Struct CodexSessionScanner 

pub struct CodexSessionScanner<'a, S: Storage> { /* private fields */ }

Orchestrates Codex session file scanning with storage integration.

CodexSessionScanner provides a high-level API for scanning Codex CLI session files and inserting events into storage. It handles:

• Incremental parsing (only reads new content since last scan)
• Deduplication by timestamp+type key
• Position tracking for future scans

Implementations

impl<'a, S: Storage> CodexSessionScanner<'a, S>

pub fn new(storage: &'a S, machine_id: impl Into<String>) -> Self

Create a new scanner with the given storage and machine ID.

pub fn scan_file(&self, path: &Path) -> Result<ScanResult, ScanError>

Scan a Codex session file and insert events into storage.

This method:

1. Extracts session ID from filename
2. Loads the last scanned position for the file
3. Parses new entries since that position
4. Inserts new events
5. Updates the position for future incremental scans

pub fn scan_session(&self, session_id: &str) -> Result<ScanResult, ScanError>

Scan a session file by session ID.

Looks up the session file path in the standard Codex sessions directory. After scanning, also updates the transcript_path for the provided session_id, which may differ from the UUID extracted from the filename. This ensures sessions created by hooks (using thread-id) get their transcript_path set.