@grok/agent-sdk 0.6.0 → 0.7.0

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 (521) hide show
  1. package/AGENTS.md +40 -0
  2. package/dist/channels/github/forward.d.ts +5 -0
  3. package/dist/channels/github/forward.d.ts.map +1 -1
  4. package/dist/channels/github/forward.js +6 -3
  5. package/dist/channels/slack/api.d.ts +18 -0
  6. package/dist/channels/slack/api.d.ts.map +1 -1
  7. package/dist/channels/slack/api.js +31 -0
  8. package/dist/channels/slack/approvals.d.ts +19 -2
  9. package/dist/channels/slack/approvals.d.ts.map +1 -1
  10. package/dist/channels/slack/approvals.js +90 -19
  11. package/dist/channels/slack/attachments.d.ts +7 -2
  12. package/dist/channels/slack/attachments.d.ts.map +1 -1
  13. package/dist/channels/slack/attachments.js +318 -156
  14. package/dist/channels/slack/connect-card.d.ts +16 -0
  15. package/dist/channels/slack/connect-card.d.ts.map +1 -0
  16. package/dist/channels/slack/connect-card.js +31 -0
  17. package/dist/channels/slack/credentials.d.ts +10 -2
  18. package/dist/channels/slack/credentials.d.ts.map +1 -1
  19. package/dist/channels/slack/credentials.js +17 -15
  20. package/dist/channels/slack/defaults.d.ts.map +1 -1
  21. package/dist/channels/slack/defaults.js +18 -9
  22. package/dist/channels/slack/dispatch.d.ts +1 -1
  23. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  24. package/dist/channels/slack/dispatch.js +19 -3
  25. package/dist/channels/slack/inbound.d.ts +8 -2
  26. package/dist/channels/slack/inbound.d.ts.map +1 -1
  27. package/dist/channels/slack/inbound.js +25 -4
  28. package/dist/channels/slack/index.d.ts +3 -2
  29. package/dist/channels/slack/index.d.ts.map +1 -1
  30. package/dist/channels/slack/index.js +3 -2
  31. package/dist/channels/slack/init.d.ts.map +1 -1
  32. package/dist/channels/slack/init.js +2 -1
  33. package/dist/channels/slack/mentions.d.ts +28 -0
  34. package/dist/channels/slack/mentions.d.ts.map +1 -0
  35. package/dist/channels/slack/mentions.js +178 -0
  36. package/dist/channels/slack/setup.js +1 -1
  37. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  38. package/dist/channels/slack/slack-channel.js +46 -3
  39. package/dist/channels/slack/stop.d.ts.map +1 -1
  40. package/dist/channels/slack/stop.js +7 -1
  41. package/dist/channels/slack/thread-context.d.ts +3 -0
  42. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  43. package/dist/channels/slack/thread-context.js +17 -7
  44. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
  45. package/dist/channels/slack/tool-approval-events.js +55 -2
  46. package/dist/channels/slack/types.d.ts +2 -0
  47. package/dist/channels/slack/types.d.ts.map +1 -1
  48. package/dist/channels/teams/activity.d.ts +33 -0
  49. package/dist/channels/teams/activity.d.ts.map +1 -0
  50. package/dist/channels/teams/activity.js +213 -0
  51. package/dist/channels/teams/auth.d.ts +25 -0
  52. package/dist/channels/teams/auth.d.ts.map +1 -0
  53. package/dist/channels/teams/auth.js +55 -0
  54. package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
  55. package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
  56. package/dist/channels/teams/bot-framework-auth.js +154 -0
  57. package/dist/channels/teams/cards.d.ts +23 -0
  58. package/dist/channels/teams/cards.d.ts.map +1 -0
  59. package/dist/channels/teams/cards.js +107 -0
  60. package/dist/channels/teams/connector.d.ts +48 -0
  61. package/dist/channels/teams/connector.d.ts.map +1 -0
  62. package/dist/channels/teams/connector.js +159 -0
  63. package/dist/channels/teams/credentials.d.ts +65 -0
  64. package/dist/channels/teams/credentials.d.ts.map +1 -0
  65. package/dist/channels/teams/credentials.js +84 -0
  66. package/dist/channels/teams/delivery.d.ts +14 -0
  67. package/dist/channels/teams/delivery.d.ts.map +1 -0
  68. package/dist/channels/teams/delivery.js +169 -0
  69. package/dist/channels/teams/dispatch.d.ts +45 -0
  70. package/dist/channels/teams/dispatch.d.ts.map +1 -0
  71. package/dist/channels/teams/dispatch.js +402 -0
  72. package/dist/channels/teams/engagement.d.ts +32 -0
  73. package/dist/channels/teams/engagement.d.ts.map +1 -0
  74. package/dist/channels/teams/engagement.js +120 -0
  75. package/dist/channels/teams/index.d.ts +21 -0
  76. package/dist/channels/teams/index.d.ts.map +1 -0
  77. package/dist/channels/teams/index.js +19 -0
  78. package/dist/channels/teams/marks.d.ts +19 -0
  79. package/dist/channels/teams/marks.d.ts.map +1 -0
  80. package/dist/channels/teams/marks.js +96 -0
  81. package/dist/channels/teams/senders.d.ts +27 -0
  82. package/dist/channels/teams/senders.d.ts.map +1 -0
  83. package/dist/channels/teams/senders.js +72 -0
  84. package/dist/channels/teams/teams-channel.d.ts +43 -0
  85. package/dist/channels/teams/teams-channel.d.ts.map +1 -0
  86. package/dist/channels/teams/teams-channel.js +278 -0
  87. package/dist/channels/teams/text.d.ts +7 -0
  88. package/dist/channels/teams/text.d.ts.map +1 -0
  89. package/dist/channels/teams/text.js +63 -0
  90. package/dist/channels/teams/types.d.ts +306 -0
  91. package/dist/channels/teams/types.d.ts.map +1 -0
  92. package/dist/channels/teams/types.js +1 -0
  93. package/dist/channels.d.ts +31 -0
  94. package/dist/channels.d.ts.map +1 -1
  95. package/dist/channels.js +37 -0
  96. package/dist/connections.d.ts +1 -1
  97. package/dist/connections.d.ts.map +1 -1
  98. package/dist/docs/404.html +3 -3
  99. package/dist/docs/assets/{app.lt-BYgI2.js → app.Ch-048af.js} +4 -4
  100. package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
  101. package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.SoN0MK7o.lean.js} +1 -1
  102. package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +1 -0
  103. package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
  104. package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BIzu7OVF.js} +1 -1
  105. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
  106. package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.B4y6Y5eG.js} +1 -1
  107. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
  108. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
  109. package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
  110. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
  111. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
  112. package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
  113. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
  114. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
  115. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
  116. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
  117. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.CwrYtDVo.js} +1 -1
  118. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +1 -0
  119. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +1 -0
  120. package/dist/docs/assets/chunks/clone.F824-PNx.js +1 -0
  121. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
  122. package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
  123. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
  124. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
  125. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
  126. package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
  127. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
  128. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
  129. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
  130. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
  131. package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.CdOyJvsX.js} +1 -1
  132. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
  133. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
  134. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
  135. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
  136. package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DDwvoQlY.js} +1 -1
  137. package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.BRXPDWj3.js} +1 -1
  138. package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.3YwC0t3o.js} +1 -1
  139. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
  140. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
  141. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
  142. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
  143. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
  144. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
  145. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.B_SGgvgs.js} +1 -1
  146. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +1 -0
  147. package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.bNyH5NPA.js} +2 -2
  148. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
  149. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
  150. package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DQqE3WF8.js} +1 -1
  151. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
  152. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.DnJA2aXp.js} +1 -1
  153. package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.N9S5KC5R.js} +2 -2
  154. package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.N9S5KC5R.lean.js} +1 -1
  155. package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
  156. package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
  157. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
  158. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
  159. package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
  160. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
  161. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
  162. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
  163. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
  164. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  165. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
  166. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
  167. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
  168. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
  169. package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
  170. package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
  171. package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
  172. package/dist/docs/building-with-agents.html +37 -37
  173. package/dist/docs/changelog.html +37 -37
  174. package/dist/docs/changelog.md +35 -0
  175. package/dist/docs/deployment.html +39 -39
  176. package/dist/docs/deployment.md +10 -0
  177. package/dist/docs/evals.html +37 -37
  178. package/dist/docs/guides/agent-to-agent.html +37 -37
  179. package/dist/docs/guides/bitbucket.html +37 -37
  180. package/dist/docs/guides/cloud-agents.html +43 -38
  181. package/dist/docs/guides/cloud-agents.md +47 -0
  182. package/dist/docs/guides/convert-automation.html +37 -37
  183. package/dist/docs/guides/github.html +37 -37
  184. package/dist/docs/guides/gitlab.html +37 -37
  185. package/dist/docs/guides/improve.html +37 -37
  186. package/dist/docs/guides/jev.html +37 -37
  187. package/dist/docs/guides/mcp-oauth.html +37 -37
  188. package/dist/docs/guides/migrate.html +37 -37
  189. package/dist/docs/guides/opentelemetry.html +37 -37
  190. package/dist/docs/guides/pagerduty.html +37 -37
  191. package/dist/docs/guides/slack.html +37 -37
  192. package/dist/docs/guides/teams.html +109 -0
  193. package/dist/docs/guides/teams.md +384 -0
  194. package/dist/docs/guides/webhooks.html +37 -37
  195. package/dist/docs/hashmap.json +1 -1
  196. package/dist/docs/hillclimbing.html +37 -37
  197. package/dist/docs/index.html +37 -37
  198. package/dist/docs/llms-full.txt +636 -4
  199. package/dist/docs/llms.txt +1 -0
  200. package/dist/docs/quickstart.html +37 -37
  201. package/dist/docs/reference/access.html +36 -36
  202. package/dist/docs/reference/agent-config.html +37 -37
  203. package/dist/docs/reference/artifacts.html +37 -37
  204. package/dist/docs/reference/channels.html +38 -38
  205. package/dist/docs/reference/channels.md +1 -0
  206. package/dist/docs/reference/cli.html +50 -40
  207. package/dist/docs/reference/cli.md +116 -0
  208. package/dist/docs/reference/connections.html +37 -37
  209. package/dist/docs/reference/evals.html +37 -37
  210. package/dist/docs/reference/extensions.html +37 -37
  211. package/dist/docs/reference/hooks.html +37 -37
  212. package/dist/docs/reference/http-api.html +37 -37
  213. package/dist/docs/reference/instructions.html +37 -37
  214. package/dist/docs/reference/limits.html +39 -39
  215. package/dist/docs/reference/limits.md +4 -4
  216. package/dist/docs/reference/memory.html +37 -37
  217. package/dist/docs/reference/playground.html +36 -36
  218. package/dist/docs/reference/project-layout.html +37 -37
  219. package/dist/docs/reference/schedules.html +40 -40
  220. package/dist/docs/reference/sessions.html +38 -38
  221. package/dist/docs/reference/sessions.md +13 -0
  222. package/dist/docs/reference/skills.html +40 -40
  223. package/dist/docs/reference/subagents.html +37 -37
  224. package/dist/docs/reference/tools.html +37 -37
  225. package/dist/docs/templates/agentic-owners.html +37 -37
  226. package/dist/docs/templates/reviews.html +37 -37
  227. package/dist/docs/troubleshooting.html +38 -38
  228. package/dist/docs/troubleshooting.md +21 -0
  229. package/dist/evals/run-facts.d.ts.map +1 -1
  230. package/dist/evals/run-facts.js +4 -0
  231. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
  232. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
  233. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
  234. package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
  235. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  236. package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
  237. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
  238. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
  239. package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
  240. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
  241. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  242. package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
  243. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
  244. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
  245. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
  246. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
  247. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
  248. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
  249. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
  250. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
  251. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
  252. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
  253. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
  254. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
  255. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
  256. package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
  257. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
  258. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
  259. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
  260. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
  261. package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
  262. package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
  263. package/dist/extensions.d.ts.map +1 -1
  264. package/dist/extensions.js +18 -3
  265. package/dist/files-backends/agent-store-presigned-url.js +5 -1
  266. package/dist/index.d.ts +1 -0
  267. package/dist/index.d.ts.map +1 -1
  268. package/dist/index.js +1 -0
  269. package/dist/internal/approval-gate.d.ts +6 -1
  270. package/dist/internal/approval-gate.d.ts.map +1 -1
  271. package/dist/internal/approval-gate.js +13 -2
  272. package/dist/internal/authored-loaders.js +1 -1
  273. package/dist/internal/channel-architecture.d.ts.map +1 -1
  274. package/dist/internal/channel-architecture.js +3 -1
  275. package/dist/internal/cli/commands/channels.d.ts +9 -3
  276. package/dist/internal/cli/commands/channels.d.ts.map +1 -1
  277. package/dist/internal/cli/commands/channels.js +193 -4
  278. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  279. package/dist/internal/cli/commands/index.js +6 -1
  280. package/dist/internal/cli/commands/serve.d.ts.map +1 -1
  281. package/dist/internal/cli/commands/serve.js +25 -5
  282. package/dist/internal/cli/dispatch.d.ts.map +1 -1
  283. package/dist/internal/cli/dispatch.js +22 -8
  284. package/dist/internal/cli/flags.d.ts +14 -0
  285. package/dist/internal/cli/flags.d.ts.map +1 -1
  286. package/dist/internal/cli/flags.js +14 -0
  287. package/dist/internal/cli/help.d.ts.map +1 -1
  288. package/dist/internal/cli/help.js +3 -1
  289. package/dist/internal/cli-cursor.js +2 -2
  290. package/dist/internal/cli-deploy.d.ts +1 -0
  291. package/dist/internal/cli-deploy.d.ts.map +1 -1
  292. package/dist/internal/cli-deploy.js +19 -1
  293. package/dist/internal/cli-mcp.d.ts.map +1 -1
  294. package/dist/internal/cli-mcp.js +5 -3
  295. package/dist/internal/cli-teams-doctor.d.ts +39 -0
  296. package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
  297. package/dist/internal/cli-teams-doctor.js +508 -0
  298. package/dist/internal/cli-teams-forward.d.ts +84 -0
  299. package/dist/internal/cli-teams-forward.d.ts.map +1 -0
  300. package/dist/internal/cli-teams-forward.js +386 -0
  301. package/dist/internal/cli-teams-package.d.ts +26 -0
  302. package/dist/internal/cli-teams-package.d.ts.map +1 -0
  303. package/dist/internal/cli-teams-package.js +123 -0
  304. package/dist/internal/cli-teams.d.ts +15 -0
  305. package/dist/internal/cli-teams.d.ts.map +1 -0
  306. package/dist/internal/cli-teams.js +253 -0
  307. package/dist/internal/connect-click.d.ts +12 -0
  308. package/dist/internal/connect-click.d.ts.map +1 -0
  309. package/dist/internal/connect-click.js +22 -0
  310. package/dist/internal/continuation-channel.d.ts +5 -1
  311. package/dist/internal/continuation-channel.d.ts.map +1 -1
  312. package/dist/internal/continuation-channel.js +34 -0
  313. package/dist/internal/continuation-identity.d.ts +7 -4
  314. package/dist/internal/continuation-identity.d.ts.map +1 -1
  315. package/dist/internal/continuation-identity.js +66 -1
  316. package/dist/internal/convert-automation/convert-workflow.js +2 -2
  317. package/dist/internal/credential-env-names.d.ts +36 -0
  318. package/dist/internal/credential-env-names.d.ts.map +1 -0
  319. package/dist/internal/credential-env-names.js +68 -0
  320. package/dist/internal/cursor/account-mcp.d.ts +67 -9
  321. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  322. package/dist/internal/cursor/account-mcp.js +206 -25
  323. package/dist/internal/cursor/backend-client.d.ts +10 -1
  324. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  325. package/dist/internal/cursor/backend-client.js +19 -7
  326. package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
  327. package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
  328. package/dist/internal/cursor/cloud-agent-identity.js +224 -0
  329. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  330. package/dist/internal/cursor/credentials.js +3 -1
  331. package/dist/internal/cursor-account-mcp-auth.d.ts +1 -0
  332. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  333. package/dist/internal/cursor-account-mcp-auth.js +2 -1
  334. package/dist/internal/deploy-client.d.ts.map +1 -1
  335. package/dist/internal/deploy-client.js +34 -2
  336. package/dist/internal/deploy-manifest.d.ts +51 -3
  337. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  338. package/dist/internal/deploy-manifest.js +96 -7
  339. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  340. package/dist/internal/discovery/agent-config.js +6 -1
  341. package/dist/internal/discovery/connections.d.ts.map +1 -1
  342. package/dist/internal/discovery/connections.js +53 -0
  343. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  344. package/dist/internal/discovery/extensions.js +2 -0
  345. package/dist/internal/discovery/info.d.ts.map +1 -1
  346. package/dist/internal/discovery/info.js +4 -0
  347. package/dist/internal/env-file.d.ts +1 -0
  348. package/dist/internal/env-file.d.ts.map +1 -1
  349. package/dist/internal/env-file.js +18 -17
  350. package/dist/internal/env-prefix.d.ts +11 -0
  351. package/dist/internal/env-prefix.d.ts.map +1 -0
  352. package/dist/internal/env-prefix.js +23 -0
  353. package/dist/internal/event-id-dedupe.d.ts +12 -0
  354. package/dist/internal/event-id-dedupe.d.ts.map +1 -0
  355. package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
  356. package/dist/internal/event-mapper.d.ts +7 -2
  357. package/dist/internal/event-mapper.d.ts.map +1 -1
  358. package/dist/internal/event-mapper.js +7 -0
  359. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  360. package/dist/internal/expected-delivery-failure.js +3 -0
  361. package/dist/internal/extension-namespace.d.ts +9 -0
  362. package/dist/internal/extension-namespace.d.ts.map +1 -0
  363. package/dist/internal/extension-namespace.js +14 -0
  364. package/dist/internal/guid.d.ts +2 -0
  365. package/dist/internal/guid.d.ts.map +1 -0
  366. package/dist/internal/guid.js +4 -0
  367. package/dist/internal/host-kv-cas.d.ts +13 -0
  368. package/dist/internal/host-kv-cas.d.ts.map +1 -0
  369. package/dist/internal/host-kv-cas.js +8 -0
  370. package/dist/internal/host-kv.d.ts +4 -1
  371. package/dist/internal/host-kv.d.ts.map +1 -1
  372. package/dist/internal/host-kv.js +15 -2
  373. package/dist/internal/hosted-catch-protocol.d.ts +5 -0
  374. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  375. package/dist/internal/hosted-catch-protocol.js +5 -0
  376. package/dist/internal/hosted-catch.d.ts +2 -0
  377. package/dist/internal/hosted-catch.d.ts.map +1 -1
  378. package/dist/internal/hosted-catch.js +6 -1
  379. package/dist/internal/hosted-delivery-protocol.d.ts +3 -0
  380. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  381. package/dist/internal/hosted-delivery-protocol.js +69 -1
  382. package/dist/internal/hosted-delivery.d.ts +5 -2
  383. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  384. package/dist/internal/hosted-delivery.js +11 -2
  385. package/dist/internal/hosted-session-fixture.js +1 -1
  386. package/dist/internal/hosting.d.ts +5 -0
  387. package/dist/internal/hosting.d.ts.map +1 -1
  388. package/dist/internal/hosting.js +7 -1
  389. package/dist/internal/install-cursor-skills.d.ts +6 -7
  390. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  391. package/dist/internal/install-cursor-skills.js +15 -9
  392. package/dist/internal/interview/agent-questions.d.ts +1 -1
  393. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  394. package/dist/internal/interview/agent-questions.js +4 -3
  395. package/dist/internal/local-control-plane.d.ts.map +1 -1
  396. package/dist/internal/local-control-plane.js +24 -0
  397. package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
  398. package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
  399. package/dist/internal/mcp-allowlist-in-use.js +93 -0
  400. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  401. package/dist/internal/mcp-endpoint.js +8 -10
  402. package/dist/internal/mcp-host.d.ts +19 -1
  403. package/dist/internal/mcp-host.d.ts.map +1 -1
  404. package/dist/internal/mcp-host.js +67 -3
  405. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  406. package/dist/internal/mcp-oauth.js +5 -7
  407. package/dist/internal/oidcAudiences.d.ts +22 -0
  408. package/dist/internal/oidcAudiences.d.ts.map +1 -0
  409. package/dist/internal/oidcAudiences.js +35 -0
  410. package/dist/internal/otel/collector.d.ts.map +1 -1
  411. package/dist/internal/otel/collector.js +2 -0
  412. package/dist/internal/platform-timers.d.ts +2 -0
  413. package/dist/internal/platform-timers.d.ts.map +1 -1
  414. package/dist/internal/platform-timers.js +14 -0
  415. package/dist/internal/private-file.d.ts +32 -1
  416. package/dist/internal/private-file.d.ts.map +1 -1
  417. package/dist/internal/private-file.js +209 -7
  418. package/dist/internal/redact-values.d.ts +3 -0
  419. package/dist/internal/redact-values.d.ts.map +1 -0
  420. package/dist/internal/redact-values.js +19 -0
  421. package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
  422. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  423. package/dist/internal/reminder-followup-error.d.ts +23 -0
  424. package/dist/internal/reminder-followup-error.d.ts.map +1 -0
  425. package/dist/internal/reminder-followup-error.js +12 -0
  426. package/dist/internal/reminder-runner.d.ts +15 -1
  427. package/dist/internal/reminder-runner.d.ts.map +1 -1
  428. package/dist/internal/reminder-runner.js +95 -21
  429. package/dist/internal/resolved-connections.d.ts.map +1 -1
  430. package/dist/internal/resolved-connections.js +23 -3
  431. package/dist/internal/run-client.js +2 -1
  432. package/dist/internal/run-program.d.ts +31 -0
  433. package/dist/internal/run-program.d.ts.map +1 -0
  434. package/dist/internal/run-program.js +150 -0
  435. package/dist/internal/sdk-runner.d.ts +28 -2
  436. package/dist/internal/sdk-runner.d.ts.map +1 -1
  437. package/dist/internal/sdk-runner.js +298 -38
  438. package/dist/internal/server.d.ts.map +1 -1
  439. package/dist/internal/server.js +45 -4
  440. package/dist/internal/session-credential.d.ts +14 -0
  441. package/dist/internal/session-credential.d.ts.map +1 -0
  442. package/dist/internal/session-credential.js +25 -0
  443. package/dist/internal/session-engine.d.ts +136 -5
  444. package/dist/internal/session-engine.d.ts.map +1 -1
  445. package/dist/internal/session-engine.js +580 -92
  446. package/dist/internal/storage-coordinator.d.ts +3 -1
  447. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  448. package/dist/internal/storage-coordinator.js +13 -0
  449. package/dist/internal/storage-roles.d.ts +9 -1
  450. package/dist/internal/storage-roles.d.ts.map +1 -1
  451. package/dist/internal/teams-channel-profile.d.ts +41 -0
  452. package/dist/internal/teams-channel-profile.d.ts.map +1 -0
  453. package/dist/internal/teams-channel-profile.js +91 -0
  454. package/dist/internal/teams-devtunnel.d.ts +55 -0
  455. package/dist/internal/teams-devtunnel.d.ts.map +1 -0
  456. package/dist/internal/teams-devtunnel.js +205 -0
  457. package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
  458. package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
  459. package/dist/internal/teams-tunnel-proxy.js +100 -0
  460. package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
  461. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
  462. package/dist/internal/testing/conversation-identity-vectors.js +67 -0
  463. package/dist/internal/testing/hosted-http.d.ts +15 -0
  464. package/dist/internal/testing/hosted-http.d.ts.map +1 -0
  465. package/dist/internal/testing/hosted-http.js +86 -0
  466. package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
  467. package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
  468. package/dist/internal/testing/teams-activity-fixtures.js +236 -0
  469. package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
  470. package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
  471. package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
  472. package/dist/internal/tunnel-process.d.ts +29 -0
  473. package/dist/internal/tunnel-process.d.ts.map +1 -0
  474. package/dist/internal/tunnel-process.js +105 -0
  475. package/dist/internal/turn-context.d.ts +28 -0
  476. package/dist/internal/turn-context.d.ts.map +1 -0
  477. package/dist/internal/turn-context.js +1 -0
  478. package/dist/oidc-token.d.ts +127 -0
  479. package/dist/oidc-token.d.ts.map +1 -0
  480. package/dist/oidc-token.js +221 -0
  481. package/dist/playground/assets/index-BaBSZXki.css +1 -0
  482. package/dist/playground/assets/index-BkAF8YlO.js +62 -0
  483. package/dist/playground/index.html +2 -2
  484. package/dist/teams-app-package.d.ts +78 -0
  485. package/dist/teams-app-package.d.ts.map +1 -0
  486. package/dist/teams-app-package.js +204 -0
  487. package/dist/tools.d.ts +1 -1
  488. package/dist/tools.d.ts.map +1 -1
  489. package/dist/types.d.ts +271 -2
  490. package/dist/types.d.ts.map +1 -1
  491. package/docs/changelog.md +35 -0
  492. package/docs/deployment.md +10 -0
  493. package/docs/guides/cloud-agents.md +47 -0
  494. package/docs/guides/teams.md +389 -0
  495. package/docs/reference/channels.md +1 -0
  496. package/docs/reference/cli.md +116 -0
  497. package/docs/reference/limits.md +4 -4
  498. package/docs/reference/sessions.md +13 -0
  499. package/docs/troubleshooting.md +21 -0
  500. package/package.json +21 -46
  501. package/skills/create-agent/SKILL.md +17 -4
  502. package/skills/debug/SKILL.md +1 -0
  503. package/skills/deploy/SKILL.md +1 -1
  504. package/skills/framework-map/SKILL.md +1 -0
  505. package/skills/setup-teams/SKILL.md +141 -0
  506. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
  507. package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
  508. package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
  509. package/dist/docs/assets/changelog.md.DVNB-ApU.js +0 -1
  510. package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +0 -1
  511. package/dist/docs/assets/chunks/channel.CdyTxaXV.js +0 -1
  512. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +0 -1
  513. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +0 -1
  514. package/dist/docs/assets/chunks/clone.DpIwUbur.js +0 -1
  515. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +0 -1
  516. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
  517. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
  518. package/dist/playground/assets/index-CnFd5R1_.js +0 -62
  519. package/dist/playground/assets/index-DNzRv6G8.css +0 -1
  520. /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
  521. /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
