One native Run supervisor owns the accounting obligations of its governed model calls. Its LLM turns and protocols share that owner through their HOST model scope. The owner is private process state, outside forkable Room state; Kontor remains the sole authority for balances and transfer receipts.
Each call registers before effects. Each dispatch retains its reservation and admission commands before submitting them, including their original identity, route, amount and explicit audit timestamps. Provider entry is recorded before the HTTP function is invoked. Reconciliation never invokes that function.
Accounting failures are distinct from provider failures, so a ledger timeout cannot trigger another inference request. The gateway retains response-body custody until handoff, closing a response when intervening accounting fails.
run/observe-settlement reads the original live Room incarnation's native
facts. It reports workers' quiescence, supervisor admission sealing, reservation
reconciliation and hold-transfer evidence separately. It performs no recovery
or authority grant. Its absence after owner release or restart is unknown;
it is not a durable completion acknowledgement.
A reservation's paid amount moves into the payer's shared hold wallet.
Consumer usage charging occurs later and can draw on that hold. Therefore
reservation reconciliation does not establish usage consumption. The observer
reports :usage-consumption :not-established and identifies hold transfers;
these are historical transfer evidence, not a claim about the hold's current
balance. Recovery neither refunds nor sweeps that shared hold, which can also
serve other calls or Runs. Returning actual available allowance remains a
separate operation.
This contract covers current-process governed HTTP dispatch ownership. It does not reconstruct native closures or unfinished call journals after process loss, prove publication/acceptance, or make arbitrary consumer usage charging atomic. Evaluation judges and money-only legacy calls do not acquire a new governed scope implicitly. Stronger restart and charge-handoff contracts require their own explicit witnesses and integration with their actual native owner.
Can you improve this documentation?Edit on GitHub
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |