ZioConversationArchive

Streams the main-thread entries of a session. Resolves vendor-then-mirror like forSession.

Reads the page of up to limit entries immediately older than token.

The token is pinned to the transcript it was minted against; if the session now resolves to a different file (the vendor tree was pruned between pages), this fails with ArchiveError.PageSourceMoved rather than reading a stale offset against the wrong file. If the session no longer resolves under either root at all, this fails with ArchiveError.SessionNotFound.

Follows a session's main transcript as the agent writes it.

The first element is the newest page of what the transcript already holds — the same read lastEntries makes — and every element after it is what the file has grown by since the element before. Nothing is emitted while the file is unchanged, and a line the writer has not finished is held back until it is, so an entry is read exactly once and never half-written.

The whole of what the follow remembers is a byte offset into an append-only file, so nothing that was read is held on to. The session is resolved once, vendor-then-mirror, and the offset belongs to the file that resolution found: a read that fails because that file went away — or finds a file shorter than what has already been read, which an append-only transcript never is — ends the follow, and re-subscribing resolves again.

Locates a session by encoding the configured cwd, resolving the live vendor tree first and falling back to the archive mirror; None when no main transcript exists under either root. The returned record's root names which one won.

Reads the last limit main-thread entries of a session without parsing the transcript from the start. Entries within the returned page are oldest-first; the page itself is the newest slice of the transcript. The page's older cursor pages backward through earlier, older pages. Resolves vendor-then-mirror like forSession, so a pruned session still tails from the mirror.

Idempotently mirrors the whole session tree into the archive directory, reporting what was copied, extended, refreshed, and skipped.

Custody is one-directional: when the session resolves under works.iterative.claude.core.log.model.RecordRoot.Archive (the vendor tree is already pruned), this is a no-op returning works.iterative.claude.core.log.model.MirrorReport.empty — the archive is never truncated or recopied from nothing. Only a Vendor-resolved record is ever a mirror source. SessionNotFound is raised only when neither root holds the session.

Streams a sub-agent's own sidechain entries, joined to its parent by the tool_use id recorded in the sub-agent's .meta.json. Resolves vendor-then-mirror like forSession.