sidekick-shared 0.29.1 → 0.30.0

package/dist/providers/codex.js

@@ -5,7 +5,9 @@
  * Implements SessionProviderBase for monitoring Codex CLI sessions.
  * Codex stores sessions as JSONL rollout files in:
  *   ~/.codex/sessions/YYYY/MM/DD/rollout-<timestamp>-<uuid>.jsonl
- * with an optional SQLite index at ~/.codex/state.sqlite.
+ * with an optional SQLite index at ~/.codex/state.sqlite. Older rollouts are
+ * compressed in place to `….jsonl.zst`; those are read only with the
+ * `includeCompressedRollouts` option (see `providers/compressedRollouts`).
  *
  * Ported from sidekick-vscode/src/services/providers/CodexSessionProvider.ts
  */
@@ -51,17 +53,20 @@ const sessionContext_1 = require("../context/sessionContext");
 const sessionStats_1 = require("../sessionStats");
 const codexParser_1 = require("../parsers/codexParser");
 const codexDatabase_1 = require("./codexDatabase");
-const subagentStatsCache_1 = require("../parsers/subagentStatsCache");
 const rolloutWalker_1 = require("./rolloutWalker");
+const compressedRollouts_1 = require("./compressedRollouts");
+const codexCompressedReader_1 = require("./codexCompressedReader");
+const codexSubagents_1 = require("./codexSubagents");
+const codexRolloutOrigin_1 = require("../parsers/codexRolloutOrigin");
 const codexPaths_1 = require("../codexPaths");
 const codexRollouts_1 = require("./codexRollouts");
 Object.defineProperty(exports, "findCodexRolloutFile", { enumerable: true, get: function () { return codexRollouts_1.findCodexRolloutFile; } });
 const directoryListingCache_1 = require("./directoryListingCache");
+const fileContinuity_1 = require("../fileContinuity");
 const diagnostics_1 = require("./diagnostics");
 const modelContext_1 = require("../modelContext");
 const observedContextWindows_1 = require("../observedContextWindows");
 const usageNormalization_1 = require("../usageNormalization");
-const subagentUsage_1 = require("../usage/subagentUsage");
 // ---------------------------------------------------------------------------
 // Helper functions
 // ---------------------------------------------------------------------------
@@ -74,8 +79,8 @@ function truncate(text, maxLen) {
     return trimmed;
 }
 /** Every rollout under a directory, newest first (one capped walk). */
