Backplane. AgentRuntime. Codex. Reconciliation. Adapter behaviour
(backplane_agent_runtime v1.10.90)
Copy Markdown
Trusted host storage for immutable recovery evidence and separate closure receipts.
Evidence reads must not perform cleanup. The host holds exclusive recovery and Store writer authority from the authoritative reads through receipt CAS. Receipt revision zero means absent; the first successful CAS writes revision one. A durable adapter documents its atomicity, isolation and persistence boundary. No runtime capability, callback or Store context belongs in serialized evidence.
Summary
Callbacks
Atomically create one durable decision per source run. An existing key is a conflict.
Read an immutable root continuation decision, or return :not_found if absent.
Optional staged-export journal read under the same exclusive writer authority.
Callbacks
@callback compare_and_create_continuation(term(), String.t(), map()) :: {:ok, map()} | {:error, Backplane.AgentRuntime.Error.t()}
Atomically create one durable decision per source run. An existing key is a conflict.
@callback compare_and_swap_receipt(term(), String.t(), non_neg_integer(), map()) :: {:ok, map()} | {:error, Backplane.AgentRuntime.Error.t()}
@callback load_continuation(term(), String.t()) :: {:ok, map()} | {:error, Backplane.AgentRuntime.Error.t()}
Read an immutable root continuation decision, or return :not_found if absent.
@callback load_evidence(term(), String.t()) :: {:ok, map()} | {:error, Backplane.AgentRuntime.Error.t()}
@callback load_receipt(term(), String.t()) :: {:ok, map()} | {:error, Backplane.AgentRuntime.Error.t()}
@callback load_recovery_journal(term(), map()) :: {:ok, [map()]} | {:error, Backplane.AgentRuntime.Error.t()}
Optional staged-export journal read under the same exclusive writer authority.
Returns bounded portable entries from admission (revision 1) through the exact
authoritative Store revision. Each entry has string keys revision,
prior_revision, prior_incarnation, incarnation, kind, and canonical command
input. Normal commands retain incarnation; fence advances it, has an empty
input, and explicitly binds the preceding revision/incarnation. Reads never
execute effects. This capability does not change the Store write contract.
@callback mode() :: :ephemeral | :durable
@callback runtime_store(term(), String.t()) :: {:ok, {module(), term()}} | {:error, Backplane.AgentRuntime.Error.t()}