package/dist/types.d.ts CHANGED
@@ -221,7 +221,9 @@ export interface AgentConfig {
221
221
  * the discovered `agent/skills/` read-only and index them in the
222
222
  * instructions. Pass a callback to mount the tree it returns instead,
223
223
  * for example the discovered skills plus tenant skills. The index
224
- * still lists only discovered skills. `false` mounts nothing and
224
+ * lists only the discovered skills that tree serves at
225
+ * `/<name>/SKILL.md`, asked each turn, so a tree can withhold a skill
226
+ * for one session by not serving it. `false` mounts nothing and
225
227
  * drops the index. Host-disk agents get `.cursor/skills/` and ignore
226
228
  * this field.
227
229
  */
@@ -373,6 +375,15 @@ export interface AgentHostingOptions {
373
375
  * the next deploy.
374
376
  */
375
377
  image?: string;
378
+ /**
379
+ * Customer OIDC audiences this deployment may mint for workload identity
380
+ * federation. Exact strings, at most 8, each 1–512 printable ASCII
381
+ * characters with no spaces or `*`. The Cursor exchange audience is
382
+ * refused even if it is listed.
383
+ */
384
+ oidc?: {
385
+ audiences?: string[];
386
+ };
376
387
  }
377
388
  /**
378
389
  * Local runtime options on {@link AgentConfig.local}.
@@ -858,6 +869,11 @@ export interface ToolContext {
858
869
  * `subagent.completed`). Omitted for scratch `callTool` with no session.
859
870
  */
860
871
  emit?: (payload: SessionEventPayload) => void;
872
+ /**
873
+ * Add a user message to the turn this call runs in, through `Run.steer`.
874
+ * See {@link SteerTurn}. Omitted for scratch `callTool` with no session.
875
+ */
876
+ steer?: SteerTurn;
861
877
  /**
862
878
  * Tags for this turn. The values stay in the process and are copied
863
879
  * onto spans, log records, and `cursor.token.usage` when those are
@@ -916,6 +932,19 @@ export type ToolNeedsApproval<TInput> = boolean | ((input: TInput) => boolean |
916
932
  * run.
917
933
  */
918
934
  export type ToolEffect = "read" | "write" | "idempotent";
935
+ /**
936
+ * Whose account a `cursorAccount` connection uses for a call.
937
+ *
938
+ * - `"shared"`: every call uses the account signed in on the Deployed Agents
939
+ * page, including a run with no person. This is the mode when
940
+ * {@link ConnectionConfig.credentials} is omitted.
941
+ * - `"individual"`: the account of the person whose message started the
942
+ * turn. A turn with no person, such as a schedule or a webhook, fails. It
943
+ * never uses another account.
944
+ *
945
+ * @experimental
946
+ */
947
+ export type ConnectionCredentialMode = "individual" | "shared";
919
948
  /** Authored `defineConnection({ effects })` — one effect or a set. */
920
949
  export type ConnectionEffects = ToolEffect | readonly ToolEffect[];
921
950
  export declare function isToolEffect(value: unknown): value is ToolEffect;
@@ -1074,6 +1103,12 @@ export interface Extension<TConfig = undefined, TInput = TConfig> extends Extens
1074
1103
  (...args: undefined extends TInput ? [config?: TInput] : [config: TInput]): ExtensionMount;
1075
1104
  /** The mounted configuration (schema defaults applied); throws before the mount. */
1076
1105
  readonly config: TConfig;
1106
+ /**
1107
+ * The namespace the agent mounted it under (`agent/extensions/<ns>.ts`), so
1108
+ * the tree can name its own contributions (`<ns>__<name>`); throws until
1109
+ * discovery has loaded the mount.
1110
+ */
1111
+ readonly namespace: string;
1077
1112
  }
