@cursor/july 0.1.102 → 0.1.104

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 (789) hide show
  1. package/AGENTS.md +34 -32
  2. package/README.md +10 -12
  3. package/dist/ab.d.ts +1 -1
  4. package/dist/ab.js +1 -1
  5. package/dist/bin/agent-serve.d.ts +12 -12
  6. package/dist/bin/agent-serve.js +114 -36
  7. package/dist/channels/bitbucket/api.d.ts +176 -0
  8. package/dist/channels/bitbucket/api.d.ts.map +1 -0
  9. package/dist/channels/bitbucket/api.js +419 -0
  10. package/dist/channels/bitbucket/binding.d.ts +71 -0
  11. package/dist/channels/bitbucket/binding.d.ts.map +1 -0
  12. package/dist/channels/bitbucket/binding.js +269 -0
  13. package/dist/channels/bitbucket/bitbucket-channel.d.ts +33 -0
  14. package/dist/channels/bitbucket/bitbucket-channel.d.ts.map +1 -0
  15. package/dist/channels/bitbucket/bitbucket-channel.js +120 -0
  16. package/dist/channels/bitbucket/bitbucket-webhook.d.ts +61 -0
  17. package/dist/channels/bitbucket/bitbucket-webhook.d.ts.map +1 -0
  18. package/dist/channels/bitbucket/bitbucket-webhook.js +394 -0
  19. package/dist/channels/bitbucket/checks.d.ts +67 -0
  20. package/dist/channels/bitbucket/checks.d.ts.map +1 -0
  21. package/dist/channels/bitbucket/checks.js +102 -0
  22. package/dist/channels/bitbucket/cursor-account.d.ts +37 -0
  23. package/dist/channels/bitbucket/cursor-account.d.ts.map +1 -0
  24. package/dist/channels/bitbucket/cursor-account.js +65 -0
  25. package/dist/channels/bitbucket/defaults.d.ts +26 -0
  26. package/dist/channels/bitbucket/defaults.d.ts.map +1 -0
  27. package/dist/channels/bitbucket/defaults.js +73 -0
  28. package/dist/channels/bitbucket/events.d.ts +22 -0
  29. package/dist/channels/bitbucket/events.d.ts.map +1 -0
  30. package/dist/channels/bitbucket/events.js +64 -0
  31. package/dist/channels/bitbucket/index.d.ts +34 -0
  32. package/dist/channels/bitbucket/index.d.ts.map +1 -0
  33. package/dist/channels/bitbucket/index.js +33 -0
  34. package/dist/channels/bitbucket/replay.d.ts +63 -0
  35. package/dist/channels/bitbucket/replay.d.ts.map +1 -0
  36. package/dist/channels/bitbucket/replay.js +304 -0
  37. package/dist/channels/bitbucket/state.d.ts +35 -0
  38. package/dist/channels/bitbucket/state.d.ts.map +1 -0
  39. package/dist/channels/bitbucket/state.js +21 -0
  40. package/dist/channels/bitbucket/types.d.ts +229 -0
  41. package/dist/channels/bitbucket/types.d.ts.map +1 -0
  42. package/dist/channels/bitbucket/types.js +1 -0
  43. package/dist/channels/change-monitors/change-monitors-channel.d.ts +5 -0
  44. package/dist/channels/change-monitors/change-monitors-channel.d.ts.map +1 -0
  45. package/dist/channels/change-monitors/change-monitors-channel.js +41 -0
  46. package/dist/channels/change-monitors/index.d.ts +4 -0
  47. package/dist/channels/change-monitors/index.d.ts.map +1 -0
  48. package/dist/channels/change-monitors/index.js +2 -0
  49. package/dist/channels/change-monitors/types.d.ts +39 -0
  50. package/dist/channels/change-monitors/types.d.ts.map +1 -0
  51. package/dist/channels/change-monitors/types.js +1 -0
  52. package/dist/channels/deployments/deployments-channel.d.ts +22 -14
  53. package/dist/channels/deployments/deployments-channel.d.ts.map +1 -1
  54. package/dist/channels/deployments/deployments-channel.js +25 -27
  55. package/dist/channels/deployments/types.d.ts +12 -6
  56. package/dist/channels/deployments/types.d.ts.map +1 -1
  57. package/dist/channels/github/binding.d.ts +6 -0
  58. package/dist/channels/github/binding.d.ts.map +1 -1
  59. package/dist/channels/github/binding.js +3 -3
  60. package/dist/channels/github/cursor-account.d.ts +7 -3
  61. package/dist/channels/github/cursor-account.d.ts.map +1 -1
  62. package/dist/channels/github/cursor-account.js +10 -6
  63. package/dist/channels/github/defaults.d.ts.map +1 -1
  64. package/dist/channels/github/defaults.js +4 -0
  65. package/dist/channels/github/events.d.ts +1 -1
  66. package/dist/channels/github/events.js +1 -1
  67. package/dist/channels/github/forward.d.ts +1 -1
  68. package/dist/channels/github/forward.d.ts.map +1 -1
  69. package/dist/channels/github/forward.js +3 -2
  70. package/dist/channels/github/github-channel.d.ts +29 -39
  71. package/dist/channels/github/github-channel.d.ts.map +1 -1
  72. package/dist/channels/github/github-channel.js +68 -101
  73. package/dist/channels/github/progress.d.ts +22 -0
  74. package/dist/channels/github/progress.d.ts.map +1 -1
  75. package/dist/channels/github/progress.js +32 -5
  76. package/dist/channels/github/replay.d.ts +1 -1
  77. package/dist/channels/github/replay.js +1 -1
  78. package/dist/channels/github/state.d.ts +2 -0
  79. package/dist/channels/github/state.d.ts.map +1 -1
  80. package/dist/channels/github/state.js +14 -11
  81. package/dist/channels/github/types.d.ts +2 -4
  82. package/dist/channels/github/types.d.ts.map +1 -1
  83. package/dist/channels/gitlab/api.d.ts +91 -0
  84. package/dist/channels/gitlab/api.d.ts.map +1 -0
  85. package/dist/channels/gitlab/api.js +150 -0
  86. package/dist/channels/gitlab/binding.d.ts +58 -0
  87. package/dist/channels/gitlab/binding.d.ts.map +1 -0
  88. package/dist/channels/gitlab/binding.js +139 -0
  89. package/dist/channels/gitlab/checks.d.ts +110 -0
  90. package/dist/channels/gitlab/checks.d.ts.map +1 -0
  91. package/dist/channels/gitlab/checks.js +126 -0
  92. package/dist/channels/gitlab/cursor-account.d.ts +36 -0
  93. package/dist/channels/gitlab/cursor-account.d.ts.map +1 -0
  94. package/dist/channels/gitlab/cursor-account.js +65 -0
  95. package/dist/channels/gitlab/defaults.d.ts +25 -0
  96. package/dist/channels/gitlab/defaults.d.ts.map +1 -0
  97. package/dist/channels/gitlab/defaults.js +60 -0
  98. package/dist/channels/gitlab/events.d.ts +12 -0
  99. package/dist/channels/gitlab/events.d.ts.map +1 -0
  100. package/dist/channels/gitlab/events.js +28 -0
  101. package/dist/channels/gitlab/gitlab-channel.d.ts +33 -0
  102. package/dist/channels/gitlab/gitlab-channel.d.ts.map +1 -0
  103. package/dist/channels/gitlab/gitlab-channel.js +120 -0
  104. package/dist/channels/gitlab/gitlab-webhook.d.ts +45 -0
  105. package/dist/channels/gitlab/gitlab-webhook.d.ts.map +1 -0
  106. package/dist/channels/gitlab/gitlab-webhook.js +397 -0
  107. package/dist/channels/gitlab/index.d.ts +31 -0
  108. package/dist/channels/gitlab/index.d.ts.map +1 -0
  109. package/dist/channels/gitlab/index.js +30 -0
  110. package/dist/channels/gitlab/replay.d.ts +105 -0
  111. package/dist/channels/gitlab/replay.d.ts.map +1 -0
  112. package/dist/channels/gitlab/replay.js +206 -0
  113. package/dist/channels/gitlab/state.d.ts +33 -0
  114. package/dist/channels/gitlab/state.d.ts.map +1 -0
  115. package/dist/channels/gitlab/state.js +23 -0
  116. package/dist/channels/gitlab/types.d.ts +214 -0
  117. package/dist/channels/gitlab/types.d.ts.map +1 -0
  118. package/dist/channels/gitlab/types.js +1 -0
  119. package/dist/channels/issues/index.d.ts +4 -0
  120. package/dist/channels/issues/index.d.ts.map +1 -0
  121. package/dist/channels/issues/index.js +2 -0
  122. package/dist/channels/issues/issues-channel.d.ts +5 -0
  123. package/dist/channels/issues/issues-channel.d.ts.map +1 -0
  124. package/dist/channels/issues/issues-channel.js +37 -0
  125. package/dist/channels/issues/types.d.ts +33 -0
  126. package/dist/channels/issues/types.d.ts.map +1 -0
  127. package/dist/channels/issues/types.js +1 -0
  128. package/dist/channels/origin/api.d.ts.map +1 -1
  129. package/dist/channels/origin/api.js +4 -2
  130. package/dist/channels/origin/origin-channel.d.ts +4 -9
  131. package/dist/channels/origin/origin-channel.d.ts.map +1 -1
  132. package/dist/channels/origin/origin-channel.js +8 -48
  133. package/dist/channels/origin/types.d.ts +20 -2
  134. package/dist/channels/origin/types.d.ts.map +1 -1
  135. package/dist/channels/slack/eval-directive.d.ts.map +1 -1
  136. package/dist/channels/slack/eval-directive.js +1 -7
  137. package/dist/channels/slack/init.d.ts.map +1 -1
  138. package/dist/channels/slack/init.js +3 -3
  139. package/dist/channels/slack/setup.d.ts +1 -1
  140. package/dist/channels/slack/setup.d.ts.map +1 -1
  141. package/dist/channels/slack/setup.js +6 -13
  142. package/dist/channels/slack/types.d.ts +1 -1
  143. package/dist/channels/slack/types.d.ts.map +1 -1
  144. package/dist/channels.d.ts +1 -1
  145. package/dist/channels.d.ts.map +1 -1
  146. package/dist/client.d.ts +1 -1
  147. package/dist/client.js +1 -1
  148. package/dist/connections.d.ts +1 -1
  149. package/dist/connections.js +1 -1
  150. package/dist/docs/404.html +2 -2
  151. package/dist/docs/ab.html +4 -4
  152. package/dist/docs/assets/{app.CLA03RCz.js → app.DbMWUyGb.js} +1 -1
  153. package/dist/docs/assets/chunks/@localSearchIndexroot.Bqsulb9K.js +1 -0
  154. package/dist/docs/assets/chunks/{VPLocalSearchBox.ifxv-cJV.js → VPLocalSearchBox.DcNeTh9o.js} +1 -1
  155. package/dist/docs/assets/chunks/{theme.DWCwM6p-.js → theme.DMjhY3gl.js} +2 -2
  156. package/dist/docs/assets/concepts.md.DgEcZOfT.js +1 -0
  157. package/dist/docs/assets/{concepts.md.rPzW2HZN.lean.js → concepts.md.DgEcZOfT.lean.js} +1 -1
  158. package/dist/docs/assets/{evals.md.CPzDAwoH.js → evals.md.CbMoebP1.js} +1 -1
  159. package/dist/docs/assets/guides_cloud-agents.md.DS8RIjwx.js +9 -0
  160. package/dist/docs/assets/{guides_github.md.BtPr9GaP.js → guides_github.md.c0gdGJ-D.js} +1 -1
  161. package/dist/docs/assets/{guides_github.md.BtPr9GaP.lean.js → guides_github.md.c0gdGJ-D.lean.js} +1 -1
  162. package/dist/docs/assets/{guides_opentelemetry.md.BVTXDCRg.js → guides_opentelemetry.md.COh9jFVg.js} +7 -8
  163. package/dist/docs/assets/{guides_opentelemetry.md.BVTXDCRg.lean.js → guides_opentelemetry.md.COh9jFVg.lean.js} +1 -1
  164. package/dist/docs/assets/{index.md.Kiht7ell.js → index.md.D75GWhPl.js} +1 -1
  165. package/dist/docs/assets/{reference_agent-config.md.BHeYMgme.js → reference_agent-config.md.CHNpiyp4.js} +3 -3
  166. package/dist/docs/assets/{reference_channels.md.Cd2f2iyV.js → reference_channels.md.DBGcaB7m.js} +2 -2
  167. package/dist/docs/assets/{reference_channels.md.Cd2f2iyV.lean.js → reference_channels.md.DBGcaB7m.lean.js} +1 -1
  168. package/dist/docs/assets/{reference_cli.md.DfoeyvL0.js → reference_cli.md.CJNc_xYK.js} +1 -1
  169. package/dist/docs/assets/{reference_extensions.md.9WQMZe1l.js → reference_extensions.md.DykHW3qL.js} +11 -5
  170. package/dist/docs/assets/reference_extensions.md.DykHW3qL.lean.js +1 -0
  171. package/dist/docs/assets/reference_hooks.md.Ddt5DdgJ.js +73 -0
  172. package/dist/docs/assets/{reference_hooks.md.a8BJxMR5.lean.js → reference_hooks.md.Ddt5DdgJ.lean.js} +1 -1
  173. package/dist/docs/assets/{reference_playground.md.DnX5nL-B.js → reference_playground.md.4myJPxrf.js} +1 -1
  174. package/dist/docs/assets/{reference_project-layout.md.CA6QP6Lw.js → reference_project-layout.md.DuBu9a96.js} +2 -2
  175. package/dist/docs/assets/reference_result.md.BK5SxDrf.js +19 -0
  176. package/dist/docs/assets/reference_result.md.BK5SxDrf.lean.js +1 -0
  177. package/dist/docs/assets/{reference_sessions.md.NxFP_CAC.js → reference_sessions.md.CueyOHSL.js} +1 -1
  178. package/dist/docs/assets/{reference_sessions.md.NxFP_CAC.lean.js → reference_sessions.md.CueyOHSL.lean.js} +1 -1
  179. package/dist/docs/assets/{reference_tools.md.B1up2r9W.js → reference_tools.md.aGrn99hP.js} +1 -1
  180. package/dist/docs/assets/skills_framework-map.md.haibFyoB.js +1 -0
  181. package/dist/docs/assets/{skills_otel.md.CgiZryR3.js → skills_otel.md.CqhobH3B.js} +3 -3
  182. package/dist/docs/assets/{skills_otel.md.CgiZryR3.lean.js → skills_otel.md.CqhobH3B.lean.js} +1 -1
  183. package/dist/docs/assets/{templates_pr-autofixer.md.x5zl6-GT.js → templates_pr-autofixer.md.Bds_XWcV.js} +2 -2
  184. package/dist/docs/assets/{templates_pr-autofixer.md.x5zl6-GT.lean.js → templates_pr-autofixer.md.Bds_XWcV.lean.js} +1 -1
  185. package/dist/docs/building-with-agents.html +4 -4
  186. package/dist/docs/concepts.html +5 -5
  187. package/dist/docs/concepts.md +2 -4
  188. package/dist/docs/deployment.html +4 -4
  189. package/dist/docs/design/filesystem.md +376 -0
  190. package/dist/docs/design/runtime-abstraction.md +2 -3
  191. package/dist/docs/evals.html +6 -6
  192. package/dist/docs/evals.md +9 -7
  193. package/dist/docs/guides/agent-to-agent.html +4 -4
  194. package/dist/docs/guides/cloud-agents.html +6 -6
  195. package/dist/docs/guides/cloud-agents.md +4 -6
  196. package/dist/docs/guides/convert-automation.html +4 -4
  197. package/dist/docs/guides/github.html +6 -6
  198. package/dist/docs/guides/github.md +5 -1
  199. package/dist/docs/guides/human-in-the-loop.html +4 -4
  200. package/dist/docs/guides/mcp-oauth.html +5 -5
  201. package/dist/docs/guides/opentelemetry.html +10 -11
  202. package/dist/docs/guides/opentelemetry.md +41 -17
  203. package/dist/docs/guides/slack.html +4 -4
  204. package/dist/docs/guides/webhooks.html +4 -4
  205. package/dist/docs/hashmap.json +1 -1
  206. package/dist/docs/hillclimbing.html +4 -4
  207. package/dist/docs/index.html +6 -6
  208. package/dist/docs/index.md +2 -2
  209. package/dist/docs/llms-full.txt +907 -262
  210. package/dist/docs/llms.txt +3 -2
  211. package/dist/docs/quickstart.html +4 -4
  212. package/dist/docs/reference/agent-config.html +8 -8
  213. package/dist/docs/reference/agent-config.md +6 -10
  214. package/dist/docs/reference/artifacts.html +5 -5
  215. package/dist/docs/reference/channels.html +6 -6
  216. package/dist/docs/reference/channels.md +38 -8
  217. package/dist/docs/reference/cli.html +5 -5
  218. package/dist/docs/reference/cli.md +3 -4
  219. package/dist/docs/reference/connections.html +4 -4
  220. package/dist/docs/reference/extensions.html +16 -10
  221. package/dist/docs/reference/extensions.md +86 -22
  222. package/dist/docs/reference/hooks.html +69 -10
  223. package/dist/docs/reference/hooks.md +215 -46
  224. package/dist/docs/reference/http-api.html +4 -4
  225. package/dist/docs/reference/instructions.html +4 -4
  226. package/dist/docs/reference/playground.html +5 -5
  227. package/dist/docs/reference/playground.md +3 -0
  228. package/dist/docs/reference/project-layout.html +6 -6
  229. package/dist/docs/reference/project-layout.md +2 -1
  230. package/dist/docs/reference/prompt.html +4 -4
  231. package/dist/docs/reference/result.html +45 -0
  232. package/dist/docs/reference/result.md +89 -0
  233. package/dist/docs/reference/schedules.html +4 -4
  234. package/dist/docs/reference/sessions.html +5 -5
  235. package/dist/docs/reference/sessions.md +3 -1
  236. package/dist/docs/reference/skills.html +4 -4
  237. package/dist/docs/reference/subagents.html +4 -4
  238. package/dist/docs/reference/tools.html +5 -5
  239. package/dist/docs/reference/tools.md +1 -2
  240. package/dist/docs/scaffolding-agents.html +4 -4
  241. package/dist/docs/skills/ab.html +4 -4
  242. package/dist/docs/skills/create-agent.html +4 -4
  243. package/dist/docs/skills/debug.html +4 -4
  244. package/dist/docs/skills/evals.html +4 -4
  245. package/dist/docs/skills/framework-map.html +5 -5
  246. package/dist/docs/skills/framework-map.md +3 -1
  247. package/dist/docs/skills/github.html +4 -4
  248. package/dist/docs/skills/hillclimb.html +4 -4
  249. package/dist/docs/skills/index.html +4 -4
  250. package/dist/docs/skills/mcp-auth.html +4 -4
  251. package/dist/docs/skills/otel.html +7 -7
  252. package/dist/docs/skills/otel.md +8 -3
  253. package/dist/docs/skills/setup-slack.html +4 -4
  254. package/dist/docs/storage.html +4 -4
  255. package/dist/docs/templates/agentic-owners.html +4 -4
  256. package/dist/docs/templates/agents-md.html +4 -4
  257. package/dist/docs/templates/code-wiki.html +4 -4
  258. package/dist/docs/templates/demo.html +4 -4
  259. package/dist/docs/templates/pr-autofixer.html +6 -6
  260. package/dist/docs/templates/pr-autofixer.md +0 -3
  261. package/dist/docs/templates/security-help.html +4 -4
  262. package/dist/docs/templates/security-reviewer.html +4 -4
  263. package/dist/docs/templates/triage.html +4 -4
  264. package/dist/docs/troubleshooting.html +4 -4
  265. package/dist/evals.d.ts +1 -1
  266. package/dist/evals.d.ts.map +1 -1
  267. package/dist/extensions.d.ts +20 -7
  268. package/dist/extensions.d.ts.map +1 -1
  269. package/dist/extensions.js +36 -5
  270. package/dist/files.d.ts +16 -3
  271. package/dist/files.d.ts.map +1 -1
  272. package/dist/files.js +16 -3
  273. package/dist/filesystem.d.ts +440 -0
  274. package/dist/filesystem.d.ts.map +1 -0
  275. package/dist/filesystem.js +1694 -0
  276. package/dist/index.d.ts +6 -4
  277. package/dist/index.d.ts.map +1 -1
  278. package/dist/index.js +4 -3
  279. package/dist/internal/ab-snapshot.d.ts.map +1 -1
  280. package/dist/internal/ab-snapshot.js +0 -1
  281. package/dist/internal/advertise-tools.d.ts.map +1 -1
  282. package/dist/internal/advertise-tools.js +1 -3
  283. package/dist/internal/authored-alias-hooks.d.ts +4 -13
  284. package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
  285. package/dist/internal/authored-alias-hooks.js +4 -20
  286. package/dist/internal/authored-loaders.d.ts +2 -3
  287. package/dist/internal/authored-loaders.d.ts.map +1 -1
  288. package/dist/internal/authored-loaders.js +6 -20
  289. package/dist/internal/channel-dispatch.d.ts +43 -0
  290. package/dist/internal/channel-dispatch.d.ts.map +1 -0
  291. package/dist/internal/channel-dispatch.js +77 -0
  292. package/dist/internal/chat-client.d.ts +1 -1
  293. package/dist/internal/chat-client.js +1 -1
  294. package/dist/internal/cli-ax.d.ts +5 -5
  295. package/dist/internal/cli-ax.d.ts.map +1 -1
  296. package/dist/internal/cli-ax.js +5 -5
  297. package/dist/internal/cli-bitbucket.d.ts +33 -0
  298. package/dist/internal/cli-bitbucket.d.ts.map +1 -0
  299. package/dist/internal/cli-bitbucket.js +359 -0
  300. package/dist/internal/cli-convert-automation.d.ts +1 -1
  301. package/dist/internal/cli-convert-automation.js +2 -2
  302. package/dist/internal/cli-cursor.d.ts +1 -1
  303. package/dist/internal/cli-cursor.d.ts.map +1 -1
  304. package/dist/internal/cli-cursor.js +2 -4
  305. package/dist/internal/cli-deploy.d.ts.map +1 -1
  306. package/dist/internal/cli-deploy.js +2 -6
  307. package/dist/internal/cli-github.d.ts +1 -1
  308. package/dist/internal/cli-github.js +3 -3
  309. package/dist/internal/cli-gitlab.d.ts +37 -0
  310. package/dist/internal/cli-gitlab.d.ts.map +1 -0
  311. package/dist/internal/cli-gitlab.js +380 -0
  312. package/dist/internal/cli-mcp.d.ts.map +1 -1
  313. package/dist/internal/cli-mcp.js +2 -6
  314. package/dist/internal/cli-slack.d.ts +1 -1
  315. package/dist/internal/cli-slack.d.ts.map +1 -1
  316. package/dist/internal/cli-slack.js +2 -4
  317. package/dist/internal/continuation-channel.d.ts +18 -2
  318. package/dist/internal/continuation-channel.d.ts.map +1 -1
  319. package/dist/internal/continuation-channel.js +67 -5
  320. package/dist/internal/continuation-identity.d.ts +24 -17
  321. package/dist/internal/continuation-identity.d.ts.map +1 -1
  322. package/dist/internal/continuation-identity.js +246 -32
  323. package/dist/internal/conversation-mirror.d.ts.map +1 -1
  324. package/dist/internal/conversation-mirror.js +4 -3
  325. package/dist/internal/convert-automation/types.d.ts +1 -1
  326. package/dist/internal/convert-automation/types.js +1 -1
  327. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  328. package/dist/internal/cursor/account-mcp.js +1 -3
  329. package/dist/internal/cursor/backend-client.d.ts +5 -4
  330. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  331. package/dist/internal/cursor/backend-client.js +5 -6
  332. package/dist/internal/cursor/bound-secret-file.d.ts +56 -0
  333. package/dist/internal/cursor/bound-secret-file.d.ts.map +1 -0
  334. package/dist/internal/cursor/bound-secret-file.js +88 -0
  335. package/dist/internal/cursor/credentials.d.ts +39 -5
  336. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  337. package/dist/internal/cursor/credentials.js +58 -8
  338. package/dist/internal/cursor/hosted-bound-secrets.d.ts +41 -0
  339. package/dist/internal/cursor/hosted-bound-secrets.d.ts.map +1 -0
  340. package/dist/internal/cursor/hosted-bound-secrets.js +54 -0
  341. package/dist/internal/cursor/hosted-deployment-secrets.d.ts +19 -5
  342. package/dist/internal/cursor/hosted-deployment-secrets.d.ts.map +1 -1
  343. package/dist/internal/cursor/hosted-deployment-secrets.js +29 -9
  344. package/dist/internal/cursor/hosted-store-secrets.d.ts +1 -1
  345. package/dist/internal/cursor/hosted-store-secrets.js +1 -1
  346. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  347. package/dist/internal/cursor-account-mcp-auth.js +2 -4
  348. package/dist/internal/cursor-deployment-relay.d.ts +6 -2
  349. package/dist/internal/cursor-deployment-relay.d.ts.map +1 -1
  350. package/dist/internal/cursor-deployment-relay.js +13 -9
  351. package/dist/internal/deploy-manifest.d.ts +1 -1
  352. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  353. package/dist/internal/deploy-manifest.js +1 -1
  354. package/dist/internal/discovery/ab.d.ts +1 -1
  355. package/dist/internal/discovery/ab.d.ts.map +1 -1
  356. package/dist/internal/discovery/ab.js +21 -9
  357. package/dist/internal/discovery/agent.d.ts +6 -1
  358. package/dist/internal/discovery/agent.d.ts.map +1 -1
  359. package/dist/internal/discovery/agent.js +141 -120
  360. package/dist/internal/discovery/channels.d.ts +1 -1
  361. package/dist/internal/discovery/channels.d.ts.map +1 -1
  362. package/dist/internal/discovery/channels.js +14 -14
  363. package/dist/internal/discovery/connections.d.ts +1 -5
  364. package/dist/internal/discovery/connections.d.ts.map +1 -1
  365. package/dist/internal/discovery/connections.js +30 -44
  366. package/dist/internal/discovery/cursor-plugin.d.ts.map +1 -1
  367. package/dist/internal/discovery/cursor-plugin.js +1 -3
  368. package/dist/internal/discovery/extension-overlay.d.ts +32 -0
  369. package/dist/internal/discovery/extension-overlay.d.ts.map +1 -0
  370. package/dist/internal/discovery/extension-overlay.js +191 -0
  371. package/dist/internal/discovery/extensions.d.ts +11 -2
  372. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  373. package/dist/internal/discovery/extensions.js +211 -74
  374. package/dist/internal/discovery/hooks.d.ts +1 -1
  375. package/dist/internal/discovery/hooks.d.ts.map +1 -1
  376. package/dist/internal/discovery/hooks.js +15 -2
  377. package/dist/internal/discovery/info.d.ts.map +1 -1
  378. package/dist/internal/discovery/info.js +10 -1
  379. package/dist/internal/discovery/modules.d.ts.map +1 -1
  380. package/dist/internal/discovery/modules.js +8 -2
  381. package/dist/internal/discovery/names.d.ts +1 -1
  382. package/dist/internal/discovery/names.d.ts.map +1 -1
  383. package/dist/internal/discovery/names.js +1 -0
  384. package/dist/internal/discovery/project.d.ts +0 -2
  385. package/dist/internal/discovery/project.d.ts.map +1 -1
  386. package/dist/internal/discovery/project.js +64 -10
  387. package/dist/internal/discovery/runtime.d.ts.map +1 -1
  388. package/dist/internal/discovery/runtime.js +1 -2
  389. package/dist/internal/discovery/schedules.d.ts +1 -1
  390. package/dist/internal/discovery/schedules.d.ts.map +1 -1
  391. package/dist/internal/discovery/schedules.js +23 -2
  392. package/dist/internal/discovery/services.d.ts +6 -2
  393. package/dist/internal/discovery/services.d.ts.map +1 -1
  394. package/dist/internal/discovery/services.js +31 -1
  395. package/dist/internal/discovery/skills.d.ts +1 -6
  396. package/dist/internal/discovery/skills.d.ts.map +1 -1
  397. package/dist/internal/discovery/skills.js +8 -3
  398. package/dist/internal/discovery/subagent.d.ts +3 -0
  399. package/dist/internal/discovery/subagent.d.ts.map +1 -1
  400. package/dist/internal/discovery/subagent.js +109 -0
  401. package/dist/internal/discovery.d.ts +1 -2
  402. package/dist/internal/discovery.d.ts.map +1 -1
  403. package/dist/internal/discovery.js +1 -2
  404. package/dist/internal/distribution.d.ts +10 -27
  405. package/dist/internal/distribution.d.ts.map +1 -1
  406. package/dist/internal/distribution.js +25 -73
  407. package/dist/internal/docs-site.js +1 -1
  408. package/dist/internal/eval-run-store.d.ts +0 -1
  409. package/dist/internal/eval-run-store.d.ts.map +1 -1
  410. package/dist/internal/eval-runner.d.ts.map +1 -1
  411. package/dist/internal/factory-resource-channel.d.ts +33 -0
  412. package/dist/internal/factory-resource-channel.d.ts.map +1 -0
  413. package/dist/internal/factory-resource-channel.js +77 -0
  414. package/dist/internal/filesystem/errors.d.ts +64 -0
  415. package/dist/internal/filesystem/errors.d.ts.map +1 -0
  416. package/dist/internal/filesystem/errors.js +175 -0
  417. package/dist/internal/filesystem/format.d.ts +28 -0
  418. package/dist/internal/filesystem/format.d.ts.map +1 -0
  419. package/dist/internal/filesystem/format.js +213 -0
  420. package/dist/internal/filesystem/merge.d.ts +34 -0
  421. package/dist/internal/filesystem/merge.d.ts.map +1 -0
  422. package/dist/internal/filesystem/merge.js +196 -0
  423. package/dist/internal/filesystem/scratch.d.ts +59 -0
  424. package/dist/internal/filesystem/scratch.d.ts.map +1 -0
  425. package/dist/internal/filesystem/scratch.js +212 -0
  426. package/dist/internal/filesystem/sdk-schemas.d.ts +29 -0
  427. package/dist/internal/filesystem/sdk-schemas.d.ts.map +1 -0
  428. package/dist/internal/filesystem/sdk-schemas.js +153 -0
  429. package/dist/internal/filesystem/tools.d.ts +42 -0
  430. package/dist/internal/filesystem/tools.d.ts.map +1 -0
  431. package/dist/internal/filesystem/tools.js +618 -0
  432. package/dist/internal/filesystem/walk.d.ts +74 -0
  433. package/dist/internal/filesystem/walk.d.ts.map +1 -0
  434. package/dist/internal/filesystem/walk.js +339 -0
  435. package/dist/internal/framework-file-storage.d.ts +8 -0
  436. package/dist/internal/framework-file-storage.d.ts.map +1 -1
  437. package/dist/internal/framework-file-storage.js +8 -8
  438. package/dist/internal/github-fanout.d.ts +1 -1
  439. package/dist/internal/github-fanout.js +1 -1
  440. package/dist/internal/guest-network.d.ts +104 -0
  441. package/dist/internal/guest-network.d.ts.map +1 -0
  442. package/dist/internal/guest-network.js +309 -0
  443. package/dist/internal/host-otel.d.ts +3 -3
  444. package/dist/internal/host-otel.d.ts.map +1 -1
  445. package/dist/internal/host-otel.js +8 -4
  446. package/dist/internal/hosted-admission-adapter.d.ts +8 -7
  447. package/dist/internal/hosted-admission-adapter.d.ts.map +1 -1
  448. package/dist/internal/hosted-delivery-protocol.d.ts +6 -0
  449. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  450. package/dist/internal/hosted-delivery-protocol.js +18 -5
  451. package/dist/internal/hosted-delivery.d.ts +18 -0
  452. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  453. package/dist/internal/hosted-delivery.js +258 -118
  454. package/dist/internal/http-channel.d.ts.map +1 -1
  455. package/dist/internal/http-channel.js +1 -3
  456. package/dist/internal/init-interview.d.ts.map +1 -1
  457. package/dist/internal/init-interview.js +1 -3
  458. package/dist/internal/init-project.d.ts +2 -2
  459. package/dist/internal/init-project.js +2 -2
  460. package/dist/internal/inline-stdio-define-stub.d.ts +1 -1
  461. package/dist/internal/inline-stdio-define-stub.d.ts.map +1 -1
  462. package/dist/internal/inline-stdio-define-stub.js +1 -1
  463. package/dist/internal/is-record.d.ts +2 -0
  464. package/dist/internal/is-record.d.ts.map +1 -0
  465. package/dist/internal/is-record.js +3 -0
  466. package/dist/internal/json-schema.d.ts.map +1 -1
  467. package/dist/internal/json-schema.js +18 -10
  468. package/dist/internal/local-control-plane.d.ts +1 -2
  469. package/dist/internal/local-control-plane.d.ts.map +1 -1
  470. package/dist/internal/local-control-plane.js +3 -20
  471. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  472. package/dist/internal/mcp-endpoint.js +1 -3
  473. package/dist/internal/otel/collector.d.ts +12 -3
  474. package/dist/internal/otel/collector.d.ts.map +1 -1
  475. package/dist/internal/otel/collector.js +77 -125
  476. package/dist/internal/otel/config.d.ts +0 -2
  477. package/dist/internal/otel/config.d.ts.map +1 -1
  478. package/dist/internal/otel/config.js +17 -20
  479. package/dist/internal/otel/http.d.ts +2 -0
  480. package/dist/internal/otel/http.d.ts.map +1 -1
  481. package/dist/internal/otel/http.js +7 -1
  482. package/dist/internal/otel/mcp.d.ts.map +1 -1
  483. package/dist/internal/otel/mcp.js +3 -16
  484. package/dist/internal/otel/runtime.d.ts +26 -1
  485. package/dist/internal/otel/runtime.d.ts.map +1 -1
  486. package/dist/internal/otel/runtime.js +164 -15
  487. package/dist/internal/package-inline-stdio.d.ts.map +1 -1
  488. package/dist/internal/package-inline-stdio.js +3 -11
  489. package/dist/internal/playground/toolchain.d.ts +1 -1
  490. package/dist/internal/playground/toolchain.d.ts.map +1 -1
  491. package/dist/internal/playground/toolchain.js +1 -1
  492. package/dist/internal/request-error-status.d.ts +12 -0
  493. package/dist/internal/request-error-status.d.ts.map +1 -0
  494. package/dist/internal/request-error-status.js +52 -0
  495. package/dist/internal/resolve-prod-target.d.ts +1 -1
  496. package/dist/internal/resolve-prod-target.d.ts.map +1 -1
  497. package/dist/internal/resolve-prod-target.js +3 -7
  498. package/dist/internal/result-output.d.ts +18 -0
  499. package/dist/internal/result-output.d.ts.map +1 -0
  500. package/dist/internal/result-output.js +33 -0
  501. package/dist/internal/run-client.d.ts +2 -2
  502. package/dist/internal/run-client.js +2 -2
  503. package/dist/internal/runtime-dispatch-runner.d.ts +1 -11
  504. package/dist/internal/runtime-dispatch-runner.d.ts.map +1 -1
  505. package/dist/internal/runtime-dispatch-runner.js +2 -15
  506. package/dist/internal/sdk-runner.d.ts +1 -1
  507. package/dist/internal/sdk-runner.d.ts.map +1 -1
  508. package/dist/internal/sdk-runner.js +6 -7
  509. package/dist/internal/server.d.ts.map +1 -1
  510. package/dist/internal/server.js +110 -35
  511. package/dist/internal/session-cost.d.ts +3 -3
  512. package/dist/internal/session-cost.d.ts.map +1 -1
  513. package/dist/internal/session-cost.js +3 -3
  514. package/dist/internal/session-engine.d.ts +48 -11
  515. package/dist/internal/session-engine.d.ts.map +1 -1
  516. package/dist/internal/session-engine.js +507 -115
  517. package/dist/internal/session-run-log.d.ts.map +1 -1
  518. package/dist/internal/session-run-log.js +1 -3
  519. package/dist/internal/skills-sync.d.ts +1 -4
  520. package/dist/internal/skills-sync.d.ts.map +1 -1
  521. package/dist/internal/skills-sync.js +10 -50
  522. package/dist/internal/sleep.d.ts +2 -0
  523. package/dist/internal/sleep.d.ts.map +1 -0
  524. package/dist/internal/sleep.js +3 -0
  525. package/dist/internal/store-mirror.d.ts +29 -0
  526. package/dist/internal/store-mirror.d.ts.map +1 -0
  527. package/dist/internal/store-mirror.js +70 -0
  528. package/dist/internal/tenant-slack/relay.d.ts +73 -0
  529. package/dist/internal/tenant-slack/relay.d.ts.map +1 -0
  530. package/dist/internal/tenant-slack/relay.js +138 -0
  531. package/dist/internal/testing/factory-resource-fixtures.d.ts +48 -0
  532. package/dist/internal/testing/factory-resource-fixtures.d.ts.map +1 -0
  533. package/dist/internal/testing/factory-resource-fixtures.js +41 -0
  534. package/dist/internal/testing/scm-continuation-fixtures.d.ts +33 -0
  535. package/dist/internal/testing/scm-continuation-fixtures.d.ts.map +1 -0
  536. package/dist/internal/testing/scm-continuation-fixtures.js +253 -0
  537. package/dist/internal/workspace-sync.d.ts +22 -0
  538. package/dist/internal/workspace-sync.d.ts.map +1 -0
  539. package/dist/internal/workspace-sync.js +49 -0
  540. package/dist/internal/workspace.d.ts +7 -0
  541. package/dist/internal/workspace.d.ts.map +1 -1
  542. package/dist/internal/workspace.js +13 -0
  543. package/dist/otel.d.ts +23 -1
  544. package/dist/otel.d.ts.map +1 -1
  545. package/dist/otel.js +93 -2
  546. package/dist/playground/assets/index-8YiozU89.js +67 -0
  547. package/dist/playground/assets/index-MbMxXg-y.css +1 -0
  548. package/dist/playground/index.html +2 -2
  549. package/dist/result.d.ts +24 -0
  550. package/dist/result.d.ts.map +1 -0
  551. package/dist/result.js +27 -0
  552. package/dist/storage-backends/cursor-hosted.d.ts.map +1 -1
  553. package/dist/storage-backends/cursor-hosted.js +7 -4
  554. package/dist/storage-protocol.d.ts.map +1 -1
  555. package/dist/storage-protocol.js +1 -3
  556. package/dist/types.d.ts +141 -26
  557. package/dist/types.d.ts.map +1 -1
  558. package/docs/README.md +2 -2
  559. package/docs/concepts.md +2 -4
  560. package/docs/design/filesystem.md +376 -0
  561. package/docs/design/runtime-abstraction.md +2 -3
  562. package/docs/evals.md +9 -7
  563. package/docs/guides/cloud-agents.md +4 -6
  564. package/docs/guides/github.md +5 -1
  565. package/docs/guides/opentelemetry.md +41 -17
  566. package/docs/reference/agent-config.md +6 -10
  567. package/docs/reference/channels.md +38 -8
  568. package/docs/reference/cli.md +3 -4
  569. package/docs/reference/extensions.md +87 -23
  570. package/docs/reference/hooks.md +215 -46
  571. package/docs/reference/playground.md +3 -0
  572. package/docs/reference/project-layout.md +2 -1
  573. package/docs/reference/result.md +94 -0
  574. package/docs/reference/sessions.md +3 -1
  575. package/docs/reference/tools.md +1 -2
  576. package/docs/templates/pr-autofixer.md +0 -3
  577. package/package.json +42 -9
  578. package/skills/framework-map/SKILL.md +3 -1
  579. package/skills/otel/SKILL.md +8 -3
  580. package/src/ab.ts +1 -1
  581. package/src/bin/agent-serve.ts +121 -21
  582. package/src/channels/bitbucket/api.ts +623 -0
  583. package/src/channels/bitbucket/binding.ts +414 -0
  584. package/src/channels/bitbucket/bitbucket-channel.ts +182 -0
  585. package/src/channels/bitbucket/bitbucket-webhook.ts +576 -0
  586. package/src/channels/bitbucket/checks.ts +154 -0
  587. package/src/channels/bitbucket/cursor-account.ts +117 -0
  588. package/src/channels/bitbucket/defaults.ts +110 -0
  589. package/src/channels/bitbucket/events.ts +84 -0
  590. package/src/channels/bitbucket/index.ts +49 -0
  591. package/src/channels/bitbucket/replay.ts +439 -0
  592. package/src/channels/bitbucket/state.ts +59 -0
  593. package/src/channels/bitbucket/types.ts +266 -0
  594. package/src/channels/change-monitors/change-monitors-channel.ts +62 -0
  595. package/src/channels/change-monitors/index.ts +8 -0
  596. package/src/channels/change-monitors/types.ts +44 -0
  597. package/src/channels/deployments/deployments-channel.ts +25 -43
  598. package/src/channels/deployments/types.ts +12 -6
  599. package/src/channels/github/binding.ts +8 -1
  600. package/src/channels/github/cursor-account.ts +17 -6
  601. package/src/channels/github/defaults.ts +4 -0
  602. package/src/channels/github/events.ts +1 -1
  603. package/src/channels/github/forward.ts +3 -2
  604. package/src/channels/github/github-channel.ts +74 -221
  605. package/src/channels/github/progress.ts +76 -10
  606. package/src/channels/github/replay.ts +1 -1
  607. package/src/channels/github/state.ts +6 -0
  608. package/src/channels/github/types.ts +2 -5
  609. package/src/channels/gitlab/api.ts +228 -0
  610. package/src/channels/gitlab/binding.ts +233 -0
  611. package/src/channels/gitlab/checks.ts +243 -0
  612. package/src/channels/gitlab/cursor-account.ts +114 -0
  613. package/src/channels/gitlab/defaults.ts +93 -0
  614. package/src/channels/gitlab/events.ts +44 -0
  615. package/src/channels/gitlab/gitlab-channel.ts +176 -0
  616. package/src/channels/gitlab/gitlab-webhook.ts +555 -0
  617. package/src/channels/gitlab/index.ts +43 -0
  618. package/src/channels/gitlab/replay.ts +347 -0
  619. package/src/channels/gitlab/state.ts +55 -0
  620. package/src/channels/gitlab/types.ts +263 -0
  621. package/src/channels/issues/index.ts +9 -0
  622. package/src/channels/issues/issues-channel.ts +51 -0
  623. package/src/channels/issues/types.ts +41 -0
  624. package/src/channels/origin/api.ts +4 -2
  625. package/src/channels/origin/origin-channel.ts +19 -94
  626. package/src/channels/origin/types.ts +23 -2
  627. package/src/channels/slack/eval-directive.ts +1 -6
  628. package/src/channels/slack/init.ts +6 -3
  629. package/src/channels/slack/setup.ts +7 -6
  630. package/src/channels/slack/types.ts +1 -1
  631. package/src/channels.ts +0 -1
  632. package/src/client.ts +1 -1
  633. package/src/connections.ts +1 -1
  634. package/src/evals.ts +1 -1
  635. package/src/extensions.ts +47 -5
  636. package/src/files.ts +21 -3
  637. package/src/filesystem.ts +2074 -0
  638. package/src/index.ts +48 -28
  639. package/src/internal/ab-snapshot.ts +0 -3
  640. package/src/internal/advertise-tools.ts +1 -4
  641. package/src/internal/authored-alias-hooks.ts +4 -21
  642. package/src/internal/authored-loaders.ts +6 -23
  643. package/src/internal/channel-dispatch.ts +160 -0
  644. package/src/internal/chat-client.ts +1 -1
  645. package/src/internal/cli-ax.ts +5 -5
  646. package/src/internal/cli-bitbucket.ts +477 -0
  647. package/src/internal/cli-convert-automation.ts +7 -7
  648. package/src/internal/cli-cursor.ts +2 -5
  649. package/src/internal/cli-deploy.ts +2 -8
  650. package/src/internal/cli-github.ts +3 -3
  651. package/src/internal/cli-gitlab.ts +485 -0
  652. package/src/internal/cli-mcp.ts +2 -7
  653. package/src/internal/cli-slack.ts +2 -5
  654. package/src/internal/continuation-channel.ts +102 -4
  655. package/src/internal/continuation-identity.ts +338 -35
  656. package/src/internal/conversation-mirror.ts +4 -3
  657. package/src/internal/convert-automation/types.ts +1 -1
  658. package/src/internal/cursor/account-mcp.ts +1 -4
  659. package/src/internal/cursor/backend-client.ts +9 -10
  660. package/src/internal/cursor/bound-secret-file.ts +108 -0
  661. package/src/internal/cursor/credentials.ts +75 -10
  662. package/src/internal/cursor/hosted-bound-secrets.ts +75 -0
  663. package/src/internal/cursor/hosted-deployment-secrets.ts +42 -11
  664. package/src/internal/cursor/hosted-store-secrets.ts +1 -1
  665. package/src/internal/cursor-account-mcp-auth.ts +2 -5
  666. package/src/internal/cursor-deployment-relay.ts +11 -7
  667. package/src/internal/deploy-manifest.ts +4 -2
  668. package/src/internal/discovery/ab.ts +29 -9
  669. package/src/internal/discovery/agent.ts +181 -136
  670. package/src/internal/discovery/channels.ts +15 -13
  671. package/src/internal/discovery/connections.ts +55 -50
  672. package/src/internal/discovery/cursor-plugin.ts +1 -4
  673. package/src/internal/discovery/extension-overlay.ts +274 -0
  674. package/src/internal/discovery/extensions.ts +330 -105
  675. package/src/internal/discovery/hooks.ts +20 -2
  676. package/src/internal/discovery/info.ts +10 -0
  677. package/src/internal/discovery/modules.ts +8 -2
  678. package/src/internal/discovery/names.ts +2 -1
  679. package/src/internal/discovery/project.ts +80 -9
  680. package/src/internal/discovery/runtime.ts +1 -2
  681. package/src/internal/discovery/schedules.ts +28 -2
  682. package/src/internal/discovery/services.ts +37 -1
  683. package/src/internal/discovery/skills.ts +13 -3
  684. package/src/internal/discovery/subagent.ts +107 -0
  685. package/src/internal/discovery.ts +0 -2
  686. package/src/internal/distribution.ts +35 -83
  687. package/src/internal/docs-site.ts +1 -1
  688. package/src/internal/eval-run-store.ts +0 -7
  689. package/src/internal/eval-runner.ts +0 -1
  690. package/src/internal/factory-resource-channel.ts +122 -0
  691. package/src/internal/filesystem/errors.ts +220 -0
  692. package/src/internal/filesystem/format.ts +276 -0
  693. package/src/internal/filesystem/merge.ts +195 -0
  694. package/src/internal/filesystem/scratch.ts +255 -0
  695. package/src/internal/filesystem/sdk-schemas.ts +204 -0
  696. package/src/internal/filesystem/tools.ts +821 -0
  697. package/src/internal/filesystem/walk.ts +369 -0
  698. package/src/internal/framework-file-storage.ts +8 -8
  699. package/src/internal/github-fanout.ts +1 -1
  700. package/src/internal/guest-network.ts +389 -0
  701. package/src/internal/host-otel.ts +8 -4
  702. package/src/internal/hosted-admission-adapter.ts +8 -8
  703. package/src/internal/hosted-delivery-protocol.ts +26 -1
  704. package/src/internal/hosted-delivery.ts +393 -192
  705. package/src/internal/http-channel.ts +1 -4
  706. package/src/internal/init-interview.ts +1 -4
  707. package/src/internal/init-project.ts +2 -2
  708. package/src/internal/inline-stdio-define-stub.ts +1 -1
  709. package/src/internal/is-record.ts +3 -0
  710. package/src/internal/json-schema.ts +19 -10
  711. package/src/internal/local-control-plane.ts +5 -24
  712. package/src/internal/mcp-endpoint.ts +1 -4
  713. package/src/internal/otel/collector.ts +94 -159
  714. package/src/internal/otel/config.ts +10 -14
  715. package/src/internal/otel/http.ts +14 -1
  716. package/src/internal/otel/mcp.ts +3 -16
  717. package/src/internal/otel/runtime.ts +240 -25
  718. package/src/internal/package-inline-stdio.ts +3 -12
  719. package/src/internal/playground/toolchain.ts +1 -1
  720. package/src/internal/request-error-status.ts +72 -0
  721. package/src/internal/resolve-prod-target.ts +3 -8
  722. package/src/internal/result-output.ts +34 -0
  723. package/src/internal/run-client.ts +2 -2
  724. package/src/internal/runtime-dispatch-runner.ts +3 -21
  725. package/src/internal/sdk-runner.ts +7 -7
  726. package/src/internal/server.ts +153 -44
  727. package/src/internal/session-cost.ts +3 -3
  728. package/src/internal/session-engine.ts +621 -103
  729. package/src/internal/session-run-log.ts +1 -4
  730. package/src/internal/skills-sync.ts +13 -63
  731. package/src/internal/sleep.ts +3 -0
  732. package/src/internal/store-mirror.ts +86 -0
  733. package/src/internal/tenant-slack/relay.ts +179 -0
  734. package/src/internal/testing/factory-resource-fixtures.ts +85 -0
  735. package/src/internal/testing/scm-continuation-fixtures.ts +286 -0
  736. package/src/internal/workspace-sync.ts +55 -0
  737. package/src/internal/workspace.ts +14 -0
  738. package/src/otel.ts +143 -3
  739. package/src/result.ts +36 -0
  740. package/src/storage-backends/cursor-hosted.ts +7 -4
  741. package/src/storage-protocol.ts +1 -4
  742. package/src/types.ts +154 -37
  743. package/templates/triage/agent/lib/types.ts +0 -2
  744. package/dist/continuation.d.ts +0 -20
  745. package/dist/continuation.d.ts.map +0 -1
  746. package/dist/continuation.js +0 -18
  747. package/dist/docs/assets/chunks/@localSearchIndexroot.FAqdWIXo.js +0 -1
  748. package/dist/docs/assets/concepts.md.rPzW2HZN.js +0 -1
  749. package/dist/docs/assets/guides_cloud-agents.md.DumwWXba.js +0 -9
  750. package/dist/docs/assets/guides_cloud-runtime.md.BRirbRAN.js +0 -9
  751. package/dist/docs/assets/guides_cloud-runtime.md.BRirbRAN.lean.js +0 -1
  752. package/dist/docs/assets/reference_extensions.md.9WQMZe1l.lean.js +0 -1
  753. package/dist/docs/assets/reference_hooks.md.a8BJxMR5.js +0 -14
  754. package/dist/docs/assets/skills_framework-map.md.DDa4MeEW.js +0 -1
  755. package/dist/docs/guides/cloud-runtime.html +0 -35
  756. package/dist/docs/guides/cloud-runtime.md +0 -117
  757. package/dist/internal/convert-automation/index.d.ts +0 -3
  758. package/dist/internal/convert-automation/index.d.ts.map +0 -1
  759. package/dist/internal/convert-automation/index.js +0 -1
  760. package/dist/internal/grokbot/runner.d.ts +0 -64
  761. package/dist/internal/grokbot/runner.d.ts.map +0 -1
  762. package/dist/internal/grokbot/runner.js +0 -282
  763. package/dist/internal/managed-delivery.d.ts +0 -80
  764. package/dist/internal/managed-delivery.d.ts.map +0 -1
  765. package/dist/internal/managed-delivery.js +0 -86
  766. package/dist/internal/review-comments.d.ts +0 -370
  767. package/dist/internal/review-comments.d.ts.map +0 -1
  768. package/dist/internal/review-comments.js +0 -921
  769. package/dist/internal/shallow-clone.d.ts +0 -176
  770. package/dist/internal/shallow-clone.d.ts.map +0 -1
  771. package/dist/internal/shallow-clone.js +0 -419
  772. package/dist/playground/assets/index-B6C9S9nG.css +0 -1
  773. package/dist/playground/assets/index-ZqNoT8Ie.js +0 -69
  774. package/docs/guides/cloud-runtime.md +0 -122
  775. package/src/continuation.ts +0 -49
  776. package/src/internal/convert-automation/index.ts +0 -10
  777. package/src/internal/grokbot/runner.ts +0 -370
  778. package/src/internal/managed-delivery.ts +0 -125
  779. package/src/internal/review-comments.ts +0 -1363
  780. package/src/internal/shallow-clone.ts +0 -609
  781. /package/dist/docs/assets/{evals.md.CPzDAwoH.lean.js → evals.md.CbMoebP1.lean.js} +0 -0
  782. /package/dist/docs/assets/{guides_cloud-agents.md.DumwWXba.lean.js → guides_cloud-agents.md.DS8RIjwx.lean.js} +0 -0
  783. /package/dist/docs/assets/{index.md.Kiht7ell.lean.js → index.md.D75GWhPl.lean.js} +0 -0
  784. /package/dist/docs/assets/{reference_agent-config.md.BHeYMgme.lean.js → reference_agent-config.md.CHNpiyp4.lean.js} +0 -0
  785. /package/dist/docs/assets/{reference_cli.md.DfoeyvL0.lean.js → reference_cli.md.CJNc_xYK.lean.js} +0 -0
  786. /package/dist/docs/assets/{reference_playground.md.DnX5nL-B.lean.js → reference_playground.md.4myJPxrf.lean.js} +0 -0
  787. /package/dist/docs/assets/{reference_project-layout.md.CA6QP6Lw.lean.js → reference_project-layout.md.DuBu9a96.lean.js} +0 -0
  788. /package/dist/docs/assets/{reference_tools.md.B1up2r9W.lean.js → reference_tools.md.aGrn99hP.lean.js} +0 -0
  789. /package/dist/docs/assets/{skills_framework-map.md.DDa4MeEW.lean.js → skills_framework-map.md.haibFyoB.lean.js} +0 -0
