# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/which-invariants-prevent-double-settlement-across-escrow-release-and-sla-credit-paths-in-cross-org-agent-negotiation.md
# Remnant Warrant:    https://corpusfetch.com/c/which-invariants-prevent-double-settlement-across-escrow-release-and-sla-credit-paths-in-cross-org-agent-negotiation.warrant.json
# Markdown SHA-256:   4433c4a5644dbce2777d7fd2bc530c8e0b25d257c631939f7e481ac418059175
# Code AST SHA-256:   a1c10cb0d5a8eec78fe62e626ae0c641f003d466cea6e04f13e800b537ec9893
# Verified Classes:   SettlementConflictError, SettlementLeg, EscrowLedger
# Defensive Guards:   6 fail-closed invariants (zero external deps)

from dataclasses import dataclass


class SettlementConflictError(RuntimeError):
    """Raised when a proposed settlement leg would exceed escrowed value."""


@dataclass(frozen=True)
class SettlementLeg:
    task_id: str
    kind: str          # "release" | "credit" | "refund"
    amount: int


class EscrowLedger:
    def __init__(self, escrowed: dict[str, int]):
        self._escrowed = dict(escrowed)
        self._settled: dict[str, int] = {tid: 0 for tid in escrowed}

    def settled_total(self, task_id: str) -> int:
        return self._settled[task_id]

    def apply(self, leg: SettlementLeg) -> None:
        escrowed = self._escrowed.get(leg.task_id)
        if escrowed is None:
            raise SettlementConflictError(f"unknown task {leg.task_id}")
        remaining = escrowed - self._settled[leg.task_id]
        if leg.amount < 0:
            raise SettlementConflictError(f"negative leg amount {leg.amount}")
        if leg.amount > remaining:
            raise SettlementConflictError(
                f"task {leg.task_id}: leg {leg.kind}={leg.amount} "
                f"exceeds remaining escrow {remaining} "
                f"(escrowed={escrowed}, settled={self._settled[leg.task_id]})"
            )
        self._settled[leg.task_id] += leg.amount
        assert self._settled[leg.task_id] <= escrowed


def settle_late_acceptance(
    ledger: EscrowLedger, task_id: str, credit_amount: int
) -> None:
    """Collapse a late-but-accepted completion into ONE atomic settlement.

    The credit is deducted from the releasable amount; release and credit
    are recorded as a single decision so the accounting identity
    release + credit == escrowed holds exactly once.
    """
    escrowed = ledger._escrowed[task_id]
    if credit_amount > escrowed:
        raise SettlementConflictError(
            f"credit {credit_amount} exceeds escrow {escrowed} for {task_id}"
        )
    release_amount = escrowed - credit_amount
    # Single coordinator: apply credit first, then release — both against
    # the same remaining-balance check, so a concurrent second leg cannot
    # double-spend the vault.
    ledger.apply(SettlementLeg(task_id, "credit", credit_amount))
    ledger.apply(SettlementLeg(task_id, "release", release_amount))
    if ledger.settled_total(task_id) != escrowed:
        raise SettlementConflictError(
            f"settlement identity violated for {task_id}: "
            f"settled={ledger.settled_total(task_id)} escrowed={escrowed}"
        )
