Provenance on a Company State record
How to read the four-part provenance panel — source evidence, affected entities, external references, and connector object links.
Every Company State detail page carries the same Provenance panel down the side. It answers one question: where did this record come from, and what does it touch?
This matters most for records an agent created. A commitment that appeared without anyone typing it is only trustworthy if you can see what it was made from.
Source evidence
When an agent or connector created the record, it links the evidence packet it read — the captured email, message, or synced record behind it. The panel shows:
- The packet ID and the source system it came from.
- The source ID — the identifier in that system.
- Evidence time — when the evidence itself was captured, not when the record was created.
- A content hash of the captured evidence.
The hash is what makes this more than a label. It fixes exactly what the record was made from, so the evidence can't be quietly swapped for something else afterwards.
You cannot set or edit any of this. Provenance is written by whatever created the record, and the edit forms deliberately have no field for it. Records you create by hand simply show "No source evidence packet linked" — that's expected, not an error.
Affected entities
The accounts, contacts, opportunities, projects, tasks, or people the record concerns, shown as links out to those records.
The link only goes one way. Opening an account will not show you the commitments and risks attached to it — you have to come from the Company State side.
External references
Pointers back at the original thing in another system, shown as
system:id — and clickable when a URL was recorded. On commitments
these can be typed on the form as gmail:msg-1:https://...; on policies
and intention records they're entered as JSON.
External object links
Connector-managed links, shown as connector:id. These are maintained
by the connector framework rather than entered by anyone, and appear
only for records a connector is tracking.
When sections are empty
Each of the four sections says so plainly when it has nothing — no evidence packet, no external references, no connector links. Empty means nothing was recorded, not that something failed to load.