@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,307 @@
1
+ # MCP connections
2
+
3
+ An MCP connection gives the agent tools from an MCP server. Define one
4
+ file per server under `bot/mcp-connections/`; the filename becomes the
5
+ server name. Default-export `defineConnection` from
6
+ `@cursor/bdk/connections`. The transport is remote HTTP, local stdio,
7
+ the signed-in Cursor account's connectors, or a peer agent addressed by
8
+ slug.
9
+
10
+ Put a server in `bot/host-connections/` when only host tools should
11
+ call it. Host connections use the same `defineConnection` shape and
12
+ support `bdk mcp oauth`; the model and playground don't see them.
13
+
14
+ ## Remote MCP server
15
+
16
+ Point an MCP connection at a remote server with a URL.
17
+
18
+ ```ts
19
+ import { defineConnection } from "@cursor/bdk/connections";
20
+
21
+ export default defineConnection({
22
+ url: "https://mcp.linear.app/mcp",
23
+ headers: { authorization: "Bearer ${LINEAR_TOKEN}" },
24
+ });
25
+ ```
26
+
27
+ ## Credentials in headers and env
28
+
29
+ Write a credential as a `${NAME}` template in `headers` on a remote
30
+ connection or in `env` on a stdio one. The connection stores the template
31
+ as you wrote it and reads `NAME` from the environment every time it opens a
32
+ client, so the value can arrive after the project loads.
33
+
34
+ ```ts
35
+ export default defineConnection({
36
+ command: "slack-mcp-server",
37
+ args: ["--transport", "stdio"],
38
+ env: { SLACK_MCP_XOXB_TOKEN: "${SLACK_BOT_TOKEN}" },
39
+ });
40
+ ```
41
+
42
+ That timing is the point of the template. Your connection file is imported
43
+ once, when the project loads, and a hosted deployment has none of its
44
+ secrets in the environment yet, because the platform passes them to the
45
+ agent per request. So a `process.env.SLACK_BOT_TOKEN` read at the top of
46
+ the file captures an empty string and keeps sending it for the life of the
47
+ process, while the same file works locally because `.env.local` was read
48
+ before the import. The template form is right in both places.
49
+
50
+ `bdk validate` warns about a template the environment does not define and
51
+ names the variable. It stays a warning rather than an error, since a
52
+ hosted deployment resolves it later. An unset variable resolves to an
53
+ empty value at connect time, which the server reports as an auth failure.
54
+
55
+ ## Host MCP OAuth
56
+
57
+ For servers that speak OAuth, set `oauth: true` and authorize with the
58
+ CLI or mid-run Connect. Tokens live in `mcp-auth.json` under the CLI
59
+ config directory of the machine that authorized them. A hosted agent
60
+ reaches OAuth servers through a
61
+ [Cursor account connection](#cursor-account-mcp-connection) instead.
62
+
63
+ ```ts
64
+ export default defineConnection({
65
+ url: "https://mcp.example.com/inventory",
66
+ oauth: true,
67
+ });
68
+ ```
69
+
70
+ ```text
71
+ bdk mcp oauth inventory # browser PKCE → local mcp-auth.json
72
+ ```
73
+
74
+ Full walkthrough: [Host MCP OAuth](/docs/guides/mcp-oauth.md). Companion
75
+ skill: [`skills/mcp-auth/SKILL.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/mcp-auth/SKILL.md).
76
+
77
+ ## Per-session auth
78
+
79
+ For http/sse connections whose credential depends on who the session is
80
+ for, declare an `auth` callback instead of static headers. It runs
81
+ host-side with the session's `SessionInfo` and returns headers merged
82
+ over the static ones:
83
+
84
+ ```ts
85
+ export default defineConnection({
86
+ url: "https://api.cursor.com/v1/mcp/plugins",
87
+ auth: async (session) => ({
88
+ headers: { Authorization: `Bearer ${await grantFor(session)}` },
89
+ }),
90
+ advertiseTools: true,
91
+ });
92
+ ```
93
+
94
+ The callback is evaluated on every turn, including reminder
95
+ fires and post-restart follow-ups, so the identity always comes from the
96
+ session itself, never from state parked in memory. The model never sees a
97
+ downstream account parameter and cannot choose the account. A callback
98
+ that throws fails the turn: a turn never silently runs without the
99
+ connection's identity. `host.mcp` calls from server tools keep the static
100
+ headers only. You can't combine `auth` with `oauth: true`; the host OAuth
101
+ provider owns the Authorization header.
102
+
103
+ Derive the identity from durable session facts: `session.auth`,
104
+ `session.id`, or your channel's own session state. Do not key it off
105
+ `session.continuationKey`. The HTTP channel rotates that key after every
106
+ accepted follow-up, so an account mapping keyed on it breaks
107
+ mid-conversation.
108
+
109
+ `auth` works attached or advertised. Advertise the auth connection
110
+ instead of attaching it next to a stateful stdio server.
111
+
112
+ ## Advertise tools {#advertise-tools}
113
+
114
+ Set `advertiseTools: true` when the model should call an MCP server's
115
+ tools by name. BDK preserves each tool's description, input
116
+ and output schemas, and MCP annotations. Exposed names normalize invalid
117
+ characters and add numeric suffixes to avoid collisions.
118
+
119
+ ```ts
120
+ export default defineConnection({
121
+ url: "https://api.cursor.com/v1/mcp/plugins",
122
+ auth: async (session) => ({ headers: await headersForSession(session) }),
123
+ advertiseTools: true,
124
+ });
125
+ ```
126
+
127
+ Listing, authentication, invalid tool name, and name collision failures
128
+ fail the turn by default. Set `optional: true` to omit an unavailable
129
+ connection instead. Advertised tools behave like server tools, and
130
+ [direct tool calls](/docs/reference/tools.md#call-a-tool-without-a-model-turn) use the
131
+ same names.
132
+
133
+ In a dry-run session, MCP tools marked read-only run normally. Tools
134
+ marked as writes are stubbed. Tools without effect annotations are
135
+ unavailable. A tool annotated read-only uses the same transient retry as
136
+ an authored read. A tool with no effect annotation runs once.
137
+
138
+ ## Filter connection tools
139
+
140
+ Use `tools` the same way you allowlist harness tools on the agent. When
141
+ set, the connection serves only those names. Use `disallowedTools` to
142
+ drop names instead. The two combine as deny-wins. The model and
143
+ `host.mcp` only see what remains. A model-visible filter requires
144
+ `advertiseTools: true`.
145
+
146
+ ```ts
147
+ export default defineConnection({
148
+ url: "https://mcp.example.com/inventory",
149
+ advertiseTools: true,
150
+ tools: ["search_skus", "get_stock"],
151
+ });
152
+ ```
153
+
154
+ ```ts
155
+ export default defineConnection({
156
+ url: "https://mcp.example.com/inventory",
157
+ advertiseTools: true,
158
+ disallowedTools: ["place_order", "delete_sku"],
159
+ });
160
+ ```
161
+
162
+ Names are the server's `tools/list` names. Unknown names are omitted. A
163
+ filter that matches nothing on the server fails the turn unless
164
+ `optional: true`. Combine with `effects: "read"` to keep only the listed
165
+ tools the server classifies as reads.
166
+
167
+ A list of names is an allowlist. An object of handlers authors TypeScript
168
+ tools. On `host-connections/`, a name list restricts `host.mcp` without
169
+ advertising.
170
+
171
+ ## Local stdio MCP server
172
+
173
+ Run a local MCP server as a child process with `command`.
174
+
175
+ ```ts
176
+ export default defineConnection({
177
+ command: "node",
178
+ args: ["--import", "tsx", "mcp/units-server.ts"],
179
+ // env, cwd
180
+ });
181
+ ```
182
+
183
+ This suits small purpose-built servers, like a `units` converter
184
+ shipped next to the agent.
185
+
186
+ To run TypeScript in the agent environment, author the tools on the
187
+ connection instead. BDK packages authored tools as stdio MCP, so you
188
+ write only `execute`.
189
+
190
+ ```ts
191
+ export default defineConnection({
192
+ tools: {
193
+ probe_agent_tool: {
194
+ description: "Prove the tool ran in the agent environment.",
195
+ async execute({ label }) {
196
+ return { ok: true, label };
197
+ },
198
+ },
199
+ },
200
+ });
201
+ ```
202
+
203
+ ## Cursor account MCP connection
204
+
205
+ `{ cursorAccount: true }` forwards the MCP connectors the signed-in
206
+ Cursor account already authorized (dashboard → MCP), such as Linear,
207
+ Notion, and Slack. You don't configure tokens. Every tool runs on the
208
+ Cursor backend with the account's stored OAuth credentials, so raw
209
+ tokens never reach the serving host, session workspaces, or traces.
210
+
211
+ By default the agent gets every connected HTTP/SSE connector on the
212
+ account. Pass `servers: "*"` (or `["*"]`) for the same all-connectors
213
+ behavior in an explicit form. Pass a name list when you want a smaller
214
+ set.
215
+
216
+ ```ts
217
+ // bot/mcp-connections/account.ts: every connected connector
218
+ export default defineConnection({
219
+ cursorAccount: true,
220
+ advertiseTools: true,
221
+ });
222
+ ```
223
+
224
+ ```ts
225
+ // only Linear:
226
+ export default defineConnection({
227
+ cursorAccount: true,
228
+ servers: ["Linear"],
229
+ advertiseTools: true,
230
+ });
231
+ ```
232
+
233
+ Name the file `account.ts`. `cursor.ts` collides with the IDE `cursor`
234
+ MCP namespace. `advertiseTools: true` puts connector tools on local
235
+ turns by name.
236
+
237
+ The host must be signed in (`bdk login`, `CURSOR_API_KEY`, or
238
+ `CURSOR_SERVICE_ACCOUNT_KEY`). `serve` fails at startup otherwise.
239
+
240
+ Use a `{ command }` connection for stdio servers.
241
+
242
+ > [!CAUTION]
243
+ > Whoever can talk to the agent can drive these connectors, because they
244
+ > are ordinary agent tools. `serve` refuses to start when
245
+ > `--allow-anonymous` is combined with account MCP connections unless you
246
+ > also pass `--allow-anonymous-cursor-account-mcp` (trusted boundary only;
247
+ > for example an SSO proxy or the hosted alias token). Prefer
248
+ > `--bearer-token` on shared hosts.
249
+
250
+ ## Peer MCP connection {#peer-mcp-connection}
251
+
252
+ `{ agent: "<slug>" }` addresses another agent without configuring a URL,
253
+ headers, or secrets. On a local multi-agent serve, the target is another
254
+ mount slug. On Cursor-managed hosting, it is the lowercase deployment slug
255
+ of another agent on the same team.
256
+
257
+ On a local multi-agent serve, the model gets the peer's `ask` and `check`
258
+ tools, plus `call_tool` when the peer has server tools, and can delegate work
259
+ to it:
260
+
261
+ ```ts
262
+ export default defineConnection({
263
+ agent: "weather-agent",
264
+ description: "Delegate weather questions to the weather agent.",
265
+ });
266
+ ```
267
+
268
+ Declare the connection only on the caller. The specialist needs no matching
269
+ configuration.
270
+
271
+ In a local multi-agent serve, unknown slugs and self-references fail at
272
+ startup. A single-agent serve omits peers with a warning unless its hosting
273
+ platform sets `--peers-url`. Walkthrough:
274
+ [Peer agents](/docs/guides/agent-to-agent.md#delegate-a-question-to-a-specialist).
275
+
276
+ ## Call MCP from host code
277
+
278
+ A file under `bot/mcp-connections/` is available to the Cursor agent,
279
+ to server tools through `ctx.host.mcp`, and to channel and schedule
280
+ handlers through `args.host.mcp`. Host connections skip the model.
281
+
282
+ ```ts
283
+ // bot/tools/search_linear.ts
284
+ import { defineTool } from "@cursor/bdk/tools";
285
+ import { z } from "zod";
286
+
287
+ export default defineTool({
288
+ description: "Search Linear issues.",
289
+ inputSchema: z.object({ query: z.string() }),
290
+ async execute({ query }, ctx) {
291
+ return ctx.host.mcp.callTool("linear", "list_issues", { query });
292
+ },
293
+ });
294
+ ```
295
+
296
+ `host.mcp.names()` lists connection names.
297
+ `listTools(name)` / `callTool(name, tool, args)` call into a named
298
+ connection.
299
+
300
+ ## Related
301
+
302
+ - [Host MCP OAuth](/docs/guides/mcp-oauth.md): `mcp oauth`, Connect, and
303
+ hosted agents
304
+ - [Tools](/docs/reference/tools.md): authored tools that wrap MCP connections
305
+ - [Webhooks](/docs/guides/webhooks.md): calling MCP connections from handlers
306
+ - [Peer agents](/docs/guides/agent-to-agent.md): when a specialist is its
307
+ own agent
@@ -0,0 +1,115 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en-US" dir="ltr">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width,initial-scale=1">
6
+ <title>Evals | Bot Development Kit (BDK)</title>
7
+ <meta name="description" content="Define eval cases, drive turns, assert trajectories, and interpret results.">
8
+ <meta name="generator" content="VitePress v1.6.4">
9
+ <link rel="preload stylesheet" href="/docs/assets/style.B9o0luvp.css" as="style">
10
+ <link rel="preload stylesheet" href="/docs/vp-icons.css" as="style">
11
+
12
+ <script type="module" src="/docs/assets/app.wA5xBBcd.js"></script>
13
+ <link rel="preload" href="/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
+ <link rel="modulepreload" href="/docs/assets/chunks/framework.BNw1pucY.js">
15
+ <link rel="modulepreload" href="/docs/assets/chunks/theme.DvfKzyXq.js">
16
+ <link rel="modulepreload" href="/docs/assets/chunks/katex.DkKDou_j.js">
17
+ <link rel="modulepreload" href="/docs/assets/chunks/dagre-KV5264BT.BBXxGEaD.js">
18
+ <link rel="modulepreload" href="/docs/assets/chunks/cose-bilkent-S5V4N54A.DGpAcJ55.js">
19
+ <link rel="modulepreload" href="/docs/assets/chunks/c4Diagram-AHTNJAMY.DfkDHeB9.js">
20
+ <link rel="modulepreload" href="/docs/assets/chunks/flowDiagram-DWJPFMVM.M81hXIXZ.js">
21
+ <link rel="modulepreload" href="/docs/assets/chunks/erDiagram-SMLLAGMA.B3bTCW_e.js">
22
+ <link rel="modulepreload" href="/docs/assets/chunks/gitGraphDiagram-UUTBAWPF.CLEMZgO3.js">
23
+ <link rel="modulepreload" href="/docs/assets/chunks/ganttDiagram-T4ZO3ILL.BKg7WY--.js">
24
+ <link rel="modulepreload" href="/docs/assets/chunks/infoDiagram-42DDH7IO.BTiWTi82.js">
25
+ <link rel="modulepreload" href="/docs/assets/chunks/pieDiagram-DEJITSTG.Cba8e8lS.js">
26
+ <link rel="modulepreload" href="/docs/assets/chunks/quadrantDiagram-34T5L4WZ.2YjBycHF.js">
27
+ <link rel="modulepreload" href="/docs/assets/chunks/xychartDiagram-5P7HB3ND.DnKSGQE1.js">
28
+ <link rel="modulepreload" href="/docs/assets/chunks/requirementDiagram-MS252O5E.D4P5RqVI.js">
29
+ <link rel="modulepreload" href="/docs/assets/chunks/sequenceDiagram-FGHM5R23.BZm7EaoT.js">
30
+ <link rel="modulepreload" href="/docs/assets/chunks/classDiagram-6PBFFD2Q.DqByliAC.js">
31
+ <link rel="modulepreload" href="/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DqByliAC.js">
32
+ <link rel="modulepreload" href="/docs/assets/chunks/stateDiagram-FHFEXIEX.DcR4f3X2.js">
33
+ <link rel="modulepreload" href="/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.Bb4oMe0P.js">
34
+ <link rel="modulepreload" href="/docs/assets/chunks/journeyDiagram-VCZTEJTY.0lQNZ40U.js">
35
+ <link rel="modulepreload" href="/docs/assets/chunks/timeline-definition-GMOUNBTQ.CgDh96vg.js">
36
+ <link rel="modulepreload" href="/docs/assets/chunks/mindmap-definition-QFDTVHPH.B56nGoB_.js">
37
+ <link rel="modulepreload" href="/docs/assets/chunks/kanban-definition-6JOO6SKY.L5sKlf7X.js">
38
+ <link rel="modulepreload" href="/docs/assets/chunks/sankeyDiagram-XADWPNL6.C0Hn8NUm.js">
39
+ <link rel="modulepreload" href="/docs/assets/chunks/diagram-TYMM5635.YIsbRH20.js">
40
+ <link rel="modulepreload" href="/docs/assets/chunks/diagram-MMDJMWI5.aHh4WGg9.js">
41
+ <link rel="modulepreload" href="/docs/assets/chunks/blockDiagram-DXYQGD6D.BrXMZRtK.js">
42
+ <link rel="modulepreload" href="/docs/assets/chunks/diagram-5BDNPKRD.EKqOwmK2.js">
43
+ <link rel="modulepreload" href="/docs/assets/chunks/architectureDiagram-Q4EWVU46.MfG0itQh.js">
44
+ <link rel="modulepreload" href="/docs/assets/chunks/ishikawaDiagram-UXIWVN3A.DcqY_KQL.js">
45
+ <link rel="modulepreload" href="/docs/assets/chunks/vennDiagram-DHZGUBPP.B4fagbC8.js">
46
+ <link rel="modulepreload" href="/docs/assets/chunks/diagram-G4DWMVQ6.CB8pdkoZ.js">
47
+ <link rel="modulepreload" href="/docs/assets/chunks/wardleyDiagram-NUSXRM2D.DBUg0bvz.js">
48
+ <link rel="modulepreload" href="/docs/assets/chunks/virtual_mermaid-config.DDnGl6nM.js">
49
+ <link rel="modulepreload" href="/docs/assets/reference_evals.md.Ccwp4x3o.lean.js">
50
+ <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
51
+ <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
52
+ <link rel="alternate" type="text/plain" href="/docs/llms.txt">
53
+ <link rel="alternate" type="text/markdown" href="/docs/reference/evals.md">
54
+ </head>
55
+ <body>
56
+ <div id="app"><div class="Layout" data-v-738a160a><!--[--><!--]--><!--[--><span tabindex="-1" data-v-a98c2453></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-a98c2453>Skip to content</a><!--]--><!----><header class="VPNav" data-v-738a160a data-v-76ad4059><div class="VPNavBar" data-v-76ad4059 data-v-6fc2afcb><div class="wrapper" data-v-6fc2afcb><div class="container" data-v-6fc2afcb><div class="title" data-v-6fc2afcb><div class="VPNavBarTitle has-sidebar" data-v-6fc2afcb data-v-9e6caa3f><a class="title" href="/docs/" data-v-9e6caa3f><!--[--><!--]--><!----><span data-v-9e6caa3f>Bot Development Kit (BDK)</span><!--[--><!--[--><!--[--><!--[--><span class="bdk-version" title="BDK 0.2.27 (@cursor/bdk package)" data-v-d89e5038>0.2.27</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-6fc2afcb><div class="content-body" data-v-6fc2afcb><!--[--><!--]--><div class="VPNavBarSearch search" data-v-6fc2afcb><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-6fc2afcb data-v-78f72f99><span id="main-nav-aria-label" class="visually-hidden" data-v-78f72f99> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/quickstart.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Quickstart</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/guides/mcp-oauth.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Guides</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/guides/github.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Integrations</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/templates/security-reviewer.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Templates</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/reference/project-layout.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Reference</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-6fc2afcb data-v-bf7c3d0f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-bf7c3d0f data-v-e9e166e4 data-v-74f7b0ff><span class="check" data-v-74f7b0ff><span class="icon" data-v-74f7b0ff><!--[--><span class="vpi-sun sun" data-v-e9e166e4></span><span class="vpi-moon moon" data-v-e9e166e4></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-6fc2afcb data-v-799c9281 data-v-070c9767><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-070c9767><span class="vpi-more-horizontal icon" data-v-070c9767></span></button><div class="menu" data-v-070c9767><div class="VPMenu" data-v-070c9767 data-v-c05d27ee><!----><!--[--><!--[--><!----><div class="group" data-v-799c9281><div class="item appearance" data-v-799c9281><p class="label" data-v-799c9281>Appearance</p><div class="appearance-action" data-v-799c9281><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-799c9281 data-v-e9e166e4 data-v-74f7b0ff><span class="check" data-v-74f7b0ff><span class="icon" data-v-74f7b0ff><!--[--><span class="vpi-sun sun" data-v-e9e166e4></span><span class="vpi-moon moon" data-v-e9e166e4></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-6fc2afcb data-v-2caaf84e><span class="container" data-v-2caaf84e><span class="top" data-v-2caaf84e></span><span class="middle" data-v-2caaf84e></span><span class="bottom" data-v-2caaf84e></span></span></button></div></div></div></div><div class="divider" data-v-6fc2afcb><div class="divider-line" data-v-6fc2afcb></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-738a160a data-v-e0cbfd80><div class="container" data-v-e0cbfd80><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-e0cbfd80><span class="vpi-align-left menu-icon" data-v-e0cbfd80></span><span class="menu-text" data-v-e0cbfd80>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-e0cbfd80 data-v-36e0b8e9><button data-v-36e0b8e9>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-738a160a data-v-2859715e><div class="curtain" data-v-2859715e></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-2859715e><span class="visually-hidden" id="sidebar-aria-label" data-v-2859715e> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Getting started</h2><!----></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/changelog.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Changelog</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/quickstart.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Building your first agent</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Integrations</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/github.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>GitHub</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/slack.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Slack</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/webhooks.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Webhooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/convert-automation.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Cursor Automations</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/opentelemetry.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>OpenTelemetry</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/gitlab.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>GitLab</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/bitbucket.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Bitbucket</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/pagerduty.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>PagerDuty</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Extensions</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/extensions.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/cloud-agents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Cloud agents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/grokbot-agents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Grok Bot agents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/improve.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Self-improvement</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/jev.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Jev</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Guides</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/mcp-oauth.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>MCP</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/hooks.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Hooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/agent-to-agent.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Peer agents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/deployment.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Deployment</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/export-grokbot.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Export a Grok Bot</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/migrate.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Early-alpha migration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/evals.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Evals</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/hillclimbing.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Hillclimbing</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/building-with-agents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Build with a coding agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/troubleshooting.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Troubleshooting</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Templates</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/grokbot-agents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Grok Bot agents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/security-reviewer.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Security reviewer</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/thermo-review.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Thermo review</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/thermo-quality-review.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Thermo quality review</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/agentic-owners.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Agentic Approver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/triage.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Triage agent</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible has-active" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Reference</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/project-layout.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Project layout</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/agent-config.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Agent config</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/instructions.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Instructions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/tools.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Tools</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/prompt.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/skills.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Skills</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/connections.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>MCP Connections</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/subagents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Subagents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/channels.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Channels</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/schedules.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Schedules & reminders</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/hooks.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Hooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/memory.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Memory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/evals.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Evals</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/artifacts.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Artifacts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/sessions.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Sessions & streaming</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/playground.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Playground</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/cli.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>CLI</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/http-api.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>HTTP API</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-738a160a data-v-9f462cdf><div class="VPDoc has-sidebar has-aside" data-v-9f462cdf data-v-995f90b4><!--[--><!--]--><div class="container" data-v-995f90b4><div class="aside" data-v-995f90b4><div class="aside-curtain" data-v-995f90b4></div><div class="aside-container" data-v-995f90b4><div class="aside-content" data-v-995f90b4><div class="VPDocAside" data-v-995f90b4 data-v-10889960><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-10889960 data-v-afb61a88><div class="content" data-v-afb61a88><div class="outline-marker" data-v-afb61a88></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-afb61a88>On this page</div><ul class="VPDocOutlineItem root" data-v-afb61a88 data-v-0587367d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-10889960></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-995f90b4><div class="content-container" data-v-995f90b4><!--[--><!--]--><main class="main" data-v-995f90b4><div style="position:relative;" class="vp-doc _docs_reference_evals" data-v-995f90b4><div><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>
57
+ <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>
58
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> cases: [</span></span>
59
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
60
+ <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>
61
+ <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>
62
+ <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>
63
+ <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>
64
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</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>
67
+ <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>
68
+ <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>
69
+ <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>
70
+ <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>
71
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
72
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
73
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ],</span></span>
74
+ <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>
75
+ <span class="line"></span>
76
+ <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>
77
+ <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>
78
+ <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>
79
+ <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>
80
+ <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>
81
+ <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>
82
+ <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>
83
+ <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>
84
+ <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>
85
+ <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>
86
+ <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>
87
+ <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>
88
+ <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>
89
+ <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>
90
+ <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>
91
+ <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>
92
+ <span class="line"></span>
93
+ <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>
94
+ <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>
95
+ <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>
96
+ <span class="line"></span>
97
+ <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>
98
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineEval</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
99
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> description: row.task,</span></span>
100
+ <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>
101
+ <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>
102
+ <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>
103
+ <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>
104
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
105
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })</span></span>
106
+ <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>
107
+ <span class="line"><span>bdk eval --dir .</span></span>
108
+ <span class="line"><span>bdk eval --dir . builds/checkout</span></span>
109
+ <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>
110
+ <span class="line"><span>bdk eval status &lt;eval-id&gt; --url http://127.0.0.1:3000/vulnerability-scanner</span></span>
111
+ <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></div></div></main><footer class="VPDocFooter" data-v-995f90b4 data-v-8edf72db><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-8edf72db><span class="visually-hidden" id="doc-footer-aria-label" data-v-8edf72db>Pager</span><div class="pager" data-v-8edf72db><a class="VPLink link pager-link prev" href="/docs/reference/memory.html" data-v-8edf72db><!--[--><span class="desc" data-v-8edf72db>Previous page</span><span class="title" data-v-8edf72db>Memory</span><!--]--></a></div><div class="pager" data-v-8edf72db><a class="VPLink link pager-link next" href="/docs/reference/artifacts.html" data-v-8edf72db><!--[--><span class="desc" data-v-8edf72db>Next page</span><span class="title" data-v-8edf72db>Artifacts</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
112
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"building-with-agents.md\":\"FZXrY8Nk\",\"changelog.md\":\"BvHRIiMH\",\"deployment.md\":\"3MMWuPeV\",\"evals.md\":\"CHR34K1Y\",\"guides_agent-to-agent.md\":\"CwL5cwuE\",\"guides_bitbucket.md\":\"CKUayYtD\",\"guides_cloud-agents.md\":\"BzbzcOyj\",\"guides_convert-automation.md\":\"DMEX9nF-\",\"guides_export-grokbot.md\":\"qo5bxi4h\",\"guides_github.md\":\"TuNiZAOQ\",\"guides_gitlab.md\":\"CtNI4fSH\",\"guides_grokbot-agents.md\":\"BwAykJ7U\",\"guides_hooks.md\":\"B2XfGX50\",\"guides_improve.md\":\"CZKVt1cT\",\"guides_jev.md\":\"D7XH4JH3\",\"guides_mcp-oauth.md\":\"Cxq2TxBB\",\"guides_migrate.md\":\"CQlGaBKX\",\"guides_opentelemetry.md\":\"D4wO7_8v\",\"guides_pagerduty.md\":\"BHXMcMtx\",\"guides_slack.md\":\"ClIyi7FI\",\"guides_webhooks.md\":\"Cpdc3BDX\",\"hillclimbing.md\":\"Dxvd-0gT\",\"index.md\":\"CAnsLl8D\",\"quickstart.md\":\"D8JDfkKO\",\"reference_agent-config.md\":\"CZrbHOfT\",\"reference_artifacts.md\":\"DLV9MZES\",\"reference_channels.md\":\"CNNIS6K7\",\"reference_cli.md\":\"1o_TqKdt\",\"reference_connections.md\":\"BJE2Zllp\",\"reference_evals.md\":\"Ccwp4x3o\",\"reference_extensions.md\":\"DKxTuCIw\",\"reference_hooks.md\":\"CROr0QgC\",\"reference_http-api.md\":\"Dji-DD_Z\",\"reference_instructions.md\":\"BYMVxAkw\",\"reference_memory.md\":\"BwyJXYZe\",\"reference_playground.md\":\"q4MI-0td\",\"reference_project-layout.md\":\"mFcS8yDD\",\"reference_prompt.md\":\"DqPh71XN\",\"reference_schedules.md\":\"BqWnJES4\",\"reference_sessions.md\":\"Bi6lHttM\",\"reference_skills.md\":\"Ckddg6KX\",\"reference_subagents.md\":\"ChNGh6HK\",\"reference_tools.md\":\"Bo0UfT0a\",\"templates_agentic-owners.md\":\"CTEnR0jp\",\"templates_grokbot-agents.md\":\"DgpPEs7B\",\"templates_security-reviewer.md\":\"Gh6EF9Us\",\"templates_thermo-quality-review.md\":\"B77UyTrX\",\"templates_thermo-review.md\":\"DRJ7mC5U\",\"templates_triage.md\":\"CNN6b0JZ\",\"troubleshooting.md\":\"DFnoTDlQ\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Bot Development Kit (BDK)\",\"description\":\"Build and serve bots and agents from versioned Markdown and TypeScript.\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"sdkVersion\":\"0.2.27\",\"nav\":[{\"text\":\"Quickstart\",\"link\":\"/quickstart\"},{\"text\":\"Guides\",\"link\":\"/guides/mcp-oauth\"},{\"text\":\"Integrations\",\"link\":\"/guides/github\"},{\"text\":\"Templates\",\"link\":\"/templates/security-reviewer\"},{\"text\":\"Reference\",\"link\":\"/reference/project-layout\"}],\"search\":{\"provider\":\"local\"},\"outline\":{\"level\":[2,3]},\"sidebar\":[{\"text\":\"Getting started\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"Changelog\",\"link\":\"/changelog\"},{\"text\":\"Building your first agent\",\"link\":\"/quickstart\"}]},{\"text\":\"Integrations\",\"collapsed\":false,\"items\":[{\"text\":\"GitHub\",\"link\":\"/guides/github\"},{\"text\":\"Slack\",\"link\":\"/guides/slack\"},{\"text\":\"Webhooks\",\"link\":\"/guides/webhooks\"},{\"text\":\"Cursor Automations\",\"link\":\"/guides/convert-automation\"},{\"text\":\"OpenTelemetry\",\"link\":\"/guides/opentelemetry\"},{\"text\":\"GitLab\",\"link\":\"/guides/gitlab\"},{\"text\":\"Bitbucket\",\"link\":\"/guides/bitbucket\"},{\"text\":\"PagerDuty\",\"link\":\"/guides/pagerduty\"}]},{\"text\":\"Extensions\",\"collapsed\":false,\"items\":[{\"text\":\"Overview\",\"link\":\"/reference/extensions\"},{\"text\":\"Cloud agents\",\"link\":\"/guides/cloud-agents\"},{\"text\":\"Grok Bot agents\",\"link\":\"/guides/grokbot-agents\"},{\"text\":\"Self-improvement\",\"link\":\"/guides/improve\"},{\"text\":\"Jev\",\"link\":\"/guides/jev\"}]},{\"text\":\"Guides\",\"collapsed\":false,\"items\":[{\"text\":\"MCP\",\"link\":\"/guides/mcp-oauth\"},{\"text\":\"Hooks\",\"link\":\"/guides/hooks\"},{\"text\":\"Peer agents\",\"link\":\"/guides/agent-to-agent\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"},{\"text\":\"Export a Grok Bot\",\"link\":\"/guides/export-grokbot\"},{\"text\":\"Early-alpha migration\",\"link\":\"/guides/migrate\"},{\"text\":\"Evals\",\"link\":\"/evals\"},{\"text\":\"Hillclimbing\",\"link\":\"/hillclimbing\"},{\"text\":\"Build with a coding agent\",\"link\":\"/building-with-agents\"},{\"text\":\"Troubleshooting\",\"link\":\"/troubleshooting\"}]},{\"text\":\"Templates\",\"collapsed\":false,\"items\":[{\"text\":\"Grok Bot agents\",\"link\":\"/templates/grokbot-agents\"},{\"text\":\"Security reviewer\",\"link\":\"/templates/security-reviewer\"},{\"text\":\"Thermo review\",\"link\":\"/templates/thermo-review\"},{\"text\":\"Thermo quality review\",\"link\":\"/templates/thermo-quality-review\"},{\"text\":\"Agentic Approver\",\"link\":\"/templates/agentic-owners\"},{\"text\":\"Triage agent\",\"link\":\"/templates/triage\"}]},{\"text\":\"Reference\",\"collapsed\":false,\"items\":[{\"text\":\"Project layout\",\"link\":\"/reference/project-layout\"},{\"text\":\"Agent config\",\"link\":\"/reference/agent-config\"},{\"text\":\"Instructions\",\"link\":\"/reference/instructions\"},{\"text\":\"Tools\",\"link\":\"/reference/tools\"},{\"text\":\"prompt\",\"link\":\"/reference/prompt\"},{\"text\":\"Skills\",\"link\":\"/reference/skills\"},{\"text\":\"MCP Connections\",\"link\":\"/reference/connections\"},{\"text\":\"Subagents\",\"link\":\"/reference/subagents\"},{\"text\":\"Channels\",\"link\":\"/reference/channels\"},{\"text\":\"Schedules & reminders\",\"link\":\"/reference/schedules\"},{\"text\":\"Hooks\",\"link\":\"/reference/hooks\"},{\"text\":\"Memory\",\"link\":\"/reference/memory\"},{\"text\":\"Evals\",\"link\":\"/reference/evals\"},{\"text\":\"Artifacts\",\"link\":\"/reference/artifacts\"},{\"text\":\"Sessions & streaming\",\"link\":\"/reference/sessions\"},{\"text\":\"Playground\",\"link\":\"/reference/playground\"},{\"text\":\"CLI\",\"link\":\"/reference/cli\"},{\"text\":\"HTTP API\",\"link\":\"/reference/http-api\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
113
+
114
+ </body>
115
+ </html>