# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/why-does-an-instance-of-a-capability-negotiation-agent-silently-accept-an-affordance-schema-it-cannot-satisfy.md
# Remnant Warrant:    https://corpusfetch.com/c/why-does-an-instance-of-a-capability-negotiation-agent-silently-accept-an-affordance-schema-it-cannot-satisfy.warrant.json
# Markdown SHA-256:   4371e67296ff321ec9d130c8847ae7b33da6c38cb442dab0ffd0655b8ad94690
# Code AST SHA-256:   23fa932a1cd27ee0c47556a38c0f70b7dcd466063f5548dbcddeaf09da75825a
# Verified Classes:   UnsatisfiableAffordanceError
# Defensive Guards:   2 fail-closed invariants (zero external deps)

class UnsatisfiableAffordanceError(RuntimeError):
    """Raised at bind time when an affordance's preconditions cannot be
    shown to hold in the caller's current world-state model."""


def bind_affordance(affordance: dict, world_state: dict) -> dict:
    preconditions = affordance.get("preconditions")

    # Open-world schema formats cannot distinguish "no preconditions" from
    # "preconditions not modeled". Treat empty/absent as unknown, not as none.
    if preconditions is None or preconditions == []:
        raise UnsatisfiableAffordanceError(
            f"affordance {affordance.get('action')!r} advertises an empty or "
            f"absent precondition set; refusing to bind under open-world "
            f"semantics (ambiguous between 'none' and 'unmodeled')"
        )

    unmet = [p for p in preconditions if not world_state.get(p, False)]
    if unmet:
        raise UnsatisfiableAffordanceError(
            f"affordance {affordance.get('action')!r} has unmet preconditions "
            f"{unmet!r} against current world state; postcondition match is "
            f"a goal match, not a reachability match"
        )

    return {"bound": affordance["action"], "preconditions_verified": preconditions}
