@grok/agent-sdk 0.6.0 → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +40 -0
- package/dist/channels/github/cursor-account.d.ts +1 -0
- package/dist/channels/github/cursor-account.d.ts.map +1 -1
- package/dist/channels/github/cursor-account.js +8 -2
- package/dist/channels/github/forward.d.ts +5 -0
- package/dist/channels/github/forward.d.ts.map +1 -1
- package/dist/channels/github/forward.js +6 -3
- package/dist/channels/origin/cursor-account.d.ts +6 -0
- package/dist/channels/origin/cursor-account.d.ts.map +1 -1
- package/dist/channels/origin/cursor-account.js +17 -0
- package/dist/channels/slack/api.d.ts +18 -0
- package/dist/channels/slack/api.d.ts.map +1 -1
- package/dist/channels/slack/api.js +31 -0
- package/dist/channels/slack/approvals.d.ts +19 -2
- package/dist/channels/slack/approvals.d.ts.map +1 -1
- package/dist/channels/slack/approvals.js +90 -19
- package/dist/channels/slack/attachments.d.ts +7 -2
- package/dist/channels/slack/attachments.d.ts.map +1 -1
- package/dist/channels/slack/attachments.js +318 -156
- package/dist/channels/slack/connect-card.d.ts +16 -0
- package/dist/channels/slack/connect-card.d.ts.map +1 -0
- package/dist/channels/slack/connect-card.js +31 -0
- package/dist/channels/slack/credentials.d.ts +10 -2
- package/dist/channels/slack/credentials.d.ts.map +1 -1
- package/dist/channels/slack/credentials.js +17 -15
- package/dist/channels/slack/defaults.d.ts.map +1 -1
- package/dist/channels/slack/defaults.js +18 -9
- package/dist/channels/slack/dispatch.d.ts +1 -1
- package/dist/channels/slack/dispatch.d.ts.map +1 -1
- package/dist/channels/slack/dispatch.js +19 -3
- package/dist/channels/slack/inbound.d.ts +8 -2
- package/dist/channels/slack/inbound.d.ts.map +1 -1
- package/dist/channels/slack/inbound.js +25 -4
- package/dist/channels/slack/index.d.ts +3 -2
- package/dist/channels/slack/index.d.ts.map +1 -1
- package/dist/channels/slack/index.js +3 -2
- package/dist/channels/slack/init.d.ts.map +1 -1
- package/dist/channels/slack/init.js +2 -1
- package/dist/channels/slack/mentions.d.ts +28 -0
- package/dist/channels/slack/mentions.d.ts.map +1 -0
- package/dist/channels/slack/mentions.js +178 -0
- package/dist/channels/slack/setup.js +1 -1
- package/dist/channels/slack/slack-channel.d.ts.map +1 -1
- package/dist/channels/slack/slack-channel.js +46 -3
- package/dist/channels/slack/stop.d.ts.map +1 -1
- package/dist/channels/slack/stop.js +7 -1
- package/dist/channels/slack/thread-context.d.ts +3 -0
- package/dist/channels/slack/thread-context.d.ts.map +1 -1
- package/dist/channels/slack/thread-context.js +17 -7
- package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
- package/dist/channels/slack/tool-approval-events.js +55 -2
- package/dist/channels/slack/types.d.ts +2 -0
- package/dist/channels/slack/types.d.ts.map +1 -1
- package/dist/channels/teams/activity.d.ts +33 -0
- package/dist/channels/teams/activity.d.ts.map +1 -0
- package/dist/channels/teams/activity.js +213 -0
- package/dist/channels/teams/auth.d.ts +25 -0
- package/dist/channels/teams/auth.d.ts.map +1 -0
- package/dist/channels/teams/auth.js +55 -0
- package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
- package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
- package/dist/channels/teams/bot-framework-auth.js +154 -0
- package/dist/channels/teams/cards.d.ts +23 -0
- package/dist/channels/teams/cards.d.ts.map +1 -0
- package/dist/channels/teams/cards.js +107 -0
- package/dist/channels/teams/connector.d.ts +48 -0
- package/dist/channels/teams/connector.d.ts.map +1 -0
- package/dist/channels/teams/connector.js +159 -0
- package/dist/channels/teams/credentials.d.ts +65 -0
- package/dist/channels/teams/credentials.d.ts.map +1 -0
- package/dist/channels/teams/credentials.js +84 -0
- package/dist/channels/teams/delivery.d.ts +14 -0
- package/dist/channels/teams/delivery.d.ts.map +1 -0
- package/dist/channels/teams/delivery.js +169 -0
- package/dist/channels/teams/dispatch.d.ts +45 -0
- package/dist/channels/teams/dispatch.d.ts.map +1 -0
- package/dist/channels/teams/dispatch.js +402 -0
- package/dist/channels/teams/engagement.d.ts +32 -0
- package/dist/channels/teams/engagement.d.ts.map +1 -0
- package/dist/channels/teams/engagement.js +120 -0
- package/dist/channels/teams/index.d.ts +21 -0
- package/dist/channels/teams/index.d.ts.map +1 -0
- package/dist/channels/teams/index.js +19 -0
- package/dist/channels/teams/marks.d.ts +19 -0
- package/dist/channels/teams/marks.d.ts.map +1 -0
- package/dist/channels/teams/marks.js +96 -0
- package/dist/channels/teams/senders.d.ts +27 -0
- package/dist/channels/teams/senders.d.ts.map +1 -0
- package/dist/channels/teams/senders.js +72 -0
- package/dist/channels/teams/teams-channel.d.ts +43 -0
- package/dist/channels/teams/teams-channel.d.ts.map +1 -0
- package/dist/channels/teams/teams-channel.js +278 -0
- package/dist/channels/teams/text.d.ts +7 -0
- package/dist/channels/teams/text.d.ts.map +1 -0
- package/dist/channels/teams/text.js +63 -0
- package/dist/channels/teams/types.d.ts +306 -0
- package/dist/channels/teams/types.d.ts.map +1 -0
- package/dist/channels/teams/types.js +1 -0
- package/dist/channels.d.ts +31 -0
- package/dist/channels.d.ts.map +1 -1
- package/dist/channels.js +37 -0
- package/dist/connections.d.ts +1 -1
- package/dist/connections.d.ts.map +1 -1
- package/dist/docs/404.html +3 -3
- package/dist/docs/assets/{app.lt-BYgI2.js → app.CpLKJnOA.js} +4 -4
- package/dist/docs/assets/changelog.md.DoOgjnPC.js +1 -0
- package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.DoOgjnPC.lean.js} +1 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BJ_1eI6D.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.Cr1HJ_9k.js} +2 -2
- package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BjpgGAMM.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.CKdhNPPk.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.iovoEQbg.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BYQIeDre.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY.gbWi2q8N.js} +1 -1
- package/dist/docs/assets/chunks/channel.BP0n324b.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.1Mem4UG9.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.Dn3H-X_H.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.BkpSDZwX.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.BScqy1zP.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.Cp394LWf.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.BDv9LhoL.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.CsgCcrKO.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.BKBpIC5O.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BhTtyWMA.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BhTtyWMA.js +1 -0
- package/dist/docs/assets/chunks/clone.BVK2rFqj.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.Bs3ZS9PC.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.CgWi0tY2.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.rn6qIo9N.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.ChhW8oww.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.C0wH5KSk.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.CNEcrwA0.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DCsnKO-7.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.WCMkfvP0.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.BUb1Sxfr.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF._kORbCzm.js} +1 -1
- package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.PrGRm4KW.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.BxhCjiQM.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.5ddTis2y.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BUStU27-.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.CJd1psl3.js} +1 -1
- package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DqvbZSML.js} +1 -1
- package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.DOmz-1UB.js} +1 -1
- package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.33k2v8dM.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.iISCqCXC.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.BHvVgzmD.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.CY3w_-Cn.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.CHXKQS1v.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.DTtRoGss.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.NnPcQ3eY.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.D8DFciH7.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ESAwmMws.js +1 -0
- package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.CwkiT-Fo.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ._wIWkMU6.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.NLVv7R6r.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DbsCXUZp.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.Dp5uAVDl.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.eOEBq4rX.js} +1 -1
- package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.CIRydNl3.js} +3 -3
- package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.CIRydNl3.lean.js} +1 -1
- package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
- package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
- package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
- package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
- package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.js +82 -0
- package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.lean.js +1 -0
- package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.js → reference_agent-config.md.CfM1S6Ac.js} +2 -2
- package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.lean.js → reference_agent-config.md.CfM1S6Ac.lean.js} +1 -1
- package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
- package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
- package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
- package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
- package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
- package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
- package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
- package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
- package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
- package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
- package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
- package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
- package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
- package/dist/docs/building-with-agents.html +37 -37
- package/dist/docs/changelog.html +37 -37
- package/dist/docs/changelog.md +43 -0
- package/dist/docs/deployment.html +40 -40
- package/dist/docs/deployment.md +14 -0
- package/dist/docs/evals.html +37 -37
- package/dist/docs/guides/agent-to-agent.html +37 -37
- package/dist/docs/guides/bitbucket.html +37 -37
- package/dist/docs/guides/cloud-agents.html +43 -38
- package/dist/docs/guides/cloud-agents.md +47 -0
- package/dist/docs/guides/convert-automation.html +37 -37
- package/dist/docs/guides/github.html +37 -37
- package/dist/docs/guides/gitlab.html +37 -37
- package/dist/docs/guides/improve.html +37 -37
- package/dist/docs/guides/jev.html +37 -37
- package/dist/docs/guides/mcp-oauth.html +37 -37
- package/dist/docs/guides/migrate.html +37 -37
- package/dist/docs/guides/opentelemetry.html +37 -37
- package/dist/docs/guides/pagerduty.html +37 -37
- package/dist/docs/guides/slack.html +37 -37
- package/dist/docs/guides/teams.html +109 -0
- package/dist/docs/guides/teams.md +384 -0
- package/dist/docs/guides/webhooks.html +37 -37
- package/dist/docs/guides/workload-identity.html +141 -0
- package/dist/docs/guides/workload-identity.md +227 -0
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +37 -37
- package/dist/docs/index.html +37 -37
- package/dist/docs/llms-full.txt +881 -5
- package/dist/docs/llms.txt +2 -0
- package/dist/docs/quickstart.html +37 -37
- package/dist/docs/reference/access.html +36 -36
- package/dist/docs/reference/agent-config.html +39 -39
- package/dist/docs/reference/agent-config.md +1 -1
- package/dist/docs/reference/artifacts.html +37 -37
- package/dist/docs/reference/channels.html +38 -38
- package/dist/docs/reference/channels.md +1 -0
- package/dist/docs/reference/cli.html +50 -40
- package/dist/docs/reference/cli.md +116 -0
- package/dist/docs/reference/connections.html +37 -37
- package/dist/docs/reference/evals.html +37 -37
- package/dist/docs/reference/extensions.html +37 -37
- package/dist/docs/reference/hooks.html +37 -37
- package/dist/docs/reference/http-api.html +37 -37
- package/dist/docs/reference/instructions.html +37 -37
- package/dist/docs/reference/limits.html +39 -39
- package/dist/docs/reference/limits.md +4 -4
- package/dist/docs/reference/memory.html +37 -37
- package/dist/docs/reference/playground.html +36 -36
- package/dist/docs/reference/project-layout.html +37 -37
- package/dist/docs/reference/schedules.html +40 -40
- package/dist/docs/reference/sessions.html +38 -38
- package/dist/docs/reference/sessions.md +13 -0
- package/dist/docs/reference/skills.html +40 -40
- package/dist/docs/reference/subagents.html +37 -37
- package/dist/docs/reference/tools.html +37 -37
- package/dist/docs/templates/agentic-owners.html +37 -37
- package/dist/docs/templates/reviews.html +37 -37
- package/dist/docs/troubleshooting.html +38 -38
- package/dist/docs/troubleshooting.md +21 -0
- package/dist/evals/run-facts.d.ts.map +1 -1
- package/dist/evals/run-facts.js +4 -0
- package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
- package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
- package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
- package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
- package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
- package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
- package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
- package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
- package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
- package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
- package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
- package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
- package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
- package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
- package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
- package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
- package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
- package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
- package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
- package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
- package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
- package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
- package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
- package/dist/extensions.d.ts.map +1 -1
- package/dist/extensions.js +18 -3
- package/dist/files-backends/agent-store-presigned-url.js +5 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/internal/approval-gate.d.ts +6 -1
- package/dist/internal/approval-gate.d.ts.map +1 -1
- package/dist/internal/approval-gate.js +13 -2
- package/dist/internal/authored-loaders.js +1 -1
- package/dist/internal/channel-architecture.d.ts.map +1 -1
- package/dist/internal/channel-architecture.js +3 -1
- package/dist/internal/cli/commands/channels.d.ts +9 -3
- package/dist/internal/cli/commands/channels.d.ts.map +1 -1
- package/dist/internal/cli/commands/channels.js +193 -4
- package/dist/internal/cli/commands/index.d.ts.map +1 -1
- package/dist/internal/cli/commands/index.js +6 -1
- package/dist/internal/cli/commands/serve.d.ts.map +1 -1
- package/dist/internal/cli/commands/serve.js +25 -5
- package/dist/internal/cli/dispatch.d.ts.map +1 -1
- package/dist/internal/cli/dispatch.js +22 -8
- package/dist/internal/cli/flags.d.ts +14 -0
- package/dist/internal/cli/flags.d.ts.map +1 -1
- package/dist/internal/cli/flags.js +14 -0
- package/dist/internal/cli/help.d.ts.map +1 -1
- package/dist/internal/cli/help.js +3 -1
- package/dist/internal/cli-ax.d.ts.map +1 -1
- package/dist/internal/cli-ax.js +6 -3
- package/dist/internal/cli-cursor.js +2 -2
- package/dist/internal/cli-deploy.d.ts +1 -0
- package/dist/internal/cli-deploy.d.ts.map +1 -1
- package/dist/internal/cli-deploy.js +19 -1
- package/dist/internal/cli-mcp.d.ts.map +1 -1
- package/dist/internal/cli-mcp.js +5 -3
- package/dist/internal/cli-teams-doctor.d.ts +39 -0
- package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
- package/dist/internal/cli-teams-doctor.js +508 -0
- package/dist/internal/cli-teams-forward.d.ts +84 -0
- package/dist/internal/cli-teams-forward.d.ts.map +1 -0
- package/dist/internal/cli-teams-forward.js +386 -0
- package/dist/internal/cli-teams-package.d.ts +26 -0
- package/dist/internal/cli-teams-package.d.ts.map +1 -0
- package/dist/internal/cli-teams-package.js +123 -0
- package/dist/internal/cli-teams.d.ts +15 -0
- package/dist/internal/cli-teams.d.ts.map +1 -0
- package/dist/internal/cli-teams.js +253 -0
- package/dist/internal/connect-click.d.ts +12 -0
- package/dist/internal/connect-click.d.ts.map +1 -0
- package/dist/internal/connect-click.js +22 -0
- package/dist/internal/continuation-channel.d.ts +5 -1
- package/dist/internal/continuation-channel.d.ts.map +1 -1
- package/dist/internal/continuation-channel.js +34 -0
- package/dist/internal/continuation-identity.d.ts +7 -4
- package/dist/internal/continuation-identity.d.ts.map +1 -1
- package/dist/internal/continuation-identity.js +66 -1
- package/dist/internal/convert-automation/convert-workflow.js +2 -2
- package/dist/internal/credential-env-names.d.ts +36 -0
- package/dist/internal/credential-env-names.d.ts.map +1 -0
- package/dist/internal/credential-env-names.js +68 -0
- package/dist/internal/cursor/account-mcp.d.ts +67 -9
- package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
- package/dist/internal/cursor/account-mcp.js +206 -25
- package/dist/internal/cursor/backend-client.d.ts +10 -1
- package/dist/internal/cursor/backend-client.d.ts.map +1 -1
- package/dist/internal/cursor/backend-client.js +19 -7
- package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
- package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
- package/dist/internal/cursor/cloud-agent-identity.js +224 -0
- package/dist/internal/cursor/credentials.d.ts.map +1 -1
- package/dist/internal/cursor/credentials.js +3 -1
- package/dist/internal/cursor-account-mcp-auth.d.ts +8 -1
- package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
- package/dist/internal/cursor-account-mcp-auth.js +22 -6
- package/dist/internal/deploy-client.d.ts.map +1 -1
- package/dist/internal/deploy-client.js +34 -2
- package/dist/internal/deploy-manifest.d.ts +51 -3
- package/dist/internal/deploy-manifest.d.ts.map +1 -1
- package/dist/internal/deploy-manifest.js +96 -7
- package/dist/internal/discovery/agent-config.d.ts.map +1 -1
- package/dist/internal/discovery/agent-config.js +6 -1
- package/dist/internal/discovery/agent.d.ts.map +1 -1
- package/dist/internal/discovery/agent.js +2 -1
- package/dist/internal/discovery/connections.d.ts +5 -0
- package/dist/internal/discovery/connections.d.ts.map +1 -1
- package/dist/internal/discovery/connections.js +71 -1
- package/dist/internal/discovery/extensions.d.ts.map +1 -1
- package/dist/internal/discovery/extensions.js +2 -0
- package/dist/internal/discovery/info.d.ts.map +1 -1
- package/dist/internal/discovery/info.js +4 -0
- package/dist/internal/env-file.d.ts +1 -0
- package/dist/internal/env-file.d.ts.map +1 -1
- package/dist/internal/env-file.js +18 -17
- package/dist/internal/env-prefix.d.ts +11 -0
- package/dist/internal/env-prefix.d.ts.map +1 -0
- package/dist/internal/env-prefix.js +23 -0
- package/dist/internal/event-id-dedupe.d.ts +12 -0
- package/dist/internal/event-id-dedupe.d.ts.map +1 -0
- package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
- package/dist/internal/event-mapper.d.ts +7 -2
- package/dist/internal/event-mapper.d.ts.map +1 -1
- package/dist/internal/event-mapper.js +7 -0
- package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
- package/dist/internal/expected-delivery-failure.js +3 -0
- package/dist/internal/extension-namespace.d.ts +9 -0
- package/dist/internal/extension-namespace.d.ts.map +1 -0
- package/dist/internal/extension-namespace.js +14 -0
- package/dist/internal/guid.d.ts +2 -0
- package/dist/internal/guid.d.ts.map +1 -0
- package/dist/internal/guid.js +4 -0
- package/dist/internal/host-kv-cas.d.ts +13 -0
- package/dist/internal/host-kv-cas.d.ts.map +1 -0
- package/dist/internal/host-kv-cas.js +26 -0
- package/dist/internal/host-kv.d.ts +4 -1
- package/dist/internal/host-kv.d.ts.map +1 -1
- package/dist/internal/host-kv.js +15 -2
- package/dist/internal/hosted-catch-protocol.d.ts +5 -0
- package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-catch-protocol.js +5 -0
- package/dist/internal/hosted-catch.d.ts +2 -0
- package/dist/internal/hosted-catch.d.ts.map +1 -1
- package/dist/internal/hosted-catch.js +6 -1
- package/dist/internal/hosted-delivery-protocol.d.ts +4 -0
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +73 -3
- package/dist/internal/hosted-delivery.d.ts +9 -3
- package/dist/internal/hosted-delivery.d.ts.map +1 -1
- package/dist/internal/hosted-delivery.js +14 -3
- package/dist/internal/hosted-session-fixture.js +1 -1
- package/dist/internal/hosting.d.ts +5 -0
- package/dist/internal/hosting.d.ts.map +1 -1
- package/dist/internal/hosting.js +7 -1
- package/dist/internal/ids.d.ts +2 -0
- package/dist/internal/ids.d.ts.map +1 -1
- package/dist/internal/ids.js +5 -0
- package/dist/internal/install-cursor-skills.d.ts +6 -7
- package/dist/internal/install-cursor-skills.d.ts.map +1 -1
- package/dist/internal/install-cursor-skills.js +15 -9
- package/dist/internal/interview/agent-questions.d.ts +1 -1
- package/dist/internal/interview/agent-questions.d.ts.map +1 -1
- package/dist/internal/interview/agent-questions.js +4 -3
- package/dist/internal/local-control-plane.d.ts.map +1 -1
- package/dist/internal/local-control-plane.js +24 -0
- package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
- package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
- package/dist/internal/mcp-allowlist-in-use.js +93 -0
- package/dist/internal/mcp-endpoint.d.ts.map +1 -1
- package/dist/internal/mcp-endpoint.js +8 -10
- package/dist/internal/mcp-host.d.ts +19 -1
- package/dist/internal/mcp-host.d.ts.map +1 -1
- package/dist/internal/mcp-host.js +67 -3
- package/dist/internal/mcp-oauth.d.ts.map +1 -1
- package/dist/internal/mcp-oauth.js +5 -7
- package/dist/internal/oidcAudiences.d.ts +22 -0
- package/dist/internal/oidcAudiences.d.ts.map +1 -0
- package/dist/internal/oidcAudiences.js +35 -0
- package/dist/internal/otel/collector.d.ts.map +1 -1
- package/dist/internal/otel/collector.js +2 -0
- package/dist/internal/platform-timers.d.ts +2 -0
- package/dist/internal/platform-timers.d.ts.map +1 -1
- package/dist/internal/platform-timers.js +14 -0
- package/dist/internal/private-file.d.ts +32 -1
- package/dist/internal/private-file.d.ts.map +1 -1
- package/dist/internal/private-file.js +209 -7
- package/dist/internal/redact-values.d.ts +3 -0
- package/dist/internal/redact-values.d.ts.map +1 -0
- package/dist/internal/redact-values.js +19 -0
- package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
- package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
- package/dist/internal/reminder-followup-error.d.ts +23 -0
- package/dist/internal/reminder-followup-error.d.ts.map +1 -0
- package/dist/internal/reminder-followup-error.js +12 -0
- package/dist/internal/reminder-runner.d.ts +15 -1
- package/dist/internal/reminder-runner.d.ts.map +1 -1
- package/dist/internal/reminder-runner.js +95 -21
- package/dist/internal/resolved-connections.d.ts.map +1 -1
- package/dist/internal/resolved-connections.js +23 -3
- package/dist/internal/run-client.js +2 -1
- package/dist/internal/run-program.d.ts +31 -0
- package/dist/internal/run-program.d.ts.map +1 -0
- package/dist/internal/run-program.js +150 -0
- package/dist/internal/schedule-runner.d.ts +1 -0
- package/dist/internal/schedule-runner.d.ts.map +1 -1
- package/dist/internal/schedule-runner.js +10 -1
- package/dist/internal/sdk-runner.d.ts +28 -2
- package/dist/internal/sdk-runner.d.ts.map +1 -1
- package/dist/internal/sdk-runner.js +298 -38
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +53 -8
- package/dist/internal/session-credential.d.ts +14 -0
- package/dist/internal/session-credential.d.ts.map +1 -0
- package/dist/internal/session-credential.js +25 -0
- package/dist/internal/session-engine.d.ts +140 -6
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +583 -93
- package/dist/internal/storage-coordinator.d.ts +3 -1
- package/dist/internal/storage-coordinator.d.ts.map +1 -1
- package/dist/internal/storage-coordinator.js +13 -0
- package/dist/internal/storage-roles.d.ts +9 -1
- package/dist/internal/storage-roles.d.ts.map +1 -1
- package/dist/internal/teams-channel-profile.d.ts +41 -0
- package/dist/internal/teams-channel-profile.d.ts.map +1 -0
- package/dist/internal/teams-channel-profile.js +91 -0
- package/dist/internal/teams-devtunnel.d.ts +55 -0
- package/dist/internal/teams-devtunnel.d.ts.map +1 -0
- package/dist/internal/teams-devtunnel.js +205 -0
- package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
- package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
- package/dist/internal/teams-tunnel-proxy.js +100 -0
- package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
- package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
- package/dist/internal/testing/conversation-identity-vectors.js +67 -0
- package/dist/internal/testing/hosted-http.d.ts +15 -0
- package/dist/internal/testing/hosted-http.d.ts.map +1 -0
- package/dist/internal/testing/hosted-http.js +86 -0
- package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
- package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
- package/dist/internal/testing/teams-activity-fixtures.js +236 -0
- package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
- package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
- package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
- package/dist/internal/tunnel-process.d.ts +29 -0
- package/dist/internal/tunnel-process.d.ts.map +1 -0
- package/dist/internal/tunnel-process.js +105 -0
- package/dist/internal/turn-context.d.ts +28 -0
- package/dist/internal/turn-context.d.ts.map +1 -0
- package/dist/internal/turn-context.js +1 -0
- package/dist/oidc-token.d.ts +131 -0
- package/dist/oidc-token.d.ts.map +1 -0
- package/dist/oidc-token.js +221 -0
- package/dist/playground/assets/chunk-YOKDWASO-BPO_8GRX.js +115 -0
- package/dist/playground/assets/highlighted-body-KPVGNVTW-CxEV-T_f.js +1 -0
- package/dist/playground/assets/index-CjFJhCtb.js +62 -0
- package/dist/playground/assets/index-vwUVwmk8.css +1 -0
- package/dist/playground/assets/mermaid-HWGCJPDP-eK-fpbFn.js +1 -0
- package/dist/playground/index.html +2 -2
- package/dist/teams-app-package.d.ts +78 -0
- package/dist/teams-app-package.d.ts.map +1 -0
- package/dist/teams-app-package.js +204 -0
- package/dist/tools.d.ts +1 -1
- package/dist/tools.d.ts.map +1 -1
- package/dist/types.d.ts +271 -2
- package/dist/types.d.ts.map +1 -1
- package/docs/changelog.md +43 -0
- package/docs/deployment.md +14 -0
- package/docs/guides/cloud-agents.md +47 -0
- package/docs/guides/teams.md +389 -0
- package/docs/guides/workload-identity.md +232 -0
- package/docs/reference/agent-config.md +1 -1
- package/docs/reference/channels.md +1 -0
- package/docs/reference/cli.md +116 -0
- package/docs/reference/limits.md +4 -4
- package/docs/reference/sessions.md +13 -0
- package/docs/troubleshooting.md +21 -0
- package/package.json +23 -46
- package/skills/create-agent/SKILL.md +17 -4
- package/skills/debug/SKILL.md +1 -0
- package/skills/deploy/SKILL.md +1 -1
- package/skills/framework-map/SKILL.md +1 -0
- package/skills/setup-teams/SKILL.md +141 -0
- package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
- package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
- package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
- package/dist/docs/assets/changelog.md.DVNB-ApU.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +0 -1
- package/dist/docs/assets/chunks/channel.CdyTxaXV.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +0 -1
- package/dist/docs/assets/chunks/clone.DpIwUbur.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +0 -1
- package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
- package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
- package/dist/playground/assets/index-CnFd5R1_.js +0 -62
- package/dist/playground/assets/index-DNzRv6G8.css +0 -1
- /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
- /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjF,oBAAoB;AACpB,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,iBAAiB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAQD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B,GAAG,WAAW,CAoCd"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
function threadOf(ref) {
|
|
2
|
+
return ref.conversation.type === "channel"
|
|
3
|
+
? `${ref.conversation.id}:${ref.threadId}`
|
|
4
|
+
: ref.conversation.id;
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* One key per reply chain in a channel, and one per personal or group chat.
|
|
8
|
+
* @experimental
|
|
9
|
+
*/
|
|
10
|
+
export function teamsThreadKey(ref) {
|
|
11
|
+
return `teams:${threadOf(ref)}`;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* A Teams session principal. `"thread"` (default) lets anyone in the
|
|
15
|
+
* thread continue the session and resolve its approvals; `"author"` scopes
|
|
16
|
+
* both to the person who started it.
|
|
17
|
+
* @experimental
|
|
18
|
+
*/
|
|
19
|
+
export function buildTeamsAuthContext(input) {
|
|
20
|
+
const { conversation } = input.ref;
|
|
21
|
+
// Tenant and object ids are GUIDs, so the principal uses one letter case for every message.
|
|
22
|
+
const base = `teams:${conversation.tenantId?.toLowerCase() ?? "unknown"}:${threadOf(input.ref)}`;
|
|
23
|
+
const user = input.author.aadObjectId?.toLowerCase() ?? input.author.id;
|
|
24
|
+
const attributes = {
|
|
25
|
+
conversation_type: conversation.type,
|
|
26
|
+
conversation_id: conversation.id,
|
|
27
|
+
thread_id: input.ref.threadId,
|
|
28
|
+
user_id: input.author.id,
|
|
29
|
+
};
|
|
30
|
+
if (conversation.tenantId !== undefined) {
|
|
31
|
+
attributes.tenant_id = conversation.tenantId;
|
|
32
|
+
}
|
|
33
|
+
if (conversation.teamId !== undefined) {
|
|
34
|
+
attributes.team_id = conversation.teamId;
|
|
35
|
+
}
|
|
36
|
+
if (input.author.aadObjectId !== undefined) {
|
|
37
|
+
attributes.aad_object_id = input.author.aadObjectId;
|
|
38
|
+
}
|
|
39
|
+
if (input.author.name !== undefined) {
|
|
40
|
+
attributes.user_name = input.author.name;
|
|
41
|
+
}
|
|
42
|
+
if (input.author.isBot) {
|
|
43
|
+
attributes.author_type = "bot";
|
|
44
|
+
}
|
|
45
|
+
if (input.engagement !== undefined) {
|
|
46
|
+
attributes.engagement = input.engagement;
|
|
47
|
+
}
|
|
48
|
+
return {
|
|
49
|
+
authenticator: "teams",
|
|
50
|
+
principalId: input.respondTo === "author" ? `${base}:${user}` : base,
|
|
51
|
+
principalType: "user",
|
|
52
|
+
attributes,
|
|
53
|
+
label: input.author.name,
|
|
54
|
+
};
|
|
55
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { type KeyObject } from "node:crypto";
|
|
2
|
+
export declare const BOT_FRAMEWORK_OPENID_METADATA_URL = "https://login.botframework.com/v1/.well-known/openidconfiguration";
|
|
3
|
+
export declare const BOT_FRAMEWORK_TOKEN_ISSUER = "https://api.botframework.com";
|
|
4
|
+
type FetchFn = (input: string, init?: RequestInit) => Promise<Response>;
|
|
5
|
+
interface SigningKey {
|
|
6
|
+
key: KeyObject;
|
|
7
|
+
endorsements?: readonly string[];
|
|
8
|
+
}
|
|
9
|
+
export interface BotFrameworkKeySource {
|
|
10
|
+
key(kid: string): Promise<SigningKey | undefined>;
|
|
11
|
+
}
|
|
12
|
+
export declare function createBotFrameworkKeySource(deps?: {
|
|
13
|
+
fetch?: FetchFn;
|
|
14
|
+
now?: () => number;
|
|
15
|
+
metadataUrl?: string;
|
|
16
|
+
}): BotFrameworkKeySource;
|
|
17
|
+
export type BotFrameworkTokenCheck = {
|
|
18
|
+
ok: true;
|
|
19
|
+
} | {
|
|
20
|
+
ok: false;
|
|
21
|
+
reason: string;
|
|
22
|
+
};
|
|
23
|
+
export declare function verifyBotFrameworkToken(input: {
|
|
24
|
+
authorization: string | null;
|
|
25
|
+
appId: string;
|
|
26
|
+
serviceUrl: string;
|
|
27
|
+
/** Bot Framework signs for many channels; the key must be endorsed for the activity's. */
|
|
28
|
+
channelId: string;
|
|
29
|
+
keys: BotFrameworkKeySource;
|
|
30
|
+
nowMs?: number;
|
|
31
|
+
}): Promise<BotFrameworkTokenCheck>;
|
|
32
|
+
export {};
|
|
33
|
+
//# sourceMappingURL=bot-framework-auth.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bot-framework-auth.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/bot-framework-auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,SAAS,EAAU,MAAM,aAAa,CAAC;AAItE,eAAO,MAAM,iCAAiC,sEACuB,CAAC;AACtE,eAAO,MAAM,0BAA0B,iCAAiC,CAAC;AAQzE,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAExE,UAAU,UAAU;IAClB,GAAG,EAAE,SAAS,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;CACnD;AAED,wBAAgB,2BAA2B,CACzC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvE,qBAAqB,CA2EvB;AAUD,MAAM,MAAM,sBAAsB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA+DlC"}
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
import { Buffer } from "node:buffer";
|
|
2
|
+
import { createPublicKey, verify } from "node:crypto";
|
|
3
|
+
import { isRecord } from "../../internal/is-record.js";
|
|
4
|
+
import { trimServiceUrl } from "./activity.js";
|
|
5
|
+
export const BOT_FRAMEWORK_OPENID_METADATA_URL = "https://login.botframework.com/v1/.well-known/openidconfiguration";
|
|
6
|
+
export const BOT_FRAMEWORK_TOKEN_ISSUER = "https://api.botframework.com";
|
|
7
|
+
const CLOCK_SKEW_SECONDS = 5 * 60;
|
|
8
|
+
const KEYS_TTL_MS = 24 * 60 * 60 * 1000;
|
|
9
|
+
/** While Microsoft's key endpoints are down, cached keys keep verifying for this long. */
|
|
10
|
+
const KEYS_MAX_STALE_MS = 7 * 24 * 60 * 60 * 1000;
|
|
11
|
+
/** A forged key id, or a failed refresh, triggers at most one metadata refetch per interval. */
|
|
12
|
+
const REFRESH_COOLDOWN_MS = 5 * 60 * 1000;
|
|
13
|
+
export function createBotFrameworkKeySource(deps = {}) {
|
|
14
|
+
const fetchImpl = deps.fetch ?? fetch;
|
|
15
|
+
const now = deps.now ?? Date.now;
|
|
16
|
+
const metadataUrl = deps.metadataUrl ?? BOT_FRAMEWORK_OPENID_METADATA_URL;
|
|
17
|
+
let keys = new Map();
|
|
18
|
+
let fetchedAt;
|
|
19
|
+
let failedAt;
|
|
20
|
+
let inflight;
|
|
21
|
+
const refresh = async () => {
|
|
22
|
+
const metadata = await fetchJson(fetchImpl, metadataUrl);
|
|
23
|
+
const jwksUri = isRecord(metadata) ? metadata.jwks_uri : undefined;
|
|
24
|
+
if (typeof jwksUri !== "string") {
|
|
25
|
+
throw new Error("Bot Framework OpenID metadata has no jwks_uri");
|
|
26
|
+
}
|
|
27
|
+
const jwks = await fetchJson(fetchImpl, jwksUri);
|
|
28
|
+
const next = new Map();
|
|
29
|
+
for (const jwk of isRecord(jwks) && Array.isArray(jwks.keys) ? jwks.keys : []) {
|
|
30
|
+
if (!isRecord(jwk) ||
|
|
31
|
+
typeof jwk.kid !== "string" ||
|
|
32
|
+
jwk.kty !== "RSA" ||
|
|
33
|
+
typeof jwk.n !== "string" ||
|
|
34
|
+
typeof jwk.e !== "string") {
|
|
35
|
+
continue;
|
|
36
|
+
}
|
|
37
|
+
next.set(jwk.kid, {
|
|
38
|
+
key: createPublicKey({ key: { kty: "RSA", n: jwk.n, e: jwk.e }, format: "jwk" }),
|
|
39
|
+
endorsements: Array.isArray(jwk.endorsements)
|
|
40
|
+
? jwk.endorsements.filter((item) => typeof item === "string")
|
|
41
|
+
: undefined,
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
keys = next;
|
|
45
|
+
fetchedAt = now();
|
|
46
|
+
};
|
|
47
|
+
const refreshOnce = () => {
|
|
48
|
+
inflight ??= refresh()
|
|
49
|
+
.then(() => {
|
|
50
|
+
failedAt = undefined;
|
|
51
|
+
}, (error) => {
|
|
52
|
+
failedAt = now();
|
|
53
|
+
throw error;
|
|
54
|
+
})
|
|
55
|
+
.finally(() => {
|
|
56
|
+
inflight = undefined;
|
|
57
|
+
});
|
|
58
|
+
return inflight;
|
|
59
|
+
};
|
|
60
|
+
return {
|
|
61
|
+
async key(kid) {
|
|
62
|
+
const at = now();
|
|
63
|
+
const age = fetchedAt === undefined ? Number.POSITIVE_INFINITY : at - fetchedAt;
|
|
64
|
+
const due = age >= KEYS_TTL_MS || (!keys.has(kid) && age >= REFRESH_COOLDOWN_MS);
|
|
65
|
+
const coolingDown = failedAt !== undefined && at - failedAt < REFRESH_COOLDOWN_MS;
|
|
66
|
+
if (due && !coolingDown) {
|
|
67
|
+
try {
|
|
68
|
+
await refreshOnce();
|
|
69
|
+
}
|
|
70
|
+
catch (error) {
|
|
71
|
+
if (age >= KEYS_MAX_STALE_MS) {
|
|
72
|
+
throw error;
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
else if (coolingDown && age >= KEYS_MAX_STALE_MS) {
|
|
77
|
+
throw new Error("Bot Framework signing keys are unavailable: the last refresh failed");
|
|
78
|
+
}
|
|
79
|
+
return keys.get(kid);
|
|
80
|
+
},
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
async function fetchJson(fetchImpl, url) {
|
|
84
|
+
const response = await fetchImpl(url, { headers: { accept: "application/json" } });
|
|
85
|
+
if (!response.ok) {
|
|
86
|
+
throw new Error(`GET ${url} answered HTTP ${response.status}`);
|
|
87
|
+
}
|
|
88
|
+
return (await response.json());
|
|
89
|
+
}
|
|
90
|
+
export async function verifyBotFrameworkToken(input) {
|
|
91
|
+
const header = input.authorization;
|
|
92
|
+
if (header === null || !header.toLowerCase().startsWith("bearer ")) {
|
|
93
|
+
return { ok: false, reason: "missing_token" };
|
|
94
|
+
}
|
|
95
|
+
const parts = header.slice("bearer ".length).trim().split(".");
|
|
96
|
+
const [encodedHeader, encodedPayload, encodedSignature] = parts;
|
|
97
|
+
if (parts.length !== 3 ||
|
|
98
|
+
encodedHeader === undefined ||
|
|
99
|
+
encodedPayload === undefined ||
|
|
100
|
+
encodedSignature === undefined) {
|
|
101
|
+
return { ok: false, reason: "malformed_token" };
|
|
102
|
+
}
|
|
103
|
+
const jwtHeader = decodeSegment(encodedHeader);
|
|
104
|
+
const claims = decodeSegment(encodedPayload);
|
|
105
|
+
if (jwtHeader === undefined || claims === undefined) {
|
|
106
|
+
return { ok: false, reason: "malformed_token" };
|
|
107
|
+
}
|
|
108
|
+
if (jwtHeader.alg !== "RS256" || typeof jwtHeader.kid !== "string") {
|
|
109
|
+
return { ok: false, reason: "algorithm" };
|
|
110
|
+
}
|
|
111
|
+
const signingKey = await input.keys.key(jwtHeader.kid);
|
|
112
|
+
if (signingKey === undefined) {
|
|
113
|
+
return { ok: false, reason: "unknown_key" };
|
|
114
|
+
}
|
|
115
|
+
const signed = verify("RSA-SHA256", Buffer.from(`${encodedHeader}.${encodedPayload}`), signingKey.key, Buffer.from(encodedSignature, "base64url"));
|
|
116
|
+
if (!signed) {
|
|
117
|
+
return { ok: false, reason: "signature" };
|
|
118
|
+
}
|
|
119
|
+
if (claims.iss !== BOT_FRAMEWORK_TOKEN_ISSUER) {
|
|
120
|
+
return { ok: false, reason: "issuer" };
|
|
121
|
+
}
|
|
122
|
+
const audiences = Array.isArray(claims.aud) ? claims.aud : [claims.aud];
|
|
123
|
+
const appId = input.appId.toLowerCase();
|
|
124
|
+
if (!audiences.some((audience) => typeof audience === "string" && audience.toLowerCase() === appId)) {
|
|
125
|
+
return { ok: false, reason: "audience" };
|
|
126
|
+
}
|
|
127
|
+
const nowSeconds = (input.nowMs ?? Date.now()) / 1000;
|
|
128
|
+
if (typeof claims.exp !== "number" || claims.exp + CLOCK_SKEW_SECONDS < nowSeconds) {
|
|
129
|
+
return { ok: false, reason: "expired" };
|
|
130
|
+
}
|
|
131
|
+
if (typeof claims.nbf === "number" && claims.nbf - CLOCK_SKEW_SECONDS > nowSeconds) {
|
|
132
|
+
return { ok: false, reason: "not_yet_valid" };
|
|
133
|
+
}
|
|
134
|
+
if (typeof claims.serviceurl !== "string" ||
|
|
135
|
+
normalizeServiceUrl(claims.serviceurl) !== normalizeServiceUrl(input.serviceUrl)) {
|
|
136
|
+
return { ok: false, reason: "service_url" };
|
|
137
|
+
}
|
|
138
|
+
if (input.channelId === "" || signingKey.endorsements?.includes(input.channelId) !== true) {
|
|
139
|
+
return { ok: false, reason: "endorsement" };
|
|
140
|
+
}
|
|
141
|
+
return { ok: true };
|
|
142
|
+
}
|
|
143
|
+
function decodeSegment(segment) {
|
|
144
|
+
try {
|
|
145
|
+
const value = JSON.parse(Buffer.from(segment, "base64url").toString("utf8"));
|
|
146
|
+
return isRecord(value) ? value : undefined;
|
|
147
|
+
}
|
|
148
|
+
catch {
|
|
149
|
+
return undefined;
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
function normalizeServiceUrl(serviceUrl) {
|
|
153
|
+
return trimServiceUrl(serviceUrl).toLowerCase();
|
|
154
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { ApprovalDecision, ApprovalEndReason } from "../../types.js";
|
|
2
|
+
import type { TeamsOutboundActivity } from "./connector.js";
|
|
3
|
+
export interface TeamsApprovalSubmit {
|
|
4
|
+
sessionId: string;
|
|
5
|
+
callId: string;
|
|
6
|
+
decision: ApprovalDecision;
|
|
7
|
+
}
|
|
8
|
+
export declare function parseApprovalSubmit(value: Record<string, unknown>): TeamsApprovalSubmit | undefined;
|
|
9
|
+
export declare function approvalCardActivity(input: {
|
|
10
|
+
sessionId: string;
|
|
11
|
+
callId: string;
|
|
12
|
+
toolLabel: string;
|
|
13
|
+
args: unknown;
|
|
14
|
+
}): TeamsOutboundActivity;
|
|
15
|
+
export declare function resolvedApprovalCardActivity(input: {
|
|
16
|
+
toolLabel: string;
|
|
17
|
+
decision: ApprovalDecision;
|
|
18
|
+
by?: string;
|
|
19
|
+
reason?: ApprovalEndReason;
|
|
20
|
+
}): TeamsOutboundActivity;
|
|
21
|
+
/** The card a click lands on once the call that waited for it is gone. */
|
|
22
|
+
export declare function closedApprovalCardActivity(): TeamsOutboundActivity;
|
|
23
|
+
//# sourceMappingURL=cards.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/cards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAM5D,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,mBAAmB,GAAG,SAAS,CAajC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,qBAAqB,CAoBxB;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B,GAAG,qBAAqB,CAaxB;AAuBD,0EAA0E;AAC1E,wBAAgB,0BAA0B,IAAI,qBAAqB,CAWlE"}
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
import { redactSensitiveValues } from "../../internal/redact-values.js";
|
|
2
|
+
import { cutText } from "./text.js";
|
|
3
|
+
const ADAPTIVE_CARD_CONTENT_TYPE = "application/vnd.microsoft.card.adaptive";
|
|
4
|
+
const APPROVAL_ACTION = "bdk.tool-approval";
|
|
5
|
+
const ARGS_DISPLAY_MAX = 2_000;
|
|
6
|
+
export function parseApprovalSubmit(value) {
|
|
7
|
+
const { action, sessionId, callId, decision } = value;
|
|
8
|
+
if (action !== APPROVAL_ACTION ||
|
|
9
|
+
typeof sessionId !== "string" ||
|
|
10
|
+
sessionId === "" ||
|
|
11
|
+
typeof callId !== "string" ||
|
|
12
|
+
callId === "" ||
|
|
13
|
+
(decision !== "approve" && decision !== "deny")) {
|
|
14
|
+
return undefined;
|
|
15
|
+
}
|
|
16
|
+
return { sessionId, callId, decision };
|
|
17
|
+
}
|
|
18
|
+
export function approvalCardActivity(input) {
|
|
19
|
+
const submit = (decision) => ({
|
|
20
|
+
action: APPROVAL_ACTION,
|
|
21
|
+
sessionId: input.sessionId,
|
|
22
|
+
callId: input.callId,
|
|
23
|
+
decision,
|
|
24
|
+
});
|
|
25
|
+
const args = formatArgs(input.args);
|
|
26
|
+
return cardActivity({
|
|
27
|
+
body: [
|
|
28
|
+
{ type: "TextBlock", text: `Approve ${input.toolLabel}?`, weight: "Bolder", wrap: true },
|
|
29
|
+
...(args === ""
|
|
30
|
+
? []
|
|
31
|
+
: [{ type: "TextBlock", text: args, fontType: "Monospace", wrap: true }]),
|
|
32
|
+
],
|
|
33
|
+
actions: [
|
|
34
|
+
{ type: "Action.Submit", title: "Approve", style: "positive", data: submit("approve") },
|
|
35
|
+
{ type: "Action.Submit", title: "Deny", style: "destructive", data: submit("deny") },
|
|
36
|
+
],
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
export function resolvedApprovalCardActivity(input) {
|
|
40
|
+
return cardActivity({
|
|
41
|
+
body: [
|
|
42
|
+
{ type: "TextBlock", text: input.toolLabel, weight: "Bolder", wrap: true },
|
|
43
|
+
{
|
|
44
|
+
type: "TextBlock",
|
|
45
|
+
text: resolvedApprovalText(input),
|
|
46
|
+
color: input.decision === "approve" ? "Good" : "Attention",
|
|
47
|
+
wrap: true,
|
|
48
|
+
},
|
|
49
|
+
],
|
|
50
|
+
actions: [],
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
function resolvedApprovalText(input) {
|
|
54
|
+
switch (input.reason) {
|
|
55
|
+
case "timeout":
|
|
56
|
+
return "Denied: nobody answered in time.";
|
|
57
|
+
case "interrupt":
|
|
58
|
+
return "Denied: the request stopped before anyone answered.";
|
|
59
|
+
case undefined: {
|
|
60
|
+
const verdict = input.decision === "approve" ? "Approved" : "Denied";
|
|
61
|
+
return input.by === undefined ? verdict : `${verdict} by ${input.by}`;
|
|
62
|
+
}
|
|
63
|
+
default: {
|
|
64
|
+
const unexpected = input.reason;
|
|
65
|
+
return unexpected;
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
/** The card a click lands on once the call that waited for it is gone. */
|
|
70
|
+
export function closedApprovalCardActivity() {
|
|
71
|
+
return cardActivity({
|
|
72
|
+
body: [
|
|
73
|
+
{
|
|
74
|
+
type: "TextBlock",
|
|
75
|
+
text: "This approval request expired.",
|
|
76
|
+
wrap: true,
|
|
77
|
+
},
|
|
78
|
+
],
|
|
79
|
+
actions: [],
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
function cardActivity(content) {
|
|
83
|
+
return {
|
|
84
|
+
type: "message",
|
|
85
|
+
attachments: [
|
|
86
|
+
{
|
|
87
|
+
contentType: ADAPTIVE_CARD_CONTENT_TYPE,
|
|
88
|
+
content: {
|
|
89
|
+
type: "AdaptiveCard",
|
|
90
|
+
$schema: "http://adaptivecards.io/schemas/adaptive-card.json",
|
|
91
|
+
version: "1.5",
|
|
92
|
+
...content,
|
|
93
|
+
},
|
|
94
|
+
},
|
|
95
|
+
],
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
function formatArgs(args) {
|
|
99
|
+
if (args === undefined || args === null) {
|
|
100
|
+
return "";
|
|
101
|
+
}
|
|
102
|
+
const redacted = redactSensitiveValues(args);
|
|
103
|
+
const text = typeof redacted === "string" ? redacted : JSON.stringify(redacted, null, 2);
|
|
104
|
+
return text.length <= ARGS_DISPLAY_MAX
|
|
105
|
+
? text
|
|
106
|
+
: `${cutText(text, ARGS_DISPLAY_MAX)}… (${text.length} characters; the call uses all of them)`;
|
|
107
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type { ResolvedTeamsCredentials } from "./credentials.js";
|
|
2
|
+
import type { TeamsAddress } from "./types.js";
|
|
3
|
+
export declare const BOT_FRAMEWORK_TOKEN_SCOPE = "https://api.botframework.com/.default";
|
|
4
|
+
type FetchFn = (input: string, init?: RequestInit) => Promise<Response>;
|
|
5
|
+
export interface TeamsOutboundActivity {
|
|
6
|
+
type: "message" | "typing";
|
|
7
|
+
text?: string;
|
|
8
|
+
textFormat?: "markdown";
|
|
9
|
+
attachments?: unknown[];
|
|
10
|
+
}
|
|
11
|
+
/** What the Bot Connector says about one conversation member. */
|
|
12
|
+
export interface TeamsMember {
|
|
13
|
+
userRole?: string;
|
|
14
|
+
tenantId?: string;
|
|
15
|
+
}
|
|
16
|
+
export interface TeamsConnector {
|
|
17
|
+
send(address: TeamsAddress, activity: TeamsOutboundActivity): Promise<{
|
|
18
|
+
id: string;
|
|
19
|
+
}>;
|
|
20
|
+
update(address: TeamsAddress, activityId: string, activity: TeamsOutboundActivity): Promise<void>;
|
|
21
|
+
delete(address: TeamsAddress, activityId: string): Promise<void>;
|
|
22
|
+
addReaction(address: TeamsAddress, activityId: string, reactionType: string): Promise<void>;
|
|
23
|
+
/** `undefined` when the conversation has no such member. */
|
|
24
|
+
member(input: {
|
|
25
|
+
serviceUrl: string;
|
|
26
|
+
conversationId: string;
|
|
27
|
+
memberId: string;
|
|
28
|
+
}): Promise<TeamsMember | undefined>;
|
|
29
|
+
}
|
|
30
|
+
export declare class TeamsConnectorError extends Error {
|
|
31
|
+
readonly status: number;
|
|
32
|
+
constructor(status: number, message: string);
|
|
33
|
+
}
|
|
34
|
+
export declare class TeamsCredentialsUnsetError extends Error {
|
|
35
|
+
constructor();
|
|
36
|
+
}
|
|
37
|
+
export declare function teamsTokenEndpoint(tenantId: string): string;
|
|
38
|
+
export declare function mintBotFrameworkToken(credentials: ResolvedTeamsCredentials, fetchImpl?: FetchFn): Promise<{
|
|
39
|
+
token: string;
|
|
40
|
+
expiresInSeconds: number;
|
|
41
|
+
}>;
|
|
42
|
+
export declare function createTeamsConnector(deps: {
|
|
43
|
+
credentials: () => Promise<ResolvedTeamsCredentials | undefined>;
|
|
44
|
+
fetch?: FetchFn;
|
|
45
|
+
now?: () => number;
|
|
46
|
+
}): TeamsConnector;
|
|
47
|
+
export {};
|
|
48
|
+
//# sourceMappingURL=connector.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/connector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,yBAAyB,0CAA0C,CAAC;AAIjF,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClG,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,4DAA4D;IAC5D,MAAM,CAAC,KAAK,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CACtC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAE1C,QAAQ,CAAC,MAAM,EAAE,MAAM;IADzB,YACW,MAAM,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EAIhB;CACF;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,cAGC;CACF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,wBAAwB,EACrC,SAAS,GAAE,OAAe,GACzB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBtD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,WAAW,EAAE,MAAM,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAAC;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GAAG,cAAc,CAwHjB"}
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
import { setTimeout as sleep } from "node:timers/promises";
|
|
2
|
+
import { isRecord } from "../../internal/is-record.js";
|
|
3
|
+
import { trimServiceUrl } from "./activity.js";
|
|
4
|
+
export const BOT_FRAMEWORK_TOKEN_SCOPE = "https://api.botframework.com/.default";
|
|
5
|
+
const TOKEN_REFRESH_MARGIN_MS = 5 * 60 * 1000;
|
|
6
|
+
const MAX_RETRY_AFTER_MS = 5_000;
|
|
7
|
+
export class TeamsConnectorError extends Error {
|
|
8
|
+
constructor(status, message) {
|
|
9
|
+
super(message);
|
|
10
|
+
this.status = status;
|
|
11
|
+
this.name = "TeamsConnectorError";
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
export class TeamsCredentialsUnsetError extends Error {
|
|
15
|
+
constructor() {
|
|
16
|
+
super("Teams credentials are not set");
|
|
17
|
+
this.name = "TeamsCredentialsUnsetError";
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
export function teamsTokenEndpoint(tenantId) {
|
|
21
|
+
return `https://login.microsoftonline.com/${encodeURIComponent(tenantId)}/oauth2/v2.0/token`;
|
|
22
|
+
}
|
|
23
|
+
export async function mintBotFrameworkToken(credentials, fetchImpl = fetch) {
|
|
24
|
+
const response = await fetchImpl(teamsTokenEndpoint(credentials.tenantId), {
|
|
25
|
+
method: "POST",
|
|
26
|
+
headers: { "content-type": "application/x-www-form-urlencoded" },
|
|
27
|
+
body: new URLSearchParams({
|
|
28
|
+
grant_type: "client_credentials",
|
|
29
|
+
client_id: credentials.appId,
|
|
30
|
+
client_secret: credentials.appPassword,
|
|
31
|
+
scope: BOT_FRAMEWORK_TOKEN_SCOPE,
|
|
32
|
+
}).toString(),
|
|
33
|
+
});
|
|
34
|
+
const payload = await jsonRecord(response);
|
|
35
|
+
const token = payload.access_token;
|
|
36
|
+
if (!response.ok || typeof token !== "string" || token === "") {
|
|
37
|
+
const code = typeof payload.error === "string" ? `: ${payload.error}` : "";
|
|
38
|
+
throw new TeamsConnectorError(response.status, `Bot Framework token request failed with HTTP ${response.status}${code}`);
|
|
39
|
+
}
|
|
40
|
+
const expiresIn = Number(payload.expires_in);
|
|
41
|
+
return { token, expiresInSeconds: Number.isFinite(expiresIn) ? expiresIn : 3600 };
|
|
42
|
+
}
|
|
43
|
+
export function createTeamsConnector(deps) {
|
|
44
|
+
const fetchImpl = deps.fetch ?? fetch;
|
|
45
|
+
const now = deps.now ?? Date.now;
|
|
46
|
+
let cached;
|
|
47
|
+
const token = async (fresh) => {
|
|
48
|
+
const credentials = await deps.credentials();
|
|
49
|
+
if (credentials === undefined) {
|
|
50
|
+
throw new TeamsCredentialsUnsetError();
|
|
51
|
+
}
|
|
52
|
+
const key = `${credentials.appId}\n${credentials.tenantId}`;
|
|
53
|
+
if (!fresh && cached?.key === key && cached.expiresAtMs - TOKEN_REFRESH_MARGIN_MS > now()) {
|
|
54
|
+
return cached.token;
|
|
55
|
+
}
|
|
56
|
+
const minted = await mintBotFrameworkToken(credentials, fetchImpl);
|
|
57
|
+
cached = { key, token: minted.token, expiresAtMs: now() + minted.expiresInSeconds * 1000 };
|
|
58
|
+
return minted.token;
|
|
59
|
+
};
|
|
60
|
+
const call = async (input) => {
|
|
61
|
+
let fresh = false;
|
|
62
|
+
let waited = false;
|
|
63
|
+
for (;;) {
|
|
64
|
+
const headers = {
|
|
65
|
+
authorization: `Bearer ${await token(fresh)}`,
|
|
66
|
+
};
|
|
67
|
+
if (input.body !== undefined) {
|
|
68
|
+
headers["content-type"] = "application/json";
|
|
69
|
+
}
|
|
70
|
+
const response = await fetchImpl(input.url, {
|
|
71
|
+
method: input.method,
|
|
72
|
+
headers,
|
|
73
|
+
body: input.body === undefined ? undefined : JSON.stringify(input.body),
|
|
74
|
+
});
|
|
75
|
+
if (response.status === 401 && !fresh) {
|
|
76
|
+
fresh = true;
|
|
77
|
+
continue;
|
|
78
|
+
}
|
|
79
|
+
if (response.status === 429 && input.retry429 !== false && !waited) {
|
|
80
|
+
waited = true;
|
|
81
|
+
await sleep(retryAfterMs(response.headers.get("retry-after")));
|
|
82
|
+
continue;
|
|
83
|
+
}
|
|
84
|
+
return response;
|
|
85
|
+
}
|
|
86
|
+
};
|
|
87
|
+
const ok = async (input) => {
|
|
88
|
+
const response = await call(input);
|
|
89
|
+
if (!response.ok) {
|
|
90
|
+
throw new TeamsConnectorError(response.status, `Bot Connector ${input.method} answered HTTP ${response.status}`);
|
|
91
|
+
}
|
|
92
|
+
return response;
|
|
93
|
+
};
|
|
94
|
+
return {
|
|
95
|
+
async send(address, activity) {
|
|
96
|
+
const payload = await jsonRecord(await ok({ method: "POST", url: activitiesUrl(address), body: activity }));
|
|
97
|
+
return { id: typeof payload.id === "string" ? payload.id : "" };
|
|
98
|
+
},
|
|
99
|
+
async update(address, activityId, activity) {
|
|
100
|
+
await ok({
|
|
101
|
+
method: "PUT",
|
|
102
|
+
url: `${activitiesUrl(address)}/${encodeURIComponent(activityId)}`,
|
|
103
|
+
body: { ...activity, id: activityId },
|
|
104
|
+
});
|
|
105
|
+
},
|
|
106
|
+
async delete(address, activityId) {
|
|
107
|
+
await ok({
|
|
108
|
+
method: "DELETE",
|
|
109
|
+
url: `${activitiesUrl(address)}/${encodeURIComponent(activityId)}`,
|
|
110
|
+
});
|
|
111
|
+
},
|
|
112
|
+
async addReaction(address, activityId, reactionType) {
|
|
113
|
+
const response = await call({
|
|
114
|
+
method: "PUT",
|
|
115
|
+
url: `${activitiesUrl(address)}/${encodeURIComponent(activityId)}/reactions/${encodeURIComponent(reactionType)}`,
|
|
116
|
+
retry429: false,
|
|
117
|
+
});
|
|
118
|
+
if (response.status === 409) {
|
|
119
|
+
return;
|
|
120
|
+
}
|
|
121
|
+
if (!response.ok) {
|
|
122
|
+
throw new TeamsConnectorError(response.status, `Bot Connector PUT reaction answered HTTP ${response.status}`);
|
|
123
|
+
}
|
|
124
|
+
},
|
|
125
|
+
async member(input) {
|
|
126
|
+
const response = await call({
|
|
127
|
+
method: "GET",
|
|
128
|
+
url: `${conversationUrl(input)}/members/${encodeURIComponent(input.memberId)}`,
|
|
129
|
+
});
|
|
130
|
+
if (response.status === 404) {
|
|
131
|
+
return undefined;
|
|
132
|
+
}
|
|
133
|
+
if (!response.ok) {
|
|
134
|
+
throw new TeamsConnectorError(response.status, `Bot Connector GET member answered HTTP ${response.status}`);
|
|
135
|
+
}
|
|
136
|
+
const payload = await jsonRecord(response);
|
|
137
|
+
return {
|
|
138
|
+
userRole: typeof payload.userRole === "string" ? payload.userRole : undefined,
|
|
139
|
+
tenantId: typeof payload.tenantId === "string" ? payload.tenantId : undefined,
|
|
140
|
+
};
|
|
141
|
+
},
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
async function jsonRecord(response) {
|
|
145
|
+
const payload = await response.json().catch(() => undefined);
|
|
146
|
+
return isRecord(payload) ? payload : {};
|
|
147
|
+
}
|
|
148
|
+
function conversationUrl(input) {
|
|
149
|
+
return `${trimServiceUrl(input.serviceUrl)}/v3/conversations/${encodeURIComponent(input.conversationId)}`;
|
|
150
|
+
}
|
|
151
|
+
function activitiesUrl(address) {
|
|
152
|
+
return `${conversationUrl(address)}/activities`;
|
|
153
|
+
}
|
|
154
|
+
function retryAfterMs(header) {
|
|
155
|
+
const seconds = header === null ? Number.NaN : Number(header);
|
|
156
|
+
return Number.isFinite(seconds) && seconds >= 0
|
|
157
|
+
? Math.min(seconds * 1000, MAX_RETRY_AFTER_MS)
|
|
158
|
+
: 1000;
|
|
159
|
+
}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import type { TeamsChannelOptions, TeamsCredentials } from "./types.js";
|
|
2
|
+
/** Prefix plus Teams env names from {@link storedEnvPrefix}. */
|
|
3
|
+
export declare function teamsCredentialEnv(prefix?: string): {
|
|
4
|
+
envPrefix: string;
|
|
5
|
+
keys: {
|
|
6
|
+
appId: string;
|
|
7
|
+
appPassword: string;
|
|
8
|
+
tenantId: string;
|
|
9
|
+
};
|
|
10
|
+
};
|
|
11
|
+
/**
|
|
12
|
+
* Env var names for one Azure Bot: `<PREFIX>_TEAMS_APP_ID`, or `TEAMS_APP_ID` with no prefix.
|
|
13
|
+
* @experimental
|
|
14
|
+
*/
|
|
15
|
+
export declare function teamsEnvKeys(prefix?: string): {
|
|
16
|
+
appId: string;
|
|
17
|
+
appPassword: string;
|
|
18
|
+
tenantId: string;
|
|
19
|
+
};
|
|
20
|
+
/**
|
|
21
|
+
* Credentials read from the environment on every use, so a hosted
|
|
22
|
+
* deployment picks up its secrets per request.
|
|
23
|
+
* @experimental
|
|
24
|
+
*/
|
|
25
|
+
export declare function teamsCredentialsFromEnv(prefix?: string): TeamsCredentials;
|
|
26
|
+
export interface ResolvedTeamsCredentials {
|
|
27
|
+
appId: string;
|
|
28
|
+
appPassword: string;
|
|
29
|
+
tenantId: string;
|
|
30
|
+
}
|
|
31
|
+
/** `undefined` until all three are set. Without a home tenant the channel cannot refuse a foreign one. */
|
|
32
|
+
export declare function resolveTeamsCredentials(credentials: TeamsCredentials): Promise<ResolvedTeamsCredentials | undefined>;
|
|
33
|
+
/**
|
|
34
|
+
* Which deployment secret names the Azure Bot app id.
|
|
35
|
+
* `named` is a secret the control plane can load. `guest` is a literal or
|
|
36
|
+
* a function: the handler checks the token, and v2 deploy rejects it.
|
|
37
|
+
* An omitted `credentials` block is `named` with `TEAMS_APP_ID` (or the
|
|
38
|
+
* `envPrefix` form).
|
|
39
|
+
*/
|
|
40
|
+
export type TeamsAppIdCatch = {
|
|
41
|
+
kind: "named";
|
|
42
|
+
secretName: string;
|
|
43
|
+
} | {
|
|
44
|
+
kind: "guest";
|
|
45
|
+
};
|
|
46
|
+
export declare function teamsAppIdCatch(options: TeamsChannelOptions): TeamsAppIdCatch;
|
|
47
|
+
/**
|
|
48
|
+
* How the control plane learns the bot's home tenant.
|
|
49
|
+
* `secret` is a deployment secret name. `literal` is the tenant id itself.
|
|
50
|
+
* `missing` and `function` cannot be checked before compute, so architecture
|
|
51
|
+
* v2 deploy rejects them.
|
|
52
|
+
*/
|
|
53
|
+
export type TeamsTenantCatch = {
|
|
54
|
+
kind: "secret";
|
|
55
|
+
secretName: string;
|
|
56
|
+
} | {
|
|
57
|
+
kind: "literal";
|
|
58
|
+
tenantId: string;
|
|
59
|
+
} | {
|
|
60
|
+
kind: "function";
|
|
61
|
+
} | {
|
|
62
|
+
kind: "missing";
|
|
63
|
+
};
|
|
64
|
+
export declare function teamsTenantCatch(options: TeamsChannelOptions): TeamsTenantCatch;
|
|
65
|
+
//# sourceMappingURL=credentials.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/credentials.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAe,MAAM,YAAY,CAAC;AAQrF,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE,CAUA;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAEA;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAOzE;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,0GAA0G;AAC1G,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,gBAAgB,GAC5B,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAQ/C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAExF,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,eAAe,CAQ7E;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,CAiB/E"}
|