@grok/agent-sdk 0.5.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 (530) 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/manifest.d.ts.map +1 -1
  34. package/dist/channels/slack/manifest.js +2 -15
  35. package/dist/channels/slack/mentions.d.ts +28 -0
  36. package/dist/channels/slack/mentions.d.ts.map +1 -0
  37. package/dist/channels/slack/mentions.js +178 -0
  38. package/dist/channels/slack/setup.js +1 -1
  39. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  40. package/dist/channels/slack/slack-channel.js +46 -3
  41. package/dist/channels/slack/stop.d.ts.map +1 -1
  42. package/dist/channels/slack/stop.js +7 -1
  43. package/dist/channels/slack/thread-context.d.ts +3 -0
  44. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  45. package/dist/channels/slack/thread-context.js +17 -7
  46. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
  47. package/dist/channels/slack/tool-approval-events.js +55 -2
  48. package/dist/channels/slack/types.d.ts +2 -0
  49. package/dist/channels/slack/types.d.ts.map +1 -1
  50. package/dist/channels/teams/activity.d.ts +33 -0
  51. package/dist/channels/teams/activity.d.ts.map +1 -0
  52. package/dist/channels/teams/activity.js +213 -0
  53. package/dist/channels/teams/auth.d.ts +25 -0
  54. package/dist/channels/teams/auth.d.ts.map +1 -0
  55. package/dist/channels/teams/auth.js +55 -0
  56. package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
  57. package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
  58. package/dist/channels/teams/bot-framework-auth.js +154 -0
  59. package/dist/channels/teams/cards.d.ts +23 -0
  60. package/dist/channels/teams/cards.d.ts.map +1 -0
  61. package/dist/channels/teams/cards.js +107 -0
  62. package/dist/channels/teams/connector.d.ts +48 -0
  63. package/dist/channels/teams/connector.d.ts.map +1 -0
  64. package/dist/channels/teams/connector.js +159 -0
  65. package/dist/channels/teams/credentials.d.ts +65 -0
  66. package/dist/channels/teams/credentials.d.ts.map +1 -0
  67. package/dist/channels/teams/credentials.js +84 -0
  68. package/dist/channels/teams/delivery.d.ts +14 -0
  69. package/dist/channels/teams/delivery.d.ts.map +1 -0
  70. package/dist/channels/teams/delivery.js +169 -0
  71. package/dist/channels/teams/dispatch.d.ts +45 -0
  72. package/dist/channels/teams/dispatch.d.ts.map +1 -0
  73. package/dist/channels/teams/dispatch.js +402 -0
  74. package/dist/channels/teams/engagement.d.ts +32 -0
  75. package/dist/channels/teams/engagement.d.ts.map +1 -0
  76. package/dist/channels/teams/engagement.js +120 -0
  77. package/dist/channels/teams/index.d.ts +21 -0
  78. package/dist/channels/teams/index.d.ts.map +1 -0
  79. package/dist/channels/teams/index.js +19 -0
  80. package/dist/channels/teams/marks.d.ts +19 -0
  81. package/dist/channels/teams/marks.d.ts.map +1 -0
  82. package/dist/channels/teams/marks.js +96 -0
  83. package/dist/channels/teams/senders.d.ts +27 -0
  84. package/dist/channels/teams/senders.d.ts.map +1 -0
  85. package/dist/channels/teams/senders.js +72 -0
  86. package/dist/channels/teams/teams-channel.d.ts +43 -0
  87. package/dist/channels/teams/teams-channel.d.ts.map +1 -0
  88. package/dist/channels/teams/teams-channel.js +278 -0
  89. package/dist/channels/teams/text.d.ts +7 -0
  90. package/dist/channels/teams/text.d.ts.map +1 -0
  91. package/dist/channels/teams/text.js +63 -0
  92. package/dist/channels/teams/types.d.ts +306 -0
  93. package/dist/channels/teams/types.d.ts.map +1 -0
  94. package/dist/channels/teams/types.js +1 -0
  95. package/dist/channels.d.ts +31 -0
  96. package/dist/channels.d.ts.map +1 -1
  97. package/dist/channels.js +37 -0
  98. package/dist/connections.d.ts +1 -1
  99. package/dist/connections.d.ts.map +1 -1
  100. package/dist/docs/404.html +3 -3
  101. package/dist/docs/assets/{app.CYdjweqP.js → app.Ch-048af.js} +4 -4
  102. package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
  103. package/dist/docs/assets/{changelog.md.BMrJ5WxW.lean.js → changelog.md.SoN0MK7o.lean.js} +1 -1
  104. package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +1 -0
  105. package/dist/docs/assets/chunks/{VPLocalSearchBox.CRATKS9J.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
  106. package/dist/docs/assets/chunks/{arc.BxM78ISR.js → arc.BIzu7OVF.js} +1 -1
  107. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.Bi6MuKaU.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
  108. package/dist/docs/assets/chunks/{baseUniq.L47qqpDG.js → baseUniq.B4y6Y5eG.js} +1 -1
  109. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.kHFF2FK5.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
  110. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BTW85ll3.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
  111. package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
  112. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.Bbh3_48g.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
  113. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.WeAmK3fK.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
  114. package/dist/docs/assets/chunks/{chunk-55IACEB6.DTdUiVHf.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
  115. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.n5XzANDz.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
  116. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.D51eewCb.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
  117. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.BrY0U7ZV.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
  118. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B0OA4aFV.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
  119. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Djt3Mjft.js → chunk-YZCP3GAM.CwrYtDVo.js} +1 -1
  120. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +1 -0
  121. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +1 -0
  122. package/dist/docs/assets/chunks/clone.F824-PNx.js +1 -0
  123. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DiMcA6Q8.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
  124. package/dist/docs/assets/chunks/{dagre-KV5264BT.BGqI4vrS.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
  125. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.bDqFuMoH.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
  126. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Y0sxaXRU.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
  127. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Bg43b0yi.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
  128. package/dist/docs/assets/chunks/{diagram-TYMM5635.DCfVasEC.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
  129. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.C72GaD16.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
  130. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.DxRQj7pP.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
  131. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DiLZy5Q4.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
  132. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.DL8XkRvh.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
  133. package/dist/docs/assets/chunks/{graph.3Xub80xJ.js → graph.CdOyJvsX.js} +1 -1
  134. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.O3lGaspu.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
  135. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.w-pCiQzn.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
  136. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cg_oBs9j.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
  137. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.BpfMGPwn.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
  138. package/dist/docs/assets/chunks/{layout.CtwXs__p.js → layout.DDwvoQlY.js} +1 -1
  139. package/dist/docs/assets/chunks/{linear.NmCskOrP.js → linear.BRXPDWj3.js} +1 -1
  140. package/dist/docs/assets/chunks/{min.DpQtsLKs.js → min.3YwC0t3o.js} +1 -1
  141. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.B-P-aKVp.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
  142. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.BfjjqK7j.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
  143. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BTzHo53F.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
  144. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DIT2FIKr.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
  145. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.NK1wCsgt.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
  146. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.D9oElkvo.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
  147. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.IPksnixH.js → stateDiagram-FHFEXIEX.B_SGgvgs.js} +1 -1
  148. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +1 -0
  149. package/dist/docs/assets/chunks/{theme.CgKu7tr3.js → theme.bNyH5NPA.js} +2 -2
  150. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CuAtJapY.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
  151. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.B87nNW9E.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
  152. package/dist/docs/assets/chunks/wardley-RL74JXVD.DQqE3WF8.js +162 -0
  153. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BELjSq8w.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
  154. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.5zN5ZGsz.js → xychartDiagram-5P7HB3ND.DnJA2aXp.js} +1 -1
  155. package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.N9S5KC5R.js} +2 -2
  156. package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.N9S5KC5R.lean.js} +1 -1
  157. package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
  158. package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
  159. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
  160. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
  161. package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
  162. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
  163. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
  164. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
  165. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
  166. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  167. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
  168. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
  169. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
  170. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
  171. package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
  172. package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
  173. package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
  174. package/dist/docs/building-with-agents.html +37 -37
  175. package/dist/docs/changelog.html +37 -37
  176. package/dist/docs/changelog.md +51 -0
  177. package/dist/docs/deployment.html +39 -39
  178. package/dist/docs/deployment.md +10 -0
  179. package/dist/docs/evals.html +37 -37
  180. package/dist/docs/guides/agent-to-agent.html +37 -37
  181. package/dist/docs/guides/bitbucket.html +37 -37
  182. package/dist/docs/guides/cloud-agents.html +43 -38
  183. package/dist/docs/guides/cloud-agents.md +47 -0
  184. package/dist/docs/guides/convert-automation.html +37 -37
  185. package/dist/docs/guides/github.html +37 -37
  186. package/dist/docs/guides/gitlab.html +37 -37
  187. package/dist/docs/guides/improve.html +37 -37
  188. package/dist/docs/guides/jev.html +37 -37
  189. package/dist/docs/guides/mcp-oauth.html +37 -37
  190. package/dist/docs/guides/migrate.html +37 -37
  191. package/dist/docs/guides/opentelemetry.html +37 -37
  192. package/dist/docs/guides/pagerduty.html +37 -37
  193. package/dist/docs/guides/slack.html +37 -37
  194. package/dist/docs/guides/teams.html +109 -0
  195. package/dist/docs/guides/teams.md +384 -0
  196. package/dist/docs/guides/webhooks.html +37 -37
  197. package/dist/docs/hashmap.json +1 -1
  198. package/dist/docs/hillclimbing.html +37 -37
  199. package/dist/docs/index.html +37 -37
  200. package/dist/docs/llms-full.txt +652 -4
  201. package/dist/docs/llms.txt +1 -0
  202. package/dist/docs/quickstart.html +37 -37
  203. package/dist/docs/reference/access.html +36 -36
  204. package/dist/docs/reference/agent-config.html +37 -37
  205. package/dist/docs/reference/artifacts.html +37 -37
  206. package/dist/docs/reference/channels.html +38 -38
  207. package/dist/docs/reference/channels.md +1 -0
  208. package/dist/docs/reference/cli.html +50 -40
  209. package/dist/docs/reference/cli.md +116 -0
  210. package/dist/docs/reference/connections.html +37 -37
  211. package/dist/docs/reference/evals.html +37 -37
  212. package/dist/docs/reference/extensions.html +37 -37
  213. package/dist/docs/reference/hooks.html +37 -37
  214. package/dist/docs/reference/http-api.html +37 -37
  215. package/dist/docs/reference/instructions.html +37 -37
  216. package/dist/docs/reference/limits.html +39 -39
  217. package/dist/docs/reference/limits.md +4 -4
  218. package/dist/docs/reference/memory.html +37 -37
  219. package/dist/docs/reference/playground.html +36 -36
  220. package/dist/docs/reference/project-layout.html +37 -37
  221. package/dist/docs/reference/schedules.html +40 -40
  222. package/dist/docs/reference/sessions.html +38 -38
  223. package/dist/docs/reference/sessions.md +13 -0
  224. package/dist/docs/reference/skills.html +40 -40
  225. package/dist/docs/reference/subagents.html +37 -37
  226. package/dist/docs/reference/tools.html +37 -37
  227. package/dist/docs/templates/agentic-owners.html +37 -37
  228. package/dist/docs/templates/reviews.html +37 -37
  229. package/dist/docs/troubleshooting.html +38 -38
  230. package/dist/docs/troubleshooting.md +21 -0
  231. package/dist/evals/run-facts.d.ts.map +1 -1
  232. package/dist/evals/run-facts.js +4 -0
  233. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
  234. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
  235. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
  236. package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
  237. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  238. package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
  239. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
  240. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
  241. package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
  242. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
  243. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  244. package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
  245. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
  246. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
  247. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
  248. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
  249. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
  250. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
  251. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
  252. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
  253. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
  254. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
  255. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
  256. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
  257. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
  258. package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
  259. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
  260. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
  261. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
  262. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
  263. package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
  264. package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
  265. package/dist/extensions.d.ts.map +1 -1
  266. package/dist/extensions.js +18 -3
  267. package/dist/files-backends/agent-store-presigned-url.js +5 -1
  268. package/dist/index.d.ts +1 -0
  269. package/dist/index.d.ts.map +1 -1
  270. package/dist/index.js +1 -0
  271. package/dist/internal/approval-gate.d.ts +6 -1
  272. package/dist/internal/approval-gate.d.ts.map +1 -1
  273. package/dist/internal/approval-gate.js +13 -2
  274. package/dist/internal/authored-loaders.js +1 -1
  275. package/dist/internal/channel-architecture.d.ts.map +1 -1
  276. package/dist/internal/channel-architecture.js +3 -1
  277. package/dist/internal/cli/commands/channels.d.ts +9 -3
  278. package/dist/internal/cli/commands/channels.d.ts.map +1 -1
  279. package/dist/internal/cli/commands/channels.js +193 -4
  280. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  281. package/dist/internal/cli/commands/index.js +6 -1
  282. package/dist/internal/cli/commands/serve.d.ts.map +1 -1
  283. package/dist/internal/cli/commands/serve.js +25 -5
  284. package/dist/internal/cli/dispatch.d.ts.map +1 -1
  285. package/dist/internal/cli/dispatch.js +22 -8
  286. package/dist/internal/cli/flags.d.ts +14 -0
  287. package/dist/internal/cli/flags.d.ts.map +1 -1
  288. package/dist/internal/cli/flags.js +14 -0
  289. package/dist/internal/cli/help.d.ts.map +1 -1
  290. package/dist/internal/cli/help.js +3 -1
  291. package/dist/internal/cli-cursor.js +2 -2
  292. package/dist/internal/cli-deploy.d.ts +1 -0
  293. package/dist/internal/cli-deploy.d.ts.map +1 -1
  294. package/dist/internal/cli-deploy.js +31 -8
  295. package/dist/internal/cli-mcp.d.ts.map +1 -1
  296. package/dist/internal/cli-mcp.js +5 -3
  297. package/dist/internal/cli-teams-doctor.d.ts +39 -0
  298. package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
  299. package/dist/internal/cli-teams-doctor.js +508 -0
  300. package/dist/internal/cli-teams-forward.d.ts +84 -0
  301. package/dist/internal/cli-teams-forward.d.ts.map +1 -0
  302. package/dist/internal/cli-teams-forward.js +386 -0
  303. package/dist/internal/cli-teams-package.d.ts +26 -0
  304. package/dist/internal/cli-teams-package.d.ts.map +1 -0
  305. package/dist/internal/cli-teams-package.js +123 -0
  306. package/dist/internal/cli-teams.d.ts +15 -0
  307. package/dist/internal/cli-teams.d.ts.map +1 -0
  308. package/dist/internal/cli-teams.js +253 -0
  309. package/dist/internal/connect-click.d.ts +12 -0
  310. package/dist/internal/connect-click.d.ts.map +1 -0
  311. package/dist/internal/connect-click.js +22 -0
  312. package/dist/internal/continuation-channel.d.ts +5 -1
  313. package/dist/internal/continuation-channel.d.ts.map +1 -1
  314. package/dist/internal/continuation-channel.js +34 -0
  315. package/dist/internal/continuation-identity.d.ts +7 -4
  316. package/dist/internal/continuation-identity.d.ts.map +1 -1
  317. package/dist/internal/continuation-identity.js +66 -1
  318. package/dist/internal/convert-automation/convert-workflow.js +2 -2
  319. package/dist/internal/credential-env-names.d.ts +36 -0
  320. package/dist/internal/credential-env-names.d.ts.map +1 -0
  321. package/dist/internal/credential-env-names.js +68 -0
  322. package/dist/internal/cursor/account-mcp.d.ts +67 -9
  323. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  324. package/dist/internal/cursor/account-mcp.js +206 -25
  325. package/dist/internal/cursor/backend-client.d.ts +10 -1
  326. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  327. package/dist/internal/cursor/backend-client.js +19 -7
  328. package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
  329. package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
  330. package/dist/internal/cursor/cloud-agent-identity.js +224 -0
  331. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  332. package/dist/internal/cursor/credentials.js +3 -1
  333. package/dist/internal/cursor-account-mcp-auth.d.ts +1 -0
  334. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  335. package/dist/internal/cursor-account-mcp-auth.js +2 -1
  336. package/dist/internal/deploy-client.d.ts.map +1 -1
  337. package/dist/internal/deploy-client.js +34 -2
  338. package/dist/internal/deploy-manifest.d.ts +51 -3
  339. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  340. package/dist/internal/deploy-manifest.js +96 -7
  341. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  342. package/dist/internal/discovery/agent-config.js +6 -1
  343. package/dist/internal/discovery/connections.d.ts.map +1 -1
  344. package/dist/internal/discovery/connections.js +53 -0
  345. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  346. package/dist/internal/discovery/extensions.js +2 -0
  347. package/dist/internal/discovery/info.d.ts.map +1 -1
  348. package/dist/internal/discovery/info.js +4 -0
  349. package/dist/internal/env-file.d.ts +1 -0
  350. package/dist/internal/env-file.d.ts.map +1 -1
  351. package/dist/internal/env-file.js +18 -17
  352. package/dist/internal/env-prefix.d.ts +11 -0
  353. package/dist/internal/env-prefix.d.ts.map +1 -0
  354. package/dist/internal/env-prefix.js +23 -0
  355. package/dist/internal/event-id-dedupe.d.ts +12 -0
  356. package/dist/internal/event-id-dedupe.d.ts.map +1 -0
  357. package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
  358. package/dist/internal/event-mapper.d.ts +7 -2
  359. package/dist/internal/event-mapper.d.ts.map +1 -1
  360. package/dist/internal/event-mapper.js +7 -0
  361. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  362. package/dist/internal/expected-delivery-failure.js +3 -0
  363. package/dist/internal/extension-namespace.d.ts +9 -0
  364. package/dist/internal/extension-namespace.d.ts.map +1 -0
  365. package/dist/internal/extension-namespace.js +14 -0
  366. package/dist/internal/guid.d.ts +2 -0
  367. package/dist/internal/guid.d.ts.map +1 -0
  368. package/dist/internal/guid.js +4 -0
  369. package/dist/internal/host-kv-cas.d.ts +13 -0
  370. package/dist/internal/host-kv-cas.d.ts.map +1 -0
  371. package/dist/internal/host-kv-cas.js +8 -0
  372. package/dist/internal/host-kv.d.ts +4 -1
  373. package/dist/internal/host-kv.d.ts.map +1 -1
  374. package/dist/internal/host-kv.js +15 -2
  375. package/dist/internal/hosted-catch-protocol.d.ts +5 -0
  376. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  377. package/dist/internal/hosted-catch-protocol.js +5 -0
  378. package/dist/internal/hosted-catch.d.ts +2 -0
  379. package/dist/internal/hosted-catch.d.ts.map +1 -1
  380. package/dist/internal/hosted-catch.js +6 -1
  381. package/dist/internal/hosted-delivery-protocol.d.ts +6 -0
  382. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  383. package/dist/internal/hosted-delivery-protocol.js +71 -1
  384. package/dist/internal/hosted-delivery.d.ts +5 -2
  385. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  386. package/dist/internal/hosted-delivery.js +36 -12
  387. package/dist/internal/hosted-execution-latency.d.ts +3 -0
  388. package/dist/internal/hosted-execution-latency.d.ts.map +1 -1
  389. package/dist/internal/hosted-execution-latency.js +11 -0
  390. package/dist/internal/hosted-session-fixture.js +1 -1
  391. package/dist/internal/hosting.d.ts +5 -0
  392. package/dist/internal/hosting.d.ts.map +1 -1
  393. package/dist/internal/hosting.js +7 -1
  394. package/dist/internal/install-cursor-skills.d.ts +6 -7
  395. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  396. package/dist/internal/install-cursor-skills.js +15 -9
  397. package/dist/internal/interview/agent-questions.d.ts +1 -1
  398. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  399. package/dist/internal/interview/agent-questions.js +4 -3
  400. package/dist/internal/local-control-plane.d.ts.map +1 -1
  401. package/dist/internal/local-control-plane.js +24 -0
  402. package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
  403. package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
  404. package/dist/internal/mcp-allowlist-in-use.js +93 -0
  405. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  406. package/dist/internal/mcp-endpoint.js +8 -10
  407. package/dist/internal/mcp-host.d.ts +19 -1
  408. package/dist/internal/mcp-host.d.ts.map +1 -1
  409. package/dist/internal/mcp-host.js +67 -3
  410. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  411. package/dist/internal/mcp-oauth.js +5 -7
  412. package/dist/internal/oidcAudiences.d.ts +22 -0
  413. package/dist/internal/oidcAudiences.d.ts.map +1 -0
  414. package/dist/internal/oidcAudiences.js +35 -0
  415. package/dist/internal/otel/collector.d.ts.map +1 -1
  416. package/dist/internal/otel/collector.js +2 -0
  417. package/dist/internal/platform-timers.d.ts +2 -0
  418. package/dist/internal/platform-timers.d.ts.map +1 -1
  419. package/dist/internal/platform-timers.js +14 -0
  420. package/dist/internal/private-file.d.ts +32 -1
  421. package/dist/internal/private-file.d.ts.map +1 -1
  422. package/dist/internal/private-file.js +209 -7
  423. package/dist/internal/redact-values.d.ts +3 -0
  424. package/dist/internal/redact-values.d.ts.map +1 -0
  425. package/dist/internal/redact-values.js +19 -0
  426. package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
  427. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  428. package/dist/internal/reminder-followup-error.d.ts +23 -0
  429. package/dist/internal/reminder-followup-error.d.ts.map +1 -0
  430. package/dist/internal/reminder-followup-error.js +12 -0
  431. package/dist/internal/reminder-runner.d.ts +15 -1
  432. package/dist/internal/reminder-runner.d.ts.map +1 -1
  433. package/dist/internal/reminder-runner.js +95 -21
  434. package/dist/internal/resolved-connections.d.ts.map +1 -1
  435. package/dist/internal/resolved-connections.js +23 -3
  436. package/dist/internal/run-client.js +2 -1
  437. package/dist/internal/run-program.d.ts +31 -0
  438. package/dist/internal/run-program.d.ts.map +1 -0
  439. package/dist/internal/run-program.js +150 -0
  440. package/dist/internal/sdk-runner.d.ts +29 -3
  441. package/dist/internal/sdk-runner.d.ts.map +1 -1
  442. package/dist/internal/sdk-runner.js +304 -38
  443. package/dist/internal/server.d.ts.map +1 -1
  444. package/dist/internal/server.js +53 -8
  445. package/dist/internal/session-credential.d.ts +14 -0
  446. package/dist/internal/session-credential.d.ts.map +1 -0
  447. package/dist/internal/session-credential.js +25 -0
  448. package/dist/internal/session-engine.d.ts +137 -5
  449. package/dist/internal/session-engine.d.ts.map +1 -1
  450. package/dist/internal/session-engine.js +606 -92
  451. package/dist/internal/storage-coordinator.d.ts +3 -1
  452. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  453. package/dist/internal/storage-coordinator.js +13 -0
  454. package/dist/internal/storage-roles.d.ts +9 -1
  455. package/dist/internal/storage-roles.d.ts.map +1 -1
  456. package/dist/internal/tcp-address.d.ts +3 -1
  457. package/dist/internal/tcp-address.d.ts.map +1 -1
  458. package/dist/internal/tcp-address.js +6 -0
  459. package/dist/internal/teams-channel-profile.d.ts +41 -0
  460. package/dist/internal/teams-channel-profile.d.ts.map +1 -0
  461. package/dist/internal/teams-channel-profile.js +91 -0
  462. package/dist/internal/teams-devtunnel.d.ts +55 -0
  463. package/dist/internal/teams-devtunnel.d.ts.map +1 -0
  464. package/dist/internal/teams-devtunnel.js +205 -0
  465. package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
  466. package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
  467. package/dist/internal/teams-tunnel-proxy.js +100 -0
  468. package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
  469. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
  470. package/dist/internal/testing/conversation-identity-vectors.js +67 -0
  471. package/dist/internal/testing/hosted-http.d.ts +15 -0
  472. package/dist/internal/testing/hosted-http.d.ts.map +1 -0
  473. package/dist/internal/testing/hosted-http.js +86 -0
  474. package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
  475. package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
  476. package/dist/internal/testing/teams-activity-fixtures.js +236 -0
  477. package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
  478. package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
  479. package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
  480. package/dist/internal/tunnel-process.d.ts +29 -0
  481. package/dist/internal/tunnel-process.d.ts.map +1 -0
  482. package/dist/internal/tunnel-process.js +105 -0
  483. package/dist/internal/turn-context.d.ts +28 -0
  484. package/dist/internal/turn-context.d.ts.map +1 -0
  485. package/dist/internal/turn-context.js +1 -0
  486. package/dist/oidc-token.d.ts +127 -0
  487. package/dist/oidc-token.d.ts.map +1 -0
  488. package/dist/oidc-token.js +221 -0
  489. package/dist/playground/assets/index-BaBSZXki.css +1 -0
  490. package/dist/playground/assets/index-BkAF8YlO.js +62 -0
  491. package/dist/playground/index.html +2 -2
  492. package/dist/teams-app-package.d.ts +78 -0
  493. package/dist/teams-app-package.d.ts.map +1 -0
  494. package/dist/teams-app-package.js +204 -0
  495. package/dist/tools.d.ts +1 -1
  496. package/dist/tools.d.ts.map +1 -1
  497. package/dist/types.d.ts +278 -2
  498. package/dist/types.d.ts.map +1 -1
  499. package/docs/changelog.md +51 -0
  500. package/docs/deployment.md +10 -0
  501. package/docs/guides/cloud-agents.md +47 -0
  502. package/docs/guides/teams.md +389 -0
  503. package/docs/reference/channels.md +1 -0
  504. package/docs/reference/cli.md +116 -0
  505. package/docs/reference/limits.md +4 -4
  506. package/docs/reference/sessions.md +13 -0
  507. package/docs/troubleshooting.md +21 -0
  508. package/package.json +21 -46
  509. package/skills/create-agent/SKILL.md +17 -4
  510. package/skills/debug/SKILL.md +1 -0
  511. package/skills/deploy/SKILL.md +1 -1
  512. package/skills/framework-map/SKILL.md +1 -0
  513. package/skills/setup-teams/SKILL.md +141 -0
  514. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
  515. package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
  516. package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
  517. package/dist/docs/assets/changelog.md.BMrJ5WxW.js +0 -1
  518. package/dist/docs/assets/chunks/@localSearchIndexroot.dUaE1f8e.js +0 -1
  519. package/dist/docs/assets/chunks/channel.ljJtQtBi.js +0 -1
  520. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BZ3Uc-XU.js +0 -1
  521. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BZ3Uc-XU.js +0 -1
  522. package/dist/docs/assets/chunks/clone.BDtbEo69.js +0 -1
  523. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CbhzVsQE.js +0 -1
  524. package/dist/docs/assets/chunks/wardley-RL74JXVD.BFIVMaoi.js +0 -162
  525. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
  526. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
  527. package/dist/playground/assets/index-D0-FHg1x.css +0 -1
  528. package/dist/playground/assets/index-D5SLKUy6.js +0 -62
  529. /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
  530. /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
