# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/under-what-conditions-must-an-instance-refuse-to-resume-an-mcp-session-across-an-http-native-transport-upgrade.md
# Remnant Warrant:    https://corpusfetch.com/c/under-what-conditions-must-an-instance-refuse-to-resume-an-mcp-session-across-an-http-native-transport-upgrade.warrant.json
# Markdown SHA-256:   dd400f5ab15c2c57d054bb39441836a672698f2bd0183d624dd2d934d193b3c4
# Code AST SHA-256:   cc5572d94814862084d4d3ed790e432ca7268b88e3018b1211dd11ff61092906
# Verified Classes:   CrossTransportResumeError
# Defensive Guards:   5 fail-closed invariants (zero external deps)

class CrossTransportResumeError(RuntimeError):
    """Raised when a session resume is attempted across incompatible transports
    or with a token whose audience does not match the receiving endpoint."""


def resume_session(
    session_store: dict,
    session_id: str,
    request_transport: str,
    last_event_id: str | None,
    token_aud: str,
    endpoint_uri: str,
) -> dict:
    record = session_store.get(session_id)
    if record is None:
        raise CrossTransportResumeError(
            f"unknown session {session_id!r}; refusing resume"
        )

    if record["transport"] != request_transport:
        raise CrossTransportResumeError(
            f"session {session_id!r} was minted under transport "
            f"{record['transport']!r}; resume requested under "
            f"{request_transport!r}. Cross-transport resume is forbidden; "
            f"invalidate session and re-initialize."
        )

    if token_aud != endpoint_uri:
        raise CrossTransportResumeError(
            f"token audience {token_aud!r} does not match receiving endpoint "
            f"{endpoint_uri!r}; resource-server binding violated."
        )

    if last_event_id is not None:
        prefix = f"{request_transport}:{session_id}:"
        if not last_event_id.startswith(prefix):
            raise CrossTransportResumeError(
                f"cursor {last_event_id!r} is not namespaced for session "
                f"{session_id!r} under transport {request_transport!r}; "
                f"refusing to interpret foreign event log."
            )
        cursor = int(last_event_id.rsplit(":", 1)[1])
        if cursor > record["last_event_seq"]:
            raise CrossTransportResumeError(
                f"cursor {cursor} exceeds session high-water mark "
                f"{record['last_event_seq']}; possible replay attack."
            )

    return record
