@grok/agent-sdk 0.6.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +40 -0
- 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/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.Ch-048af.js} +4 -4
- package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
- package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.SoN0MK7o.lean.js} +1 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
- package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BIzu7OVF.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.B4y6Y5eG.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
- package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.CwrYtDVo.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +1 -0
- package/dist/docs/assets/chunks/clone.F824-PNx.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
- package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.CdOyJvsX.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
- package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DDwvoQlY.js} +1 -1
- package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.BRXPDWj3.js} +1 -1
- package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.3YwC0t3o.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.B_SGgvgs.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +1 -0
- package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.bNyH5NPA.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DQqE3WF8.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.DnJA2aXp.js} +1 -1
- package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.N9S5KC5R.js} +2 -2
- package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.N9S5KC5R.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/{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 +35 -0
- package/dist/docs/deployment.html +39 -39
- package/dist/docs/deployment.md +10 -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/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +37 -37
- package/dist/docs/index.html +37 -37
- package/dist/docs/llms-full.txt +636 -4
- package/dist/docs/llms.txt +1 -0
- package/dist/docs/quickstart.html +37 -37
- package/dist/docs/reference/access.html +36 -36
- package/dist/docs/reference/agent-config.html +37 -37
- 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-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 +1 -0
- package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
- package/dist/internal/cursor-account-mcp-auth.js +2 -1
- 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/connections.d.ts.map +1 -1
- package/dist/internal/discovery/connections.js +53 -0
- 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 +8 -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 +3 -0
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +69 -1
- package/dist/internal/hosted-delivery.d.ts +5 -2
- package/dist/internal/hosted-delivery.d.ts.map +1 -1
- package/dist/internal/hosted-delivery.js +11 -2
- 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/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/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 +45 -4
- 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 +136 -5
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +580 -92
- 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 +127 -0
- package/dist/oidc-token.d.ts.map +1 -0
- package/dist/oidc-token.js +221 -0
- package/dist/playground/assets/index-BaBSZXki.css +1 -0
- package/dist/playground/assets/index-BkAF8YlO.js +62 -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 +35 -0
- package/docs/deployment.md +10 -0
- package/docs/guides/cloud-agents.md +47 -0
- package/docs/guides/teams.md +389 -0
- 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 +21 -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,402 @@
|
|
|
1
|
+
import { SessionAuthError } from "../../internal/auth.js";
|
|
2
|
+
import { ApprovalInterruptedError } from "../../internal/session-engine.js";
|
|
3
|
+
import { continuationSource, isOneShotContinuationKey, normalizeIdentity, stampMailboxContinuation, } from "../../internal/continuation-identity.js";
|
|
4
|
+
import { skipped, turnStarted } from "../../internal/channel-dispatch.js";
|
|
5
|
+
import { storedJson } from "../../internal/json-value.js";
|
|
6
|
+
import { buildTeamsAuthContext, teamsThreadKey } from "./auth.js";
|
|
7
|
+
import { closedApprovalCardActivity, parseApprovalSubmit } from "./cards.js";
|
|
8
|
+
import { emptyTeamsChannelState } from "./delivery.js";
|
|
9
|
+
import { gateTeamsMessage, needsThreadSessionCheck, } from "./engagement.js";
|
|
10
|
+
import { sameTeamsTenant } from "./senders.js";
|
|
11
|
+
import { cutText } from "./text.js";
|
|
12
|
+
const TITLE_MAX = 80;
|
|
13
|
+
const DEFAULT_TEAMS_ACK = "1f440_eyes";
|
|
14
|
+
const DEFAULT_REFUSAL_TEXT = "I can only help members of this organization. Ask the agent owner to allow guests.";
|
|
15
|
+
const UNVERIFIED_REFUSAL_TEXT = "I couldn't verify your access, try again shortly.";
|
|
16
|
+
const DEFAULT_WELCOME_TEXT = "Hi! Mention me in a channel, or message me here, to get started.";
|
|
17
|
+
function teamsSessionKey(input) {
|
|
18
|
+
switch (input.source.kind) {
|
|
19
|
+
case "local":
|
|
20
|
+
return localSessionKey(input);
|
|
21
|
+
case "admitted":
|
|
22
|
+
return input.source.key === undefined
|
|
23
|
+
? undefined
|
|
24
|
+
: { probe: input.source.key, send: { mailboxContinuation: { key: input.source.key } } };
|
|
25
|
+
default: {
|
|
26
|
+
const unexpected = input.source;
|
|
27
|
+
return unexpected;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* A v1 selector addresses the thread with `continuationToken`. A v2 thread
|
|
33
|
+
* selector stamps the `cont:teams` key the control plane stamps from the same
|
|
34
|
+
* activity. The `none/v2` selector stamps an `evt:` key: one session, not a drop.
|
|
35
|
+
*/
|
|
36
|
+
function localSessionKey(input) {
|
|
37
|
+
if (continuationSource(input.identity, "teams") === "engine") {
|
|
38
|
+
const key = teamsThreadKey(input.ref);
|
|
39
|
+
return { probe: key, send: { continuationToken: key } };
|
|
40
|
+
}
|
|
41
|
+
const mailbox = stampMailboxContinuation(normalizeIdentity(input.identity, "teams"), "message", input.activity, "teams");
|
|
42
|
+
if (!mailbox.key.startsWith("cont:teams:") && !isOneShotContinuationKey(mailbox.key)) {
|
|
43
|
+
return undefined;
|
|
44
|
+
}
|
|
45
|
+
return { probe: mailbox.key, send: { mailboxContinuation: mailbox } };
|
|
46
|
+
}
|
|
47
|
+
export async function dispatchTeamsInbound(input) {
|
|
48
|
+
const { inbound, runtime } = input;
|
|
49
|
+
const activity = activityRef(inbound);
|
|
50
|
+
if (!sameTeamsTenant(activity.conversation.tenantId, input.tenantId)) {
|
|
51
|
+
runtime.log(`ignoring an activity from tenant ${activity.conversation.tenantId ?? "none"}`);
|
|
52
|
+
return skipped("foreign_tenant");
|
|
53
|
+
}
|
|
54
|
+
if (inbound.kind === "installed") {
|
|
55
|
+
return dispatchInstalled({ inbound, args: input.args, runtime });
|
|
56
|
+
}
|
|
57
|
+
const deliveryKey = `${activity.conversation.id}\n${activity.id}`;
|
|
58
|
+
if (!runtime.dedupe.tryHandle(deliveryKey)) {
|
|
59
|
+
return skipped("duplicate");
|
|
60
|
+
}
|
|
61
|
+
try {
|
|
62
|
+
return await dispatchClaimed({ ...input, inbound });
|
|
63
|
+
}
|
|
64
|
+
catch (error) {
|
|
65
|
+
// Bot Framework redelivers after a 5xx; the redelivery must not read as a duplicate.
|
|
66
|
+
runtime.dedupe.release(deliveryKey);
|
|
67
|
+
throw error;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
async function dispatchClaimed(input) {
|
|
71
|
+
const { inbound, runtime } = input;
|
|
72
|
+
const session = teamsSessionKey({
|
|
73
|
+
source: input.sessionKey,
|
|
74
|
+
identity: runtime.options.continuation,
|
|
75
|
+
ref: inbound.kind === "message" ? inbound.message : inbound.action,
|
|
76
|
+
activity: input.args.body,
|
|
77
|
+
});
|
|
78
|
+
if (session === undefined) {
|
|
79
|
+
return skipped("unaddressed");
|
|
80
|
+
}
|
|
81
|
+
if (inbound.kind === "cardAction") {
|
|
82
|
+
// Card actions skip the engagement gate, which is what admits allowlisted bots.
|
|
83
|
+
if (inbound.action.author.isBot) {
|
|
84
|
+
runtime.log(`warn ignoring a card click from Teams bot ${inbound.action.author.id} in ${inbound.action.conversation.id}`);
|
|
85
|
+
return skipped("bot_sender");
|
|
86
|
+
}
|
|
87
|
+
const verdict = await senderVerdict({
|
|
88
|
+
sender: inbound.action,
|
|
89
|
+
address: inbound.address,
|
|
90
|
+
tenantId: input.tenantId,
|
|
91
|
+
runtime,
|
|
92
|
+
});
|
|
93
|
+
if (verdict !== "member") {
|
|
94
|
+
runtime.log(`warn ignoring a card click from Teams sender ${inbound.action.author.id} in ${inbound.action.conversation.id}: ${verdict}`);
|
|
95
|
+
return skipped(refusalReason(verdict));
|
|
96
|
+
}
|
|
97
|
+
return dispatchCardAction({
|
|
98
|
+
...input,
|
|
99
|
+
action: inbound.action,
|
|
100
|
+
address: inbound.address,
|
|
101
|
+
session,
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
const { message, address, botId } = inbound;
|
|
105
|
+
const engagement = runtime.options.engagement;
|
|
106
|
+
const threadHasSession = needsThreadSessionCheck(message, engagement) &&
|
|
107
|
+
((await runtime.started()?.hasContinuationSession(session.probe)) ?? false);
|
|
108
|
+
const gate = gateTeamsMessage({ message, botId, engagement, threadHasSession });
|
|
109
|
+
if (gate.kind === "drop") {
|
|
110
|
+
return skipped(gate.reason);
|
|
111
|
+
}
|
|
112
|
+
if (gate.botWake && !runtime.budget.tryWake(session.probe)) {
|
|
113
|
+
return skipped("bot_wake_budget");
|
|
114
|
+
}
|
|
115
|
+
const verdict = await senderVerdict({
|
|
116
|
+
sender: message,
|
|
117
|
+
address,
|
|
118
|
+
tenantId: input.tenantId,
|
|
119
|
+
runtime,
|
|
120
|
+
});
|
|
121
|
+
if (verdict !== "member") {
|
|
122
|
+
await postRefusal({ runtime, args: input.args, address, sender: message, verdict });
|
|
123
|
+
return skipped(refusalReason(verdict));
|
|
124
|
+
}
|
|
125
|
+
const hook = hookFor(runtime.options, gate.engagement);
|
|
126
|
+
const decision = hook === undefined
|
|
127
|
+
? defaultTeamsDispatch(message, gate.engagement, runtime.options)
|
|
128
|
+
: await hook(teamsBinding(input.args, runtime.connector, address), message);
|
|
129
|
+
if (decision === null || decision === undefined) {
|
|
130
|
+
return skipped("handler_declined");
|
|
131
|
+
}
|
|
132
|
+
ackInboundMessage({ args: input.args, runtime, address, message, decision });
|
|
133
|
+
try {
|
|
134
|
+
return await startTurn({
|
|
135
|
+
args: input.args,
|
|
136
|
+
decision,
|
|
137
|
+
ref: message,
|
|
138
|
+
author: message.author,
|
|
139
|
+
engagement: gate.engagement,
|
|
140
|
+
text: message.text,
|
|
141
|
+
address,
|
|
142
|
+
activityId: message.id,
|
|
143
|
+
session,
|
|
144
|
+
});
|
|
145
|
+
}
|
|
146
|
+
catch (error) {
|
|
147
|
+
// The redelivery of a turn that never started must not find the wake spent.
|
|
148
|
+
if (gate.botWake) {
|
|
149
|
+
runtime.budget.release(session.probe);
|
|
150
|
+
}
|
|
151
|
+
throw error;
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
function resolveTeamsAck(reply) {
|
|
155
|
+
if (reply?.ack === false) {
|
|
156
|
+
return undefined;
|
|
157
|
+
}
|
|
158
|
+
const custom = reply?.ack?.trim();
|
|
159
|
+
return custom === undefined || custom === "" ? DEFAULT_TEAMS_ACK : custom;
|
|
160
|
+
}
|
|
161
|
+
function ackInboundMessage(input) {
|
|
162
|
+
if (input.decision.quiet === true) {
|
|
163
|
+
return;
|
|
164
|
+
}
|
|
165
|
+
const reaction = resolveTeamsAck(input.runtime.options.reply);
|
|
166
|
+
if (reaction === undefined) {
|
|
167
|
+
return;
|
|
168
|
+
}
|
|
169
|
+
input.args.waitUntil(input.runtime.connector
|
|
170
|
+
.addReaction(input.address, input.message.id, reaction)
|
|
171
|
+
.catch((error) => {
|
|
172
|
+
input.runtime.log(`warn could not react to Teams message ${input.message.id} in ${input.message.conversation.id}: ${error instanceof Error ? error.message : String(error)}`);
|
|
173
|
+
}));
|
|
174
|
+
}
|
|
175
|
+
function activityRef(inbound) {
|
|
176
|
+
switch (inbound.kind) {
|
|
177
|
+
case "message":
|
|
178
|
+
return inbound.message;
|
|
179
|
+
case "cardAction":
|
|
180
|
+
return inbound.action;
|
|
181
|
+
case "installed":
|
|
182
|
+
return inbound;
|
|
183
|
+
default: {
|
|
184
|
+
const unexpected = inbound;
|
|
185
|
+
return unexpected;
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
/** Bots pass: the engagement gate admits only allowlisted bot mentions and opted-in bot posts, both under the bot wake budget. */
|
|
190
|
+
function senderVerdict(input) {
|
|
191
|
+
if (input.runtime.options.policy?.blockExternals === false || input.sender.author.isBot) {
|
|
192
|
+
return Promise.resolve("member");
|
|
193
|
+
}
|
|
194
|
+
return input.runtime.senders.verdict({
|
|
195
|
+
serviceUrl: input.address.serviceUrl,
|
|
196
|
+
conversation: input.sender.conversation,
|
|
197
|
+
author: input.sender.author,
|
|
198
|
+
tenantId: input.tenantId,
|
|
199
|
+
});
|
|
200
|
+
}
|
|
201
|
+
function refusalReason(verdict) {
|
|
202
|
+
return verdict === "unverified" ? "sender_unverified" : "external_sender";
|
|
203
|
+
}
|
|
204
|
+
async function postRefusal(input) {
|
|
205
|
+
if (input.runtime.options.policy?.refusalMessage === false) {
|
|
206
|
+
return;
|
|
207
|
+
}
|
|
208
|
+
const mark = {
|
|
209
|
+
kv: hostKv(input.args),
|
|
210
|
+
key: `refusal\n${input.sender.conversation.id}\n${input.sender.author.id}`,
|
|
211
|
+
};
|
|
212
|
+
if (!(await input.runtime.marks.claim({ ...mark, ttlMs: 60 * 60_000 }))) {
|
|
213
|
+
return;
|
|
214
|
+
}
|
|
215
|
+
try {
|
|
216
|
+
await input.runtime.connector.send(input.address, {
|
|
217
|
+
type: "message",
|
|
218
|
+
text: refusalText(input.runtime, input.verdict),
|
|
219
|
+
textFormat: "markdown",
|
|
220
|
+
});
|
|
221
|
+
}
|
|
222
|
+
catch (error) {
|
|
223
|
+
input.runtime.log(`warn could not post a Teams refusal to ${input.sender.conversation.id}: ${error instanceof Error ? error.message : String(error)}`);
|
|
224
|
+
await releaseMark(input.runtime, mark, input.sender.conversation.id);
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
async function releaseMark(runtime, mark, conversationId) {
|
|
228
|
+
try {
|
|
229
|
+
await runtime.marks.release(mark);
|
|
230
|
+
}
|
|
231
|
+
catch (error) {
|
|
232
|
+
runtime.log(`warn could not release a Teams mark for ${conversationId}: ${error instanceof Error ? error.message : String(error)}`);
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
function refusalText(runtime, verdict) {
|
|
236
|
+
if (verdict === "unverified") {
|
|
237
|
+
return UNVERIFIED_REFUSAL_TEXT;
|
|
238
|
+
}
|
|
239
|
+
const custom = runtime.options.policy?.refusalMessage;
|
|
240
|
+
return typeof custom === "string" ? custom : DEFAULT_REFUSAL_TEXT;
|
|
241
|
+
}
|
|
242
|
+
async function dispatchInstalled(input) {
|
|
243
|
+
const welcome = input.runtime.options.welcome;
|
|
244
|
+
if (welcome === false) {
|
|
245
|
+
return skipped("welcome_disabled");
|
|
246
|
+
}
|
|
247
|
+
const mark = { kv: hostKv(input.args), key: `welcome\n${input.inbound.conversation.id}` };
|
|
248
|
+
if (!(await input.runtime.marks.claim(mark))) {
|
|
249
|
+
return skipped("welcome_duplicate");
|
|
250
|
+
}
|
|
251
|
+
try {
|
|
252
|
+
await input.runtime.connector.send(input.inbound.address, {
|
|
253
|
+
type: "message",
|
|
254
|
+
text: welcome ?? DEFAULT_WELCOME_TEXT,
|
|
255
|
+
textFormat: "markdown",
|
|
256
|
+
});
|
|
257
|
+
}
|
|
258
|
+
catch (error) {
|
|
259
|
+
input.runtime.log(`warn could not post a Teams welcome to ${input.inbound.conversation.id}: ${error instanceof Error ? error.message : String(error)}`);
|
|
260
|
+
await releaseMark(input.runtime, mark, input.inbound.conversation.id);
|
|
261
|
+
// The welcome mark is the only dedupe for installs, so a redelivery after this 5xx greets.
|
|
262
|
+
return Response.json({ ok: false, error: "welcome_failed" }, { status: 502 });
|
|
263
|
+
}
|
|
264
|
+
return skipped("welcome_sent");
|
|
265
|
+
}
|
|
266
|
+
function hostKv(args) {
|
|
267
|
+
return args.host?.kv;
|
|
268
|
+
}
|
|
269
|
+
async function dispatchCardAction(input) {
|
|
270
|
+
const { action, runtime } = input;
|
|
271
|
+
const approval = parseApprovalSubmit(action.value);
|
|
272
|
+
if (approval !== undefined) {
|
|
273
|
+
const started = runtime.started();
|
|
274
|
+
if (started === undefined) {
|
|
275
|
+
return skipped("approvals_unavailable");
|
|
276
|
+
}
|
|
277
|
+
const clicker = buildTeamsAuthContext({
|
|
278
|
+
ref: action,
|
|
279
|
+
author: action.author,
|
|
280
|
+
respondTo: runtime.options.policy?.respondTo,
|
|
281
|
+
});
|
|
282
|
+
try {
|
|
283
|
+
await started.resolveApproval(approval.sessionId, approval.callId, approval.decision, clicker);
|
|
284
|
+
}
|
|
285
|
+
catch (error) {
|
|
286
|
+
runtime.log(`warn approval click not applied session=${approval.sessionId} call=${approval.callId}: ${error instanceof Error ? error.message : String(error)}`);
|
|
287
|
+
// Not found means the call was already decided, and that card already has no buttons.
|
|
288
|
+
if (error instanceof ApprovalInterruptedError) {
|
|
289
|
+
await closeApprovalCard({ runtime, address: input.address, action });
|
|
290
|
+
}
|
|
291
|
+
return skipped("approval_refused");
|
|
292
|
+
}
|
|
293
|
+
return skipped("approval_resolved");
|
|
294
|
+
}
|
|
295
|
+
if (runtime.options.onCardAction === undefined) {
|
|
296
|
+
return skipped("no_card_handler");
|
|
297
|
+
}
|
|
298
|
+
const decision = await runtime.options.onCardAction(teamsBinding(input.args, runtime.connector, input.address), action);
|
|
299
|
+
if (decision === null || decision === undefined) {
|
|
300
|
+
return skipped("handler_declined");
|
|
301
|
+
}
|
|
302
|
+
return startTurn({
|
|
303
|
+
args: input.args,
|
|
304
|
+
decision,
|
|
305
|
+
ref: action,
|
|
306
|
+
author: action.author,
|
|
307
|
+
engagement: "cardAction",
|
|
308
|
+
text: `Adaptive Card submit: ${JSON.stringify(action.value)}`,
|
|
309
|
+
address: input.address,
|
|
310
|
+
activityId: action.id,
|
|
311
|
+
session: input.session,
|
|
312
|
+
});
|
|
313
|
+
}
|
|
314
|
+
/** Nothing waits on the clicked card any more, so it must not keep live buttons. */
|
|
315
|
+
async function closeApprovalCard(input) {
|
|
316
|
+
const cardId = input.action.cardActivityId;
|
|
317
|
+
if (cardId === undefined) {
|
|
318
|
+
return;
|
|
319
|
+
}
|
|
320
|
+
try {
|
|
321
|
+
await input.runtime.connector.update(input.address, cardId, closedApprovalCardActivity());
|
|
322
|
+
}
|
|
323
|
+
catch (error) {
|
|
324
|
+
input.runtime.log(`warn could not close the Teams approval card ${cardId}: ${error instanceof Error ? error.message : String(error)}`);
|
|
325
|
+
}
|
|
326
|
+
}
|
|
327
|
+
/**
|
|
328
|
+
* The default decision: the sender's thread-scoped principal, no extra context.
|
|
329
|
+
* @experimental
|
|
330
|
+
*/
|
|
331
|
+
export function defaultTeamsDispatch(message, engagement, options) {
|
|
332
|
+
return {
|
|
333
|
+
auth: buildTeamsAuthContext({
|
|
334
|
+
ref: message,
|
|
335
|
+
author: message.author,
|
|
336
|
+
engagement,
|
|
337
|
+
respondTo: options.policy?.respondTo,
|
|
338
|
+
}),
|
|
339
|
+
};
|
|
340
|
+
}
|
|
341
|
+
function hookFor(options, engagement) {
|
|
342
|
+
switch (engagement) {
|
|
343
|
+
case "mention":
|
|
344
|
+
return options.onAppMention;
|
|
345
|
+
case "directMessage":
|
|
346
|
+
return options.onDirectMessage;
|
|
347
|
+
case "channelPost":
|
|
348
|
+
return options.onChannelPost;
|
|
349
|
+
default: {
|
|
350
|
+
const unexpected = engagement;
|
|
351
|
+
return unexpected;
|
|
352
|
+
}
|
|
353
|
+
}
|
|
354
|
+
}
|
|
355
|
+
function teamsBinding(args, connector, address) {
|
|
356
|
+
return {
|
|
357
|
+
thread: {
|
|
358
|
+
post: (text) => connector.send(address, { type: "message", text, textFormat: "markdown" }),
|
|
359
|
+
typing: async () => {
|
|
360
|
+
await connector.send(address, { type: "typing" });
|
|
361
|
+
},
|
|
362
|
+
},
|
|
363
|
+
host: args.host,
|
|
364
|
+
artifacts: args.artifacts,
|
|
365
|
+
};
|
|
366
|
+
}
|
|
367
|
+
function teamsContext(input) {
|
|
368
|
+
const from = input.author.name === undefined ? input.author.id : `${input.author.name} (${input.author.id})`;
|
|
369
|
+
return [
|
|
370
|
+
"<teams_context>",
|
|
371
|
+
`conversation: ${input.ref.conversation.type}`,
|
|
372
|
+
`from: ${from}${input.author.isBot ? " [bot]" : ""}`,
|
|
373
|
+
`engagement: ${input.engagement}`,
|
|
374
|
+
"</teams_context>",
|
|
375
|
+
].join("\n");
|
|
376
|
+
}
|
|
377
|
+
async function startTurn(input) {
|
|
378
|
+
const prompt = [
|
|
379
|
+
teamsContext(input),
|
|
380
|
+
input.decision.message ?? input.text,
|
|
381
|
+
...(input.decision.context ?? []),
|
|
382
|
+
].join("\n\n");
|
|
383
|
+
try {
|
|
384
|
+
const session = await input.args.send(prompt, {
|
|
385
|
+
auth: input.decision.auth,
|
|
386
|
+
...input.session.send,
|
|
387
|
+
state: storedJson({ ...emptyTeamsChannelState(), address: input.address }),
|
|
388
|
+
// A follow-up refreshes only where replies go; live and approval-card state stay.
|
|
389
|
+
refreshState: storedJson({ address: input.address }),
|
|
390
|
+
title: input.decision.title ?? `Teams: ${cutText(input.text.split("\n")[0] ?? "", TITLE_MAX)}`,
|
|
391
|
+
admission: "coalesce",
|
|
392
|
+
deliveryId: input.activityId,
|
|
393
|
+
});
|
|
394
|
+
return turnStarted(session);
|
|
395
|
+
}
|
|
396
|
+
catch (error) {
|
|
397
|
+
if (error instanceof SessionAuthError) {
|
|
398
|
+
return skipped("not_session_author");
|
|
399
|
+
}
|
|
400
|
+
throw error;
|
|
401
|
+
}
|
|
402
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { TeamsBotMentionsOptions, TeamsEngagementOptions, TeamsMessage } from "./types.js";
|
|
2
|
+
/** @experimental */
|
|
3
|
+
export type TeamsEngagement = "mention" | "directMessage" | "channelPost";
|
|
4
|
+
export type TeamsGate = {
|
|
5
|
+
kind: "dispatch";
|
|
6
|
+
engagement: TeamsEngagement;
|
|
7
|
+
botWake: boolean;
|
|
8
|
+
} | {
|
|
9
|
+
kind: "drop";
|
|
10
|
+
reason: string;
|
|
11
|
+
};
|
|
12
|
+
export declare function assertTeamsEngagement(engagement: TeamsEngagementOptions | undefined): void;
|
|
13
|
+
export declare function needsThreadSessionCheck(message: TeamsMessage, engagement: TeamsEngagementOptions | undefined): boolean;
|
|
14
|
+
export declare function gateTeamsMessage(input: {
|
|
15
|
+
message: TeamsMessage;
|
|
16
|
+
botId: string;
|
|
17
|
+
engagement: TeamsEngagementOptions | undefined;
|
|
18
|
+
threadHasSession: boolean;
|
|
19
|
+
}): TeamsGate;
|
|
20
|
+
export interface BotWakeBudget {
|
|
21
|
+
tryWake(threadKey: string): boolean;
|
|
22
|
+
/** Gives back the thread's latest wake, for a wake whose turn never started. */
|
|
23
|
+
release(threadKey: string): void;
|
|
24
|
+
/** Threads the budget still holds. */
|
|
25
|
+
size(): number;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Wakes per thread. A thread idle for 24 hours starts over, so its entry is
|
|
29
|
+
* evicted then.
|
|
30
|
+
*/
|
|
31
|
+
export declare function createBotWakeBudget(options: TeamsBotMentionsOptions | undefined, now?: () => number): BotWakeBudget;
|
|
32
|
+
//# sourceMappingURL=engagement.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/engagement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EAEvB,sBAAsB,EACtB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,aAAa,CAAC;AAE1E,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAOrC,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,sBAAsB,GAAG,SAAS,GAAG,IAAI,CAmB1F;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,sBAAsB,GAAG,SAAS,GAC7C,OAAO,CAET;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC/C,gBAAgB,EAAE,OAAO,CAAC;CAC3B,GAAG,SAAS,CA+BZ;AA8BD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,gFAAgF;IAChF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,sCAAsC;IACtC,IAAI,IAAI,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,uBAAuB,GAAG,SAAS,EAC5C,GAAG,GAAE,MAAM,MAAiB,GAC3B,aAAa,CAsCf"}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
import { TEAMS_BOT_ID_PREFIX } from "./activity.js";
|
|
2
|
+
const HOUR_MS = 60 * 60 * 1000;
|
|
3
|
+
const IDLE_RESET_MS = 24 * HOUR_MS;
|
|
4
|
+
const DEFAULT_BOT_WAKES_PER_HOUR = 5;
|
|
5
|
+
const DEFAULT_BOT_WAKES_TOTAL = 20;
|
|
6
|
+
export function assertTeamsEngagement(engagement) {
|
|
7
|
+
const posts = engagement?.channelPosts;
|
|
8
|
+
if (posts !== undefined) {
|
|
9
|
+
if (posts.allow.length === 0) {
|
|
10
|
+
throw new Error('teamsChannel engagement.channelPosts.allow must name a channel or be ["*"]');
|
|
11
|
+
}
|
|
12
|
+
if (posts.allow.includes("*") && posts.allow.length > 1) {
|
|
13
|
+
throw new Error('teamsChannel engagement.channelPosts.allow cannot mix "*" with channel ids');
|
|
14
|
+
}
|
|
15
|
+
const bad = posts.allow.find((id) => id !== "*" && !id.startsWith("19:"));
|
|
16
|
+
if (bad !== undefined) {
|
|
17
|
+
throw new Error(`teamsChannel engagement.channelPosts.allow entry ${JSON.stringify(bad)} is not a Teams channel id (19:…)`);
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
if (engagement?.botMentions !== undefined && engagement.botMentions.allowFrom.length === 0) {
|
|
21
|
+
throw new Error("teamsChannel engagement.botMentions.allowFrom must name at least one bot");
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
export function needsThreadSessionCheck(message, engagement) {
|
|
25
|
+
return message.isReply && !message.mentionsBot && engagement?.channelPosts?.replies === "joined";
|
|
26
|
+
}
|
|
27
|
+
export function gateTeamsMessage(input) {
|
|
28
|
+
const { message, engagement } = input;
|
|
29
|
+
if (message.author.id === input.botId) {
|
|
30
|
+
return { kind: "drop", reason: "own_post" };
|
|
31
|
+
}
|
|
32
|
+
if (message.conversation.type === "personal") {
|
|
33
|
+
if (message.author.isBot) {
|
|
34
|
+
return { kind: "drop", reason: "bot_author" };
|
|
35
|
+
}
|
|
36
|
+
return engagement?.directMessages === false
|
|
37
|
+
? { kind: "drop", reason: "direct_messages_off" }
|
|
38
|
+
: { kind: "dispatch", engagement: "directMessage", botWake: false };
|
|
39
|
+
}
|
|
40
|
+
if (message.mentionsBot && engagement?.mentions !== false) {
|
|
41
|
+
if (!message.author.isBot) {
|
|
42
|
+
return { kind: "dispatch", engagement: "mention", botWake: false };
|
|
43
|
+
}
|
|
44
|
+
return botMentionAllowed(message.author.id, engagement?.botMentions)
|
|
45
|
+
? { kind: "dispatch", engagement: "mention", botWake: true }
|
|
46
|
+
: { kind: "drop", reason: "bot_mention_not_allowed" };
|
|
47
|
+
}
|
|
48
|
+
const posts = engagement?.channelPosts;
|
|
49
|
+
if (message.conversation.type !== "channel" || posts === undefined) {
|
|
50
|
+
return { kind: "drop", reason: "not_mentioned" };
|
|
51
|
+
}
|
|
52
|
+
if (message.author.isBot && posts.includeBotPosts !== true) {
|
|
53
|
+
return { kind: "drop", reason: "bot_post" };
|
|
54
|
+
}
|
|
55
|
+
return watchesPost(message, posts, input.threadHasSession)
|
|
56
|
+
? { kind: "dispatch", engagement: "channelPost", botWake: message.author.isBot }
|
|
57
|
+
: { kind: "drop", reason: "not_watched" };
|
|
58
|
+
}
|
|
59
|
+
function watchesPost(message, posts, threadHasSession) {
|
|
60
|
+
const allowlisted = posts.allow.includes("*") || posts.allow.includes(message.conversation.id);
|
|
61
|
+
const which = posts.posts ?? "top-level";
|
|
62
|
+
if (!message.isReply) {
|
|
63
|
+
return allowlisted && which !== "replies";
|
|
64
|
+
}
|
|
65
|
+
return (allowlisted && which !== "top-level") || (posts.replies === "joined" && threadHasSession);
|
|
66
|
+
}
|
|
67
|
+
function botMentionAllowed(authorId, options) {
|
|
68
|
+
if (options === undefined) {
|
|
69
|
+
return false;
|
|
70
|
+
}
|
|
71
|
+
// Bot ids are app GUIDs, which Teams and Azure send in either letter case.
|
|
72
|
+
const author = authorId.toLowerCase();
|
|
73
|
+
return options.allowFrom.some((entry) => {
|
|
74
|
+
const id = entry.toLowerCase();
|
|
75
|
+
return id === author || `${TEAMS_BOT_ID_PREFIX}${id}` === author;
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Wakes per thread. A thread idle for 24 hours starts over, so its entry is
|
|
80
|
+
* evicted then.
|
|
81
|
+
*/
|
|
82
|
+
export function createBotWakeBudget(options, now = Date.now) {
|
|
83
|
+
const perHour = options?.maxPerThreadPerHour ?? DEFAULT_BOT_WAKES_PER_HOUR;
|
|
84
|
+
const total = options?.maxPerThreadTotal ?? DEFAULT_BOT_WAKES_TOTAL;
|
|
85
|
+
const wakes = new Map();
|
|
86
|
+
const evictIdle = (at) => {
|
|
87
|
+
for (const [key, history] of wakes) {
|
|
88
|
+
const last = history.at(-1);
|
|
89
|
+
if (last === undefined || at - last >= IDLE_RESET_MS) {
|
|
90
|
+
wakes.delete(key);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
};
|
|
94
|
+
return {
|
|
95
|
+
tryWake(threadKey) {
|
|
96
|
+
const at = now();
|
|
97
|
+
evictIdle(at);
|
|
98
|
+
const history = wakes.get(threadKey) ?? [];
|
|
99
|
+
const lastHour = history.filter((time) => at - time < HOUR_MS).length;
|
|
100
|
+
if (lastHour >= perHour || history.length >= total) {
|
|
101
|
+
return false;
|
|
102
|
+
}
|
|
103
|
+
wakes.delete(threadKey);
|
|
104
|
+
wakes.set(threadKey, [...history, at]);
|
|
105
|
+
return true;
|
|
106
|
+
},
|
|
107
|
+
release(threadKey) {
|
|
108
|
+
const history = wakes.get(threadKey);
|
|
109
|
+
if (history === undefined) {
|
|
110
|
+
return;
|
|
111
|
+
}
|
|
112
|
+
if (history.length <= 1) {
|
|
113
|
+
wakes.delete(threadKey);
|
|
114
|
+
return;
|
|
115
|
+
}
|
|
116
|
+
wakes.set(threadKey, history.slice(0, -1));
|
|
117
|
+
},
|
|
118
|
+
size: () => wakes.size,
|
|
119
|
+
};
|
|
120
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Microsoft Teams channel pack for the customer's own Azure Bot.
|
|
3
|
+
*
|
|
4
|
+
* ```ts
|
|
5
|
+
* import { teamsChannel } from "@grok/agent-sdk/channels/teams";
|
|
6
|
+
*
|
|
7
|
+
* // TEAMS_APP_ID + TEAMS_APP_PASSWORD + TEAMS_TENANT_ID
|
|
8
|
+
* export default teamsChannel();
|
|
9
|
+
*
|
|
10
|
+
* // One Azure Bot per agent in a multi-agent serve
|
|
11
|
+
* export default teamsChannel({ envPrefix: "MY_AGENT" });
|
|
12
|
+
* // → MY_AGENT_TEAMS_APP_ID + MY_AGENT_TEAMS_APP_PASSWORD + MY_AGENT_TEAMS_TENANT_ID
|
|
13
|
+
* ```
|
|
14
|
+
*/
|
|
15
|
+
export { buildTeamsAuthContext, teamsThreadKey, type TeamsThreadRef } from "./auth.js";
|
|
16
|
+
export { teamsCredentialsFromEnv, teamsEnvKeys } from "./credentials.js";
|
|
17
|
+
export { defaultTeamsDispatch } from "./dispatch.js";
|
|
18
|
+
export type { TeamsEngagement } from "./engagement.js";
|
|
19
|
+
export { TEAMS_CHANNEL_KIND, teamsChannel } from "./teams-channel.js";
|
|
20
|
+
export * from "./types.js";
|
|
21
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACtE,cAAc,YAAY,CAAC"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Microsoft Teams channel pack for the customer's own Azure Bot.
|
|
3
|
+
*
|
|
4
|
+
* ```ts
|
|
5
|
+
* import { teamsChannel } from "@grok/agent-sdk/channels/teams";
|
|
6
|
+
*
|
|
7
|
+
* // TEAMS_APP_ID + TEAMS_APP_PASSWORD + TEAMS_TENANT_ID
|
|
8
|
+
* export default teamsChannel();
|
|
9
|
+
*
|
|
10
|
+
* // One Azure Bot per agent in a multi-agent serve
|
|
11
|
+
* export default teamsChannel({ envPrefix: "MY_AGENT" });
|
|
12
|
+
* // → MY_AGENT_TEAMS_APP_ID + MY_AGENT_TEAMS_APP_PASSWORD + MY_AGENT_TEAMS_TENANT_ID
|
|
13
|
+
* ```
|
|
14
|
+
*/
|
|
15
|
+
export { buildTeamsAuthContext, teamsThreadKey } from "./auth.js";
|
|
16
|
+
export { teamsCredentialsFromEnv, teamsEnvKeys } from "./credentials.js";
|
|
17
|
+
export { defaultTeamsDispatch } from "./dispatch.js";
|
|
18
|
+
export { TEAMS_CHANNEL_KIND, teamsChannel } from "./teams-channel.js";
|
|
19
|
+
export * from "./types.js";
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { HostKvApi } from "../../types.js";
|
|
2
|
+
export interface TeamsMarks {
|
|
3
|
+
/** `true` when this caller takes the mark. A live mark returns `false`. */
|
|
4
|
+
claim(input: {
|
|
5
|
+
kv: HostKvApi | undefined;
|
|
6
|
+
key: string;
|
|
7
|
+
ttlMs?: number;
|
|
8
|
+
}): Promise<boolean>;
|
|
9
|
+
/** Drops the mark so the next claim takes it. */
|
|
10
|
+
release(input: {
|
|
11
|
+
kv: HostKvApi | undefined;
|
|
12
|
+
key: string;
|
|
13
|
+
}): Promise<void>;
|
|
14
|
+
}
|
|
15
|
+
export declare function createTeamsMarks(deps: {
|
|
16
|
+
now?: () => number;
|
|
17
|
+
log: (line: string) => void;
|
|
18
|
+
}): TeamsMarks;
|
|
19
|
+
//# sourceMappingURL=marks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"marks.d.ts","sourceRoot":"","sources":["../../../src/channels/teams/marks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,gBAAgB,CAAC;AAI3D,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,KAAK,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,SAAS,GAAG,SAAS,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3F,iDAAiD;IACjD,OAAO,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,SAAS,GAAG,SAAS,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,GAAG,UAAU,CA8Bb"}
|