Skip to content

Agent log format

Open format of an agent session, so anyone can check one or write one.

File

A PDF: readable pages, then the signed log as JSON between %%KVERITAS_AGENT_BEGIN%% and %%KVERITAS_AGENT_END%%. Nothing may follow the end marker. kveritas seal -o session.json writes the JSON alone.

{"version": "1.0", "genesis": {...}, "entries": [...], "seal": {...}}

Chain

  • genesis.hash: SHA-256 of the canonical genesis without hash and server. Signed by the server at start.
  • each entry: prev_link = link of the entry before (the genesis hash for the first); link = SHA-256 of the canonical entry without link.
  • seal.chain_head = last link, signed by the server: RSA-PSS SHA-256 over chain_head:nonce:signed_at, with a key from the trusted list.

Canonical JSON: keys sorted, no spaces, UTF-8, < > & escaped as < > &. All numbers are integers.

Entries

type
agent.start A traced run begins. summary names the command and the root process.
effects Up to 500 effects seen by the tracer.
label.<tool> The agent's own label. target: SHA-256 of the absolute file path.
agent.end Run summary (exit, duration, resources) and the final state of every file touched (final effects).
report Last entry. output_hash: SHA-256 of the readable pages.
prompt, tool_call.*, file_effect, spawn Claude Code hooks or kveritas record.

Effects

Field
op exec, write, create, rename, delete, read, connect, exit, escape, stopped, final
at Time (RFC 3339).
pid, ppid Process and its parent.
subject Shown per disclosure: nothing for files when redacted, paths for names, full commands for open.
hash SHA-256 of the full path, command (arguments joined by NUL) or address.
to, to_hash Rename target.
before, after Content SHA-256 before the change and at the end; size:<bytes> above 16 MB; deleted.
exit Exit code.
escape Why it was flagged.
project Inside the project folder.

Server witness

Each entry is sent as it is recorded: invocation = index, run_digest = link, chain = SHA-256 of previous chain:link, starting from SHA-256 of kveritas-run-chain:<session> then the genesis hash. The server refuses a seal unless it holds every entry and the last one is chain_head.