@grok/agent-sdk 0.0.0-stage → 0.2.27

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 (1966) hide show
  1. package/AGENTS.md +336 -0
  2. package/CHANGELOG.md +3 -0
  3. package/LICENSE.md +3 -0
  4. package/README.md +106 -2
  5. package/dist/artifacts.d.ts +37 -0
  6. package/dist/artifacts.d.ts.map +1 -0
  7. package/dist/artifacts.js +52 -0
  8. package/dist/bin/agent-sdk.js +2 -0
  9. package/dist/bin/agent-serve.d.ts +20 -0
  10. package/dist/bin/agent-serve.d.ts.map +1 -0
  11. package/dist/bin/agent-serve.js +1703 -0
  12. package/dist/channels/bitbucket/api.d.ts +217 -0
  13. package/dist/channels/bitbucket/api.d.ts.map +1 -0
  14. package/dist/channels/bitbucket/api.js +648 -0
  15. package/dist/channels/bitbucket/binding.d.ts +75 -0
  16. package/dist/channels/bitbucket/binding.d.ts.map +1 -0
  17. package/dist/channels/bitbucket/binding.js +313 -0
  18. package/dist/channels/bitbucket/bitbucket-channel.d.ts +47 -0
  19. package/dist/channels/bitbucket/bitbucket-channel.d.ts.map +1 -0
  20. package/dist/channels/bitbucket/bitbucket-channel.js +173 -0
  21. package/dist/channels/bitbucket/bitbucket-webhook.d.ts +73 -0
  22. package/dist/channels/bitbucket/bitbucket-webhook.d.ts.map +1 -0
  23. package/dist/channels/bitbucket/bitbucket-webhook.js +399 -0
  24. package/dist/channels/bitbucket/checks.d.ts +67 -0
  25. package/dist/channels/bitbucket/checks.d.ts.map +1 -0
  26. package/dist/channels/bitbucket/checks.js +90 -0
  27. package/dist/channels/bitbucket/cursor-account.d.ts +37 -0
  28. package/dist/channels/bitbucket/cursor-account.d.ts.map +1 -0
  29. package/dist/channels/bitbucket/cursor-account.js +65 -0
  30. package/dist/channels/bitbucket/defaults.d.ts +26 -0
  31. package/dist/channels/bitbucket/defaults.d.ts.map +1 -0
  32. package/dist/channels/bitbucket/defaults.js +77 -0
  33. package/dist/channels/bitbucket/events.d.ts +22 -0
  34. package/dist/channels/bitbucket/events.d.ts.map +1 -0
  35. package/dist/channels/bitbucket/events.js +59 -0
  36. package/dist/channels/bitbucket/index.d.ts +38 -0
  37. package/dist/channels/bitbucket/index.d.ts.map +1 -0
  38. package/dist/channels/bitbucket/index.js +37 -0
  39. package/dist/channels/bitbucket/replay.d.ts +63 -0
  40. package/dist/channels/bitbucket/replay.d.ts.map +1 -0
  41. package/dist/channels/bitbucket/replay.js +326 -0
  42. package/dist/channels/bitbucket/state.d.ts +35 -0
  43. package/dist/channels/bitbucket/state.d.ts.map +1 -0
  44. package/dist/channels/bitbucket/state.js +30 -0
  45. package/dist/channels/bitbucket/types.d.ts +236 -0
  46. package/dist/channels/bitbucket/types.d.ts.map +1 -0
  47. package/dist/channels/bitbucket/types.js +1 -0
  48. package/dist/channels/change-monitors/change-monitors-channel.d.ts +5 -0
  49. package/dist/channels/change-monitors/change-monitors-channel.d.ts.map +1 -0
  50. package/dist/channels/change-monitors/change-monitors-channel.js +45 -0
  51. package/dist/channels/change-monitors/index.d.ts +4 -0
  52. package/dist/channels/change-monitors/index.d.ts.map +1 -0
  53. package/dist/channels/change-monitors/index.js +2 -0
  54. package/dist/channels/change-monitors/types.d.ts +42 -0
  55. package/dist/channels/change-monitors/types.d.ts.map +1 -0
  56. package/dist/channels/change-monitors/types.js +1 -0
  57. package/dist/channels/checks.d.ts +121 -0
  58. package/dist/channels/checks.d.ts.map +1 -0
  59. package/dist/channels/checks.js +76 -0
  60. package/dist/channels/deployments/deployments-channel.d.ts +95 -0
  61. package/dist/channels/deployments/deployments-channel.d.ts.map +1 -0
  62. package/dist/channels/deployments/deployments-channel.js +188 -0
  63. package/dist/channels/deployments/index.d.ts +25 -0
  64. package/dist/channels/deployments/index.d.ts.map +1 -0
  65. package/dist/channels/deployments/index.js +24 -0
  66. package/dist/channels/deployments/types.d.ts +83 -0
  67. package/dist/channels/deployments/types.d.ts.map +1 -0
  68. package/dist/channels/deployments/types.js +7 -0
  69. package/dist/channels/github/api.d.ts +133 -0
  70. package/dist/channels/github/api.d.ts.map +1 -0
  71. package/dist/channels/github/api.js +373 -0
  72. package/dist/channels/github/auth.d.ts +71 -0
  73. package/dist/channels/github/auth.d.ts.map +1 -0
  74. package/dist/channels/github/auth.js +247 -0
  75. package/dist/channels/github/binding.d.ts +86 -0
  76. package/dist/channels/github/binding.d.ts.map +1 -0
  77. package/dist/channels/github/binding.js +123 -0
  78. package/dist/channels/github/checks.d.ts +64 -0
  79. package/dist/channels/github/checks.d.ts.map +1 -0
  80. package/dist/channels/github/checks.js +93 -0
  81. package/dist/channels/github/cursor-account.d.ts +109 -0
  82. package/dist/channels/github/cursor-account.d.ts.map +1 -0
  83. package/dist/channels/github/cursor-account.js +206 -0
  84. package/dist/channels/github/defaults.d.ts +23 -0
  85. package/dist/channels/github/defaults.d.ts.map +1 -0
  86. package/dist/channels/github/defaults.js +132 -0
  87. package/dist/channels/github/events.d.ts +18 -0
  88. package/dist/channels/github/events.d.ts.map +1 -0
  89. package/dist/channels/github/events.js +56 -0
  90. package/dist/channels/github/forward.d.ts +139 -0
  91. package/dist/channels/github/forward.d.ts.map +1 -0
  92. package/dist/channels/github/forward.js +263 -0
  93. package/dist/channels/github/github-channel.d.ts +187 -0
  94. package/dist/channels/github/github-channel.d.ts.map +1 -0
  95. package/dist/channels/github/github-channel.js +2089 -0
  96. package/dist/channels/github/index.d.ts +64 -0
  97. package/dist/channels/github/index.d.ts.map +1 -0
  98. package/dist/channels/github/index.js +52 -0
  99. package/dist/channels/github/progress.d.ts +84 -0
  100. package/dist/channels/github/progress.d.ts.map +1 -0
  101. package/dist/channels/github/progress.js +235 -0
  102. package/dist/channels/github/replay.d.ts +115 -0
  103. package/dist/channels/github/replay.d.ts.map +1 -0
  104. package/dist/channels/github/replay.js +269 -0
  105. package/dist/channels/github/state.d.ts +47 -0
  106. package/dist/channels/github/state.d.ts.map +1 -0
  107. package/dist/channels/github/state.js +77 -0
  108. package/dist/channels/github/types.d.ts +515 -0
  109. package/dist/channels/github/types.d.ts.map +1 -0
  110. package/dist/channels/github/types.js +1 -0
  111. package/dist/channels/gitlab/api.d.ts +118 -0
  112. package/dist/channels/gitlab/api.d.ts.map +1 -0
  113. package/dist/channels/gitlab/api.js +220 -0
  114. package/dist/channels/gitlab/binding.d.ts +63 -0
  115. package/dist/channels/gitlab/binding.d.ts.map +1 -0
  116. package/dist/channels/gitlab/binding.js +166 -0
  117. package/dist/channels/gitlab/checks.d.ts +110 -0
  118. package/dist/channels/gitlab/checks.d.ts.map +1 -0
  119. package/dist/channels/gitlab/checks.js +121 -0
  120. package/dist/channels/gitlab/cursor-account.d.ts +36 -0
  121. package/dist/channels/gitlab/cursor-account.d.ts.map +1 -0
  122. package/dist/channels/gitlab/cursor-account.js +64 -0
  123. package/dist/channels/gitlab/defaults.d.ts +25 -0
  124. package/dist/channels/gitlab/defaults.d.ts.map +1 -0
  125. package/dist/channels/gitlab/defaults.js +61 -0
  126. package/dist/channels/gitlab/events.d.ts +12 -0
  127. package/dist/channels/gitlab/events.d.ts.map +1 -0
  128. package/dist/channels/gitlab/events.js +26 -0
  129. package/dist/channels/gitlab/gitlab-channel.d.ts +48 -0
  130. package/dist/channels/gitlab/gitlab-channel.d.ts.map +1 -0
  131. package/dist/channels/gitlab/gitlab-channel.js +173 -0
  132. package/dist/channels/gitlab/gitlab-webhook.d.ts +54 -0
  133. package/dist/channels/gitlab/gitlab-webhook.d.ts.map +1 -0
  134. package/dist/channels/gitlab/gitlab-webhook.js +421 -0
  135. package/dist/channels/gitlab/index.d.ts +35 -0
  136. package/dist/channels/gitlab/index.d.ts.map +1 -0
  137. package/dist/channels/gitlab/index.js +34 -0
  138. package/dist/channels/gitlab/replay.d.ts +105 -0
  139. package/dist/channels/gitlab/replay.d.ts.map +1 -0
  140. package/dist/channels/gitlab/replay.js +222 -0
  141. package/dist/channels/gitlab/state.d.ts +33 -0
  142. package/dist/channels/gitlab/state.d.ts.map +1 -0
  143. package/dist/channels/gitlab/state.js +31 -0
  144. package/dist/channels/gitlab/types.d.ts +222 -0
  145. package/dist/channels/gitlab/types.d.ts.map +1 -0
  146. package/dist/channels/gitlab/types.js +1 -0
  147. package/dist/channels/issues/index.d.ts +4 -0
  148. package/dist/channels/issues/index.d.ts.map +1 -0
  149. package/dist/channels/issues/index.js +2 -0
  150. package/dist/channels/issues/issues-channel.d.ts +5 -0
  151. package/dist/channels/issues/issues-channel.d.ts.map +1 -0
  152. package/dist/channels/issues/issues-channel.js +35 -0
  153. package/dist/channels/issues/types.d.ts +33 -0
  154. package/dist/channels/issues/types.d.ts.map +1 -0
  155. package/dist/channels/issues/types.js +1 -0
  156. package/dist/channels/origin/api.d.ts +157 -0
  157. package/dist/channels/origin/api.d.ts.map +1 -0
  158. package/dist/channels/origin/api.js +363 -0
  159. package/dist/channels/origin/binding.d.ts +57 -0
  160. package/dist/channels/origin/binding.d.ts.map +1 -0
  161. package/dist/channels/origin/binding.js +56 -0
  162. package/dist/channels/origin/checks.d.ts +119 -0
  163. package/dist/channels/origin/checks.d.ts.map +1 -0
  164. package/dist/channels/origin/checks.js +147 -0
  165. package/dist/channels/origin/cursor-account.d.ts +24 -0
  166. package/dist/channels/origin/cursor-account.d.ts.map +1 -0
  167. package/dist/channels/origin/cursor-account.js +35 -0
  168. package/dist/channels/origin/defaults.d.ts +43 -0
  169. package/dist/channels/origin/defaults.d.ts.map +1 -0
  170. package/dist/channels/origin/defaults.js +94 -0
  171. package/dist/channels/origin/events.d.ts +10 -0
  172. package/dist/channels/origin/events.d.ts.map +1 -0
  173. package/dist/channels/origin/events.js +25 -0
  174. package/dist/channels/origin/index.d.ts +45 -0
  175. package/dist/channels/origin/index.d.ts.map +1 -0
  176. package/dist/channels/origin/index.js +33 -0
  177. package/dist/channels/origin/origin-channel.d.ts +72 -0
  178. package/dist/channels/origin/origin-channel.d.ts.map +1 -0
  179. package/dist/channels/origin/origin-channel.js +628 -0
  180. package/dist/channels/origin/origin-webhook.d.ts +69 -0
  181. package/dist/channels/origin/origin-webhook.d.ts.map +1 -0
  182. package/dist/channels/origin/origin-webhook.js +213 -0
  183. package/dist/channels/origin/reactions.d.ts +56 -0
  184. package/dist/channels/origin/reactions.d.ts.map +1 -0
  185. package/dist/channels/origin/reactions.js +46 -0
  186. package/dist/channels/origin/state.d.ts +32 -0
  187. package/dist/channels/origin/state.d.ts.map +1 -0
  188. package/dist/channels/origin/state.js +31 -0
  189. package/dist/channels/origin/types.d.ts +257 -0
  190. package/dist/channels/origin/types.d.ts.map +1 -0
  191. package/dist/channels/origin/types.js +1 -0
  192. package/dist/channels/pagerduty/api.d.ts +74 -0
  193. package/dist/channels/pagerduty/api.d.ts.map +1 -0
  194. package/dist/channels/pagerduty/api.js +101 -0
  195. package/dist/channels/pagerduty/defaults.d.ts +42 -0
  196. package/dist/channels/pagerduty/defaults.d.ts.map +1 -0
  197. package/dist/channels/pagerduty/defaults.js +132 -0
  198. package/dist/channels/pagerduty/events.d.ts +24 -0
  199. package/dist/channels/pagerduty/events.d.ts.map +1 -0
  200. package/dist/channels/pagerduty/events.js +38 -0
  201. package/dist/channels/pagerduty/index.d.ts +31 -0
  202. package/dist/channels/pagerduty/index.d.ts.map +1 -0
  203. package/dist/channels/pagerduty/index.js +30 -0
  204. package/dist/channels/pagerduty/pagerduty-channel.d.ts +64 -0
  205. package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -0
  206. package/dist/channels/pagerduty/pagerduty-channel.js +195 -0
  207. package/dist/channels/pagerduty/pagerduty-webhook.d.ts +70 -0
  208. package/dist/channels/pagerduty/pagerduty-webhook.d.ts.map +1 -0
  209. package/dist/channels/pagerduty/pagerduty-webhook.js +280 -0
  210. package/dist/channels/pagerduty/payload.d.ts +33 -0
  211. package/dist/channels/pagerduty/payload.d.ts.map +1 -0
  212. package/dist/channels/pagerduty/payload.js +150 -0
  213. package/dist/channels/pagerduty/replay.d.ts +35 -0
  214. package/dist/channels/pagerduty/replay.d.ts.map +1 -0
  215. package/dist/channels/pagerduty/replay.js +115 -0
  216. package/dist/channels/pagerduty/secrets.d.ts +16 -0
  217. package/dist/channels/pagerduty/secrets.d.ts.map +1 -0
  218. package/dist/channels/pagerduty/secrets.js +23 -0
  219. package/dist/channels/pagerduty/self-user.d.ts +51 -0
  220. package/dist/channels/pagerduty/self-user.d.ts.map +1 -0
  221. package/dist/channels/pagerduty/self-user.js +157 -0
  222. package/dist/channels/pagerduty/state.d.ts +31 -0
  223. package/dist/channels/pagerduty/state.d.ts.map +1 -0
  224. package/dist/channels/pagerduty/state.js +30 -0
  225. package/dist/channels/pagerduty/types.d.ts +217 -0
  226. package/dist/channels/pagerduty/types.d.ts.map +1 -0
  227. package/dist/channels/pagerduty/types.js +1 -0
  228. package/dist/channels/runs/index.d.ts +4 -0
  229. package/dist/channels/runs/index.d.ts.map +1 -0
  230. package/dist/channels/runs/index.js +2 -0
  231. package/dist/channels/runs/runs-channel.d.ts +5 -0
  232. package/dist/channels/runs/runs-channel.d.ts.map +1 -0
  233. package/dist/channels/runs/runs-channel.js +34 -0
  234. package/dist/channels/runs/types.d.ts +34 -0
  235. package/dist/channels/runs/types.d.ts.map +1 -0
  236. package/dist/channels/runs/types.js +1 -0
  237. package/dist/channels/slack/agentic-delivery.d.ts +24 -0
  238. package/dist/channels/slack/agentic-delivery.d.ts.map +1 -0
  239. package/dist/channels/slack/agentic-delivery.js +510 -0
  240. package/dist/channels/slack/agentic-posted.d.ts +30 -0
  241. package/dist/channels/slack/agentic-posted.d.ts.map +1 -0
  242. package/dist/channels/slack/agentic-posted.js +101 -0
  243. package/dist/channels/slack/agentic-signals.d.ts +43 -0
  244. package/dist/channels/slack/agentic-signals.d.ts.map +1 -0
  245. package/dist/channels/slack/agentic-signals.js +199 -0
  246. package/dist/channels/slack/api.d.ts +172 -0
  247. package/dist/channels/slack/api.d.ts.map +1 -0
  248. package/dist/channels/slack/api.js +642 -0
  249. package/dist/channels/slack/approvals.d.ts +48 -0
  250. package/dist/channels/slack/approvals.d.ts.map +1 -0
  251. package/dist/channels/slack/approvals.js +233 -0
  252. package/dist/channels/slack/assistant.d.ts +23 -0
  253. package/dist/channels/slack/assistant.d.ts.map +1 -0
  254. package/dist/channels/slack/assistant.js +57 -0
  255. package/dist/channels/slack/attachments.d.ts +85 -0
  256. package/dist/channels/slack/attachments.d.ts.map +1 -0
  257. package/dist/channels/slack/attachments.js +507 -0
  258. package/dist/channels/slack/auth.d.ts +46 -0
  259. package/dist/channels/slack/auth.d.ts.map +1 -0
  260. package/dist/channels/slack/auth.js +97 -0
  261. package/dist/channels/slack/blocks.d.ts +61 -0
  262. package/dist/channels/slack/blocks.d.ts.map +1 -0
  263. package/dist/channels/slack/blocks.js +90 -0
  264. package/dist/channels/slack/bot-mentions.d.ts +108 -0
  265. package/dist/channels/slack/bot-mentions.d.ts.map +1 -0
  266. package/dist/channels/slack/bot-mentions.js +243 -0
  267. package/dist/channels/slack/channel-watch.d.ts +80 -0
  268. package/dist/channels/slack/channel-watch.d.ts.map +1 -0
  269. package/dist/channels/slack/channel-watch.js +264 -0
  270. package/dist/channels/slack/cli-project.d.ts +19 -0
  271. package/dist/channels/slack/cli-project.d.ts.map +1 -0
  272. package/dist/channels/slack/cli-project.js +203 -0
  273. package/dist/channels/slack/code-fences.d.ts +17 -0
  274. package/dist/channels/slack/code-fences.d.ts.map +1 -0
  275. package/dist/channels/slack/code-fences.js +164 -0
  276. package/dist/channels/slack/constants.d.ts +27 -0
  277. package/dist/channels/slack/constants.d.ts.map +1 -0
  278. package/dist/channels/slack/constants.js +37 -0
  279. package/dist/channels/slack/credentials.d.ts +35 -0
  280. package/dist/channels/slack/credentials.d.ts.map +1 -0
  281. package/dist/channels/slack/credentials.js +73 -0
  282. package/dist/channels/slack/defaults.d.ts +50 -0
  283. package/dist/channels/slack/defaults.d.ts.map +1 -0
  284. package/dist/channels/slack/defaults.js +592 -0
  285. package/dist/channels/slack/dispatch.d.ts +153 -0
  286. package/dist/channels/slack/dispatch.d.ts.map +1 -0
  287. package/dist/channels/slack/dispatch.js +820 -0
  288. package/dist/channels/slack/doctor.d.ts +40 -0
  289. package/dist/channels/slack/doctor.d.ts.map +1 -0
  290. package/dist/channels/slack/doctor.js +277 -0
  291. package/dist/channels/slack/eval-directive.d.ts +59 -0
  292. package/dist/channels/slack/eval-directive.d.ts.map +1 -0
  293. package/dist/channels/slack/eval-directive.js +252 -0
  294. package/dist/channels/slack/event-id-dedupe.d.ts +10 -0
  295. package/dist/channels/slack/event-id-dedupe.d.ts.map +1 -0
  296. package/dist/channels/slack/event-id-dedupe.js +23 -0
  297. package/dist/channels/slack/external-policy.d.ts +28 -0
  298. package/dist/channels/slack/external-policy.d.ts.map +1 -0
  299. package/dist/channels/slack/external-policy.js +51 -0
  300. package/dist/channels/slack/footer.d.ts +33 -0
  301. package/dist/channels/slack/footer.d.ts.map +1 -0
  302. package/dist/channels/slack/footer.js +72 -0
  303. package/dist/channels/slack/inbound.d.ts +104 -0
  304. package/dist/channels/slack/inbound.d.ts.map +1 -0
  305. package/dist/channels/slack/inbound.js +350 -0
  306. package/dist/channels/slack/index.d.ts +56 -0
  307. package/dist/channels/slack/index.d.ts.map +1 -0
  308. package/dist/channels/slack/index.js +55 -0
  309. package/dist/channels/slack/init.d.ts +41 -0
  310. package/dist/channels/slack/init.d.ts.map +1 -0
  311. package/dist/channels/slack/init.js +109 -0
  312. package/dist/channels/slack/interactive.d.ts +73 -0
  313. package/dist/channels/slack/interactive.d.ts.map +1 -0
  314. package/dist/channels/slack/interactive.js +309 -0
  315. package/dist/channels/slack/links.d.ts +10 -0
  316. package/dist/channels/slack/links.d.ts.map +1 -0
  317. package/dist/channels/slack/links.js +18 -0
  318. package/dist/channels/slack/live-delivery.d.ts +80 -0
  319. package/dist/channels/slack/live-delivery.d.ts.map +1 -0
  320. package/dist/channels/slack/live-delivery.js +386 -0
  321. package/dist/channels/slack/log.d.ts +25 -0
  322. package/dist/channels/slack/log.d.ts.map +1 -0
  323. package/dist/channels/slack/log.js +44 -0
  324. package/dist/channels/slack/manifest.d.ts +80 -0
  325. package/dist/channels/slack/manifest.d.ts.map +1 -0
  326. package/dist/channels/slack/manifest.js +186 -0
  327. package/dist/channels/slack/message-body.d.ts +13 -0
  328. package/dist/channels/slack/message-body.d.ts.map +1 -0
  329. package/dist/channels/slack/message-body.js +74 -0
  330. package/dist/channels/slack/nudge-carrier.d.ts +21 -0
  331. package/dist/channels/slack/nudge-carrier.d.ts.map +1 -0
  332. package/dist/channels/slack/nudge-carrier.js +201 -0
  333. package/dist/channels/slack/nudge-store.d.ts +77 -0
  334. package/dist/channels/slack/nudge-store.d.ts.map +1 -0
  335. package/dist/channels/slack/nudge-store.js +288 -0
  336. package/dist/channels/slack/paint-start.d.ts +22 -0
  337. package/dist/channels/slack/paint-start.d.ts.map +1 -0
  338. package/dist/channels/slack/paint-start.js +76 -0
  339. package/dist/channels/slack/placeholder.d.ts +62 -0
  340. package/dist/channels/slack/placeholder.d.ts.map +1 -0
  341. package/dist/channels/slack/placeholder.js +237 -0
  342. package/dist/channels/slack/pr-ref.d.ts +24 -0
  343. package/dist/channels/slack/pr-ref.d.ts.map +1 -0
  344. package/dist/channels/slack/pr-ref.js +55 -0
  345. package/dist/channels/slack/progress-delivery.d.ts +28 -0
  346. package/dist/channels/slack/progress-delivery.d.ts.map +1 -0
  347. package/dist/channels/slack/progress-delivery.js +109 -0
  348. package/dist/channels/slack/reasoning-card.d.ts +38 -0
  349. package/dist/channels/slack/reasoning-card.d.ts.map +1 -0
  350. package/dist/channels/slack/reasoning-card.js +90 -0
  351. package/dist/channels/slack/reasoning-chip.d.ts +8 -0
  352. package/dist/channels/slack/reasoning-chip.d.ts.map +1 -0
  353. package/dist/channels/slack/reasoning-chip.js +30 -0
  354. package/dist/channels/slack/recording-sink.d.ts +29 -0
  355. package/dist/channels/slack/recording-sink.d.ts.map +1 -0
  356. package/dist/channels/slack/recording-sink.js +128 -0
  357. package/dist/channels/slack/redact.d.ts +2 -0
  358. package/dist/channels/slack/redact.d.ts.map +1 -0
  359. package/dist/channels/slack/redact.js +5 -0
  360. package/dist/channels/slack/reply-options.d.ts +56 -0
  361. package/dist/channels/slack/reply-options.d.ts.map +1 -0
  362. package/dist/channels/slack/reply-options.js +218 -0
  363. package/dist/channels/slack/self-identity.d.ts +18 -0
  364. package/dist/channels/slack/self-identity.d.ts.map +1 -0
  365. package/dist/channels/slack/self-identity.js +49 -0
  366. package/dist/channels/slack/sender-name.d.ts +26 -0
  367. package/dist/channels/slack/sender-name.d.ts.map +1 -0
  368. package/dist/channels/slack/sender-name.js +79 -0
  369. package/dist/channels/slack/setup.d.ts +33 -0
  370. package/dist/channels/slack/setup.d.ts.map +1 -0
  371. package/dist/channels/slack/setup.js +99 -0
  372. package/dist/channels/slack/slack-channel.d.ts +46 -0
  373. package/dist/channels/slack/slack-channel.d.ts.map +1 -0
  374. package/dist/channels/slack/slack-channel.js +683 -0
  375. package/dist/channels/slack/socket-mode.d.ts +26 -0
  376. package/dist/channels/slack/socket-mode.d.ts.map +1 -0
  377. package/dist/channels/slack/socket-mode.js +100 -0
  378. package/dist/channels/slack/stop.d.ts +14 -0
  379. package/dist/channels/slack/stop.d.ts.map +1 -0
  380. package/dist/channels/slack/stop.js +22 -0
  381. package/dist/channels/slack/stream.d.ts +42 -0
  382. package/dist/channels/slack/stream.d.ts.map +1 -0
  383. package/dist/channels/slack/stream.js +30 -0
  384. package/dist/channels/slack/thread-context.d.ts +89 -0
  385. package/dist/channels/slack/thread-context.d.ts.map +1 -0
  386. package/dist/channels/slack/thread-context.js +459 -0
  387. package/dist/channels/slack/tool-approval-events.d.ts +38 -0
  388. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -0
  389. package/dist/channels/slack/tool-approval-events.js +207 -0
  390. package/dist/channels/slack/tool-cards.d.ts +22 -0
  391. package/dist/channels/slack/tool-cards.d.ts.map +1 -0
  392. package/dist/channels/slack/tool-cards.js +167 -0
  393. package/dist/channels/slack/tool-chip.d.ts +9 -0
  394. package/dist/channels/slack/tool-chip.d.ts.map +1 -0
  395. package/dist/channels/slack/tool-chip.js +22 -0
  396. package/dist/channels/slack/types.d.ts +811 -0
  397. package/dist/channels/slack/types.d.ts.map +1 -0
  398. package/dist/channels/slack/types.js +4 -0
  399. package/dist/channels/slack/upload.d.ts +13 -0
  400. package/dist/channels/slack/upload.d.ts.map +1 -0
  401. package/dist/channels/slack/upload.js +122 -0
  402. package/dist/channels/slack/user-info.d.ts +16 -0
  403. package/dist/channels/slack/user-info.d.ts.map +1 -0
  404. package/dist/channels/slack/user-info.js +58 -0
  405. package/dist/channels.d.ts +188 -0
  406. package/dist/channels.d.ts.map +1 -0
  407. package/dist/channels.js +421 -0
  408. package/dist/connections.d.ts +160 -0
  409. package/dist/connections.d.ts.map +1 -0
  410. package/dist/connections.js +185 -0
  411. package/dist/dashboard-session-url.d.ts +15 -0
  412. package/dist/dashboard-session-url.d.ts.map +1 -0
  413. package/dist/dashboard-session-url.js +24 -0
  414. package/dist/docs/404.html +24 -0
  415. package/dist/docs/architecture.svg +59 -0
  416. package/dist/docs/assets/app.wA5xBBcd.js +309 -0
  417. package/dist/docs/assets/building-with-agents.md.FZXrY8Nk.js +9 -0
  418. package/dist/docs/assets/building-with-agents.md.FZXrY8Nk.lean.js +1 -0
  419. package/dist/docs/assets/changelog.md.BvHRIiMH.js +1 -0
  420. package/dist/docs/assets/changelog.md.BvHRIiMH.lean.js +1 -0
  421. package/dist/docs/assets/chunks/@localSearchIndexroot.BoDEJQWv.js +1 -0
  422. package/dist/docs/assets/chunks/VPLocalSearchBox.C29HLCVL.js +9 -0
  423. package/dist/docs/assets/chunks/arc.BOaoYWmh.js +1 -0
  424. package/dist/docs/assets/chunks/architectureDiagram-Q4EWVU46.MfG0itQh.js +36 -0
  425. package/dist/docs/assets/chunks/baseUniq.CUeJciCF.js +1 -0
  426. package/dist/docs/assets/chunks/blockDiagram-DXYQGD6D.BrXMZRtK.js +132 -0
  427. package/dist/docs/assets/chunks/c4Diagram-AHTNJAMY.DfkDHeB9.js +10 -0
  428. package/dist/docs/assets/chunks/channel.D2BTz0L-.js +1 -0
  429. package/dist/docs/assets/chunks/chunk-4BX2VUAB.xKz8CiXK.js +1 -0
  430. package/dist/docs/assets/chunks/chunk-4TB4RGXK.kkfBh4zk.js +206 -0
  431. package/dist/docs/assets/chunks/chunk-55IACEB6.BClJGb94.js +1 -0
  432. package/dist/docs/assets/chunks/chunk-EDXVE4YY.P9BpQ9L3.js +1 -0
  433. package/dist/docs/assets/chunks/chunk-FMBD7UC4.R4iYi58S.js +15 -0
  434. package/dist/docs/assets/chunks/chunk-OYMX7WX6.Cpn8L1dw.js +231 -0
  435. package/dist/docs/assets/chunks/chunk-QZHKN3VN.BLftECqU.js +1 -0
  436. package/dist/docs/assets/chunks/chunk-YZCP3GAM.BWDV1AYt.js +1 -0
  437. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DqByliAC.js +1 -0
  438. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DqByliAC.js +1 -0
  439. package/dist/docs/assets/chunks/clone.CldT1lbQ.js +1 -0
  440. package/dist/docs/assets/chunks/cose-bilkent-S5V4N54A.DGpAcJ55.js +1 -0
  441. package/dist/docs/assets/chunks/cytoscape.esm.BQk4lpUV.js +331 -0
  442. package/dist/docs/assets/chunks/dagre-KV5264BT.BBXxGEaD.js +4 -0
  443. package/dist/docs/assets/chunks/defaultLocale.C4B-KCzX.js +1 -0
  444. package/dist/docs/assets/chunks/diagram-5BDNPKRD.EKqOwmK2.js +10 -0
  445. package/dist/docs/assets/chunks/diagram-G4DWMVQ6.CB8pdkoZ.js +24 -0
  446. package/dist/docs/assets/chunks/diagram-MMDJMWI5.aHh4WGg9.js +43 -0
  447. package/dist/docs/assets/chunks/diagram-TYMM5635.YIsbRH20.js +24 -0
  448. package/dist/docs/assets/chunks/erDiagram-SMLLAGMA.B3bTCW_e.js +85 -0
  449. package/dist/docs/assets/chunks/flowDiagram-DWJPFMVM.M81hXIXZ.js +162 -0
  450. package/dist/docs/assets/chunks/framework.BNw1pucY.js +19 -0
  451. package/dist/docs/assets/chunks/ganttDiagram-T4ZO3ILL.BKg7WY--.js +292 -0
  452. package/dist/docs/assets/chunks/gitGraphDiagram-UUTBAWPF.CLEMZgO3.js +106 -0
  453. package/dist/docs/assets/chunks/graph.DS38W_Q-.js +1 -0
  454. package/dist/docs/assets/chunks/infoDiagram-42DDH7IO.BTiWTi82.js +2 -0
  455. package/dist/docs/assets/chunks/init.Gi6I4Gst.js +1 -0
  456. package/dist/docs/assets/chunks/ishikawaDiagram-UXIWVN3A.DcqY_KQL.js +70 -0
  457. package/dist/docs/assets/chunks/journeyDiagram-VCZTEJTY.0lQNZ40U.js +139 -0
  458. package/dist/docs/assets/chunks/kanban-definition-6JOO6SKY.L5sKlf7X.js +89 -0
  459. package/dist/docs/assets/chunks/katex.DkKDou_j.js +257 -0
  460. package/dist/docs/assets/chunks/layout.7u4gFhQa.js +1 -0
  461. package/dist/docs/assets/chunks/linear.D5v33SOb.js +1 -0
  462. package/dist/docs/assets/chunks/min.Dc9uCxf9.js +1 -0
  463. package/dist/docs/assets/chunks/mindmap-definition-QFDTVHPH.B56nGoB_.js +96 -0
  464. package/dist/docs/assets/chunks/ordinal.DBvzRdQf.js +1 -0
  465. package/dist/docs/assets/chunks/pieDiagram-DEJITSTG.Cba8e8lS.js +30 -0
  466. package/dist/docs/assets/chunks/quadrantDiagram-34T5L4WZ.2YjBycHF.js +7 -0
  467. package/dist/docs/assets/chunks/requirementDiagram-MS252O5E.D4P5RqVI.js +84 -0
  468. package/dist/docs/assets/chunks/sankeyDiagram-XADWPNL6.C0Hn8NUm.js +10 -0
  469. package/dist/docs/assets/chunks/sequenceDiagram-FGHM5R23.BZm7EaoT.js +157 -0
  470. package/dist/docs/assets/chunks/stateDiagram-FHFEXIEX.DcR4f3X2.js +1 -0
  471. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.Bb4oMe0P.js +1 -0
  472. package/dist/docs/assets/chunks/theme.DvfKzyXq.js +2 -0
  473. package/dist/docs/assets/chunks/timeline-definition-GMOUNBTQ.CgDh96vg.js +120 -0
  474. package/dist/docs/assets/chunks/vennDiagram-DHZGUBPP.B4fagbC8.js +34 -0
  475. package/dist/docs/assets/chunks/virtual_mermaid-config.DDnGl6nM.js +1 -0
  476. package/dist/docs/assets/chunks/wardley-RL74JXVD.Ck68omim.js +162 -0
  477. package/dist/docs/assets/chunks/wardleyDiagram-NUSXRM2D.DBUg0bvz.js +20 -0
  478. package/dist/docs/assets/chunks/xychartDiagram-5P7HB3ND.DnKSGQE1.js +7 -0
  479. package/dist/docs/assets/deployment.md.3MMWuPeV.js +31 -0
  480. package/dist/docs/assets/deployment.md.3MMWuPeV.lean.js +1 -0
  481. package/dist/docs/assets/evals.md.CHR34K1Y.js +68 -0
  482. package/dist/docs/assets/evals.md.CHR34K1Y.lean.js +1 -0
  483. package/dist/docs/assets/guides_agent-to-agent.md.CwL5cwuE.js +42 -0
  484. package/dist/docs/assets/guides_agent-to-agent.md.CwL5cwuE.lean.js +1 -0
  485. package/dist/docs/assets/guides_bitbucket.md.CKUayYtD.js +145 -0
  486. package/dist/docs/assets/guides_bitbucket.md.CKUayYtD.lean.js +1 -0
  487. package/dist/docs/assets/guides_cloud-agents.md.BzbzcOyj.js +9 -0
  488. package/dist/docs/assets/guides_cloud-agents.md.BzbzcOyj.lean.js +1 -0
  489. package/dist/docs/assets/guides_convert-automation.md.DMEX9nF-.js +43 -0
  490. package/dist/docs/assets/guides_convert-automation.md.DMEX9nF-.lean.js +1 -0
  491. package/dist/docs/assets/guides_export-grokbot.md.qo5bxi4h.js +55 -0
  492. package/dist/docs/assets/guides_export-grokbot.md.qo5bxi4h.lean.js +1 -0
  493. package/dist/docs/assets/guides_github.md.TuNiZAOQ.js +162 -0
  494. package/dist/docs/assets/guides_github.md.TuNiZAOQ.lean.js +1 -0
  495. package/dist/docs/assets/guides_gitlab.md.CtNI4fSH.js +153 -0
  496. package/dist/docs/assets/guides_gitlab.md.CtNI4fSH.lean.js +1 -0
  497. package/dist/docs/assets/guides_grokbot-agents.md.BwAykJ7U.js +15 -0
  498. package/dist/docs/assets/guides_grokbot-agents.md.BwAykJ7U.lean.js +1 -0
  499. package/dist/docs/assets/guides_hooks.md.B2XfGX50.js +54 -0
  500. package/dist/docs/assets/guides_hooks.md.B2XfGX50.lean.js +1 -0
  501. package/dist/docs/assets/guides_improve.md.CZKVt1cT.js +21 -0
  502. package/dist/docs/assets/guides_improve.md.CZKVt1cT.lean.js +1 -0
  503. package/dist/docs/assets/guides_jev.md.D7XH4JH3.js +151 -0
  504. package/dist/docs/assets/guides_jev.md.D7XH4JH3.lean.js +1 -0
  505. package/dist/docs/assets/guides_mcp-oauth.md.Cxq2TxBB.js +38 -0
  506. package/dist/docs/assets/guides_mcp-oauth.md.Cxq2TxBB.lean.js +1 -0
  507. package/dist/docs/assets/guides_migrate.md.CQlGaBKX.js +7 -0
  508. package/dist/docs/assets/guides_migrate.md.CQlGaBKX.lean.js +1 -0
  509. package/dist/docs/assets/guides_opentelemetry.md.D4wO7_8v.js +37 -0
  510. package/dist/docs/assets/guides_opentelemetry.md.D4wO7_8v.lean.js +1 -0
  511. package/dist/docs/assets/guides_pagerduty.md.BHXMcMtx.js +60 -0
  512. package/dist/docs/assets/guides_pagerduty.md.BHXMcMtx.lean.js +1 -0
  513. package/dist/docs/assets/guides_slack.md.ClIyi7FI.js +75 -0
  514. package/dist/docs/assets/guides_slack.md.ClIyi7FI.lean.js +1 -0
  515. package/dist/docs/assets/guides_webhooks.md.Cpdc3BDX.js +93 -0
  516. package/dist/docs/assets/guides_webhooks.md.Cpdc3BDX.lean.js +1 -0
  517. package/dist/docs/assets/hillclimbing.md.Dxvd-0gT.js +7 -0
  518. package/dist/docs/assets/hillclimbing.md.Dxvd-0gT.lean.js +1 -0
  519. package/dist/docs/assets/index.md.CAnsLl8D.js +27 -0
  520. package/dist/docs/assets/index.md.CAnsLl8D.lean.js +1 -0
  521. package/dist/docs/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 +0 -0
  522. package/dist/docs/assets/inter-italic-cyrillic.By2_1cv3.woff2 +0 -0
  523. package/dist/docs/assets/inter-italic-greek-ext.1u6EdAuj.woff2 +0 -0
  524. package/dist/docs/assets/inter-italic-greek.DJ8dCoTZ.woff2 +0 -0
  525. package/dist/docs/assets/inter-italic-latin-ext.CN1xVJS-.woff2 +0 -0
  526. package/dist/docs/assets/inter-italic-latin.C2AdPX0b.woff2 +0 -0
  527. package/dist/docs/assets/inter-italic-vietnamese.BSbpV94h.woff2 +0 -0
  528. package/dist/docs/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 +0 -0
  529. package/dist/docs/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 +0 -0
  530. package/dist/docs/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 +0 -0
  531. package/dist/docs/assets/inter-roman-greek.BBVDIX6e.woff2 +0 -0
  532. package/dist/docs/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 +0 -0
  533. package/dist/docs/assets/inter-roman-latin.Di8DUHzh.woff2 +0 -0
  534. package/dist/docs/assets/inter-roman-vietnamese.BjW4sHH5.woff2 +0 -0
  535. package/dist/docs/assets/quickstart.md.D8JDfkKO.js +170 -0
  536. package/dist/docs/assets/quickstart.md.D8JDfkKO.lean.js +1 -0
  537. package/dist/docs/assets/reference_agent-config.md.CZrbHOfT.js +38 -0
  538. package/dist/docs/assets/reference_agent-config.md.CZrbHOfT.lean.js +1 -0
  539. package/dist/docs/assets/reference_artifacts.md.DLV9MZES.js +18 -0
  540. package/dist/docs/assets/reference_artifacts.md.DLV9MZES.lean.js +1 -0
  541. package/dist/docs/assets/reference_channels.md.CNNIS6K7.js +22 -0
  542. package/dist/docs/assets/reference_channels.md.CNNIS6K7.lean.js +1 -0
  543. package/dist/docs/assets/reference_cli.md.1o_TqKdt.js +103 -0
  544. package/dist/docs/assets/reference_cli.md.1o_TqKdt.lean.js +1 -0
  545. package/dist/docs/assets/reference_connections.md.BJE2Zllp.js +66 -0
  546. package/dist/docs/assets/reference_connections.md.BJE2Zllp.lean.js +1 -0
  547. package/dist/docs/assets/reference_evals.md.Ccwp4x3o.js +56 -0
  548. package/dist/docs/assets/reference_evals.md.Ccwp4x3o.lean.js +1 -0
  549. package/dist/docs/assets/reference_extensions.md.DKxTuCIw.js +62 -0
  550. package/dist/docs/assets/reference_extensions.md.DKxTuCIw.lean.js +1 -0
  551. package/dist/docs/assets/reference_hooks.md.CROr0QgC.js +51 -0
  552. package/dist/docs/assets/reference_hooks.md.CROr0QgC.lean.js +1 -0
  553. package/dist/docs/assets/reference_http-api.md.Dji-DD_Z.js +11 -0
  554. package/dist/docs/assets/reference_http-api.md.Dji-DD_Z.lean.js +1 -0
  555. package/dist/docs/assets/reference_instructions.md.BYMVxAkw.js +14 -0
  556. package/dist/docs/assets/reference_instructions.md.BYMVxAkw.lean.js +1 -0
  557. package/dist/docs/assets/reference_memory.md.BwyJXYZe.js +4 -0
  558. package/dist/docs/assets/reference_memory.md.BwyJXYZe.lean.js +1 -0
  559. package/dist/docs/assets/reference_playground.md.q4MI-0td.js +1 -0
  560. package/dist/docs/assets/reference_playground.md.q4MI-0td.lean.js +1 -0
  561. package/dist/docs/assets/reference_project-layout.md.mFcS8yDD.js +25 -0
  562. package/dist/docs/assets/reference_project-layout.md.mFcS8yDD.lean.js +1 -0
  563. package/dist/docs/assets/reference_prompt.md.DqPh71XN.js +9 -0
  564. package/dist/docs/assets/reference_prompt.md.DqPh71XN.lean.js +1 -0
  565. package/dist/docs/assets/reference_schedules.md.BqWnJES4.js +47 -0
  566. package/dist/docs/assets/reference_schedules.md.BqWnJES4.lean.js +1 -0
  567. package/dist/docs/assets/reference_sessions.md.Bi6lHttM.js +22 -0
  568. package/dist/docs/assets/reference_sessions.md.Bi6lHttM.lean.js +1 -0
  569. package/dist/docs/assets/reference_skills.md.Ckddg6KX.js +15 -0
  570. package/dist/docs/assets/reference_skills.md.Ckddg6KX.lean.js +1 -0
  571. package/dist/docs/assets/reference_subagents.md.ChNGh6HK.js +10 -0
  572. package/dist/docs/assets/reference_subagents.md.ChNGh6HK.lean.js +1 -0
  573. package/dist/docs/assets/reference_tools.md.Bo0UfT0a.js +79 -0
  574. package/dist/docs/assets/reference_tools.md.Bo0UfT0a.lean.js +1 -0
  575. package/dist/docs/assets/style.B9o0luvp.css +1 -0
  576. package/dist/docs/assets/templates_agentic-owners.md.CTEnR0jp.js +13 -0
  577. package/dist/docs/assets/templates_agentic-owners.md.CTEnR0jp.lean.js +1 -0
  578. package/dist/docs/assets/templates_grokbot-agents.md.DgpPEs7B.js +5 -0
  579. package/dist/docs/assets/templates_grokbot-agents.md.DgpPEs7B.lean.js +1 -0
  580. package/dist/docs/assets/templates_security-reviewer.md.Gh6EF9Us.js +3 -0
  581. package/dist/docs/assets/templates_security-reviewer.md.Gh6EF9Us.lean.js +1 -0
  582. package/dist/docs/assets/templates_thermo-quality-review.md.B77UyTrX.js +3 -0
  583. package/dist/docs/assets/templates_thermo-quality-review.md.B77UyTrX.lean.js +1 -0
  584. package/dist/docs/assets/templates_thermo-review.md.DRJ7mC5U.js +3 -0
  585. package/dist/docs/assets/templates_thermo-review.md.DRJ7mC5U.lean.js +1 -0
  586. package/dist/docs/assets/templates_triage.md.CNN6b0JZ.js +9 -0
  587. package/dist/docs/assets/templates_triage.md.CNN6b0JZ.lean.js +1 -0
  588. package/dist/docs/assets/troubleshooting.md.DFnoTDlQ.js +1 -0
  589. package/dist/docs/assets/troubleshooting.md.DFnoTDlQ.lean.js +1 -0
  590. package/dist/docs/building-with-agents.html +68 -0
  591. package/dist/docs/building-with-agents.md +134 -0
  592. package/dist/docs/changelog.html +60 -0
  593. package/dist/docs/changelog.md +114 -0
  594. package/dist/docs/deployment.html +90 -0
  595. package/dist/docs/deployment.md +309 -0
  596. package/dist/docs/evals.html +127 -0
  597. package/dist/docs/evals.md +239 -0
  598. package/dist/docs/guides/agent-to-agent.html +101 -0
  599. package/dist/docs/guides/agent-to-agent.md +162 -0
  600. package/dist/docs/guides/bitbucket.html +204 -0
  601. package/dist/docs/guides/bitbucket.md +293 -0
  602. package/dist/docs/guides/cloud-agents.html +68 -0
  603. package/dist/docs/guides/cloud-agents.md +81 -0
  604. package/dist/docs/guides/convert-automation.html +102 -0
  605. package/dist/docs/guides/convert-automation.md +180 -0
  606. package/dist/docs/guides/export-grokbot.html +114 -0
  607. package/dist/docs/guides/export-grokbot.md +239 -0
  608. package/dist/docs/guides/github.html +221 -0
  609. package/dist/docs/guides/github.md +373 -0
  610. package/dist/docs/guides/gitlab.html +212 -0
  611. package/dist/docs/guides/gitlab.md +299 -0
  612. package/dist/docs/guides/grokbot-agents.html +74 -0
  613. package/dist/docs/guides/grokbot-agents.md +135 -0
  614. package/dist/docs/guides/hooks.html +113 -0
  615. package/dist/docs/guides/hooks.md +116 -0
  616. package/dist/docs/guides/improve.html +80 -0
  617. package/dist/docs/guides/improve.md +129 -0
  618. package/dist/docs/guides/jev.html +210 -0
  619. package/dist/docs/guides/jev.md +298 -0
  620. package/dist/docs/guides/mcp-oauth.html +97 -0
  621. package/dist/docs/guides/mcp-oauth.md +148 -0
  622. package/dist/docs/guides/migrate.html +66 -0
  623. package/dist/docs/guides/migrate.md +164 -0
  624. package/dist/docs/guides/opentelemetry.html +96 -0
  625. package/dist/docs/guides/opentelemetry.md +205 -0
  626. package/dist/docs/guides/pagerduty.html +119 -0
  627. package/dist/docs/guides/pagerduty.md +336 -0
  628. package/dist/docs/guides/slack.html +134 -0
  629. package/dist/docs/guides/slack.md +309 -0
  630. package/dist/docs/guides/webhooks.html +152 -0
  631. package/dist/docs/guides/webhooks.md +250 -0
  632. package/dist/docs/hashmap.json +1 -0
  633. package/dist/docs/hillclimbing.html +66 -0
  634. package/dist/docs/hillclimbing.md +134 -0
  635. package/dist/docs/index.html +86 -0
  636. package/dist/docs/index.md +110 -0
  637. package/dist/docs/llms-full.txt +10077 -0
  638. package/dist/docs/llms.txt +68 -0
  639. package/dist/docs/quickstart.html +229 -0
  640. package/dist/docs/quickstart.md +307 -0
  641. package/dist/docs/reference/agent-config.html +97 -0
  642. package/dist/docs/reference/agent-config.md +238 -0
  643. package/dist/docs/reference/artifacts.html +77 -0
  644. package/dist/docs/reference/artifacts.md +113 -0
  645. package/dist/docs/reference/channels.html +81 -0
  646. package/dist/docs/reference/channels.md +214 -0
  647. package/dist/docs/reference/cli.html +162 -0
  648. package/dist/docs/reference/cli.md +1098 -0
  649. package/dist/docs/reference/connections.html +125 -0
  650. package/dist/docs/reference/connections.md +307 -0
  651. package/dist/docs/reference/evals.html +115 -0
  652. package/dist/docs/reference/evals.md +294 -0
  653. package/dist/docs/reference/extensions.html +121 -0
  654. package/dist/docs/reference/extensions.md +209 -0
  655. package/dist/docs/reference/hooks.html +110 -0
  656. package/dist/docs/reference/hooks.md +197 -0
  657. package/dist/docs/reference/http-api.html +70 -0
  658. package/dist/docs/reference/http-api.md +221 -0
  659. package/dist/docs/reference/instructions.html +73 -0
  660. package/dist/docs/reference/instructions.md +64 -0
  661. package/dist/docs/reference/memory.html +63 -0
  662. package/dist/docs/reference/memory.md +114 -0
  663. package/dist/docs/reference/playground.html +60 -0
  664. package/dist/docs/reference/playground.md +36 -0
  665. package/dist/docs/reference/project-layout.html +84 -0
  666. package/dist/docs/reference/project-layout.md +117 -0
  667. package/dist/docs/reference/prompt.html +68 -0
  668. package/dist/docs/reference/prompt.md +47 -0
  669. package/dist/docs/reference/schedules.html +106 -0
  670. package/dist/docs/reference/schedules.md +190 -0
  671. package/dist/docs/reference/sessions.html +81 -0
  672. package/dist/docs/reference/sessions.md +200 -0
  673. package/dist/docs/reference/skills.html +74 -0
  674. package/dist/docs/reference/skills.md +72 -0
  675. package/dist/docs/reference/subagents.html +69 -0
  676. package/dist/docs/reference/subagents.md +61 -0
  677. package/dist/docs/reference/tools.html +138 -0
  678. package/dist/docs/reference/tools.md +306 -0
  679. package/dist/docs/templates/agentic-owners.html +72 -0
  680. package/dist/docs/templates/agentic-owners.md +126 -0
  681. package/dist/docs/templates/grokbot-agents.html +64 -0
  682. package/dist/docs/templates/grokbot-agents.md +55 -0
  683. package/dist/docs/templates/security-reviewer.html +62 -0
  684. package/dist/docs/templates/security-reviewer.md +81 -0
  685. package/dist/docs/templates/thermo-quality-review.html +62 -0
  686. package/dist/docs/templates/thermo-quality-review.md +75 -0
  687. package/dist/docs/templates/thermo-review.html +62 -0
  688. package/dist/docs/templates/thermo-review.md +75 -0
  689. package/dist/docs/templates/triage.html +68 -0
  690. package/dist/docs/templates/triage.md +101 -0
  691. package/dist/docs/troubleshooting.html +60 -0
  692. package/dist/docs/troubleshooting.md +149 -0
  693. package/dist/docs/vp-icons.css +0 -0
  694. package/dist/evals/assertions.d.ts +199 -0
  695. package/dist/evals/assertions.d.ts.map +1 -0
  696. package/dist/evals/assertions.js +447 -0
  697. package/dist/evals/expect.d.ts +95 -0
  698. package/dist/evals/expect.d.ts.map +1 -0
  699. package/dist/evals/expect.js +184 -0
  700. package/dist/evals/judge.d.ts +134 -0
  701. package/dist/evals/judge.d.ts.map +1 -0
  702. package/dist/evals/judge.js +221 -0
  703. package/dist/evals/loaders.d.ts +51 -0
  704. package/dist/evals/loaders.d.ts.map +1 -0
  705. package/dist/evals/loaders.js +107 -0
  706. package/dist/evals/matchers.d.ts +95 -0
  707. package/dist/evals/matchers.d.ts.map +1 -0
  708. package/dist/evals/matchers.js +141 -0
  709. package/dist/evals/reporters.d.ts +70 -0
  710. package/dist/evals/reporters.d.ts.map +1 -0
  711. package/dist/evals/reporters.js +196 -0
  712. package/dist/evals/results.d.ts +103 -0
  713. package/dist/evals/results.d.ts.map +1 -0
  714. package/dist/evals/results.js +27 -0
  715. package/dist/evals/run-facts.d.ts +77 -0
  716. package/dist/evals/run-facts.d.ts.map +1 -0
  717. package/dist/evals/run-facts.js +213 -0
  718. package/dist/evals.d.ts +446 -0
  719. package/dist/evals.d.ts.map +1 -0
  720. package/dist/evals.js +304 -0
  721. package/dist/executors.d.ts +11 -0
  722. package/dist/executors.d.ts.map +1 -0
  723. package/dist/executors.js +21 -0
  724. package/dist/extensions/cursor-cloud-agents/extension.d.ts +94 -0
  725. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -0
  726. package/dist/extensions/cursor-cloud-agents/extension.js +104 -0
  727. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +118 -0
  728. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -0
  729. package/dist/extensions/cursor-cloud-agents/lib/backend.js +290 -0
  730. package/dist/extensions/cursor-cloud-agents/lib/channels.d.ts +3 -0
  731. package/dist/extensions/cursor-cloud-agents/lib/channels.d.ts.map +1 -0
  732. package/dist/extensions/cursor-cloud-agents/lib/channels.js +11 -0
  733. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +25 -0
  734. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -0
  735. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +65 -0
  736. package/dist/extensions/cursor-cloud-agents/lib/inputs.d.ts +5 -0
  737. package/dist/extensions/cursor-cloud-agents/lib/inputs.d.ts.map +1 -0
  738. package/dist/extensions/cursor-cloud-agents/lib/inputs.js +4 -0
  739. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +47 -0
  740. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -0
  741. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +62 -0
  742. package/dist/extensions/cursor-cloud-agents/lib/repos.d.ts +17 -0
  743. package/dist/extensions/cursor-cloud-agents/lib/repos.d.ts.map +1 -0
  744. package/dist/extensions/cursor-cloud-agents/lib/repos.js +60 -0
  745. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts +8 -0
  746. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -0
  747. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +14 -0
  748. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +17 -0
  749. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -0
  750. package/dist/extensions/cursor-cloud-agents/lib/watch.js +85 -0
  751. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +19 -0
  752. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -0
  753. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +60 -0
  754. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +41 -0
  755. package/dist/extensions/cursor-cloud-agents/tools/cancel.d.ts +4 -0
  756. package/dist/extensions/cursor-cloud-agents/tools/cancel.d.ts.map +1 -0
  757. package/dist/extensions/cursor-cloud-agents/tools/cancel.js +19 -0
  758. package/dist/extensions/cursor-cloud-agents/tools/dump.d.ts +4 -0
  759. package/dist/extensions/cursor-cloud-agents/tools/dump.d.ts.map +1 -0
  760. package/dist/extensions/cursor-cloud-agents/tools/dump.js +43 -0
  761. package/dist/extensions/cursor-cloud-agents/tools/get.d.ts +4 -0
  762. package/dist/extensions/cursor-cloud-agents/tools/get.d.ts.map +1 -0
  763. package/dist/extensions/cursor-cloud-agents/tools/get.js +14 -0
  764. package/dist/extensions/cursor-cloud-agents/tools/launch.d.ts +4 -0
  765. package/dist/extensions/cursor-cloud-agents/tools/launch.d.ts.map +1 -0
  766. package/dist/extensions/cursor-cloud-agents/tools/launch.js +49 -0
  767. package/dist/extensions/cursor-cloud-agents/tools/list.d.ts +4 -0
  768. package/dist/extensions/cursor-cloud-agents/tools/list.d.ts.map +1 -0
  769. package/dist/extensions/cursor-cloud-agents/tools/list.js +25 -0
  770. package/dist/extensions/cursor-cloud-agents/tools/reply.d.ts +4 -0
  771. package/dist/extensions/cursor-cloud-agents/tools/reply.d.ts.map +1 -0
  772. package/dist/extensions/cursor-cloud-agents/tools/reply.js +26 -0
  773. package/dist/extensions/cursor-grokbot-agents/extension.d.ts +77 -0
  774. package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +1 -0
  775. package/dist/extensions/cursor-grokbot-agents/extension.js +70 -0
  776. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +11 -0
  777. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +1 -0
  778. package/dist/extensions/cursor-grokbot-agents/lib/agents.js +31 -0
  779. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +56 -0
  780. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +1 -0
  781. package/dist/extensions/cursor-grokbot-agents/lib/backend.js +138 -0
  782. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +28 -0
  783. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +1 -0
  784. package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +46 -0
  785. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +53 -0
  786. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +1 -0
  787. package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +186 -0
  788. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +4 -0
  789. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +1 -0
  790. package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +15 -0
  791. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +12 -0
  792. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +1 -0
  793. package/dist/extensions/cursor-grokbot-agents/lib/lock.js +24 -0
  794. package/dist/extensions/cursor-grokbot-agents/skills/consult.md +40 -0
  795. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +4 -0
  796. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +1 -0
  797. package/dist/extensions/cursor-grokbot-agents/tools/ask.js +26 -0
  798. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +4 -0
  799. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +1 -0
  800. package/dist/extensions/cursor-grokbot-agents/tools/check.js +21 -0
  801. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +4 -0
  802. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +1 -0
  803. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +13 -0
  804. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +4 -0
  805. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +1 -0
  806. package/dist/extensions/cursor-grokbot-agents/tools/list.js +22 -0
  807. package/dist/extensions/improve/extension.d.ts +48 -0
  808. package/dist/extensions/improve/extension.d.ts.map +1 -0
  809. package/dist/extensions/improve/extension.js +43 -0
  810. package/dist/extensions/improve/skills/yourself.d.ts +4 -0
  811. package/dist/extensions/improve/skills/yourself.d.ts.map +1 -0
  812. package/dist/extensions/improve/skills/yourself.js +43 -0
  813. package/dist/extensions/jev/extension.d.ts +46 -0
  814. package/dist/extensions/jev/extension.d.ts.map +1 -0
  815. package/dist/extensions/jev/extension.js +56 -0
  816. package/dist/extensions/jev/lib/evaluate.d.ts +105 -0
  817. package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -0
  818. package/dist/extensions/jev/lib/evaluate.js +154 -0
  819. package/dist/extensions/jev/skills/gated-write.md +25 -0
  820. package/dist/extensions/jev/skills/questions.md +33 -0
  821. package/dist/extensions/jev/tools/evaluate.d.ts +4 -0
  822. package/dist/extensions/jev/tools/evaluate.d.ts.map +1 -0
  823. package/dist/extensions/jev/tools/evaluate.js +72 -0
  824. package/dist/extensions/slack-communication/extension.d.ts +28 -0
  825. package/dist/extensions/slack-communication/extension.d.ts.map +1 -0
  826. package/dist/extensions/slack-communication/extension.js +32 -0
  827. package/dist/extensions/slack-communication/skills/slack-voice.d.ts +5 -0
  828. package/dist/extensions/slack-communication/skills/slack-voice.d.ts.map +1 -0
  829. package/dist/extensions/slack-communication/skills/slack-voice.js +52 -0
  830. package/dist/extensions/slack-communication/tools/delete-message.d.ts +4 -0
  831. package/dist/extensions/slack-communication/tools/delete-message.d.ts.map +1 -0
  832. package/dist/extensions/slack-communication/tools/delete-message.js +29 -0
  833. package/dist/extensions/slack-communication/tools/edit-message.d.ts +4 -0
  834. package/dist/extensions/slack-communication/tools/edit-message.d.ts.map +1 -0
  835. package/dist/extensions/slack-communication/tools/edit-message.js +34 -0
  836. package/dist/extensions/slack-communication/tools/post-card.d.ts +4 -0
  837. package/dist/extensions/slack-communication/tools/post-card.d.ts.map +1 -0
  838. package/dist/extensions/slack-communication/tools/post-card.js +25 -0
  839. package/dist/extensions/slack-communication/tools/post-file.d.ts +4 -0
  840. package/dist/extensions/slack-communication/tools/post-file.d.ts.map +1 -0
  841. package/dist/extensions/slack-communication/tools/post-file.js +75 -0
  842. package/dist/extensions/slack-communication/tools/post-update.d.ts +4 -0
  843. package/dist/extensions/slack-communication/tools/post-update.d.ts.map +1 -0
  844. package/dist/extensions/slack-communication/tools/post-update.js +33 -0
  845. package/dist/extensions/slack-communication/tools/react.d.ts +4 -0
  846. package/dist/extensions/slack-communication/tools/react.d.ts.map +1 -0
  847. package/dist/extensions/slack-communication/tools/react.js +27 -0
  848. package/dist/extensions/slack-communication/tools/set-status.d.ts +4 -0
  849. package/dist/extensions/slack-communication/tools/set-status.d.ts.map +1 -0
  850. package/dist/extensions/slack-communication/tools/set-status.js +18 -0
  851. package/dist/extensions.d.ts +87 -0
  852. package/dist/extensions.d.ts.map +1 -0
  853. package/dist/extensions.js +141 -0
  854. package/dist/files-backends/agent-store-presigned-url.d.ts +3 -0
  855. package/dist/files-backends/agent-store-presigned-url.d.ts.map +1 -0
  856. package/dist/files-backends/agent-store-presigned-url.js +223 -0
  857. package/dist/files-backends/cursor-hosted.d.ts +65 -0
  858. package/dist/files-backends/cursor-hosted.d.ts.map +1 -0
  859. package/dist/files-backends/cursor-hosted.js +848 -0
  860. package/dist/files-backends/local-fs.d.ts +33 -0
  861. package/dist/files-backends/local-fs.d.ts.map +1 -0
  862. package/dist/files-backends/local-fs.js +133 -0
  863. package/dist/files.d.ts +203 -0
  864. package/dist/files.d.ts.map +1 -0
  865. package/dist/files.js +129 -0
  866. package/dist/filesystem.d.ts +515 -0
  867. package/dist/filesystem.d.ts.map +1 -0
  868. package/dist/filesystem.js +1596 -0
  869. package/dist/hooks.d.ts +25 -0
  870. package/dist/hooks.d.ts.map +1 -0
  871. package/dist/hooks.js +25 -0
  872. package/dist/index.d.ts +87 -0
  873. package/dist/index.d.ts.map +1 -0
  874. package/dist/index.js +94 -0
  875. package/dist/internal/advertise-tools.d.ts +96 -0
  876. package/dist/internal/advertise-tools.d.ts.map +1 -0
  877. package/dist/internal/advertise-tools.js +255 -0
  878. package/dist/internal/approval-gate.d.ts +35 -0
  879. package/dist/internal/approval-gate.d.ts.map +1 -0
  880. package/dist/internal/approval-gate.js +81 -0
  881. package/dist/internal/artifacts-store.d.ts +123 -0
  882. package/dist/internal/artifacts-store.d.ts.map +1 -0
  883. package/dist/internal/artifacts-store.js +657 -0
  884. package/dist/internal/as-of.d.ts +39 -0
  885. package/dist/internal/as-of.d.ts.map +1 -0
  886. package/dist/internal/as-of.js +207 -0
  887. package/dist/internal/auth.d.ts +12 -0
  888. package/dist/internal/auth.d.ts.map +1 -0
  889. package/dist/internal/auth.js +34 -0
  890. package/dist/internal/authored-alias-hooks.d.ts +43 -0
  891. package/dist/internal/authored-alias-hooks.d.ts.map +1 -0
  892. package/dist/internal/authored-alias-hooks.js +104 -0
  893. package/dist/internal/authored-loaders.d.ts +50 -0
  894. package/dist/internal/authored-loaders.d.ts.map +1 -0
  895. package/dist/internal/authored-loaders.js +183 -0
  896. package/dist/internal/bounded-int.d.ts +11 -0
  897. package/dist/internal/bounded-int.d.ts.map +1 -0
  898. package/dist/internal/bounded-int.js +12 -0
  899. package/dist/internal/bounded.d.ts +7 -0
  900. package/dist/internal/bounded.d.ts.map +1 -0
  901. package/dist/internal/bounded.js +21 -0
  902. package/dist/internal/brand.d.ts +6 -0
  903. package/dist/internal/brand.d.ts.map +1 -0
  904. package/dist/internal/brand.js +17 -0
  905. package/dist/internal/browser-origin-guard.d.ts +19 -0
  906. package/dist/internal/browser-origin-guard.d.ts.map +1 -0
  907. package/dist/internal/browser-origin-guard.js +51 -0
  908. package/dist/internal/builtin-tools/artifacts.d.ts +10 -0
  909. package/dist/internal/builtin-tools/artifacts.d.ts.map +1 -0
  910. package/dist/internal/builtin-tools/artifacts.js +87 -0
  911. package/dist/internal/builtin-tools/index.d.ts +17 -0
  912. package/dist/internal/builtin-tools/index.d.ts.map +1 -0
  913. package/dist/internal/builtin-tools/index.js +39 -0
  914. package/dist/internal/builtin-tools/reminders.d.ts +9 -0
  915. package/dist/internal/builtin-tools/reminders.d.ts.map +1 -0
  916. package/dist/internal/builtin-tools/reminders.js +115 -0
  917. package/dist/internal/channel-architecture.d.ts +21 -0
  918. package/dist/internal/channel-architecture.d.ts.map +1 -0
  919. package/dist/internal/channel-architecture.js +43 -0
  920. package/dist/internal/channel-dispatch.d.ts +43 -0
  921. package/dist/internal/channel-dispatch.d.ts.map +1 -0
  922. package/dist/internal/channel-dispatch.js +74 -0
  923. package/dist/internal/channel-route-dispatch.d.ts +13 -0
  924. package/dist/internal/channel-route-dispatch.d.ts.map +1 -0
  925. package/dist/internal/channel-route-dispatch.js +51 -0
  926. package/dist/internal/channel-state.d.ts +17 -0
  927. package/dist/internal/channel-state.d.ts.map +1 -0
  928. package/dist/internal/channel-state.js +69 -0
  929. package/dist/internal/chat-client.d.ts +45 -0
  930. package/dist/internal/chat-client.d.ts.map +1 -0
  931. package/dist/internal/chat-client.js +457 -0
  932. package/dist/internal/cli-ax.d.ts +227 -0
  933. package/dist/internal/cli-ax.d.ts.map +1 -0
  934. package/dist/internal/cli-ax.js +1825 -0
  935. package/dist/internal/cli-bitbucket.d.ts +33 -0
  936. package/dist/internal/cli-bitbucket.d.ts.map +1 -0
  937. package/dist/internal/cli-bitbucket.js +332 -0
  938. package/dist/internal/cli-convert-automation.d.ts +39 -0
  939. package/dist/internal/cli-convert-automation.d.ts.map +1 -0
  940. package/dist/internal/cli-convert-automation.js +257 -0
  941. package/dist/internal/cli-cursor.d.ts +38 -0
  942. package/dist/internal/cli-cursor.d.ts.map +1 -0
  943. package/dist/internal/cli-cursor.js +205 -0
  944. package/dist/internal/cli-deploy.d.ts +171 -0
  945. package/dist/internal/cli-deploy.d.ts.map +1 -0
  946. package/dist/internal/cli-deploy.js +2072 -0
  947. package/dist/internal/cli-docs.d.ts +34 -0
  948. package/dist/internal/cli-docs.d.ts.map +1 -0
  949. package/dist/internal/cli-docs.js +156 -0
  950. package/dist/internal/cli-github.d.ts +47 -0
  951. package/dist/internal/cli-github.d.ts.map +1 -0
  952. package/dist/internal/cli-github.js +600 -0
  953. package/dist/internal/cli-gitlab.d.ts +37 -0
  954. package/dist/internal/cli-gitlab.d.ts.map +1 -0
  955. package/dist/internal/cli-gitlab.js +350 -0
  956. package/dist/internal/cli-images.d.ts +68 -0
  957. package/dist/internal/cli-images.d.ts.map +1 -0
  958. package/dist/internal/cli-images.js +536 -0
  959. package/dist/internal/cli-init-grokbot.d.ts +29 -0
  960. package/dist/internal/cli-init-grokbot.d.ts.map +1 -0
  961. package/dist/internal/cli-init-grokbot.js +181 -0
  962. package/dist/internal/cli-manifest.d.ts +19 -0
  963. package/dist/internal/cli-manifest.d.ts.map +1 -0
  964. package/dist/internal/cli-manifest.js +37 -0
  965. package/dist/internal/cli-mcp-oauth.d.ts +51 -0
  966. package/dist/internal/cli-mcp-oauth.d.ts.map +1 -0
  967. package/dist/internal/cli-mcp-oauth.js +300 -0
  968. package/dist/internal/cli-mcp.d.ts +75 -0
  969. package/dist/internal/cli-mcp.d.ts.map +1 -0
  970. package/dist/internal/cli-mcp.js +659 -0
  971. package/dist/internal/cli-migrate.d.ts +18 -0
  972. package/dist/internal/cli-migrate.d.ts.map +1 -0
  973. package/dist/internal/cli-migrate.js +351 -0
  974. package/dist/internal/cli-pagerduty.d.ts +32 -0
  975. package/dist/internal/cli-pagerduty.d.ts.map +1 -0
  976. package/dist/internal/cli-pagerduty.js +242 -0
  977. package/dist/internal/cli-skills.d.ts +21 -0
  978. package/dist/internal/cli-skills.d.ts.map +1 -0
  979. package/dist/internal/cli-skills.js +65 -0
  980. package/dist/internal/cli-slack-manual.d.ts +41 -0
  981. package/dist/internal/cli-slack-manual.d.ts.map +1 -0
  982. package/dist/internal/cli-slack-manual.js +296 -0
  983. package/dist/internal/cli-slack.d.ts +59 -0
  984. package/dist/internal/cli-slack.d.ts.map +1 -0
  985. package/dist/internal/cli-slack.js +708 -0
  986. package/dist/internal/cloud-merge.d.ts +25 -0
  987. package/dist/internal/cloud-merge.d.ts.map +1 -0
  988. package/dist/internal/cloud-merge.js +40 -0
  989. package/dist/internal/cloud-turn-usage.d.ts +34 -0
  990. package/dist/internal/cloud-turn-usage.d.ts.map +1 -0
  991. package/dist/internal/cloud-turn-usage.js +94 -0
  992. package/dist/internal/comment-safe.d.ts +8 -0
  993. package/dist/internal/comment-safe.d.ts.map +1 -0
  994. package/dist/internal/comment-safe.js +12 -0
  995. package/dist/internal/connection-env.d.ts +31 -0
  996. package/dist/internal/connection-env.d.ts.map +1 -0
  997. package/dist/internal/connection-env.js +83 -0
  998. package/dist/internal/continuation-channel.d.ts +48 -0
  999. package/dist/internal/continuation-channel.d.ts.map +1 -0
  1000. package/dist/internal/continuation-channel.js +170 -0
  1001. package/dist/internal/continuation-identity.d.ts +126 -0
  1002. package/dist/internal/continuation-identity.d.ts.map +1 -0
  1003. package/dist/internal/continuation-identity.js +897 -0
  1004. package/dist/internal/continuation.d.ts +3 -0
  1005. package/dist/internal/continuation.d.ts.map +1 -0
  1006. package/dist/internal/continuation.js +1 -0
  1007. package/dist/internal/conversation-mirror.d.ts +72 -0
  1008. package/dist/internal/conversation-mirror.d.ts.map +1 -0
  1009. package/dist/internal/conversation-mirror.js +401 -0
  1010. package/dist/internal/conversation-pack.d.ts +29 -0
  1011. package/dist/internal/conversation-pack.d.ts.map +1 -0
  1012. package/dist/internal/conversation-pack.js +96 -0
  1013. package/dist/internal/convert-automation/convert-workflow.d.ts +10 -0
  1014. package/dist/internal/convert-automation/convert-workflow.d.ts.map +1 -0
  1015. package/dist/internal/convert-automation/convert-workflow.js +976 -0
  1016. package/dist/internal/convert-automation/types.d.ts +202 -0
  1017. package/dist/internal/convert-automation/types.d.ts.map +1 -0
  1018. package/dist/internal/convert-automation/types.js +13 -0
  1019. package/dist/internal/convert-grokbot/answers.d.ts +127 -0
  1020. package/dist/internal/convert-grokbot/answers.d.ts.map +1 -0
  1021. package/dist/internal/convert-grokbot/answers.js +445 -0
  1022. package/dist/internal/convert-grokbot/bot.d.ts +50 -0
  1023. package/dist/internal/convert-grokbot/bot.d.ts.map +1 -0
  1024. package/dist/internal/convert-grokbot/bot.js +72 -0
  1025. package/dist/internal/convert-grokbot/checks.d.ts +26 -0
  1026. package/dist/internal/convert-grokbot/checks.d.ts.map +1 -0
  1027. package/dist/internal/convert-grokbot/checks.js +170 -0
  1028. package/dist/internal/convert-grokbot/convert.d.ts +60 -0
  1029. package/dist/internal/convert-grokbot/convert.d.ts.map +1 -0
  1030. package/dist/internal/convert-grokbot/convert.js +470 -0
  1031. package/dist/internal/convert-grokbot/handoff.d.ts +44 -0
  1032. package/dist/internal/convert-grokbot/handoff.d.ts.map +1 -0
  1033. package/dist/internal/convert-grokbot/handoff.js +160 -0
  1034. package/dist/internal/convert-grokbot/recipe.d.ts +61 -0
  1035. package/dist/internal/convert-grokbot/recipe.d.ts.map +1 -0
  1036. package/dist/internal/convert-grokbot/recipe.js +94 -0
  1037. package/dist/internal/convert-grokbot/routine.d.ts +51 -0
  1038. package/dist/internal/convert-grokbot/routine.d.ts.map +1 -0
  1039. package/dist/internal/convert-grokbot/routine.js +128 -0
  1040. package/dist/internal/convert-grokbot/slack.d.ts +28 -0
  1041. package/dist/internal/convert-grokbot/slack.d.ts.map +1 -0
  1042. package/dist/internal/convert-grokbot/slack.js +50 -0
  1043. package/dist/internal/cron.d.ts +17 -0
  1044. package/dist/internal/cron.d.ts.map +1 -0
  1045. package/dist/internal/cron.js +60 -0
  1046. package/dist/internal/cursor/account-mcp.d.ts +135 -0
  1047. package/dist/internal/cursor/account-mcp.d.ts.map +1 -0
  1048. package/dist/internal/cursor/account-mcp.js +513 -0
  1049. package/dist/internal/cursor/backend-client.d.ts +229 -0
  1050. package/dist/internal/cursor/backend-client.d.ts.map +1 -0
  1051. package/dist/internal/cursor/backend-client.js +700 -0
  1052. package/dist/internal/cursor/bound-secret-file.d.ts +56 -0
  1053. package/dist/internal/cursor/bound-secret-file.d.ts.map +1 -0
  1054. package/dist/internal/cursor/bound-secret-file.js +88 -0
  1055. package/dist/internal/cursor/credentials.d.ts +196 -0
  1056. package/dist/internal/cursor/credentials.d.ts.map +1 -0
  1057. package/dist/internal/cursor/credentials.js +463 -0
  1058. package/dist/internal/cursor/cursor-api-transport.d.ts +37 -0
  1059. package/dist/internal/cursor/cursor-api-transport.d.ts.map +1 -0
  1060. package/dist/internal/cursor/cursor-api-transport.js +40 -0
  1061. package/dist/internal/cursor/github-credentials.d.ts +44 -0
  1062. package/dist/internal/cursor/github-credentials.d.ts.map +1 -0
  1063. package/dist/internal/cursor/github-credentials.js +174 -0
  1064. package/dist/internal/cursor/hosted-bound-secrets.d.ts +45 -0
  1065. package/dist/internal/cursor/hosted-bound-secrets.d.ts.map +1 -0
  1066. package/dist/internal/cursor/hosted-bound-secrets.js +64 -0
  1067. package/dist/internal/cursor/hosted-deployment-secrets.d.ts +30 -0
  1068. package/dist/internal/cursor/hosted-deployment-secrets.d.ts.map +1 -0
  1069. package/dist/internal/cursor/hosted-deployment-secrets.js +97 -0
  1070. package/dist/internal/cursor/hosted-store-secrets.d.ts +39 -0
  1071. package/dist/internal/cursor/hosted-store-secrets.d.ts.map +1 -0
  1072. package/dist/internal/cursor/hosted-store-secrets.js +84 -0
  1073. package/dist/internal/cursor/session-token.d.ts +45 -0
  1074. package/dist/internal/cursor/session-token.d.ts.map +1 -0
  1075. package/dist/internal/cursor/session-token.js +85 -0
  1076. package/dist/internal/cursor/store-api-client.d.ts +60 -0
  1077. package/dist/internal/cursor/store-api-client.d.ts.map +1 -0
  1078. package/dist/internal/cursor/store-api-client.js +189 -0
  1079. package/dist/internal/cursor-account-mcp-auth.d.ts +70 -0
  1080. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -0
  1081. package/dist/internal/cursor-account-mcp-auth.js +233 -0
  1082. package/dist/internal/cursor-agent-template.d.ts +9 -0
  1083. package/dist/internal/cursor-agent-template.d.ts.map +1 -0
  1084. package/dist/internal/cursor-agent-template.js +43 -0
  1085. package/dist/internal/cursor-deployment-relay.d.ts +95 -0
  1086. package/dist/internal/cursor-deployment-relay.d.ts.map +1 -0
  1087. package/dist/internal/cursor-deployment-relay.js +212 -0
  1088. package/dist/internal/cursor-event-relay.d.ts +243 -0
  1089. package/dist/internal/cursor-event-relay.d.ts.map +1 -0
  1090. package/dist/internal/cursor-event-relay.js +430 -0
  1091. package/dist/internal/cursor-relay-core.d.ts +160 -0
  1092. package/dist/internal/cursor-relay-core.d.ts.map +1 -0
  1093. package/dist/internal/cursor-relay-core.js +442 -0
  1094. package/dist/internal/deferred-channel-session.d.ts +21 -0
  1095. package/dist/internal/deferred-channel-session.d.ts.map +1 -0
  1096. package/dist/internal/deferred-channel-session.js +55 -0
  1097. package/dist/internal/deploy-client.d.ts +604 -0
  1098. package/dist/internal/deploy-client.d.ts.map +1 -0
  1099. package/dist/internal/deploy-client.js +1009 -0
  1100. package/dist/internal/deploy-manifest.d.ts +179 -0
  1101. package/dist/internal/deploy-manifest.d.ts.map +1 -0
  1102. package/dist/internal/deploy-manifest.js +320 -0
  1103. package/dist/internal/deploy-source.d.ts +38 -0
  1104. package/dist/internal/deploy-source.d.ts.map +1 -0
  1105. package/dist/internal/deploy-source.js +124 -0
  1106. package/dist/internal/describe-error.d.ts +6 -0
  1107. package/dist/internal/describe-error.d.ts.map +1 -0
  1108. package/dist/internal/describe-error.js +31 -0
  1109. package/dist/internal/dev-mode.d.ts +13 -0
  1110. package/dist/internal/dev-mode.d.ts.map +1 -0
  1111. package/dist/internal/dev-mode.js +17 -0
  1112. package/dist/internal/discovery/agent-config.d.ts +55 -0
  1113. package/dist/internal/discovery/agent-config.d.ts.map +1 -0
  1114. package/dist/internal/discovery/agent-config.js +230 -0
  1115. package/dist/internal/discovery/agent.d.ts +16 -0
  1116. package/dist/internal/discovery/agent.d.ts.map +1 -0
  1117. package/dist/internal/discovery/agent.js +347 -0
  1118. package/dist/internal/discovery/channels.d.ts +10 -0
  1119. package/dist/internal/discovery/channels.d.ts.map +1 -0
  1120. package/dist/internal/discovery/channels.js +88 -0
  1121. package/dist/internal/discovery/connections.d.ts +13 -0
  1122. package/dist/internal/discovery/connections.d.ts.map +1 -0
  1123. package/dist/internal/discovery/connections.js +430 -0
  1124. package/dist/internal/discovery/context.d.ts +36 -0
  1125. package/dist/internal/discovery/context.d.ts.map +1 -0
  1126. package/dist/internal/discovery/context.js +84 -0
  1127. package/dist/internal/discovery/cursor-plugin.d.ts +25 -0
  1128. package/dist/internal/discovery/cursor-plugin.d.ts.map +1 -0
  1129. package/dist/internal/discovery/cursor-plugin.js +513 -0
  1130. package/dist/internal/discovery/extension-overlay.d.ts +31 -0
  1131. package/dist/internal/discovery/extension-overlay.d.ts.map +1 -0
  1132. package/dist/internal/discovery/extension-overlay.js +142 -0
  1133. package/dist/internal/discovery/extensions.d.ts +28 -0
  1134. package/dist/internal/discovery/extensions.d.ts.map +1 -0
  1135. package/dist/internal/discovery/extensions.js +376 -0
  1136. package/dist/internal/discovery/fs.d.ts +15 -0
  1137. package/dist/internal/discovery/fs.d.ts.map +1 -0
  1138. package/dist/internal/discovery/fs.js +92 -0
  1139. package/dist/internal/discovery/hooks.d.ts +7 -0
  1140. package/dist/internal/discovery/hooks.d.ts.map +1 -0
  1141. package/dist/internal/discovery/hooks.js +50 -0
  1142. package/dist/internal/discovery/info.d.ts +6 -0
  1143. package/dist/internal/discovery/info.d.ts.map +1 -0
  1144. package/dist/internal/discovery/info.js +166 -0
  1145. package/dist/internal/discovery/instructions.d.ts +7 -0
  1146. package/dist/internal/discovery/instructions.d.ts.map +1 -0
  1147. package/dist/internal/discovery/instructions.js +79 -0
  1148. package/dist/internal/discovery/instrumentation.d.ts +10 -0
  1149. package/dist/internal/discovery/instrumentation.d.ts.map +1 -0
  1150. package/dist/internal/discovery/instrumentation.js +29 -0
  1151. package/dist/internal/discovery/modules.d.ts +20 -0
  1152. package/dist/internal/discovery/modules.d.ts.map +1 -0
  1153. package/dist/internal/discovery/modules.js +88 -0
  1154. package/dist/internal/discovery/names.d.ts +14 -0
  1155. package/dist/internal/discovery/names.d.ts.map +1 -0
  1156. package/dist/internal/discovery/names.js +39 -0
  1157. package/dist/internal/discovery/project-public.d.ts +16 -0
  1158. package/dist/internal/discovery/project-public.d.ts.map +1 -0
  1159. package/dist/internal/discovery/project-public.js +54 -0
  1160. package/dist/internal/discovery/project.d.ts +57 -0
  1161. package/dist/internal/discovery/project.d.ts.map +1 -0
  1162. package/dist/internal/discovery/project.js +298 -0
  1163. package/dist/internal/discovery/reminders.d.ts +7 -0
  1164. package/dist/internal/discovery/reminders.d.ts.map +1 -0
  1165. package/dist/internal/discovery/reminders.js +54 -0
  1166. package/dist/internal/discovery/runtime.d.ts +34 -0
  1167. package/dist/internal/discovery/runtime.d.ts.map +1 -0
  1168. package/dist/internal/discovery/runtime.js +97 -0
  1169. package/dist/internal/discovery/schedules.d.ts +7 -0
  1170. package/dist/internal/discovery/schedules.d.ts.map +1 -0
  1171. package/dist/internal/discovery/schedules.js +107 -0
  1172. package/dist/internal/discovery/seed-files.d.ts +7 -0
  1173. package/dist/internal/discovery/seed-files.d.ts.map +1 -0
  1174. package/dist/internal/discovery/seed-files.js +30 -0
  1175. package/dist/internal/discovery/services.d.ts +27 -0
  1176. package/dist/internal/discovery/services.d.ts.map +1 -0
  1177. package/dist/internal/discovery/services.js +122 -0
  1178. package/dist/internal/discovery/skills.d.ts +11 -0
  1179. package/dist/internal/discovery/skills.d.ts.map +1 -0
  1180. package/dist/internal/discovery/skills.js +139 -0
  1181. package/dist/internal/discovery/subagent.d.ts +16 -0
  1182. package/dist/internal/discovery/subagent.d.ts.map +1 -0
  1183. package/dist/internal/discovery/subagent.js +113 -0
  1184. package/dist/internal/discovery/tools.d.ts +18 -0
  1185. package/dist/internal/discovery/tools.d.ts.map +1 -0
  1186. package/dist/internal/discovery/tools.js +144 -0
  1187. package/dist/internal/discovery.d.ts +15 -0
  1188. package/dist/internal/discovery.d.ts.map +1 -0
  1189. package/dist/internal/discovery.js +13 -0
  1190. package/dist/internal/distribution.d.ts +65 -0
  1191. package/dist/internal/distribution.d.ts.map +1 -0
  1192. package/dist/internal/distribution.js +102 -0
  1193. package/dist/internal/docs-site.d.ts +38 -0
  1194. package/dist/internal/docs-site.d.ts.map +1 -0
  1195. package/dist/internal/docs-site.js +216 -0
  1196. package/dist/internal/duration.d.ts +8 -0
  1197. package/dist/internal/duration.d.ts.map +1 -0
  1198. package/dist/internal/duration.js +35 -0
  1199. package/dist/internal/env-file.d.ts +19 -0
  1200. package/dist/internal/env-file.d.ts.map +1 -0
  1201. package/dist/internal/env-file.js +74 -0
  1202. package/dist/internal/estimate-cost.d.ts +55 -0
  1203. package/dist/internal/estimate-cost.d.ts.map +1 -0
  1204. package/dist/internal/estimate-cost.js +118 -0
  1205. package/dist/internal/eval-judge-model.d.ts +64 -0
  1206. package/dist/internal/eval-judge-model.d.ts.map +1 -0
  1207. package/dist/internal/eval-judge-model.js +129 -0
  1208. package/dist/internal/eval-run-store.d.ts +119 -0
  1209. package/dist/internal/eval-run-store.d.ts.map +1 -0
  1210. package/dist/internal/eval-run-store.js +479 -0
  1211. package/dist/internal/eval-runner.d.ts +106 -0
  1212. package/dist/internal/eval-runner.d.ts.map +1 -0
  1213. package/dist/internal/eval-runner.js +616 -0
  1214. package/dist/internal/eval-transport.d.ts +24 -0
  1215. package/dist/internal/eval-transport.d.ts.map +1 -0
  1216. package/dist/internal/eval-transport.js +22 -0
  1217. package/dist/internal/evals-client.d.ts +104 -0
  1218. package/dist/internal/evals-client.d.ts.map +1 -0
  1219. package/dist/internal/evals-client.js +299 -0
  1220. package/dist/internal/event-log.d.ts +94 -0
  1221. package/dist/internal/event-log.d.ts.map +1 -0
  1222. package/dist/internal/event-log.js +302 -0
  1223. package/dist/internal/event-mapper.d.ts +165 -0
  1224. package/dist/internal/event-mapper.d.ts.map +1 -0
  1225. package/dist/internal/event-mapper.js +665 -0
  1226. package/dist/internal/expected-delivery-failure.d.ts +3 -0
  1227. package/dist/internal/expected-delivery-failure.d.ts.map +1 -0
  1228. package/dist/internal/expected-delivery-failure.js +34 -0
  1229. package/dist/internal/factory-resource-channel.d.ts +33 -0
  1230. package/dist/internal/factory-resource-channel.d.ts.map +1 -0
  1231. package/dist/internal/factory-resource-channel.js +63 -0
  1232. package/dist/internal/filesystem/errors.d.ts +64 -0
  1233. package/dist/internal/filesystem/errors.d.ts.map +1 -0
  1234. package/dist/internal/filesystem/errors.js +172 -0
  1235. package/dist/internal/filesystem/format.d.ts +28 -0
  1236. package/dist/internal/filesystem/format.d.ts.map +1 -0
  1237. package/dist/internal/filesystem/format.js +209 -0
  1238. package/dist/internal/filesystem/merge.d.ts +34 -0
  1239. package/dist/internal/filesystem/merge.d.ts.map +1 -0
  1240. package/dist/internal/filesystem/merge.js +154 -0
  1241. package/dist/internal/filesystem/nearest.d.ts +15 -0
  1242. package/dist/internal/filesystem/nearest.d.ts.map +1 -0
  1243. package/dist/internal/filesystem/nearest.js +90 -0
  1244. package/dist/internal/filesystem/scratch.d.ts +60 -0
  1245. package/dist/internal/filesystem/scratch.d.ts.map +1 -0
  1246. package/dist/internal/filesystem/scratch.js +190 -0
  1247. package/dist/internal/filesystem/sdk-schemas.d.ts +29 -0
  1248. package/dist/internal/filesystem/sdk-schemas.d.ts.map +1 -0
  1249. package/dist/internal/filesystem/sdk-schemas.js +154 -0
  1250. package/dist/internal/filesystem/subagent-inherit.d.ts +39 -0
  1251. package/dist/internal/filesystem/subagent-inherit.d.ts.map +1 -0
  1252. package/dist/internal/filesystem/subagent-inherit.js +96 -0
  1253. package/dist/internal/filesystem/tools.d.ts +48 -0
  1254. package/dist/internal/filesystem/tools.d.ts.map +1 -0
  1255. package/dist/internal/filesystem/tools.js +648 -0
  1256. package/dist/internal/filesystem/walk.d.ts +77 -0
  1257. package/dist/internal/filesystem/walk.d.ts.map +1 -0
  1258. package/dist/internal/filesystem/walk.js +283 -0
  1259. package/dist/internal/framework-file-storage.d.ts +51 -0
  1260. package/dist/internal/framework-file-storage.d.ts.map +1 -0
  1261. package/dist/internal/framework-file-storage.js +291 -0
  1262. package/dist/internal/framework-storage-selection.d.ts +30 -0
  1263. package/dist/internal/framework-storage-selection.d.ts.map +1 -0
  1264. package/dist/internal/framework-storage-selection.js +84 -0
  1265. package/dist/internal/frontmatter.d.ts +20 -0
  1266. package/dist/internal/frontmatter.d.ts.map +1 -0
  1267. package/dist/internal/frontmatter.js +85 -0
  1268. package/dist/internal/github-fanout.d.ts +32 -0
  1269. package/dist/internal/github-fanout.d.ts.map +1 -0
  1270. package/dist/internal/github-fanout.js +106 -0
  1271. package/dist/internal/guest-network.d.ts +98 -0
  1272. package/dist/internal/guest-network.d.ts.map +1 -0
  1273. package/dist/internal/guest-network.js +313 -0
  1274. package/dist/internal/handleAgentServeTrigger.d.ts +98 -0
  1275. package/dist/internal/handleAgentServeTrigger.d.ts.map +1 -0
  1276. package/dist/internal/handleAgentServeTrigger.js +194 -0
  1277. package/dist/internal/hmac-secret-values.d.ts +48 -0
  1278. package/dist/internal/hmac-secret-values.d.ts.map +1 -0
  1279. package/dist/internal/hmac-secret-values.js +68 -0
  1280. package/dist/internal/host-files.d.ts +29 -0
  1281. package/dist/internal/host-files.d.ts.map +1 -0
  1282. package/dist/internal/host-files.js +256 -0
  1283. package/dist/internal/host-kv.d.ts +21 -0
  1284. package/dist/internal/host-kv.d.ts.map +1 -0
  1285. package/dist/internal/host-kv.js +62 -0
  1286. package/dist/internal/host-otel.d.ts +26 -0
  1287. package/dist/internal/host-otel.d.ts.map +1 -0
  1288. package/dist/internal/host-otel.js +184 -0
  1289. package/dist/internal/host-platforms.d.ts +58 -0
  1290. package/dist/internal/host-platforms.d.ts.map +1 -0
  1291. package/dist/internal/host-platforms.js +118 -0
  1292. package/dist/internal/hosted-admission-adapter.d.ts +36 -0
  1293. package/dist/internal/hosted-admission-adapter.d.ts.map +1 -0
  1294. package/dist/internal/hosted-admission-adapter.js +7 -0
  1295. package/dist/internal/hosted-admission-context.d.ts +20 -0
  1296. package/dist/internal/hosted-admission-context.d.ts.map +1 -0
  1297. package/dist/internal/hosted-admission-context.js +31 -0
  1298. package/dist/internal/hosted-catch-protocol.d.ts +54 -0
  1299. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -0
  1300. package/dist/internal/hosted-catch-protocol.js +90 -0
  1301. package/dist/internal/hosted-catch.d.ts +42 -0
  1302. package/dist/internal/hosted-catch.d.ts.map +1 -0
  1303. package/dist/internal/hosted-catch.js +154 -0
  1304. package/dist/internal/hosted-delivery-protocol.d.ts +275 -0
  1305. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -0
  1306. package/dist/internal/hosted-delivery-protocol.js +708 -0
  1307. package/dist/internal/hosted-delivery.d.ts +135 -0
  1308. package/dist/internal/hosted-delivery.d.ts.map +1 -0
  1309. package/dist/internal/hosted-delivery.js +1098 -0
  1310. package/dist/internal/hosted-eval-cases.d.ts +21 -0
  1311. package/dist/internal/hosted-eval-cases.d.ts.map +1 -0
  1312. package/dist/internal/hosted-eval-cases.js +162 -0
  1313. package/dist/internal/hosted-execution-diag.d.ts +64 -0
  1314. package/dist/internal/hosted-execution-diag.d.ts.map +1 -0
  1315. package/dist/internal/hosted-execution-diag.js +219 -0
  1316. package/dist/internal/hosted-execution-flush.d.ts +65 -0
  1317. package/dist/internal/hosted-execution-flush.d.ts.map +1 -0
  1318. package/dist/internal/hosted-execution-flush.js +113 -0
  1319. package/dist/internal/hosted-execution-latency.d.ts +80 -0
  1320. package/dist/internal/hosted-execution-latency.d.ts.map +1 -0
  1321. package/dist/internal/hosted-execution-latency.js +226 -0
  1322. package/dist/internal/hosted-managed-automation.d.ts +30 -0
  1323. package/dist/internal/hosted-managed-automation.d.ts.map +1 -0
  1324. package/dist/internal/hosted-managed-automation.js +83 -0
  1325. package/dist/internal/hosting.d.ts +62 -0
  1326. package/dist/internal/hosting.d.ts.map +1 -0
  1327. package/dist/internal/hosting.js +130 -0
  1328. package/dist/internal/http-channel-define.d.ts +11 -0
  1329. package/dist/internal/http-channel-define.d.ts.map +1 -0
  1330. package/dist/internal/http-channel-define.js +21 -0
  1331. package/dist/internal/http-channel.d.ts +54 -0
  1332. package/dist/internal/http-channel.d.ts.map +1 -0
  1333. package/dist/internal/http-channel.js +543 -0
  1334. package/dist/internal/http-control-plane-session.d.ts +54 -0
  1335. package/dist/internal/http-control-plane-session.d.ts.map +1 -0
  1336. package/dist/internal/http-control-plane-session.js +163 -0
  1337. package/dist/internal/ids.d.ts +27 -0
  1338. package/dist/internal/ids.d.ts.map +1 -0
  1339. package/dist/internal/ids.js +54 -0
  1340. package/dist/internal/incoming-headers-to-fetch.d.ts +10 -0
  1341. package/dist/internal/incoming-headers-to-fetch.d.ts.map +1 -0
  1342. package/dist/internal/incoming-headers-to-fetch.js +40 -0
  1343. package/dist/internal/init-interview.d.ts +64 -0
  1344. package/dist/internal/init-interview.d.ts.map +1 -0
  1345. package/dist/internal/init-interview.js +193 -0
  1346. package/dist/internal/init-project.d.ts +188 -0
  1347. package/dist/internal/init-project.d.ts.map +1 -0
  1348. package/dist/internal/init-project.js +492 -0
  1349. package/dist/internal/init-scaffold.d.ts +20 -0
  1350. package/dist/internal/init-scaffold.d.ts.map +1 -0
  1351. package/dist/internal/init-scaffold.js +194 -0
  1352. package/dist/internal/inline-stdio-define-stub.d.ts +3 -0
  1353. package/dist/internal/inline-stdio-define-stub.d.ts.map +1 -0
  1354. package/dist/internal/inline-stdio-define-stub.js +4 -0
  1355. package/dist/internal/inline-stdio-mcp.d.ts +34 -0
  1356. package/dist/internal/inline-stdio-mcp.d.ts.map +1 -0
  1357. package/dist/internal/inline-stdio-mcp.js +170 -0
  1358. package/dist/internal/install-cursor-skills.d.ts +160 -0
  1359. package/dist/internal/install-cursor-skills.d.ts.map +1 -0
  1360. package/dist/internal/install-cursor-skills.js +464 -0
  1361. package/dist/internal/interview/agent-questions.d.ts +19 -0
  1362. package/dist/internal/interview/agent-questions.d.ts.map +1 -0
  1363. package/dist/internal/interview/agent-questions.js +120 -0
  1364. package/dist/internal/interview/question.d.ts +82 -0
  1365. package/dist/internal/interview/question.d.ts.map +1 -0
  1366. package/dist/internal/interview/question.js +198 -0
  1367. package/dist/internal/is-record.d.ts +2 -0
  1368. package/dist/internal/is-record.d.ts.map +1 -0
  1369. package/dist/internal/is-record.js +3 -0
  1370. package/dist/internal/json-schema.d.ts +25 -0
  1371. package/dist/internal/json-schema.d.ts.map +1 -0
  1372. package/dist/internal/json-schema.js +69 -0
  1373. package/dist/internal/legacy-command-guard.d.ts +24 -0
  1374. package/dist/internal/legacy-command-guard.d.ts.map +1 -0
  1375. package/dist/internal/legacy-command-guard.js +47 -0
  1376. package/dist/internal/listen-port.d.ts +22 -0
  1377. package/dist/internal/listen-port.d.ts.map +1 -0
  1378. package/dist/internal/listen-port.js +66 -0
  1379. package/dist/internal/local-control-plane.d.ts +59 -0
  1380. package/dist/internal/local-control-plane.d.ts.map +1 -0
  1381. package/dist/internal/local-control-plane.js +341 -0
  1382. package/dist/internal/local-env.d.ts +10 -0
  1383. package/dist/internal/local-env.d.ts.map +1 -0
  1384. package/dist/internal/local-env.js +55 -0
  1385. package/dist/internal/local-ingress.d.ts +35 -0
  1386. package/dist/internal/local-ingress.d.ts.map +1 -0
  1387. package/dist/internal/local-ingress.js +50 -0
  1388. package/dist/internal/log-ring.d.ts +23 -0
  1389. package/dist/internal/log-ring.d.ts.map +1 -0
  1390. package/dist/internal/log-ring.js +41 -0
  1391. package/dist/internal/logs-client.d.ts +98 -0
  1392. package/dist/internal/logs-client.d.ts.map +1 -0
  1393. package/dist/internal/logs-client.js +418 -0
  1394. package/dist/internal/map-pool.d.ts +11 -0
  1395. package/dist/internal/map-pool.d.ts.map +1 -0
  1396. package/dist/internal/map-pool.js +34 -0
  1397. package/dist/internal/mcp-endpoint.d.ts +84 -0
  1398. package/dist/internal/mcp-endpoint.d.ts.map +1 -0
  1399. package/dist/internal/mcp-endpoint.js +566 -0
  1400. package/dist/internal/mcp-host.d.ts +99 -0
  1401. package/dist/internal/mcp-host.d.ts.map +1 -0
  1402. package/dist/internal/mcp-host.js +422 -0
  1403. package/dist/internal/mcp-oauth-on-demand.d.ts +68 -0
  1404. package/dist/internal/mcp-oauth-on-demand.d.ts.map +1 -0
  1405. package/dist/internal/mcp-oauth-on-demand.js +250 -0
  1406. package/dist/internal/mcp-oauth-persist.d.ts +42 -0
  1407. package/dist/internal/mcp-oauth-persist.d.ts.map +1 -0
  1408. package/dist/internal/mcp-oauth-persist.js +76 -0
  1409. package/dist/internal/mcp-oauth.d.ts +118 -0
  1410. package/dist/internal/mcp-oauth.d.ts.map +1 -0
  1411. package/dist/internal/mcp-oauth.js +393 -0
  1412. package/dist/internal/memory-dir.d.ts +8 -0
  1413. package/dist/internal/memory-dir.d.ts.map +1 -0
  1414. package/dist/internal/memory-dir.js +7 -0
  1415. package/dist/internal/model-config.d.ts +7 -0
  1416. package/dist/internal/model-config.d.ts.map +1 -0
  1417. package/dist/internal/model-config.js +67 -0
  1418. package/dist/internal/named-webhook-secret.d.ts +39 -0
  1419. package/dist/internal/named-webhook-secret.d.ts.map +1 -0
  1420. package/dist/internal/named-webhook-secret.js +47 -0
  1421. package/dist/internal/net.d.ts +5 -0
  1422. package/dist/internal/net.d.ts.map +1 -0
  1423. package/dist/internal/net.js +28 -0
  1424. package/dist/internal/open-browser.d.ts +5 -0
  1425. package/dist/internal/open-browser.d.ts.map +1 -0
  1426. package/dist/internal/open-browser.js +33 -0
  1427. package/dist/internal/otel/attrs.d.ts +7 -0
  1428. package/dist/internal/otel/attrs.d.ts.map +1 -0
  1429. package/dist/internal/otel/attrs.js +13 -0
  1430. package/dist/internal/otel/collector.d.ts +50 -0
  1431. package/dist/internal/otel/collector.d.ts.map +1 -0
  1432. package/dist/internal/otel/collector.js +765 -0
  1433. package/dist/internal/otel/computer-use-attrs.d.ts +18 -0
  1434. package/dist/internal/otel/computer-use-attrs.d.ts.map +1 -0
  1435. package/dist/internal/otel/computer-use-attrs.js +30 -0
  1436. package/dist/internal/otel/config.d.ts +59 -0
  1437. package/dist/internal/otel/config.d.ts.map +1 -0
  1438. package/dist/internal/otel/config.js +236 -0
  1439. package/dist/internal/otel/conversation-span-processor.d.ts +9 -0
  1440. package/dist/internal/otel/conversation-span-processor.d.ts.map +1 -0
  1441. package/dist/internal/otel/conversation-span-processor.js +34 -0
  1442. package/dist/internal/otel/customer.d.ts +52 -0
  1443. package/dist/internal/otel/customer.d.ts.map +1 -0
  1444. package/dist/internal/otel/customer.js +727 -0
  1445. package/dist/internal/otel/http.d.ts +13 -0
  1446. package/dist/internal/otel/http.d.ts.map +1 -0
  1447. package/dist/internal/otel/http.js +93 -0
  1448. package/dist/internal/otel/mcp.d.ts +16 -0
  1449. package/dist/internal/otel/mcp.d.ts.map +1 -0
  1450. package/dist/internal/otel/mcp.js +46 -0
  1451. package/dist/internal/otel/propagation.d.ts +6 -0
  1452. package/dist/internal/otel/propagation.d.ts.map +1 -0
  1453. package/dist/internal/otel/propagation.js +14 -0
  1454. package/dist/internal/otel/runtime.d.ts +41 -0
  1455. package/dist/internal/otel/runtime.d.ts.map +1 -0
  1456. package/dist/internal/otel/runtime.js +92 -0
  1457. package/dist/internal/otel/tool-error-class.d.ts +4 -0
  1458. package/dist/internal/otel/tool-error-class.d.ts.map +1 -0
  1459. package/dist/internal/otel/tool-error-class.js +36 -0
  1460. package/dist/internal/otel-env.d.ts +6 -0
  1461. package/dist/internal/otel-env.d.ts.map +1 -0
  1462. package/dist/internal/otel-env.js +5 -0
  1463. package/dist/internal/package-inline-stdio.d.ts +12 -0
  1464. package/dist/internal/package-inline-stdio.d.ts.map +1 -0
  1465. package/dist/internal/package-inline-stdio.js +107 -0
  1466. package/dist/internal/peer-connections.d.ts +63 -0
  1467. package/dist/internal/peer-connections.d.ts.map +1 -0
  1468. package/dist/internal/peer-connections.js +115 -0
  1469. package/dist/internal/persistent-stage-log-mirror.d.ts +57 -0
  1470. package/dist/internal/persistent-stage-log-mirror.d.ts.map +1 -0
  1471. package/dist/internal/persistent-stage-log-mirror.js +231 -0
  1472. package/dist/internal/platform-schedule-sync.d.ts +17 -0
  1473. package/dist/internal/platform-schedule-sync.d.ts.map +1 -0
  1474. package/dist/internal/platform-schedule-sync.js +55 -0
  1475. package/dist/internal/platform-timers.d.ts +42 -0
  1476. package/dist/internal/platform-timers.d.ts.map +1 -0
  1477. package/dist/internal/platform-timers.js +251 -0
  1478. package/dist/internal/playground/static.d.ts +52 -0
  1479. package/dist/internal/playground/static.d.ts.map +1 -0
  1480. package/dist/internal/playground/static.js +230 -0
  1481. package/dist/internal/playground/toolchain.d.ts +57 -0
  1482. package/dist/internal/playground/toolchain.d.ts.map +1 -0
  1483. package/dist/internal/playground/toolchain.js +213 -0
  1484. package/dist/internal/playground-proxy.d.ts +69 -0
  1485. package/dist/internal/playground-proxy.d.ts.map +1 -0
  1486. package/dist/internal/playground-proxy.js +434 -0
  1487. package/dist/internal/process-memory-telemetry.d.ts +89 -0
  1488. package/dist/internal/process-memory-telemetry.d.ts.map +1 -0
  1489. package/dist/internal/process-memory-telemetry.js +226 -0
  1490. package/dist/internal/project-layout.d.ts +7 -0
  1491. package/dist/internal/project-layout.d.ts.map +1 -0
  1492. package/dist/internal/project-layout.js +24 -0
  1493. package/dist/internal/prompt-context.d.ts +38 -0
  1494. package/dist/internal/prompt-context.d.ts.map +1 -0
  1495. package/dist/internal/prompt-context.js +86 -0
  1496. package/dist/internal/reminder-control-plane-protocol.d.ts +196 -0
  1497. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -0
  1498. package/dist/internal/reminder-control-plane-protocol.js +279 -0
  1499. package/dist/internal/reminder-runner.d.ts +223 -0
  1500. package/dist/internal/reminder-runner.d.ts.map +1 -0
  1501. package/dist/internal/reminder-runner.js +1241 -0
  1502. package/dist/internal/reminder-schedule.d.ts +26 -0
  1503. package/dist/internal/reminder-schedule.d.ts.map +1 -0
  1504. package/dist/internal/reminder-schedule.js +83 -0
  1505. package/dist/internal/reminder-store.d.ts +78 -0
  1506. package/dist/internal/reminder-store.d.ts.map +1 -0
  1507. package/dist/internal/reminder-store.js +105 -0
  1508. package/dist/internal/request-error-status.d.ts +14 -0
  1509. package/dist/internal/request-error-status.d.ts.map +1 -0
  1510. package/dist/internal/request-error-status.js +77 -0
  1511. package/dist/internal/request-headers.d.ts +11 -0
  1512. package/dist/internal/request-headers.d.ts.map +1 -0
  1513. package/dist/internal/request-headers.js +14 -0
  1514. package/dist/internal/resolve-prod-target.d.ts +76 -0
  1515. package/dist/internal/resolve-prod-target.d.ts.map +1 -0
  1516. package/dist/internal/resolve-prod-target.js +215 -0
  1517. package/dist/internal/resolved-connections.d.ts +65 -0
  1518. package/dist/internal/resolved-connections.d.ts.map +1 -0
  1519. package/dist/internal/resolved-connections.js +108 -0
  1520. package/dist/internal/router.d.ts +33 -0
  1521. package/dist/internal/router.d.ts.map +1 -0
  1522. package/dist/internal/router.js +93 -0
  1523. package/dist/internal/run-client.d.ts +78 -0
  1524. package/dist/internal/run-client.d.ts.map +1 -0
  1525. package/dist/internal/run-client.js +369 -0
  1526. package/dist/internal/runtime-dispatch-runner.d.ts +25 -0
  1527. package/dist/internal/runtime-dispatch-runner.d.ts.map +1 -0
  1528. package/dist/internal/runtime-dispatch-runner.js +35 -0
  1529. package/dist/internal/sanitize-mcp-tool-name.d.ts +20 -0
  1530. package/dist/internal/sanitize-mcp-tool-name.d.ts.map +1 -0
  1531. package/dist/internal/sanitize-mcp-tool-name.js +28 -0
  1532. package/dist/internal/schedule-runner.d.ts +42 -0
  1533. package/dist/internal/schedule-runner.d.ts.map +1 -0
  1534. package/dist/internal/schedule-runner.js +157 -0
  1535. package/dist/internal/scm/pr-url.d.ts +56 -0
  1536. package/dist/internal/scm/pr-url.d.ts.map +1 -0
  1537. package/dist/internal/scm/pr-url.js +153 -0
  1538. package/dist/internal/sdk-runner.d.ts +204 -0
  1539. package/dist/internal/sdk-runner.d.ts.map +1 -0
  1540. package/dist/internal/sdk-runner.js +1006 -0
  1541. package/dist/internal/sdk-subagent-inherit-support.d.ts +9 -0
  1542. package/dist/internal/sdk-subagent-inherit-support.d.ts.map +1 -0
  1543. package/dist/internal/sdk-subagent-inherit-support.js +89 -0
  1544. package/dist/internal/secret-alternatives.d.ts +11 -0
  1545. package/dist/internal/secret-alternatives.d.ts.map +1 -0
  1546. package/dist/internal/secret-alternatives.js +13 -0
  1547. package/dist/internal/serve-restart.d.ts +42 -0
  1548. package/dist/internal/serve-restart.d.ts.map +1 -0
  1549. package/dist/internal/serve-restart.js +72 -0
  1550. package/dist/internal/server.d.ts +45 -0
  1551. package/dist/internal/server.d.ts.map +1 -0
  1552. package/dist/internal/server.js +2566 -0
  1553. package/dist/internal/session-cost.d.ts +49 -0
  1554. package/dist/internal/session-cost.d.ts.map +1 -0
  1555. package/dist/internal/session-cost.js +147 -0
  1556. package/dist/internal/session-engine.d.ts +955 -0
  1557. package/dist/internal/session-engine.d.ts.map +1 -0
  1558. package/dist/internal/session-engine.js +4880 -0
  1559. package/dist/internal/session-links.d.ts +14 -0
  1560. package/dist/internal/session-links.d.ts.map +1 -0
  1561. package/dist/internal/session-links.js +64 -0
  1562. package/dist/internal/session-live-publisher.d.ts +48 -0
  1563. package/dist/internal/session-live-publisher.d.ts.map +1 -0
  1564. package/dist/internal/session-live-publisher.js +415 -0
  1565. package/dist/internal/session-run-log.d.ts +108 -0
  1566. package/dist/internal/session-run-log.d.ts.map +1 -0
  1567. package/dist/internal/session-run-log.js +398 -0
  1568. package/dist/internal/session-store.d.ts +73 -0
  1569. package/dist/internal/session-store.d.ts.map +1 -0
  1570. package/dist/internal/session-store.js +279 -0
  1571. package/dist/internal/session-urls.d.ts +10 -0
  1572. package/dist/internal/session-urls.d.ts.map +1 -0
  1573. package/dist/internal/session-urls.js +25 -0
  1574. package/dist/internal/sessions-client.d.ts +63 -0
  1575. package/dist/internal/sessions-client.d.ts.map +1 -0
  1576. package/dist/internal/sessions-client.js +215 -0
  1577. package/dist/internal/skill-catalog.d.ts +28 -0
  1578. package/dist/internal/skill-catalog.d.ts.map +1 -0
  1579. package/dist/internal/skill-catalog.js +36 -0
  1580. package/dist/internal/skills-sync.d.ts +22 -0
  1581. package/dist/internal/skills-sync.d.ts.map +1 -0
  1582. package/dist/internal/skills-sync.js +40 -0
  1583. package/dist/internal/slack-provision-client.d.ts +199 -0
  1584. package/dist/internal/slack-provision-client.d.ts.map +1 -0
  1585. package/dist/internal/slack-provision-client.js +320 -0
  1586. package/dist/internal/slack-thread-key.d.ts +7 -0
  1587. package/dist/internal/slack-thread-key.d.ts.map +1 -0
  1588. package/dist/internal/slack-thread-key.js +10 -0
  1589. package/dist/internal/sleep.d.ts +2 -0
  1590. package/dist/internal/sleep.d.ts.map +1 -0
  1591. package/dist/internal/sleep.js +3 -0
  1592. package/dist/internal/slug.d.ts +12 -0
  1593. package/dist/internal/slug.d.ts.map +1 -0
  1594. package/dist/internal/slug.js +38 -0
  1595. package/dist/internal/sqlite-experimental-warning.d.ts +2 -0
  1596. package/dist/internal/sqlite-experimental-warning.d.ts.map +1 -0
  1597. package/dist/internal/sqlite-experimental-warning.js +22 -0
  1598. package/dist/internal/start-log-store.d.ts +53 -0
  1599. package/dist/internal/start-log-store.d.ts.map +1 -0
  1600. package/dist/internal/start-log-store.js +155 -0
  1601. package/dist/internal/steering.d.ts +15 -0
  1602. package/dist/internal/steering.d.ts.map +1 -0
  1603. package/dist/internal/steering.js +17 -0
  1604. package/dist/internal/storage-coordinator.d.ts +200 -0
  1605. package/dist/internal/storage-coordinator.d.ts.map +1 -0
  1606. package/dist/internal/storage-coordinator.js +747 -0
  1607. package/dist/internal/storage-roles.d.ts +83 -0
  1608. package/dist/internal/storage-roles.d.ts.map +1 -0
  1609. package/dist/internal/storage-roles.js +24 -0
  1610. package/dist/internal/storage.d.ts +2 -0
  1611. package/dist/internal/storage.d.ts.map +1 -0
  1612. package/dist/internal/storage.js +1 -0
  1613. package/dist/internal/store-api-protocol.d.ts +164 -0
  1614. package/dist/internal/store-api-protocol.d.ts.map +1 -0
  1615. package/dist/internal/store-api-protocol.js +145 -0
  1616. package/dist/internal/store-mirror.d.ts +28 -0
  1617. package/dist/internal/store-mirror.d.ts.map +1 -0
  1618. package/dist/internal/store-mirror.js +54 -0
  1619. package/dist/internal/stream-progress.d.ts +14 -0
  1620. package/dist/internal/stream-progress.d.ts.map +1 -0
  1621. package/dist/internal/stream-progress.js +231 -0
  1622. package/dist/internal/terminal-style.d.ts +40 -0
  1623. package/dist/internal/terminal-style.d.ts.map +1 -0
  1624. package/dist/internal/terminal-style.js +93 -0
  1625. package/dist/internal/testing/conversation-identity-vectors.d.ts +53 -0
  1626. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -0
  1627. package/dist/internal/testing/conversation-identity-vectors.js +170 -0
  1628. package/dist/internal/testing/factory-resource-fixtures.d.ts +64 -0
  1629. package/dist/internal/testing/factory-resource-fixtures.d.ts.map +1 -0
  1630. package/dist/internal/testing/factory-resource-fixtures.js +55 -0
  1631. package/dist/internal/testing/hmac-secret-vectors.d.ts +38 -0
  1632. package/dist/internal/testing/hmac-secret-vectors.d.ts.map +1 -0
  1633. package/dist/internal/testing/hmac-secret-vectors.js +89 -0
  1634. package/dist/internal/testing/pagerduty-continuation-fixtures.d.ts +42 -0
  1635. package/dist/internal/testing/pagerduty-continuation-fixtures.d.ts.map +1 -0
  1636. package/dist/internal/testing/pagerduty-continuation-fixtures.js +175 -0
  1637. package/dist/internal/testing/scm-continuation-fixtures.d.ts +33 -0
  1638. package/dist/internal/testing/scm-continuation-fixtures.d.ts.map +1 -0
  1639. package/dist/internal/testing/scm-continuation-fixtures.js +257 -0
  1640. package/dist/internal/testing/slack-continuation-fixtures.d.ts +26 -0
  1641. package/dist/internal/testing/slack-continuation-fixtures.d.ts.map +1 -0
  1642. package/dist/internal/testing/slack-continuation-fixtures.js +136 -0
  1643. package/dist/internal/tool-call-retry.d.ts +87 -0
  1644. package/dist/internal/tool-call-retry.d.ts.map +1 -0
  1645. package/dist/internal/tool-call-retry.js +387 -0
  1646. package/dist/internal/tool-catalog.d.ts +31 -0
  1647. package/dist/internal/tool-catalog.d.ts.map +1 -0
  1648. package/dist/internal/tool-catalog.js +76 -0
  1649. package/dist/internal/tool-policy.d.ts +110 -0
  1650. package/dist/internal/tool-policy.d.ts.map +1 -0
  1651. package/dist/internal/tool-policy.js +138 -0
  1652. package/dist/internal/tool-result.d.ts +20 -0
  1653. package/dist/internal/tool-result.d.ts.map +1 -0
  1654. package/dist/internal/tool-result.js +50 -0
  1655. package/dist/internal/trajectory.d.ts +68 -0
  1656. package/dist/internal/trajectory.d.ts.map +1 -0
  1657. package/dist/internal/trajectory.js +336 -0
  1658. package/dist/internal/turn-governor.d.ts +54 -0
  1659. package/dist/internal/turn-governor.d.ts.map +1 -0
  1660. package/dist/internal/turn-governor.js +108 -0
  1661. package/dist/internal/turn-lease-store.d.ts +51 -0
  1662. package/dist/internal/turn-lease-store.d.ts.map +1 -0
  1663. package/dist/internal/turn-lease-store.js +172 -0
  1664. package/dist/internal/turn-outbox.d.ts +24 -0
  1665. package/dist/internal/turn-outbox.d.ts.map +1 -0
  1666. package/dist/internal/turn-outbox.js +65 -0
  1667. package/dist/internal/update-check.d.ts +93 -0
  1668. package/dist/internal/update-check.d.ts.map +1 -0
  1669. package/dist/internal/update-check.js +401 -0
  1670. package/dist/internal/v2-hosting.d.ts +34 -0
  1671. package/dist/internal/v2-hosting.d.ts.map +1 -0
  1672. package/dist/internal/v2-hosting.js +35 -0
  1673. package/dist/internal/workspace-sync.d.ts +44 -0
  1674. package/dist/internal/workspace-sync.d.ts.map +1 -0
  1675. package/dist/internal/workspace-sync.js +85 -0
  1676. package/dist/internal/workspace.d.ts +155 -0
  1677. package/dist/internal/workspace.d.ts.map +1 -0
  1678. package/dist/internal/workspace.js +468 -0
  1679. package/dist/internal/zod-schema.d.ts +14 -0
  1680. package/dist/internal/zod-schema.d.ts.map +1 -0
  1681. package/dist/internal/zod-schema.js +22 -0
  1682. package/dist/internal/zod3-datetime.d.ts +12 -0
  1683. package/dist/internal/zod3-datetime.d.ts.map +1 -0
  1684. package/dist/internal/zod3-datetime.js +17 -0
  1685. package/dist/kv/memory-kv.d.ts +24 -0
  1686. package/dist/kv/memory-kv.d.ts.map +1 -0
  1687. package/dist/kv/memory-kv.js +80 -0
  1688. package/dist/kv.d.ts +18 -0
  1689. package/dist/kv.d.ts.map +1 -0
  1690. package/dist/kv.js +16 -0
  1691. package/dist/memory.d.ts +113 -0
  1692. package/dist/memory.d.ts.map +1 -0
  1693. package/dist/memory.js +312 -0
  1694. package/dist/otel-public.d.ts +6 -0
  1695. package/dist/otel-public.d.ts.map +1 -0
  1696. package/dist/otel-public.js +5 -0
  1697. package/dist/otel.d.ts +31 -0
  1698. package/dist/otel.d.ts.map +1 -0
  1699. package/dist/otel.js +146 -0
  1700. package/dist/playground/assets/cursor-icons-16-DfKNljMZ.woff2 +0 -0
  1701. package/dist/playground/assets/index-B3_YohwW.js +62 -0
  1702. package/dist/playground/assets/index-Cn3-adsJ.css +1 -0
  1703. package/dist/playground/index.html +17 -0
  1704. package/dist/prompt.d.ts +39 -0
  1705. package/dist/prompt.d.ts.map +1 -0
  1706. package/dist/prompt.js +68 -0
  1707. package/dist/public-deprecated.d.ts +36 -0
  1708. package/dist/public-deprecated.d.ts.map +1 -0
  1709. package/dist/public-deprecated.js +39 -0
  1710. package/dist/reminders.d.ts +42 -0
  1711. package/dist/reminders.d.ts.map +1 -0
  1712. package/dist/reminders.js +45 -0
  1713. package/dist/schedules.d.ts +23 -0
  1714. package/dist/schedules.d.ts.map +1 -0
  1715. package/dist/schedules.js +26 -0
  1716. package/dist/skills.d.ts +22 -0
  1717. package/dist/skills.d.ts.map +1 -0
  1718. package/dist/skills.js +22 -0
  1719. package/dist/storage-backends/cursor-hosted-v2.d.ts +54 -0
  1720. package/dist/storage-backends/cursor-hosted-v2.d.ts.map +1 -0
  1721. package/dist/storage-backends/cursor-hosted-v2.js +113 -0
  1722. package/dist/storage-backends/cursor-hosted.d.ts +94 -0
  1723. package/dist/storage-backends/cursor-hosted.d.ts.map +1 -0
  1724. package/dist/storage-backends/cursor-hosted.js +225 -0
  1725. package/dist/storage-backends/file-kv.d.ts +42 -0
  1726. package/dist/storage-backends/file-kv.d.ts.map +1 -0
  1727. package/dist/storage-backends/file-kv.js +226 -0
  1728. package/dist/storage-protocol.d.ts +124 -0
  1729. package/dist/storage-protocol.d.ts.map +1 -0
  1730. package/dist/storage-protocol.js +181 -0
  1731. package/dist/storage.d.ts +254 -0
  1732. package/dist/storage.d.ts.map +1 -0
  1733. package/dist/storage.js +145 -0
  1734. package/dist/tools.d.ts +135 -0
  1735. package/dist/tools.d.ts.map +1 -0
  1736. package/dist/tools.js +78 -0
  1737. package/dist/types.d.ts +3804 -0
  1738. package/dist/types.d.ts.map +1 -0
  1739. package/dist/types.js +191 -0
  1740. package/docs/README.md +115 -0
  1741. package/docs/building-with-agents.md +139 -0
  1742. package/docs/changelog.md +119 -0
  1743. package/docs/deployment.md +314 -0
  1744. package/docs/evals.md +244 -0
  1745. package/docs/guides/agent-to-agent.md +167 -0
  1746. package/docs/guides/bitbucket.md +298 -0
  1747. package/docs/guides/cloud-agents.md +86 -0
  1748. package/docs/guides/convert-automation.md +185 -0
  1749. package/docs/guides/export-grokbot.md +244 -0
  1750. package/docs/guides/github.md +378 -0
  1751. package/docs/guides/gitlab.md +304 -0
  1752. package/docs/guides/grokbot-agents.md +140 -0
  1753. package/docs/guides/hooks.md +121 -0
  1754. package/docs/guides/improve.md +134 -0
  1755. package/docs/guides/jev.md +303 -0
  1756. package/docs/guides/mcp-oauth.md +153 -0
  1757. package/docs/guides/migrate.md +169 -0
  1758. package/docs/guides/opentelemetry.md +205 -0
  1759. package/docs/guides/pagerduty.md +341 -0
  1760. package/docs/guides/slack.md +314 -0
  1761. package/docs/guides/webhooks.md +255 -0
  1762. package/docs/hillclimbing.md +139 -0
  1763. package/docs/quickstart.md +312 -0
  1764. package/docs/reference/agent-config.md +243 -0
  1765. package/docs/reference/artifacts.md +118 -0
  1766. package/docs/reference/channels.md +219 -0
  1767. package/docs/reference/cli.md +1103 -0
  1768. package/docs/reference/connections.md +312 -0
  1769. package/docs/reference/evals.md +299 -0
  1770. package/docs/reference/extensions.md +214 -0
  1771. package/docs/reference/hooks.md +202 -0
  1772. package/docs/reference/http-api.md +226 -0
  1773. package/docs/reference/instructions.md +69 -0
  1774. package/docs/reference/memory.md +119 -0
  1775. package/docs/reference/playground.md +41 -0
  1776. package/docs/reference/project-layout.md +122 -0
  1777. package/docs/reference/prompt.md +52 -0
  1778. package/docs/reference/schedules.md +195 -0
  1779. package/docs/reference/sessions.md +205 -0
  1780. package/docs/reference/skills.md +77 -0
  1781. package/docs/reference/subagents.md +66 -0
  1782. package/docs/reference/tools.md +311 -0
  1783. package/docs/templates/agentic-owners.md +131 -0
  1784. package/docs/templates/grokbot-agents.md +60 -0
  1785. package/docs/templates/security-reviewer.md +86 -0
  1786. package/docs/templates/thermo-quality-review.md +80 -0
  1787. package/docs/templates/thermo-review.md +80 -0
  1788. package/docs/templates/triage.md +106 -0
  1789. package/docs/troubleshooting.md +154 -0
  1790. package/package.json +429 -4
  1791. package/schemas/grokbot-answers.schema.json +354 -0
  1792. package/scripts/install-cursor-skills.mjs +29 -0
  1793. package/skills/create-agent/SKILL.md +175 -0
  1794. package/skills/debug/SKILL.md +43 -0
  1795. package/skills/deploy/SKILL.md +169 -0
  1796. package/skills/evals/SKILL.md +145 -0
  1797. package/skills/framework-map/SKILL.md +128 -0
  1798. package/skills/github/SKILL.md +133 -0
  1799. package/skills/hillclimb/SKILL.md +63 -0
  1800. package/skills/mcp-auth/SKILL.md +60 -0
  1801. package/skills/migrate-v2/SKILL.md +397 -0
  1802. package/skills/otel/SKILL.md +48 -0
  1803. package/skills/setup-slack/SKILL.md +136 -0
  1804. package/templates/agentic-owners/README.md +78 -0
  1805. package/templates/agentic-owners/bot/agent.ts +8 -0
  1806. package/templates/agentic-owners/bot/channels/github.ts +63 -0
  1807. package/templates/agentic-owners/bot/instructions.md +34 -0
  1808. package/templates/agentic-owners/bot/lib/config.ts +5 -0
  1809. package/templates/agentic-owners/bot/lib/github.ts +219 -0
  1810. package/templates/agentic-owners/bot/lib/owners/README.md +50 -0
  1811. package/templates/agentic-owners/bot/lib/owners/constants.ts +22 -0
  1812. package/templates/agentic-owners/bot/lib/owners/decision.ts +480 -0
  1813. package/templates/agentic-owners/bot/lib/owners/globalOverride.ts +60 -0
  1814. package/templates/agentic-owners/bot/lib/owners/handles.ts +54 -0
  1815. package/templates/agentic-owners/bot/lib/owners/match.ts +287 -0
  1816. package/templates/agentic-owners/bot/lib/owners/matching.ts +147 -0
  1817. package/templates/agentic-owners/bot/lib/owners/parse.ts +696 -0
  1818. package/templates/agentic-owners/bot/lib/owners/policyMode.ts +57 -0
  1819. package/templates/agentic-owners/bot/lib/owners/prompt.ts +64 -0
  1820. package/templates/agentic-owners/bot/lib/owners/prompts/base-review.md +105 -0
  1821. package/templates/agentic-owners/bot/lib/owners/types.ts +73 -0
  1822. package/templates/agentic-owners/bot/lib/review.ts +723 -0
  1823. package/templates/agentic-owners/bot/tools/record_review.ts +62 -0
  1824. package/templates/agentic-owners/evals/evals.config.ts +5 -0
  1825. package/templates/agentic-owners/evals/owners.eval.ts +111 -0
  1826. package/templates/agentic-owners/package.json +20 -0
  1827. package/templates/agentic-owners/tsconfig.json +12 -0
  1828. package/templates/agents-md/README.md +43 -0
  1829. package/templates/agents-md/bot/agent.ts +8 -0
  1830. package/templates/agents-md/bot/channels/github.ts +10 -0
  1831. package/templates/agents-md/bot/channels/queue.ts +23 -0
  1832. package/templates/agents-md/bot/channels/slack.ts +9 -0
  1833. package/templates/agents-md/bot/instructions.md +38 -0
  1834. package/templates/agents-md/bot/lib/collect.ts +412 -0
  1835. package/templates/agents-md/bot/lib/config.ts +8 -0
  1836. package/templates/agents-md/bot/lib/paths.ts +49 -0
  1837. package/templates/agents-md/bot/schedules/weekly.ts +17 -0
  1838. package/templates/agents-md/bot/tools/apply_agents.ts +217 -0
  1839. package/templates/agents-md/evals/agents.eval.ts +136 -0
  1840. package/templates/agents-md/evals/evals.config.ts +5 -0
  1841. package/templates/agents-md/init.json +38 -0
  1842. package/templates/agents-md/package.json +18 -0
  1843. package/templates/agents-md/tsconfig.json +12 -0
  1844. package/templates/code-wiki/README.md +34 -0
  1845. package/templates/code-wiki/bot/agent.ts +8 -0
  1846. package/templates/code-wiki/bot/channels/github.ts +125 -0
  1847. package/templates/code-wiki/bot/instructions.md +39 -0
  1848. package/templates/code-wiki/bot/lib/repos.ts +5 -0
  1849. package/templates/code-wiki/bot/lib/wiki.ts +22 -0
  1850. package/templates/code-wiki/bot/tools/apply_wiki.ts +210 -0
  1851. package/templates/code-wiki/evals/evals.config.ts +5 -0
  1852. package/templates/code-wiki/evals/wiki.eval.ts +124 -0
  1853. package/templates/code-wiki/init.json +25 -0
  1854. package/templates/code-wiki/package.json +18 -0
  1855. package/templates/code-wiki/tsconfig.json +12 -0
  1856. package/templates/demo/README.md +37 -0
  1857. package/templates/demo/bot/agent.ts +8 -0
  1858. package/templates/demo/bot/channels/github.ts +52 -0
  1859. package/templates/demo/bot/channels/queue.ts +24 -0
  1860. package/templates/demo/bot/instructions.md +8 -0
  1861. package/templates/demo/bot/lib/collect.ts +66 -0
  1862. package/templates/demo/bot/lib/repos.ts +5 -0
  1863. package/templates/demo/bot/tools/record_demo.ts +37 -0
  1864. package/templates/demo/evals/demo.eval.ts +29 -0
  1865. package/templates/demo/evals/evals.config.ts +5 -0
  1866. package/templates/demo/init.json +25 -0
  1867. package/templates/demo/package.json +18 -0
  1868. package/templates/demo/tsconfig.json +12 -0
  1869. package/templates/grokbot-agents/README.md +27 -0
  1870. package/templates/grokbot-agents/bot/agent.ts +6 -0
  1871. package/templates/grokbot-agents/bot/extensions/grokbot.ts +5 -0
  1872. package/templates/grokbot-agents/bot/instructions.md +7 -0
  1873. package/templates/grokbot-agents/evals/evals.config.ts +5 -0
  1874. package/templates/grokbot-agents/evals/grokbot-agents.eval.ts +18 -0
  1875. package/templates/grokbot-agents/init.json +18 -0
  1876. package/templates/grokbot-agents/package.json +17 -0
  1877. package/templates/grokbot-agents/tsconfig.json +12 -0
  1878. package/templates/pr-autofixer/bot/agent.ts +11 -0
  1879. package/templates/pr-autofixer/bot/channels/drive.ts +24 -0
  1880. package/templates/pr-autofixer/bot/channels/github.ts +155 -0
  1881. package/templates/pr-autofixer/bot/channels/slack.ts +16 -0
  1882. package/templates/pr-autofixer/bot/hooks/bind-agent.ts +19 -0
  1883. package/templates/pr-autofixer/bot/instructions.md +83 -0
  1884. package/templates/pr-autofixer/bot/lib/affinity.ts +24 -0
  1885. package/templates/pr-autofixer/bot/lib/drive-schemas.ts +18 -0
  1886. package/templates/pr-autofixer/bot/lib/drive.ts +73 -0
  1887. package/templates/pr-autofixer/bot/lib/merge-watch.ts +116 -0
  1888. package/templates/pr-autofixer/bot/lib/pr-state.ts +40 -0
  1889. package/templates/pr-autofixer/bot/lib/repos.ts +18 -0
  1890. package/templates/pr-autofixer/bot/lib/start-drive.ts +113 -0
  1891. package/templates/pr-autofixer/bot/lib/webhook-buffer.ts +215 -0
  1892. package/templates/pr-autofixer/bot/lib/webhook-routing.ts +231 -0
  1893. package/templates/pr-autofixer/bot/tools/drive_pr.ts +21 -0
  1894. package/templates/pr-autofixer/evals/coordinator.eval.ts +16 -0
  1895. package/templates/pr-autofixer/evals/evals.config.ts +5 -0
  1896. package/templates/pr-autofixer/init.json +25 -0
  1897. package/templates/pr-autofixer/package.json +18 -0
  1898. package/templates/pr-autofixer/tsconfig.json +12 -0
  1899. package/templates/security-help/README.md +46 -0
  1900. package/templates/security-help/bot/agent.ts +17 -0
  1901. package/templates/security-help/bot/channels/github.ts +13 -0
  1902. package/templates/security-help/bot/channels/slack.ts +84 -0
  1903. package/templates/security-help/bot/instructions.md +19 -0
  1904. package/templates/security-help/bot/lib/pr-first-pass.ts +40 -0
  1905. package/templates/security-help/bot/lib/repos.ts +5 -0
  1906. package/templates/security-help/bot/skills/access-request.md +10 -0
  1907. package/templates/security-help/bot/skills/faq.md +31 -0
  1908. package/templates/security-help/bot/skills/security-playbooks.md +12 -0
  1909. package/templates/security-help/bot/skills/security-pr-first-pass.md +12 -0
  1910. package/templates/security-help/evals/evals.config.ts +5 -0
  1911. package/templates/security-help/evals/security-help.eval.ts +51 -0
  1912. package/templates/security-help/init.json +31 -0
  1913. package/templates/security-help/package.json +17 -0
  1914. package/templates/security-help/tsconfig.json +12 -0
  1915. package/templates/security-reviewer/README.md +33 -0
  1916. package/templates/security-reviewer/bot/agent.ts +8 -0
  1917. package/templates/security-reviewer/bot/channels/github.ts +43 -0
  1918. package/templates/security-reviewer/bot/instructions.md +22 -0
  1919. package/templates/security-reviewer/bot/lib/repos.ts +5 -0
  1920. package/templates/security-reviewer/bot/tools/post_findings.ts +68 -0
  1921. package/templates/security-reviewer/evals/evals.config.ts +5 -0
  1922. package/templates/security-reviewer/evals/review.eval.ts +50 -0
  1923. package/templates/security-reviewer/init.json +25 -0
  1924. package/templates/security-reviewer/package.json +18 -0
  1925. package/templates/security-reviewer/tsconfig.json +12 -0
  1926. package/templates/thermo-quality-review/README.md +35 -0
  1927. package/templates/thermo-quality-review/bot/agent.ts +8 -0
  1928. package/templates/thermo-quality-review/bot/channels/github.ts +39 -0
  1929. package/templates/thermo-quality-review/bot/instructions.md +43 -0
  1930. package/templates/thermo-quality-review/bot/tools/post_findings.ts +67 -0
  1931. package/templates/thermo-quality-review/evals/evals.config.ts +5 -0
  1932. package/templates/thermo-quality-review/evals/review.eval.ts +59 -0
  1933. package/templates/thermo-quality-review/package.json +18 -0
  1934. package/templates/thermo-quality-review/tsconfig.json +12 -0
  1935. package/templates/thermo-review/README.md +35 -0
  1936. package/templates/thermo-review/bot/agent.ts +8 -0
  1937. package/templates/thermo-review/bot/channels/github.ts +39 -0
  1938. package/templates/thermo-review/bot/instructions.md +40 -0
  1939. package/templates/thermo-review/bot/tools/post_findings.ts +67 -0
  1940. package/templates/thermo-review/evals/evals.config.ts +5 -0
  1941. package/templates/thermo-review/evals/review.eval.ts +50 -0
  1942. package/templates/thermo-review/package.json +18 -0
  1943. package/templates/thermo-review/tsconfig.json +12 -0
  1944. package/templates/triage/README.md +47 -0
  1945. package/templates/triage/bot/agent.ts +8 -0
  1946. package/templates/triage/bot/channels/queue.ts +29 -0
  1947. package/templates/triage/bot/channels/webhook.ts +41 -0
  1948. package/templates/triage/bot/hooks/memory.ts +3 -0
  1949. package/templates/triage/bot/instructions.md +38 -0
  1950. package/templates/triage/bot/lib/actuate.ts +703 -0
  1951. package/templates/triage/bot/lib/parse-queue-event.ts +160 -0
  1952. package/templates/triage/bot/lib/tracker.ts +5 -0
  1953. package/templates/triage/bot/lib/types.ts +48 -0
  1954. package/templates/triage/bot/lib/verify-webhook.ts +79 -0
  1955. package/templates/triage/bot/skills/triage-rubric.md +44 -0
  1956. package/templates/triage/bot/tools/record_triage.ts +29 -0
  1957. package/templates/triage/evals/evals.config.ts +5 -0
  1958. package/templates/triage/evals/triage.eval.ts +64 -0
  1959. package/templates/triage/overlays/jira/README.md +21 -0
  1960. package/templates/triage/overlays/jira/bot/lib/tracker.ts +8 -0
  1961. package/templates/triage/overlays/jira/bot/mcp-connections/tracker.ts +6 -0
  1962. package/templates/triage/overlays/linear/README.md +21 -0
  1963. package/templates/triage/overlays/linear/bot/lib/tracker.ts +8 -0
  1964. package/templates/triage/overlays/linear/bot/mcp-connections/tracker.ts +6 -0
  1965. package/templates/triage/package.json +18 -0
  1966. package/templates/triage/tsconfig.json +12 -0
