Session provenance
You finish an agent session with a shiny markdown file and no durable record of which prompts, tools, or models the harness captured. Session provenance records those events and proposes a short colophon for review, so the seal can name what the journal actually logged.
See the story first: Walkthrough: conversation → document → colophon
That page shows human prompts, the document the agent wrote, the proposed colophon, and a sealed-page footer, using the multi-agent fixture (Claude + Codex).
In one diagram
You prompt the agent
↓
Agent writes a document (model-primary bytes)
↓
Skill records journal → builds session record → proposes colo
↓
You review · optionally publish the record · sign claim to content bytes
Signing stays a separate, deliberate step. Auto-sign is out of scope.
Human-input percent
When journal events carry char evidence (user_prompt.chars, file_write.chars_added), the session record and proposed colophon include human_input: an integer percent from method hi1 — direction (prompts per model write burst) · contribution (human vs model chars) · review (post-output prompts and explicit human review events). A sealed page's footer can then read "model-primary · 48% human input". Raw counts ride along, so the headline is recomputable by anyone; journals without char evidence get no percent. Spec: human-input measure (hi1).
Layers
| Layer | What | Public? |
|---|---|---|
| Content | The markdown/HTML you ship | Yes |
| Colophon | Composition + ingredients | Yes (in claim) |
| Session provenance | Prompt counts, tools, timeline | Optional URL |
| Raw transcript | Full chat | Local by default |
Quick results (fixture)
| Metric | Value |
|---|---|
| Human prompts | 6 (3 prompts × Claude and Codex) |
| Composition | model-primary |
| Models | Claude, Codex |
| Tools | innsigle-session, sloptimizer |
Sloptimizer is listed as a tool. It does not flip composition to human-authored.
Machine pack
| File | Description |
|---|---|
| human-inputs.json | Scripted human prompts |
| session-claude.jsonl | Claude journal |
| session-codex.jsonl | Codex journal |
| session-provenance.json | Session record |
| colo.json | Proposed colo |
| sealed-notes-claude.md | Document from Claude |
| sealed-notes-codex.md | Document from Codex |
Reproduce
From a full clone of this repo:
npm run test:provenance-driver
innsigle provenance build \
--journal session.jsonl \
--generated-at 2026-07-24T18:00:00Z \
--out l2.json
innsigle provenance propose-colo --provenance l2.json --out colo.json
(From a clone without install: node src/cli.mjs ….)
Check it
What we claim: the fixture driver proposes model-primary and lists rewrite tools without laundering authorship.
npm run test:provenance-driver
# then inspect examples under docs/website/static/examples/provenance/
# or site/examples/provenance/ after a site build
Expect: composition model-primary; ingredients include models and innsigle-session / sloptimizer as tools, not a flip to human-authored.
Spec
- Walkthrough (story)
- Design: session provenance
- Feature note: session provenance feature
Innsigle seal: mixed by Innsigle (human key)
Signature covers the markdown source of this page, not these HTML bytes. This render quotes that seal.
- Composition
- mixed
- Issuer
- Innsigle
innsigle - Signing key
ed25519:15c6242b6ef825413847e221267959c9(human key)- Signed source
docs/website/content/curated/use/provenance.md- Signed
- 2026-09-30T20:46:37Z
- Content digest
sha256:9d25b2d5…37915767
Human-controlled key. Signature is not a detector and not a truth guarantee.
Raw attestation JSON
{
"payload": {
"innsigle": "1",
"type": "https://innsigle.dev/claim/colophon/v1",
"issued_at": "2026-09-30T20:46:37Z",
"issuer": {
"id": "innsigle",
"name": "Innsigle",
"key_id": "ed25519:15c6242b6ef825413847e221267959c9",
"key_url": "https://documentdrivendx.github.io/innsigle/.well-known/innsigle/keys.json"
},
"subjects": [
{
"uri": "https://documentdrivendx.github.io/innsigle/use/provenance/",
"digest": {
"alg": "sha256",
"value": "9d25b2d5cbe00285225d7f636be60f4df588554ce77a2c6e6a57b45937915767"
}
}
],
"colophon": {
"schema_version": "1",
"composition": "mixed",
"ingredients": [
{
"kind": "human",
"name": "operator",
"role": "outline"
},
{
"kind": "model",
"name": "Claude",
"role": "expand"
},
{
"kind": "human",
"name": "operator",
"role": "final-edit"
}
],
"notes": null
}
},
"payload_encoding": "json",
"signatures": [
{
"key_id": "ed25519:15c6242b6ef825413847e221267959c9",
"alg": "ed25519",
"sig": "x7CW3rJHeG5j6oLgYVVwMYdUV-QLKN6i4jk7oMSVZBtxFM5i04KhAEvrtMLLPjEVpK6LBTgO9yIgnKFVdBI2BQ",
"signed_at": "2026-09-30T20:46:37Z"
}
]
}