@@ -0,0 +1,384 @@
1
+ # Microsoft Teams agents
2
+
3
+ A Teams agent wakes when someone @mentions it in a channel or group chat,
4
+ messages it in a personal chat, or posts in a channel it watches. It
5
+ answers in the same reply chain. `teamsChannel()` takes the same engagement options as
6
+ `slackChannel()`, so an agent that already runs in Slack can run in Teams
7
+ with the same shape of config.
8
+
9
+ The agent answers as an Azure Bot that you register and own. Teams sends
10
+ each message to the bot's messaging endpoint, and the channel checks the
11
+ Bot Framework token on every request before it starts a turn.
12
+
13
+ ## Set up with the CLI
14
+
15
+ The `agent-sdk channels teams` commands do every step except the clicks in
16
+ the Azure portal and in Teams:
17
+
18
+ ```bash
19
+ agent-sdk channels teams setup
20
+ printf %s "$CLIENT_SECRET" | agent-sdk channels teams init --dir ./helm \
21
+ --app-id <microsoft-app-id> --tenant-id <app-tenant-id>
22
+ agent-sdk channels teams package --dir ./helm
23
+ agent-sdk dev ./helm
24
+ agent-sdk channels teams doctor --dir ./helm --endpoint <printed URL>
25
+ ```
26
+
27
+ 1. `setup` prints the Azure portal steps in
28
+ [Register the Azure Bot](#register-the-azure-bot).
29
+ 2. `init` writes `bot/channels/teams.ts` and puts the app id, the client
30
+ secret, and the tenant id in `.env.local`. It reads the secret from a
31
+ hidden prompt or stdin, never from an argument.
32
+ 3. `package` writes `helm-teams-app.zip`. Upload it in Teams, as
33
+ [Install the bot in Teams](#install-the-bot-in-teams) describes.
34
+ 4. `dev` opens a tunnel and prints the messaging endpoint. Set it on the
35
+ Azure Bot.
36
+ 5. `doctor` checks the env names, the token, the Azure Bot, and the
37
+ endpoint, and names the part that fails.
38
+
39
+ The [CLI reference](/docs/reference/cli.md#teams) lists every flag. The rest of
40
+ this guide explains what the commands write and how the channel behaves.
41
+
42
+ ## Answer a mention or personal chat
43
+
44
+ ```ts
45
+ // bot/channels/teams.ts
46
+ import { teamsChannel } from "@grok/agent-sdk/channels/teams";
47
+
48
+ export default teamsChannel();
49
+ ```
50
+
51
+ By default the agent answers @mentions in channels and group chats, and
52
+ every message in a personal chat. While a turn runs, Teams shows the
53
+ typing indicator, and the reply arrives as one message in the reply chain.
54
+ In a channel, each reply chain is its own conversation. A personal chat
55
+ and a group chat have no reply chains, so each one is a single
56
+ conversation.
57
+
58
+ The channel reads three variables:
59
+
60
+ | Variable | Value |
61
+ | --- | --- |
62
+ | `TEAMS_APP_ID` | The Azure Bot's Microsoft App ID |
63
+ | `TEAMS_APP_PASSWORD` | A client secret of that app registration |
64
+ | `TEAMS_TENANT_ID` | Required. The home tenant of your single-tenant Azure Bot |
65
+
66
+ The Azure Bot is a single-tenant bot in your own tenant, because Azure
67
+ does not create new multi-tenant bots after July 31, 2025. The channel
68
+ mints its Bot Connector token in that tenant and ignores activities from
69
+ any other tenant. To run several
70
+ agents in one `agent-sdk dev`, give each its own bot and an `envPrefix`.
71
+ `channels teams init --prefix HELPDESK` writes it for you. The prefix
72
+ starts with a letter.
73
+
74
+ ```ts
75
+ export default teamsChannel({ envPrefix: "HELPDESK" });
76
+ // HELPDESK_TEAMS_APP_ID, HELPDESK_TEAMS_APP_PASSWORD, HELPDESK_TEAMS_TENANT_ID
77
+ ```
78
+
79
+ The channel file owns these names. When the file exists, `init` writes the
80
+ names it reads, and `doctor` and `package` read them from the loaded
81
+ channel.
82
+
83
+ ## Register the Azure Bot
84
+
85
+ 1. In the Azure portal, create an **Azure Bot** resource. Set **Type of
86
+ App** to **Single Tenant** and **Creation type** to **Create new
87
+ Microsoft App ID**.
88
+ 2. Open the bot's **Configuration** page. Copy **Microsoft App ID** and
89
+ **App Tenant ID**. `init` takes them as `--app-id` and `--tenant-id`.
90
+ 3. From **Configuration**, open **Manage Password**, add a client secret,
91
+ and copy its value. Azure shows the value once. `init` reads it from
92
+ the hidden prompt or stdin.
93
+ 4. Under **Channels**, add **Microsoft Teams**.
94
+ 5. Set **Messaging endpoint** to the URL in
95
+ [Messaging endpoint](#messaging-endpoint), or for a hosted deploy, the
96
+ URL in [Deploy](#deploy).
97
+
98
+ ## Install the bot in Teams
99
+
100
+ Teams installs a bot from an app package: a zip of `manifest.json` and two
101
+ icons. `agent-sdk channels teams package` builds it from the channel. The
102
+ `bots` entry names the Azure Bot by its app ID and the places people can
103
+ talk to it:
104
+
105
+ ```json
106
+ {
107
+ "id": "<TEAMS_APP_ID>",
108
+ "bots": [
109
+ {
110
+ "botId": "<TEAMS_APP_ID>",
111
+ "scopes": ["personal", "team", "groupChat"],
112
+ "isNotificationOnly": false
113
+ }
114
+ ]
115
+ }
116
+ ```
117
+
118
+ A full manifest also needs `manifestVersion`, `version`, `developer`,
119
+ `name`, `description`, `icons`, and `accentColor`; see the
120
+ [app manifest schema](https://learn.microsoft.com/microsoftteams/platform/resources/schema/manifest-schema).
121
+ Upload the package in Teams under **Apps** > **Manage your apps** >
122
+ **Upload an app**, or have a Teams admin publish it to your organization
123
+ in the Teams admin center. Then add the app to a team, a group chat, or a
124
+ personal chat.
125
+
126
+ ## Wake on a channel post
127
+
128
+ Teams sends a channel post without a mention only to an app that holds
129
+ the resource-specific consent permission `ChannelMessage.Read.Group`.
130
+ `package` adds it when the channel sets `engagement.channelPosts`, and a
131
+ team owner grants it when they add the app to the team:
132
+
133
+ ```json
134
+ {
135
+ "webApplicationInfo": { "id": "<TEAMS_APP_ID>" },
136
+ "authorization": {
137
+ "permissions": {
138
+ "resourceSpecific": [{ "name": "ChannelMessage.Read.Group", "type": "Application" }]
139
+ }
140
+ }
141
+ }
142
+ ```
143
+
144
+ Then name the channels to watch. Copy a channel's ID from its **Get link
145
+ to channel** URL: it's the `19:…@thread.tacv2` part.
146
+
147
+ ```ts
148
+ export default teamsChannel({
149
+ engagement: {
150
+ channelPosts: {
151
+ allow: ["19:4b7c2f9e1d6a4e8f9a3b5c7d1e2f3a4b@thread.tacv2"],
152
+ posts: "all",
153
+ },
154
+ },
155
+ });
156
+ ```
157
+
158
+ Watched posts go to `onChannelPost` when you set it, the same way
159
+ mentions go to `onAppMention` and personal chats to `onDirectMessage`.
160
+ Return `null` from a hook to skip a message. `posts` is `"top-level"` (the
161
+ default), `"replies"`, or `"all"`. Use
162
+ `allow: ["*"]` to watch every channel the app is in, and
163
+ `replies: "joined"` to also answer replies in any reply chain the agent
164
+ already answered. Bot posts stay out unless you set `includeBotPosts: true`;
165
+ the agent's own posts never start a turn.
166
+
167
+ To let another bot wake the agent with an @mention, list it in
168
+ `engagement.botMentions.allowFrom` as `28:<its app ID>`. Each thread allows
169
+ 5 bot wakes an hour and 20 in total by default
170
+ (`maxPerThreadPerHour`, `maxPerThreadTotal`).
171
+
172
+ ## Stream the reply
173
+
174
+ ```ts
175
+ export default teamsChannel({ reply: { mode: "stream" } });
176
+ ```
177
+
178
+ In stream mode the agent posts one message as soon as it starts working.
179
+ That message names the tool the agent is running until text arrives, then
180
+ fills in as the reply grows, and it ends as the final answer. Teams limits
181
+ how often a bot can edit a message, so the channel edits at most once
182
+ every 1.5 seconds; set `updateIntervalMs` to change that.
183
+
184
+ ## Approve tool calls in Teams
185
+
186
+ ```ts
187
+ export default teamsChannel({ toolApprovals: true });
188
+ ```
189
+
190
+ When a server tool with `needsApproval` is about to run, the agent posts
191
+ an Adaptive Card in the thread with the tool's arguments, secrets
192
+ redacted, and **Approve** and **Deny** buttons. Anyone who could continue
193
+ the conversation can decide; set `policy: { respondTo: "author" }` to
194
+ limit that, and follow-ups, to the person who started it. After the click,
195
+ the card shows the decision and who made it.
196
+
197
+ For your own cards, handle other `Action.Submit` clicks in
198
+ `onCardAction`, which receives the submitted data and can start a turn in
199
+ the card's thread.
200
+
201
+ ## Refuse guests and other tenants
202
+
203
+ By default the channel answers only members and owners of the bot's
204
+ tenant. It asks Teams for the sender's role and tenant. It refuses a
205
+ guest, an anonymous meeting user, or a person from another organization.
206
+ This applies when they message the agent and when they click a card.
207
+ **Approve** and **Deny** are card clicks. A sender with no role is
208
+ refused. A sender Teams does not list is refused too.
209
+
210
+ The agent posts one short reply to a refused sender. It posts at most
211
+ once per conversation and sender per hour. The default text is "I can
212
+ only help members of this organization. Ask the agent owner to allow
213
+ guests."
214
+
215
+ Set `policy.refusalMessage` to change the default text. Set
216
+ `policy.refusalMessage` to `false` to stay silent. Silence applies to a
217
+ refused sender and to a sender the lookup could not verify.
218
+
219
+ A failed lookup gets the reply "I couldn't verify your access, try again
220
+ shortly." The agent does not reply to a card click from a refused sender.
221
+ The agent ignores a card click from a bot, including a bot that
222
+ `engagement.botMentions` allows. The agent does not reply to an activity
223
+ from another tenant.
224
+
225
+ To let guests and external members in, set `blockExternals` to `false`.
226
+
227
+ ```ts
228
+ export default teamsChannel({ policy: { blockExternals: false } });
229
+ ```
230
+
231
+ ```ts
232
+ export default teamsChannel({
233
+ policy: {
234
+ refusalMessage: "Ask your team owner to add you to this organization.",
235
+ },
236
+ });
237
+ ```
238
+
239
+ ## Welcome message
240
+
241
+ When someone installs the app in a conversation, the agent posts one
242
+ greeting there. Teams reports the install as an `installationUpdate`
243
+ activity whose action is `add`. The greeting does not start a model turn.
244
+ The agent posts it once per conversation.
245
+
246
+ The default text is "Hi! Mention me in a channel, or message me here, to
247
+ get started."
248
+
249
+ Set `welcome` to change the greeting. Set `welcome` to `false` to turn
250
+ it off.
251
+
252
+ ```ts
253
+ export default teamsChannel({
254
+ welcome: "Hi. Mention me when you want help with a laptop.",
255
+ });
256
+ ```
257
+
258
+ ## Messaging endpoint
259
+
260
+ Under `agent-sdk dev` or self-hosted `agent-sdk serve`, the Azure Bot's
261
+ messaging endpoint is the server's public origin plus the channel's path:
262
+
263
+ ```text
264
+ https://<origin>/<slug>/v1/channels/<channel>
265
+ ```
266
+
267
+ `<slug>` is the agent's slug and `<channel>` is the channel file's name, so
268
+ `bot/channels/teams.ts` in the `helm` agent answers at
269
+ `https://<origin>/helm/v1/channels/teams`. The URL has no trailing slash.
270
+ With `teamsChannel({ path: "/messages" })`, the channel appends that path:
271
+ `https://<origin>/helm/v1/channels/teams/messages`. A hosted deploy has a
272
+ different URL; see [Deploy](#deploy).
273
+
274
+ ## Test locally
275
+
276
+ Teams reaches the bot only at a public HTTPS URL. `agent-sdk dev` opens a
277
+ `cloudflared` tunnel and prints the messaging endpoint on the tunnel's
278
+ origin:
279
+
280
+ ```bash
281
+ agent-sdk dev ./helm
282
+ ```
283
+
284
+ Copy the printed URL into the Azure Bot's **Messaging endpoint**, then
285
+ mention the bot in Teams. `--tunnel devtunnel` keeps one URL across
286
+ restarts. Next to a plain `agent-sdk serve`, `agent-sdk channels teams
287
+ forward` opens the same tunnel. `agent-sdk dev --mode single` serves one agent
288
+ without a slug, so its endpoint is `https://<origin>/v1/channels/teams`.
289
+ Without `--mode single`, the endpoint includes the agent's slug:
290
+ `https://<origin>/helm/v1/channels/teams`.
291
+
292
+ To run your own tunnel instead, serve with plain `agent-sdk serve`, which
293
+ opens no tunnel, and point `cloudflared` at its port:
294
+
295
+ ```bash
296
+ agent-sdk serve --dir ./helm --mode single --port 3978
297
+ cloudflared tunnel --url http://localhost:3978
298
+ ```
299
+
300
+ Add `--protocol http2` to `cloudflared` if your network blocks QUIC. Set the
301
+ Azure Bot's **Messaging endpoint** to the printed `<public-url>` plus
302
+ `/v1/channels/teams`, or `<public-url>/helm/v1/channels/teams` without
303
+ `--mode single`. The built-in tunnel forwards only `POST` requests to the
304
+ Teams messaging paths. A tunnel you run yourself exposes every route on the
305
+ port.
306
+
307
+ Requests through a tunnel always get the Bot Framework token check, so only
308
+ Teams can start turns there. A tunnel adds proxy headers or forwards its
309
+ public hostname, and the dev exception for unsigned activities refuses both.
310
+ To replay a saved activity without Teams, POST it to the same path on
311
+ `http://127.0.0.1:<port>` from the same machine; `agent-sdk dev` admits
312
+ unsigned activities from loopback only.
313
+
314
+ ## Deploy
315
+
316
+ Hosted, the agent needs its three secrets:
317
+
318
+ ```ts
319
+ // bot/agent.ts
320
+ import { defineAgent } from "@grok/agent-sdk";
321
+
322
+ export default defineAgent({
323
+ hosting: {
324
+ secretNames: ["TEAMS_APP_ID", "TEAMS_APP_PASSWORD", "TEAMS_TENANT_ID"],
325
+ },
326
+ });
327
+ ```
328
+
329
+ Hosting adds the Microsoft hosts that a Teams channel calls
330
+ (`login.microsoftonline.com`, `login.botframework.com`, and
331
+ `smba.trafficmanager.net`), so you do not list them in `egressDomains`.
332
+ Your team's network settings still apply to them. If your team restricts
333
+ egress, its allowlist must include all three hosts, or the agent's replies
334
+ fail.
335
+
336
+ An `envPrefix` changes the secret names. With
337
+ `teamsChannel({ envPrefix: "ECHO" })`, list `ECHO_TEAMS_APP_ID`,
338
+ `ECHO_TEAMS_APP_PASSWORD`, and `ECHO_TEAMS_TENANT_ID` in `secretNames`, and
339
+ set those names with `agent-sdk secret set`.
340
+
341
+ ```bash
342
+ agent-sdk deploy --dir . --slug helpdesk
343
+ agent-sdk secret set helpdesk TEAMS_APP_ID
344
+ agent-sdk secret set helpdesk TEAMS_APP_PASSWORD
345
+ agent-sdk secret set helpdesk TEAMS_TENANT_ID
346
+ ```
347
+
348
+ `agent-sdk deploy` prints the hosted messaging endpoint on a `public:`
349
+ line that ends in `/v1/channels/teams`. Set the Azure Bot's **Messaging
350
+ endpoint** to that URL, not to the slug URL from local testing. With a
351
+ custom `path`, add it after the printed URL.
352
+
353
+ On hosting, Cursor checks the Bot Framework token and the tenant before
354
+ the agent starts. Activities that the channel cannot act on, such as a
355
+ reaction or an unmentioned post outside `channelPosts`, stop there and
356
+ use no compute. Each personal or group chat is one session, and each
357
+ channel reply chain is one session. Tool approvals work on hosting: an
358
+ Approve or Deny click reaches the turn that waits for it, and a call that
359
+ nobody approves in 10 minutes is denied.
360
+
361
+ Hosting runs Teams channels only in the commercial Microsoft cloud, and
362
+ only for teams that have Teams channels turned on. The deploy fails
363
+ otherwise.
364
+
365
+ ## How Teams differs from Slack
366
+
367
+ | | Slack | Teams |
368
+ | --- | --- | --- |
369
+ | App | Your Slack app's bot and app tokens | Your Azure Bot's app ID, client secret, and tenant |
370
+ | Local transport | Socket Mode, no public URL | `agent-sdk dev` opens a tunnel to the messaging endpoint |
371
+ | Watch channel posts | `message.channels` subscription | `ChannelMessage.Read.Group` consent at install |
372
+ | Threads | Every message can start a thread | Reply chains in channels; personal and group chats are one conversation each |
373
+ | Bot-to-bot wakes | `maxDepth` from message metadata, plus per-thread caps | Per-thread caps only |
374
+ | Progress | Status chip, streaming API, tool and reasoning cards | Typing indicator, or one edited message in stream mode |
375
+ | Approvals | Block Kit buttons | Adaptive Card buttons |
376
+ | Hosted sessions | One per thread | One per chat, or one per channel reply chain |
377
+ | Not available in Teams | | Reactions, file uploads and downloads, suggested prompts, `eval` commands, edit debounce |
378
+
379
+ ## Related
380
+
381
+ - [Slack](/docs/guides/slack.md)
382
+ - [Webhooks](/docs/guides/webhooks.md)
383
+ - [Deployment](/docs/deployment.md)
384
+ - [Channels reference](/docs/reference/channels.md)