@@ -0,0 +1,485 @@
1
+ /**
2
+ * `agent-sdk gitlab …` — replay a merge request into a local `gitlabChannel()`
3
+ * and list the discovered GitLab channels.
4
+ *
5
+ * There is no `gh webhook forward` analogue for GitLab: project hooks POST to
6
+ * a public URL, so live forwarding needs a tunnel (see `gitlab forward`,
7
+ * which prints the recipe rather than running one). Replay covers the local
8
+ * loop without either: it reads the MR over REST (`GITLAB_TOKEN`) and POSTs
9
+ * GitLab-shaped payloads with `X-Gitlab-Token` set from `--secret` /
10
+ * `GITLAB_WEBHOOK_SECRET`.
11
+ */
12
+
13
+ import { randomUUID } from "node:crypto";
14
+ import { mkdir, writeFile } from "node:fs/promises";
15
+ import { join, resolve as resolvePath } from "node:path";
16
+ import { channelForwardUrl } from "../channels/github/forward.js";
17
+ import {
18
+ createGitLabClient,
19
+ gitlabProjectPathSegment,
20
+ } from "../channels/gitlab/api.js";
21
+ import {
22
+ findGitLabChannelTargets,
23
+ type GitLabChannelTarget,
24
+ } from "../channels/gitlab/gitlab-channel.js";
25
+ import {
26
+ GITLAB_SYNTHESIZABLE_EVENTS,
27
+ parseGitLabMrRef,
28
+ type ReplayGitLabMergeRequest,
29
+ type ReplayGitLabPipeline,
30
+ type ReplayGitLabProject,
31
+ type SynthesizedGitLabEvent,
32
+ selectGitLabReplayEvents,
33
+ synthesizeGitLabEvent,
34
+ } from "../channels/gitlab/replay.js";
35
+ import { resolveAgentMounts } from "./discovery.js";
36
+ import { CLI_COMMAND_NAME as CLI } from "./distribution.js";
37
+
38
+ const DEFAULT_HOST = "127.0.0.1";
39
+ const DEFAULT_PORT = 3000;
40
+
41
+ export interface GitlabCliOptions {
42
+ dir: string;
43
+ slug?: string;
44
+ channel?: string;
45
+ host?: string;
46
+ port?: number;
47
+ /** Explicit delivery URL (skips URL derivation). */
48
+ url?: string;
49
+ /** Comma/space-separated event list, or `*` for the channel's declared set. */
50
+ events?: string;
51
+ /** Hook secret sent as `X-Gitlab-Token` (defaults to GITLAB_WEBHOOK_SECRET). */
52
+ secret?: string;
53
+ json?: boolean;
54
+ /** replay: MR URL or `group/project!N`. */
55
+ mrUrl?: string;
56
+ /** replay: merge_request action (open, update, close, reopen, approved…). */
57
+ action?: string;
58
+ /** replay: pipeline status (success, failed, running…). */
59
+ conclusion?: string;
60
+ /** replay: note body. */
61
+ comment?: string;
62
+ dryRun?: boolean;
63
+ out?: string;
64
+ }
65
+
66
+ const GITLAB_HELP = `${CLI} gitlab — replay GitLab merge-request webhooks into a local agent
67
+
68
+ Usage:
69
+ ${CLI} gitlab replay <mr_url|group/project!N> [--events a,b,c | *]
70
+ [--action A] [--conclusion STATUS] [--comment "…"]
71
+ [--dir .] [--slug S] [--channel C]
72
+ [--host H] [--port N] [--url URL] [--secret S]
73
+ [--dry-run] [--out DIR] [--json]
74
+ ${CLI} gitlab events [--dir .] [--host H] [--port N] [--json]
75
+ ${CLI} gitlab forward [--dir .] [--host H] [--port N]
76
+
77
+ Commands:
78
+ replay Synthesize webhook payloads from a merge request you can *read*
79
+ (Reporter access is enough) and POST them to the discovered
80
+ gitlabChannel()s. Reads the MR over the REST API with GITLAB_TOKEN,
81
+ builds GitLab-shaped payloads for --events (default merge_request;
82
+ \`*\` = the channel's declared events: ${GITLAB_SYNTHESIZABLE_EVENTS.join(", ")}),
83
+ and sets X-Gitlab-Token from --secret / GITLAB_WEBHOOK_SECRET.
84
+ --dry-run prints them; --out writes them as fixtures.
85
+ events List discovered GitLab channels and the object_kinds each accepts.
86
+ forward Print the project-hook + tunnel recipe for live deliveries. GitLab
87
+ has no \`gh webhook forward\` analogue: hooks need a reachable URL.
88
+
89
+ Prerequisites:
90
+ - GITLAB_TOKEN with read_api on the project (self-managed: also set
91
+ GITLAB_API_BASE_URL=https://<host>/api/v4, or pass a full MR URL).
92
+ - The agent already serving (\`${CLI} serve --dir . --dev\`).
93
+
94
+ See also: docs/guides/gitlab.md
95
+ `;
96
+
97
+ export async function cmdGitlab(
98
+ subcommand: string | undefined,
99
+ options: GitlabCliOptions
100
+ ): Promise<number> {
101
+ switch (subcommand) {
102
+ case undefined:
103
+ case "help":
104
+ case "--help":
105
+ case "-h":
106
+ process.stdout.write(GITLAB_HELP);
107
+ return subcommand === undefined ? 1 : 0;
108
+ case "replay":
109
+ return cmdGitlabReplay(options);
110
+ case "events":
111
+ return cmdGitlabEvents(options);
112
+ case "forward":
113
+ return cmdGitlabForward(options);
114
+ default:
115
+ process.stderr.write(`Unknown gitlab subcommand: ${subcommand}\n`);
116
+ process.stdout.write(GITLAB_HELP);
117
+ return 1;
118
+ }
119
+ }
120
+
121
+ interface ReplayTarget {
122
+ slug: string;
123
+ channelId: string;
124
+ url: string;
125
+ events: string[];
126
+ }
127
+
128
+ async function resolveTargets(
129
+ options: GitlabCliOptions
130
+ ): Promise<ReplayTarget[] | undefined> {
131
+ const dir = resolvePath(options.dir);
132
+ const channels = findGitLabChannelTargets(await resolveAgentMounts(dir));
133
+ const host = options.host ?? DEFAULT_HOST;
134
+ const port = options.port ?? DEFAULT_PORT;
135
+ let candidates: GitLabChannelTarget[] = channels;
136
+ if (options.slug !== undefined) {
137
+ candidates = candidates.filter((c) => c.slug === options.slug);
138
+ }
139
+ if (options.channel !== undefined) {
140
+ candidates = candidates.filter((c) => c.channelId === options.channel);
141
+ }
142
+ if (options.url !== undefined && candidates.length > 1) {
143
+ process.stderr.write(
144
+ "--url targets a single channel; narrow with --slug/--channel\n"
145
+ );
146
+ return undefined;
147
+ }
148
+ if (candidates.length === 0 && options.url === undefined) {
149
+ process.stderr.write(
150
+ "no GitLab channel found. Author agent/channels/gitlab.ts with gitlabChannel(), or pass --url.\n"
151
+ );
152
+ return undefined;
153
+ }
154
+ if (options.url !== undefined) {
155
+ return [
156
+ {
157
+ slug: candidates[0]?.slug ?? "",
158
+ channelId: candidates[0]?.channelId ?? "",
159
+ url: options.url,
160
+ events: candidates[0]?.events ?? [],
161
+ },
162
+ ];
163
+ }
164
+ return candidates.map((c) => ({
165
+ slug: c.slug,
166
+ channelId: c.channelId,
167
+ url: channelForwardUrl({
168
+ host,
169
+ port,
170
+ slug: c.slug,
171
+ channelId: c.channelId,
172
+ routePath: c.routePath,
173
+ }),
174
+ events: c.events,
175
+ }));
176
+ }
177
+
178
+ async function cmdGitlabReplay(options: GitlabCliOptions): Promise<number> {
179
+ const mrUrl = options.mrUrl;
180
+ if (mrUrl === undefined || mrUrl === "") {
181
+ process.stderr.write("gitlab replay needs an MR URL or group/project!N\n");
182
+ return 1;
183
+ }
184
+ const ref = parseGitLabMrRef(mrUrl);
185
+ if (ref === undefined) {
186
+ process.stderr.write(`could not parse merge request ref: ${mrUrl}\n`);
187
+ return 1;
188
+ }
189
+ const targets = await resolveTargets(options);
190
+ if (targets === undefined) {
191
+ return 1;
192
+ }
193
+
194
+ const requested = parseEventList(options.events);
195
+ const declared = [...new Set(targets.flatMap((target) => target.events))];
196
+ const { events, unsupported } = selectGitLabReplayEvents(requested, declared);
197
+ if (unsupported.length > 0) {
198
+ process.stderr.write(
199
+ `[agent-sdk] cannot synthesize (skipped): ${unsupported.join(", ")}\n`
200
+ );
201
+ }
202
+ if (events.length === 0) {
203
+ process.stderr.write("no synthesizable events selected\n");
204
+ return 1;
205
+ }
206
+
207
+ // Read the MR — Reporter access is enough.
208
+ const gitlab = createGitLabClient({
209
+ apiBaseUrl:
210
+ process.env.GITLAB_API_BASE_URL?.trim() || `${ref.origin}/api/v4`,
211
+ });
212
+ const projectSegment = gitlabProjectPathSegment(ref.projectPath);
213
+ let project: ReplayGitLabProject;
214
+ let mergeRequest: ReplayGitLabMergeRequest;
215
+ try {
216
+ project = await gitlab.request<ReplayGitLabProject>({
217
+ method: "GET",
218
+ path: `/projects/${projectSegment}`,
219
+ });
220
+ mergeRequest = await gitlab.request<ReplayGitLabMergeRequest>({
221
+ method: "GET",
222
+ path: `/projects/${projectSegment}/merge_requests/${ref.iid}`,
223
+ });
224
+ } catch (error) {
225
+ process.stderr.write(
226
+ `failed to read ${ref.label} via ${gitlab.apiBaseUrl}: ${
227
+ error instanceof Error ? error.message : String(error)
228
+ }\n`
229
+ );
230
+ return 1;
231
+ }
232
+ let pipeline: ReplayGitLabPipeline | undefined;
233
+ if (events.includes("pipeline")) {
234
+ pipeline = await gitlab
235
+ .request<ReplayGitLabPipeline[]>({
236
+ method: "GET",
237
+ path: `/projects/${projectSegment}/merge_requests/${ref.iid}/pipelines`,
238
+ })
239
+ .then((list) => list[0])
240
+ .catch(() => undefined);
241
+ }
242
+
243
+ const synthesized: SynthesizedGitLabEvent[] = [];
244
+ for (const event of events) {
245
+ const result = synthesizeGitLabEvent({
246
+ event,
247
+ project,
248
+ mergeRequest,
249
+ action: options.action,
250
+ comment: options.comment,
251
+ status: options.conclusion,
252
+ pipeline,
253
+ });
254
+ if ("error" in result) {
255
+ process.stderr.write(`[agent-sdk] skipping ${event}: ${result.error}\n`);
256
+ continue;
257
+ }
258
+ synthesized.push(result);
259
+ }
260
+ if (synthesized.length === 0) {
261
+ process.stderr.write("nothing to replay after synthesis\n");
262
+ return 1;
263
+ }
264
+
265
+ const secret = options.secret ?? process.env.GITLAB_WEBHOOK_SECRET;
266
+ process.stderr.write(
267
+ `[agent-sdk] replaying ${ref.label} (${synthesized
268
+ .map(eventLabel)
269
+ .join(
270
+ ", "
271
+ )}) → ${targets.length} channel${targets.length === 1 ? "" : "s"}\n`
272
+ );
273
+
274
+ const report: Array<Record<string, unknown>> = [];
275
+ let anyRejected = false;
276
+ for (const event of synthesized) {
277
+ const body = JSON.stringify(event.payload);
278
+ const headers: Record<string, string> = {
279
+ "content-type": "application/json",
280
+ "x-gitlab-event": event.header,
281
+ "x-gitlab-event-uuid": randomUUID(),
282
+ };
283
+ if (secret !== undefined && secret !== "") {
284
+ headers["x-gitlab-token"] = secret;
285
+ }
286
+ if (options.out !== undefined) {
287
+ const file = await writeReplayFixture(options.out, event);
288
+ process.stderr.write(`[agent-sdk] wrote ${file}\n`);
289
+ }
290
+ const label = eventLabel(event);
291
+ if (options.dryRun === true) {
292
+ report.push({ ...eventReport(event), payload: event.payload });
293
+ if (options.json !== true) {
294
+ process.stdout.write(
295
+ `--- ${label} ---\n${JSON.stringify(event.payload, null, 2)}\n`
296
+ );
297
+ }
298
+ continue;
299
+ }
300
+ const deliveries = await deliverReplayEvent(
301
+ body,
302
+ headers,
303
+ event.eventName,
304
+ targets
305
+ );
306
+ if (deliveries.length === 0 || deliveries.some((d) => !d.ok)) {
307
+ anyRejected = true;
308
+ }
309
+ report.push({ ...eventReport(event), deliveries });
310
+ if (options.json !== true) {
311
+ const summary =
312
+ deliveries
313
+ .map(
314
+ (d) => `${d.label} ${d.status || "ERR"}${d.ok ? "" : " (rejected)"}`
315
+ )
316
+ .join(", ") || "(no matching channel)";
317
+ process.stderr.write(`[agent-sdk] ${label} → ${summary}\n`);
318
+ }
319
+ }
320
+
321
+ if (options.json === true) {
322
+ process.stdout.write(
323
+ `${JSON.stringify(
324
+ { mr: ref.label, dryRun: options.dryRun === true, events: report },
325
+ null,
326
+ 2
327
+ )}\n`
328
+ );
329
+ }
330
+ return anyRejected ? 1 : 0;
331
+ }
332
+
333
+ interface ReplayDelivery {
334
+ label: string;
335
+ status: number;
336
+ ok: boolean;
337
+ error?: string;
338
+ }
339
+
340
+ async function deliverReplayEvent(
341
+ body: string,
342
+ headers: Record<string, string>,
343
+ eventName: string,
344
+ targets: readonly ReplayTarget[]
345
+ ): Promise<ReplayDelivery[]> {
346
+ const recipients = targets.filter(
347
+ (target) => target.events.length === 0 || target.events.includes(eventName)
348
+ );
349
+ return Promise.all(
350
+ recipients.map(async (target) => {
351
+ const label =
352
+ target.slug === ""
353
+ ? target.channelId
354
+ : `${target.slug}/${target.channelId}`;
355
+ try {
356
+ const response = await fetch(target.url, {
357
+ method: "POST",
358
+ headers,
359
+ body,
360
+ });
361
+ await response.text().catch(() => undefined);
362
+ return { label, status: response.status, ok: response.ok };
363
+ } catch (error) {
364
+ return {
365
+ label,
366
+ status: 0,
367
+ ok: false,
368
+ error: error instanceof Error ? error.message : String(error),
369
+ };
370
+ }
371
+ })
372
+ );
373
+ }
374
+
375
+ function eventLabel(event: SynthesizedGitLabEvent): string {
376
+ return event.action === undefined
377
+ ? event.eventName
378
+ : `${event.eventName}.${event.action}`;
379
+ }
380
+
381
+ function eventReport(event: SynthesizedGitLabEvent): Record<string, unknown> {
382
+ return { event: event.eventName, action: event.action };
383
+ }
384
+
385
+ async function writeReplayFixture(
386
+ outDir: string,
387
+ event: SynthesizedGitLabEvent
388
+ ): Promise<string> {
389
+ const dir = resolvePath(outDir);
390
+ await mkdir(dir, { recursive: true });
391
+ const file = join(dir, `gitlab-${eventLabel(event)}.json`);
392
+ await writeFile(file, `${JSON.stringify(event.payload, null, 2)}\n`);
393
+ return file;
394
+ }
395
+
396
+ async function cmdGitlabEvents(options: GitlabCliOptions): Promise<number> {
397
+ const dir = resolvePath(options.dir);
398
+ const channels = findGitLabChannelTargets(await resolveAgentMounts(dir));
399
+ const host = options.host ?? DEFAULT_HOST;
400
+ const port = options.port ?? DEFAULT_PORT;
401
+ const rows = channels.map((c) => ({
402
+ slug: c.slug,
403
+ channelId: c.channelId,
404
+ url: channelForwardUrl({
405
+ host,
406
+ port,
407
+ slug: c.slug,
408
+ channelId: c.channelId,
409
+ routePath: c.routePath,
410
+ }),
411
+ events: c.events,
412
+ }));
413
+ if (options.json === true) {
414
+ process.stdout.write(`${JSON.stringify({ channels: rows }, null, 2)}\n`);
415
+ return 0;
416
+ }
417
+ if (rows.length === 0) {
418
+ process.stdout.write("no GitLab channels found\n");
419
+ return 0;
420
+ }
421
+ for (const row of rows) {
422
+ const label =
423
+ row.slug === "" ? row.channelId : `${row.slug}/${row.channelId}`;
424
+ process.stdout.write(
425
+ `${label}\n ${row.url}\n ${row.events.join(", ")}\n`
426
+ );
427
+ }
428
+ return 0;
429
+ }
430
+
431
+ async function cmdGitlabForward(options: GitlabCliOptions): Promise<number> {
432
+ const dir = resolvePath(options.dir);
433
+ const channels = findGitLabChannelTargets(await resolveAgentMounts(dir));
434
+ const host = options.host ?? DEFAULT_HOST;
435
+ const port = options.port ?? DEFAULT_PORT;
436
+ if (channels.length === 0) {
437
+ process.stderr.write(
438
+ "no GitLab channel found. Author agent/channels/gitlab.ts with gitlabChannel().\n"
439
+ );
440
+ return 1;
441
+ }
442
+ const lines = [
443
+ "GitLab project hooks deliver to a public URL; there is no local relay.",
444
+ "To receive live deliveries:",
445
+ "",
446
+ ` 1. Expose the agent: e.g. \`cloudflared tunnel --url http://${host}:${port}\``,
447
+ " (or ngrok / any HTTPS tunnel) and note the public base URL.",
448
+ " 2. In GitLab → Project → Settings → Webhooks, add one hook per channel:",
449
+ ];
450
+ for (const c of channels) {
451
+ const path = channelForwardUrl({
452
+ host,
453
+ port,
454
+ slug: c.slug,
455
+ channelId: c.channelId,
456
+ routePath: c.routePath,
457
+ }).replace(`http://${host}:${port}`, "<tunnel>");
458
+ lines.push(` URL: ${path}`);
459
+ lines.push(` Trigger: ${c.events.join(", ")}`);
460
+ lines.push(
461
+ " Secret token: the value of GITLAB_WEBHOOK_SECRET (or webhookSecret)"
462
+ );
463
+ }
464
+ lines.push(
465
+ "",
466
+ ` 3. Serve with the secret set so X-Gitlab-Token is verified:`,
467
+ ` GITLAB_WEBHOOK_SECRET=… ${CLI} serve --dir . --dev`,
468
+ "",
469
+ `Without a tunnel, \`${CLI} gitlab replay <mr_url>\` exercises the same channel locally.`,
470
+ ""
471
+ );
472
+ process.stdout.write(lines.join("\n"));
473
+ return 0;
474
+ }
475
+
476
+ function parseEventList(value: string | undefined): string[] | undefined {
477
+ if (value === undefined) {
478
+ return undefined;
479
+ }
480
+ const events = value
481
+ .split(/[\s,]+/)
482
+ .map((event) => event.trim())
483
+ .filter(Boolean);
484
+ return events.length === 0 ? undefined : events;
485
+ }
@@ -37,6 +37,7 @@ import {
37
37
  resolveProdSlug,
38
38
  resolveProdTarget,
39
39
  } from "./resolve-prod-target.js";
