netizen-cli 0.10.0__py3-none-any.whl

netizen_cli/channel/__init__.py

@@ -0,0 +1 @@
+"""Feishu Channel presentation adapters."""

netizen_cli/channel/completion_mentions.py

@@ -0,0 +1,60 @@
+"""Best-effort, single-attempt completion reminders anchored to result cards."""
+
+from __future__ import annotations
+
+import asyncio
+import hashlib
+import json
+import logging
+
+from lark_channel import Identity, OutboundText, SendOpts
+
+from ..domain import FeishuScope, ScopeKind
+from .ports import ReplyChannel
+from .topics import TopicPublishError, validate_topic_message
+
+logger = logging.getLogger(__name__)
+
+
+async def send_completion_mention(
+    channel: ReplyChannel,
+    *,
+    scope: FeishuScope,
+    card_message_id: str,
+    user_id: str,
+    operation_id: str,
+) -> bool:
+    """Keep the result-card anchor and scope; never fall back or resend."""
+    identity = json.dumps(
+        [scope.key, operation_id, card_message_id, user_id], ensure_ascii=True,
+    )
+    opts = SendOpts(
+        receive_id_type="chat_id", reply_to=card_message_id,
+        reply_in_thread=scope.kind is ScopeKind.TOPIC, reply_target_gone="fail",
+        uuid="completion-" + hashlib.sha256(identity.encode()).hexdigest()[:32],
+    )
+    try:
+        async with asyncio.timeout(5):
+            result = await channel.send(
+                scope.chat_id,
+                OutboundText(text="本轮任务已结束。", mentions=[Identity(open_id=user_id)]),
+                opts,
+            )
+        sent = validate_topic_message(result, scope.chat_id)
+        if (
+            not sent.root_id or not sent.parent_id
+            or sent.thread_id != scope.topic_id
+            or (scope.kind is not ScopeKind.TOPIC and sent.parent_id != card_message_id)
+        ):
+            raise TopicPublishError("completion reminder reply was not confirmed", unknown=True)
+        return True
+    except asyncio.CancelledError:
+        raise
+    except Exception:
+        # The request may already have notified the user. Do not retry or
+        # trigger result recovery; notification delivery never changes execution.
+        logger.warning(
+            "completion reminder reply was not confirmed; not retrying",
+            extra={"message_id": card_message_id, "operation_id": operation_id},
+        )
+        return False