summary_writer.py 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162
  1. """Pipeline-facing Teams outbound delivery (meeting-summary writer).
  2. Lives inside the Teams platform plugin so the meeting pipeline reuses one Teams
  3. """
  4. from __future__ import annotations
  5. import html
  6. import os
  7. from typing import Any, Optional
  8. from urllib.parse import quote
  9. from gateway.config import PlatformConfig
  10. from agent.i18n import t
  11. from gateway.platforms._shared import get_scoped_secret as _get_scoped_secret
  12. import httpx
  13. def _parse_bool(value: Any, *, default: bool = False) -> bool:
  14. if isinstance(value, bool):
  15. return value
  16. if isinstance(value, str):
  17. normalized = value.strip().lower()
  18. if normalized in {"1", "true", "yes", "on"}:
  19. return True
  20. if normalized in {"0", "false", "no", "off"}:
  21. return False
  22. return default
  23. # (catalog key of the heading, payload attr); headings resolve through ``t()`` at render time.
  24. _LIST_SECTIONS = (("platform.teams.summary.key_decisions", "key_decisions"),
  25. ("platform.teams.summary.action_items", "action_items"),
  26. ("platform.teams.summary.risks", "risks"))
  27. # Env fallbacks for delivery config keys, applied only where nothing else set the key (access_token is a scoped secret).
  28. _ENV_KEYS = {"delivery_mode": "TEAMS_DELIVERY_MODE", "incoming_webhook_url": "TEAMS_INCOMING_WEBHOOK_URL",
  29. "access_token": "TEAMS_GRAPH_ACCESS_TOKEN", "team_id": "TEAMS_TEAM_ID", "channel_id": "TEAMS_CHANNEL_ID", "chat_id": "TEAMS_CHAT_ID"}
  30. class _StaticAccessTokenProvider:
  31. """Minimal token-provider shim so outbound Graph delivery can reuse the shared client."""
  32. def __init__(self, access_token: str):
  33. self._access_token = str(access_token or "").strip()
  34. async def get_access_token(self, *, force_refresh: bool = False) -> str:
  35. if not self._access_token:
  36. raise ValueError("TEAMS_GRAPH_ACCESS_TOKEN is required for graph delivery mode.")
  37. return self._access_token
  38. def clear_cache(self) -> None:
  39. return None
  40. class TeamsSummaryWriter:
  41. """Deliver a meeting summary to Teams via incoming webhook or Graph."""
  42. def __init__(
  43. self, platform_config: PlatformConfig | None = None, *,
  44. graph_client: Any | None = None, transport: httpx.AsyncBaseTransport | None = None,
  45. ) -> None:
  46. self._platform_config, self._graph_client, self._transport = platform_config, graph_client, transport
  47. async def write_summary(self, payload: Any, config: dict[str, Any] | None, existing_record: Optional[dict[str, Any]] = None) -> dict[str, Any]:
  48. merged = self._resolve_delivery_config(config)
  49. if existing_record and not _parse_bool(merged.get("force_resend"), default=False):
  50. return dict(existing_record)
  51. mode = str(merged.get("delivery_mode") or merged.get("mode") or "").strip().lower()
  52. if not mode and merged.get("incoming_webhook_url"):
  53. mode = "incoming_webhook"
  54. elif not mode and (merged.get("chat_id") or (merged.get("team_id") and merged.get("channel_id"))):
  55. mode = "graph"
  56. if mode == "incoming_webhook":
  57. return await self._write_summary_via_incoming_webhook(payload, merged)
  58. if mode == "graph":
  59. return await self._write_summary_via_graph(payload, merged)
  60. raise ValueError("Teams delivery_mode must be 'incoming_webhook' or 'graph'.")
  61. def _resolve_delivery_config(self, config: dict[str, Any] | None) -> dict[str, Any]:
  62. merged: dict[str, Any] = {}
  63. platform_cfg = self._platform_config
  64. if platform_cfg is not None:
  65. merged.update(dict(platform_cfg.extra or {}))
  66. if platform_cfg.token and "access_token" not in merged:
  67. merged["access_token"] = platform_cfg.token
  68. if platform_cfg.home_channel:
  69. merged.setdefault("channel_id", platform_cfg.home_channel.chat_id)
  70. merged.update(dict(config or {}))
  71. for key, env in _ENV_KEYS.items():
  72. value = _get_scoped_secret(env, "") if key == "access_token" else os.getenv(env, "")
  73. if value and not merged.get(key):
  74. merged[key] = value
  75. return merged
  76. async def _write_summary_via_incoming_webhook(self, payload: Any, config: dict[str, Any]) -> dict[str, Any]:
  77. webhook_url = str(config.get("incoming_webhook_url") or "").strip()
  78. if not webhook_url:
  79. raise ValueError("TEAMS_INCOMING_WEBHOOK_URL is required for incoming_webhook mode.")
  80. body = {"text": self._render_summary_markdown(payload)}
  81. async with httpx.AsyncClient(timeout=20.0, transport=self._transport) as client:
  82. response = await client.post(webhook_url, json=body)
  83. response.raise_for_status()
  84. return {"delivery_mode": "incoming_webhook", "webhook_url": webhook_url, "status_code": response.status_code, "delivered": True}
  85. async def _write_summary_via_graph(self, payload: Any, config: dict[str, Any]) -> dict[str, Any]:
  86. graph_client = self._build_graph_client(config)
  87. chat_id = str(config.get("chat_id") or "").strip()
  88. if chat_id:
  89. path = f"/chats/{quote(chat_id, safe='')}/messages"
  90. target = {"target_type": "chat", "chat_id": chat_id}
  91. else:
  92. team_id = str(config.get("team_id") or "").strip()
  93. channel_id = str(config.get("channel_id") or "").strip()
  94. if not team_id or not channel_id:
  95. raise ValueError("Graph delivery mode requires chat_id, or both team_id and channel_id.")
  96. path = f"/teams/{quote(team_id, safe='')}/channels/{quote(channel_id, safe='')}/messages"
  97. target = {"target_type": "channel", "team_id": team_id, "channel_id": channel_id}
  98. response = await graph_client.post_json(path, json_body={"body": {"contentType": "html", "content": self._render_summary_html(payload)}})
  99. return {"delivery_mode": "graph", **target, "message_id": (response or {}).get("id"), "web_url": (response or {}).get("webUrl")}
  100. def _build_graph_client(self, config: dict[str, Any]) -> Any:
  101. if self._graph_client is not None:
  102. return self._graph_client
  103. from tools.microsoft_graph_auth import MicrosoftGraphTokenProvider
  104. from tools.microsoft_graph_client import MicrosoftGraphClient
  105. access_token = str(config.get("access_token") or "").strip()
  106. provider = _StaticAccessTokenProvider(access_token) if access_token else MicrosoftGraphTokenProvider.from_env()
  107. return MicrosoftGraphClient(provider, transport=self._transport)
  108. def _render_summary_markdown(self, payload: Any) -> str:
  109. summary = self._text(getattr(payload, "summary", None), t("platform.teams.summary.empty"))
  110. lines = [f"**{self._title(payload)}**", "", t("platform.teams.summary.summary_line", summary=summary)]
  111. for heading_key, attr in _LIST_SECTIONS:
  112. lines += ["", f"{t(heading_key)}:", *self._bullet_lines(getattr(payload, attr, None))]
  113. return "\n".join(lines)
  114. def _render_summary_html(self, payload: Any) -> str:
  115. summary = html.escape(self._text(getattr(payload, "summary", None), t("platform.teams.summary.empty")))
  116. blocks = [f"<h2>{html.escape(self._title(payload))}</h2>",
  117. f"<h3>{html.escape(t('platform.teams.summary.heading'))}</h3>", f"<p>{summary}</p>"]
  118. for heading_key, attr in _LIST_SECTIONS:
  119. rendered = "".join(f"<li>{html.escape(str(item))}</li>" for item in (getattr(payload, attr, None) or []) if str(item).strip())
  120. blocks += [f"<h3>{html.escape(t(heading_key))}</h3>",
  121. f"<ul>{rendered}</ul>" if rendered else f"<p>{html.escape(t('platform.teams.summary.none_item'))}</p>"]
  122. return "".join(blocks)
  123. @staticmethod
  124. def _title(payload: Any) -> str:
  125. if title := getattr(payload, "title", None):
  126. return str(title)
  127. meeting_ref = getattr(payload, "meeting_ref", None)
  128. meeting_id = (getattr(meeting_ref, "meeting_id", None) if meeting_ref else None)
  129. return t("platform.teams.summary.title", meeting_id=meeting_id or t("platform.teams.summary.title_fallback"))
  130. @staticmethod
  131. def _text(value: Any, default: str) -> str:
  132. return str(value or "").strip() or default
  133. @classmethod
  134. def _bullet_lines(cls, values: Any) -> list[str]:
  135. return [f"- {str(item).strip()}" for item in (values or []) if str(item).strip()] or ["- None"]