"""
意图：模板卡 / 补问卡动作（骨架）。

正式：校验 clarification token 绑定的 waitVersion + 允许动作集合。
"""

from __future__ import annotations

import logging
from typing import Any

logger = logging.getLogger(__name__)


def handle_card_action(
    *,
    sender_id: str,
    thread_id: str,
    wait_version: int,
    action: str,
    payload: dict[str, Any] | None = None,
) -> None:
    """骨架：仅记日志；无 sender_id 直接返回。"""
    if not (sender_id or "").strip():
        return
    logger.info(
        "handler.card_action stub sender=%s thread=%s wait=%s action=%s",
        sender_id,
        thread_id,
        wait_version,
        action,
    )