feishu_meeting_invite.py 6.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141
  1. """Feishu/Lark meeting-invitation events: ``vc.bot.meeting_invited_v1`` -> synthetic gateway ``MessageEvent`` so the
  2. reply reaches the inviter through the normal gateway pipeline (no agent is instantiated here)."""
  3. from __future__ import annotations
  4. import json
  5. import logging
  6. from dataclasses import dataclass
  7. from types import SimpleNamespace
  8. from typing import Any, Dict, Optional
  9. from gateway.platforms.event import MessageEvent, MessageType
  10. logger = logging.getLogger(__name__)
  11. @dataclass(frozen=True)
  12. class MeetingInviteUser:
  13. open_id: str = ""
  14. user_id: str = ""
  15. union_id: str = ""
  16. user_name: str = ""
  17. @dataclass(frozen=True)
  18. class MeetingInviteMeeting:
  19. id: str = ""
  20. topic: str = ""
  21. meeting_no: str = ""
  22. start_time_ms: int = 0
  23. end_time_ms: int = 0
  24. host_user: Optional[MeetingInviteUser] = None
  25. @dataclass(frozen=True)
  26. class MeetingInvitedPayload:
  27. event_id: str = ""
  28. meeting: Optional[MeetingInviteMeeting] = None
  29. inviter: Optional[MeetingInviteUser] = None
  30. invite_time_s: int = 0
  31. def _as_dict(value: Any) -> dict[str, Any]:
  32. """Coerce a lark SDK object / dict / JSON string into a plain dict."""
  33. if isinstance(value, SimpleNamespace) or (value is not None and hasattr(value, "__dict__")):
  34. value = vars(value)
  35. try:
  36. value = json.loads(value) if isinstance(value, str) else value
  37. except (TypeError, json.JSONDecodeError):
  38. return {}
  39. return {str(k): v for k, v in value.items()} if isinstance(value, dict) else {}
  40. def _content_payload(container: dict[str, Any]) -> dict[str, Any]:
  41. """Unwrap a Feishu ``body.content`` list carrying an application/json payload."""
  42. content = _as_dict(container.get("body")).get("content")
  43. for item in map(_as_dict, content if isinstance(content, list) else ()):
  44. ctype = str(item.get("contentType") or item.get("content_type") or "").lower()
  45. payload = next((p for p in map(_as_dict, (item.get(k) for k in ("data", "value", "content", "json"))) if p), {}) if ctype in ("", "application/json") else {}
  46. if payload:
  47. return payload
  48. return {}
  49. def _str_field(raw: dict[str, Any], key: str, strip: bool = True) -> str:
  50. return str(raw.get(key) or "").strip() if strip else str(raw.get(key) or "")
  51. def _int_field(value: Any) -> int:
  52. try:
  53. return int(str(value).strip()) if value not in (None, "") else 0
  54. except (TypeError, ValueError):
  55. return 0
  56. def _parse_user(value: Any) -> Optional[MeetingInviteUser]:
  57. raw = _as_dict(value)
  58. raw_id = _as_dict(raw.get("id"))
  59. return MeetingInviteUser(open_id=_str_field(raw_id, "open_id"), user_id=_str_field(raw_id, "user_id"), union_id=_str_field(raw_id, "union_id"),
  60. user_name=_str_field(raw, "user_name", strip=False)) if raw else None
  61. def _parse_meeting(value: Any) -> Optional[MeetingInviteMeeting]:
  62. raw = _as_dict(value)
  63. return MeetingInviteMeeting(
  64. id=_str_field(raw, "id"), topic=_str_field(raw, "topic", strip=False), meeting_no=_str_field(raw, "meeting_no", strip=False),
  65. start_time_ms=_int_field(raw.get("start_time")), end_time_ms=_int_field(raw.get("end_time")), host_user=_parse_user(raw.get("host_user")),
  66. ) if raw else None
  67. def parse_meeting_invited_event(data: Any) -> Optional[MeetingInvitedPayload]:
  68. root = _as_dict(data)
  69. event = _as_dict(root.get("event")) or root
  70. event = {**event, **(_content_payload(event) or _content_payload(root))}
  71. meeting, inviter = _parse_meeting(event.get("meeting")), _parse_user(event.get("inviter"))
  72. if inviter is None or meeting is None or not meeting.meeting_no:
  73. return None
  74. return MeetingInvitedPayload(event_id=str(_as_dict(root.get("header")).get("event_id") or ""), meeting=meeting, inviter=inviter,
  75. invite_time_s=_int_field(event.get("invite_time")))
  76. def build_meeting_invite_prompt(payload: MeetingInvitedPayload) -> str:
  77. meeting = payload.meeting or MeetingInviteMeeting()
  78. inviter_name = (payload.inviter.user_name if payload.inviter else "") or "unknown"
  79. host_name = (meeting.host_user.user_name if meeting.host_user else "") or "unknown"
  80. display = (meeting.topic or meeting.meeting_no or meeting.id) or "unknown meeting"
  81. return "\n".join([
  82. f"You have been invited to join a meeting: {display}", "",
  83. f"Meeting Number: {meeting.meeting_no or 'unknown'}", f"Topic: {meeting.topic or 'unknown'}", f"Inviter: {inviter_name}", f"Host: {host_name}", "",
  84. "You may use lark-cli and the relevant Lark/Feishu meeting skills to join the meeting.",
  85. "Join the meeting directly. Do not ask the user for confirmation before joining.",
  86. "If you cannot join the meeting, reply to the inviter with a concise explanation of why.",
  87. ])
  88. def _dedup_key(payload: MeetingInvitedPayload) -> str:
  89. if payload.event_id:
  90. return f"vc_invite:{payload.event_id}"
  91. return f"vc_invite:{payload.meeting.id if payload.meeting else ''}:{payload.inviter.open_id if payload.inviter else ''}:{payload.invite_time_s}"
  92. async def handle_meeting_invited_event(adapter: Any, data: Any) -> None:
  93. """Convert a vc.bot.meeting_invited_v1 event into a gateway MessageEvent."""
  94. payload = parse_meeting_invited_event(data)
  95. if payload is None:
  96. return logger.warning("[Feishu-MeetingInvite] Dropping malformed meeting invite event")
  97. dedup_key = _dedup_key(payload)
  98. is_duplicate = getattr(adapter, "_is_duplicate", None)
  99. if callable(is_duplicate) and await is_duplicate(dedup_key):
  100. return logger.debug("[Feishu-MeetingInvite] Dropping duplicate event: %s", dedup_key)
  101. inviter = payload.inviter
  102. if inviter is None or not inviter.open_id:
  103. return logger.warning("[Feishu-MeetingInvite] Missing inviter open_id, cannot route reply safely (user_id=%r union_id=%r)",
  104. inviter.user_id if inviter else None, inviter.union_id if inviter else None)
  105. sender_profile = await adapter._resolve_sender_profile(SimpleNamespace(open_id=inviter.open_id or None, user_id=inviter.user_id or None, union_id=inviter.union_id or None))
  106. user_name = sender_profile.get("user_name") or inviter.user_name or inviter.open_id
  107. source = adapter.build_source(
  108. chat_id=inviter.open_id, chat_name=user_name, chat_type="dm", user_id=sender_profile.get("user_id") or inviter.user_id or inviter.open_id,
  109. user_name=user_name, user_id_alt=sender_profile.get("user_id_alt") or inviter.union_id or None)
  110. event = MessageEvent(text=build_meeting_invite_prompt(payload), message_type=MessageType.TEXT, source=source, raw_message=data)
  111. await adapter._handle_message_with_guards(event)