@grok/agent-sdk 0.6.0 → 0.7.1

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 (550) hide show
  1. package/AGENTS.md +40 -0
  2. package/dist/channels/github/cursor-account.d.ts +1 -0
  3. package/dist/channels/github/cursor-account.d.ts.map +1 -1
  4. package/dist/channels/github/cursor-account.js +8 -2
  5. package/dist/channels/github/forward.d.ts +5 -0
  6. package/dist/channels/github/forward.d.ts.map +1 -1
  7. package/dist/channels/github/forward.js +6 -3
  8. package/dist/channels/origin/cursor-account.d.ts +6 -0
  9. package/dist/channels/origin/cursor-account.d.ts.map +1 -1
  10. package/dist/channels/origin/cursor-account.js +17 -0
  11. package/dist/channels/slack/api.d.ts +18 -0
  12. package/dist/channels/slack/api.d.ts.map +1 -1
  13. package/dist/channels/slack/api.js +31 -0
  14. package/dist/channels/slack/approvals.d.ts +19 -2
  15. package/dist/channels/slack/approvals.d.ts.map +1 -1
  16. package/dist/channels/slack/approvals.js +90 -19
  17. package/dist/channels/slack/attachments.d.ts +7 -2
  18. package/dist/channels/slack/attachments.d.ts.map +1 -1
  19. package/dist/channels/slack/attachments.js +318 -156
  20. package/dist/channels/slack/connect-card.d.ts +16 -0
  21. package/dist/channels/slack/connect-card.d.ts.map +1 -0
  22. package/dist/channels/slack/connect-card.js +31 -0
  23. package/dist/channels/slack/credentials.d.ts +10 -2
  24. package/dist/channels/slack/credentials.d.ts.map +1 -1
  25. package/dist/channels/slack/credentials.js +17 -15
  26. package/dist/channels/slack/defaults.d.ts.map +1 -1
  27. package/dist/channels/slack/defaults.js +18 -9
  28. package/dist/channels/slack/dispatch.d.ts +1 -1
  29. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  30. package/dist/channels/slack/dispatch.js +19 -3
  31. package/dist/channels/slack/inbound.d.ts +8 -2
  32. package/dist/channels/slack/inbound.d.ts.map +1 -1
  33. package/dist/channels/slack/inbound.js +25 -4
  34. package/dist/channels/slack/index.d.ts +3 -2
  35. package/dist/channels/slack/index.d.ts.map +1 -1
  36. package/dist/channels/slack/index.js +3 -2
  37. package/dist/channels/slack/init.d.ts.map +1 -1
  38. package/dist/channels/slack/init.js +2 -1
  39. package/dist/channels/slack/mentions.d.ts +28 -0
  40. package/dist/channels/slack/mentions.d.ts.map +1 -0
  41. package/dist/channels/slack/mentions.js +178 -0
  42. package/dist/channels/slack/setup.js +1 -1
  43. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  44. package/dist/channels/slack/slack-channel.js +46 -3
  45. package/dist/channels/slack/stop.d.ts.map +1 -1
  46. package/dist/channels/slack/stop.js +7 -1
  47. package/dist/channels/slack/thread-context.d.ts +3 -0
  48. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  49. package/dist/channels/slack/thread-context.js +17 -7
  50. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
  51. package/dist/channels/slack/tool-approval-events.js +55 -2
  52. package/dist/channels/slack/types.d.ts +2 -0
  53. package/dist/channels/slack/types.d.ts.map +1 -1
  54. package/dist/channels/teams/activity.d.ts +33 -0
  55. package/dist/channels/teams/activity.d.ts.map +1 -0
  56. package/dist/channels/teams/activity.js +213 -0
  57. package/dist/channels/teams/auth.d.ts +25 -0
  58. package/dist/channels/teams/auth.d.ts.map +1 -0
  59. package/dist/channels/teams/auth.js +55 -0
  60. package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
  61. package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
  62. package/dist/channels/teams/bot-framework-auth.js +154 -0
  63. package/dist/channels/teams/cards.d.ts +23 -0
  64. package/dist/channels/teams/cards.d.ts.map +1 -0
  65. package/dist/channels/teams/cards.js +107 -0
  66. package/dist/channels/teams/connector.d.ts +48 -0
  67. package/dist/channels/teams/connector.d.ts.map +1 -0
  68. package/dist/channels/teams/connector.js +159 -0
  69. package/dist/channels/teams/credentials.d.ts +65 -0
  70. package/dist/channels/teams/credentials.d.ts.map +1 -0
  71. package/dist/channels/teams/credentials.js +84 -0
  72. package/dist/channels/teams/delivery.d.ts +14 -0
  73. package/dist/channels/teams/delivery.d.ts.map +1 -0
  74. package/dist/channels/teams/delivery.js +169 -0
  75. package/dist/channels/teams/dispatch.d.ts +45 -0
  76. package/dist/channels/teams/dispatch.d.ts.map +1 -0
  77. package/dist/channels/teams/dispatch.js +402 -0
  78. package/dist/channels/teams/engagement.d.ts +32 -0
  79. package/dist/channels/teams/engagement.d.ts.map +1 -0
  80. package/dist/channels/teams/engagement.js +120 -0
  81. package/dist/channels/teams/index.d.ts +21 -0
  82. package/dist/channels/teams/index.d.ts.map +1 -0
  83. package/dist/channels/teams/index.js +19 -0
  84. package/dist/channels/teams/marks.d.ts +19 -0
  85. package/dist/channels/teams/marks.d.ts.map +1 -0
  86. package/dist/channels/teams/marks.js +96 -0
  87. package/dist/channels/teams/senders.d.ts +27 -0
  88. package/dist/channels/teams/senders.d.ts.map +1 -0
  89. package/dist/channels/teams/senders.js +72 -0
  90. package/dist/channels/teams/teams-channel.d.ts +43 -0
  91. package/dist/channels/teams/teams-channel.d.ts.map +1 -0
  92. package/dist/channels/teams/teams-channel.js +278 -0
  93. package/dist/channels/teams/text.d.ts +7 -0
  94. package/dist/channels/teams/text.d.ts.map +1 -0
  95. package/dist/channels/teams/text.js +63 -0
  96. package/dist/channels/teams/types.d.ts +306 -0
  97. package/dist/channels/teams/types.d.ts.map +1 -0
  98. package/dist/channels/teams/types.js +1 -0
  99. package/dist/channels.d.ts +31 -0
  100. package/dist/channels.d.ts.map +1 -1
  101. package/dist/channels.js +37 -0
  102. package/dist/connections.d.ts +1 -1
  103. package/dist/connections.d.ts.map +1 -1
  104. package/dist/docs/404.html +3 -3
  105. package/dist/docs/assets/{app.lt-BYgI2.js → app.CpLKJnOA.js} +4 -4
  106. package/dist/docs/assets/changelog.md.DoOgjnPC.js +1 -0
  107. package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.DoOgjnPC.lean.js} +1 -1
  108. package/dist/docs/assets/chunks/@localSearchIndexroot.BJ_1eI6D.js +1 -0
  109. package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.Cr1HJ_9k.js} +2 -2
  110. package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BjpgGAMM.js} +1 -1
  111. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.CKdhNPPk.js} +1 -1
  112. package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.iovoEQbg.js} +1 -1
  113. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BYQIeDre.js} +1 -1
  114. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY.gbWi2q8N.js} +1 -1
  115. package/dist/docs/assets/chunks/channel.BP0n324b.js +1 -0
  116. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.1Mem4UG9.js} +1 -1
  117. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.Dn3H-X_H.js} +1 -1
  118. package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.BkpSDZwX.js} +1 -1
  119. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.BScqy1zP.js} +1 -1
  120. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.Cp394LWf.js} +1 -1
  121. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.BDv9LhoL.js} +1 -1
  122. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.CsgCcrKO.js} +1 -1
  123. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.BKBpIC5O.js} +1 -1
  124. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BhTtyWMA.js +1 -0
  125. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BhTtyWMA.js +1 -0
  126. package/dist/docs/assets/chunks/clone.BVK2rFqj.js +1 -0
  127. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.Bs3ZS9PC.js} +1 -1
  128. package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.CgWi0tY2.js} +1 -1
  129. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.rn6qIo9N.js} +1 -1
  130. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.ChhW8oww.js} +1 -1
  131. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.C0wH5KSk.js} +1 -1
  132. package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.CNEcrwA0.js} +1 -1
  133. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DCsnKO-7.js} +1 -1
  134. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.WCMkfvP0.js} +1 -1
  135. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.BUb1Sxfr.js} +1 -1
  136. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF._kORbCzm.js} +1 -1
  137. package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.PrGRm4KW.js} +1 -1
  138. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.BxhCjiQM.js} +1 -1
  139. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.5ddTis2y.js} +1 -1
  140. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BUStU27-.js} +1 -1
  141. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.CJd1psl3.js} +1 -1
  142. package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DqvbZSML.js} +1 -1
  143. package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.DOmz-1UB.js} +1 -1
  144. package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.33k2v8dM.js} +1 -1
  145. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.iISCqCXC.js} +1 -1
  146. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.BHvVgzmD.js} +1 -1
  147. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.CY3w_-Cn.js} +1 -1
  148. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.CHXKQS1v.js} +1 -1
  149. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.DTtRoGss.js} +1 -1
  150. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.NnPcQ3eY.js} +1 -1
  151. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.D8DFciH7.js} +1 -1
  152. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ESAwmMws.js +1 -0
  153. package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.CwkiT-Fo.js} +2 -2
  154. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ._wIWkMU6.js} +1 -1
  155. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.NLVv7R6r.js} +1 -1
  156. package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DbsCXUZp.js} +1 -1
  157. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.Dp5uAVDl.js} +1 -1
  158. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.eOEBq4rX.js} +1 -1
  159. package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.CIRydNl3.js} +3 -3
  160. package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.CIRydNl3.lean.js} +1 -1
  161. package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
  162. package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
  163. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
  164. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
  165. package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.js +82 -0
  166. package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.lean.js +1 -0
  167. package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.js → reference_agent-config.md.CfM1S6Ac.js} +2 -2
  168. package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.lean.js → reference_agent-config.md.CfM1S6Ac.lean.js} +1 -1
  169. package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
  170. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
  171. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
  172. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
  173. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
  174. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  175. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
  176. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
  177. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
  178. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
  179. package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
  180. package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
  181. package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
  182. package/dist/docs/building-with-agents.html +37 -37
  183. package/dist/docs/changelog.html +37 -37
  184. package/dist/docs/changelog.md +43 -0
  185. package/dist/docs/deployment.html +40 -40
  186. package/dist/docs/deployment.md +14 -0
  187. package/dist/docs/evals.html +37 -37
  188. package/dist/docs/guides/agent-to-agent.html +37 -37
  189. package/dist/docs/guides/bitbucket.html +37 -37
  190. package/dist/docs/guides/cloud-agents.html +43 -38
  191. package/dist/docs/guides/cloud-agents.md +47 -0
  192. package/dist/docs/guides/convert-automation.html +37 -37
  193. package/dist/docs/guides/github.html +37 -37
  194. package/dist/docs/guides/gitlab.html +37 -37
  195. package/dist/docs/guides/improve.html +37 -37
  196. package/dist/docs/guides/jev.html +37 -37
  197. package/dist/docs/guides/mcp-oauth.html +37 -37
  198. package/dist/docs/guides/migrate.html +37 -37
  199. package/dist/docs/guides/opentelemetry.html +37 -37
  200. package/dist/docs/guides/pagerduty.html +37 -37
  201. package/dist/docs/guides/slack.html +37 -37
  202. package/dist/docs/guides/teams.html +109 -0
  203. package/dist/docs/guides/teams.md +384 -0
  204. package/dist/docs/guides/webhooks.html +37 -37
  205. package/dist/docs/guides/workload-identity.html +141 -0
  206. package/dist/docs/guides/workload-identity.md +227 -0
  207. package/dist/docs/hashmap.json +1 -1
  208. package/dist/docs/hillclimbing.html +37 -37
  209. package/dist/docs/index.html +37 -37
  210. package/dist/docs/llms-full.txt +881 -5
  211. package/dist/docs/llms.txt +2 -0
  212. package/dist/docs/quickstart.html +37 -37
  213. package/dist/docs/reference/access.html +36 -36
  214. package/dist/docs/reference/agent-config.html +39 -39
  215. package/dist/docs/reference/agent-config.md +1 -1
  216. package/dist/docs/reference/artifacts.html +37 -37
  217. package/dist/docs/reference/channels.html +38 -38
  218. package/dist/docs/reference/channels.md +1 -0
  219. package/dist/docs/reference/cli.html +50 -40
  220. package/dist/docs/reference/cli.md +116 -0
  221. package/dist/docs/reference/connections.html +37 -37
  222. package/dist/docs/reference/evals.html +37 -37
  223. package/dist/docs/reference/extensions.html +37 -37
  224. package/dist/docs/reference/hooks.html +37 -37
  225. package/dist/docs/reference/http-api.html +37 -37
  226. package/dist/docs/reference/instructions.html +37 -37
  227. package/dist/docs/reference/limits.html +39 -39
  228. package/dist/docs/reference/limits.md +4 -4
  229. package/dist/docs/reference/memory.html +37 -37
  230. package/dist/docs/reference/playground.html +36 -36
  231. package/dist/docs/reference/project-layout.html +37 -37
  232. package/dist/docs/reference/schedules.html +40 -40
  233. package/dist/docs/reference/sessions.html +38 -38
  234. package/dist/docs/reference/sessions.md +13 -0
  235. package/dist/docs/reference/skills.html +40 -40
  236. package/dist/docs/reference/subagents.html +37 -37
  237. package/dist/docs/reference/tools.html +37 -37
  238. package/dist/docs/templates/agentic-owners.html +37 -37
  239. package/dist/docs/templates/reviews.html +37 -37
  240. package/dist/docs/troubleshooting.html +38 -38
  241. package/dist/docs/troubleshooting.md +21 -0
  242. package/dist/evals/run-facts.d.ts.map +1 -1
  243. package/dist/evals/run-facts.js +4 -0
  244. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
  245. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
  246. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
  247. package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
  248. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  249. package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
  250. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
  251. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
  252. package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
  253. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
  254. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  255. package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
  256. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
  257. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
  258. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
  259. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
  260. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
  261. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
  262. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
  263. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
  264. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
  265. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
  266. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
  267. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
  268. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
  269. package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
  270. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
  271. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
  272. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
  273. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
  274. package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
  275. package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
  276. package/dist/extensions.d.ts.map +1 -1
  277. package/dist/extensions.js +18 -3
  278. package/dist/files-backends/agent-store-presigned-url.js +5 -1
  279. package/dist/index.d.ts +1 -0
  280. package/dist/index.d.ts.map +1 -1
  281. package/dist/index.js +1 -0
  282. package/dist/internal/approval-gate.d.ts +6 -1
  283. package/dist/internal/approval-gate.d.ts.map +1 -1
  284. package/dist/internal/approval-gate.js +13 -2
  285. package/dist/internal/authored-loaders.js +1 -1
  286. package/dist/internal/channel-architecture.d.ts.map +1 -1
  287. package/dist/internal/channel-architecture.js +3 -1
  288. package/dist/internal/cli/commands/channels.d.ts +9 -3
  289. package/dist/internal/cli/commands/channels.d.ts.map +1 -1
  290. package/dist/internal/cli/commands/channels.js +193 -4
  291. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  292. package/dist/internal/cli/commands/index.js +6 -1
  293. package/dist/internal/cli/commands/serve.d.ts.map +1 -1
  294. package/dist/internal/cli/commands/serve.js +25 -5
  295. package/dist/internal/cli/dispatch.d.ts.map +1 -1
  296. package/dist/internal/cli/dispatch.js +22 -8
  297. package/dist/internal/cli/flags.d.ts +14 -0
  298. package/dist/internal/cli/flags.d.ts.map +1 -1
  299. package/dist/internal/cli/flags.js +14 -0
  300. package/dist/internal/cli/help.d.ts.map +1 -1
  301. package/dist/internal/cli/help.js +3 -1
  302. package/dist/internal/cli-ax.d.ts.map +1 -1
  303. package/dist/internal/cli-ax.js +6 -3
  304. package/dist/internal/cli-cursor.js +2 -2
  305. package/dist/internal/cli-deploy.d.ts +1 -0
  306. package/dist/internal/cli-deploy.d.ts.map +1 -1
  307. package/dist/internal/cli-deploy.js +19 -1
  308. package/dist/internal/cli-mcp.d.ts.map +1 -1
  309. package/dist/internal/cli-mcp.js +5 -3
  310. package/dist/internal/cli-teams-doctor.d.ts +39 -0
  311. package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
  312. package/dist/internal/cli-teams-doctor.js +508 -0
  313. package/dist/internal/cli-teams-forward.d.ts +84 -0
  314. package/dist/internal/cli-teams-forward.d.ts.map +1 -0
  315. package/dist/internal/cli-teams-forward.js +386 -0
  316. package/dist/internal/cli-teams-package.d.ts +26 -0
  317. package/dist/internal/cli-teams-package.d.ts.map +1 -0
  318. package/dist/internal/cli-teams-package.js +123 -0
  319. package/dist/internal/cli-teams.d.ts +15 -0
  320. package/dist/internal/cli-teams.d.ts.map +1 -0
  321. package/dist/internal/cli-teams.js +253 -0
  322. package/dist/internal/connect-click.d.ts +12 -0
  323. package/dist/internal/connect-click.d.ts.map +1 -0
  324. package/dist/internal/connect-click.js +22 -0
  325. package/dist/internal/continuation-channel.d.ts +5 -1
  326. package/dist/internal/continuation-channel.d.ts.map +1 -1
  327. package/dist/internal/continuation-channel.js +34 -0
  328. package/dist/internal/continuation-identity.d.ts +7 -4
  329. package/dist/internal/continuation-identity.d.ts.map +1 -1
  330. package/dist/internal/continuation-identity.js +66 -1
  331. package/dist/internal/convert-automation/convert-workflow.js +2 -2
  332. package/dist/internal/credential-env-names.d.ts +36 -0
  333. package/dist/internal/credential-env-names.d.ts.map +1 -0
  334. package/dist/internal/credential-env-names.js +68 -0
  335. package/dist/internal/cursor/account-mcp.d.ts +67 -9
  336. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  337. package/dist/internal/cursor/account-mcp.js +206 -25
  338. package/dist/internal/cursor/backend-client.d.ts +10 -1
  339. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  340. package/dist/internal/cursor/backend-client.js +19 -7
  341. package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
  342. package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
  343. package/dist/internal/cursor/cloud-agent-identity.js +224 -0
  344. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  345. package/dist/internal/cursor/credentials.js +3 -1
  346. package/dist/internal/cursor-account-mcp-auth.d.ts +8 -1
  347. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  348. package/dist/internal/cursor-account-mcp-auth.js +22 -6
  349. package/dist/internal/deploy-client.d.ts.map +1 -1
  350. package/dist/internal/deploy-client.js +34 -2
  351. package/dist/internal/deploy-manifest.d.ts +51 -3
  352. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  353. package/dist/internal/deploy-manifest.js +96 -7
  354. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  355. package/dist/internal/discovery/agent-config.js +6 -1
  356. package/dist/internal/discovery/agent.d.ts.map +1 -1
  357. package/dist/internal/discovery/agent.js +2 -1
  358. package/dist/internal/discovery/connections.d.ts +5 -0
  359. package/dist/internal/discovery/connections.d.ts.map +1 -1
  360. package/dist/internal/discovery/connections.js +71 -1
  361. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  362. package/dist/internal/discovery/extensions.js +2 -0
  363. package/dist/internal/discovery/info.d.ts.map +1 -1
  364. package/dist/internal/discovery/info.js +4 -0
  365. package/dist/internal/env-file.d.ts +1 -0
  366. package/dist/internal/env-file.d.ts.map +1 -1
  367. package/dist/internal/env-file.js +18 -17
  368. package/dist/internal/env-prefix.d.ts +11 -0
  369. package/dist/internal/env-prefix.d.ts.map +1 -0
  370. package/dist/internal/env-prefix.js +23 -0
  371. package/dist/internal/event-id-dedupe.d.ts +12 -0
  372. package/dist/internal/event-id-dedupe.d.ts.map +1 -0
  373. package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
  374. package/dist/internal/event-mapper.d.ts +7 -2
  375. package/dist/internal/event-mapper.d.ts.map +1 -1
  376. package/dist/internal/event-mapper.js +7 -0
  377. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  378. package/dist/internal/expected-delivery-failure.js +3 -0
  379. package/dist/internal/extension-namespace.d.ts +9 -0
  380. package/dist/internal/extension-namespace.d.ts.map +1 -0
  381. package/dist/internal/extension-namespace.js +14 -0
  382. package/dist/internal/guid.d.ts +2 -0
  383. package/dist/internal/guid.d.ts.map +1 -0
  384. package/dist/internal/guid.js +4 -0
  385. package/dist/internal/host-kv-cas.d.ts +13 -0
  386. package/dist/internal/host-kv-cas.d.ts.map +1 -0
  387. package/dist/internal/host-kv-cas.js +26 -0
  388. package/dist/internal/host-kv.d.ts +4 -1
  389. package/dist/internal/host-kv.d.ts.map +1 -1
  390. package/dist/internal/host-kv.js +15 -2
  391. package/dist/internal/hosted-catch-protocol.d.ts +5 -0
  392. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  393. package/dist/internal/hosted-catch-protocol.js +5 -0
  394. package/dist/internal/hosted-catch.d.ts +2 -0
  395. package/dist/internal/hosted-catch.d.ts.map +1 -1
  396. package/dist/internal/hosted-catch.js +6 -1
  397. package/dist/internal/hosted-delivery-protocol.d.ts +4 -0
  398. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  399. package/dist/internal/hosted-delivery-protocol.js +73 -3
  400. package/dist/internal/hosted-delivery.d.ts +9 -3
  401. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  402. package/dist/internal/hosted-delivery.js +14 -3
  403. package/dist/internal/hosted-session-fixture.js +1 -1
  404. package/dist/internal/hosting.d.ts +5 -0
  405. package/dist/internal/hosting.d.ts.map +1 -1
  406. package/dist/internal/hosting.js +7 -1
  407. package/dist/internal/ids.d.ts +2 -0
  408. package/dist/internal/ids.d.ts.map +1 -1
  409. package/dist/internal/ids.js +5 -0
  410. package/dist/internal/install-cursor-skills.d.ts +6 -7
  411. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  412. package/dist/internal/install-cursor-skills.js +15 -9
  413. package/dist/internal/interview/agent-questions.d.ts +1 -1
  414. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  415. package/dist/internal/interview/agent-questions.js +4 -3
  416. package/dist/internal/local-control-plane.d.ts.map +1 -1
  417. package/dist/internal/local-control-plane.js +24 -0
  418. package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
  419. package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
  420. package/dist/internal/mcp-allowlist-in-use.js +93 -0
  421. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  422. package/dist/internal/mcp-endpoint.js +8 -10
  423. package/dist/internal/mcp-host.d.ts +19 -1
  424. package/dist/internal/mcp-host.d.ts.map +1 -1
  425. package/dist/internal/mcp-host.js +67 -3
  426. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  427. package/dist/internal/mcp-oauth.js +5 -7
  428. package/dist/internal/oidcAudiences.d.ts +22 -0
  429. package/dist/internal/oidcAudiences.d.ts.map +1 -0
  430. package/dist/internal/oidcAudiences.js +35 -0
  431. package/dist/internal/otel/collector.d.ts.map +1 -1
  432. package/dist/internal/otel/collector.js +2 -0
  433. package/dist/internal/platform-timers.d.ts +2 -0
  434. package/dist/internal/platform-timers.d.ts.map +1 -1
  435. package/dist/internal/platform-timers.js +14 -0
  436. package/dist/internal/private-file.d.ts +32 -1
  437. package/dist/internal/private-file.d.ts.map +1 -1
  438. package/dist/internal/private-file.js +209 -7
  439. package/dist/internal/redact-values.d.ts +3 -0
  440. package/dist/internal/redact-values.d.ts.map +1 -0
  441. package/dist/internal/redact-values.js +19 -0
  442. package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
  443. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  444. package/dist/internal/reminder-followup-error.d.ts +23 -0
  445. package/dist/internal/reminder-followup-error.d.ts.map +1 -0
  446. package/dist/internal/reminder-followup-error.js +12 -0
  447. package/dist/internal/reminder-runner.d.ts +15 -1
  448. package/dist/internal/reminder-runner.d.ts.map +1 -1
  449. package/dist/internal/reminder-runner.js +95 -21
  450. package/dist/internal/resolved-connections.d.ts.map +1 -1
  451. package/dist/internal/resolved-connections.js +23 -3
  452. package/dist/internal/run-client.js +2 -1
  453. package/dist/internal/run-program.d.ts +31 -0
  454. package/dist/internal/run-program.d.ts.map +1 -0
  455. package/dist/internal/run-program.js +150 -0
  456. package/dist/internal/schedule-runner.d.ts +1 -0
  457. package/dist/internal/schedule-runner.d.ts.map +1 -1
  458. package/dist/internal/schedule-runner.js +10 -1
  459. package/dist/internal/sdk-runner.d.ts +28 -2
  460. package/dist/internal/sdk-runner.d.ts.map +1 -1
  461. package/dist/internal/sdk-runner.js +298 -38
  462. package/dist/internal/server.d.ts.map +1 -1
  463. package/dist/internal/server.js +53 -8
  464. package/dist/internal/session-credential.d.ts +14 -0
  465. package/dist/internal/session-credential.d.ts.map +1 -0
  466. package/dist/internal/session-credential.js +25 -0
  467. package/dist/internal/session-engine.d.ts +140 -6
  468. package/dist/internal/session-engine.d.ts.map +1 -1
  469. package/dist/internal/session-engine.js +583 -93
  470. package/dist/internal/storage-coordinator.d.ts +3 -1
  471. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  472. package/dist/internal/storage-coordinator.js +13 -0
  473. package/dist/internal/storage-roles.d.ts +9 -1
  474. package/dist/internal/storage-roles.d.ts.map +1 -1
  475. package/dist/internal/teams-channel-profile.d.ts +41 -0
  476. package/dist/internal/teams-channel-profile.d.ts.map +1 -0
  477. package/dist/internal/teams-channel-profile.js +91 -0
  478. package/dist/internal/teams-devtunnel.d.ts +55 -0
  479. package/dist/internal/teams-devtunnel.d.ts.map +1 -0
  480. package/dist/internal/teams-devtunnel.js +205 -0
  481. package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
  482. package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
  483. package/dist/internal/teams-tunnel-proxy.js +100 -0
  484. package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
  485. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
  486. package/dist/internal/testing/conversation-identity-vectors.js +67 -0
  487. package/dist/internal/testing/hosted-http.d.ts +15 -0
  488. package/dist/internal/testing/hosted-http.d.ts.map +1 -0
  489. package/dist/internal/testing/hosted-http.js +86 -0
  490. package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
  491. package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
  492. package/dist/internal/testing/teams-activity-fixtures.js +236 -0
  493. package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
  494. package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
  495. package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
  496. package/dist/internal/tunnel-process.d.ts +29 -0
  497. package/dist/internal/tunnel-process.d.ts.map +1 -0
  498. package/dist/internal/tunnel-process.js +105 -0
  499. package/dist/internal/turn-context.d.ts +28 -0
  500. package/dist/internal/turn-context.d.ts.map +1 -0
  501. package/dist/internal/turn-context.js +1 -0
  502. package/dist/oidc-token.d.ts +131 -0
  503. package/dist/oidc-token.d.ts.map +1 -0
  504. package/dist/oidc-token.js +221 -0
  505. package/dist/playground/assets/chunk-YOKDWASO-BPO_8GRX.js +115 -0
  506. package/dist/playground/assets/highlighted-body-KPVGNVTW-CxEV-T_f.js +1 -0
  507. package/dist/playground/assets/index-CjFJhCtb.js +62 -0
  508. package/dist/playground/assets/index-vwUVwmk8.css +1 -0
  509. package/dist/playground/assets/mermaid-HWGCJPDP-eK-fpbFn.js +1 -0
  510. package/dist/playground/index.html +2 -2
  511. package/dist/teams-app-package.d.ts +78 -0
  512. package/dist/teams-app-package.d.ts.map +1 -0
  513. package/dist/teams-app-package.js +204 -0
  514. package/dist/tools.d.ts +1 -1
  515. package/dist/tools.d.ts.map +1 -1
  516. package/dist/types.d.ts +271 -2
  517. package/dist/types.d.ts.map +1 -1
  518. package/docs/changelog.md +43 -0
  519. package/docs/deployment.md +14 -0
  520. package/docs/guides/cloud-agents.md +47 -0
  521. package/docs/guides/teams.md +389 -0
  522. package/docs/guides/workload-identity.md +232 -0
  523. package/docs/reference/agent-config.md +1 -1
  524. package/docs/reference/channels.md +1 -0
  525. package/docs/reference/cli.md +116 -0
  526. package/docs/reference/limits.md +4 -4
  527. package/docs/reference/sessions.md +13 -0
  528. package/docs/troubleshooting.md +21 -0
  529. package/package.json +23 -46
  530. package/skills/create-agent/SKILL.md +17 -4
  531. package/skills/debug/SKILL.md +1 -0
  532. package/skills/deploy/SKILL.md +1 -1
  533. package/skills/framework-map/SKILL.md +1 -0
  534. package/skills/setup-teams/SKILL.md +141 -0
  535. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
  536. package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
  537. package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
  538. package/dist/docs/assets/changelog.md.DVNB-ApU.js +0 -1
  539. package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +0 -1
  540. package/dist/docs/assets/chunks/channel.CdyTxaXV.js +0 -1
  541. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +0 -1
  542. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +0 -1
  543. package/dist/docs/assets/chunks/clone.DpIwUbur.js +0 -1
  544. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +0 -1
  545. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
  546. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
  547. package/dist/playground/assets/index-CnFd5R1_.js +0 -62
  548. package/dist/playground/assets/index-DNzRv6G8.css +0 -1
  549. /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
  550. /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
