@grok/agent-sdk 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (521) hide show
  1. package/AGENTS.md +40 -0
  2. package/dist/channels/github/forward.d.ts +5 -0
  3. package/dist/channels/github/forward.d.ts.map +1 -1
  4. package/dist/channels/github/forward.js +6 -3
  5. package/dist/channels/slack/api.d.ts +18 -0
  6. package/dist/channels/slack/api.d.ts.map +1 -1
  7. package/dist/channels/slack/api.js +31 -0
  8. package/dist/channels/slack/approvals.d.ts +19 -2
  9. package/dist/channels/slack/approvals.d.ts.map +1 -1
  10. package/dist/channels/slack/approvals.js +90 -19
  11. package/dist/channels/slack/attachments.d.ts +7 -2
  12. package/dist/channels/slack/attachments.d.ts.map +1 -1
  13. package/dist/channels/slack/attachments.js +318 -156
  14. package/dist/channels/slack/connect-card.d.ts +16 -0
  15. package/dist/channels/slack/connect-card.d.ts.map +1 -0
  16. package/dist/channels/slack/connect-card.js +31 -0
  17. package/dist/channels/slack/credentials.d.ts +10 -2
  18. package/dist/channels/slack/credentials.d.ts.map +1 -1
  19. package/dist/channels/slack/credentials.js +17 -15
  20. package/dist/channels/slack/defaults.d.ts.map +1 -1
  21. package/dist/channels/slack/defaults.js +18 -9
  22. package/dist/channels/slack/dispatch.d.ts +1 -1
  23. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  24. package/dist/channels/slack/dispatch.js +19 -3
  25. package/dist/channels/slack/inbound.d.ts +8 -2
  26. package/dist/channels/slack/inbound.d.ts.map +1 -1
  27. package/dist/channels/slack/inbound.js +25 -4
  28. package/dist/channels/slack/index.d.ts +3 -2
  29. package/dist/channels/slack/index.d.ts.map +1 -1
  30. package/dist/channels/slack/index.js +3 -2
  31. package/dist/channels/slack/init.d.ts.map +1 -1
  32. package/dist/channels/slack/init.js +2 -1
  33. package/dist/channels/slack/mentions.d.ts +28 -0
  34. package/dist/channels/slack/mentions.d.ts.map +1 -0
  35. package/dist/channels/slack/mentions.js +178 -0
  36. package/dist/channels/slack/setup.js +1 -1
  37. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  38. package/dist/channels/slack/slack-channel.js +46 -3
  39. package/dist/channels/slack/stop.d.ts.map +1 -1
  40. package/dist/channels/slack/stop.js +7 -1
  41. package/dist/channels/slack/thread-context.d.ts +3 -0
  42. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  43. package/dist/channels/slack/thread-context.js +17 -7
  44. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
  45. package/dist/channels/slack/tool-approval-events.js +55 -2
  46. package/dist/channels/slack/types.d.ts +2 -0
  47. package/dist/channels/slack/types.d.ts.map +1 -1
  48. package/dist/channels/teams/activity.d.ts +33 -0
  49. package/dist/channels/teams/activity.d.ts.map +1 -0
  50. package/dist/channels/teams/activity.js +213 -0
  51. package/dist/channels/teams/auth.d.ts +25 -0
  52. package/dist/channels/teams/auth.d.ts.map +1 -0
  53. package/dist/channels/teams/auth.js +55 -0
  54. package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
  55. package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
  56. package/dist/channels/teams/bot-framework-auth.js +154 -0
  57. package/dist/channels/teams/cards.d.ts +23 -0
  58. package/dist/channels/teams/cards.d.ts.map +1 -0
  59. package/dist/channels/teams/cards.js +107 -0
  60. package/dist/channels/teams/connector.d.ts +48 -0
  61. package/dist/channels/teams/connector.d.ts.map +1 -0
  62. package/dist/channels/teams/connector.js +159 -0
  63. package/dist/channels/teams/credentials.d.ts +65 -0
  64. package/dist/channels/teams/credentials.d.ts.map +1 -0
  65. package/dist/channels/teams/credentials.js +84 -0
  66. package/dist/channels/teams/delivery.d.ts +14 -0
  67. package/dist/channels/teams/delivery.d.ts.map +1 -0
  68. package/dist/channels/teams/delivery.js +169 -0
  69. package/dist/channels/teams/dispatch.d.ts +45 -0
  70. package/dist/channels/teams/dispatch.d.ts.map +1 -0
  71. package/dist/channels/teams/dispatch.js +402 -0
  72. package/dist/channels/teams/engagement.d.ts +32 -0
  73. package/dist/channels/teams/engagement.d.ts.map +1 -0
  74. package/dist/channels/teams/engagement.js +120 -0
  75. package/dist/channels/teams/index.d.ts +21 -0
  76. package/dist/channels/teams/index.d.ts.map +1 -0
  77. package/dist/channels/teams/index.js +19 -0
  78. package/dist/channels/teams/marks.d.ts +19 -0
  79. package/dist/channels/teams/marks.d.ts.map +1 -0
  80. package/dist/channels/teams/marks.js +96 -0
  81. package/dist/channels/teams/senders.d.ts +27 -0
  82. package/dist/channels/teams/senders.d.ts.map +1 -0
  83. package/dist/channels/teams/senders.js +72 -0
  84. package/dist/channels/teams/teams-channel.d.ts +43 -0
  85. package/dist/channels/teams/teams-channel.d.ts.map +1 -0
  86. package/dist/channels/teams/teams-channel.js +278 -0
  87. package/dist/channels/teams/text.d.ts +7 -0
  88. package/dist/channels/teams/text.d.ts.map +1 -0
  89. package/dist/channels/teams/text.js +63 -0
  90. package/dist/channels/teams/types.d.ts +306 -0
  91. package/dist/channels/teams/types.d.ts.map +1 -0
  92. package/dist/channels/teams/types.js +1 -0
  93. package/dist/channels.d.ts +31 -0
  94. package/dist/channels.d.ts.map +1 -1
  95. package/dist/channels.js +37 -0
  96. package/dist/connections.d.ts +1 -1
  97. package/dist/connections.d.ts.map +1 -1
  98. package/dist/docs/404.html +3 -3
  99. package/dist/docs/assets/{app.lt-BYgI2.js → app.Ch-048af.js} +4 -4
  100. package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
  101. package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.SoN0MK7o.lean.js} +1 -1
  102. package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +1 -0
  103. package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
  104. package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BIzu7OVF.js} +1 -1
  105. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
  106. package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.B4y6Y5eG.js} +1 -1
  107. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
  108. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
  109. package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
  110. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
  111. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
  112. package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
  113. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
  114. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
  115. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
  116. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
  117. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.CwrYtDVo.js} +1 -1
  118. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +1 -0
  119. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +1 -0
  120. package/dist/docs/assets/chunks/clone.F824-PNx.js +1 -0
  121. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
  122. package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
  123. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
  124. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
  125. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
  126. package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
  127. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
  128. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
  129. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
  130. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
  131. package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.CdOyJvsX.js} +1 -1
  132. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
  133. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
  134. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
  135. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
  136. package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DDwvoQlY.js} +1 -1
  137. package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.BRXPDWj3.js} +1 -1
  138. package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.3YwC0t3o.js} +1 -1
  139. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
  140. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
  141. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
  142. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
  143. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
  144. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
  145. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.B_SGgvgs.js} +1 -1
  146. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +1 -0
  147. package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.bNyH5NPA.js} +2 -2
  148. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
  149. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
  150. package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DQqE3WF8.js} +1 -1
  151. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
  152. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.DnJA2aXp.js} +1 -1
  153. package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.N9S5KC5R.js} +2 -2
  154. package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.N9S5KC5R.lean.js} +1 -1
  155. package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
  156. package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
  157. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
  158. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
  159. package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
  160. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
  161. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
  162. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
  163. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
  164. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  165. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
  166. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
  167. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
  168. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
  169. package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
  170. package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
  171. package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
  172. package/dist/docs/building-with-agents.html +37 -37
  173. package/dist/docs/changelog.html +37 -37
  174. package/dist/docs/changelog.md +35 -0
  175. package/dist/docs/deployment.html +39 -39
  176. package/dist/docs/deployment.md +10 -0
  177. package/dist/docs/evals.html +37 -37
  178. package/dist/docs/guides/agent-to-agent.html +37 -37
  179. package/dist/docs/guides/bitbucket.html +37 -37
  180. package/dist/docs/guides/cloud-agents.html +43 -38
  181. package/dist/docs/guides/cloud-agents.md +47 -0
  182. package/dist/docs/guides/convert-automation.html +37 -37
  183. package/dist/docs/guides/github.html +37 -37
  184. package/dist/docs/guides/gitlab.html +37 -37
  185. package/dist/docs/guides/improve.html +37 -37
  186. package/dist/docs/guides/jev.html +37 -37
  187. package/dist/docs/guides/mcp-oauth.html +37 -37
  188. package/dist/docs/guides/migrate.html +37 -37
  189. package/dist/docs/guides/opentelemetry.html +37 -37
  190. package/dist/docs/guides/pagerduty.html +37 -37
  191. package/dist/docs/guides/slack.html +37 -37
  192. package/dist/docs/guides/teams.html +109 -0
  193. package/dist/docs/guides/teams.md +384 -0
  194. package/dist/docs/guides/webhooks.html +37 -37
  195. package/dist/docs/hashmap.json +1 -1
  196. package/dist/docs/hillclimbing.html +37 -37
  197. package/dist/docs/index.html +37 -37
  198. package/dist/docs/llms-full.txt +636 -4
  199. package/dist/docs/llms.txt +1 -0
  200. package/dist/docs/quickstart.html +37 -37
  201. package/dist/docs/reference/access.html +36 -36
  202. package/dist/docs/reference/agent-config.html +37 -37
  203. package/dist/docs/reference/artifacts.html +37 -37
  204. package/dist/docs/reference/channels.html +38 -38
  205. package/dist/docs/reference/channels.md +1 -0
  206. package/dist/docs/reference/cli.html +50 -40
  207. package/dist/docs/reference/cli.md +116 -0
  208. package/dist/docs/reference/connections.html +37 -37
  209. package/dist/docs/reference/evals.html +37 -37
  210. package/dist/docs/reference/extensions.html +37 -37
  211. package/dist/docs/reference/hooks.html +37 -37
  212. package/dist/docs/reference/http-api.html +37 -37
  213. package/dist/docs/reference/instructions.html +37 -37
  214. package/dist/docs/reference/limits.html +39 -39
  215. package/dist/docs/reference/limits.md +4 -4
  216. package/dist/docs/reference/memory.html +37 -37
  217. package/dist/docs/reference/playground.html +36 -36
  218. package/dist/docs/reference/project-layout.html +37 -37
  219. package/dist/docs/reference/schedules.html +40 -40
  220. package/dist/docs/reference/sessions.html +38 -38
  221. package/dist/docs/reference/sessions.md +13 -0
  222. package/dist/docs/reference/skills.html +40 -40
  223. package/dist/docs/reference/subagents.html +37 -37
  224. package/dist/docs/reference/tools.html +37 -37
  225. package/dist/docs/templates/agentic-owners.html +37 -37
  226. package/dist/docs/templates/reviews.html +37 -37
  227. package/dist/docs/troubleshooting.html +38 -38
  228. package/dist/docs/troubleshooting.md +21 -0
  229. package/dist/evals/run-facts.d.ts.map +1 -1
  230. package/dist/evals/run-facts.js +4 -0
  231. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
  232. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
  233. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
  234. package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
  235. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  236. package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
  237. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
  238. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
  239. package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
  240. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
  241. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  242. package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
  243. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
  244. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
  245. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
  246. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
  247. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
  248. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
  249. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
  250. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
  251. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
  252. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
  253. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
  254. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
  255. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
  256. package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
  257. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
  258. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
  259. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
  260. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
  261. package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
  262. package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
  263. package/dist/extensions.d.ts.map +1 -1
  264. package/dist/extensions.js +18 -3
  265. package/dist/files-backends/agent-store-presigned-url.js +5 -1
  266. package/dist/index.d.ts +1 -0
  267. package/dist/index.d.ts.map +1 -1
  268. package/dist/index.js +1 -0
  269. package/dist/internal/approval-gate.d.ts +6 -1
  270. package/dist/internal/approval-gate.d.ts.map +1 -1
  271. package/dist/internal/approval-gate.js +13 -2
  272. package/dist/internal/authored-loaders.js +1 -1
  273. package/dist/internal/channel-architecture.d.ts.map +1 -1
  274. package/dist/internal/channel-architecture.js +3 -1
  275. package/dist/internal/cli/commands/channels.d.ts +9 -3
  276. package/dist/internal/cli/commands/channels.d.ts.map +1 -1
  277. package/dist/internal/cli/commands/channels.js +193 -4
  278. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  279. package/dist/internal/cli/commands/index.js +6 -1
  280. package/dist/internal/cli/commands/serve.d.ts.map +1 -1
  281. package/dist/internal/cli/commands/serve.js +25 -5
  282. package/dist/internal/cli/dispatch.d.ts.map +1 -1
  283. package/dist/internal/cli/dispatch.js +22 -8
  284. package/dist/internal/cli/flags.d.ts +14 -0
  285. package/dist/internal/cli/flags.d.ts.map +1 -1
  286. package/dist/internal/cli/flags.js +14 -0
  287. package/dist/internal/cli/help.d.ts.map +1 -1
  288. package/dist/internal/cli/help.js +3 -1
  289. package/dist/internal/cli-cursor.js +2 -2
  290. package/dist/internal/cli-deploy.d.ts +1 -0
  291. package/dist/internal/cli-deploy.d.ts.map +1 -1
  292. package/dist/internal/cli-deploy.js +19 -1
  293. package/dist/internal/cli-mcp.d.ts.map +1 -1
  294. package/dist/internal/cli-mcp.js +5 -3
  295. package/dist/internal/cli-teams-doctor.d.ts +39 -0
  296. package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
  297. package/dist/internal/cli-teams-doctor.js +508 -0
  298. package/dist/internal/cli-teams-forward.d.ts +84 -0
  299. package/dist/internal/cli-teams-forward.d.ts.map +1 -0
  300. package/dist/internal/cli-teams-forward.js +386 -0
  301. package/dist/internal/cli-teams-package.d.ts +26 -0
  302. package/dist/internal/cli-teams-package.d.ts.map +1 -0
  303. package/dist/internal/cli-teams-package.js +123 -0
  304. package/dist/internal/cli-teams.d.ts +15 -0
  305. package/dist/internal/cli-teams.d.ts.map +1 -0
  306. package/dist/internal/cli-teams.js +253 -0
  307. package/dist/internal/connect-click.d.ts +12 -0
  308. package/dist/internal/connect-click.d.ts.map +1 -0
  309. package/dist/internal/connect-click.js +22 -0
  310. package/dist/internal/continuation-channel.d.ts +5 -1
  311. package/dist/internal/continuation-channel.d.ts.map +1 -1
  312. package/dist/internal/continuation-channel.js +34 -0
  313. package/dist/internal/continuation-identity.d.ts +7 -4
  314. package/dist/internal/continuation-identity.d.ts.map +1 -1
  315. package/dist/internal/continuation-identity.js +66 -1
  316. package/dist/internal/convert-automation/convert-workflow.js +2 -2
  317. package/dist/internal/credential-env-names.d.ts +36 -0
  318. package/dist/internal/credential-env-names.d.ts.map +1 -0
  319. package/dist/internal/credential-env-names.js +68 -0
  320. package/dist/internal/cursor/account-mcp.d.ts +67 -9
  321. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  322. package/dist/internal/cursor/account-mcp.js +206 -25
  323. package/dist/internal/cursor/backend-client.d.ts +10 -1
  324. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  325. package/dist/internal/cursor/backend-client.js +19 -7
  326. package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
  327. package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
  328. package/dist/internal/cursor/cloud-agent-identity.js +224 -0
  329. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  330. package/dist/internal/cursor/credentials.js +3 -1
  331. package/dist/internal/cursor-account-mcp-auth.d.ts +1 -0
  332. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  333. package/dist/internal/cursor-account-mcp-auth.js +2 -1
  334. package/dist/internal/deploy-client.d.ts.map +1 -1
  335. package/dist/internal/deploy-client.js +34 -2
  336. package/dist/internal/deploy-manifest.d.ts +51 -3
  337. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  338. package/dist/internal/deploy-manifest.js +96 -7
  339. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  340. package/dist/internal/discovery/agent-config.js +6 -1
  341. package/dist/internal/discovery/connections.d.ts.map +1 -1
  342. package/dist/internal/discovery/connections.js +53 -0
  343. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  344. package/dist/internal/discovery/extensions.js +2 -0
  345. package/dist/internal/discovery/info.d.ts.map +1 -1
  346. package/dist/internal/discovery/info.js +4 -0
  347. package/dist/internal/env-file.d.ts +1 -0
  348. package/dist/internal/env-file.d.ts.map +1 -1
  349. package/dist/internal/env-file.js +18 -17
  350. package/dist/internal/env-prefix.d.ts +11 -0
  351. package/dist/internal/env-prefix.d.ts.map +1 -0
  352. package/dist/internal/env-prefix.js +23 -0
  353. package/dist/internal/event-id-dedupe.d.ts +12 -0
  354. package/dist/internal/event-id-dedupe.d.ts.map +1 -0
  355. package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
  356. package/dist/internal/event-mapper.d.ts +7 -2
  357. package/dist/internal/event-mapper.d.ts.map +1 -1
  358. package/dist/internal/event-mapper.js +7 -0
  359. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  360. package/dist/internal/expected-delivery-failure.js +3 -0
  361. package/dist/internal/extension-namespace.d.ts +9 -0
  362. package/dist/internal/extension-namespace.d.ts.map +1 -0
  363. package/dist/internal/extension-namespace.js +14 -0
  364. package/dist/internal/guid.d.ts +2 -0
  365. package/dist/internal/guid.d.ts.map +1 -0
  366. package/dist/internal/guid.js +4 -0
  367. package/dist/internal/host-kv-cas.d.ts +13 -0
  368. package/dist/internal/host-kv-cas.d.ts.map +1 -0
  369. package/dist/internal/host-kv-cas.js +8 -0
  370. package/dist/internal/host-kv.d.ts +4 -1
  371. package/dist/internal/host-kv.d.ts.map +1 -1
  372. package/dist/internal/host-kv.js +15 -2
  373. package/dist/internal/hosted-catch-protocol.d.ts +5 -0
  374. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  375. package/dist/internal/hosted-catch-protocol.js +5 -0
  376. package/dist/internal/hosted-catch.d.ts +2 -0
  377. package/dist/internal/hosted-catch.d.ts.map +1 -1
  378. package/dist/internal/hosted-catch.js +6 -1
  379. package/dist/internal/hosted-delivery-protocol.d.ts +3 -0
  380. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  381. package/dist/internal/hosted-delivery-protocol.js +69 -1
  382. package/dist/internal/hosted-delivery.d.ts +5 -2
  383. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  384. package/dist/internal/hosted-delivery.js +11 -2
  385. package/dist/internal/hosted-session-fixture.js +1 -1
  386. package/dist/internal/hosting.d.ts +5 -0
  387. package/dist/internal/hosting.d.ts.map +1 -1
  388. package/dist/internal/hosting.js +7 -1
  389. package/dist/internal/install-cursor-skills.d.ts +6 -7
  390. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  391. package/dist/internal/install-cursor-skills.js +15 -9
  392. package/dist/internal/interview/agent-questions.d.ts +1 -1
  393. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  394. package/dist/internal/interview/agent-questions.js +4 -3
  395. package/dist/internal/local-control-plane.d.ts.map +1 -1
  396. package/dist/internal/local-control-plane.js +24 -0
  397. package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
  398. package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
  399. package/dist/internal/mcp-allowlist-in-use.js +93 -0
  400. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  401. package/dist/internal/mcp-endpoint.js +8 -10
  402. package/dist/internal/mcp-host.d.ts +19 -1
  403. package/dist/internal/mcp-host.d.ts.map +1 -1
  404. package/dist/internal/mcp-host.js +67 -3
  405. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  406. package/dist/internal/mcp-oauth.js +5 -7
  407. package/dist/internal/oidcAudiences.d.ts +22 -0
  408. package/dist/internal/oidcAudiences.d.ts.map +1 -0
  409. package/dist/internal/oidcAudiences.js +35 -0
  410. package/dist/internal/otel/collector.d.ts.map +1 -1
  411. package/dist/internal/otel/collector.js +2 -0
  412. package/dist/internal/platform-timers.d.ts +2 -0
  413. package/dist/internal/platform-timers.d.ts.map +1 -1
  414. package/dist/internal/platform-timers.js +14 -0
  415. package/dist/internal/private-file.d.ts +32 -1
  416. package/dist/internal/private-file.d.ts.map +1 -1
  417. package/dist/internal/private-file.js +209 -7
  418. package/dist/internal/redact-values.d.ts +3 -0
  419. package/dist/internal/redact-values.d.ts.map +1 -0
  420. package/dist/internal/redact-values.js +19 -0
  421. package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
  422. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  423. package/dist/internal/reminder-followup-error.d.ts +23 -0
  424. package/dist/internal/reminder-followup-error.d.ts.map +1 -0
  425. package/dist/internal/reminder-followup-error.js +12 -0
  426. package/dist/internal/reminder-runner.d.ts +15 -1
  427. package/dist/internal/reminder-runner.d.ts.map +1 -1
  428. package/dist/internal/reminder-runner.js +95 -21
  429. package/dist/internal/resolved-connections.d.ts.map +1 -1
  430. package/dist/internal/resolved-connections.js +23 -3
  431. package/dist/internal/run-client.js +2 -1
  432. package/dist/internal/run-program.d.ts +31 -0
  433. package/dist/internal/run-program.d.ts.map +1 -0
  434. package/dist/internal/run-program.js +150 -0
  435. package/dist/internal/sdk-runner.d.ts +28 -2
  436. package/dist/internal/sdk-runner.d.ts.map +1 -1
  437. package/dist/internal/sdk-runner.js +298 -38
  438. package/dist/internal/server.d.ts.map +1 -1
  439. package/dist/internal/server.js +45 -4
  440. package/dist/internal/session-credential.d.ts +14 -0
  441. package/dist/internal/session-credential.d.ts.map +1 -0
  442. package/dist/internal/session-credential.js +25 -0
  443. package/dist/internal/session-engine.d.ts +136 -5
  444. package/dist/internal/session-engine.d.ts.map +1 -1
  445. package/dist/internal/session-engine.js +580 -92
  446. package/dist/internal/storage-coordinator.d.ts +3 -1
  447. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  448. package/dist/internal/storage-coordinator.js +13 -0
  449. package/dist/internal/storage-roles.d.ts +9 -1
  450. package/dist/internal/storage-roles.d.ts.map +1 -1
  451. package/dist/internal/teams-channel-profile.d.ts +41 -0
  452. package/dist/internal/teams-channel-profile.d.ts.map +1 -0
  453. package/dist/internal/teams-channel-profile.js +91 -0
  454. package/dist/internal/teams-devtunnel.d.ts +55 -0
  455. package/dist/internal/teams-devtunnel.d.ts.map +1 -0
  456. package/dist/internal/teams-devtunnel.js +205 -0
  457. package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
  458. package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
  459. package/dist/internal/teams-tunnel-proxy.js +100 -0
  460. package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
  461. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
  462. package/dist/internal/testing/conversation-identity-vectors.js +67 -0
  463. package/dist/internal/testing/hosted-http.d.ts +15 -0
  464. package/dist/internal/testing/hosted-http.d.ts.map +1 -0
  465. package/dist/internal/testing/hosted-http.js +86 -0
  466. package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
  467. package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
  468. package/dist/internal/testing/teams-activity-fixtures.js +236 -0
  469. package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
  470. package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
  471. package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
  472. package/dist/internal/tunnel-process.d.ts +29 -0
  473. package/dist/internal/tunnel-process.d.ts.map +1 -0
  474. package/dist/internal/tunnel-process.js +105 -0
  475. package/dist/internal/turn-context.d.ts +28 -0
  476. package/dist/internal/turn-context.d.ts.map +1 -0
  477. package/dist/internal/turn-context.js +1 -0
  478. package/dist/oidc-token.d.ts +127 -0
  479. package/dist/oidc-token.d.ts.map +1 -0
  480. package/dist/oidc-token.js +221 -0
  481. package/dist/playground/assets/index-BaBSZXki.css +1 -0
  482. package/dist/playground/assets/index-BkAF8YlO.js +62 -0
  483. package/dist/playground/index.html +2 -2
  484. package/dist/teams-app-package.d.ts +78 -0
  485. package/dist/teams-app-package.d.ts.map +1 -0
  486. package/dist/teams-app-package.js +204 -0
  487. package/dist/tools.d.ts +1 -1
  488. package/dist/tools.d.ts.map +1 -1
  489. package/dist/types.d.ts +271 -2
  490. package/dist/types.d.ts.map +1 -1
  491. package/docs/changelog.md +35 -0
  492. package/docs/deployment.md +10 -0
  493. package/docs/guides/cloud-agents.md +47 -0
  494. package/docs/guides/teams.md +389 -0
  495. package/docs/reference/channels.md +1 -0
  496. package/docs/reference/cli.md +116 -0
  497. package/docs/reference/limits.md +4 -4
  498. package/docs/reference/sessions.md +13 -0
  499. package/docs/troubleshooting.md +21 -0
  500. package/package.json +21 -46
  501. package/skills/create-agent/SKILL.md +17 -4
  502. package/skills/debug/SKILL.md +1 -0
  503. package/skills/deploy/SKILL.md +1 -1
  504. package/skills/framework-map/SKILL.md +1 -0
  505. package/skills/setup-teams/SKILL.md +141 -0
  506. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
  507. package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
  508. package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
  509. package/dist/docs/assets/changelog.md.DVNB-ApU.js +0 -1
  510. package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +0 -1
  511. package/dist/docs/assets/chunks/channel.CdyTxaXV.js +0 -1
  512. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +0 -1
  513. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +0 -1
  514. package/dist/docs/assets/chunks/clone.DpIwUbur.js +0 -1
  515. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +0 -1
  516. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
  517. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
  518. package/dist/playground/assets/index-CnFd5R1_.js +0 -62
  519. package/dist/playground/assets/index-DNzRv6G8.css +0 -1
  520. /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
  521. /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
