# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/under-what-conditions-must-an-instance-reject-a-resumed-mcp-sse-stream-when-oauth-2-1-resource-indicators-change-mid-session.md
# Remnant Warrant:    https://corpusfetch.com/c/under-what-conditions-must-an-instance-reject-a-resumed-mcp-sse-stream-when-oauth-2-1-resource-indicators-change-mid-session.warrant.json
# Markdown SHA-256:   a3ca20682e112538ce21dfdf8c6d7189aa8599fdcf04658f4125c5edb37c4c01
# Code AST SHA-256:   b3beecb4a07a167f7e4208eb59f4d21bec722466df3152aaa419086e41b3c745
# Verified Classes:   StreamResumeAuthorizationError, StreamProvenance, PresentedToken
# Defensive Guards:   5 fail-closed invariants (zero external deps)

import dataclasses
from typing import FrozenSet


class StreamResumeAuthorizationError(RuntimeError):
    """Raised when a Last-Event-ID resume is presented under an authorization
    context that does not match the provenance of the replayed events."""


@dataclasses.dataclass(frozen=True)
class StreamProvenance:
    resource: str
    scopes: FrozenSet[str]
    subject: str
    client_id: str


@dataclasses.dataclass(frozen=True)
class PresentedToken:
    resource: str
    scopes: FrozenSet[str]
    subject: str
    client_id: str


def validate_resume(
    provenance: StreamProvenance,
    presented: PresentedToken,
    event_id_in_window: bool,
) -> None:
    if not event_id_in_window:
        raise StreamResumeAuthorizationError(
            f"event {event_id_in_window!r} outside replay window; "
            "client must reissue original MCP request"
        )
    if presented.resource != provenance.resource:
        raise StreamResumeAuthorizationError(
            f"resource indicator mismatch on resume: stream minted under "
            f"{provenance.resource!r}, token presented for {presented.resource!r}"
        )
    if not provenance.scopes.issubset(presented.scopes):
        missing = provenance.scopes - presented.scopes
        raise StreamResumeAuthorizationError(
            f"scope regression on resume: missing {sorted(missing)} required "
            f"to replay stream minted under {provenance.resource!r}"
        )
    if presented.subject != provenance.subject:
        raise StreamResumeAuthorizationError(
            "principal mismatch on resume; treating as new stream"
        )
    if presented.client_id != provenance.client_id:
        raise StreamResumeAuthorizationError(
            "client_id mismatch on resume; treating as new stream"
        )
