@grok/agent-sdk 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (530) hide show
  1. package/AGENTS.md +40 -0
  2. package/dist/channels/github/forward.d.ts +5 -0
  3. package/dist/channels/github/forward.d.ts.map +1 -1
  4. package/dist/channels/github/forward.js +6 -3
  5. package/dist/channels/slack/api.d.ts +18 -0
  6. package/dist/channels/slack/api.d.ts.map +1 -1
  7. package/dist/channels/slack/api.js +31 -0
  8. package/dist/channels/slack/approvals.d.ts +19 -2
  9. package/dist/channels/slack/approvals.d.ts.map +1 -1
  10. package/dist/channels/slack/approvals.js +90 -19
  11. package/dist/channels/slack/attachments.d.ts +7 -2
  12. package/dist/channels/slack/attachments.d.ts.map +1 -1
  13. package/dist/channels/slack/attachments.js +318 -156
  14. package/dist/channels/slack/connect-card.d.ts +16 -0
  15. package/dist/channels/slack/connect-card.d.ts.map +1 -0
  16. package/dist/channels/slack/connect-card.js +31 -0
  17. package/dist/channels/slack/credentials.d.ts +10 -2
  18. package/dist/channels/slack/credentials.d.ts.map +1 -1
  19. package/dist/channels/slack/credentials.js +17 -15
  20. package/dist/channels/slack/defaults.d.ts.map +1 -1
  21. package/dist/channels/slack/defaults.js +18 -9
  22. package/dist/channels/slack/dispatch.d.ts +1 -1
  23. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  24. package/dist/channels/slack/dispatch.js +19 -3
  25. package/dist/channels/slack/inbound.d.ts +8 -2
  26. package/dist/channels/slack/inbound.d.ts.map +1 -1
  27. package/dist/channels/slack/inbound.js +25 -4
  28. package/dist/channels/slack/index.d.ts +3 -2
  29. package/dist/channels/slack/index.d.ts.map +1 -1
  30. package/dist/channels/slack/index.js +3 -2
  31. package/dist/channels/slack/init.d.ts.map +1 -1
  32. package/dist/channels/slack/init.js +2 -1
  33. package/dist/channels/slack/manifest.d.ts.map +1 -1
  34. package/dist/channels/slack/manifest.js +2 -15
  35. package/dist/channels/slack/mentions.d.ts +28 -0
  36. package/dist/channels/slack/mentions.d.ts.map +1 -0
  37. package/dist/channels/slack/mentions.js +178 -0
  38. package/dist/channels/slack/setup.js +1 -1
  39. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  40. package/dist/channels/slack/slack-channel.js +46 -3
  41. package/dist/channels/slack/stop.d.ts.map +1 -1
  42. package/dist/channels/slack/stop.js +7 -1
  43. package/dist/channels/slack/thread-context.d.ts +3 -0
  44. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  45. package/dist/channels/slack/thread-context.js +17 -7
  46. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
  47. package/dist/channels/slack/tool-approval-events.js +55 -2
  48. package/dist/channels/slack/types.d.ts +2 -0
  49. package/dist/channels/slack/types.d.ts.map +1 -1
  50. package/dist/channels/teams/activity.d.ts +33 -0
  51. package/dist/channels/teams/activity.d.ts.map +1 -0
  52. package/dist/channels/teams/activity.js +213 -0
  53. package/dist/channels/teams/auth.d.ts +25 -0
  54. package/dist/channels/teams/auth.d.ts.map +1 -0
  55. package/dist/channels/teams/auth.js +55 -0
  56. package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
  57. package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
  58. package/dist/channels/teams/bot-framework-auth.js +154 -0
  59. package/dist/channels/teams/cards.d.ts +23 -0
  60. package/dist/channels/teams/cards.d.ts.map +1 -0
  61. package/dist/channels/teams/cards.js +107 -0
  62. package/dist/channels/teams/connector.d.ts +48 -0
  63. package/dist/channels/teams/connector.d.ts.map +1 -0
  64. package/dist/channels/teams/connector.js +159 -0
  65. package/dist/channels/teams/credentials.d.ts +65 -0
  66. package/dist/channels/teams/credentials.d.ts.map +1 -0
  67. package/dist/channels/teams/credentials.js +84 -0
  68. package/dist/channels/teams/delivery.d.ts +14 -0
  69. package/dist/channels/teams/delivery.d.ts.map +1 -0
  70. package/dist/channels/teams/delivery.js +169 -0
  71. package/dist/channels/teams/dispatch.d.ts +45 -0
  72. package/dist/channels/teams/dispatch.d.ts.map +1 -0
  73. package/dist/channels/teams/dispatch.js +402 -0
  74. package/dist/channels/teams/engagement.d.ts +32 -0
  75. package/dist/channels/teams/engagement.d.ts.map +1 -0
  76. package/dist/channels/teams/engagement.js +120 -0
  77. package/dist/channels/teams/index.d.ts +21 -0
  78. package/dist/channels/teams/index.d.ts.map +1 -0
  79. package/dist/channels/teams/index.js +19 -0
  80. package/dist/channels/teams/marks.d.ts +19 -0
  81. package/dist/channels/teams/marks.d.ts.map +1 -0
  82. package/dist/channels/teams/marks.js +96 -0
  83. package/dist/channels/teams/senders.d.ts +27 -0
  84. package/dist/channels/teams/senders.d.ts.map +1 -0
  85. package/dist/channels/teams/senders.js +72 -0
  86. package/dist/channels/teams/teams-channel.d.ts +43 -0
  87. package/dist/channels/teams/teams-channel.d.ts.map +1 -0
  88. package/dist/channels/teams/teams-channel.js +278 -0
  89. package/dist/channels/teams/text.d.ts +7 -0
  90. package/dist/channels/teams/text.d.ts.map +1 -0
  91. package/dist/channels/teams/text.js +63 -0
  92. package/dist/channels/teams/types.d.ts +306 -0
  93. package/dist/channels/teams/types.d.ts.map +1 -0
  94. package/dist/channels/teams/types.js +1 -0
  95. package/dist/channels.d.ts +31 -0
  96. package/dist/channels.d.ts.map +1 -1
  97. package/dist/channels.js +37 -0
  98. package/dist/connections.d.ts +1 -1
  99. package/dist/connections.d.ts.map +1 -1
  100. package/dist/docs/404.html +3 -3
  101. package/dist/docs/assets/{app.CYdjweqP.js → app.Ch-048af.js} +4 -4
  102. package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
  103. package/dist/docs/assets/{changelog.md.BMrJ5WxW.lean.js → changelog.md.SoN0MK7o.lean.js} +1 -1
  104. package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +1 -0
  105. package/dist/docs/assets/chunks/{VPLocalSearchBox.CRATKS9J.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
  106. package/dist/docs/assets/chunks/{arc.BxM78ISR.js → arc.BIzu7OVF.js} +1 -1
  107. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.Bi6MuKaU.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
  108. package/dist/docs/assets/chunks/{baseUniq.L47qqpDG.js → baseUniq.B4y6Y5eG.js} +1 -1
  109. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.kHFF2FK5.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
  110. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BTW85ll3.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
  111. package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
  112. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.Bbh3_48g.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
  113. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.WeAmK3fK.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
  114. package/dist/docs/assets/chunks/{chunk-55IACEB6.DTdUiVHf.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
  115. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.n5XzANDz.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
  116. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.D51eewCb.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
  117. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.BrY0U7ZV.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
  118. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B0OA4aFV.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
  119. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Djt3Mjft.js → chunk-YZCP3GAM.CwrYtDVo.js} +1 -1
  120. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +1 -0
  121. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +1 -0
  122. package/dist/docs/assets/chunks/clone.F824-PNx.js +1 -0
  123. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DiMcA6Q8.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
  124. package/dist/docs/assets/chunks/{dagre-KV5264BT.BGqI4vrS.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
  125. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.bDqFuMoH.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
  126. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Y0sxaXRU.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
  127. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Bg43b0yi.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
  128. package/dist/docs/assets/chunks/{diagram-TYMM5635.DCfVasEC.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
  129. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.C72GaD16.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
  130. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.DxRQj7pP.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
  131. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DiLZy5Q4.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
  132. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.DL8XkRvh.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
  133. package/dist/docs/assets/chunks/{graph.3Xub80xJ.js → graph.CdOyJvsX.js} +1 -1
  134. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.O3lGaspu.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
  135. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.w-pCiQzn.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
  136. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cg_oBs9j.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
  137. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.BpfMGPwn.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
  138. package/dist/docs/assets/chunks/{layout.CtwXs__p.js → layout.DDwvoQlY.js} +1 -1
  139. package/dist/docs/assets/chunks/{linear.NmCskOrP.js → linear.BRXPDWj3.js} +1 -1
  140. package/dist/docs/assets/chunks/{min.DpQtsLKs.js → min.3YwC0t3o.js} +1 -1
  141. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.B-P-aKVp.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
  142. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.BfjjqK7j.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
  143. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BTzHo53F.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
  144. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DIT2FIKr.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
  145. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.NK1wCsgt.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
  146. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.D9oElkvo.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
  147. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.IPksnixH.js → stateDiagram-FHFEXIEX.B_SGgvgs.js} +1 -1
  148. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +1 -0
  149. package/dist/docs/assets/chunks/{theme.CgKu7tr3.js → theme.bNyH5NPA.js} +2 -2
  150. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CuAtJapY.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
  151. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.B87nNW9E.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
  152. package/dist/docs/assets/chunks/wardley-RL74JXVD.DQqE3WF8.js +162 -0
  153. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BELjSq8w.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
  154. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.5zN5ZGsz.js → xychartDiagram-5P7HB3ND.DnJA2aXp.js} +1 -1
  155. package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.N9S5KC5R.js} +2 -2
  156. package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.N9S5KC5R.lean.js} +1 -1
  157. package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
  158. package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
  159. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
  160. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
  161. package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
  162. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
  163. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
  164. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
  165. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
  166. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  167. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
  168. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
  169. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
  170. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
  171. package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
  172. package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
  173. package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
  174. package/dist/docs/building-with-agents.html +37 -37
  175. package/dist/docs/changelog.html +37 -37
  176. package/dist/docs/changelog.md +51 -0
  177. package/dist/docs/deployment.html +39 -39
  178. package/dist/docs/deployment.md +10 -0
  179. package/dist/docs/evals.html +37 -37
  180. package/dist/docs/guides/agent-to-agent.html +37 -37
  181. package/dist/docs/guides/bitbucket.html +37 -37
  182. package/dist/docs/guides/cloud-agents.html +43 -38
  183. package/dist/docs/guides/cloud-agents.md +47 -0
  184. package/dist/docs/guides/convert-automation.html +37 -37
  185. package/dist/docs/guides/github.html +37 -37
  186. package/dist/docs/guides/gitlab.html +37 -37
  187. package/dist/docs/guides/improve.html +37 -37
  188. package/dist/docs/guides/jev.html +37 -37
  189. package/dist/docs/guides/mcp-oauth.html +37 -37
  190. package/dist/docs/guides/migrate.html +37 -37
  191. package/dist/docs/guides/opentelemetry.html +37 -37
  192. package/dist/docs/guides/pagerduty.html +37 -37
  193. package/dist/docs/guides/slack.html +37 -37
  194. package/dist/docs/guides/teams.html +109 -0
  195. package/dist/docs/guides/teams.md +384 -0
  196. package/dist/docs/guides/webhooks.html +37 -37
  197. package/dist/docs/hashmap.json +1 -1
  198. package/dist/docs/hillclimbing.html +37 -37
  199. package/dist/docs/index.html +37 -37
  200. package/dist/docs/llms-full.txt +652 -4
  201. package/dist/docs/llms.txt +1 -0
  202. package/dist/docs/quickstart.html +37 -37
  203. package/dist/docs/reference/access.html +36 -36
  204. package/dist/docs/reference/agent-config.html +37 -37
  205. package/dist/docs/reference/artifacts.html +37 -37
  206. package/dist/docs/reference/channels.html +38 -38
  207. package/dist/docs/reference/channels.md +1 -0
  208. package/dist/docs/reference/cli.html +50 -40
  209. package/dist/docs/reference/cli.md +116 -0
  210. package/dist/docs/reference/connections.html +37 -37
  211. package/dist/docs/reference/evals.html +37 -37
  212. package/dist/docs/reference/extensions.html +37 -37
  213. package/dist/docs/reference/hooks.html +37 -37
  214. package/dist/docs/reference/http-api.html +37 -37
  215. package/dist/docs/reference/instructions.html +37 -37
  216. package/dist/docs/reference/limits.html +39 -39
  217. package/dist/docs/reference/limits.md +4 -4
  218. package/dist/docs/reference/memory.html +37 -37
  219. package/dist/docs/reference/playground.html +36 -36
  220. package/dist/docs/reference/project-layout.html +37 -37
  221. package/dist/docs/reference/schedules.html +40 -40
  222. package/dist/docs/reference/sessions.html +38 -38
  223. package/dist/docs/reference/sessions.md +13 -0
  224. package/dist/docs/reference/skills.html +40 -40
  225. package/dist/docs/reference/subagents.html +37 -37
  226. package/dist/docs/reference/tools.html +37 -37
  227. package/dist/docs/templates/agentic-owners.html +37 -37
  228. package/dist/docs/templates/reviews.html +37 -37
  229. package/dist/docs/troubleshooting.html +38 -38
  230. package/dist/docs/troubleshooting.md +21 -0
  231. package/dist/evals/run-facts.d.ts.map +1 -1
  232. package/dist/evals/run-facts.js +4 -0
  233. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
  234. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
  235. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
  236. package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
  237. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  238. package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
  239. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
  240. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
  241. package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
  242. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
  243. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  244. package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
  245. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
  246. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
  247. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
  248. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
  249. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
  250. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
  251. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
  252. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
  253. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
  254. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
  255. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
  256. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
  257. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
  258. package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
  259. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
  260. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
  261. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
  262. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
  263. package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
  264. package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
  265. package/dist/extensions.d.ts.map +1 -1
  266. package/dist/extensions.js +18 -3
  267. package/dist/files-backends/agent-store-presigned-url.js +5 -1
  268. package/dist/index.d.ts +1 -0
  269. package/dist/index.d.ts.map +1 -1
  270. package/dist/index.js +1 -0
  271. package/dist/internal/approval-gate.d.ts +6 -1
  272. package/dist/internal/approval-gate.d.ts.map +1 -1
  273. package/dist/internal/approval-gate.js +13 -2
  274. package/dist/internal/authored-loaders.js +1 -1
  275. package/dist/internal/channel-architecture.d.ts.map +1 -1
  276. package/dist/internal/channel-architecture.js +3 -1
  277. package/dist/internal/cli/commands/channels.d.ts +9 -3
  278. package/dist/internal/cli/commands/channels.d.ts.map +1 -1
  279. package/dist/internal/cli/commands/channels.js +193 -4
  280. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  281. package/dist/internal/cli/commands/index.js +6 -1
  282. package/dist/internal/cli/commands/serve.d.ts.map +1 -1
  283. package/dist/internal/cli/commands/serve.js +25 -5
  284. package/dist/internal/cli/dispatch.d.ts.map +1 -1
  285. package/dist/internal/cli/dispatch.js +22 -8
  286. package/dist/internal/cli/flags.d.ts +14 -0
  287. package/dist/internal/cli/flags.d.ts.map +1 -1
  288. package/dist/internal/cli/flags.js +14 -0
  289. package/dist/internal/cli/help.d.ts.map +1 -1
  290. package/dist/internal/cli/help.js +3 -1
  291. package/dist/internal/cli-cursor.js +2 -2
  292. package/dist/internal/cli-deploy.d.ts +1 -0
  293. package/dist/internal/cli-deploy.d.ts.map +1 -1
  294. package/dist/internal/cli-deploy.js +31 -8
  295. package/dist/internal/cli-mcp.d.ts.map +1 -1
  296. package/dist/internal/cli-mcp.js +5 -3
  297. package/dist/internal/cli-teams-doctor.d.ts +39 -0
  298. package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
  299. package/dist/internal/cli-teams-doctor.js +508 -0
  300. package/dist/internal/cli-teams-forward.d.ts +84 -0
  301. package/dist/internal/cli-teams-forward.d.ts.map +1 -0
  302. package/dist/internal/cli-teams-forward.js +386 -0
  303. package/dist/internal/cli-teams-package.d.ts +26 -0
  304. package/dist/internal/cli-teams-package.d.ts.map +1 -0
  305. package/dist/internal/cli-teams-package.js +123 -0
  306. package/dist/internal/cli-teams.d.ts +15 -0
  307. package/dist/internal/cli-teams.d.ts.map +1 -0
  308. package/dist/internal/cli-teams.js +253 -0
  309. package/dist/internal/connect-click.d.ts +12 -0
  310. package/dist/internal/connect-click.d.ts.map +1 -0
  311. package/dist/internal/connect-click.js +22 -0
  312. package/dist/internal/continuation-channel.d.ts +5 -1
  313. package/dist/internal/continuation-channel.d.ts.map +1 -1
  314. package/dist/internal/continuation-channel.js +34 -0
  315. package/dist/internal/continuation-identity.d.ts +7 -4
  316. package/dist/internal/continuation-identity.d.ts.map +1 -1
  317. package/dist/internal/continuation-identity.js +66 -1
  318. package/dist/internal/convert-automation/convert-workflow.js +2 -2
  319. package/dist/internal/credential-env-names.d.ts +36 -0
  320. package/dist/internal/credential-env-names.d.ts.map +1 -0
  321. package/dist/internal/credential-env-names.js +68 -0
  322. package/dist/internal/cursor/account-mcp.d.ts +67 -9
  323. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  324. package/dist/internal/cursor/account-mcp.js +206 -25
  325. package/dist/internal/cursor/backend-client.d.ts +10 -1
  326. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  327. package/dist/internal/cursor/backend-client.js +19 -7
  328. package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
  329. package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
  330. package/dist/internal/cursor/cloud-agent-identity.js +224 -0
  331. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  332. package/dist/internal/cursor/credentials.js +3 -1
  333. package/dist/internal/cursor-account-mcp-auth.d.ts +1 -0
  334. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  335. package/dist/internal/cursor-account-mcp-auth.js +2 -1
  336. package/dist/internal/deploy-client.d.ts.map +1 -1
  337. package/dist/internal/deploy-client.js +34 -2
  338. package/dist/internal/deploy-manifest.d.ts +51 -3
  339. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  340. package/dist/internal/deploy-manifest.js +96 -7
  341. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  342. package/dist/internal/discovery/agent-config.js +6 -1
  343. package/dist/internal/discovery/connections.d.ts.map +1 -1
  344. package/dist/internal/discovery/connections.js +53 -0
  345. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  346. package/dist/internal/discovery/extensions.js +2 -0
  347. package/dist/internal/discovery/info.d.ts.map +1 -1
  348. package/dist/internal/discovery/info.js +4 -0
  349. package/dist/internal/env-file.d.ts +1 -0
  350. package/dist/internal/env-file.d.ts.map +1 -1
  351. package/dist/internal/env-file.js +18 -17
  352. package/dist/internal/env-prefix.d.ts +11 -0
  353. package/dist/internal/env-prefix.d.ts.map +1 -0
  354. package/dist/internal/env-prefix.js +23 -0
  355. package/dist/internal/event-id-dedupe.d.ts +12 -0
  356. package/dist/internal/event-id-dedupe.d.ts.map +1 -0
  357. package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
  358. package/dist/internal/event-mapper.d.ts +7 -2
  359. package/dist/internal/event-mapper.d.ts.map +1 -1
  360. package/dist/internal/event-mapper.js +7 -0
  361. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  362. package/dist/internal/expected-delivery-failure.js +3 -0
  363. package/dist/internal/extension-namespace.d.ts +9 -0
  364. package/dist/internal/extension-namespace.d.ts.map +1 -0
  365. package/dist/internal/extension-namespace.js +14 -0
  366. package/dist/internal/guid.d.ts +2 -0
  367. package/dist/internal/guid.d.ts.map +1 -0
  368. package/dist/internal/guid.js +4 -0
  369. package/dist/internal/host-kv-cas.d.ts +13 -0
  370. package/dist/internal/host-kv-cas.d.ts.map +1 -0
  371. package/dist/internal/host-kv-cas.js +8 -0
  372. package/dist/internal/host-kv.d.ts +4 -1
  373. package/dist/internal/host-kv.d.ts.map +1 -1
  374. package/dist/internal/host-kv.js +15 -2
  375. package/dist/internal/hosted-catch-protocol.d.ts +5 -0
  376. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  377. package/dist/internal/hosted-catch-protocol.js +5 -0
  378. package/dist/internal/hosted-catch.d.ts +2 -0
  379. package/dist/internal/hosted-catch.d.ts.map +1 -1
  380. package/dist/internal/hosted-catch.js +6 -1
  381. package/dist/internal/hosted-delivery-protocol.d.ts +6 -0
  382. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  383. package/dist/internal/hosted-delivery-protocol.js +71 -1
  384. package/dist/internal/hosted-delivery.d.ts +5 -2
  385. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  386. package/dist/internal/hosted-delivery.js +36 -12
  387. package/dist/internal/hosted-execution-latency.d.ts +3 -0
  388. package/dist/internal/hosted-execution-latency.d.ts.map +1 -1
  389. package/dist/internal/hosted-execution-latency.js +11 -0
  390. package/dist/internal/hosted-session-fixture.js +1 -1
  391. package/dist/internal/hosting.d.ts +5 -0
  392. package/dist/internal/hosting.d.ts.map +1 -1
  393. package/dist/internal/hosting.js +7 -1
  394. package/dist/internal/install-cursor-skills.d.ts +6 -7
  395. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  396. package/dist/internal/install-cursor-skills.js +15 -9
  397. package/dist/internal/interview/agent-questions.d.ts +1 -1
  398. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  399. package/dist/internal/interview/agent-questions.js +4 -3
  400. package/dist/internal/local-control-plane.d.ts.map +1 -1
  401. package/dist/internal/local-control-plane.js +24 -0
  402. package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
  403. package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
  404. package/dist/internal/mcp-allowlist-in-use.js +93 -0
  405. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  406. package/dist/internal/mcp-endpoint.js +8 -10
  407. package/dist/internal/mcp-host.d.ts +19 -1
  408. package/dist/internal/mcp-host.d.ts.map +1 -1
  409. package/dist/internal/mcp-host.js +67 -3
  410. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  411. package/dist/internal/mcp-oauth.js +5 -7
  412. package/dist/internal/oidcAudiences.d.ts +22 -0
  413. package/dist/internal/oidcAudiences.d.ts.map +1 -0
  414. package/dist/internal/oidcAudiences.js +35 -0
  415. package/dist/internal/otel/collector.d.ts.map +1 -1
  416. package/dist/internal/otel/collector.js +2 -0
  417. package/dist/internal/platform-timers.d.ts +2 -0
  418. package/dist/internal/platform-timers.d.ts.map +1 -1
  419. package/dist/internal/platform-timers.js +14 -0
  420. package/dist/internal/private-file.d.ts +32 -1
  421. package/dist/internal/private-file.d.ts.map +1 -1
  422. package/dist/internal/private-file.js +209 -7
  423. package/dist/internal/redact-values.d.ts +3 -0
  424. package/dist/internal/redact-values.d.ts.map +1 -0
  425. package/dist/internal/redact-values.js +19 -0
  426. package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
  427. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  428. package/dist/internal/reminder-followup-error.d.ts +23 -0
  429. package/dist/internal/reminder-followup-error.d.ts.map +1 -0
  430. package/dist/internal/reminder-followup-error.js +12 -0
  431. package/dist/internal/reminder-runner.d.ts +15 -1
  432. package/dist/internal/reminder-runner.d.ts.map +1 -1
  433. package/dist/internal/reminder-runner.js +95 -21
  434. package/dist/internal/resolved-connections.d.ts.map +1 -1
  435. package/dist/internal/resolved-connections.js +23 -3
  436. package/dist/internal/run-client.js +2 -1
  437. package/dist/internal/run-program.d.ts +31 -0
  438. package/dist/internal/run-program.d.ts.map +1 -0
  439. package/dist/internal/run-program.js +150 -0
  440. package/dist/internal/sdk-runner.d.ts +29 -3
  441. package/dist/internal/sdk-runner.d.ts.map +1 -1
  442. package/dist/internal/sdk-runner.js +304 -38
  443. package/dist/internal/server.d.ts.map +1 -1
  444. package/dist/internal/server.js +53 -8
  445. package/dist/internal/session-credential.d.ts +14 -0
  446. package/dist/internal/session-credential.d.ts.map +1 -0
  447. package/dist/internal/session-credential.js +25 -0
  448. package/dist/internal/session-engine.d.ts +137 -5
  449. package/dist/internal/session-engine.d.ts.map +1 -1
  450. package/dist/internal/session-engine.js +606 -92
  451. package/dist/internal/storage-coordinator.d.ts +3 -1
  452. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  453. package/dist/internal/storage-coordinator.js +13 -0
  454. package/dist/internal/storage-roles.d.ts +9 -1
  455. package/dist/internal/storage-roles.d.ts.map +1 -1
  456. package/dist/internal/tcp-address.d.ts +3 -1
  457. package/dist/internal/tcp-address.d.ts.map +1 -1
  458. package/dist/internal/tcp-address.js +6 -0
  459. package/dist/internal/teams-channel-profile.d.ts +41 -0
  460. package/dist/internal/teams-channel-profile.d.ts.map +1 -0
  461. package/dist/internal/teams-channel-profile.js +91 -0
  462. package/dist/internal/teams-devtunnel.d.ts +55 -0
  463. package/dist/internal/teams-devtunnel.d.ts.map +1 -0
  464. package/dist/internal/teams-devtunnel.js +205 -0
  465. package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
  466. package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
  467. package/dist/internal/teams-tunnel-proxy.js +100 -0
  468. package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
  469. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
  470. package/dist/internal/testing/conversation-identity-vectors.js +67 -0
  471. package/dist/internal/testing/hosted-http.d.ts +15 -0
  472. package/dist/internal/testing/hosted-http.d.ts.map +1 -0
  473. package/dist/internal/testing/hosted-http.js +86 -0
  474. package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
  475. package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
  476. package/dist/internal/testing/teams-activity-fixtures.js +236 -0
  477. package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
  478. package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
  479. package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
  480. package/dist/internal/tunnel-process.d.ts +29 -0
  481. package/dist/internal/tunnel-process.d.ts.map +1 -0
  482. package/dist/internal/tunnel-process.js +105 -0
  483. package/dist/internal/turn-context.d.ts +28 -0
  484. package/dist/internal/turn-context.d.ts.map +1 -0
  485. package/dist/internal/turn-context.js +1 -0
  486. package/dist/oidc-token.d.ts +127 -0
  487. package/dist/oidc-token.d.ts.map +1 -0
  488. package/dist/oidc-token.js +221 -0
  489. package/dist/playground/assets/index-BaBSZXki.css +1 -0
  490. package/dist/playground/assets/index-BkAF8YlO.js +62 -0
  491. package/dist/playground/index.html +2 -2
  492. package/dist/teams-app-package.d.ts +78 -0
  493. package/dist/teams-app-package.d.ts.map +1 -0
  494. package/dist/teams-app-package.js +204 -0
  495. package/dist/tools.d.ts +1 -1
  496. package/dist/tools.d.ts.map +1 -1
  497. package/dist/types.d.ts +278 -2
  498. package/dist/types.d.ts.map +1 -1
  499. package/docs/changelog.md +51 -0
  500. package/docs/deployment.md +10 -0
  501. package/docs/guides/cloud-agents.md +47 -0
  502. package/docs/guides/teams.md +389 -0
  503. package/docs/reference/channels.md +1 -0
  504. package/docs/reference/cli.md +116 -0
  505. package/docs/reference/limits.md +4 -4
  506. package/docs/reference/sessions.md +13 -0
  507. package/docs/troubleshooting.md +21 -0
  508. package/package.json +21 -46
  509. package/skills/create-agent/SKILL.md +17 -4
  510. package/skills/debug/SKILL.md +1 -0
  511. package/skills/deploy/SKILL.md +1 -1
  512. package/skills/framework-map/SKILL.md +1 -0
  513. package/skills/setup-teams/SKILL.md +141 -0
  514. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
  515. package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
  516. package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
  517. package/dist/docs/assets/changelog.md.BMrJ5WxW.js +0 -1
  518. package/dist/docs/assets/chunks/@localSearchIndexroot.dUaE1f8e.js +0 -1
  519. package/dist/docs/assets/chunks/channel.ljJtQtBi.js +0 -1
  520. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BZ3Uc-XU.js +0 -1
  521. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BZ3Uc-XU.js +0 -1
  522. package/dist/docs/assets/chunks/clone.BDtbEo69.js +0 -1
  523. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CbhzVsQE.js +0 -1
  524. package/dist/docs/assets/chunks/wardley-RL74JXVD.BFIVMaoi.js +0 -162
  525. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
  526. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
  527. package/dist/playground/assets/index-D0-FHg1x.css +0 -1
  528. package/dist/playground/assets/index-D5SLKUy6.js +0 -62
  529. /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
  530. /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