@@ -0,0 +1,96 @@
1
+ import { createHash } from "node:crypto";
2
+ import { hostKvCas } from "../../internal/host-kv-cas.js";
3
+ import { isDuringHostedAdmission } from "../../internal/hosted-admission-context.js";
4
+ import { isRecord } from "../../internal/is-record.js";
5
+ const MARK_MAX = 5_000;
6
+ export function createTeamsMarks(deps) {
7
+ const now = deps.now ?? Date.now;
8
+ const local = new Map();
9
+ // Persistent hosting has no compare-and-swap on every deploy, so this is not a warning.
10
+ let loggedNotAtomic = false;
11
+ const logNotAtomic = () => {
12
+ if (!loggedNotAtomic) {
13
+ loggedNotAtomic = true;
14
+ deps.log("debug host.kv has no compare-and-swap, so a Teams mark claim is not atomic");
15
+ }
16
+ };
17
+ return {
18
+ async claim({ kv, key, ttlMs }) {
19
+ const nowMs = now();
20
+ const expiresAtMs = ttlMs === undefined ? null : nowMs + ttlMs;
21
+ const stored = storedKv(kv);
22
+ if (stored !== undefined) {
23
+ return claimStored({ kv: stored, key, expiresAtMs, nowMs, logNotAtomic });
24
+ }
25
+ return claimLocal(local, key, expiresAtMs, nowMs);
26
+ },
27
+ async release({ kv, key }) {
28
+ const stored = storedKv(kv);
29
+ if (stored !== undefined) {
30
+ await stored.delete(markStorageKey(key));
31
+ return;
32
+ }
33
+ local.delete(key);
34
+ },
35
+ };
36
+ }
37
+ /** Hosted admissions do not share this process's memory. */
38
+ function storedKv(kv) {
39
+ return isDuringHostedAdmission() ? kv : undefined;
40
+ }
41
+ function claimLocal(marks, key, expiresAtMs, nowMs) {
42
+ if (isLive(marks.get(key), nowMs)) {
43
+ return false;
44
+ }
45
+ marks.delete(key);
46
+ marks.set(key, expiresAtMs);
47
+ if (marks.size > MARK_MAX) {
48
+ const oldest = marks.keys().next().value;
49
+ if (oldest !== undefined) {
50
+ marks.delete(oldest);
51
+ }
52
+ }
53
+ return true;
54
+ }
55
+ async function claimStored({ kv, key, expiresAtMs, nowMs, logNotAtomic, }) {
56
+ const storageKey = markStorageKey(key);
57
+ const mark = { expiresAtMs };
58
+ const cas = hostKvCas(kv);
59
+ if (cas === undefined) {
60
+ logNotAtomic();
61
+ if (isLive(expiryOf(await kv.get(storageKey)), nowMs)) {
62
+ return false;
63
+ }
64
+ await kv.put(storageKey, mark);
65
+ return true;
66
+ }
67
+ const created = await cas.putIfAbsent(storageKey, mark);
68
+ if (created.ok) {
69
+ return true;
70
+ }
71
+ const current = created.current;
72
+ if (current === undefined) {
73
+ return (await cas.putIfAbsent(storageKey, mark)).ok;
74
+ }
75
+ if (isLive(expiryOf(current.value), nowMs)) {
76
+ return false;
77
+ }
78
+ return (await cas.putIfVersion(storageKey, mark, current.version)).ok;
79
+ }
80
+ function isLive(expiresAtMs, nowMs) {
81
+ return expiresAtMs !== undefined && (expiresAtMs === null || expiresAtMs > nowMs);
82
+ }
83
+ function expiryOf(value) {
84
+ if (!isRecord(value)) {
85
+ return undefined;
86
+ }
87
+ const expiresAtMs = value.expiresAtMs;
88
+ if (expiresAtMs === null) {
89
+ return null;
90
+ }
91
+ return typeof expiresAtMs === "number" ? expiresAtMs : undefined;
92
+ }
93
+ /** Hash the key so ids that contain `:`, `@`, or `;` stay one short path segment. */
94
+ function markStorageKey(key) {
95
+ return `teams/marks/${createHash("sha256").update(key).digest("hex")}`;
96
+ }
@@ -0,0 +1,27 @@
1
+ import { type TeamsConnector, type TeamsMember } from "./connector.js";
2
+ import type { TeamsAuthor, TeamsConversation } from "./types.js";
3
+ export type TeamsSenderVerdict = "member" | "external" | "unverified";
4
+ /** Tenant ids are GUIDs. Letter case is not part of the id. */
5
+ export declare function sameTeamsTenant(left: string | undefined, right: string | undefined): boolean;
6
+ /** External unless Teams names the member a member or owner of the expected tenant. */
7
+ export declare function isExternalTeamsMember(member: TeamsMember | undefined, tenantId: string): boolean;
8
+ export interface ExternalSenderCheck {
9
+ verdict(input: {
10
+ serviceUrl: string;
11
+ conversation: TeamsConversation;
12
+ author: TeamsAuthor;
13
+ tenantId: string;
14
+ }): Promise<TeamsSenderVerdict>;
15
+ }
16
+ /**
17
+ * Look a sender up once per team or conversation, because a member of
18
+ * one team can be a guest in another. A membership is kept longer than
19
+ * a refusal. A lookup that throws is unverified and is not kept, so the
20
+ * next message asks again.
21
+ */
22
+ export declare function createExternalSenderCheck(deps: {
23
+ connector: TeamsConnector;
24
+ log: (line: string) => void;
25
+ now?: () => number;
26
+ }): ExternalSenderCheck;
27
+ //# sourceMappingURL=senders.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"senders.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/senders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKjE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAOtE,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE5F;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOhG;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,KAAK,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,iBAAiB,CAAC;QAChC,MAAM,EAAE,WAAW,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjC;AAOD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,SAAS,EAAE,cAAc,CAAC;IAC1B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GAAG,mBAAmB,CA0CtB"}
@@ -0,0 +1,72 @@
1
+ import { TeamsConnectorError } from "./connector.js";
2
+ const VERDICT_CACHE_MAX = 2_000;
3
+ const HOME_TENANT_ROLES = new Set(["user", "member", "admin", "owner"]);
4
+ const VERDICT_TTL_MS = {
5
+ member: 10 * 60_000,
6
+ external: 2 * 60_000,
7
+ };
8
+ /** Tenant ids are GUIDs. Letter case is not part of the id. */
9
+ export function sameTeamsTenant(left, right) {
10
+ return left !== undefined && right !== undefined && left.toLowerCase() === right.toLowerCase();
11
+ }
12
+ /** External unless Teams names the member a member or owner of the expected tenant. */
13
+ export function isExternalTeamsMember(member, tenantId) {
14
+ return (member === undefined ||
15
+ member.userRole === undefined ||
16
+ !HOME_TENANT_ROLES.has(member.userRole) ||
17
+ !sameTeamsTenant(member.tenantId, tenantId));
18
+ }
19
+ /**
20
+ * Look a sender up once per team or conversation, because a member of
21
+ * one team can be a guest in another. A membership is kept longer than
22
+ * a refusal. A lookup that throws is unverified and is not kept, so the
23
+ * next message asks again.
24
+ */
25
+ export function createExternalSenderCheck(deps) {
26
+ const now = deps.now ?? Date.now;
27
+ const verdicts = new Map();
28
+ return {
29
+ async verdict({ serviceUrl, conversation, author, tenantId }) {
30
+ const nowMs = now();
31
+ const rosterId = conversation.teamId ?? conversation.id;
32
+ const key = `${tenantId}\n${rosterId}\n${author.id}`;
33
+ const cached = verdicts.get(key);
34
+ if (cached !== undefined && cached.expiresAtMs > nowMs) {
35
+ return cached.verdict;
36
+ }
37
+ if (cached !== undefined) {
38
+ verdicts.delete(key);
39
+ }
40
+ let member;
41
+ try {
42
+ member = await deps.connector.member({
43
+ serviceUrl,
44
+ conversationId: rosterId,
45
+ memberId: author.id,
46
+ });
47
+ }
48
+ catch (error) {
49
+ deps.log(lookupFailure(author.id, error));
50
+ return "unverified";
51
+ }
52
+ const verdict = isExternalTeamsMember(member, tenantId)
53
+ ? "external"
54
+ : "member";
55
+ verdicts.set(key, { verdict, expiresAtMs: nowMs + VERDICT_TTL_MS[verdict] });
56
+ if (verdicts.size > VERDICT_CACHE_MAX) {
57
+ const oldest = verdicts.keys().next().value;
58
+ if (oldest !== undefined) {
59
+ verdicts.delete(oldest);
60
+ }
61
+ }
62
+ return verdict;
63
+ },
64
+ };
65
+ }
66
+ function lookupFailure(authorId, error) {
67
+ if (error instanceof TeamsConnectorError) {
68
+ return `warn could not look up Teams sender ${authorId}: HTTP ${error.status}, so it is refused`;
69
+ }
70
+ const message = error instanceof Error ? error.message : String(error);
71
+ return `warn could not look up Teams sender ${authorId}: ${message}, so it is refused`;
72
+ }
@@ -0,0 +1,43 @@
1
+ import type { ChannelDefinition, ChannelHandlerArgs } from "../../types.js";
2
+ import { type BotFrameworkKeySource } from "./bot-framework-auth.js";
3
+ import { type TeamsSessionKeySource } from "./dispatch.js";
4
+ import type { TeamsChannelOptions, TeamsChannelState } from "./types.js";
5
+ /** @experimental */
6
+ export declare const TEAMS_CHANNEL_KIND = "teams";
7
+ export declare function getTeamsChannelOptions(definition: object): TeamsChannelOptions | undefined;
8
+ export interface TeamsChannelDeps {
9
+ keys?: BotFrameworkKeySource;
10
+ fetch?: (input: string, init?: RequestInit) => Promise<Response>;
11
+ now?: () => number;
12
+ /** Where each activity's session key comes from. Defaults to building it from the activity. */
13
+ sessionKey?: (request: Request, args: ChannelHandlerArgs) => TeamsSessionKeySource;
14
+ }
15
+ /**
16
+ * A Microsoft Teams channel for the customer's own Azure Bot. It mounts the
17
+ * Bot Framework messaging endpoint as its POST route. Set the Azure Bot's
18
+ * messaging endpoint to that route's public URL. Every activity must carry
19
+ * a valid Bot Framework JWT. Under `serve --dev`, an unsigned activity from
20
+ * loopback with no proxy headers is admitted so recorded activities can be
21
+ * replayed locally.
22
+ *
23
+ * ```ts
24
+ * import { teamsChannel } from "@grok/agent-sdk/channels/teams";
25
+ *
26
+ * // TEAMS_APP_ID, TEAMS_APP_PASSWORD, TEAMS_TENANT_ID
27
+ * // Hosting uses teams.thread/v2 with no continuation option.
28
+ * export default teamsChannel();
29
+ *
30
+ * // MY_AGENT_TEAMS_APP_ID, MY_AGENT_TEAMS_APP_PASSWORD, MY_AGENT_TEAMS_TENANT_ID
31
+ * export default teamsChannel({ envPrefix: "MY_AGENT" });
32
+ * ```
33
+ * @experimental
34
+ */
35
+ export declare function teamsChannel(options?: TeamsChannelOptions): ChannelDefinition<TeamsChannelState>;
36
+ export declare function createTeamsChannel(authored: TeamsChannelOptions, deps: TeamsChannelDeps): ChannelDefinition<TeamsChannelState>;
37
+ /**
38
+ * Architecture v2 deploy needs an app id the control plane can name, and a
39
+ * tenant it can check. A missing tenant, or a tenant that is only a
40
+ * function, fails that deploy. Architecture v1 still accepts those shapes.
41
+ */
42
+ export declare function teamsChannelArchitectureError(definition: object): string | undefined;
43
+ //# sourceMappingURL=teams-channel.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"teams-channel.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/teams-channel.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,yBAAyB,CAAC;AAWjC,OAAO,EAGL,KAAK,qBAAqB,EAE3B,MAAM,eAAe,CAAC;AAIvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzE,oBAAoB;AACpB,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAO1C,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE1F;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,KAAK,qBAAqB,CAAC;CACpF;AAYD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,CAAC,iBAAiB,CAAC,CAEtC;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,gBAAgB,GACrB,iBAAiB,CAAC,iBAAiB,CAAC,CA+JtC;AAyDD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAwBpF"}
@@ -0,0 +1,278 @@
1
+ import * as z from "zod/v4";
2
+ import { microsoftTeamsBotFrameworkActivityAuth, defineChannel, localDevStrict, POST, publicEndpoint, } from "../../channels.js";
3
+ import { skipped } from "../../internal/channel-dispatch.js";
4
+ import { normalizeIdentity } from "../../internal/continuation-identity.js";
5
+ import { isDevMode } from "../../internal/dev-mode.js";
6
+ import { createReleasableEventIdDedupe } from "../../internal/event-id-dedupe.js";
7
+ import { LOG_PRODUCT } from "../../internal/distribution.js";
8
+ import { attachHostedAdmissionAdapter } from "../../internal/hosted-admission-adapter.js";
9
+ import { CATCH_AUTH_CONTEXT, replayCatchRequest } from "../../internal/hosted-catch.js";
10
+ import { AGENT_SDK_CATCH_EVENT_TYPE, CATCH_CONTINUATION_KEY_HEADER, } from "../../internal/hosted-catch-protocol.js";
11
+ import { namedWebhookSecretArchitectureError } from "../../internal/named-webhook-secret.js";
12
+ import { isRecord } from "../../internal/is-record.js";
13
+ import { parseTeamsActivity } from "./activity.js";
14
+ import { createBotFrameworkKeySource, verifyBotFrameworkToken, } from "./bot-framework-auth.js";
15
+ import { createTeamsConnector } from "./connector.js";
16
+ import { resolveTeamsCredentials, teamsAppIdCatch, teamsCredentialEnv, teamsCredentialsFromEnv, teamsEnvKeys, teamsTenantCatch, } from "./credentials.js";
17
+ import { buildDefaultTeamsEvents, emptyTeamsChannelState } from "./delivery.js";
18
+ import { dispatchTeamsInbound, } from "./dispatch.js";
19
+ import { assertTeamsEngagement, createBotWakeBudget } from "./engagement.js";
20
+ import { createTeamsMarks } from "./marks.js";
21
+ import { createExternalSenderCheck } from "./senders.js";
22
+ /** @experimental */
23
+ export const TEAMS_CHANNEL_KIND = "teams";
24
+ /** A hosted Teams approval holds its guest VM while it waits, so the wait is bounded. */
25
+ const TEAMS_TOOL_APPROVAL_TIMEOUT_MS = 10 * 60_000;
26
+ const TEAMS_LOG_PREFIX = `[${LOG_PRODUCT}/teams]`;
27
+ const teamsChannelOptionsByDefinition = new WeakMap();
28
+ export function getTeamsChannelOptions(definition) {
29
+ return teamsChannelOptionsByDefinition.get(definition);
30
+ }
31
+ /**
32
+ * A hosted catch replay runs on the key the control plane admitted. Local
33
+ * serve builds the key from the activity.
34
+ */
35
+ function defaultSessionKey(request, args) {
36
+ return args.auth?.authenticator === CATCH_AUTH_CONTEXT.authenticator
37
+ ? { kind: "admitted", key: request.headers.get(CATCH_CONTINUATION_KEY_HEADER) || undefined }
38
+ : { kind: "local" };
39
+ }
40
+ /**
41
+ * A Microsoft Teams channel for the customer's own Azure Bot. It mounts the
42
+ * Bot Framework messaging endpoint as its POST route. Set the Azure Bot's
43
+ * messaging endpoint to that route's public URL. Every activity must carry
44
+ * a valid Bot Framework JWT. Under `serve --dev`, an unsigned activity from
45
+ * loopback with no proxy headers is admitted so recorded activities can be
46
+ * replayed locally.
47
+ *
48
+ * ```ts
49
+ * import { teamsChannel } from "@grok/agent-sdk/channels/teams";
50
+ *
51
+ * // TEAMS_APP_ID, TEAMS_APP_PASSWORD, TEAMS_TENANT_ID
52
+ * // Hosting uses teams.thread/v2 with no continuation option.
53
+ * export default teamsChannel();
54
+ *
55
+ * // MY_AGENT_TEAMS_APP_ID, MY_AGENT_TEAMS_APP_PASSWORD, MY_AGENT_TEAMS_TENANT_ID
56
+ * export default teamsChannel({ envPrefix: "MY_AGENT" });
57
+ * ```
58
+ * @experimental
59
+ */
60
+ export function teamsChannel(options = {}) {
61
+ return createTeamsChannel(options, {});
62
+ }
63
+ export function createTeamsChannel(authored, deps) {
64
+ const options = { ...authored };
65
+ if (options.continuation !== undefined) {
66
+ options.continuation = normalizeIdentity(options.continuation, TEAMS_CHANNEL_KIND);
67
+ }
68
+ assertTeamsEngagement(options.engagement);
69
+ const credentials = options.credentials ?? teamsCredentialsFromEnv(options.envPrefix);
70
+ const resolveCredentials = () => resolveTeamsCredentials(credentials);
71
+ const keys = deps.keys ?? createBotFrameworkKeySource({ fetch: deps.fetch });
72
+ let logger = options.logger;
73
+ const log = (line) => (logger ?? console.log)(`${TEAMS_LOG_PREFIX} ${line}`);
74
+ const connector = createTeamsConnector({
75
+ credentials: resolveCredentials,
76
+ fetch: deps.fetch,
77
+ now: deps.now,
78
+ });
79
+ let started;
80
+ const runtime = {
81
+ options,
82
+ connector,
83
+ dedupe: createReleasableEventIdDedupe(),
84
+ budget: createBotWakeBudget(options.engagement?.botMentions, deps.now),
85
+ senders: createExternalSenderCheck({ connector, log, now: deps.now }),
86
+ marks: createTeamsMarks({ now: deps.now, log }),
87
+ started: () => started,
88
+ log,
89
+ };
90
+ const defaults = options.deliverDefaults === false
91
+ ? {}
92
+ : buildDefaultTeamsEvents({
93
+ connector,
94
+ reply: options.reply ?? { mode: "post" },
95
+ toolLabels: options.toolLabels,
96
+ toolApprovals: options.toolApprovals === true,
97
+ log,
98
+ now: deps.now,
99
+ });
100
+ let warnedUnconfigured = false;
101
+ const appId = teamsAppIdCatch(options);
102
+ const tenant = teamsTenantCatch(options);
103
+ // A named app id and a named or literal tenant are checked on the control
104
+ // plane. Anything else stays public so architecture v1 can still receive
105
+ // Azure Bot deliveries. allowAll() would drop the route from that list.
106
+ const catchAuth = appId.kind === "named" && tenant.kind === "secret"
107
+ ? microsoftTeamsBotFrameworkActivityAuth({
108
+ secret: appId.secretName,
109
+ tenantSecret: tenant.secretName,
110
+ })
111
+ : appId.kind === "named" && tenant.kind === "literal"
112
+ ? microsoftTeamsBotFrameworkActivityAuth({
113
+ secret: appId.secretName,
114
+ tenantId: tenant.tenantId,
115
+ })
116
+ : publicEndpoint();
117
+ const definition = defineChannel({
118
+ auth: [catchAuth],
119
+ state: emptyTeamsChannelState(),
120
+ events: { ...defaults, ...options.events },
121
+ meta: {
122
+ kind: TEAMS_CHANNEL_KIND,
123
+ toolApprovalTimeoutMs: TEAMS_TOOL_APPROVAL_TIMEOUT_MS,
124
+ credentialEnv: options.credentials === undefined ? teamsCredentialEnv(options.envPrefix) : undefined,
125
+ teamsEngagement: {
126
+ mentions: options.engagement?.mentions ?? true,
127
+ directMessages: options.engagement?.directMessages ?? true,
128
+ channelPosts: options.engagement?.channelPosts === undefined
129
+ ? undefined
130
+ : [...options.engagement.channelPosts.allow],
131
+ includeBotPosts: options.engagement?.channelPosts === undefined
132
+ ? undefined
133
+ : options.engagement.channelPosts.includeBotPosts === true,
134
+ },
135
+ },
136
+ onStart: async (args) => {
137
+ logger ??= args.logger;
138
+ started = args;
139
+ if ((await resolveCredentials()) === undefined) {
140
+ const names = teamsEnvKeys(options.envPrefix);
141
+ log(`idle: set ${names.appId}, ${names.appPassword}, and ${names.tenantId} to answer Teams activities`);
142
+ }
143
+ },
144
+ routes: [
145
+ POST(options.path ?? "/", {
146
+ bodySchema: z.unknown(),
147
+ description: "Bot Framework messaging endpoint for Microsoft Teams",
148
+ handler: async (request, args) => {
149
+ const resolved = await resolveCredentials();
150
+ if (resolved === undefined) {
151
+ if (!warnedUnconfigured) {
152
+ warnedUnconfigured = true;
153
+ log("warn refusing an activity: the Teams app id, password, or tenant id is not set");
154
+ }
155
+ return Response.json({ ok: false, error: "teams_not_configured" }, { status: 503 });
156
+ }
157
+ // The control plane checked the token and the tenant before it
158
+ // admitted a hosted replay, and it strips the token.
159
+ const hosted = args.auth?.authenticator === CATCH_AUTH_CONTEXT.authenticator;
160
+ if (!hosted) {
161
+ const refusal = await refuseUnverified({
162
+ request,
163
+ args,
164
+ appId: resolved.appId,
165
+ keys,
166
+ nowMs: deps.now?.(),
167
+ log,
168
+ });
169
+ if (refusal !== undefined) {
170
+ return refusal;
171
+ }
172
+ }
173
+ const inbound = parseTeamsActivity(args.body);
174
+ if (inbound.kind === "ignored") {
175
+ return skipped(inbound.reason);
176
+ }
177
+ return dispatchTeamsInbound({
178
+ inbound,
179
+ tenantId: resolved.tenantId,
180
+ sessionKey: (deps.sessionKey ?? defaultSessionKey)(request, args),
181
+ args,
182
+ runtime,
183
+ });
184
+ },
185
+ }),
186
+ ],
187
+ });
188
+ teamsChannelOptionsByDefinition.set(definition, options);
189
+ attachHostedAdmissionAdapter(definition, {
190
+ kind: TEAMS_CHANNEL_KIND,
191
+ dispatch: async ({ channelId, eventType, payload, deliveryId, args, mailboxContinuationKey, }) => {
192
+ if (eventType !== AGENT_SDK_CATCH_EVENT_TYPE) {
193
+ return Response.json({ ok: false, error: "unsupported_teams_delivery" }, { status: 400 });
194
+ }
195
+ return replayCatchRequest({
196
+ channelId: channelId ?? TEAMS_CHANNEL_KIND,
197
+ deliveryId,
198
+ routes: definition.routes ?? [],
199
+ payload,
200
+ args,
201
+ auth: [catchAuth],
202
+ mailboxContinuationKey,
203
+ });
204
+ },
205
+ });
206
+ return definition;
207
+ }
208
+ /** The commercial Teams service host. An unsigned dev activity may only send replies there. */
209
+ const TEAMS_SERVICE_HOST = "smba.trafficmanager.net";
210
+ /**
211
+ * A tunnel adds proxy headers, so `localDevStrict()` refuses it and the token check still runs.
212
+ * An unsigned dev activity skips the token's `serviceurl` binding, so the channel refuses one
213
+ * a browser page sent (`Origin`) or one whose `serviceUrl` is not Teams: either would receive
214
+ * the bot's connector token.
215
+ */
216
+ async function refuseUnverified(input) {
217
+ const authorization = input.request.headers.get("authorization");
218
+ const activity = isRecord(input.args.body) ? input.args.body : {};
219
+ const serviceUrl = typeof activity.serviceUrl === "string" ? activity.serviceUrl : "";
220
+ const channelId = typeof activity.channelId === "string" ? activity.channelId : "";
221
+ if (authorization === null &&
222
+ !input.request.headers.has("origin") &&
223
+ isTeamsServiceUrl(serviceUrl) &&
224
+ isDevMode() &&
225
+ (await localDevStrict()(input.request, input.args)) !== null) {
226
+ input.log("dev: admitting an unsigned activity from loopback");
227
+ return undefined;
228
+ }
229
+ const check = await verifyBotFrameworkToken({
230
+ authorization,
231
+ appId: input.appId,
232
+ serviceUrl,
233
+ channelId,
234
+ keys: input.keys,
235
+ nowMs: input.nowMs,
236
+ });
237
+ if (check.ok) {
238
+ return undefined;
239
+ }
240
+ // The Bot Connector auth rules answer a key not endorsed for the activity's channel with 403.
241
+ const status = check.reason === "endorsement" ? 403 : 401;
242
+ return Response.json({ ok: false, error: "invalid_token", reason: check.reason }, { status });
243
+ }
244
+ function isTeamsServiceUrl(serviceUrl) {
245
+ if (!URL.canParse(serviceUrl)) {
246
+ return false;
247
+ }
248
+ const url = new URL(serviceUrl);
249
+ return url.protocol === "https:" && url.hostname === TEAMS_SERVICE_HOST;
250
+ }
251
+ /**
252
+ * Architecture v2 deploy needs an app id the control plane can name, and a
253
+ * tenant it can check. A missing tenant, or a tenant that is only a
254
+ * function, fails that deploy. Architecture v1 still accepts those shapes.
255
+ */
256
+ export function teamsChannelArchitectureError(definition) {
257
+ const options = getTeamsChannelOptions(definition);
258
+ if (options === undefined) {
259
+ return undefined;
260
+ }
261
+ if (teamsAppIdCatch(options).kind !== "named") {
262
+ return namedWebhookSecretArchitectureError({
263
+ option: "teamsChannel credentials.appId",
264
+ webhookSecret: options.credentials?.appId,
265
+ envName: teamsEnvKeys(options.envPrefix).appId,
266
+ verifies: "the Bot Framework token audience",
267
+ });
268
+ }
269
+ const tenant = teamsTenantCatch(options);
270
+ if (tenant.kind === "secret" || tenant.kind === "literal") {
271
+ return undefined;
272
+ }
273
+ const envName = teamsEnvKeys(options.envPrefix).tenantId;
274
+ const authored = tenant.kind === "function" ? "a function" : "missing";
275
+ return (`teamsChannel credentials.tenantId is ${authored}. Architecture "v2" requires the ` +
276
+ `home tenant of this single-tenant Azure Bot: { secretName: "${envName}" } or the tenant id. ` +
277
+ `The control plane compares the activity tenant with that value before any compute starts.`);
278
+ }
@@ -0,0 +1,7 @@
1
+ export declare function cutText(text: string, max: number): string;
2
+ /**
3
+ * Parts whose UTF-8 size inside a JSON string is at most `maxBytes`, cut at a line break when one
4
+ * fits and never inside a character. The Bot Connector measures the JSON body, where escapes grow.
5
+ */
6
+ export declare function splitTextByJsonBytes(text: string, maxBytes: number): string[];
7
+ //# sourceMappingURL=text.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/text.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKzD;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAe7E"}
@@ -0,0 +1,63 @@
1
+ export function cutText(text, max) {
2
+ if (text.length <= max) {
3
+ return text;
4
+ }
5
+ return text.slice(0, isHighSurrogate(text.charCodeAt(max - 1)) ? max - 1 : max);
6
+ }
7
+ function isHighSurrogate(code) {
8
+ return code >= 0xd800 && code <= 0xdbff;
9
+ }
10
+ /**
11
+ * Parts whose UTF-8 size inside a JSON string is at most `maxBytes`, cut at a line break when one
12
+ * fits and never inside a character. The Bot Connector measures the JSON body, where escapes grow.
13
+ */
14
+ export function splitTextByJsonBytes(text, maxBytes) {
15
+ const parts = [];
16
+ let rest = text;
17
+ for (let fits = jsonPrefixLength(rest, maxBytes); fits < rest.length;) {
18
+ const head = rest.slice(0, fits);
19
+ const lineBreak = head.lastIndexOf("\n");
20
+ const part = lineBreak > 0 ? head.slice(0, lineBreak) : head;
21
+ parts.push(part);
22
+ rest = rest.slice(part.length).replace(/^\n/, "");
23
+ fits = jsonPrefixLength(rest, maxBytes);
24
+ }
25
+ if (rest !== "" || parts.length === 0) {
26
+ parts.push(rest);
27
+ }
28
+ return parts;
29
+ }
30
+ /** UTF-16 length of the longest prefix of `text` whose JSON-escaped UTF-8 form fits in `maxBytes`. */
31
+ function jsonPrefixLength(text, maxBytes) {
32
+ let bytes = 0;
33
+ let length = 0;
34
+ for (const char of text) {
35
+ bytes += jsonSize(char.codePointAt(0) ?? 0);
36
+ if (bytes > maxBytes) {
37
+ break;
38
+ }
39
+ length += char.length;
40
+ }
41
+ return length;
42
+ }
43
+ /** `\b`, `\t`, `\n`, `\f` and `\r`; other control characters escape as `\uXXXX`. */
44
+ const SHORT_ESCAPES = new Set([0x08, 0x09, 0x0a, 0x0c, 0x0d]);
45
+ /** Bytes `JSON.stringify` writes for one code point inside a string. */
46
+ function jsonSize(codePoint) {
47
+ if (codePoint === 0x22 || codePoint === 0x5c) {
48
+ return 2;
49
+ }
50
+ if (codePoint < 0x20) {
51
+ return SHORT_ESCAPES.has(codePoint) ? 2 : 6;
52
+ }
53
+ if (codePoint >= 0xd800 && codePoint <= 0xdfff) {
54
+ return 6;
55
+ }
56
+ if (codePoint < 0x80) {
57
+ return 1;
58
+ }
59
+ if (codePoint < 0x800) {
60
+ return 2;
61
+ }
62
+ return codePoint < 0x10000 ? 3 : 4;
63
+ }