# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/what-happens-when-an-instance-resumes-a-streamable-mcp-http-session-after-a-backpressure-induced-drop.md
# Remnant Warrant:    https://corpusfetch.com/c/what-happens-when-an-instance-resumes-a-streamable-mcp-http-session-after-a-backpressure-induced-drop.warrant.json
# Markdown SHA-256:   f9b6ebd3b81c2d56f5af04eae1fe92fea9c5321a4400684bb29c2ee5e79d5345
# Code AST SHA-256:   a2a69628025f3e8ed2f6e3aa56e824196a543b3a72550e1e32a7fd51866cd6cd
# Verified Classes:   ResumptionSemanticError, ResumableSession
# Defensive Guards:   3 fail-closed invariants (zero external deps)

class ResumptionSemanticError(RuntimeError):
    """Raised when a resumed MCP session is transport-alive but semantically dead."""
    pass


class ResumableSession:
    def __init__(self, session_id: str, buffer_ttl_s: float, session_ttl_s: float):
        self.session_id = session_id
        self.buffer_ttl_s = buffer_ttl_s
        self.session_ttl_s = session_ttl_s
        self.live_request_ids: set[str] = set()
        self.replayed_request_ids: set[str] = set()

    def resume(self, last_event_id: str, replayed_events: list[dict]) -> None:
        # Invariant: buffer must not outlive the session it describes.
        if self.buffer_ttl_s > self.session_ttl_s:
            raise ResumptionSemanticError(
                f"session {self.session_id}: buffer TTL {self.buffer_ttl_s}s exceeds "
                f"session TTL {self.session_ttl_s}s; replay may reference dead requests"
            )

        self.replayed_request_ids = {ev["request_id"] for ev in replayed_events}

        orphaned = self.replayed_request_ids - self.live_request_ids
        if orphaned:
            # Replayed events point at requests the server already cancelled.
            # Transport succeeded; semantics failed. Client must reset.
            raise ResumptionSemanticError(
                f"session {self.session_id}: replayed {len(orphaned)} event(s) for "
                f"non-live request ids {sorted(orphaned)}; session is a zombie"
            )

    def probe(self, request_id: str) -> bool:
        # Client-side liveness check: a cheap request with known correlation.
        # Only a verified round-trip proves the session is usable.
        if request_id not in self.live_request_ids:
            return False
        return True

    def require_live(self) -> None:
        if not self.live_request_ids:
            raise ResumptionSemanticError(
                f"session {self.session_id}: no live requests after resume; "
                "client must re-initialize rather than replay"
            )
