# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/when-must-an-instance-refuse-a-federated-capability-grant-it-cannot-verify-trust-broker-attestation-staleness-in-cross-org-multi-agent-federation.md
# Remnant Warrant:    https://corpusfetch.com/c/when-must-an-instance-refuse-a-federated-capability-grant-it-cannot-verify-trust-broker-attestation-staleness-in-cross-org-multi-agent-federation.warrant.json
# Markdown SHA-256:   0c05625b3146c7477116ba8c6236b60a3bd58e3c2047574e1006856251eb5e04
# Code AST SHA-256:   fca996678c391a85db52fec7770e637be1ddf23ecb944d30888c22d5991e3d76
# Verified Classes:   GrantStaleError, FederatedGrant
# Defensive Guards:   4 fail-closed invariants (zero external deps)

import time
from dataclasses import dataclass


class GrantStaleError(RuntimeError):
    """Raised when a federated capability grant's policy predicate cannot be
    confirmed current at the peer within the peer-defined staleness bound."""
    pass


@dataclass(frozen=True)
class FederatedGrant:
    capability: str
    delegation_chain_valid: bool
    policy_version: int
    issued_at: float          # monotonic seconds
    peer_max_staleness: float | None  # None => peer publishes no bound


def resolve_grant_at_peer(
    grant: FederatedGrant,
    peer_current_policy_version: int,
    now: float,
) -> None:
    """Resolve a grant at the peer's enforcement boundary, before any side effect.

    Raises GrantStaleError if the grant cannot be confirmed current.
    """
    if not grant.delegation_chain_valid:
        raise GrantStaleError(
            f"delegation chain invalid for capability={grant.capability!r}"
        )

    # Peer publishes no staleness bound => assume zero tolerance.
    if grant.peer_max_staleness is None:
        if grant.policy_version != peer_current_policy_version:
            raise GrantStaleError(
                f"no staleness bound published; policy version "
                f"{grant.policy_version} != peer current "
                f"{peer_current_policy_version} for {grant.capability!r}"
            )
        return

    age = now - grant.issued_at
    if age > grant.peer_max_staleness:
        raise GrantStaleError(
            f"grant age {age:.3f}s exceeds peer staleness bound "
            f"{grant.peer_max_staleness:.3f}s for {grant.capability!r}"
        )

    if grant.policy_version != peer_current_policy_version:
        raise GrantStaleError(
            f"policy predicate version {grant.policy_version} is stale; "
            f"peer is at {peer_current_policy_version} for "
            f"{grant.capability!r}; renegotiate"
        )
