Skip to content

How ActionReceipts fit into an agent transaction.

Provider logs describe one system. An ActionReceipt gives the counterparty a standard transaction record to keep. A receiver log records what the next system observed.

One transaction, three records

An agent calls a provider, tool, or another agent. The provider may write an internal log. The application handling the transaction creates an ActionReceipt for the counterparty. The receiving system may keep its own action log. These records answer different questions, and Bulla does not assume that any one of them is complete.

01

Provider log

What the provider recorded inside its own system.

02

ActionReceipt

The portable transaction record sent to the counterparty.

03

Receiver log

What the receiving system observed independently.

Why not use the provider’s logs?

Provider logs are useful, and Bulla does not replace them. If a provider exports the relevant event, binds it to the buyer’s request and accepted terms, authenticates it, and lets the buyer keep it, that export can become evidence for an ActionReceipt. Bulla standardizes the customer-facing transaction record so every buyer does not need a custom integration for every provider’s logs.

QuestionProvider logActionReceipt
Primary useOperate and debug the providerHand one transaction to the counterparty
CustodyUsually controlled by the providerRetained by each receiving party
FormatProvider-specificOpen and versioned
ScopeA stream of system activityOne action or transaction
ChecksWhatever the provider exposesLocal checks defined by the format
CompletenessNot assumedNot assumed

The model does not need to create the file. An API gateway, tool router, payment handler, or agent runtime can emit it when accepting or completing an external action.

ActionReceipt anatomy

An ActionReceipt is a standard JSON file for one transaction. Its main fields answer practical questions about the action, the authority and limits accepted for it, the evidence supplied, and the available challenge path. Its commitments let another party detect later changes to the file.

action

What consequential transition is recorded?

mandate.authority

Who permitted it, under which policy?

mandate.bounds

What did that permission allow?

evidence_refs

What evidence supports the record, and how is it grounded?

remedy

Where does a challenge go, and what remedies are named?

hashes

Can the content, occurrence, attestation, and log leaf be recomputed?

See the ActionReceipt standard for canonicalization, preimages, conventions, and verification levels.

Answerability flow

01

Action

one consequential transition

02

Receipt

authority · bounds · evidence · recourse

03

Verify

adds · integrity

recompute the record from pinned inputs

04

Rely

adds · reliance

the policy and its decision, recorded

05

Witness

adds · retention

the receipt held outside its issuer

06

Challenge

adds · recourse

the conveyed forum and remedy path

each stage adds a named property · none grants total trust
What this check cannot tell you

This checks the receipt file. Evidence from the systems that performed or observed the action is still needed to establish what happened.

Technical evidence

Verification establishes only the reported digest, identity, or inclusion depth; it does not establish the truth of the underlying process.

What Bulla can check

Bulla checks each claim at the depth supported by the supplied record and external verification context. It keeps file integrity, signer authority, evidence, reliance policy, and challenge terms separate rather than collapsing them into one verdict.

Authority and delegation

Bind a signer to an issuer-authorized mandate, then carry delegated scope through exact parent references. Authority answers who may bind the action; bounds answer what that authority permitted.

Reliance

A bulla.rely receipt records the receipt being relied on, the selected policy, the claimed decision, and the recomputed result. Reliance becomes an explicit consequential act of its own.

Verification reports the receipt dimensions. A supplied relying-party policy computes the separate RELY, REFUSE, or ESCALATE decision.

What this check cannot tell you

The three-exit reliance decision and its receipt are implemented in the Bulla library and exercised by library vectors; no live downstream relier operates on this site.

Recourse

The recourse envelope conveys a challenge window, named forum, and ordered remedy rungs so the next party does not have to recover the process from an internal system.

Registry and inclusion

A signed deed or receipt can enter a Merkle log. Inclusion and consistency proofs let another party test whether the record entered the witnessed history it references.

WitnessReceipt and ActionReceipt

A WitnessReceipt binds a composition diagnostic and policy. An ActionReceipt records one consequential act. They are distinct formats with distinct verification questions.

Signed deed

A composition certificate signed by its issuer and optionally included in a deed registry. It carries a scoped diagnostic result into a policy or gate.

Disposition

A policy result such as proceed, advise, refuse pending disclosure, or unresolved. The selected relying policy produces the disposition.

Experimental composition diagnostics

The composition plane finds conventions that a tool graph needs but its observable schemas do not disclose. It localizes the seam and can apply a scoped bridge or translation.

disclosure_deficit = rank(delta_full) - rank(delta_observable)
What this check cannot tell you

The coherence fee measures undisclosed conventions in a pinned composition model; it is not Bulla's safety foundation or an execution-failure predictor.

Composition diagnosis

A deterministic analysis of which semantic conventions a pinned tool graph needs and which of them its observable schemas disclose.

Coherence fee / disclosure deficit

The rank difference above: the number of independent convention dimensions hidden from the observable seam inside the selected model.

Blind spot

One localized obstruction dimension with the tool fields and edges that carry it.

Semantic dimension

A named convention such as path root, date encoding, currency unit, or ID offset that must be shared across a seam.

Interaction score

The residual between the sum of per-dimension deficits and the total, used to locate dimensions that share hidden fields.

Convention pack

A versioned vocabulary of dimensions, known values, aliases, source registries, and classification patterns.

Standards and restricted registries

Open standards may ship inline or by content-addressed registry pointer. Restricted standards remain metadata until the consumer supplies the licensed values.

Bridge and translation

A bridge exposes a hidden convention in a manifest. A translator applies a typed value mapping and emits a receipt for that transformation.

What still depends on another record or institution

Record and process

Verification tests the receipt. Stronger evidence must come from the systems or counterparties that observed the underlying process.

What this check cannot tell you

Witness evidence establishes what entered a witnessed history; it does not prove the underlying execution occurred or reveal omitted actions.

Terms and operation

The receipt carries a challenge route and remedy terms. The named forum remains an operational dependency.

What this check cannot tell you

A consistently conveyed remedy adapter establishes recourse terms, not that a forum, remedy, or settlement path is operational.

Full technical reference

Epistemic receipt

Machine-readable status for a repair recommendation: exact in a pinned finite regime, surrogate with a downgrade reason, or unresolved.

Boundary fee

The part of the disclosure deficit that crosses server ownership boundaries, separated from hidden conventions internal to one server.

Contradiction score

Visible schema incompatibilities such as conflicting formats, enums, or ranges.

Structural diagnostic

The combined localization report for disclosed and undisclosed interface conditions.

Verification bill

A descriptive pairing of opacity and visible incompatibility costs.

Disclosure state

Public presentation uses DISCLOSED, PARTIALLY UNDISCLOSED, and MATERIALLY UNDISCLOSED.
What this check cannot tell you

Exact means minimum-cost within the pinned finite repair model; it is not proof of safe execution or a universal real-world cost.