@@ -0,0 +1,386 @@
1
+ import { channelRoutePath, targetLabel } from "../channels/github/forward.js";
2
+ import { CliError, errorCodeForStatus } from "./cli/errors.js";
3
+ import { describeError, unknownErrorCode } from "./describe-error.js";
4
+ import { CLI_COMMAND_NAME as CLI } from "./distribution.js";
5
+ import { isRecord } from "./is-record.js";
6
+ import { mergeRequestHeaders } from "./request-headers.js";
7
+ import { selectTeamsChannelProfiles, TEAMS_CHANNEL_KIND, teamsTarget, } from "./teams-channel-profile.js";
8
+ import { ensureDevTunnel, openDevTunnel, } from "./teams-devtunnel.js";
9
+ import { startTeamsPathProxy } from "./teams-tunnel-proxy.js";
10
+ import { openTunnelProcess } from "./tunnel-process.js";
11
+ const DEFAULT_HOST = "127.0.0.1";
12
+ const DEFAULT_PORT = 3000;
13
+ export function teamsChannelTargets(agents) {
14
+ return agents.flatMap(({ slug, info }) => info.channels
15
+ .filter((channel) => channel.kind === TEAMS_CHANNEL_KIND)
16
+ .map((channel) => teamsTarget({ slug, channelId: channel.id, routes: channel.routes })));
17
+ }
18
+ export function teamsMessagingEndpoint(baseUrl, target) {
19
+ return `${baseUrl.replace(/\/+$/, "")}${channelRoutePath(target)}`;
20
+ }
21
+ const QUICK_TUNNEL_URL = /https:\/\/[a-z0-9-]+\.trycloudflare\.com(?![a-z0-9.-])/gi;
22
+ /** cloudflared also logs `https://api.trycloudflare.com` when the tunnel request fails. */
23
+ export function parseQuickTunnelUrl(line) {
24
+ for (const match of line.matchAll(QUICK_TUNNEL_URL)) {
25
+ const url = new URL(match[0]);
26
+ if (url.hostname !== "api.trycloudflare.com") {
27
+ return url.origin;
28
+ }
29
+ }
30
+ return undefined;
31
+ }
32
+ export const CLOUDFLARED_INSTALL_URL = "https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/";
33
+ const CLOUDFLARED_INSTALL_HINT = `Install cloudflared from ${CLOUDFLARED_INSTALL_URL}`;
34
+ export async function openQuickTunnel(input) {
35
+ return openTunnelProcess({
36
+ command: "cloudflared",
37
+ args: ["tunnel", "--no-autoupdate", "--url", input.localUrl],
38
+ signal: input.signal,
39
+ spawnImpl: input.spawnImpl,
40
+ timeoutMs: input.timeoutMs,
41
+ parseUrl: parseQuickTunnelUrl,
42
+ program: "cloudflared",
43
+ installHint: CLOUDFLARED_INSTALL_HINT,
44
+ });
45
+ }
46
+ function whenAborted(signal) {
47
+ return new Promise((resolveAbort) => {
48
+ if (signal.aborted) {
49
+ resolveAbort();
50
+ return;
51
+ }
52
+ signal.addEventListener("abort", () => resolveAbort(), { once: true });
53
+ });
54
+ }
55
+ const TUNNEL_TEXT = {
56
+ cloudflared: {
57
+ opening: (localUrl) => `Opening a cloudflared quick tunnel to ${localUrl}, where the agent must be serving.\n`,
58
+ label: "cloudflared",
59
+ urlNote: () => "The URL changes each time the tunnel starts.",
60
+ apply: (count) => count === 1
61
+ ? "Set it on the Azure Bot: Configuration, Messaging endpoint, Apply."
62
+ : "Set each on its agent's Azure Bot: Configuration, Messaging endpoint, Apply.",
63
+ },
64
+ devtunnel: {
65
+ opening: (localUrl) => `Opening a dev tunnel to ${localUrl}, where the agent must be serving.\n`,
66
+ label: "devtunnel",
67
+ urlNote: (tunnelId) => `The URL stays the same while dev tunnel ${tunnelId} exists. Microsoft deletes a dev tunnel after 30 days without use, and the next start creates it again under the same id.`,
68
+ apply: (count) => count === 1
69
+ ? "Set it on the Azure Bot once: Configuration, Messaging endpoint, Apply."
70
+ : "Set each on its agent's Azure Bot once: Configuration, Messaging endpoint, Apply.",
71
+ idleWarning: "--tunnel devtunnel had no effect because no agent has a Teams channel.",
72
+ },
73
+ };
74
+ function formatTunnelReady(input) {
75
+ const endpoints = input.targets.map((target) => ({
76
+ label: targetLabel(target),
77
+ endpoint: teamsMessagingEndpoint(input.publicUrl, target),
78
+ }));
79
+ if (input.json) {
80
+ const payload = { endpoints, localUrl: input.localUrl, tunnel: input.text.label };
81
+ if (input.tunnelId !== undefined) {
82
+ payload.tunnelId = input.tunnelId;
83
+ }
84
+ return `${JSON.stringify(payload)}\n`;
85
+ }
86
+ const width = Math.max(...endpoints.map(({ label }) => label.length));
87
+ const lines = endpoints.length === 1
88
+ ? [
89
+ "Teams messaging endpoint:",
90
+ ...endpoints.map(({ endpoint }) => ` ${endpoint}`),
91
+ input.text.apply(1),
92
+ ]
93
+ : [
94
+ "Teams messaging endpoints:",
95
+ ...endpoints.map(({ label, endpoint }) => ` ${label.padEnd(width)} ${endpoint}`),
96
+ input.text.apply(endpoints.length),
97
+ ];
98
+ return [
99
+ ...lines,
100
+ input.text.urlNote(input.tunnelId ?? ""),
101
+ `Tunnel: ${input.text.label} -> ${input.localUrl}, Teams messaging paths only. Press Ctrl-C to stop.`,
102
+ "",
103
+ ].join("\n");
104
+ }
105
+ async function planTeamsTunnel(input) {
106
+ const choice = input.tunnel ?? { kind: "cloudflared" };
107
+ if (choice.kind === "cloudflared") {
108
+ return {
109
+ text: TUNNEL_TEXT.cloudflared,
110
+ open: (proxyUrl) => (input.openTunnel ?? openQuickTunnel)({
111
+ localUrl: proxyUrl,
112
+ signal: input.signal,
113
+ spawnImpl: input.spawnImpl,
114
+ }),
115
+ };
116
+ }
117
+ if (input.dir === undefined) {
118
+ throw new CliError("a dev tunnel needs the project directory.");
119
+ }
120
+ const ready = await ensureDevTunnel({
121
+ dir: input.dir,
122
+ tunnelId: choice.tunnelId,
123
+ port: input.port,
124
+ signal: input.signal,
125
+ exec: input.exec,
126
+ }).catch((error) => {
127
+ if (input.signal.aborted) {
128
+ return undefined;
129
+ }
130
+ throw error;
131
+ });
132
+ if (ready === undefined || input.signal.aborted) {
133
+ return undefined;
134
+ }
135
+ return {
136
+ text: TUNNEL_TEXT.devtunnel,
137
+ tunnelId: ready.tunnelId,
138
+ proxyPort: ready.port,
139
+ open: () => openDevTunnel({
140
+ tunnelId: ready.tunnelId,
141
+ port: ready.port,
142
+ signal: input.signal,
143
+ spawnImpl: input.spawnImpl,
144
+ }),
145
+ };
146
+ }
147
+ async function startTunnelProxy(input) {
148
+ try {
149
+ return await startTeamsPathProxy({
150
+ upstream: input.localUrl,
151
+ paths: input.paths,
152
+ port: input.port,
153
+ });
154
+ }
155
+ catch (error) {
156
+ if (input.port !== undefined && unknownErrorCode(error) === "EADDRINUSE") {
157
+ throw new CliError(`port ${input.port} is in use. The dev tunnel forwards it to the Teams proxy. Stop the process that holds it.`);
158
+ }
159
+ throw error;
160
+ }
161
+ }
162
+ /**
163
+ * Opens one tunnel that reaches only the targets' messaging paths on
164
+ * `localUrl`, prints every endpoint, and holds the tunnel until `signal`
165
+ * aborts or the tunnel process exits. Returns 0 after a stop request, else
166
+ * the process exit code.
167
+ */
168
+ export async function runTeamsTunnel(input) {
169
+ const { signal } = input;
170
+ const plan = await planTeamsTunnel(input);
171
+ if (plan === undefined) {
172
+ return 0;
173
+ }
174
+ const proxy = await startTunnelProxy({
175
+ localUrl: input.localUrl,
176
+ paths: input.targets.map(channelRoutePath),
177
+ port: plan.proxyPort,
178
+ });
179
+ try {
180
+ const tunnel = await plan.open(proxy.url).catch((error) => {
181
+ if (signal.aborted) {
182
+ return undefined;
183
+ }
184
+ throw error;
185
+ });
186
+ if (tunnel === undefined || signal.aborted) {
187
+ return 0;
188
+ }
189
+ input.out(formatTunnelReady({
190
+ publicUrl: tunnel.publicUrl,
191
+ localUrl: input.localUrl,
192
+ targets: input.targets,
193
+ json: input.json === true,
194
+ text: plan.text,
195
+ tunnelId: plan.tunnelId,
196
+ }));
197
+ const code = await Promise.race([tunnel.exited, whenAborted(signal).then(() => 0)]);
198
+ // Ctrl-C reaches the tunnel process too, so its close can land just before the stop request.
199
+ if (signal.aborted) {
200
+ await tunnel.exited;
201
+ return 0;
202
+ }
203
+ input.err(`${plan.text.label} exited with code ${code}.\n`);
204
+ return code;
205
+ }
206
+ finally {
207
+ await proxy.close();
208
+ }
209
+ }
210
+ function firstLine(text) {
211
+ return text.split("\n", 1)[0] ?? text;
212
+ }
213
+ /**
214
+ * Opens the Teams tunnel for `agent-sdk dev` when an agent on the server has a
215
+ * Teams channel. Never rejects: a failure is one warning line on `err`, and
216
+ * the server keeps serving.
217
+ */
218
+ export async function startDevTeamsTunnel(input) {
219
+ const out = input.out ?? ((text) => void process.stdout.write(text));
220
+ const err = input.err ?? ((text) => void process.stderr.write(text));
221
+ const warn = (reason) => err(`warning: Teams tunnel: ${reason}\n`);
222
+ const choice = input.tunnel ?? { kind: "cloudflared" };
223
+ try {
224
+ const targets = teamsChannelTargets(input.handle.agents);
225
+ if (targets.length === 0) {
226
+ const idleWarning = TUNNEL_TEXT[choice.kind].idleWarning;
227
+ if (idleWarning !== undefined) {
228
+ warn(idleWarning);
229
+ }
230
+ return;
231
+ }
232
+ await runTeamsTunnel({
233
+ localUrl: input.handle.url,
234
+ targets,
235
+ signal: input.signal,
236
+ out,
237
+ err: (text) => warn(text.trim()),
238
+ tunnel: choice,
239
+ dir: input.dir,
240
+ port: input.port,
241
+ exec: input.exec,
242
+ spawnImpl: input.spawnImpl,
243
+ openTunnel: input.openTunnel,
244
+ });
245
+ }
246
+ catch (error) {
247
+ const hint = error instanceof CliError && error.hint !== undefined ? ` ${error.hint}` : "";
248
+ warn(`${firstLine(describeError(error))}${hint}`);
249
+ }
250
+ }
251
+ /**
252
+ * Agents from host `GET /v1/health`, then each agent's channels from its info
253
+ * route. A health body with no `agents` array is one single-mode mount at
254
+ * `/v1/info` (empty slug). Multi-mode lists `{ slug }` and serves info at
255
+ * `/<slug>/v1/info`.
256
+ */
257
+ async function readServedAgents(input) {
258
+ const health = await fetchServerJson({
259
+ baseUrl: input.baseUrl,
260
+ path: "/v1/health",
261
+ bearerToken: input.bearerToken,
262
+ });
263
+ const agents = [];
264
+ for (const slug of slugsFromHealth(health)) {
265
+ const path = agentInfoPath(slug);
266
+ const info = await fetchServerJson({
267
+ baseUrl: input.baseUrl,
268
+ path,
269
+ bearerToken: input.bearerToken,
270
+ });
271
+ agents.push({ slug, info: { channels: readChannels(info, path) } });
272
+ }
273
+ return agents;
274
+ }
275
+ function slugsFromHealth(body) {
276
+ if (!isRecord(body)) {
277
+ throw new CliError("GET /v1/health did not return a health document.");
278
+ }
279
+ if (!Array.isArray(body.agents)) {
280
+ return [""];
281
+ }
282
+ return body.agents.map((agent) => {
283
+ if (!isRecord(agent) || typeof agent.slug !== "string") {
284
+ throw new CliError("GET /v1/health listed an agent without a slug.");
285
+ }
286
+ return agent.slug;
287
+ });
288
+ }
289
+ function agentInfoPath(slug) {
290
+ if (slug === "") {
291
+ return "/v1/info";
292
+ }
293
+ if (slug.includes("/") || slug.includes("\\") || slug === "." || slug === "..") {
294
+ throw new CliError(`GET /v1/health listed an agent slug that is not a path segment: ${slug}`);
295
+ }
296
+ return `/${slug}/v1/info`;
297
+ }
298
+ function readChannels(body, path) {
299
+ if (!isRecord(body) || !Array.isArray(body.channels)) {
300
+ throw new CliError(`GET ${path} did not return agent info.`);
301
+ }
302
+ return body.channels.map((channel) => readChannel(channel, path));
303
+ }
304
+ function readChannel(channel, path) {
305
+ if (!isRecord(channel) || typeof channel.id !== "string" || !Array.isArray(channel.routes)) {
306
+ throw new CliError(`GET ${path} returned a channel without an id and routes.`);
307
+ }
308
+ const routes = [];
309
+ for (const route of channel.routes) {
310
+ if (!isRecord(route) || typeof route.method !== "string" || typeof route.path !== "string") {
311
+ throw new CliError(`GET ${path} returned a channel route without a method and path.`);
312
+ }
313
+ routes.push({ method: route.method, path: route.path });
314
+ }
315
+ return {
316
+ id: channel.id,
317
+ kind: typeof channel.kind === "string" ? channel.kind : undefined,
318
+ routes,
319
+ };
320
+ }
321
+ async function fetchServerJson(input) {
322
+ let response;
323
+ try {
324
+ response = await fetch(`${input.baseUrl}${input.path}`, {
325
+ headers: mergeRequestHeaders({ bearerToken: input.bearerToken }),
326
+ });
327
+ }
328
+ catch (error) {
329
+ throw new CliError(`Could not reach ${input.baseUrl}. Start \`${CLI} serve\`, then point \`${CLI} channels teams forward\` at that host and port.`, { code: "unavailable", cause: error });
330
+ }
331
+ const text = await response.text();
332
+ if (!response.ok) {
333
+ const code = errorCodeForStatus(response.status);
334
+ throw new CliError(`GET ${input.path} returned HTTP ${response.status}.`, {
335
+ code,
336
+ hint: code === "unauthenticated" || code === "permission_denied"
337
+ ? `Pass the token from \`${CLI} serve --bearer-token\`.`
338
+ : undefined,
339
+ });
340
+ }
341
+ try {
342
+ return JSON.parse(text);
343
+ }
344
+ catch (error) {
345
+ throw new CliError(`GET ${input.path} did not return JSON.`, { cause: error });
346
+ }
347
+ }
348
+ export async function cmdTeamsForward(options) {
349
+ const out = options.out ?? ((text) => void process.stdout.write(text));
350
+ const err = options.err ?? ((text) => void process.stderr.write(text));
351
+ const localUrl = `http://${options.host ?? DEFAULT_HOST}:${options.port ?? DEFAULT_PORT}`;
352
+ const served = teamsChannelTargets(await readServedAgents({ baseUrl: localUrl, bearerToken: options.bearerToken }));
353
+ if (served.length === 0) {
354
+ throw new CliError(`no Teams channel found on the server at ${localUrl}. Add one with \`${CLI} channels teams init\`, then restart \`${CLI} serve\`.`);
355
+ }
356
+ const targets = selectTeamsChannelProfiles(served, {
357
+ dir: options.dir,
358
+ slug: options.slug,
359
+ channel: options.channel,
360
+ });
361
+ const choice = options.tunnel ?? { kind: "cloudflared" };
362
+ const stop = new AbortController();
363
+ const requestStop = () => stop.abort();
364
+ process.on("SIGINT", requestStop);
365
+ process.on("SIGTERM", requestStop);
366
+ try {
367
+ if (options.json !== true) {
368
+ out(TUNNEL_TEXT[choice.kind].opening(localUrl));
369
+ }
370
+ return await runTeamsTunnel({
371
+ localUrl,
372
+ targets,
373
+ signal: options.signal === undefined ? stop.signal : AbortSignal.any([stop.signal, options.signal]),
374
+ out,
375
+ err,
376
+ json: options.json,
377
+ tunnel: choice,
378
+ dir: options.dir,
379
+ openTunnel: options.openTunnel,
380
+ });
381
+ }
382
+ finally {
383
+ process.off("SIGINT", requestStop);
384
+ process.off("SIGTERM", requestStop);
385
+ }
386
+ }
@@ -0,0 +1,26 @@
1
+ import { type TeamsBotScope } from "../teams-app-package.js";
2
+ export interface TeamsPackageReport {
3
+ ok: true;
4
+ path: string;
5
+ appId: string;
6
+ version: string;
7
+ scopes: TeamsBotScope[];
8
+ channelPosts: boolean;
9
+ notes: string[];
10
+ }
11
+ export interface TeamsPackageOptions {
12
+ dir: string;
13
+ slug?: string;
14
+ channel?: string;
15
+ name?: string;
16
+ icon?: string;
17
+ appVersion?: string;
18
+ endpoint?: string;
19
+ now?: Date;
20
+ dryRun?: boolean;
21
+ json?: boolean;
22
+ out?: (text: string) => void;
23
+ outPath?: string;
24
+ }
25
+ export declare function cmdTeamsPackage(options: TeamsPackageOptions): Promise<number>;
26
+ //# sourceMappingURL=cli-teams-package.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-teams-package.d.ts","sourceRoot":"","sources":["../../src/internal/cli-teams-package.ts"],"names":[],"mappings":"AAEA,OAAO,EAQL,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AAgBjC,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDnF"}
@@ -0,0 +1,123 @@
1
+ import { readFile, writeFile } from "node:fs/promises";
2
+ import { basename, join, resolve } from "node:path";
3
+ import { buildTeamsAppPackage, DEFAULT_TEAMS_APP_ENGAGEMENT, teamsAppManifest, teamsAppPackageFileName, teamsAppPackageVersion, } from "../teams-app-package.js";
4
+ import { CliError } from "./cli/errors.js";
5
+ import { CLI_COMMAND_NAME as CLI } from "./distribution.js";
6
+ import { describeError } from "./describe-error.js";
7
+ import { ensureGitignoreEntry } from "./env-file.js";
8
+ import { isGuid } from "./guid.js";
9
+ import { loadAgentLocalEnv } from "./local-env.js";
10
+ import { credentialsInCodeMessage, loadTeamsChannelProfile, } from "./teams-channel-profile.js";
11
+ const TEAMS_APP_ZIP_GITIGNORE = "*-teams-app.zip";
12
+ const UPLOAD_LINE = "Upload it in Teams: Apps, Manage your apps, Upload an app.";
13
+ export async function cmdTeamsPackage(options) {
14
+ const out = options.out ?? ((text) => void process.stdout.write(text));
15
+ const dir = resolve(options.dir);
16
+ const profile = await loadTeamsChannelProfile({
17
+ dir: options.dir,
18
+ slug: options.slug,
19
+ channel: options.channel,
20
+ });
21
+ loadAgentLocalEnv(dir);
22
+ const notes = [];
23
+ if (options.dryRun === true) {
24
+ notes.push("Dry run. Nothing written.");
25
+ }
26
+ const appId = readAppId(profile);
27
+ const engagement = engagementFor(profile, notes);
28
+ const packageSlug = profile.slug !== "" ? profile.slug : basename(dir);
29
+ const input = {
30
+ appId,
31
+ name: options.name ?? packageSlug,
32
+ version: options.appVersion ?? teamsAppPackageVersion(options.now ?? new Date()),
33
+ engagement,
34
+ messagingEndpoints: options.endpoint === undefined ? [] : [options.endpoint],
35
+ colorIcon: options.icon === undefined ? undefined : await readColorIcon(options.icon),
36
+ };
37
+ let manifest;
38
+ let zip;
39
+ try {
40
+ manifest = teamsAppManifest(input);
41
+ zip = buildTeamsAppPackage(input, manifest);
42
+ }
43
+ catch (error) {
44
+ throw invalidArgumentOrRethrow(error);
45
+ }
46
+ const zipPath = options.outPath === undefined
47
+ ? join(dir, teamsAppPackageFileName(packageSlug))
48
+ : resolve(options.outPath);
49
+ if (options.dryRun !== true) {
50
+ await writeFile(zipPath, zip);
51
+ if (options.outPath === undefined) {
52
+ await ensureGitignoreEntry(dir, TEAMS_APP_ZIP_GITIGNORE);
53
+ }
54
+ }
55
+ const report = {
56
+ ok: true,
57
+ path: zipPath,
58
+ appId,
59
+ version: manifest.version,
60
+ scopes: manifest.bots[0].scopes,
61
+ channelPosts: engagement.channelPosts,
62
+ notes,
63
+ };
64
+ out(options.json === true
65
+ ? `${JSON.stringify(report, null, 2)}\n`
66
+ : renderReport(report, options.dryRun === true));
67
+ return 0;
68
+ }
69
+ function engagementFor(profile, notes) {
70
+ if (profile.engagement !== undefined) {
71
+ return profile.engagement;
72
+ }
73
+ notes.push("The channel does not declare which chats it answers. The app allows personal chats and @mentions.");
74
+ return DEFAULT_TEAMS_APP_ENGAGEMENT;
75
+ }
76
+ function readAppId(profile) {
77
+ if (profile.credentialEnv === undefined) {
78
+ throw new CliError(`${credentialsInCodeMessage(profile)}, and package needs the app id.`, {
79
+ code: "failed_precondition",
80
+ hint: "Read the credentials from env (teamsChannel() or teamsChannel({ envPrefix })) to build the package.",
81
+ });
82
+ }
83
+ const keys = profile.credentialEnv.keys;
84
+ const value = process.env[keys.appId]?.trim() ?? "";
85
+ if (value === "") {
86
+ throw new CliError(`${keys.appId} is missing. Run \`${CLI} channels teams init\`.`, {
87
+ code: "failed_precondition",
88
+ });
89
+ }
90
+ if (!isGuid(value)) {
91
+ throw new CliError(`${keys.appId} must be a GUID such as 00000000-0000-0000-0000-000000000000.`, { code: "invalid_argument" });
92
+ }
93
+ return value;
94
+ }
95
+ function invalidArgumentOrRethrow(error) {
96
+ if (!(error instanceof Error)) {
97
+ throw error;
98
+ }
99
+ return new CliError(error.message, { code: "invalid_argument", cause: error });
100
+ }
101
+ async function readColorIcon(iconPath) {
102
+ try {
103
+ return new Uint8Array(await readFile(iconPath));
104
+ }
105
+ catch (error) {
106
+ throw new CliError(`could not read --icon ${iconPath}: ${describeError(error)}`, {
107
+ code: "invalid_argument",
108
+ cause: error,
109
+ });
110
+ }
111
+ }
112
+ function renderReport(report, dryRun) {
113
+ const lines = [
114
+ `${dryRun ? "Would write" : "Wrote"} ${report.path}`,
115
+ `App ID: ${report.appId}`,
116
+ `Version: ${report.version}`,
117
+ `Scopes: ${report.scopes.join(", ")}`,
118
+ `Channel-post consent: ${report.channelPosts ? "yes" : "no"}`,
119
+ ...report.notes.map((note) => `note: ${note}`),
120
+ UPLOAD_LINE,
121
+ ];
122
+ return `${lines.join("\n")}\n`;
123
+ }
@@ -0,0 +1,15 @@
1
+ import { type SecretInputStream } from "./cli-deploy.js";
2
+ export declare function formatTeamsSetupGuide(): string;
3
+ export interface TeamsInitOptions {
4
+ dir: string;
5
+ appId?: string;
6
+ tenantId?: string;
7
+ prefix?: string;
8
+ dryRun?: boolean;
9
+ json?: boolean;
10
+ stdin?: SecretInputStream;
11
+ out?: (text: string) => void;
12
+ err?: (text: string) => void;
13
+ }
14
+ export declare function cmdTeamsInit(options: TeamsInitOptions): Promise<number>;
15
+ //# sourceMappingURL=cli-teams.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-teams.d.ts","sourceRoot":"","sources":["../../src/internal/cli-teams.ts"],"names":[],"mappings":"AAOA,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAoF1E,wBAAgB,qBAAqB,IAAI,MAAM,CAsB9C;AA+FD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8F7E"}