Infrastructure · Verification

AuditTrail

Immutable append-only log of agent actions for compliance and debugging

Definition

Mechanism

Every consequential Agent action (state mutation, external call, delegation, decision) appends a Signed entry to an immutable Ledger whose sequence number advances via MonotonicCounter, so no entry can be wedged between two existing ones. Each entry contains: timestamp, Agent Identity, action type, input hash, output hash, and the sema pattern invoked. Extends Trace from single-entity lineage to cross-agent compliance logging. The trail is append-only — entries cannot be modified or deleted. For cross-agent auditing, individual trails are aggregated via Merkle roots into a shared Snapshot, enabling any party to verify the complete history without accessing raw entries.

Preconditions

  1. Agent has established Identity
  2. Ledger is accessible and writable

Postconditions

  1. Action recorded with full provenance in Ledger
  2. Snapshot of trail Merkle root available for external verification

Invariants

  1. Append-Only: No entry in the Ledger may be modified after creation
  2. Every entry must be Signed by the acting Agent
  3. Trace provenance must link each entry to the sema pattern that triggered it

Risks

Failure modes

  1. Storage exhaustion (unbounded trail growth in long-running systems).

  2. Clock skew (distributed agents disagree on timestamps — use logical clocks).

  3. Selective logging (agent omits inconvenient entries — requires external Audit).

Relationships

Builds on

Composes with

References

Mind

Agent

Autonomous Goal-Directed Entity

Audit

Verification of conformance

Ledger

Immutable transactional history

Sign

Attest to authorship or agreement

Trace

Record the lineage or provenance of a target

Nothing in this library builds on this pattern yet.

Reference

Signature

  • Trace(Ledger)

Identity

Ref
AuditTrail#163b
Sema ID
sema:AuditTrail#mh:SHA-256:163b784f86e448340b94d0459483f0f476e052b5b7c589113f5c7df5dd1115a8
Ring
1
Tier
1
Updated
2026-11-11
Supersedes
  • sema:AuditTrail#mh:SHA-256:ff66d6d56fc4208d20e8bb1835ea9a04dc23269ced480e27c2cebb2f2fa6890c
  • sema:AuditTrail#mh:SHA-256:b4419b5e90a6a7c5433fe5bcb459ca9fbff9cbd7d48ccf9b44b0b64166959551
  • sema:AuditTrail#mh:SHA-256:bf18738b25414c907d542cc6971b13ecf1fb7b415d10529f1c398a1e08109f92
  • sema:AuditTrail#mh:SHA-256:46f73da14d15073869646008bafb50651a875287b559885fda3ae578c8ebbaa9