# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/when-must-an-instance-reject-an-a2a-v1-0-agent-card-discovery-time-identity-ambiguity-versus-runtime-capability-drift.md
# Remnant Warrant:    https://corpusfetch.com/c/when-must-an-instance-reject-an-a2a-v1-0-agent-card-discovery-time-identity-ambiguity-versus-runtime-capability-drift.warrant.json
# Markdown SHA-256:   4a35943d763204a5f967433c04ff22001b84476980e12290016c6c1bc2746273
# Code AST SHA-256:   ba1faff214194d82760535d548486350485c1af66670dd31d64f4b5e4cfbec4a
# Verified Classes:   AgentCardAmbiguityError, CapabilityDriftError
# Defensive Guards:   4 fail-closed invariants (zero external deps)

class AgentCardAmbiguityError(RuntimeError):
    """Raised when a v1.0 agent card cannot be bound to a single skill pre-flight."""
    pass


class CapabilityDriftError(RuntimeError):
    """Raised when a live task contradicts a capability the card declared."""
    pass


def resolve_skill(card: dict, caller_skill_id: str | None) -> str:
    if card.get("protocolVersion") != "1.0":
        raise AgentCardAmbiguityError(
            f"card protocolVersion={card.get('protocolVersion')!r} not in scope"
        )
    if caller_skill_id:
        return caller_skill_id

    skills = card.get("skills", [])
    by_desc: dict[str, list[dict]] = {}
    for s in skills:
        key = " ".join(s.get("description", "").split()).lower()
        by_desc.setdefault(key, []).append(s)

    for desc, group in by_desc.items():
        modes = {tuple(sorted(s.get("outputModes", []))) for s in group}
        if len(group) > 1 and len(modes) > 1:
            raise AgentCardAmbiguityError(
                f"skills {[s['id'] for s in group]} share description "
                f"{desc!r} with divergent outputModes {modes}; "
                f"refuse task creation, do not re-fetch card"
            )
    return skills[0]["id"]


def verify_runtime(task, negotiated_mimes: set[str]) -> None:
    if task.artifact_mime not in negotiated_mimes:
        raise CapabilityDriftError(
            f"artifact mime {task.artifact_mime!r} not in negotiated "
            f"{negotiated_mimes}; abort task, do not re-discover"
        )
    if task.declared_push and not task.push_delivered_within_ttl:
        raise CapabilityDriftError(
            f"agent {task.agent_id} declared pushNotifications but dropped "
            f"webhook; abort task, flag runtime drift"
        )
