Struct TranscriptReader 

pub struct TranscriptReader;

Reads and reconstructs message history from JSONL transcript files.

Implementations

impl TranscriptReader

pub fn load(path: &Path) -> Result<Vec<Message>, SubAgentError>

Load all messages from a JSONL transcript file.

Malformed lines are skipped with a warning. An empty or missing file returns an empty Vec. If the file does not exist at all but a matching .meta.json sidecar exists, returns SubAgentError::Transcript with a clear message so the caller knows the data is gone rather than silently degrading to a fresh start.

Errors

Returns SubAgentError::Transcript on unrecoverable I/O failures, or when the transcript file is missing but meta exists (data-loss guard).

pub fn load_meta( dir: &Path, agent_id: &str, ) -> Result<TranscriptMeta, SubAgentError>

Load the meta sidecar for an agent.

Errors

Returns SubAgentError::NotFound if the file does not exist, SubAgentError::Transcript on parse failure.

pub fn find_by_prefix(dir: &Path, prefix: &str) -> Result<String, SubAgentError>

Find the full agent ID by scanning dir for .meta.json files whose names start with prefix.

Errors

Returns SubAgentError::NotFound if no match is found, SubAgentError::AmbiguousId if multiple matches are found, SubAgentError::Transcript on I/O failure.