40
+ import { sleep as defaultSleep } from "./sleep.js";
40
41
 
41
42
  /** Mount path of the MCP surface relative to an agent base URL. */
42
43
  const MCP_PATH = "/v1/mcp";
@@ -163,7 +164,7 @@ export async function cmdMcpServe(options: McpCliOptions): Promise<number> {
163
164
  const stdin = options.stdin ?? process.stdin;
164
165
  const stdout = options.stdout ?? process.stdout;
165
166
  const fetchImpl = options.fetchImpl ?? fetch;
166
- const sleep = options.sleep ?? sleepMs;
167
+ const sleep = options.sleep ?? defaultSleep;
167
168
  const pending = new Set<Promise<void>>();
168
169
 
169
170
  const handleLine = async (line: string): Promise<void> => {
@@ -836,9 +837,3 @@ function describeError(error: unknown): string {
836
837
  function defaultErr(text: string): void {
837
838
  process.stderr.write(text);
838
839
  }
839
-
840
- function sleepMs(ms: number): Promise<void> {
841
- return new Promise((resolve) => {
842
- setTimeout(resolve, ms);
843
- });
844
- }
@@ -1,5 +1,5 @@
1
1
  /**
2
- * `agent-serve slack …` CLI — doctor, destroy/icon, `create` as a
2
+ * `agent-sdk slack …` CLI — doctor, destroy/icon, `create` as a
3
3
  * dashboard-wizard launcher (`slack-provision-client.ts`), and
4
4
  * `init --manual` for Slack CLI / paste-at-api.slack.com manifests.
5
5
  */
@@ -39,6 +39,7 @@ import {
39
39
  type SlackWizardMintResult,
40
40
  type SlackWizardPollResult,
41
41
  } from "./slack-provision-client.js";
42
+ import { sleep } from "./sleep.js";
42
43
  import { stderrPalette, type TerminalPalette } from "./terminal-style.js";
43
44
 
44
45
  export interface SlackCliOptions {
@@ -884,7 +885,3 @@ async function fileExists(path: string): Promise<boolean> {
884
885
  function isErrnoException(error: unknown): error is NodeJS.ErrnoException {
885
886
  return error instanceof Error && "code" in error;
886
887
  }
887
-
888
- function sleep(ms: number): Promise<void> {
889
- return new Promise((resolvePromise) => setTimeout(resolvePromise, ms));
890
- }
@@ -1,5 +1,9 @@
1
+ import { getBitbucketChannelOptions } from "../channels/bitbucket/bitbucket-channel.js";
2
+ import { getChangeMonitorsChannelOptions } from "../channels/change-monitors/change-monitors-channel.js";
1
3
  import { getDeploymentsChannelOptions } from "../channels/deployments/deployments-channel.js";
2
4
  import { getGitHubChannelOptions } from "../channels/github/github-channel.js";
5
+ import { getGitLabChannelOptions } from "../channels/gitlab/gitlab-channel.js";
6
+ import { getIssuesChannelOptions } from "../channels/issues/issues-channel.js";
3
7
  import { getOriginChannelOptions } from "../channels/origin/origin-channel.js";
4
8
  import { getSlackChannelOptions } from "../channels/slack/slack-channel.js";
5
9
  import type {
@@ -14,6 +18,8 @@ import {
14
18
  defaultContinuationSelector,
15
19
  handshakeContinuation,
16
20
  normalizeIdentity,
21
+ omittedV2MembershipDowngrade,
22
+ omittedV2TypedType,
17
23
  } from "./continuation-identity.js";
18
24
 
19
25
  type ContinuationChannelOptions = {
@@ -21,10 +27,28 @@ type ContinuationChannelOptions = {
21
27
  };
22
28
 
23
29
  const CONTINUATION_CHANNEL_PACKS: ReadonlyArray<{
24
- kind: "github" | "slack" | "origin" | "deployments";
30
+ kind:
31
+ | "github"
32
+ | "slack"
33
+ | "origin"
34
+ | "gitlab"
35
+ | "bitbucket"
36
+ | "deployments"
37
+ | "change_monitors"
38
+ | "issues";
25
39
  getOptions: (definition: object) => ContinuationChannelOptions | undefined;
26
40
  usesDeclaredEvents: boolean;
27
41
  }> = [
42
+ {
43
+ kind: "gitlab",
44
+ getOptions: getGitLabChannelOptions,
45
+ usesDeclaredEvents: true,
46
+ },
47
+ {
48
+ kind: "bitbucket",
49
+ getOptions: getBitbucketChannelOptions,
50
+ usesDeclaredEvents: true,
51
+ },
28
52
  {
29
53
  kind: "github",
30
54
  getOptions: getGitHubChannelOptions,
@@ -45,6 +69,16 @@ const CONTINUATION_CHANNEL_PACKS: ReadonlyArray<{
45
69
  getOptions: getDeploymentsChannelOptions,
46
70
  usesDeclaredEvents: true,
47
71
  },
72
+ {
73
+ kind: "change_monitors",
74
+ getOptions: getChangeMonitorsChannelOptions,
75
+ usesDeclaredEvents: true,
76
+ },
77
+ {
78
+ kind: "issues",
79
+ getOptions: getIssuesChannelOptions,
80
+ usesDeclaredEvents: true,
81
+ },
48
82
  ];
49
83
 
50
84
  export function channelContinuationIdentity(
@@ -72,8 +106,10 @@ export function httpContinuationIdentity(
72
106
  * Stamp `/v2` continuation defaults onto channel constructors that omitted
73
107
  * `continuation` when the agent deploys onto v2 architecture. GitHub/Origin
74
108
  * type (`pr` / `issue` / `none`) follows declared webhook events.
75
- * Deployments default to `deployments.deployment/v2`. Explicit per-channel
76
- * selectors are left alone. Idempotent.
109
+ * Deployments default to `deployments.deployment/v2`. Change Monitors
110
+ * and issues default to `change_monitors.checkpoint/v2` and
111
+ * `issues.issue/v2`.
112
+ * Explicit per-channel selectors are left alone. Idempotent.
77
113
  */
78
114
  export function applyAgentContinuationDefaults(project: {
79
115
  agent: { architecture?: AgentArchitecture };
@@ -94,6 +130,65 @@ export function applyAgentContinuationDefaults(project: {
94
130
  }
95
131
  }
96
132
 
133
+ /**
134
+ * Warn when an omitted `/v2` selector became type `none` because one
135
+ * declared event sits outside the kind membership. Call before
136
+ * {@link applyAgentContinuationDefaults} so the omitted field is still
137
+ * visible. An explicit `*.none/v2` pin stays silent.
138
+ */
139
+ export function warnOmittedContinuationDowngrades(input: {
140
+ architecture?: AgentArchitecture;
141
+ channels: ReadonlyArray<{ id: string; definition: object }>;
142
+ warn: (id: string, message: string) => void;
143
+ }): void {
144
+ if (input.architecture !== "v2") {
145
+ return;
146
+ }
147
+ for (const channel of input.channels) {
148
+ const events = channelDeclaredEventTypes(
149
+ (channel.definition as ChannelDefinition).meta
150
+ );
151
+ for (const pack of CONTINUATION_CHANNEL_PACKS) {
152
+ const options = pack.getOptions(channel.definition);
153
+ if (options === undefined) {
154
+ continue;
155
+ }
156
+ if (options.continuation !== undefined) {
157
+ break;
158
+ }
159
+ const downgrade = omittedV2MembershipDowngrade(
160
+ pack.kind,
161
+ pack.usesDeclaredEvents ? events : undefined
162
+ );
163
+ if (downgrade !== undefined) {
164
+ input.warn(
165
+ channel.id,
166
+ omittedContinuationDowngradeMessage(pack.kind, downgrade)
167
+ );
168
+ }
169
+ break;
170
+ }
171
+ }
172
+ }
173
+
174
+ function omittedContinuationDowngradeMessage(
175
+ kind: string,
176
+ downgrade: {
177
+ selector: ContinuationIdentity;
178
+ unexpected: readonly string[];
179
+ }
180
+ ): string {
181
+ const membership = omittedV2TypedType(kind) ?? kind;
182
+ return (
183
+ `omitted continuation stamped ${downgrade.selector} because ` +
184
+ `${downgrade.unexpected.join(", ")} ${
185
+ downgrade.unexpected.length === 1 ? "is" : "are"
186
+ } not in the ${membership} membership; every delivery on this ` +
187
+ `channel starts a fresh session. Pin continuation: "${downgrade.selector}" ` +
188
+ `if that is intended, or drop the event.`
189
+ );
190
+ }
191
+
97
192
  function stampOmittedChannelContinuation(
98
193
  definition: object,
99
194
  version: ContinuationProtocolVersion
@@ -124,7 +219,10 @@ export function channelDeclaredEventTypes(
124
219
  return (
125
220
  meta?.githubWebhookEvents ??
126
221
  meta?.originWebhookEvents ??
127
- meta?.deploymentEventTypes
222
+ meta?.gitlabWebhookEvents ??
223
+ meta?.bitbucketWebhookEvents ??
224
+ meta?.deploymentEventTypes ??
225
+ meta?.factoryEventTypes
128
226
  );
129
227
  }
130
228