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.
Chain¶
genesis.hash: SHA-256 of the canonical genesis withouthashandserver. 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 withoutlink. seal.chain_head= last link, signed by the server: RSA-PSS SHA-256 overchain_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.