Innsigle Use Session provenance

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

LayerWhatPublic?
ContentThe markdown/HTML you shipYes
ColophonComposition + ingredientsYes (in claim)
Session provenancePrompt counts, tools, timelineOptional URL
Raw transcriptFull chatLocal by default

Quick results (fixture)

MetricValue
Human prompts6 (3 prompts × Claude and Codex)
Compositionmodel-primary
ModelsClaude, Codex
Toolsinnsigle-session, sloptimizer

Sloptimizer is listed as a tool. It does not flip composition to human-authored.

Machine pack

FileDescription
human-inputs.jsonScripted human prompts
session-claude.jsonlClaude journal
session-codex.jsonlCodex journal
session-provenance.jsonSession record
colo.jsonProposed colo
sealed-notes-claude.mdDocument from Claude
sealed-notes-codex.mdDocument 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

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"
    }
  ]
}