@@ -70,6 +70,7 @@ command remains available.
70
70
  | [`mcp serve`, `mcp install`](#mcp) | Connect an MCP client to an agent |
71
71
  | [`mcp oauth`](#mcp-oauth) | Authorize an MCP connection |
72
72
  | [`slack`](#slack) | Provision and check Slack channel apps |
73
+ | [`teams`](#teams) | Connect, check, and package a Microsoft Teams bot |
73
74
  | [`github`](#github) | Forward, replay, and inspect GitHub webhooks |
74
75
  | [`gitlab`, `bitbucket`, `pagerduty`](#replay-other-webhooks) | Replay and inspect GitLab, Bitbucket, or PagerDuty webhooks |
75
76
 
@@ -135,6 +136,12 @@ agent-sdk dev ./agent-sdk-pr-reviewer --port 3000
135
136
  It accepts every `serve` option. Don't combine the path with a different
136
137
  `--dir`.
137
138
 
139
+ When an agent has a Microsoft Teams channel, `dev` also opens a cloudflared
140
+ quick tunnel and prints that channel's messaging endpoint. Pass
141
+ `--tunnel devtunnel` for an endpoint that stays the same across restarts, and
142
+ `--tunnel-id <id>` to pick the dev tunnel. See
143
+ [Configure Microsoft Teams](#teams).
144
+
138
145
  ### Serve the docs {#docs}
139
146
 
140
147
  ```text
@@ -539,6 +546,115 @@ token prefix defaults to the project directory name in upper snake case.
539
546
  `--channel-posts` adds the message events that `engagement.channelPosts`
540
547
  needs. See [Slack](../guides/slack.md) for manual setup.
541
548
 
549
+ ### Configure Microsoft Teams {#teams}
550
+
551
+ ```text
552
+ agent-sdk channels teams setup
553
+ agent-sdk channels teams init --app-id <guid> --tenant-id <guid> [--dir <path>]
554
+ [--prefix <prefix>] [--dry-run] [--json]
555
+ agent-sdk channels teams doctor [--dir <path>] [--slug <slug>] [--channel <id>]
556
+ [--endpoint <url>] [--json]
557
+ agent-sdk channels teams package [--dir <path>] [--slug <slug>] [--channel <id>]
558
+ [--name <name>] [--icon <png>] [--app-version <x.y.z>] [--endpoint <url>]
559
+ [--out <file>] [--dry-run] [--json]
560
+ agent-sdk channels teams forward [--dir <path>] [--slug <slug>] [--channel <id>]
561
+ [--host <host>] [--port <n>] [--tunnel cloudflared|devtunnel]
562
+ [--tunnel-id <id>] [--json]
563
+ ```
564
+
565
+ | Subcommand | Contract |
566
+ | --- | --- |
567
+ | `setup` | Print the Azure Bot setup steps without changing files. |
568
+ | `init` | Read the bot's client secret from a hidden prompt or stdin, never from an argument. Write `bot/channels/teams.ts` when it's missing, and write the app id, secret, and tenant id to `.env.local`. A second `init` keeps the channel file and replaces the secret. |
569
+ | `doctor` | Run the checks below and exit `1` when one fails. A check it can't run is skipped and says why. |
570
+ | `package` | Write the Teams app package: `manifest.json`, a 192 by 192 color icon, and a 32 by 32 outline icon. By default it writes `<slug>-teams-app.zip` in the agent folder and adds `*-teams-app.zip` to `.gitignore`. `--out <file>` writes it to that path instead. Upload it in Teams under **Apps** > **Manage your apps** > **Upload an app**. |
571
+ | `forward` | Open a tunnel to a running `agent-sdk serve` and print the messaging endpoint of each Teams channel. It runs until you stop it. |
572
+
573
+ `agent-sdk dev` opens the same tunnel by itself. The endpoint is the tunnel
574
+ origin plus `/<slug>/v1/channels/<channel>`, such as
575
+ `https://<random>.trycloudflare.com/helm/v1/channels/teams`. Set it as the
576
+ Azure Bot's messaging endpoint. The tunnel forwards only `POST` requests to
577
+ the Teams messaging paths, so the rest of the agent's API stays local. Every
578
+ other request on the tunnel host gets a `404`.
579
+
580
+ `--tunnel` picks the tunnel for `dev` and `channels teams forward`:
581
+
582
+ | `--tunnel` | Needs | Endpoint |
583
+ | --- | --- | --- |
584
+ | `cloudflared` (default) | `cloudflared` on `PATH`. No account. | A new `trycloudflare.com` URL on every start. Set it on the bot again after each restart. |
585
+ | `devtunnel` | The `devtunnel` CLI on `PATH`, logged in with `devtunnel user login`. | The same `devtunnels.ms` URL on every start. Set it on the bot once. |
586
+
587
+ With `devtunnel`, the first start creates a dev tunnel that allows anonymous
588
+ access, adds port `3978`, and saves the tunnel id as `TEAMS_DEVTUNNEL_ID` in
589
+ `.env.local`. Later starts reuse that tunnel. `--tunnel-id <id>` picks the id.
590
+ Microsoft deletes a dev tunnel after 30 days without use, and the next start
591
+ creates it again under the same id. Port `3978` belongs to the tunnel, so
592
+ `--port 3978` with `--tunnel devtunnel` stops with a usage error. Run the agent
593
+ on another port. `devtunnel host` publishes every port on the tunnel, so the
594
+ tunnel stops when it reports a port other than `3978`. Remove that port with
595
+ `devtunnel port delete <id> -p <port>`, or pass another `--tunnel-id`.
596
+
597
+ The package manifest uses Teams manifest version 1.25. It names the bot by
598
+ its app id and lists the scopes the channel answers in: mentions add `team`
599
+ and `groupChat`, and personal chats add `personal`. With
600
+ `engagement.channelPosts`, it also asks for `ChannelMessage.Read.Group`
601
+ consent. `--endpoint` adds the messaging endpoint's host to `validDomains`.
602
+ `--app-version` sets the app version. It defaults to `1.<YYYYMMDD>.<second of
603
+ the day>` in UTC, so each new zip is higher than the last, and Teams and the
604
+ Teams admin center accept it as an update. Teams refuses an update whose
605
+ version is not higher than the installed one. After you set
606
+ `--app-version 2.0.0`, a later default `1.x` version is lower, so keep passing
607
+ a higher `--app-version`. The default's middle part has 8 digits, which is fine
608
+ for a bot-only app. An app that adds an Office Add-in limits each part to 5
609
+ digits.
610
+
611
+ `doctor` runs these checks in order:
612
+
613
+ | Check | Passes when |
614
+ | --- | --- |
615
+ | `env` | The app id, password, and tenant id variables are set. |
616
+ | `token` | Microsoft Entra issues a Bot Framework token for the app within 10 seconds. |
617
+ | `bot-tenant` | The Azure Bot is **Single Tenant** and its tenant is the one in the channel's tenant id variable. |
618
+ | `bot-endpoint` | The Azure Bot's messaging endpoint is `--endpoint`. Without `--endpoint`, it reports the bot's endpoint. |
619
+ | `teams-channel` | The Azure Bot's Microsoft Teams channel is added and on. |
620
+ | `endpoint` | The endpoint's path names this channel, and an unsigned `POST` to it gets `401`. |
621
+
622
+ The three Azure checks need the Azure CLI, logged in with `az login`, on any
623
+ operating system. Without it they are skipped. When no Azure Bot in the
624
+ current subscription has the app id, they fail. Each `az` call has a time
625
+ limit. The endpoint's path must end in `/v1/channels/<channel>` plus the
626
+ channel's `path`, after nothing, the agent's slug, or `/engine` on
627
+ Cursor-managed hosting. A URL for another channel or agent fails without a
628
+ probe. The `endpoint` answers mean:
629
+
630
+ | Answer | Meaning |
631
+ | --- | --- |
632
+ | `401` with `invalid_token` | The Teams channel serves this URL and its credentials resolve. Teams signs its requests, so the channel refuses the unsigned probe. |
633
+ | `401` with `Unauthorized` | Cursor-managed hosting serves this URL and refuses the unsigned probe before the agent. |
634
+ | `503` with `teams_not_configured` | The server has no app id or password for this channel. Check `envPrefix` and the secrets. |
635
+ | `404` | No Teams channel at this path. Check the slug, the channel name, and the route path. |
636
+ | A redirect | A dev tunnel that needs sign-in. Run `devtunnel access create <id> --anonymous`. |
637
+
638
+ `--endpoint` must be the public `https` URL that `dev` or `channels teams forward`
639
+ prints. `agent-sdk dev` admits unsigned requests from loopback, so a loopback
640
+ probe proves nothing. Without `--endpoint`, `doctor` probes the Azure Bot's
641
+ messaging endpoint.
642
+
643
+ The channel's `envPrefix` owns the variable names. A new channel file reads
644
+ `TEAMS_APP_ID`, `TEAMS_APP_PASSWORD`, and `TEAMS_TENANT_ID`. `init --prefix
645
+ HELM` writes `envPrefix: "HELM"` into the new file and the names
646
+ `HELM_TEAMS_APP_ID`, `HELM_TEAMS_APP_PASSWORD`, and `HELM_TEAMS_TENANT_ID`. The
647
+ prefix must start with a letter, and each name must be a valid deployment
648
+ secret name. When the agent already has a Teams channel, under any file name,
649
+ `init` keeps it and writes the names it reads; a `--prefix` that disagrees with
650
+ it stops with an error. `doctor` and `package` read the names from the loaded
651
+ channel. Multi-agent servers need one Azure Bot per agent.
652
+
653
+ A channel that sets `credentials` in code has no env names for the CLI to
654
+ read. `doctor` then skips the `env`, `token`, and Azure checks and says why,
655
+ `package` and `init` stop with an error, and `doctor` still probes
656
+ `--endpoint`.
657
+
542
658
  ### Test GitHub webhooks {#github}
543
659
 
544
660
  ```text
@@ -5,12 +5,12 @@ description: "How many deployments and deploys a team can have on Cursor-managed
5
5
 
6
6
  # Limits
7
7
 
8
- Cursor caps deployments for some teams. If your team has caps, these are the default values.
8
+ Cursor caps deployments for every team. These are the default values.
9
9
 
10
10
  | Limit | Default | What counts |
11
11
  | --- | --- | --- |
12
- | `owner.deployments` | 20 | Each slug, running or stopped |
13
- | `owner.deploysPerDay` | 100 per 24 hours | Each accepted deploy, including redeploys |
12
+ | `owner.deployments` | 20 | Each installed slug, including a stopped slug. An uninstalled slug counts when a build from the last 2 hours is still in progress or has finished successfully. |
13
+ | `owner.deploysPerDay` | 100 | Each accepted deploy in a rolling 24-hour window, including a redeploy. |
14
14
 
15
15
  The error looks like this:
16
16
 
@@ -21,7 +21,7 @@ The error looks like this:
21
21
  "limit": "owner.deployments",
22
22
  "max": 20,
23
23
  "current": 20,
24
- "docsUrl": "https://cursor.com/docs/bdk/reference/limits"
24
+ "docsUrl": "https://cursor.com/docs/agent-sdk/reference/limits"
25
25
  }
26
26
  ```
27
27
 
@@ -95,6 +95,18 @@ const events: ChannelEventHandlers = {
95
95
  In a local Slack session, a `nudge.delivered` event with no `deliveryId`
96
96
  came from a new Slack message, not from a `send()` call.
97
97
 
98
+ ### Steer the agent's own running turn
99
+
100
+ A tool or a channel `events` handler can add a message to the turn it runs in
101
+ with `ctx.steer(message, { deliveryId })`. The message lands through the
102
+ Cursor SDK's `Run.steer` and is recorded like a steered `send()`, with
103
+ `message.received` and `nudge.delivered`. It never starts a turn, opens a
104
+ session, or queues the message. It
105
+ resolves to `{ status: "steered", turnId, deliveryId }`, to `{ status: "no_turn" }`
106
+ when the context's turn is no longer running, or to
107
+ `{ status: "not_delivered", reason }` when the running turn didn't take the
108
+ message.
109
+
98
110
  ## Stream events
99
111
 
100
112
  Each NDJSON line is a `{ type, index, sessionId, turnId?, at, data }`
@@ -107,6 +119,7 @@ ISO-8601 timestamp.
107
119
  | Input | `message.received`, `nudge.delivered` | A prompt was accepted or reached a running turn. Both carry [delivery IDs](#track-which-follow-up-reached-the-agent) |
108
120
  | Turn | `turn.queued`, `turn.started`, `turn.completed`, `turn.failed` | Queueing under [`maxRunningTurns`](./agent-config.md#concurrency), then status, result, and token usage |
109
121
  | Steps | `step.started`, `step.completed` | Model step boundaries and duration |
122
+ | Model calls | `model_call.completed` | One model call's token usage, as soon as the call finishes. Needs a Cursor SDK that reports per-call usage |
110
123
  | Reasoning | `reasoning.appended`, `reasoning.completed` | Streamed reasoning blocks |
111
124
  | Reply | `message.appended`, `message.completed` | Text deltas and finished assistant messages |
112
125
  | Tools | `actions.requested`, `actions.completed`, `action.result`, `action.tool_retry` | Tool names, arguments, outputs, and errors. `action.tool_retry` marks a read retried after a transient failure |
@@ -54,6 +54,7 @@ Start with three checks:
54
54
  | The deployment never reaches `running` | Run `agent-sdk deployment get <slug>`, and fix the error it reports. |
55
55
  | A secret or egress change has no effect | Confirm the name with `secret list`, check that the `hosting` block is on the pushed ref, and redeploy. |
56
56
  | A hosted schedule doesn't fire | Check that the deployment is running and that the schedule is in `bot/schedules/` on the deployed ref. |
57
+ | The startup log shows `requires CURSOR_API_KEY` | This is expected. See [Startup runs before secrets are available](./deployment.md#startup-runs-before-secrets-are-available). |
57
58
  | A custom route returns `429` | Wait for the time in `Retry-After`, then send it again. |
58
59
 
59
60
  ## GitHub deliveries fail
@@ -73,6 +74,26 @@ Start with three checks:
73
74
  | `slack create` waits for workspace approval | Keep the CLI running and open the **Request approval** link it prints. After an admin approves, select **Retry** in the [Deployed Agents](https://cursor.com/dashboard/deployed-agents) **Add Slack** wizard. |
74
75
  | The bot ignores ordinary channel posts | Configure `engagement.channelPosts`, create the app with `--channel-posts`, and invite it to each allowed channel. |
75
76
 
77
+ ## Teams does not respond
78
+
79
+ | What you see | What to do |
80
+ | --- | --- |
81
+ | `channels teams doctor` fails the `token` check | Copy the **Microsoft App ID** and **App Tenant ID** from the Azure Bot's **Configuration** page, create a new client secret, and run `agent-sdk channels teams init` again. |
82
+ | `channels teams doctor` fails the `endpoint` check with `teams_not_configured` | The server that serves the URL has no app id or password for this channel. Check the channel's `envPrefix` and the secrets on that server. |
83
+ | `channels teams doctor` fails the `endpoint` check with a `404`, or says the URL is not this channel's endpoint | The URL has the wrong path. Use the endpoint that `dev` printed. It ends in `/v1/channels/<channel>`, plus the channel's `path` when it sets one. |
84
+ | `channels teams doctor` fails the `bot-tenant` check | The Azure Bot must be **Single Tenant**, in the tenant that the channel's tenant id variable holds. Create a Single Tenant Azure Bot in your own tenant, then run `agent-sdk channels teams init` with its ids. |
85
+ | `channels teams doctor` skips `bot-tenant`, `bot-endpoint`, and `teams-channel` | The Azure CLI is missing or not logged in. Install it and run `az login`. |
86
+ | `channels teams doctor` fails `bot-tenant`, `bot-endpoint`, and `teams-channel` with no Azure Bot found | No Azure Bot in the current subscription has the app id. Check the app id, or select the bot's subscription with `az account set`. |
87
+ | `channels teams doctor` fails the `bot-endpoint` check | Set the endpoint that `dev` printed on the Azure Bot: **Configuration**, **Messaging endpoint**, **Apply**. |
88
+ | `channels teams doctor` fails the `teams-channel` check | On the Azure Bot, open **Channels**, select **Microsoft Teams**, then select **Apply**. |
89
+ | `agent-sdk dev` prints `warning: Teams tunnel: cloudflared is not installed` | Install `cloudflared`, put it on `PATH`, and restart `dev`. |
90
+ | `agent-sdk dev --tunnel devtunnel` prints `devtunnel is not logged in` | Run `devtunnel user login`, or `devtunnel user login -g` for a GitHub account, and restart `dev`. |
91
+ | `agent-sdk dev --tunnel devtunnel` says the dev tunnel also publishes another port | `devtunnel host` publishes every port on the tunnel. Remove the other port with `devtunnel port delete <id> -p <port>`, or pass another `--tunnel-id`. |
92
+ | The bot stops answering after you restart `dev` | The cloudflared URL changed. Set the endpoint that `dev` printed on the Azure Bot again, or start `dev` with `--tunnel devtunnel` to keep one URL. |
93
+ | The bot cannot be added to a team or group chat | Upload the app package: run `agent-sdk channels teams package`, then in Teams select **Apps**, **Manage your apps**, **Upload an app**. |
94
+
95
+ See [Configure Microsoft Teams](./reference/cli.md#teams) for the commands.
96
+
76
97
  ## MCP authorization fails
77
98
 
78
99
  | What you see | What to do |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@grok/agent-sdk",
3
- "version": "0.6.0",
3
+ "version": "0.7.1",
4
4
  "description": "Build, test, and deploy agents as code on Cursor's agent harness.",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "repository": {
@@ -25,10 +25,12 @@
25
25
  "!dist/internal/managed-delivery.*",
26
26
  "!dist/internal/factory-registration.*",
27
27
  "!dist/internal/testing/factory-resource-fixtures.*",
28
+ "!dist/internal/testing/teams-test-harness.*",
28
29
  "!dist/internal/hosted/**",
29
30
  "!dist/internal/tenant-mcp/**",
30
31
  "!dist/internal/tenant-slack/**",
31
32
  "!dist/internal/review-comments*",
33
+ "!dist/internal/review-discussion.*",
32
34
  "skills/**/*",
33
35
  "templates/**/*",
34
36
  "!templates/pr-autofixer/README.md",
@@ -45,230 +47,198 @@
45
47
  ],
46
48
  "exports": {
47
49
  ".": {
48
- "anysphere-source": "./src/index.ts",
49
50
  "types": "./dist/index.d.ts",
50
51
  "import": "./dist/index.js",
51
52
  "default": "./dist/index.js"
52
53
  },
53
- "./internal/hosted": {
54
- "anysphere-source": "./src/internal/hosted/index.ts",
55
- "types": "./src/internal/hosted/index.ts",
56
- "default": null
57
- },
58
- "./cli": {
59
- "anysphere-source": "./src/bin/agent-serve.ts",
60
- "default": null
61
- },
62
54
  "./tools": {
63
- "anysphere-source": "./src/tools.ts",
64
55
  "types": "./dist/tools.d.ts",
65
56
  "import": "./dist/tools.js",
66
57
  "default": "./dist/tools.js"
67
58
  },
68
59
  "./channels": {
69
- "anysphere-source": "./src/channels.ts",
70
60
  "types": "./dist/channels.d.ts",
71
61
  "import": "./dist/channels.js",
72
62
  "default": "./dist/channels.js"
73
63
  },
74
64
  "./channels/slack": {
75
- "anysphere-source": "./src/channels/slack/index.ts",
76
65
  "types": "./dist/channels/slack/index.d.ts",
77
66
  "import": "./dist/channels/slack/index.js",
78
67
  "default": "./dist/channels/slack/index.js"
79
68
  },
69
+ "./channels/teams": {
70
+ "bun": "./dist/channels/teams/index.js",
71
+ "types": "./dist/channels/teams/index.d.ts",
72
+ "import": "./dist/channels/teams/index.js",
73
+ "default": "./dist/channels/teams/index.js"
74
+ },
80
75
  "./channels/github": {
81
- "anysphere-source": "./src/channels/github/index.ts",
82
76
  "types": "./dist/channels/github/index.d.ts",
83
77
  "import": "./dist/channels/github/index.js",
84
78
  "default": "./dist/channels/github/index.js"
85
79
  },
86
80
  "./channels/origin": {
87
- "anysphere-source": "./src/channels/origin/index.ts",
88
81
  "types": "./dist/channels/origin/index.d.ts",
89
82
  "import": "./dist/channels/origin/index.js",
90
83
  "default": "./dist/channels/origin/index.js"
91
84
  },
92
85
  "./channels/gitlab": {
93
- "anysphere-source": "./src/channels/gitlab/index.ts",
94
86
  "types": "./dist/channels/gitlab/index.d.ts",
95
87
  "import": "./dist/channels/gitlab/index.js",
96
88
  "default": "./dist/channels/gitlab/index.js"
97
89
  },
98
90
  "./channels/change-monitors": {
99
- "anysphere-source": "./src/channels/change-monitors/index.ts",
100
91
  "types": "./dist/channels/change-monitors/index.d.ts",
101
92
  "import": "./dist/channels/change-monitors/index.js",
102
93
  "default": "./dist/channels/change-monitors/index.js"
103
94
  },
104
95
  "./channels/issues": {
105
- "anysphere-source": "./src/channels/issues/index.ts",
106
96
  "types": "./dist/channels/issues/index.d.ts",
107
97
  "import": "./dist/channels/issues/index.js",
108
98
  "default": "./dist/channels/issues/index.js"
109
99
  },
110
100
  "./channels/runs": {
111
- "anysphere-source": "./src/channels/runs/index.ts",
112
101
  "bun": "./dist/channels/runs/index.js",
113
102
  "types": "./dist/channels/runs/index.d.ts",
114
103
  "import": "./dist/channels/runs/index.js",
115
104
  "default": "./dist/channels/runs/index.js"
116
105
  },
117
106
  "./channels/match-ready": {
118
- "anysphere-source": "./src/channels/match-ready/index.ts",
119
107
  "bun": "./dist/channels/match-ready/index.js",
120
108
  "types": "./dist/channels/match-ready/index.d.ts",
121
109
  "import": "./dist/channels/match-ready/index.js",
122
110
  "default": "./dist/channels/match-ready/index.js"
123
111
  },
124
112
  "./channels/bitbucket": {
125
- "anysphere-source": "./src/channels/bitbucket/index.ts",
126
113
  "types": "./dist/channels/bitbucket/index.d.ts",
127
114
  "import": "./dist/channels/bitbucket/index.js",
128
115
  "default": "./dist/channels/bitbucket/index.js"
129
116
  },
130
117
  "./channels/pagerduty": {
131
- "anysphere-source": "./src/channels/pagerduty/index.ts",
132
118
  "bun": "./dist/channels/pagerduty/index.js",
133
119
  "types": "./dist/channels/pagerduty/index.d.ts",
134
120
  "import": "./dist/channels/pagerduty/index.js",
135
121
  "default": "./dist/channels/pagerduty/index.js"
136
122
  },
137
123
  "./channels/deployments": {
138
- "anysphere-source": "./src/channels/deployments/index.ts",
139
124
  "types": "./dist/channels/deployments/index.d.ts",
140
125
  "import": "./dist/channels/deployments/index.js",
141
126
  "default": "./dist/channels/deployments/index.js"
142
127
  },
143
128
  "./skills": {
144
- "anysphere-source": "./src/skills.ts",
145
129
  "types": "./dist/skills.d.ts",
146
130
  "import": "./dist/skills.js",
147
131
  "default": "./dist/skills.js"
148
132
  },
149
133
  "./extensions": {
150
- "anysphere-source": "./src/extensions.ts",
151
134
  "bun": "./dist/extensions.js",
152
135
  "types": "./dist/extensions.d.ts",
153
136
  "import": "./dist/extensions.js",
154
137
  "default": "./dist/extensions.js"
155
138
  },
156
139
  "./extensions/cursor-cloud-agents": {
157
- "anysphere-source": "./src/extensions/cursor-cloud-agents/extension.ts",
158
140
  "bun": "./dist/extensions/cursor-cloud-agents/extension.js",
159
141
  "types": "./dist/extensions/cursor-cloud-agents/extension.d.ts",
160
142
  "import": "./dist/extensions/cursor-cloud-agents/extension.js",
161
143
  "default": "./dist/extensions/cursor-cloud-agents/extension.js"
162
144
  },
163
145
  "./extensions/improve": {
164
- "anysphere-source": "./src/extensions/improve/extension.ts",
165
146
  "bun": "./dist/extensions/improve/extension.js",
166
147
  "types": "./dist/extensions/improve/extension.d.ts",
167
148
  "import": "./dist/extensions/improve/extension.js",
168
149
  "default": "./dist/extensions/improve/extension.js"
169
150
  },
170
151
  "./extensions/jev": {
171
- "anysphere-source": "./src/extensions/jev/extension.ts",
172
152
  "bun": "./dist/extensions/jev/extension.js",
173
153
  "types": "./dist/extensions/jev/extension.d.ts",
174
154
  "import": "./dist/extensions/jev/extension.js",
175
155
  "default": "./dist/extensions/jev/extension.js"
176
156
  },
177
157
  "./extensions/slack-communication": {
178
- "anysphere-source": "./src/extensions/slack-communication/extension.ts",
179
158
  "bun": "./dist/extensions/slack-communication/extension.js",
180
159
  "types": "./dist/extensions/slack-communication/extension.d.ts",
181
160
  "import": "./dist/extensions/slack-communication/extension.js",
182
161
  "default": "./dist/extensions/slack-communication/extension.js"
183
162
  },
184
163
  "./schedules": {
185
- "anysphere-source": "./src/schedules.ts",
186
164
  "types": "./dist/schedules.d.ts",
187
165
  "import": "./dist/schedules.js",
188
166
  "default": "./dist/schedules.js"
189
167
  },
190
168
  "./scm": {
191
- "anysphere-source": "./src/scm.ts",
192
169
  "types": "./dist/scm.d.ts",
193
170
  "import": "./dist/scm.js",
194
171
  "default": "./dist/scm.js"
195
172
  },
196
173
  "./reminders": {
197
- "anysphere-source": "./src/reminders.ts",
198
174
  "types": "./dist/reminders.d.ts",
199
175
  "import": "./dist/reminders.js",
200
176
  "default": "./dist/reminders.js"
201
177
  },
202
178
  "./connections": {
203
- "anysphere-source": "./src/connections.ts",
204
179
  "types": "./dist/connections.d.ts",
205
180
  "import": "./dist/connections.js",
206
181
  "default": "./dist/connections.js"
207
182
  },
208
183
  "./hooks": {
209
- "anysphere-source": "./src/hooks.ts",
210
184
  "types": "./dist/hooks.d.ts",
211
185
  "import": "./dist/hooks.js",
212
186
  "default": "./dist/hooks.js"
213
187
  },
214
188
  "./memory": {
215
- "anysphere-source": "./src/memory.ts",
216
189
  "types": "./dist/memory.d.ts",
217
190
  "import": "./dist/memory.js",
218
191
  "default": "./dist/memory.js"
219
192
  },
220
193
  "./prompt": {
221
- "anysphere-source": "./src/prompt.ts",
222
194
  "types": "./dist/prompt.d.ts",
223
195
  "import": "./dist/prompt.js",
224
196
  "default": "./dist/prompt.js"
225
197
  },
226
198
  "./evals": {
227
- "anysphere-source": "./src/evals.ts",
228
199
  "types": "./dist/evals.d.ts",
229
200
  "import": "./dist/evals.js",
230
201
  "default": "./dist/evals.js"
231
202
  },
232
203
  "./evals/reporters": {
233
- "anysphere-source": "./src/evals/reporters.ts",
234
204
  "types": "./dist/evals/reporters.d.ts",
235
205
  "import": "./dist/evals/reporters.js",
236
206
  "default": "./dist/evals/reporters.js"
237
207
  },
238
208
  "./evals/loaders": {
239
- "anysphere-source": "./src/evals/loaders.ts",
240
209
  "types": "./dist/evals/loaders.d.ts",
241
210
  "import": "./dist/evals/loaders.js",
242
211
  "default": "./dist/evals/loaders.js"
243
212
  },
244
213
  "./artifacts": {
245
- "anysphere-source": "./src/artifacts.ts",
246
214
  "types": "./dist/artifacts.d.ts",
247
215
  "import": "./dist/artifacts.js",
248
216
  "default": "./dist/artifacts.js"
249
217
  },
250
218
  "./kv": {
251
- "anysphere-source": "./src/kv.ts",
252
219
  "bun": "./dist/kv.js",
253
220
  "types": "./dist/kv.d.ts",
254
221
  "import": "./dist/kv.js",
255
222
  "default": "./dist/kv.js"
256
223
  },
257
224
  "./otel": {
258
- "anysphere-source": "./src/otel-public.ts",
259
225
  "types": "./dist/otel-public.d.ts",
260
226
  "import": "./dist/otel-public.js",
261
227
  "default": "./dist/otel-public.js"
262
228
  },
229
+ "./teams-app-package": {
230
+ "bun": "./dist/teams-app-package.js",
231
+ "types": "./dist/teams-app-package.d.ts",
232
+ "import": "./dist/teams-app-package.js",
233
+ "default": "./dist/teams-app-package.js"
234
+ },
263
235
  "./telemetry": {
264
- "anysphere-source": "./src/telemetry.ts",
265
236
  "bun": "./dist/telemetry.js",
266
237
  "types": "./dist/telemetry.d.ts",
267
238
  "import": "./dist/telemetry.js",
268
239
  "default": "./dist/telemetry.js"
269
240
  },
270
241
  "./package.json": {
271
- "anysphere-source": "./package.json",
272
242
  "bun": "./package.json",
273
243
  "types": "./package.json",
274
244
  "import": "./package.json",
@@ -280,7 +250,7 @@
280
250
  },
281
251
  "dependencies": {
282
252
  "@bazel/runfiles": "6.5.0",
283
- "@cursor/sdk": "1.3.0",
253
+ "@cursor/sdk": "1.4.2",
284
254
  "@modelcontextprotocol/sdk": "^1.32.1",
285
255
  "@octokit/auth-app": "^7.2.0",
286
256
  "@octokit/rest": "^21.1.1",
@@ -304,6 +274,7 @@
304
274
  "@slack/web-api": "^7.18.0",
305
275
  "croner": "^8.0.1",
306
276
  "esbuild": "^0.25.0",
277
+ "fflate": "0.8.3",
307
278
  "javascript-time-ago": "^2.6.4",
308
279
  "js-yaml": "4.3.2",
309
280
  "minimatch": "^10.2.5",
@@ -319,6 +290,10 @@
319
290
  },
320
291
  "devDependencies": {
321
292
  "@anysphere/agent-store-sync": "1.0.0",
293
+ "@anysphere/automations-ui": "1.0.0",
294
+ "@anysphere/context": "1.0.0",
295
+ "@anysphere/mcp-agent-exec": "1.0.0",
296
+ "@anysphere/mcp-core": "1.0.0",
322
297
  "@anysphere/ui": "1.0.0",
323
298
  "@braintree/sanitize-url": "7.1.2",
324
299
  "@microsoft/api-extractor": "7.59.4",
@@ -334,6 +309,8 @@
334
309
  "@types/react-dom": "19.3.0",
335
310
  "@typescript/native": "npm:typescript@^7.0.2",
336
311
  "@vitejs/plugin-react": "6.1.2",
312
+ "ajv": "8.20.0",
313
+ "ajv-draft-04": "1.0.0",
337
314
  "cytoscape": "3.33.3",
338
315
  "cytoscape-cose-bilkent": "4.1.0",
339
316
  "dayjs": "1.11.20",
@@ -2,8 +2,9 @@
2
2
  name: agent-sdk-create-agent
3
3
  description: >-
4
4
  Scaffold a new Agent SDK agent: short AskQuestion interview, then
5
- verify a turn and hand off to hillclimb. Use when creating a new
6
- agent. Ask only what the invoking message left open.
5
+ verify a turn and hand off to hillclimb. Use to build or create a
6
+ new bot or agent with the agent-sdk, the Agent SDK, `@grok/agent-sdk`,
7
+ or BDK. Ask only what the invoking message left open.
7
8
  ---
8
9
 
9
10
  # Create an Agent SDK agent
@@ -22,6 +23,14 @@ Read `skills/framework-map/SKILL.md` if you have not. CLI is
22
23
  `node_modules/@grok/agent-sdk/dist/docs/llms.txt` or `/docs/llms.txt`
23
24
  on a running host.
24
25
 
26
+ If a linked skill is not available, read its docs page instead:
27
+
28
+ - `agent-sdk-framework-map`: https://cursor.com/docs/agent-sdk/reference/project-layout
29
+ - `agent-sdk-hillclimb`: https://cursor.com/docs/agent-sdk/hillclimbing
30
+ - `agent-sdk-evals`: https://cursor.com/docs/agent-sdk/evals
31
+ - `agent-sdk-setup-slack`: https://cursor.com/docs/agent-sdk/guides/slack
32
+ - `agent-sdk-github`: https://cursor.com/docs/agent-sdk/guides/github
33
+
25
34
  ## Interview
26
35
 
27
36
  `AskQuestion`: batched, recommended option first and labeled
@@ -50,7 +59,7 @@ on a running host.
50
59
  | Question | Options | Guidance |
51
60
  | --- | --- | --- |
52
61
  | **Model** | `grok-4.7` + `reasoning_effort=high`, `fast=true` · Other id | Params, not id suffixes: `{ id: "grok-4.7", params: [{ id: "reasoning_effort", value: "high" }, { id: "fast", value: "true" }] }` |
53
- | **Channels** (multi) | playground + HTTP (always on) · Slack · GitHub · custom webhook · schedule | Slack: `skills/setup-slack/SKILL.md`. GitHub: `skills/github/SKILL.md`. No Discord/Teams pack; offer custom webhook. |
62
+ | **Channels** (multi) | playground + HTTP (always on) · Slack · Microsoft Teams · GitHub · custom webhook · schedule | Slack: `skills/setup-slack/SKILL.md`. Teams: `skills/setup-teams/SKILL.md`. GitHub: `skills/github/SKILL.md`. No Discord pack; offer custom webhook. |
54
63
  | **MCP** (multi) | none · remote URL · local stdio · Cursor account connectors · Other | One file under `bot/mcp-connections/`. Account file is `account.ts`, never `cursor.ts`. Named local tools need `advertiseTools: true`. Privileged servers go in `bot/host-connections/`. |
55
64
  | **Capabilities** (multi) | server tools · agent tools · skills · subagents · hooks · sandbox seeds · evals (recommend) | Always recommend one smoke eval. |
56
65
  <!-- interview:end -->
@@ -67,6 +76,7 @@ something". Write files only after approval.
67
76
  | Purpose | Shape |
68
77
  | --- | --- |
69
78
  | Slack chat | `slackChannel({ envPrefix })` + suggested prompts. `agent-sdk slack create` mints the bot. Prefix: `skills/setup-slack/SKILL.md` |
79
+ | Teams chat | `teamsChannel()`, or `teamsChannel({ envPrefix })` for one bot per agent. `agent-sdk channels teams init` writes it for the user's Azure Bot. Setup: `skills/setup-teams/SKILL.md` |
70
80
  | PR review with host prep | Channel `callTool` into a trimmed workspace `pr/` tree |
71
81
  | GitHub automation | `githubChannel()` hooks, replay fixtures |
72
82
  | Domain assistant | Server tools + one MCP connection + a skill |
@@ -125,7 +135,9 @@ agent-sdk init ./<slug>
125
135
  Slack: `agent-sdk slack create --dir ./<slug> --name "<Name>"`,
126
136
  not a hand-written channel. Manual Slack app:
127
137
  `agent-sdk slack init --manual` (Slack CLI, or paste at
128
- api.slack.com).
138
+ api.slack.com). Teams: `agent-sdk channels teams init --dir ./<slug>
139
+ --app-id <id> --tenant-id <id>` with the client secret on stdin,
140
+ not a hand-written channel.
129
141
  4. Blank init writes `evals/evals.config.ts` (`maxConcurrency: 20`,
130
142
  cap 200) and `evals/smoke.eval.ts`. The smoke case uses `echo`
131
143
  and asserts `t.succeeded()` and `t.calledTool("echo")`. Replace
@@ -176,6 +188,7 @@ the hand-over commands above in "Test it locally".
176
188
  ## Channel setup
177
189
 
178
190
  - **Slack.** `skills/setup-slack/SKILL.md`
191
+ - **Microsoft Teams.** `skills/setup-teams/SKILL.md`
179
192
  - **GitHub.** `skills/github/SKILL.md`
180
193
  - **Custom webhook.** `POST /v1/channels/<id>/<route>`.
181
194
  Loopback-only until you add `bearerAuth(...)`. Hosted callers
@@ -33,6 +33,7 @@ Local `agent-sdk serve`. Hosted start failures:
33
33
  | `403` on stream | Wrong principal. Same auth as create; beyond loopback send `--bearer-token`. |
34
34
  | Works on loopback, blocked via tunnel | `localDevStrict()` rejects forwarded headers. Use `--bearer-token`. Never `--allow-anonymous` with account MCP. |
35
35
  | Slack `channel idle … missing credentials` | Expected. `slack doctor --prefix <PREFIX>`. |
36
+ | Teams bot silent | `channels teams doctor --dir . --endpoint <URL dev printed>`. It names the failing part: env names, token, Azure Bot endpoint, Teams channel, or path. The cloudflared URL changes on every `dev` start; `--tunnel devtunnel` keeps one. `warning: Teams tunnel:` means the tunnel binary is missing or exited. |
36
37
  | Immediate API-key error | Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`). |
37
38
  | `validate` clean, CI typecheck fails | tsx skipped types. JSON-shaped returns; `type` not `interface`. |
38
39
  | `validate`: `architecture "v2" requires a named secret` | Getter or literal SCM credential. Use the quoted `{ secretName: "NAME" }`; `secrets set <slug> NAME` after deploy. |
@@ -39,7 +39,7 @@ the value. Do not run `agent-sdk login`.
39
39
  On Linux and macOS, run every Agent SDK command through this wrapper:
40
40
 
41
41
  ```bash
42
- BDK_VERSION="0.6.0"
42
+ BDK_VERSION="0.7.1"
43
43
  BDK_PACKAGE="@grok/agent-sdk"
44
44
  case "$BDK_VERSION" in
45
45
  __BDK_V*)
@@ -123,6 +123,7 @@ only this agent's directory.
123
123
  | OpenTelemetry | `skills/otel/SKILL.md` |
124
124
  | GitHub | `skills/github/SKILL.md` |
125
125
  | Slack | `skills/setup-slack/SKILL.md` |
126
+ | Microsoft Teams | `skills/setup-teams/SKILL.md` |
126
127
  | Host MCP OAuth | `skills/mcp-auth/SKILL.md` |
127
128
  | Managed deployment | `skills/deploy/SKILL.md` |
128
129
  | Local triage | `skills/debug/SKILL.md` |