The Bridge Between Logs and Documents
Turn immutable audit logs into editable, human-friendly documents while preserving cryptographic provenance.
The Problem
Audit logs (.tai) are great for machines and regulators, but terrible for collaboration.
You can't edit them (they're immutable), and they contain too much raw data for a casual reader.
But if you copy-paste content into a Google Doc, you lose the chain of custody. How do you prove that the "Research Report" was actually generated by the AI and hasn't been tampered with?
The Solution: .taimd
TAI Markdown is a standard Markdown file with a special YAML frontmatter block
that cryptographically links it back to the source .tai log.
- Editable: It's just Markdown. Open it in any editor.
- Verifiable: The header contains the hash of the source log.
- Traceable: Every paragraph can link to the specific log frame that generated it.
How it Works
The Export Workflow allows you to "freeze" a moment from a dynamic agent execution into a static artifact.
1. The Export Script
from tai import tai_export
# Extract insights from an agent conversation into an editable document
tai_export(
source_filename="research_discussion.tai",
selector="log.last.content", # Extract the final answer
output_filename="research_report.taimd",
title="AI Research Findings"
)
2. The Resulting File (.taimd)
---
title: AI Research Findings
source_log: research_discussion.tai
source_hash: sha256:a1b2c3d4...
generated_at: 2025-11-19T12:00:00Z
---
# AI Research Findings
Here is the summary of the research...
[View Source Context](tai://research_discussion.tai#frame=105)
Use Cases
Lab Notebooks
Scientists can edit their notes while proving the raw data came from a specific instrument run.
Legal Contracts
Lawyers can negotiate terms in a readable doc, linked to the AI negotiation log that drafted it.
Medical Reports
Doctors get a clean summary for the patient file, linked to the full diagnostic reasoning trace.