1078
1113
  /** The mount-independent part of an {@link Extension}: an agent-shaped tree. */
1079
1114
  export interface ExtensionDeclaration {
@@ -1293,6 +1328,13 @@ export type ConnectionConfig = (((Exclude<ConnectionTransport, {
1293
1328
  */
1294
1329
  tools?: readonly string[];
1295
1330
  }) | InlineStdioConnectionConfig) & {
1331
+ /**
1332
+ * Whose account a `cursorAccount` connection uses. See
1333
+ * {@link ConnectionCredentialMode}. Omit it to keep the account signed in
1334
+ * on the Deployed Agents page. Only valid with `cursorAccount: true`.
1335
+ * @experimental
1336
+ */
1337
+ credentials?: ConnectionCredentialMode;
1296
1338
  /** Documentation only; shown in `info` output. */
1297
1339
  description?: string;
1298
1340
  /**
@@ -1408,6 +1450,8 @@ export interface AuthContext {
1408
1450
  principalId: string;
1409
1451
  principalType: "user" | "service" | "runtime";
1410
1452
  attributes?: Record<string, string>;
1453
+ /** The caller's display name, shown where a person reads who acted, such as an approval card. */
1454
+ label?: string;
1411
1455
  }
1412
1456
  export interface AuthRequestInfo {
1413
1457
  /** Client IP, or null when the host cannot provide it. */
@@ -1470,6 +1514,8 @@ export interface ActionResult {
1470
1514
  }
1471
1515
  /** Human decision for a parked {@link ToolConfig.needsApproval} tool call. */
1472
1516
  export type ApprovalDecision = "approve" | "deny";
1517
+ /** Why a tool approval or MCP auth wait ended with nobody's decision. */
1518
+ export type ApprovalEndReason = "timeout" | "interrupt";
1473
1519
  /** Durable record of a tool call waiting on human approval. */
1474
1520
  export interface PendingApproval {
1475
1521
  callId: string;
@@ -1478,6 +1524,20 @@ export interface PendingApproval {
1478
1524
  args: unknown;
1479
1525
  requestedAt: string;
1480
1526
  }
1527
+ /**
1528
+ * The host's answer to the agent's `mcp_auth` request, the same shape as
1529
+ * `@cursor/sdk`'s `onMcpAuthRequest`. `undefined` keeps the SDK's default.
1530
+ * @experimental
1531
+ */
1532
+ export type McpAuthRequestHandler = (request: {
1533
+ serverName: string;
1534
+ toolCallId: string;
1535
+ }) => Promise<{
1536
+ kind: "approved";
1537
+ } | {
1538
+ kind: "rejected";
1539
+ reason: string;
1540
+ } | undefined>;
1481
1541
  /** Durable record of a tool call waiting on MCP authorization. */
1482
1542
  export interface PendingAuth {
1483
1543
  callId: string;
@@ -1486,6 +1546,18 @@ export interface PendingAuth {
1486
1546
  connection: string;
1487
1547
  authUrl: string;
1488
1548
  requestedAt: string;
1549
+ /**
1550
+ * Set when no turn waits on this connect. It stays until the person's next
1551
+ * turn finds the connection connected, or they cancel.
1552
+ * @experimental
1553
+ */
1554
+ awaitsNextTurn?: true;
1555
+ /**
1556
+ * The signed user a connect that awaits the next turn was made for. Only
1557
+ * that user's turns reuse, cancel or resolve it.
1558
+ * @experimental
1559
+ */
1560
+ userId?: number;
1489
1561
  }
1490
1562
  export type SessionEventPayload = {
1491
1563
  type: "session.started";
@@ -1537,6 +1609,20 @@ export type SessionEventPayload = {
1537
1609
  stepId: number;
1538
1610
  durationMs: number;
1539
1611
  };
1612
+ } | {
1613
+ /**
1614
+ * One model call finished. `usage` is that call's tokens, counted
1615
+ * like {@link TurnUsage}: `inputTokens` is the whole prompt, cache
1616
+ * reads and writes included. `modelCallId` matches
1617
+ * {@link ActionCall.modelCallId} on the tools that call requested.
1618
+ * Emitted only when the Cursor SDK reports per-call usage;
1619
+ * `turn.completed` still carries the turn's total.
1620
+ */
1621
+ type: "model_call.completed";
1622
+ data: {
1623
+ modelCallId: string;
1624
+ usage: TurnUsage;
1625
+ };
1540
1626
  } | {
1541
1627
  type: "reasoning.appended";
1542
1628
  data: {
@@ -1595,7 +1681,10 @@ export type SessionEventPayload = {
1595
1681
  callId: string;
1596
1682
  toolName: string;
1597
1683
  decision: ApprovalDecision;
1684
+ /** The person who decided. Absent when nobody did. */
1598
1685
  by?: string;
1686
+ /** Set when nobody decided: the wait timed out or the turn was interrupted. */
1687
+ reason?: ApprovalEndReason;
1599
1688
  parentCallId?: string;
1600
1689
  };
1601
1690
  } | {
@@ -1607,6 +1696,8 @@ export type SessionEventPayload = {
1607
1696
  * the person completes the `authUrl`, the turn is interrupted, or 10
1608
1697
  * minutes pass. Other turns (schedules, reminders, webhooks, evals) do
1609
1698
  * not emit this event. They fail the call with a "Reconnect" message.
1699
+ * An `"individual"` connection sets `privateTo` and does not wait: the
1700
+ * person connects, then clicks Connected, which starts their next turn.
1610
1701
  */
1611
1702
  type: "action.auth_requested";
1612
1703
  data: {
@@ -1615,6 +1706,27 @@ export type SessionEventPayload = {
1615
1706
  connection: string;
1616
1707
  authUrl: string;
1617
1708
  parentCallId?: string;
1709
+ /**
1710
+ * Show `authUrl` only to this person. The turn does not wait for
1711
+ * them to connect. `slackUserId` is set when the turn came from
1712
+ * Slack. A channel that cannot reach this person shows nothing.
1713
+ * @experimental
1714
+ */
1715
+ privateTo?: {
1716
+ slackUserId?: string;
1717
+ };
1718
+ };
1719
+ } | {
1720
+ /**
1721
+ * The Slack member who started this turn has no linked Cursor account,
1722
+ * and the agent has an `"individual"` connection. Show them, and only
1723
+ * them, how to link their account. The turn runs without that
1724
+ * connection.
1725
+ * @experimental
1726
+ */
1727
+ type: "action.account_link_requested";
1728
+ data: {
1729
+ slackUserId: string;
1618
1730
  };
1619
1731
  } | {
1620
1732
  type: "action.auth_resolved";
@@ -1623,7 +1735,10 @@ export type SessionEventPayload = {
1623
1735
  toolName: string;
1624
1736
  connection: string;
1625
1737
  decision: ApprovalDecision;
1738
+ /** The person who decided. Absent when nobody did. */
1626
1739
  by?: string;
1740
+ /** Set when nobody decided: the wait timed out or the turn was interrupted. */
1741
+ reason?: ApprovalEndReason;
1627
1742
  parentCallId?: string;
1628
1743
  };
1629
1744
  } | {
@@ -1897,6 +2012,18 @@ export interface SessionRecord {
1897
2012
  channelState?: JsonValue;
1898
2013
  /** Cursor SDK agent id for this session. */
1899
2014
  sdkAgentId?: string;
2015
+ /**
2016
+ * The cloud run that the newest hosted delivery started. A retry of that
2017
+ * delivery on another host waits on this run instead of sending the
2018
+ * message again.
2019
+ *
2020
+ * @internal
2021
+ */
2022
+ hostedCloudRun?: {
2023
+ platformDeliveryId: string;
2024
+ sdkAgentId: string;
2025
+ runId: string;
2026
+ };
1900
2027
  /**
1901
2028
  * When set, local harness turns use this directory as `cwd` (e.g. a PR
1902
2029
  * worktree). Session scaffold files still land under the session workspace.
@@ -2291,7 +2418,7 @@ export interface ChannelHandlerArgs {
2291
2418
  * pass `sessionId` in `tag` input to attribute one).
2292
2419
  */
2293
2420
  artifacts: ArtifactsApi;
2294
- /** Hosted Slack admission uses this to paint a warm follow-up. */
2421
+ /** Hosted admission uses this to paint a warm follow-up. */
2295
2422
  hasContinuationSession?(continuationToken: string): Promise<boolean>;
2296
2423
  isContinuationBusy?(continuationToken: string): Promise<boolean>;
2297
2424
  getContinuationLastBotMessageTs?(continuationToken: string): Promise<string | undefined>;
@@ -2387,7 +2514,51 @@ export interface SessionContext {
2387
2514
  * auto-fills both ids and rejects a conflicting explicit `sessionId`.
2388
2515
  */
2389
2516
  artifacts: ArtifactsApi;
2517
+ /**
2518
+ * Add a user message to this session's running turn through the Cursor
2519
+ * SDK's `Run.steer`. For a turn-scoped event it targets that event's turn
2520
+ * only. See {@link SteerTurn}. The host sets it on every context it builds;
2521
+ * it is optional so contexts built by hand, as in tests, stay valid.
2522
+ */
2523
+ steer?: SteerTurn;
2524
+ }
2525
+ /** Options for {@link SteerTurn}. */
2526
+ export interface SteerTurnOptions {
2527
+ /**
2528
+ * Stamped on the `message.received` and `nudge.delivered` events a
2529
+ * landed steer records. Same rules as {@link SendMessageOptions.deliveryId};
2530
+ * omit for a fresh `dlv_…` id.
2531
+ */
2532
+ deliveryId?: string;
2390
2533
  }
2534
+ /**
2535
+ * What {@link SteerTurn} did.
2536
+ *
2537
+ * - `steered`: the running turn took the message. The session records
2538
+ * `message.received` and `nudge.delivered` with `deliveryId`.
2539
+ * - `no_turn`: no turn is running in this process for the session, or the
2540
+ * running turn is not the one this context belongs to.
2541
+ * - `not_delivered`: a turn is running but did not take the message:
2542
+ * `unsupported` when its runner cannot steer, `refused` when the SDK
2543
+ * reverted the steer (the turn was ending, or the run cannot be steered).
2544
+ */
2545
+ export type SteerTurnResult = {
2546
+ status: "steered";
2547
+ turnId: string;
2548
+ deliveryId: string;
2549
+ } | {
2550
+ status: "no_turn";
2551
+ } | {
2552
+ status: "not_delivered";
2553
+ reason: "unsupported" | "refused";
2554
+ };
2555
+ /**
2556
+ * Add a user message to the session's running turn, as a person steering
2557
+ * the turn would. It never starts a turn, opens a session, or queues the
2558
+ * message for later: when the message cannot land now, the result says so
2559
+ * and nothing else happens.
2560
+ */
2561
+ export type SteerTurn = (message: string, options?: SteerTurnOptions) => Promise<SteerTurnResult>;
2391
2562
  /**
2392
2563
  * Discovery stores every channel as {@link ChannelDefinition}. That definition
2393
2564
  * types state as {@link JsonValue}. The method form lets a handler for one
@@ -2485,6 +2656,11 @@ export interface ChannelStartArgs {
2485
2656
  export interface ChannelMeta {
2486
2657
  /** Well-known pack kind, e.g. `"github"` or `"slack"`. */
2487
2658
  kind?: string;
2659
+ /**
2660
+ * How long a parked tool call on this channel waits for Approve or Deny
2661
+ * before it is denied. Absent waits until a decision or a cancel.
2662
+ */
2663
+ toolApprovalTimeoutMs?: number;
2488
2664
  /**
2489
2665
  * For GitHub webhook packs: the webhook event names this channel is wired
2490
2666
  * to dispatch on. Used to derive `gh webhook forward --events`.
@@ -2539,6 +2715,28 @@ export interface ChannelMeta {
2539
2715
  * by `info` so watched channels are auditable.
2540
2716
  */
2541
2717
  slackChannelPosts?: readonly string[];
2718
+ /**
2719
+ * Env names this channel reads, keyed by role (`appId`, `bot`).
2720
+ * `envPrefix` is already normalized, or `""` when the names have no prefix.
2721
+ * The deploy manifest copies this. Absent when the channel takes
2722
+ * `credentials` directly. Older manifests omit it.
2723
+ */
2724
+ credentialEnv?: {
2725
+ envPrefix: string;
2726
+ keys: Readonly<Record<string, string>>;
2727
+ };
2728
+ /**
2729
+ * For Teams packs: what wakes the agent. `channelPosts` lists the watched
2730
+ * channel ids and is present only when the channel watches posts.
2731
+ * `includeBotPosts` is present with it, and says whether posts by other
2732
+ * bots in those channels wake the agent.
2733
+ */
2734
+ teamsEngagement?: {
2735
+ mentions: boolean;
2736
+ directMessages: boolean;
2737
+ channelPosts?: readonly string[];
2738
+ includeBotPosts?: boolean;
2739
+ };
2542
2740
  /**
2543
2741
  * Author-facing notices about deprecated options the pack still honored.
2544
2742
  * Discovery surfaces each one as a `validate` warning on the channel file.
@@ -3058,6 +3256,18 @@ export interface ReminderHostApi {
3058
3256
  * calls this from `setContinuationToken`; channels rarely need to.
3059
3257
  */
3060
3258
  rekeyContinuation(channelId: string, oldToken: string, newToken: string): Promise<number>;
3259
+ /**
3260
+ * Fire an armed reminder as soon as the platform can, through its normal
3261
+ * claim, so a duplicate request never fires it twice. Returns the reminder
3262
+ * unchanged when it is not armed, and undefined for an unknown id.
3263
+ */
3264
+ fireNow?(id: string): Promise<ReminderInfo | undefined>;
3265
+ /**
3266
+ * The request that `create` would send for `input`, validated the same
3267
+ * way, without creating the reminder. Undefined on hosts without a
3268
+ * reminder control plane.
3269
+ */
3270
+ createRequest?(input: ReminderCreateInput): Promise<JsonObject>;
3061
3271
  /**
3062
3272
  * Fire immediately (dev / hillclimb).
3063
3273
  * `outcome` is `"noop"` when already firing or not armed.
@@ -3156,6 +3366,12 @@ export interface DiscoveredConnection {
3156
3366
  name: string;
3157
3367
  transport: ConnectionTransport;
3158
3368
  description?: string;
3369
+ /**
3370
+ * {@link ConnectionConfig.credentials}. Absent means the account signed in
3371
+ * on the Deployed Agents page.
3372
+ * @experimental
3373
+ */
3374
+ credentials?: ConnectionCredentialMode;
3159
3375
  /** Per-session auth from {@link ConnectionConfig.auth} (http/sse only). */
3160
3376
  auth?: ConnectionAuthProvider;
3161
3377
  /** Advertise-by-name from {@link ConnectionConfig.advertiseTools}. */
@@ -3345,6 +3561,11 @@ export interface ProjectConnectionInfo {
3345
3561
  * @experimental
3346
3562
  */
3347
3563
  cursorAccountServers?: string[] | "*";
3564
+ /**
3565
+ * Present when the connection sets {@link ConnectionConfig.credentials}.
3566
+ * @experimental
3567
+ */
3568
+ credentials?: ConnectionCredentialMode;
3348
3569
  }
3349
3570
  export interface ProjectChannelInfo {
3350
3571
  id: string;
@@ -3391,6 +3612,19 @@ export interface ProjectChannelInfo {
3391
3612
  * @experimental
3392
3613
  */
3393
3614
  slackChannelPosts?: readonly string[];
3615
+ /**
3616
+ * For Teams packs: what wakes the agent. `channelPosts` lists the watched
3617
+ * channel ids and is present only when the channel watches posts.
3618
+ * `includeBotPosts` is present with it, and says whether posts by other
3619
+ * bots in those channels wake the agent.
3620
+ * @experimental
3621
+ */
3622
+ teamsEngagement?: {
3623
+ mentions: boolean;
3624
+ directMessages: boolean;
3625
+ channelPosts?: readonly string[];
3626
+ includeBotPosts?: boolean;
3627
+ };
3394
3628
  }
3395
3629
  /** JSON-safe projection of the manifest returned by `GET /v1/info`. */
3396
3630
  export interface ProjectInfo {
@@ -3423,6 +3657,9 @@ export interface ProjectInfo {
3423
3657
  egressDomains?: string[];
3424
3658
  secretNames?: string[];
3425
3659
  image?: string;
3660
+ oidc?: {
3661
+ audiences?: string[];
3662
+ };
3426
3663
  };
3427
3664
  /**
3428
3665
  * Turn admission limits when authored (`concurrency` on `agent.ts`).
@@ -3617,6 +3854,13 @@ export interface RunnerTurnRequest {
3617
3854
  * the local executor cache key stays stable while credentials rotate.
3618
3855
  */
3619
3856
  perSendMcpServers?: boolean;
3857
+ /**
3858
+ * Decides the agent's `mcp_auth` requests on a local turn. Passed to the
3859
+ * SDK as `local.onMcpAuthRequest`; an SDK without that option rejects the
3860
+ * request as before.
3861
+ * @experimental
3862
+ */
3863
+ onMcpAuthRequest?: McpAuthRequestHandler;
3620
3864
  /**
3621
3865
  * Loopback URLs of the host's own Cursor-account bridges. The backend checks
3622
3866
  * every server they relay against the team's MCP policy.
@@ -3628,6 +3872,31 @@ export interface RunnerTurnRequest {
3628
3872
  onUpdate: (update: RunnerUpdate) => void | Promise<void>;
3629
3873
  /** Called once the SDK agent is open so the engine can persist its id. */
3630
3874
  onSdkAgentId?: (sdkAgentId: string) => void | Promise<void>;
3875
+ /**
3876
+ * A cloud run to wait on instead of sending {@link prompt}: the run that an
3877
+ * earlier host started for this same delivery on {@link sdkAgentId}. When
3878
+ * that run ends without finishing, the turn sends {@link prompt} after all.
3879
+ *
3880
+ * @internal
3881
+ */
3882
+ reattachCloudRunId?: string;
3883
+ /**
3884
+ * The hosted platform's id for the delivery this turn answers. A cloud turn
3885
+ * derives the id of a cloud agent it creates from it and the turn's model,
3886
+ * so every attempt at the delivery on one model names the same agent.
3887
+ *
3888
+ * @internal
3889
+ */
3890
+ platformDeliveryId?: string;
3891
+ /**
3892
+ * Called once a cloud send has started its run, before the run finishes.
3893
+ *
3894
+ * @internal
3895
+ */
3896
+ onCloudRunStarted?: (run: {
3897
+ sdkAgentId: string;
3898
+ runId: string;
3899
+ }) => void | Promise<void>;
3631
3900
  /**
3632
3901
  * Called once the harness names the run, before it produces anything.
3633
3902
  * Surfaces the request id while the turn is still running rather than at