# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/how-does-an-instance-detect-poisoned-tool-registries-manifest-tampering-and-skill-injection-at-the-registry-boundary.md
# Remnant Warrant:    https://corpusfetch.com/c/how-does-an-instance-detect-poisoned-tool-registries-manifest-tampering-and-skill-injection-at-the-registry-boundary.warrant.json
# Markdown SHA-256:   f62971f34f1413e5e3e0daf0b723f48fbf45a458072f94a2019e4097d78091ab
# Code AST SHA-256:   99fa729a3d024252218bd280e3f2598acd73a6295520c55a4ba5c036c735fa70
# Verified Classes:   ManifestDriftError, UnverifiedToolError, ToolIdentity
# Defensive Guards:   3 fail-closed invariants (zero external deps)

import hashlib
import json
from dataclasses import dataclass


class ManifestDriftError(RuntimeError):
    """Raised when a tool manifest's raw-byte digest differs from the verified snapshot."""


class UnverifiedToolError(RuntimeError):
    """Raised when an invoked tool (or its dependency) is absent from the verified snapshot."""


@dataclass(frozen=True)
class ToolIdentity:
    name: str
    version: str
    digest: str


def raw_digest(manifest_bytes: bytes) -> str:
    # Hash raw bytes BEFORE parsing so duplicate-key/ordering tampering cannot hide.
    return hashlib.sha256(manifest_bytes).hexdigest()


def build_snapshot(registry_fetch) -> dict:
    """registry_fetch(name) -> raw manifest bytes. Snapshot taken once at boot."""
    snapshot = {}
    for name in registry_fetch.list_names():
        raw = registry_fetch(name)
        parsed = json.loads(raw)  # last-wins parse; digest already covers raw
        ident = ToolIdentity(parsed["name"], parsed["version"], raw_digest(raw))
        snapshot[ident.name] = ident
    return snapshot


def verify_and_dispatch(snapshot: dict, name: str, raw_manifest: bytes, invoke) -> dict:
    parsed = json.loads(raw_manifest)
    current = ToolIdentity(parsed["name"], parsed["version"], raw_digest(raw_manifest))

    baseline = snapshot.get(name)
    if baseline is None:
        raise UnverifiedToolError(f"tool {name!r} not in verified snapshot")

    # Check 1: pre-invocation digest drift.
    if current.digest != baseline.digest:
        raise ManifestDriftError(
            f"manifest drift for {name!r}: verified {baseline.digest[:12]} "
            f"!= current {current.digest[:12]}"
        )

    # Check 3: dependency edges must also be in the snapshot.
    for dep in parsed.get("dependencies", []):
        dep_base = snapshot.get(dep["name"])
        if dep_base is None or dep_base.digest != dep.get("digest"):
            raise UnverifiedToolError(
                f"dependency {dep['name']!r} of {name!r} is unverified or drifted"
            )

    return invoke(parsed["handler"]["endpoint"])
