"""上游客户端（T-P2 落地；本文件先立签名）。

规格（§6）：模块级 httpx.AsyncClient 单例（keepalive，max_connections=100），
超时 connect=10s/read=120s/write=10s/pool=30s；始终注入
stream_options.include_usage（客户端未要求 usage 时过滤该 chunk 不下发）；
首 token 前 failover（D-P4）。
"""
from __future__ import annotations

from typing import Any, AsyncIterator, Dict


async def stream(body: dict, entry: Dict[str, Any], usage_sink) -> AsyncIterator[bytes]:
    """流式派发到上游，逐块 yield（T-P2 实现）。"""
    raise NotImplementedError("T-P2")
    yield b""  # pragma: no cover


def normalize_usage(provider: str, usage_dict: Dict[str, Any]) -> Dict[str, int]:
    """三家 usage 字段 -> 统一 {in_miss, in_hit, out}（T-P2 实现）。"""
    raise NotImplementedError("T-P2")