read_provenance
Trace any fact back to its original chat message to verify sources, build citations, or audit provenance. Returns platform, author, timestamp, and raw message.
Instructions
Trace ONE fact back to the original chat message it was extracted from. Call it to verify or cite a fact — given a fact_id from another tool, it returns where the fact came from (platform, message, author, timestamp, and the raw message text when reachable).
When to use: confirming a fact's source, building a citation, or auditing provenance. Prerequisites: a fact_id surfaced by find_facts, find_decisions, search_channel_facts, search_memory, or an ask_channel citation.
Returns (instant, read-only): {fact_id, memory_text, source: {platform, message_id, url, author, ts}, raw_message}. raw_message is the
original chat body, or an empty string if the source message is no longer
reachable — every other field is still populated in that case. No side
effects.
Error modes (returned as dicts): 'authentication_missing' (no principal); 'fact_not_found' (unknown fact_id — also returned, deliberately, when the caller lacks access to the fact's channel, so cross-tenant existence is never leaked); 'provenance_read_failed' (internal error).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fact_id | Yes | Fact id to trace, as returned in the ``fact_id`` field of another tool's result (e.g. 'fact_abc123' from find_facts, find_decisions, search_channel_facts, or ask_channel citations). Required. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||