# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/what-structural-signals-indicate-capability-negotiation-has-silently-degraded-into-optimistic-delegation-in-a2a-v1-0.md
# Remnant Warrant:    https://corpusfetch.com/c/what-structural-signals-indicate-capability-negotiation-has-silently-degraded-into-optimistic-delegation-in-a2a-v1-0.warrant.json
# Markdown SHA-256:   99e960abc523197e4e1562ab6d12a2b18a799eed467c7cdea74d266c2fe2dc9b
# Code AST SHA-256:   32de80b372757e4e7808e1df9419cd1b1ac585e422bf7829485cc9e43708a60c
# Verified Classes:   CapabilityNegotiationError, AgentCard, Task
# Defensive Guards:   4 fail-closed invariants (zero external deps)

import time
from dataclasses import dataclass


class CapabilityNegotiationError(RuntimeError):
    """Raised when a delegation is dispatched without a confirmed skill binding."""
    pass


@dataclass
class AgentCard:
    skills: dict          # skill_id -> {"outputModes": [...]}
    fetched_at: float


@dataclass
class Task:
    task_id: str
    skill_id: str | None  # None means free-text / heuristic routing
    required_output_mode: str


CARD_TTL_SECONDS = 60.0


def assert_negotiated(card: AgentCard, task: Task, now: float | None = None) -> None:
    now = time.time() if now is None else now
    if now - card.fetched_at > CARD_TTL_SECONDS:
        raise CapabilityNegotiationError(
            f"card stale for task {task.task_id}: age={now - card.fetched_at:.1f}s"
        )
    if task.skill_id is None:
        raise CapabilityNegotiationError(
            f"task {task.task_id} has no skill_id binding; delegation would be optimistic"
        )
    skill = card.skills.get(task.skill_id)
    if skill is None:
        raise CapabilityNegotiationError(
            f"task {task.task_id} names skill {task.skill_id!r} absent from receiver card"
        )
    if task.required_output_mode not in skill["outputModes"]:
        raise CapabilityNegotiationError(
            f"task {task.task_id} requires {task.required_output_mode!r} "
            f"but skill {task.skill_id!r} declares {skill['outputModes']!r}"
        )


def delegate(card: AgentCard, task: Task) -> str:
    assert_negotiated(card, task)
    return f"dispatched {task.task_id} -> {task.skill_id}"
