# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/in-what-scenarios-must-an-instance-refuse-to-bridge-a-tool-call-whose-capability-is-nominally-present-but-whose-provenance-chain-is-unverifiable-acros.md
# Remnant Warrant:    https://corpusfetch.com/c/in-what-scenarios-must-an-instance-refuse-to-bridge-a-tool-call-whose-capability-is-nominally-present-but-whose-provenance-chain-is-unverifiable-acros.warrant.json
# Markdown SHA-256:   5a865f894a551c7595d98a4cbf3f4642696435aac159d0d2e8f67dcbbd1f00f4
# Code AST SHA-256:   4396fddcd2808e0e64d859bb4465812998ace09f1644a09d9ab4dc9b2ed4bdcb
# Verified Classes:   ProvenanceUnverifiableError, CapabilityDescriptor
# Defensive Guards:   3 fail-closed invariants (zero external deps)

class ProvenanceUnverifiableError(RuntimeError):
    """Raised when a capability descriptor translates but its provenance
    witness cannot be validated in the target protocol's trust model."""
    pass


class CapabilityDescriptor:
    def __init__(self, name, source_protocol, target_protocol, witness):
        self.name = name
        self.source_protocol = source_protocol
        self.target_protocol = target_protocol
        self.witness = witness  # None if source carried no per-capability authority


def bridge_descriptor(desc: CapabilityDescriptor, target_trust_model) -> dict:
    # Schema translation may have succeeded upstream; that is irrelevant here.
    if desc.witness is None:
        raise ProvenanceUnverifiableError(
            f"capability {desc.name!r} present in {desc.source_protocol}->"
            f"{desc.target_protocol} but carries no provenance witness; "
            f"refusing to emit descriptor"
        )

    translated = target_trust_model.express(desc.witness)
    if translated is None:
        # Target protocol cannot express source authority. Refuse; do not
        # downgrade to a weaker capability or fall back by name.
        raise ProvenanceUnverifiableError(
            f"capability {desc.name!r}: witness from {desc.source_protocol} "
            f"cannot be expressed in {desc.target_protocol} trust model"
        )

    if not target_trust_model.validates(translated):
        raise ProvenanceUnverifiableError(
            f"capability {desc.name!r}: translated witness fails validation "
            f"under {desc.target_protocol} trust model"
        )

    return {"name": desc.name, "witness": translated, "provenance_complete": True}


def orchestrate_call(desc: CapabilityDescriptor, target_trust_model, policy):
    try:
        emitted = bridge_descriptor(desc, target_trust_model)
    except ProvenanceUnverifiableError as e:
        # First-class refusal outcome; do NOT substitute a name-similar tool.
        return {"outcome": "refused", "reason": str(e)}
    return {"outcome": "bridged", "descriptor": emitted}
