Skip to content
C.W.K.
Stream
Lesson 01 of 04 · published

If the Model Could See It, It Is a Line

~12 min · record, jsonl, provenance

Level 0Cold Stick
0 XP0/41 lessons0/14 achievements
0/100 XP to next level100 XP to go0% complete

The Notebook Is the Product

A chat transcript is a souvenir. Firebrand's record is the lab notebook: one JSON object per line, contiguous sequence numbers, a timestamp, a turn, a step, and a kind. Large bodies live beside the file as content-addressed artifacts. The kinds cover what the model said, what the operator said, what the engine decided, and what the world returned — session start, user, request, delta, assistant text and thinking, tool-call and result, permission, plan, ask, compaction, cut, error, session end.

Raw wire per step is stored by digest too. The wire is what the model said, so a dialect decode bug is falsifiable from the record alone. A digest chain for tamper-evident export is a named option that is not built. Nothing writes it, nothing verifies it, and no surface claims it. An unbuilt integrity feature is a hole you can name. A claimed one you cannot verify is a lie.

Model-visible means logged. If a later reader cannot tell what the model was shown, you did not have a session. You had a performance.

Chrome Stays Out

Operator-only session chrome — a title, an archived flag — is not model-visible, so it does not enter the JSONL. It lives in the session metadata file, updated only while holding the writer lock. Mixing chrome into the record would make resume feed the model a filing cabinet.

Code

The smallest line that still counts as a record·json
{
  "seq": 12,
  "ts": "2026-08-30T12:00:00Z",
  "turn": 1,
  "step": 2,
  "kind": "tool_call",
  "name": "read",
  "args": {"path": "README.md"}
}

External links

Exercise

Open any agent log you already have. Mark every fact the model used that is not on a line. Those facts are the ones a crash will invent or a review will be unable to check.
Hint
The usual missing line is the exact tool schema advertised on that step, or the exact request body.

Progress

Progress is local-only — sign in to sync across devices.
Spotted a bug or have feedback on this page?Report an Issue

Comments 0

🔔 Reply notifications (sign in)
Sign inPlease sign in to comment.

No comments yet — be the first.