-function findRolloutFiles(dir) {
-    return (0, rolloutWalker_1.walkRolloutFiles)([dir]);
+function findRolloutFiles(dir, includeCompressed = false) {
+    return (0, rolloutWalker_1.walkRolloutFiles)([dir], { includeCompressed });
 }
 function hasRolloutFile(dir) {
     return (0, rolloutWalker_1.walkRolloutFiles)([dir], { limit: 1 }).length > 0;
@@ -84,6 +89,10 @@ function hasRolloutFile(dir) {
 function findRolloutFilesInConfiguredHomes(options = {}) {
     return (0, rolloutWalker_1.walkRolloutFiles)((0, codexRollouts_1.getSessionsDirs)(), options);
 }
+/** Whether a rollout's session_meta says a subagent wrote it. */
+function isSubagentRollout(rolloutPath) {
+    return (0, codexRolloutOrigin_1.codexRolloutOrigin)((0, codexRollouts_1.readSessionMeta)(rolloutPath)).isSubagent;
+}
 /** Pick the best sessions directory for UI/search entrypoints. */
 function getSessionsDir() {
     const dirs = (0, codexPaths_1.getCodexSessionsDirs)(undefined, { includeArchived: false });
@@ -160,19 +169,16 @@ function extractFirstUserMessageFromLines(lines) {
     return null;
 }
 async function extractFirstUserMessageAsync(rolloutPath) {
-    let handle = null;
     try {
-        handle = await fs.promises.open(rolloutPath, 'r');
-        const buffer = Buffer.alloc(256 * 1024);
-        const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
-        return extractFirstUserMessageFromLines(buffer.toString('utf8', 0, bytesRead).split('\n').slice(0, 20));
+        // A compressed rollout's head is decompressed; a plain one is read as is.
+        const head = await (0, compressedRollouts_1.readRolloutHeadAsync)(rolloutPath, 256 * 1024);
+        if (head.length === 0)
+            return null;
+        return extractFirstUserMessageFromLines(head.toString('utf8').split('\n').slice(0, 20));
     }
     catch {
         return null;
     }
-    finally {
-        await handle?.close().catch(() => undefined);
-    }
 }
 /** Extract searchable text from a rollout line. */
 function extractSearchableText(line) {
@@ -304,7 +310,15 @@ class CodexReader {
     /** Cursor after the last complete line, safe to persist across restarts. */
     committedPosition = 0;
     lineBuffer = '';
-    _wasTruncated = false;
+    /** Why the last `readNew()` started over from offset 0, if it did. */
+    _lastReset = null;
+    /**
+     * A restart found while settling a seek (the file is now shorter than the
+     * position sought); the next `readNew()` reports it.
+     */
+    pendingRestart = null;
+    /** Whether the rollout is still the one the positions refer to. */
+    continuity = new fileContinuity_1.FileContinuity();
     decoder = new string_decoder_1.StringDecoder('utf8');
     /**
      * Position from `seekTo()` whose prefix still has to be parsed for model,
@@ -317,7 +331,7 @@ class CodexReader {
         this.onContextWindowLimit = onContextWindowLimit;
         this.onRateLimits = onRateLimits;
         this.onTokenUsage = onTokenUsage;
-        this.parser = new codexParser_1.CodexRolloutParser();
+        this.parser = new codexParser_1.CodexRolloutParser({ includeSubagentActivity: true });
     }
     /** Get the parser's session metadata. */
     getSessionMeta() {
@@ -326,36 +340,32 @@ class CodexReader {
     }
     readNew(endPosition) {
         this.settleSeek();
-        this._wasTruncated = false;
+        this._lastReset = null;
         const events = [];
+        let fd = null;
         try {
-            if (!fs.existsSync(this.rolloutPath))
-                return [];
-            const stats = fs.statSync(this.rolloutPath);
-            const currentSize = Math.min(stats.size, endPosition ?? stats.size);
-            // Handle truncation
-            if (currentSize < this.filePosition) {
-                this._wasTruncated = true;
-                this.filePosition = 0;
-                this.committedPosition = 0;
-                this.lineBuffer = '';
-                this.parser.reset();
-                this.decoder = new string_decoder_1.StringDecoder('utf8');
+            // Open first and stat the descriptor: the size and identity checked
+            // are those of the file actually read, even if the path is replaced.
+            fd = fs.openSync(this.rolloutPath, 'r');
+            const stats = fs.fstatSync(fd);
+            if (this.pendingRestart) {
+                this._lastReset = this.pendingRestart;
+                this.pendingRestart = null;
             }
+            const reason = this.continuity.check(fd, stats, this.filePosition, this.committedPosition);
+            // Truncated, rewritten, or replaced: what was read no longer describes
+            // the rollout, so start over from its beginning.
+            if (reason !== null)
+                this.restart(reason);
+            this.continuity.adopt(stats);
+            const currentSize = Math.min(stats.size, endPosition ?? stats.size);
             // No new content
             if (currentSize <= this.filePosition)
-                return [];
+                return events;
             // Read new bytes
-            const fd = fs.openSync(this.rolloutPath, 'r');
             const bufferSize = currentSize - this.filePosition;
             const buffer = Buffer.alloc(bufferSize);
-            let bytesRead = 0;
-            try {
-                bytesRead = fs.readSync(fd, buffer, 0, bufferSize, this.filePosition);
-            }
-            finally {
-                fs.closeSync(fd);
-            }
+            const bytesRead = fs.readSync(fd, buffer, 0, bufferSize, this.filePosition);
             const bytes = buffer.subarray(0, bytesRead);
             const newline = bytes.lastIndexOf(0x0a);
             if (newline >= 0)
@@ -382,10 +392,30 @@ class CodexReader {
             this.propagateParserState();
         }
         catch {
-            // Skip read errors
+            // Skip read errors (a missing rollout reads as no events)
+        }
+        finally {
+            if (fd !== null) {
+                try {
+                    fs.closeSync(fd);
+                }
+                catch {
+                    // Ignore close errors.
+                }
+            }
         }
         return events;
     }
+    /** Starts over from offset 0 of a rollout that was truncated, rewritten, or replaced. */
+    restart(reason) {
+        this._lastReset = { reason, previousPosition: this.committedPosition };
+        this.filePosition = 0;
+        this.committedPosition = 0;
+        this.lineBuffer = '';
+        this.parser.reset();
+        this.decoder = new string_decoder_1.StringDecoder('utf8');
+        this.pendingSeek = null;
+    }
     /** Hands the parser's context window, rate limits, and last usage to the provider. */
     propagateParserState() {
         // Propagate model_context_window from token_count events to the provider.
@@ -434,8 +464,11 @@ class CodexReader {
         this.lineBuffer = '';
         this.parser.reset();
         this.decoder = new string_decoder_1.StringDecoder('utf8');
-        this._wasTruncated = false;
+        this._lastReset = null;
+        this.pendingRestart = null;
         this.pendingSeek = null;
+        // The next read adopts whatever rollout has the path.
+        this.continuity.forget();
     }
     exists() {
         return fs.existsSync(this.rolloutPath);
@@ -468,7 +501,10 @@ class CodexReader {
             this.pendingSeek = position;
     }
     wasTruncated() {
-        return this._wasTruncated;
+        return this._lastReset !== null;
+    }
+    lastReset() {
+        return this._lastReset ? { ...this._lastReset } : null;
     }
     /** The parser's continuation state (see `CodexRolloutParser.exportResumeState`). */
     getResumeState() {
@@ -497,11 +533,14 @@ class CodexReader {
             return;
         this.reset();
         this.readNew(position);
+        if (this.filePosition < position) {
+            // The rollout no longer reaches the position sought: it was truncated
+            // or replaced since. The next read starts over and reports it.
+            this.reset();
+            this.pendingRestart = { reason: 'truncated', previousPosition: position };
+        }
     }
 }
-// ---------------------------------------------------------------------------
-// CodexProvider — full SessionProviderBase implementation
-// ---------------------------------------------------------------------------
 /**
  * Session provider for Codex CLI.
  *
@@ -520,8 +559,26 @@ class CodexProvider {
     lastTokenUsageData = null;
     /** Dated rollout-directory listings reused across async enumerations. */
     directoryCache = new directoryListingCache_1.DirectoryListingCache();
+    /** See {@link CodexProviderOptions.includeCompressedRollouts}. */
+    compressedRequested;
+    onDiagnostic;
     constructor(options = {}) {
         this.diagnostics = new diagnostics_1.ProviderDiagnosticTracker(this.id, options);
+        this.compressedRequested = options.includeCompressedRollouts === true;
+        this.onDiagnostic = options.onDiagnostic;
+    }
+    /**
+     * Whether compressed rollouts are discovered and read: requested, and the
+     * runtime can decompress them (otherwise reported once, on first use).
+     */
+    get includeCompressed() {
+        return (this.compressedRequested && (0, compressedRollouts_1.canReadCompressedRollouts)({ onDiagnostic: this.onDiagnostic }));
+    }
+    /** A stored rollout path as it exists now (its `.zst` when compressed and enabled). */
+    resolveRollout(rolloutPath) {
+        return rolloutPath
+            ? (0, compressedRollouts_1.resolveRolloutPath)(rolloutPath, { includeCompressed: this.includeCompressed })
+            : null;
     }
     // --- Database ---
     /** Lazy-initialize database connection. */
@@ -619,10 +676,11 @@ class CodexProvider {
                 return thread.rollout_path;
             }
         }
-        // File scan fallback (newest first; cwd reads are cached per path)
+        // File scan fallback (newest first; cwd reads are cached per path).
+        // Subagent rollouts share their parent's cwd but are not the session.
         for (const file of findRolloutFilesInConfiguredHomes()) {
             const cwd = (0, codexRollouts_1.readSessionCwd)(file.path);
-            if (cwd && (0, codexRollouts_1.cwdMatches)(cwd, workspacePath)) {
+            if (cwd && (0, codexRollouts_1.cwdMatches)(cwd, workspacePath) && !isSubagentRollout(file.path)) {
                 this.recordDatabaseFallback('findActiveSession', true);
                 return file.path;
             }
@@ -636,15 +694,17 @@ class CodexProvider {
         if (db) {
             const threads = db.getThreadsByCwd(workspacePath);
             const dbPaths = threads
-                .filter((t) => t.rollout_path && fs.existsSync(t.rollout_path))
-                .map((t) => t.rollout_path);
+                .map((t) => this.resolveRollout(t.rollout_path))
+                .filter((rolloutPath) => rolloutPath !== null);
             if (dbPaths.length > 0) {
                 this.recordDatabaseFallback('findAllSessions', true);
                 return dbPaths;
             }
         }
         // File scan (newest first; cwd reads are cached per path)
-        const sessions = findRolloutFilesInConfiguredHomes()
+        const sessions = findRolloutFilesInConfiguredHomes({
+            includeCompressed: this.includeCompressed,
+        })
             .filter((f) => {
             const cwd = (0, codexRollouts_1.readSessionCwd)(f.path);
             return cwd !== null && (0, codexRollouts_1.cwdMatches)(cwd, workspacePath);
@@ -655,7 +715,7 @@ class CodexProvider {
     }
     findSessionById(_workspacePath, sessionId) {
         try {
-            const found = (0, codexRollouts_1.findCodexRolloutFile)(sessionId);
+            const found = (0, codexRollouts_1.findCodexRolloutFile)(sessionId, { includeCompressed: this.includeCompressed });
             this.recordDatabaseFallback('findSessionById', true);
             return found;
         }
@@ -669,15 +729,15 @@ class CodexProvider {
         return this.findAllSessions(workspacePath);
     }
     findSessionsInDirectory(dir) {
-        return findRolloutFiles(dir).map((f) => f.path);
+        return findRolloutFiles(dir, this.includeCompressed).map((f) => f.path);
     }
     listAllSessionFiles() {
-        const files = findRolloutFilesInConfiguredHomes();
+        const files = findRolloutFilesInConfiguredHomes({ includeCompressed: this.includeCompressed });
         this.recordDatabaseFallback('listAllSessionFiles', true);
         return files;
     }
     async listSessionFilesAsync(workspacePath, options = {}) {
-        const results = await (0, codexRollouts_1.listCodexSessionFilesAsync)(workspacePath, options, this.directoryCache);
+        const results = await (0, codexRollouts_1.listCodexSessionFilesAsync)(workspacePath, { ...options, includeCompressed: this.includeCompressed }, this.directoryCache);
         // Filesystem enumeration bypasses the database, so record that here as
         // the sync listing paths do; otherwise `getLastOperationStatus()` keeps
         // describing whichever operation ran before this one.
@@ -697,7 +757,7 @@ class CodexProvider {
         const name = segments[segments.length - 1];
         if (segments.length - 1 > rolloutWalker_1.DEFAULT_ROLLOUT_WALK_MAX_DEPTH)
             return { status: 'ignored' };
-        if (!(0, rolloutWalker_1.isRolloutFile)(name)) {
+        if (!this.isSessionFile(name)) {
             this.directoryCache.invalidate(fullPath);
             try {
                 const stat = await fs.promises.stat(fullPath);
@@ -747,7 +807,9 @@ class CodexProvider {
         // after its last update can be missing from it, so older files are not
         // opened; the cwd read itself is cached per path either way.
         const indexedUpTo = db ? db.getDbMtime() : 0;
-        for (const file of findRolloutFilesInConfiguredHomes()) {
+        for (const file of findRolloutFilesInConfiguredHomes({
+            includeCompressed: this.includeCompressed,
+        })) {
             if (db && indexedUpTo > 0 && file.mtime.getTime() <= indexedUpTo)
                 continue;
             const cwd = (0, codexRollouts_1.readSessionCwd)(file.path);
@@ -789,7 +851,7 @@ class CodexProvider {
     }
     // --- File identification ---
     isSessionFile(filename) {
-        return (0, rolloutWalker_1.isRolloutFile)(filename);
+        return (0, rolloutWalker_1.isRolloutFile)(filename) || (this.includeCompressed && (0, rolloutWalker_1.isCompressedRolloutFile)(filename));
     }
     getSessionId(sessionPath) {
         return (0, rolloutWalker_1.extractRolloutSessionId)(path.basename(sessionPath));
@@ -850,6 +912,17 @@ class CodexProvider {
     }
     // --- Data reading ---
     createReader(sessionPath) {
+        if ((0, compressedRollouts_1.isCompressedRolloutPath)(sessionPath)) {
+            // Compressed rollouts are complete: read whole, never tailed.
+            return new codexCompressedReader_1.CompressedCodexRolloutReader(sessionPath, {
+                onContextWindowLimit: (limit) => {
+                    // Historical content: keep the live limit, do not persist it again.
+                    if (this.dynamicContextWindowLimit === null)
+                        this.dynamicContextWindowLimit = limit;
+                },
+                onDiagnostic: this.onDiagnostic,
+            });
+        }
         return new CodexReader(sessionPath, (limit, modelId) => {
             this.dynamicContextWindowLimit = limit;
             if (modelId) {
@@ -866,119 +939,36 @@ class CodexProvider {
         });
     }
     // --- Subagent support ---
-    scanSubagents(_sessionDir, sessionId) {
-        // Codex tracks forked sessions via forked_from_id in session_meta.
-        // Use DB when available, fall back to filesystem scanning.
-        const subagents = [];
-        // DB approach: spawned subagents (parent recorded in `threads.source`),
-        // plus forked children on older schemas that carry `forked_from_id`.
-        const db = this.ensureDb();
-        if (db) {
-            const seen = new Set();
-            const children = [
-                ...db.getSpawnedChildThreads(sessionId),
-                ...db.getThreadsByForkedFromId(sessionId),
-            ].filter((thread) => !seen.has(thread.id) && seen.add(thread.id));
-            for (const thread of children) {
-                const built = (0, subagentStatsCache_1.cachedSubagentStats)(thread.rollout_path, () => this.buildSubagentStats(thread.id, thread.rollout_path, thread.title || thread.agent_nickname));
-                if (built) {
-                    subagents.push(thread.agent_role && !built.agentType
-                        ? { ...built, agentType: thread.agent_role }
-                        : built);
-                }
-            }
-            if (children.length > 0)
-                return subagents;
-        }
-        // Filesystem fallback: scan recent rollout files for a matching
-        // forked_from_id. The walk stops after the 50 newest-dated files instead
-        // of enumerating the whole history and slicing afterwards.
-        for (const file of findRolloutFilesInConfiguredHomes({ limit: 50 })) {
-            const meta = (0, codexRollouts_1.readSessionMeta)(file.path);
-            if (meta &&
-                (meta.forked_from_id === sessionId || (0, codexDatabase_1.spawnParentFromSource)(meta.source) === sessionId)) {
-                const childId = (0, rolloutWalker_1.extractRolloutSessionId)(path.basename(file.path));
-                // `source` is a plain string for top-level sessions but an object
-                // (`{ subagent: { thread_spawn: … } }`) for spawned children.
-                const description = typeof meta.source === 'string' ? meta.source : undefined;
-                const stats = (0, subagentStatsCache_1.cachedSubagentStats)(file.path, () => this.buildSubagentStats(childId, file.path, description));
-                if (stats)
-                    subagents.push(stats);
-            }
-        }
-        return subagents;
-    }
     /**
-     * Builds SubagentStats for a forked session by reading its rollout file.
+     * Every subagent below the session, any depth: spawned threads (the
+     * database's `threads.source`, else the newest rollouts' session_meta)
+     * and, on older schemas, forks (`forked_from_id`). Each carries its
+     * rollout (`filePath`), the parent's spawn call (`spawnToolUseId`),
+     * `agentNickname`, `agentPath`, `parentAgentId`, and `depth`; tool calls
+     * and tokens come from the child's own records, not the parent history a
+     * forked child embeds.
      */
-    buildSubagentStats(agentId, rolloutPath, description) {
-        if (!rolloutPath || !fs.existsSync(rolloutPath))
-            return null;
-        const stats = {
-            agentId,
-            description: description || undefined,
-            toolCalls: [],
-            inputTokens: 0,
-            outputTokens: 0,
-        };
-        try {
-            const parser = new codexParser_1.CodexRolloutParser();
-            const content = fs.readFileSync(rolloutPath, 'utf8');
-            const lines = content.split('\n');
-            for (const line of lines) {
-                const trimmed = line.trim();
-                if (!trimmed)
-                    continue;
-                try {
-                    const parsed = JSON.parse(trimmed);
-                    // Track timestamps
-                    if (parsed.timestamp) {
-                        const ts = new Date(parsed.timestamp);
-                        if (!stats.startTime || ts < stats.startTime)
-                            stats.startTime = ts;
-                        if (!stats.endTime || ts > stats.endTime)
-                            stats.endTime = ts;
-                    }
-                    const events = parser.convertLine(parsed);
-                    for (const event of events) {
-                        // Collect tool calls
-                        if (event.type === 'assistant' && Array.isArray(event.message.content)) {
-                            for (const block of event.message.content) {
-                                if (block.type === 'tool_use' && typeof block.name === 'string') {
-                                    stats.toolCalls.push({
-                                        name: block.name,
-                                        input: block.input || {},
-                                        timestamp: new Date(event.timestamp),
-                                    });
-                                }
-                            }
-                        }
-                        // Accumulate tokens from usage events (duplicate token_count events
-                        // are already dropped by the parser).
-                        const usage = (0, usageNormalization_1.extractNormalizedUsage)(event);
-                        if (usage)
-                            (0, subagentUsage_1.addUsageToSubagent)(stats, usage);
-                    }
-                }
-                catch {
-                    /* skip malformed lines */
-                }
-            }
-            if (stats.startTime && stats.endTime) {
-                stats.durationMs = stats.endTime.getTime() - stats.startTime.getTime();
-            }
-        }
-        catch {
-            /* skip unreadable files */
-        }
-        return stats;
+    scanSubagents(_sessionDir, sessionId) {
+        const db = this.ensureDb();
+        return (0, codexSubagents_1.discoverCodexSubagents)(sessionId, {
+            db,
+            includeCompressed: this.includeCompressed,
+            onDiagnostic: this.onDiagnostic,
+            sessionRolloutPath: () => this.resolveRollout(db?.getThread(sessionId)?.rollout_path) ??
+                (0, codexRollouts_1.findCodexRolloutFile)(sessionId, { includeCompressed: this.includeCompressed }),
+            // The walk stops after the 50 newest-dated files instead of
+            // enumerating the whole history and slicing afterwards.
+            fallbackFiles: () => findRolloutFilesInConfiguredHomes({ limit: 50, includeCompressed: this.includeCompressed }),
+        });
     }
     // --- Cross-session search ---
     searchInSession(sessionPath, query, maxResults) {
         const results = [];
         const queryLower = query.toLowerCase();
         try {
-            const content = fs.readFileSync(sessionPath, 'utf8');
+            const content = (0, compressedRollouts_1.readRolloutText)(sessionPath, { onDiagnostic: this.onDiagnostic });
+            if (content === null)
+                return results;
             const lines = content.split('\n');
             for (const line of lines) {
                 if (results.length >= maxResults)

package/dist/providers/codexCompressedReader.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Session reader for a compressed Codex rollout (`rollout-…jsonl.zst`).
+ *
+ * Codex compresses only rollouts it no longer writes, so the content is
+ * decompressed and parsed whole on the first read; later reads cost one
+ * stat and return nothing until the file changes (then the rollout is read
+ * again from the start, reported as `replaced`). Positions are offsets in
+ * the decompressed content. Live tailing stays with the `.jsonl` reader.
+ *
+ * Node-only: reads files.
+ *
+ * @module providers/codexCompressedReader
+ */
+import { type CodexRolloutResumeState } from '../parsers/codexParser';
+import type { CodexRateLimits, CodexSessionMeta } from '../types/codex';
+import type { SessionEvent, TokenUsage } from '../types/sessionEvent';
+import { type ReadRolloutOptions } from './compressedRollouts';
+import type { SessionReader } from './types';
+type ReaderReset = NonNullable<ReturnType<NonNullable<SessionReader['lastReset']>>>;
+export interface CompressedCodexReaderCallbacks {
+    onContextWindowLimit?: (limit: number, modelId?: string) => void;
+    onRateLimits?: (limits: CodexRateLimits) => void;
+    onTokenUsage?: (usage: TokenUsage) => void;
+    onDiagnostic?: ReadRolloutOptions['onDiagnostic'];
+}
+/** Reads a `.jsonl.zst` rollout through a {@link CodexRolloutParser}. */
+export declare class CompressedCodexRolloutReader implements SessionReader {
+    private readonly rolloutPath;
+    private readonly callbacks;
+    private parser;
+    /** Offset after the last line parsed (the content is complete, so its end). */
+    private position;
+    /** Size and mtime of the compressed file the position refers to. */
+    private source;
+    private reset_;
+    /** Position from `seekTo()` whose prefix still has to be parsed for context. */
+    private pendingSeek;
+    constructor(rolloutPath: string, callbacks?: CompressedCodexReaderCallbacks);
+    getSessionMeta(): CodexSessionMeta | null;
+    readNew(): SessionEvent[];
+    readAll(): SessionEvent[];
+    reset(): void;
+    exists(): boolean;
+    flush(): void;
+    getPosition(): number;
+    seekTo(position: number): void;
+    wasTruncated(): boolean;
+    lastReset(): ReaderReset | null;
+    getResumeState(): CodexRolloutResumeState;
+    restoreResumeState(state: unknown): boolean;
+    /** Parses the content past `position`; `emit` false only rebuilds parser state. */
+    private readFrom;
+    /** Rebuilds parser context for a pending `seekTo()` position. */
+    private settleSeek;
+    /** Hands the parser's context window, rate limits, and last usage to the provider. */
+    private propagateParserState;
+}
+export {};