@@ -0,0 +1,66 @@
1
+ import{_ as i,c as a,o as e,a3 as t}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse(`{"title":"MCP connections","description":"Pull in tools from MCP servers: remote, stdio, the signed-in Cursor account's connectors, and peer agents.","frontmatter":{"title":"MCP connections","description":"Pull in tools from MCP servers: remote, stdio, the signed-in Cursor account's connectors, and peer agents."},"headers":[],"relativePath":"reference/connections.md","filePath":"reference/connections.md"}`),n={name:"reference/connections.md"};function h(l,s,o,p,r,k){return e(),a("div",null,[...s[0]||(s[0]=[t(`<h1 id="mcp-connections" tabindex="-1">MCP connections <a class="header-anchor" href="#mcp-connections" aria-label="Permalink to &quot;MCP connections&quot;">​</a></h1><p>An MCP connection gives the agent tools from an MCP server. Define one file per server under <code>bot/mcp-connections/</code>; the filename becomes the server name. Default-export <code>defineConnection</code> from <code>@cursor/bdk/connections</code>. The transport is remote HTTP, local stdio, the signed-in Cursor account&#39;s connectors, or a peer agent addressed by slug.</p><p>Put a server in <code>bot/host-connections/</code> when only host tools should call it. Host connections use the same <code>defineConnection</code> shape and support <code>bdk mcp oauth</code>; the model and playground don&#39;t see them.</p><h2 id="remote-mcp-server" tabindex="-1">Remote MCP server <a class="header-anchor" href="#remote-mcp-server" aria-label="Permalink to &quot;Remote MCP server&quot;">​</a></h2><p>Point an MCP connection at a remote server with a URL.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineConnection } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/connections&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
2
+ <span class="line"></span>
3
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
4
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> url: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;https://mcp.linear.app/mcp&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
5
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> headers: { authorization: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Bearer \${LINEAR_TOKEN}&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
6
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><h2 id="credentials-in-headers-and-env" tabindex="-1">Credentials in headers and env <a class="header-anchor" href="#credentials-in-headers-and-env" aria-label="Permalink to &quot;Credentials in headers and env&quot;">​</a></h2><p>Write a credential as a <code>\${NAME}</code> template in <code>headers</code> on a remote connection or in <code>env</code> on a stdio one. The connection stores the template as you wrote it and reads <code>NAME</code> from the environment every time it opens a client, so the value can arrive after the project loads.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
7
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> command: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;slack-mcp-server&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
8
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> args: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;--transport&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;stdio&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
9
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> env: { SLACK_MCP_XOXB_TOKEN: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;\${SLACK_BOT_TOKEN}&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
10
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>That timing is the point of the template. Your connection file is imported once, when the project loads, and a hosted deployment has none of its secrets in the environment yet, because the platform passes them to the agent per request. So a <code>process.env.SLACK_BOT_TOKEN</code> read at the top of the file captures an empty string and keeps sending it for the life of the process, while the same file works locally because <code>.env.local</code> was read before the import. The template form is right in both places.</p><p><code>bdk validate</code> warns about a template the environment does not define and names the variable. It stays a warning rather than an error, since a hosted deployment resolves it later. An unset variable resolves to an empty value at connect time, which the server reports as an auth failure.</p><h2 id="host-mcp-oauth" tabindex="-1">Host MCP OAuth <a class="header-anchor" href="#host-mcp-oauth" aria-label="Permalink to &quot;Host MCP OAuth&quot;">​</a></h2><p>For servers that speak OAuth, set <code>oauth: true</code> and authorize with the CLI or mid-run Connect. Tokens live in <code>mcp-auth.json</code> under the CLI config directory of the machine that authorized them. A hosted agent reaches OAuth servers through a <a href="#cursor-account-mcp-connection">Cursor account connection</a> instead.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
11
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> url: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;https://mcp.example.com/inventory&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
12
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> oauth: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
13
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk mcp oauth inventory # browser PKCE → local mcp-auth.json</span></span></code></pre></div><p>Full walkthrough: <a href="./../guides/mcp-oauth.html">Host MCP OAuth</a>. Companion skill: <a href="./../../skills/mcp-auth/SKILL.html"><code>skills/mcp-auth/SKILL.md</code></a>.</p><h2 id="per-session-auth" tabindex="-1">Per-session auth <a class="header-anchor" href="#per-session-auth" aria-label="Permalink to &quot;Per-session auth&quot;">​</a></h2><p>For http/sse connections whose credential depends on who the session is for, declare an <code>auth</code> callback instead of static headers. It runs host-side with the session&#39;s <code>SessionInfo</code> and returns headers merged over the static ones:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
14
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> url: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;https://api.cursor.com/v1/mcp/plugins&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
15
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> auth</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">async</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">session</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ({</span></span>
16
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> headers: { Authorization: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">\`Bearer \${</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> grantFor</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">(</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">session</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">)</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}\`</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
17
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }),</span></span>
18
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> advertiseTools: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
19
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>The callback is evaluated on every turn, including reminder fires and post-restart follow-ups, so the identity always comes from the session itself, never from state parked in memory. The model never sees a downstream account parameter and cannot choose the account. A callback that throws fails the turn: a turn never silently runs without the connection&#39;s identity. <code>host.mcp</code> calls from server tools keep the static headers only. You can&#39;t combine <code>auth</code> with <code>oauth: true</code>; the host OAuth provider owns the Authorization header.</p><p>Derive the identity from durable session facts: <code>session.auth</code>, <code>session.id</code>, or your channel&#39;s own session state. Do not key it off <code>session.continuationKey</code>. The HTTP channel rotates that key after every accepted follow-up, so an account mapping keyed on it breaks mid-conversation.</p><p><code>auth</code> works attached or advertised. Advertise the auth connection instead of attaching it next to a stateful stdio server.</p><h2 id="advertise-tools" tabindex="-1">Advertise tools <a class="header-anchor" href="#advertise-tools" aria-label="Permalink to &quot;Advertise tools {#advertise-tools}&quot;">​</a></h2><p>Set <code>advertiseTools: true</code> when the model should call an MCP server&#39;s tools by name. BDK preserves each tool&#39;s description, input and output schemas, and MCP annotations. Exposed names normalize invalid characters and add numeric suffixes to avoid collisions.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
20
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> url: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;https://api.cursor.com/v1/mcp/plugins&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
21
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> auth</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">async</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">session</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ({ headers: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> headersForSession</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(session) }),</span></span>
22
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> advertiseTools: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
23
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Listing, authentication, invalid tool name, and name collision failures fail the turn by default. Set <code>optional: true</code> to omit an unavailable connection instead. Advertised tools behave like server tools, and <a href="./tools.html#call-a-tool-without-a-model-turn">direct tool calls</a> use the same names.</p><p>In a dry-run session, MCP tools marked read-only run normally. Tools marked as writes are stubbed. Tools without effect annotations are unavailable. A tool annotated read-only uses the same transient retry as an authored read. A tool with no effect annotation runs once.</p><h2 id="filter-connection-tools" tabindex="-1">Filter connection tools <a class="header-anchor" href="#filter-connection-tools" aria-label="Permalink to &quot;Filter connection tools&quot;">​</a></h2><p>Use <code>tools</code> the same way you allowlist harness tools on the agent. When set, the connection serves only those names. Use <code>disallowedTools</code> to drop names instead. The two combine as deny-wins. The model and <code>host.mcp</code> only see what remains. A model-visible filter requires <code>advertiseTools: true</code>.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
24
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> url: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;https://mcp.example.com/inventory&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
25
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> advertiseTools: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
26
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> tools: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;search_skus&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;get_stock&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
27
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
28
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> url: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;https://mcp.example.com/inventory&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
29
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> advertiseTools: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
30
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> disallowedTools: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;place_order&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;delete_sku&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
31
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Names are the server&#39;s <code>tools/list</code> names. Unknown names are omitted. A filter that matches nothing on the server fails the turn unless <code>optional: true</code>. Combine with <code>effects: &quot;read&quot;</code> to keep only the listed tools the server classifies as reads.</p><p>A list of names is an allowlist. An object of handlers authors TypeScript tools. On <code>host-connections/</code>, a name list restricts <code>host.mcp</code> without advertising.</p><h2 id="local-stdio-mcp-server" tabindex="-1">Local stdio MCP server <a class="header-anchor" href="#local-stdio-mcp-server" aria-label="Permalink to &quot;Local stdio MCP server&quot;">​</a></h2><p>Run a local MCP server as a child process with <code>command</code>.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
32
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> command: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;node&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
33
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> args: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;--import&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;tsx&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;mcp/units-server.ts&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
34
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // env, cwd</span></span>
35
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>This suits small purpose-built servers, like a <code>units</code> converter shipped next to the agent.</p><p>To run TypeScript in the agent environment, author the tools on the connection instead. BDK packages authored tools as stdio MCP, so you write only <code>execute</code>.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
36
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> tools: {</span></span>
37
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> probe_agent_tool: {</span></span>
38
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> description: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Prove the tool ran in the agent environment.&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
39
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> execute</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">label</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }) {</span></span>
40
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { ok: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, label };</span></span>
41
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
42
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
43
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
44
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><h2 id="cursor-account-mcp-connection" tabindex="-1">Cursor account MCP connection <a class="header-anchor" href="#cursor-account-mcp-connection" aria-label="Permalink to &quot;Cursor account MCP connection&quot;">​</a></h2><p><code>{ cursorAccount: true }</code> forwards the MCP connectors the signed-in Cursor account already authorized (dashboard → MCP), such as Linear, Notion, and Slack. You don&#39;t configure tokens. Every tool runs on the Cursor backend with the account&#39;s stored OAuth credentials, so raw tokens never reach the serving host, session workspaces, or traces.</p><p>By default the agent gets every connected HTTP/SSE connector on the account. Pass <code>servers: &quot;*&quot;</code> (or <code>[&quot;*&quot;]</code>) for the same all-connectors behavior in an explicit form. Pass a name list when you want a smaller set.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// bot/mcp-connections/account.ts: every connected connector</span></span>
45
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
46
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> cursorAccount: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
47
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> advertiseTools: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
48
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// only Linear:</span></span>
49
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
50
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> cursorAccount: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
51
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> servers: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Linear&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
52
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> advertiseTools: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
53
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Name the file <code>account.ts</code>. <code>cursor.ts</code> collides with the IDE <code>cursor</code> MCP namespace. <code>advertiseTools: true</code> puts connector tools on local turns by name.</p><p>The host must be signed in (<code>bdk login</code>, <code>CURSOR_API_KEY</code>, or <code>CURSOR_SERVICE_ACCOUNT_KEY</code>). <code>serve</code> fails at startup otherwise.</p><p>Use a <code>{ command }</code> connection for stdio servers.</p><div class="caution custom-block github-alert"><p class="custom-block-title">CAUTION</p><p>Whoever can talk to the agent can drive these connectors, because they are ordinary agent tools. <code>serve</code> refuses to start when <code>--allow-anonymous</code> is combined with account MCP connections unless you also pass <code>--allow-anonymous-cursor-account-mcp</code> (trusted boundary only; for example an SSO proxy or the hosted alias token). Prefer <code>--bearer-token</code> on shared hosts.</p></div><h2 id="peer-mcp-connection" tabindex="-1">Peer MCP connection <a class="header-anchor" href="#peer-mcp-connection" aria-label="Permalink to &quot;Peer MCP connection {#peer-mcp-connection}&quot;">​</a></h2><p><code>{ agent: &quot;&lt;slug&gt;&quot; }</code> addresses another agent without configuring a URL, headers, or secrets. On a local multi-agent serve, the target is another mount slug. On Cursor-managed hosting, it is the lowercase deployment slug of another agent on the same team.</p><p>On a local multi-agent serve, the model gets the peer&#39;s <code>ask</code> and <code>check</code> tools, plus <code>call_tool</code> when the peer has server tools, and can delegate work to it:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineConnection</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
54
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> agent: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;weather-agent&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
55
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> description: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Delegate weather questions to the weather agent.&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
56
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Declare the connection only on the caller. The specialist needs no matching configuration.</p><p>In a local multi-agent serve, unknown slugs and self-references fail at startup. A single-agent serve omits peers with a warning unless its hosting platform sets <code>--peers-url</code>. Walkthrough: <a href="./../guides/agent-to-agent.html#delegate-a-question-to-a-specialist">Peer agents</a>.</p><h2 id="call-mcp-from-host-code" tabindex="-1">Call MCP from host code <a class="header-anchor" href="#call-mcp-from-host-code" aria-label="Permalink to &quot;Call MCP from host code&quot;">​</a></h2><p>A file under <code>bot/mcp-connections/</code> is available to the Cursor agent, to server tools through <code>ctx.host.mcp</code>, and to channel and schedule handlers through <code>args.host.mcp</code>. Host connections skip the model.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// bot/tools/search_linear.ts</span></span>
57
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineTool } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/tools&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
58
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { z } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;zod&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
59
+ <span class="line"></span>
60
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineTool</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
61
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> description: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Search Linear issues.&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
62
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> inputSchema: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">object</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ query: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">() }),</span></span>
63
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> execute</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">query</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }, </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">ctx</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
64
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ctx.host.mcp.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">callTool</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;linear&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;list_issues&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, { query });</span></span>
65
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
66
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p><code>host.mcp.names()</code> lists connection names. <code>listTools(name)</code> / <code>callTool(name, tool, args)</code> call into a named connection.</p><h2 id="related" tabindex="-1">Related <a class="header-anchor" href="#related" aria-label="Permalink to &quot;Related&quot;">​</a></h2><ul><li><a href="./../guides/mcp-oauth.html">Host MCP OAuth</a>: <code>mcp oauth</code>, Connect, and hosted agents</li><li><a href="./tools.html">Tools</a>: authored tools that wrap MCP connections</li><li><a href="./../guides/webhooks.html">Webhooks</a>: calling MCP connections from handlers</li><li><a href="./../guides/agent-to-agent.html">Peer agents</a>: when a specialist is its own agent</li></ul>`,60)])])}const E=i(n,[["render",h]]);export{c as __pageData,E as default};
@@ -0,0 +1 @@
1
+ import{_ as i,c as a,o as e,a3 as t}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse(`{"title":"MCP connections","description":"Pull in tools from MCP servers: remote, stdio, the signed-in Cursor account's connectors, and peer agents.","frontmatter":{"title":"MCP connections","description":"Pull in tools from MCP servers: remote, stdio, the signed-in Cursor account's connectors, and peer agents."},"headers":[],"relativePath":"reference/connections.md","filePath":"reference/connections.md"}`),n={name:"reference/connections.md"};function h(l,s,o,p,r,k){return e(),a("div",null,[...s[0]||(s[0]=[t("",60)])])}const E=i(n,[["render",h]]);export{c as __pageData,E as default};
@@ -0,0 +1,56 @@
1
+ import{_ as e,c as a,o as i,a3 as t}from"./chunks/framework.BNw1pucY.js";const k=JSON.parse('{"title":"Evals","description":"Define eval cases, drive turns, assert trajectories, and interpret results.","frontmatter":{"title":"Evals","description":"Define eval cases, drive turns, assert trajectories, and interpret results."},"headers":[],"relativePath":"reference/evals.md","filePath":"reference/evals.md"}'),n={name:"reference/evals.md"};function d(l,s,h,r,o,p){return i(),a("div",null,[...s[0]||(s[0]=[t(`<h1 id="evals" tabindex="-1">Evals <a class="header-anchor" href="#evals" aria-label="Permalink to &quot;Evals&quot;">​</a></h1><p>Evals run fixed cases against an agent and record whether its turns, tools, events, and output meet a contract. Files under the project-root <code>evals/</code> directory define cases with <code>@cursor/bdk/evals</code>; the runner discovers their IDs, executes them, and reports every assertion. See the <a href="./../evals.html">Evals guide</a> for the regression workflow.</p><h2 id="eval-discovery-and-case-ids" tabindex="-1">Eval discovery and case IDs <a class="header-anchor" href="#eval-discovery-and-case-ids" aria-label="Permalink to &quot;Eval discovery and case IDs&quot;">​</a></h2><p>Eval files live under the project-root <code>evals/</code> directory and end in <code>.eval.ts</code> or <code>.eval.js</code>. The path under that directory becomes the eval ID:</p><ul><li><code>evals/readiness.eval.ts</code> becomes <code>readiness</code>.</li><li><code>evals/builds/api.eval.ts</code> becomes <code>builds/api</code>.</li><li><code>evals/builds/index.eval.ts</code> becomes <code>builds</code>.</li></ul><p>Export one <code>defineEval</code> with either <code>test</code> or <code>cases</code>, not both. A case ID appends one path segment to the file ID:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineEval</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
2
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> tags: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;smoke&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
3
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> cases: [</span></span>
4
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
5
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> id: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;checkout&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
6
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> test</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">t</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
7
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">send</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Review checkout PR 42.&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
8
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">succeeded</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span>
9
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
10
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
11
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
12
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> id: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;search&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
13
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> test</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">t</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
14
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">send</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Review search PR 7.&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
15
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">succeeded</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span>
16
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
17
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
18
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ],</span></span>
19
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Those cases are <code>prs/checkout</code> and <code>prs/search</code> when the file is <code>evals/prs.eval.ts</code>. Case IDs must be unique single path segments.</p><p>A file can also export an array of <code>defineEval</code> calls. The runner names them with zero-padded indexes such as <code>sql/0000</code>. Named <code>cases</code> give handwritten scenarios stable IDs; arrays fit loaded datasets.</p><p><code>iterations</code> repeats one datapoint from 1 to 100 times. For <code>iterations: 3</code>, <code>weather/nyc</code> expands to <code>weather/nyc/1</code>, <code>weather/nyc/2</code>, and <code>weather/nyc/3</code>; selecting <code>weather/nyc</code> runs all three.</p><h2 id="eval-configuration" tabindex="-1">Eval configuration <a class="header-anchor" href="#eval-configuration" aria-label="Permalink to &quot;Eval configuration&quot;">​</a></h2><p>Every running suite needs <code>evals/evals.config.ts</code> with <code>maxConcurrency</code>:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineEvalConfig } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/evals&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
20
+ <span class="line"></span>
21
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineEvalConfig</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
22
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> maxConcurrency: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">20</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
23
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> timeoutMs: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">180_000</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
24
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> judge: { model: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;gpt-5.4-mini&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
25
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><table tabindex="0"><thead><tr><th>Option</th><th>Contract</th></tr></thead><tbody><tr><td><code>maxConcurrency</code></td><td>Required; concurrent authored datapoints, from 1 to 200</td></tr><tr><td><code>timeoutMs</code></td><td>Per-case timeout; case/file, CLI, then config precedence</td></tr><tr><td><code>judge</code></td><td>Default model for <code>t.judge</code></td></tr><tr><td><code>reporters</code></td><td>Objects notified as cases and runs complete</td></tr><tr><td><code>maxPlaygroundRuns</code></td><td>Number of server-side batches kept in playground history; defaults to 20</td></tr></tbody></table><p>A case can override <code>description</code>, <code>tags</code>, <code>timeoutMs</code>, <code>iterations</code>, <code>judge</code>, <code>reporters</code>, and <code>metadata</code>. Case metadata merges over file-level metadata; case reporters add to the file&#39;s reporters.</p><h2 id="send-turns-in-a-case" tabindex="-1">Send turns in a case <a class="header-anchor" href="#send-turns-in-a-case" aria-label="Permalink to &quot;Send turns in a case&quot;">​</a></h2><p><code>await t.send(message, options?)</code> runs one turn and waits until it finishes or fails. Several sends in one test share the session.</p><p>The returned turn exposes its assistant <code>message</code>, <code>sessionId</code>, <code>events</code>, ordered <code>toolCalls</code>, <code>ok</code>, and one-based <code>index</code>. Assertions on the turn inspect only that turn; assertions on <code>t</code> inspect the whole case. Run values include <code>t.reply</code>, <code>t.events</code>, <code>t.turns</code>, <code>t.sessionId</code>, <code>t.iteration</code>, <code>t.iterations</code>, and the timeout <code>t.signal</code>.</p><p>These options apply on the first send because they shape the session:</p><table tabindex="0"><thead><tr><th>Option</th><th>Contract</th></tr></thead><tbody><tr><td><code>workspaceFiles</code></td><td>Relative path-to-content map seeded into the session workspace</td></tr><tr><td><code>workspaceDir</code></td><td>Absolute working directory for a new local session</td></tr></tbody></table><p>Use <code>turn.expectOk()</code> when later test steps depend on the turn succeeding. It throws when the turn failed.</p><h2 id="trajectory-assertions" tabindex="-1">Trajectory assertions <a class="header-anchor" href="#trajectory-assertions" aria-label="Permalink to &quot;Trajectory assertions&quot;">​</a></h2><p>Assertions record failures without stopping the test, so one case reports every violated contract.</p><table tabindex="0"><thead><tr><th>Assertion</th><th>Checks</th></tr></thead><tbody><tr><td><code>t.succeeded()</code></td><td>Run finished without failure</td></tr><tr><td><code>t.calledTool(name, matcher?)</code></td><td>Matching tool request occurred</td></tr><tr><td><code>t.notCalledTool(name)</code></td><td>No request for that tool occurred</td></tr><tr><td><code>t.loadedSkill(name)</code></td><td>Agent opened a named skill</td></tr><tr><td><code>t.toolOrder(names)</code></td><td>Tool requests appeared in relative order</td></tr><tr><td><code>t.usedNoTools()</code></td><td>No tool was requested</td></tr><tr><td><code>t.maxToolCalls(max)</code></td><td>Tool-call count stayed under the bound</td></tr><tr><td><code>t.noFailedActions()</code></td><td>No tool result failed</td></tr><tr><td><code>t.calledSubagent(name, matcher?)</code></td><td>Matching subagent call occurred</td></tr><tr><td><code>t.taggedArtifact(kind?, predicate?)</code></td><td>Matching durable artifact was tagged</td></tr><tr><td><code>t.event(type, matcher?)</code></td><td>Matching session event occurred</td></tr><tr><td><code>t.notEvent(type, matcher?)</code></td><td>Matching session event did not occur</td></tr><tr><td><code>t.eventOrder(matchers)</code></td><td>Event groups appeared in relative order</td></tr><tr><td><code>t.eventsSatisfy(label, predicate)</code></td><td>Predicate accepted the event stream</td></tr><tr><td><code>t.check(value, expectation)</code></td><td>Value met an expectation builder</td></tr><tr><td><code>t.score(name, value)</code></td><td>Recorded a numeric score from 0 to 1</td></tr></tbody></table><p><code>t.requireToolCall</code>, <code>t.requireInputRequest</code>, and <code>t.require</code> return the matched value and stop the remaining test body when no match exists.</p><h2 id="tool-and-event-matchers" tabindex="-1">Tool and event matchers <a class="header-anchor" href="#tool-and-event-matchers" aria-label="Permalink to &quot;Tool and event matchers&quot;">​</a></h2><p>Tool matchers can narrow by <code>input</code>, <code>output</code>, <code>status</code>, and <code>count</code>. Values accept literals, regular expressions, or predicates. Object literals partial-deep-match:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">calledTool</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;inspect_pr&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, {</span></span>
26
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> input: { verdict: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;review&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
27
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> status: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;completed&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
28
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> count: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
29
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Tool status is <code>completed</code>, <code>failed</code>, <code>pending</code>, or <code>rejected</code>. Subagent matchers accept <code>output</code>, <code>status</code>, <code>count</code>, and <code>callId</code>. Event matchers accept <code>data</code> and <code>count</code>.</p><h2 id="expectation-builders" tabindex="-1">Expectation builders <a class="header-anchor" href="#expectation-builders" aria-label="Permalink to &quot;Expectation builders&quot;">​</a></h2><p>Import builders from <code>@cursor/bdk/evals</code>:</p><table tabindex="0"><thead><tr><th>Builder</th><th>Default severity</th></tr></thead><tbody><tr><td>\`includes(string</td><td>RegExp)\`</td></tr><tr><td><code>equals(value)</code></td><td>Hard gate</td></tr><tr><td><code>matches(schema)</code></td><td>Hard gate</td></tr><tr><td><code>satisfies(predicate, label)</code></td><td>Hard gate</td></tr><tr><td><code>similarity(expected)</code></td><td>Soft score</td></tr></tbody></table><p><code>matches</code> accepts Standard Schema implementations such as Zod. <code>normalizedSimilarity(value, expected)</code> returns the same 0-to-1 value used by <code>similarity</code>.</p><h2 id="severity-and-verdicts" tabindex="-1">Severity and verdicts <a class="header-anchor" href="#severity-and-verdicts" aria-label="Permalink to &quot;Severity and verdicts&quot;">​</a></h2><p>Every assertion returns a severity handle:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">succeeded</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span>
30
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">calledTool</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;search&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">soft</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span>
31
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">check</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(t.reply, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">similarity</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Expected answer&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">atLeast</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">0.8</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
32
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t.judge.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">closedQA</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;names the failing step&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">gate</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><ul><li><code>.gate(threshold?)</code> fails the case when it misses.</li><li><code>.soft(threshold?)</code> records a value without failing.</li><li><code>.atLeast(threshold)</code> records a soft bar; a miss produces a <code>scored</code> verdict.</li></ul><p>Case verdicts are <code>passed</code>, <code>failed</code>, <code>scored</code>, or <code>skipped</code>. The CLI exits 1 for a failed gate. A scored result exits 0 unless <code>--strict</code> is set. Exit 2 means the selection matched no cases.</p><h2 id="judges" tabindex="-1">Judges <a class="header-anchor" href="#judges" aria-label="Permalink to &quot;Judges&quot;">​</a></h2><p>Use a judge for meaning that deterministic checks cannot express:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t.judge.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">factuality</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(expected).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">atLeast</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">0.8</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
33
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t.judge.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">summarizes</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(expected).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">atLeast</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">0.8</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
34
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t.judge.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">closedQA</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;names the root cause&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">gate</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
35
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t.judge.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sql</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(expected).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">atLeast</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">0.9</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><p>Each grades <code>t.reply</code> by default; pass <code>{ on }</code> to grade another value. Judge configuration can live in the project config, eval, case, or call, with the nearest value winning.</p><p><code>t.judge.model(prompt)</code> returns a raw model reply for custom grading. Treat agent output as untrusted input: wrap it with <code>fenceUntrusted</code> and include <code>EVAL_JUDGE_INJECTION_GUARD</code> in the judge prompt.</p><h2 id="judge-host" tabindex="-1">Judge host <a class="header-anchor" href="#judge-host" aria-label="Permalink to &quot;Judge host&quot;">​</a></h2><p>A judge grades by calling a Cursor model. It needs a Cursor credential (<code>bdk login</code>, <code>CURSOR_API_KEY</code>, or <code>CURSOR_SERVICE_ACCOUNT_KEY</code>) and a judge model. The grading session offers no tools and turns the local SDK sandbox off, including any per-user sandbox config on the machine, so the same case grades on macOS, a Linux cloud agent, and a Linux CI runner.</p><p>Without a credential, or when that credential belongs to a different backend than the SDK will call, the case is skipped and the suite continues. Without a judge model, the case fails and the assertion names where to set one.</p><h2 id="datasets-and-fixtures" tabindex="-1">Datasets and fixtures <a class="header-anchor" href="#datasets-and-fixtures" aria-label="Permalink to &quot;Datasets and fixtures&quot;">​</a></h2><p>Load committed JSON, JSONL, or YAML relative to the project root:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineEval, includes } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/evals&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
36
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { loadYaml } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/evals/loaders&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
37
+ <span class="line"></span>
38
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> rows</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> loadYaml</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span></span>
39
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> Array</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{ </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">task</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: string; </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">prompt</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: string; </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">expected</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: string }</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
40
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;evals/data/cases.yaml&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
41
+ <span class="line"></span>
42
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> rows.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">map</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">row</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =&gt;</span></span>
43
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineEval</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
44
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> description: row.task,</span></span>
45
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> test</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">t</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
46
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">send</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(row.prompt);</span></span>
47
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">succeeded</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span>
48
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> t.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">check</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(t.reply, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">includes</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(row.expected));</span></span>
49
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
50
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })</span></span>
51
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><h2 id="reporters-and-results" tabindex="-1">Reporters and results <a class="header-anchor" href="#reporters-and-results" aria-label="Permalink to &quot;Reporters and results&quot;">​</a></h2><p>Built-in reporters include <code>JUnit({ filePath, suiteName? })</code> and <code>Artifacts({ dir })</code>. Custom reporters can expose <code>onRunStart</code>, <code>onEvalComplete</code>, and <code>onRunComplete</code>.</p><p>JSON output contains run totals and one result per case. Results include the case ID, verdict, assertions, session ID, inputs, final text, tools, tool calls, metrics, logs, duration, metadata, tags, and any error or skip reason.</p><h2 id="select-cases" tabindex="-1">Select cases <a class="header-anchor" href="#select-cases" aria-label="Permalink to &quot;Select cases&quot;">​</a></h2><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk eval --dir . --list</span></span>
52
+ <span class="line"><span>bdk eval --dir .</span></span>
53
+ <span class="line"><span>bdk eval --dir . builds/checkout</span></span>
54
+ <span class="line"><span>bdk eval --dir . --tag smoke</span></span></code></pre></div><p>ID filters match an exact ID and its descendants. Repeated IDs use OR; repeated tags use OR. When both are present, a case must match both groups.</p><h2 id="inspect-run-artifacts" tabindex="-1">Inspect run artifacts <a class="header-anchor" href="#inspect-run-artifacts" aria-label="Permalink to &quot;Inspect run artifacts&quot;">​</a></h2><p>Default run artifacts go under <code>evals/&lt;stamp&gt;/</code> in the project state directory and include <code>summary.json</code>, <code>results.jsonl</code>, and <code>evals/&lt;case-id&gt;.json</code>. <code>--artifacts &lt;dir&gt;</code> chooses another destination; <code>--no-artifacts</code> disables them. This location is independent of <code>--state-root</code>.</p><h2 id="run-evals-against-a-server" tabindex="-1">Run evals against a server <a class="header-anchor" href="#run-evals-against-a-server" aria-label="Permalink to &quot;Run evals against a server&quot;">​</a></h2><p>The playground <strong>Evals</strong> view starts batches on its running server, and <code>--url</code> targets a named running server:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk eval --url http://127.0.0.1:3000/vulnerability-scanner --tag smoke</span></span>
55
+ <span class="line"><span>bdk eval status &lt;eval-id&gt; --url http://127.0.0.1:3000/vulnerability-scanner</span></span>
56
+ <span class="line"><span>bdk eval cancel &lt;eval-id&gt; --url http://127.0.0.1:3000/vulnerability-scanner</span></span></code></pre></div><p>Server-side batches use the target&#39;s discovered cases and return an eval ID for <code>status</code> or <code>cancel</code>. Local reporter and concurrency flags don&#39;t apply to <code>--url</code> runs.</p><h2 id="related" tabindex="-1">Related <a class="header-anchor" href="#related" aria-label="Permalink to &quot;Related&quot;">​</a></h2><ul><li><a href="./../evals.html">Evals guide</a></li><li><a href="./cli.html#eval">CLI reference</a></li><li><a href="./sessions.html">Sessions</a></li><li><a href="./artifacts.html">Artifacts</a></li></ul>`,63)])])}const E=e(n,[["render",d]]);export{k as __pageData,E as default};
@@ -0,0 +1 @@
1
+ import{_ as e,c as a,o as i,a3 as t}from"./chunks/framework.BNw1pucY.js";const k=JSON.parse('{"title":"Evals","description":"Define eval cases, drive turns, assert trajectories, and interpret results.","frontmatter":{"title":"Evals","description":"Define eval cases, drive turns, assert trajectories, and interpret results."},"headers":[],"relativePath":"reference/evals.md","filePath":"reference/evals.md"}'),n={name:"reference/evals.md"};function d(l,s,h,r,o,p){return i(),a("div",null,[...s[0]||(s[0]=[t("",63)])])}const E=e(n,[["render",d]]);export{k as __pageData,E as default};
@@ -0,0 +1,62 @@
1
+ import{_ as i,c as a,o as n,a3 as e}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse('{"title":"Extensions","description":"Mount a namespaced package of tools, skills, connections, and other agent capabilities, then inspect or override what it adds.","frontmatter":{"title":"Extensions","description":"Mount a namespaced package of tools, skills, connections, and other agent capabilities, then inspect or override what it adds."},"headers":[],"relativePath":"reference/extensions.md","filePath":"reference/extensions.md"}'),t={name:"reference/extensions.md"};function l(p,s,o,h,d,r){return n(),a("div",null,[...s[0]||(s[0]=[e(`<h1 id="extensions" tabindex="-1">Extensions <a class="header-anchor" href="#extensions" aria-label="Permalink to &quot;Extensions&quot;">​</a></h1><p>An extension packages capabilities that would otherwise live under <code>bot/</code>: tools, skills, instructions, connections, hooks, channels, schedules, subagents, artifacts, and workspace seeds. One mount file adds them under a namespace without copying their source into your project.</p><p>Extensions and Cursor plugins execute as trusted host code. A namespace prevents name collisions; it does not sandbox the package or limit its side effects. Review the package before mounting it.</p><h2 id="mount-an-extension" tabindex="-1">Mount an extension <a class="header-anchor" href="#mount-an-extension" aria-label="Permalink to &quot;Mount an extension&quot;">​</a></h2><p>Install the package and add one file under <code>bot/extensions/</code>. The filename becomes the namespace, so this mount contributes names such as <code>ci__failed_jobs</code> and <code>ci__triage</code>.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// bot/extensions/ci.ts</span></span>
2
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ci </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@acme/ci-triage&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
3
+ <span class="line"></span>
4
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> ci</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
5
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> org: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;acme&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
6
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> token</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> process.env.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">BUILDKITE_TOKEN</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> ??</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
7
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Pass <code>token</code> as a function so a tool can call it. The function reads <code>BUILDKITE_TOKEN</code> when the tool calls it.</p><p>The extension validates its configuration while the project loads. Missing or mistyped settings fail <code>bdk validate</code> before a turn can call the contributed code.</p><p>Extension instructions are appended to the root agent&#39;s instructions. The root agent still needs its own <code>bot/instructions.md</code>.</p><h2 id="inspect-a-mount" tabindex="-1">Inspect a mount <a class="header-anchor" href="#inspect-a-mount" aria-label="Permalink to &quot;Inspect a mount&quot;">​</a></h2><p>Run discovery after mounting or upgrading an extension:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk validate --dir .</span></span>
8
+ <span class="line"><span>bdk info --dir . --json</span></span></code></pre></div><p><code>info</code> lists each mount and its namespaced tools, skills, connections, hooks, channels, schedules, subagents, and artifact kinds. The same data appears under <code>extensions</code> in <code>GET /v1/info</code>.</p><p>A mount can also widen what a hosted deployment reaches. <code>info</code> shows the egress hosts and secret names each mount adds, and <code>bdk deploy</code> names every extension that adds egress before it deploys.</p><p>Names inside the extension stay short. A tool authored as <code>tools/failed_jobs.ts</code> appears to the mounting agent as <code>&lt;namespace&gt;__failed_jobs</code>. The <code>__</code> separator is reserved, so root contributions cannot impersonate a mounted one.</p><h2 id="adjust-a-mounted-extension" tabindex="-1">Adjust a mounted extension <a class="header-anchor" href="#adjust-a-mounted-extension" aria-label="Permalink to &quot;Adjust a mounted extension&quot;">​</a></h2><p>Mount as a directory when you need to replace or remove one contribution. Keep the package mount in <code>extension.ts</code>, then overlay the extension&#39;s short name beneath it.</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bot/extensions/ci/</span></span>
9
+ <span class="line"><span> extension.ts</span></span>
10
+ <span class="line"><span> tools/</span></span>
11
+ <span class="line"><span> job_log.ts</span></span>
12
+ <span class="line"><span> retry_job.ts</span></span></code></pre></div><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// bot/extensions/ci/tools/job_log.ts</span></span>
13
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineTool } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/tools&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
14
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
15
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> jobLogInput,</span></span>
16
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> readRedactedLog,</span></span>
17
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">} </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;../../../lib/ci.js&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
18
+ <span class="line"></span>
19
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineTool</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
20
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> description: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Read a redacted CI log.&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
21
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> inputSchema: jobLogInput,</span></span>
22
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> execute: readRedactedLog,</span></span>
23
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// bot/extensions/ci/tools/retry_job.ts</span></span>
24
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { disableTool } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/extensions&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
25
+ <span class="line"></span>
26
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> disableTool</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><p>The first file replaces <code>ci__job_log</code>; the second removes <code>ci__retry_job</code>. Use the matching <code>disable*</code> helper for another slot, or generic <code>disable()</code> when the file location already identifies it. Validation fails when an overlay names a contribution the package does not provide.</p><h2 id="mount-a-cursor-plugin" tabindex="-1">Mount a Cursor plugin <a class="header-anchor" href="#mount-a-cursor-plugin" aria-label="Permalink to &quot;Mount a Cursor plugin&quot;">​</a></h2><p><code>cursorPlugin()</code> adapts a vendored Cursor or Claude plugin into the same namespace model. Skills, commands, agents, and MCP servers become BDK skills, subagents, and connections.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// bot/extensions/notion.ts</span></span>
27
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { cursorPlugin } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/extensions&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
28
+ <span class="line"></span>
29
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> cursorPlugin</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
30
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> path: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;plugins/notion-workspace&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
31
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> variables: {</span></span>
32
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> NOTION_TOKEN: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;\${NOTION_TOKEN}&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
33
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
34
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p><code>path</code> is relative to the project root. <code>variables</code> fills placeholders declared by the plugin&#39;s MCP configuration. Pass a <code>\${NAME}</code> template. The connection reads <code>NAME</code> when it opens. An unresolved placeholder fails validation instead of mounting a partial server.</p><p>Plugin rules and hooks are not mounted. Overlay a generated <code>mcp-connections/&lt;server&gt;.ts</code> file to replace or disable one plugin server. OAuth-backed plugin servers use <a href="./../guides/mcp-oauth.html">Host MCP OAuth</a>; transport and tool-filter details live in <a href="./connections.html">MCP connections</a>.</p><h2 id="extension-contents" tabindex="-1">Extension contents <a class="header-anchor" href="#extension-contents" aria-label="Permalink to &quot;Extension contents&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Ships under the namespace</th><th>Ignored</th></tr></thead><tbody><tr><td>Instructions, tools, skills, MCP and host connections</td><td><code>agent.ts</code>, storage, OpenTelemetry</td></tr><tr><td>Hooks, channels, schedules, and subagents</td><td>Playground code, custom sandbox backends</td></tr><tr><td>Artifact kinds and workspace seed files</td><td>Nested extensions</td></tr></tbody></table><p><code>bdk validate</code> reports unsupported paths.</p><h2 id="build-an-extension" tabindex="-1">Build an extension <a class="header-anchor" href="#build-an-extension" aria-label="Permalink to &quot;Build an extension&quot;">​</a></h2><p>Lay out the package like the shareable part of <code>bot/</code>. The root <code>extension.ts</code> supplies a description and validates any settings the consumer must provide.</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>@acme/ci-triage/</span></span>
35
+ <span class="line"><span> package.json</span></span>
36
+ <span class="line"><span> extension.ts</span></span>
37
+ <span class="line"><span> instructions.md</span></span>
38
+ <span class="line"><span> tools/</span></span>
39
+ <span class="line"><span> failed_jobs.ts</span></span>
40
+ <span class="line"><span> job_log.ts</span></span>
41
+ <span class="line"><span> skills/</span></span>
42
+ <span class="line"><span> triage.md</span></span>
43
+ <span class="line"><span> hooks/</span></span>
44
+ <span class="line"><span> audit.ts</span></span>
45
+ <span class="line"><span> lib/</span></span>
46
+ <span class="line"><span> buildkite.ts</span></span></code></pre></div><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// extension.ts</span></span>
47
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineExtension } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/extensions&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
48
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { z } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;zod&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
49
+ <span class="line"></span>
50
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineExtension</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
51
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> root: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">meta</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.dirname,</span></span>
52
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> description: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Investigate failing Buildkite jobs.&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
53
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> config: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">object</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
54
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> org: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(),</span></span>
55
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> token: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">function</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">args</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">returns</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()),</span></span>
56
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> logTailLines: z.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">number</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">int</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">positive</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">200</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
57
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }),</span></span>
58
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> hosting</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ({</span></span>
59
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> egressDomains: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;api.buildkite.com&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
60
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> secretNames: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;BUILDKITE_TOKEN&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
61
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }),</span></span>
62
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Modules inside the package import this definition and read <code>extension.config</code>, which is already validated and has defaults applied. Publish the built entry point with its slot directories and prose assets beside it.</p><p><code>hosting</code> names the hosts the package calls and the secrets it reads from the environment. It receives the validated settings, and the mounting agent&#39;s <code>hosting.egressDomains</code> and <code>hosting.secretNames</code> gain whatever it returns, so a hosted deploy reaches Buildkite without the consumer listing <code>api.buildkite.com</code>. List <code>BUILDKITE_TOKEN</code> in <code>secretNames</code>. Call <code>extension.config.token()</code> inside a tool.</p><p>The <a href="./project-layout.html">Project layout</a> owns each contribution&#39;s authoring contract. Keep extension instructions and tool descriptions namespace-neutral because the consumer chooses the final prefix.</p><h2 id="related" tabindex="-1">Related <a class="header-anchor" href="#related" aria-label="Permalink to &quot;Related&quot;">​</a></h2><ul><li><a href="./../guides/cloud-agents.html">Cloud agents</a>: delegate repository work through an extension</li><li><a href="./../guides/grokbot-agents.html">Grok Bot agents</a>: consult named bots</li><li><a href="./../guides/jev.html">Jev</a>: typed answers, then gated writes</li><li><a href="./../guides/improve.html">Self-improvement</a>: propose source changes through pull requests</li><li><a href="./project-layout.html">Project layout</a>: contribution slots</li><li><a href="./tools.html">Tools</a> and <a href="./skills.html">Skills</a>: capability contracts</li></ul>`,38)])])}const E=i(t,[["render",l]]);export{c as __pageData,E as default};
@@ -0,0 +1 @@
1
+ import{_ as i,c as a,o as n,a3 as e}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse('{"title":"Extensions","description":"Mount a namespaced package of tools, skills, connections, and other agent capabilities, then inspect or override what it adds.","frontmatter":{"title":"Extensions","description":"Mount a namespaced package of tools, skills, connections, and other agent capabilities, then inspect or override what it adds."},"headers":[],"relativePath":"reference/extensions.md","filePath":"reference/extensions.md"}'),t={name:"reference/extensions.md"};function l(p,s,o,h,d,r){return n(),a("div",null,[...s[0]||(s[0]=[e("",38)])])}const E=i(t,[["render",l]]);export{c as __pageData,E as default};
@@ -0,0 +1,51 @@
1
+ import{_ as e,c as t,o as a,a3 as i}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse('{"title":"Hooks","description":"Observe-only subscribers to the session event stream: audit logs, metrics, transcript mirrors, derived state.","frontmatter":{"title":"Hooks","description":"Observe-only subscribers to the session event stream: audit logs, metrics, transcript mirrors, derived state."},"headers":[],"relativePath":"reference/hooks.md","filePath":"reference/hooks.md"}'),n={name:"reference/hooks.md"};function o(d,s,h,l,r,k){return a(),t("div",null,[...s[0]||(s[0]=[i(`<h1 id="hooks" tabindex="-1">Hooks <a class="header-anchor" href="#hooks" aria-label="Permalink to &quot;Hooks&quot;">​</a></h1><p>A hook subscribes to selected session events and can run a side effect after each matching event is recorded: an audit line, a metric, a transcript copy, or derived state. Hooks run in the serving process for every session of the agent. They cannot change the turn, the prompt, or the reply; a handler that throws is logged and skipped.</p><p>Treat the event as read-only. Later subscribers see the same object. That makes hooks safe to add to a production agent, and the wrong surface for anything that must run before the model or must fail a turn; see <a href="#hook-boundaries">Hook boundaries</a>.</p><p><code>defineHook</code> is unrelated to <a href="https://cursor.com/docs/agent/hooks" target="_blank" rel="noreferrer">Cursor Agent hooks</a>, the <code>.cursor/hooks.json</code> scripts that can observe, block, or modify the agent loop. Those still run inside a local session workspace.</p><h2 id="author-a-hook" tabindex="-1">Author a hook <a class="header-anchor" href="#author-a-hook" aria-label="Permalink to &quot;Author a hook&quot;">​</a></h2><p>Author <code>bot/hooks/&lt;name&gt;.ts</code> with <code>defineHook</code> from <code>@cursor/bdk/hooks</code>. This one meters tokens:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// bot/hooks/usage.ts</span></span>
2
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { metrics } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@opentelemetry/api&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
3
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineHook } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/hooks&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
4
+ <span class="line"></span>
5
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> meter</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> metrics.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getMeter</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;acme&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
6
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> inputTokens</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> meter.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">createCounter</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;acme.tokens.input&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
7
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> outputTokens</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> meter.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">createCounter</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;acme.tokens.output&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
8
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> turnFailed</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> meter.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">createCounter</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;acme.turn.failed&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span>
9
+ <span class="line"></span>
10
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineHook</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
11
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> events: {</span></span>
12
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;turn.completed&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">event</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">ctx</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
13
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (ctx.session.purpose </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">===</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;eval&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> ||</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> event.data.usage </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">===</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> undefined</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
14
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
15
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
16
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> usage</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> event.data.usage;</span></span>
17
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> inputTokens.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">add</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(usage.inputTokens);</span></span>
18
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> outputTokens.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">add</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(usage.outputTokens);</span></span>
19
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
20
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;turn.failed&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">_event</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">ctx</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
21
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> turnFailed.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">add</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, { channel: ctx.channel.id });</span></span>
22
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
23
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
24
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Any module under <code>bot/hooks/</code>, subfolders included, is a hook named by its path without the extension: <code>bot/hooks/audit/usage.ts</code> is <code>audit/usage</code>. <code>*.test.ts</code> and <code>*.spec.ts</code> files are skipped. The default export must be <code>defineHook(...)</code>, names can&#39;t contain <code>__</code>, and an empty <code>events</code> map skips the hook with a warning; <code>bdk validate</code> reports all three. An extension mounts its hooks as <code>&lt;ns&gt;__&lt;name&gt;</code>, and <code>disableHook()</code> removes one (<a href="./extensions.html#adjust-a-mounted-extension">Adjust a mounted extension</a>).</p><p><code>bdk init</code> scaffolds <code>bot/hooks/memory.ts</code>, which exports <code>memoryHook()</code> from <code>@cursor/bdk/memory</code> and journals every turn for later sessions to read. Delete the file to opt out. See <a href="./memory.html">Memory</a>.</p><h2 id="events-and-payloads" tabindex="-1">Events and payloads <a class="header-anchor" href="#events-and-payloads" aria-label="Permalink to &quot;Events and payloads&quot;">​</a></h2><p>Keys are event types from the <a href="./sessions.html#stream-events">event vocabulary</a>, or <code>&quot;*&quot;</code> for every event. A typed key narrows <code>event.data</code>; a <code>&quot;*&quot;</code> handler receives the union, so switch on <code>event.type</code>. Every event carries the stream envelope <code>{ type, index, sessionId, turnId?, at, data }</code>, with <code>turnId</code> set on turn-scoped events. Skip <code>*.appended</code> deltas when you want the final text; <code>message.completed</code> already has it.</p><table tabindex="0"><thead><tr><th>Event</th><th><code>event.data</code></th></tr></thead><tbody><tr><td><code>message.received</code></td><td><code>{ text }</code></td></tr><tr><td><code>turn.completed</code></td><td><code>{ result?, usage?, cost? }</code>. <code>usage</code> has <code>inputTokens</code>, <code>outputTokens</code>, <code>cacheReadTokens</code>, <code>cacheWriteTokens</code>, and optional <code>reasoningTokens</code>. <code>cost</code> has <code>totalUsd</code> and the <code>model</code> it was priced against</td></tr><tr><td><code>turn.failed</code></td><td><code>{ message, status? }</code>. <code>status</code> is <code>&quot;error&quot;</code> or <code>&quot;cancelled&quot;</code> when present</td></tr><tr><td><code>actions.requested</code></td><td><code>{ calls: [{ callId, toolName, args?, parentCallId? }], parentCallId? }</code>. One envelope per model step once that step has listed its tools. A single tool is a batch of one. <code>parentCallId</code> marks subagent work</td></tr><tr><td><code>actions.completed</code></td><td><code>{ results: [{ callId, toolName, output?, isError, stubbed?, parentCallId? }], parentCallId? }</code>. Pair with <code>actions.requested</code>; emitted when every call in that batch has a result</td></tr><tr><td><code>action.result</code></td><td><code>{ callId, toolName, output?, isError, stubbed?, parentCallId? }</code>. Live per-call envelope for chips and spans. <code>stubbed</code> means a dry-run session answered a write without running it</td></tr><tr><td><code>action.tool_retry</code></td><td><code>{ callId, toolName, attempt, reason, connection? }</code>. A read is running again after a transient failure. <code>attempt</code> is the try about to run. <code>reason</code> is a class such as <code>transport</code> or <code>http_503</code></td></tr></tbody></table><p>The types are <code>SessionEvent</code>, <code>SessionEventType</code>, and <code>HookContext</code>, exported from <code>@cursor/bdk</code>.</p><h2 id="handler-context" tabindex="-1">Handler context <a class="header-anchor" href="#handler-context" aria-label="Permalink to &quot;Handler context&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Member</th><th>What it is</th></tr></thead><tbody><tr><td><code>ctx.session</code></td><td>Read-only session info: <code>id</code>, <code>channelId</code>, <code>mode</code> (<code>chat</code> or <code>task</code>), <code>purpose</code> (<code>live</code> or <code>eval</code>), <code>auth</code>, plus <code>title</code> and <code>sdkAgentId</code> when set</td></tr><tr><td><code>ctx.agent</code></td><td><code>{ name }</code> of the agent the event belongs to</td></tr><tr><td><code>ctx.channel</code></td><td><code>{ id, continuationToken }</code>. The token is <code>null</code> when the session can&#39;t take follow-ups</td></tr><tr><td><code>ctx.host.kv</code></td><td>Durable JSON, shared by every session of the agent. Prefix keys with <code>ctx.session.id</code> for per-session state</td></tr><tr><td><code>ctx.host.files</code></td><td>Durable files, bound to this session. Pass <code>{ scope: &quot;deployment&quot; }</code> for agent-wide files</td></tr><tr><td><code>ctx.host.mcp</code>, <code>ctx.host.github</code>, <code>ctx.host.slack</code></td><td>The same shared clients tools get</td></tr><tr><td><code>ctx.host.reminders</code></td><td>Per-session <a href="./schedules.html#reminders">reminders</a>, the same API tools get</td></tr><tr><td><code>ctx.artifacts</code></td><td>Session-bound <a href="./artifacts.html">artifacts</a> facade: <code>tag</code> fills in <code>sessionId</code> and <code>turnId</code></td></tr><tr><td><code>ctx.stateRoot</code></td><td>Absolute path of the local state root. It resets when a hosted deployment is replaced; keep derived state in <code>kv</code> or <code>files</code></td></tr></tbody></table><h2 id="hook-dispatch" tabindex="-1">Hook dispatch <a class="header-anchor" href="#hook-dispatch" aria-label="Permalink to &quot;Hook dispatch&quot;">​</a></h2><p>A hook runs after the event is recorded. It never delays the model and never sees an event that wasn&#39;t recorded.</p><table tabindex="0"><thead><tr><th>Rule</th><th>What happens</th></tr></thead><tbody><tr><td>Same session</td><td>Events dispatch one at a time</td></tr><tr><td>Eval sessions</td><td>The same stream fires; skip metering or paging when <code>ctx.session.purpose === &quot;eval&quot;</code></td></tr><tr><td>Host restart</td><td>Recorded events are not replayed into hooks, so a mirror needs no dedupe</td></tr><tr><td>Slow handler</td><td>Holds the next event&#39;s handlers on that session, not the model. Keep handlers short and queue anything slow</td></tr></tbody></table><p>Read hosted secrets inside the handler, not at module scope. Give outbound calls a timeout; a stalled request holds later handlers on that session. Skip cancelled turns when paging; they record interrupted work.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// bot/hooks/page-on-failure.ts</span></span>
25
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineHook } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/hooks&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
26
+ <span class="line"></span>
27
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineHook</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
28
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> events: {</span></span>
29
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> async</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;turn.failed&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">event</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">ctx</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) {</span></span>
30
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> pagerUrl</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> process.env.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">PAGER_WEBHOOK_URL</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
31
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (</span></span>
32
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> pagerUrl </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">===</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> undefined</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> ||</span></span>
33
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ctx.session.purpose </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">===</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;eval&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> ||</span></span>
34
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> event.data.status </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">===</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;cancelled&quot;</span></span>
35
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ) {</span></span>
36
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
37
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
38
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> fetch</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(pagerUrl, {</span></span>
39
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> method: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;POST&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
40
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> headers: { </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;content-type&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;application/json&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
41
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> body: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">JSON</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">stringify</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
42
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> agent: ctx.agent.name,</span></span>
43
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> session: ctx.session.id,</span></span>
44
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> channel: ctx.channel.id,</span></span>
45
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> message: event.data.message,</span></span>
46
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }),</span></span>
47
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> signal: AbortSignal.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">timeout</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">5_000</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
48
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> });</span></span>
49
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
50
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
51
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><h2 id="hooks-vs-channels-vs-evals" tabindex="-1">Hooks vs channels vs evals <a class="header-anchor" href="#hooks-vs-channels-vs-evals" aria-label="Permalink to &quot;Hooks vs channels vs evals&quot;">​</a></h2><p>All three consume the same stream, for different jobs:</p><table tabindex="0"><thead><tr><th></th><th>Hooks</th><th>Channel <code>events</code></th><th>Evals</th></tr></thead><tbody><tr><td>Scope</td><td>every session of the agent</td><td>sessions the channel owns</td><td>one test turn</td></tr><tr><td>Job</td><td>observe: audit, metrics, mirrors, derived state</td><td>deliver: replies back to the channel&#39;s surface</td><td>assert: gates over the trajectory</td></tr><tr><td>Context</td><td><code>ctx.host</code>, <code>ctx.artifacts</code>, session info</td><td><code>channel.state</code>, <code>setContinuationToken</code>, <code>ctx.host</code>, session info</td><td>the <code>t</code> assertion helpers</td></tr><tr><td>Can affect the run</td><td>no</td><td>yes, it owns the surface</td><td>n/a</td></tr><tr><td>Authored at</td><td><code>bot/hooks/*.ts</code></td><td>channel config</td><td><code>evals/**/*.eval.ts</code></td></tr></tbody></table><h2 id="hook-boundaries" tabindex="-1">Hook boundaries <a class="header-anchor" href="#hook-boundaries" aria-label="Permalink to &quot;Hook boundaries&quot;">​</a></h2><table tabindex="0"><thead><tr><th>You want to</th><th>Use instead</th></tr></thead><tbody><tr><td>Add context before the model runs</td><td>The channel&#39;s <code>send</code> message and <code>workspaceFiles</code>, <code>instructions.md</code>, skills, or <code>sandbox/workspace/</code> seed files</td></tr><tr><td>Reply on Slack, comment on a PR, or post any other delivery</td><td>The channel&#39;s <code>events</code> map, or the Slack and GitHub packs</td></tr><tr><td>Show PR progress (merge-box check, sticky banner)</td><td><code>githubChannel({ progress: { commitStatus, banner } })</code>; see <a href="./../guides/github.html">GitHub agents</a></td></tr><tr><td>Gate a change on behavior</td><td><a href="./../evals.html">Evals</a></td></tr></tbody></table><p>To act on a turn&#39;s decision, such as a label or a ticket, have the model record it with an authored <a href="./tools.html">tool</a>. A <code>turn.completed</code> hook then reads the recorded decision and acts on it through <code>ctx.host</code>.</p><h2 id="test-a-hook" tabindex="-1">Test a hook <a class="header-anchor" href="#test-a-hook" aria-label="Permalink to &quot;Test a hook&quot;">​</a></h2><p>A hook definition is a plain object, so a unit test calls <code>hook.events[&quot;turn.completed&quot;]</code> directly with an event and a stub <code>HookContext</code>. Discovery skips <code>*.test.ts</code>, so the test can live next to the hook.</p><table tabindex="0"><thead><tr><th>Command</th><th>What it reports</th></tr></thead><tbody><tr><td><code>bdk validate --dir .</code></td><td>Discovery errors and the empty-handlers warning</td></tr><tr><td><code>bdk info --dir . --json</code></td><td>Loaded hooks under <code>agents[].hooks</code></td></tr><tr><td><code>bdk run --dir . --message &quot;…&quot;</code></td><td>Serve log on stderr, including <code>hook &quot;&lt;name&gt;&quot; handler for &lt;event&gt; threw: …</code></td></tr></tbody></table><p>On hosting, read the same log with <a href="./cli.html#logs"><code>bdk logs</code></a>.</p><h2 id="related" tabindex="-1">Related <a class="header-anchor" href="#related" aria-label="Permalink to &quot;Related&quot;">​</a></h2><ul><li><a href="./../guides/hooks.html">Hooks guide</a>: meter usage and page on failure</li><li><a href="./sessions.html">Sessions and streaming</a>: the event vocabulary hooks observe</li><li><a href="./../guides/opentelemetry.html">OpenTelemetry</a>: OTLP traces and metrics from the same event stream</li><li><a href="./../deployment.html#observability">Deployment</a>: runtime logs and export paths</li><li><a href="./channels.html#events">Channels</a>: the delivery-side counterpart</li></ul>`,32)])])}const E=e(n,[["render",o]]);export{c as __pageData,E as default};
@@ -0,0 +1 @@
1
+ import{_ as e,c as t,o as a,a3 as i}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse('{"title":"Hooks","description":"Observe-only subscribers to the session event stream: audit logs, metrics, transcript mirrors, derived state.","frontmatter":{"title":"Hooks","description":"Observe-only subscribers to the session event stream: audit logs, metrics, transcript mirrors, derived state."},"headers":[],"relativePath":"reference/hooks.md","filePath":"reference/hooks.md"}'),n={name:"reference/hooks.md"};function o(d,s,h,l,r,k){return a(),t("div",null,[...s[0]||(s[0]=[i("",32)])])}const E=e(n,[["render",o]]);export{c as __pageData,E as default};