#xjddlZddlmZmZddlmZmZmZdZej dZ dddee dee d eefd Z dS) N)Optionalcast) KNOWN_AGENTS AgentNameDetectionResultzAI-Agentz^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$)expected_product user_agentrreturnc||std|sdS|}t|dkrdS|\}}|d\}}}t|rt|sdS|||krdS|d\}}} |t ks | tvrdSttt| dddS)a?Parse an explicit coding-agent identity from a User-Agent value. The value must be exactly two whitespace-separated products:: / AI-Agent/ ``product`` and ``version`` must be non-empty RFC 9110 tokens, the marker must be exactly ``AI-Agent``, and ``agent`` must be one of ``KNOWN_AGENTS``. Matching is case-sensitive. Leading and trailing whitespace is ignored; comments and additional products are rejected. Pass ``expected_product`` to ignore identities that were not sent by a specific client. This only filters out unrelated User-Agent values; it does not authenticate the caller, who can send any header they like. Returns a ``DetectionResult`` with ``confidence="high"`` and ``source="user-agent"``, or ``None`` when the value does not match. Nz3expected_product must be a non-empty string or None/highz user-agentz User-Agent) ValueErrorsplitlen partition_TOKENmatch AGENT_MARKERrrrr) r rpartsclient_product agent_productproduct_versionmarkeragents KC:\Projects\Historical\venv\Lib\site-packages\agent_detector/_user_agent.pyparse_invoking_agentrs 0#,<#NOOO t     E 5zzQt$)!NM(22377GQ <<  W(=(=t#3C(C(Ct$..s33FAu l!:!:t 4 5116< V VV) retypingrragent_detector._detectorrrrrcompilerstrrr rr's !!!!!!!!MMMMMMMMMM  5 6 6 '+/W/W/W /Wsm/Wo /W/W/W/W/W/Wr