# Agent Session Record

> Agent Session Record (ASR) is an open, vendor-neutral format for keeping a record of an agent session.

## Docs

- [Introduction](/index): An open, vendor-neutral format for keeping a record of an agent session.
- [Quick tour](/get-started/quick-tour): A walk through one short coding session, record by record.
- [Why ASR](/get-started/why-asr): How ASR relates to the Agent Client Protocol (ACP), ATIF, GitHub UAS, OpenTelemetry GenAI, Agent Trace, Git AI and Entire.
- [For harness authors](/get-started/harness-authors): How an agent harness adopts ASR, from third-party converters to a conformant native log.
- [For tool builders](/get-started/tool-builders): What readers, converters, exporters and storage tools must do with ASR streams.
- [White paper](/whitepaper): Agent Session Record: an open format for recorded agent sessions. A white paper and call for review, by Wills Manley.
- [Roadmap](/community/roadmap): The work between this draft and Preview, and the criteria for 1.0.
- [Governance](/community/governance): How ASR is developed, versioned and maintained.
- [Contributing](/community/contributing): How to send feedback, propose changes and contribute fixtures.
- [FAQ](/community/faq): Common questions about Agent Session Record.
- [Overview](/spec/overview): What the Agent Session Record format is, what it covers, what it leaves out, and how the specification is organized.
- [Conventions](/spec/conventions): Requirement keywords, terminology, JSON encoding rules, requirement IDs and how examples are labeled.
- [Physical format](/spec/format): Streams, immutable records, one writer per stream, torn tails, seq, bundles and their manifest, blobs and digests.
- [Identity](/spec/identity): Session keys, agent names and the identity registry, the session reference grammar, refs, record IDs versus entity IDs, derived and capture-scoped IDs, and inference IDs.
- [Envelope](/spec/envelope): The fields common to every record, the catalog of record types, and a summary of extension rules.
- [Session records](/spec/session): The session header with participants and conversations, session_info, declaration with its merge rules, state, turns and triggers, config_change, instructions and memory_change.
- [Messages](/spec/messages): The message record, roles, authors, origins and part-level values, senders, recipients and conversations, status and phase, content parts pinned to MCP and ACP content blocks plus data and opaque parts, reasoning, plans and deliveries.
- [Tools](/spec/tools): Tool calls and tool results, who requested a call, provider identity, linkage and pairing rules, shell execution details, approvals with and without a request, questions to the user, terminals and hooks.
- [Inference and usage](/spec/inference): The inference record for one model call, usage fields and cache inclusion rules, cost provenance and billing, usage_summary with its scope, coverage, quota and counting rules, and the request context with prefix chains.
- [Structure](/spec/structure): Order, context-participating and audit-only records, implicit predecessors, rewind, branchesFrom, the mechanical-sibling rule for tree-stored sources, heads, and the normative active-path and context-view algorithms, with compaction.
- [Lineage](/spec/lineage): Lineage facets with per-facet evidence, sessions run by another session and mirror streams, scope and role, the subagent record and its revisions, copied records and inherited prefixes, and the counting rules that keep copies from being counted twice.
- [Coding profile](/spec/coding): The coding profile. File changes with structured operations, object IDs, precision and basis; VCS actions and pull request links with evidence; workspace state; checkpoints; and the single path encoding used everywhere.
- [Missing data and revisions](/spec/honesty): What absence means, capture states, revisions with supersedes and assembly, declared losses, gap and tombstone records, and why ASR has no trust labels.
- [Privacy and security](/spec/privacy-security): Content levels, per-record redactions, redactable roots, producing redacted streams, the security requirements for readers and tools, and why conformance does not make a file safe to share.
- [Extensibility](/spec/extensibility): What the core includes and where other recorded facts go, _meta, vendor record types and enum values, open enums, the extensions list, profiles (what a producer promises to record), versioning, deprecation, and reader and storage obligations.
- [Conformance](/spec/conformance): Conformance classes, what a conformance claim must state, the validator, the golden corpus and adversarial fixtures, and the table of every requirement with its check type.
- [ACP mapping](/spec/acp): The normative mapping between ACP v2 and ASR, pinned to ACP schema v2.0.0-alpha.9; how a recorder turns a live ACP stream into an ASR stream, how an ASR stream is replayed as ACP updates, and the declared losses in each direction.
- [Agent identity registry](/spec/registry/index): Per-agent identity rules for producers and converters - short and reverse-DNS names, how session IDs, namespaces, subagent and fork identities, inference IDs and tree structure are derived - with native format notes and the destinations of native facts that have no standard field.
- [claude-code](/spec/registry/claude-code): Agent identity and native format mappings for claude-code.
- [t3-code](/spec/registry/t3-code): Agent identity and native format mappings for t3-code.
- [codex](/spec/registry/codex): Agent identity and native format mappings for codex.
- [openclaw](/spec/registry/openclaw): Agent identity and native format mappings for openclaw.
- [cursor](/spec/registry/cursor): Agent identity and native format mappings for cursor.
- [copilot-cli](/spec/registry/copilot-cli): Agent identity and native format mappings for copilot-cli.
- [gemini-cli](/spec/registry/gemini-cli): Agent identity and native format mappings for gemini-cli.
- [opencode](/spec/registry/opencode): Agent identity and native format mappings for opencode.
- [pi](/spec/registry/pi): Agent identity and native format mappings for pi.
- [droid](/spec/registry/droid): Agent identity and native format mappings for droid.
- [goose](/spec/registry/goose): Agent identity and native format mappings for goose.
- [openhands](/spec/registry/openhands): Agent identity and native format mappings for openhands.
- [cline](/spec/registry/cline): Agent identity and native format mappings for cline.
- [roo-code](/spec/registry/roo-code): Agent identity and native format mappings for roo-code.
- [kilo](/spec/registry/kilo): Agent identity and native format mappings for kilo.
- [zed](/spec/registry/zed): Agent identity and native format mappings for zed.
- [warp](/spec/registry/warp): Agent identity and native format mappings for warp.
- [kiro](/spec/registry/kiro): Agent identity and native format mappings for kiro.
- [qwen-code](/spec/registry/qwen-code): Agent identity and native format mappings for qwen-code.
- [crush](/spec/registry/crush): Agent identity and native format mappings for crush.
- [grok-build](/spec/registry/grok-build): Agent identity and native format mappings for grok-build.
- [antigravity](/spec/registry/antigravity): Agent identity and native format mappings for antigravity.
- [junie](/spec/registry/junie): Agent identity and native format mappings for junie.
- [auggie](/spec/registry/auggie): Agent identity and native format mappings for auggie.
- [amp](/spec/registry/amp): Agent identity and native format mappings for amp.
- [astrbot](/spec/registry/astrbot): Agent identity and native format mappings for astrbot.
- [codebuddy](/spec/registry/codebuddy): Agent identity and native format mappings for codebuddy.
- [continue](/spec/registry/continue): Agent identity and native format mappings for continue.
- [deepagents](/spec/registry/deepagents): Agent identity and native format mappings for deepagents.
- [deepseek-harness](/spec/registry/deepseek-harness): Agent identity and native format mappings for deepseek-harness.
- [devin](/spec/registry/devin): Agent identity and native format mappings for devin.
- [firebender](/spec/registry/firebender): Agent identity and native format mappings for firebender.
- [forgecode](/spec/registry/forgecode): Agent identity and native format mappings for forgecode.
- [fx](/spec/registry/fx): Agent identity and native format mappings for fx.
- [hermes](/spec/registry/hermes): Agent identity and native format mappings for hermes.
- [kimi-code](/spec/registry/kimi-code): Agent identity and native format mappings for kimi-code.
- [lingma](/spec/registry/lingma): Agent identity and native format mappings for lingma.
- [mimocode](/spec/registry/mimocode): Agent identity and native format mappings for mimocode.
- [mistral-vibe](/spec/registry/mistral-vibe): Agent identity and native format mappings for mistral-vibe.
- [mux](/spec/registry/mux): Agent identity and native format mappings for mux.
- [nanoclaw](/spec/registry/nanoclaw): Agent identity and native format mappings for nanoclaw.
- [qoder](/spec/registry/qoder): Agent identity and native format mappings for qoder.
- [rovodev](/spec/registry/rovodev): Agent identity and native format mappings for rovodev.
- [shelley](/spec/registry/shelley): Agent identity and native format mappings for shelley.
- [tabnine](/spec/registry/tabnine): Agent identity and native format mappings for tabnine.
- [Integration companion](/companions/integration): Linking commits to sessions with the Agent-Session trailer and the agent-sessions notes ref, recognized alias trailers, the export command and discovery file, and consent rules.
- [ATIF companion](/companions/atif): Exporting ASR streams as ATIF v1.8 trajectories, one per root-to-leaf path, and importing ATIF documents as ASR streams.
- [OpenTelemetry companion](/companions/otel): Generating OpenTelemetry GenAI spans from ASR streams, only where the stream records timing, with opt-in content capture.
- [Attribution companion](/companions/attribution): Deriving line attribution from ASR file changes and VCS records, and emitting it as Agent Trace records and Git AI notes, including the Git AI session join key.
- [GitHub UAS companion](/companions/uas): Importing GitHub Unified Agent Session traces into ASR and exporting ASR streams as UAS canonical traces.
- [Entire companion](/companions/entire): Importing sessions from Entire's Git-stored checkpoints, preferring native transcripts over the Entire Transcript Format, and resolving Entire-Checkpoint trailers.