sidekick-shared 0.28.3 → 0.29.0

package/dist/node.d.ts

@@ -10,7 +10,9 @@ export type { HydrateOptions, HydrateResult } from './pricingCatalog';
 export { loadObservedContextWindows, recordObservedContextWindow, getObservedContextWindowPath, } from './observedContextWindows';
 export type { ObservedContextWindowOptions, ObservedContextWindowStore, } from './observedContextWindows';
 export { listRecentSessions, readSessionTranscript } from './sessionTranscripts';
-export { collectPromptHistory, isPromptHistorySessionSettled, parsePromptHistoryCursor, } from './promptHistory';
+export { collectPromptHistory, isPromptHistorySessionSettled, parsePromptHistoryCursor, PROMPT_HISTORY_ORDINAL_MAX_RECORD_BYTES, } from './promptHistory';
+export { findToolCallOrigins } from './toolCallOrigins';
+export type { FindToolCallOriginsOptions, ToolCallOrigin } from './toolCallOrigins';
 export type { CollectPromptHistoryOptions, PromptHistoryAnswerState, PromptHistoryBound, PromptHistoryBounds, PromptHistoryCursor, PromptHistoryCursorSession, PromptHistoryEntry, PromptHistoryExclusion, PromptHistoryMetadataStatus, PromptHistoryPendingPrompt, PromptHistoryProvider, PromptHistoryResult, PromptHistoryResumeState, PromptHistoryStats, PromptHistoryUsage, } from './promptHistory';
 export { collectSessionPromptHistory } from './sessionPromptHistory';
 export type { CollectSessionPromptHistoryOptions, PromptHistorySession, PromptHistorySessionPrompt, PromptHistorySessionRef, SessionPromptHistoryBound, SessionPromptHistoryBounds, SessionPromptHistoryInclude, SessionPromptHistoryResult, SessionPromptHistoryStats, } from './sessionPromptHistory';
@@ -56,8 +58,17 @@ export { SYNTHETIC_MODEL } from './usage/claudeUsageDedupe';
 export { CONFIG_DIR_ENV_VAR, getConfigDir, getConfigDirOverride, getDefaultConfigDir, } from './paths';
 export { encodeWorkspacePath as encodeClaudeWorkspacePath, getSessionDirectory as getClaudeSessionDirectory, } from './parsers/sessionPathResolver';
 export { getLiveClaudeHome, getDefaultClaudeHome, isDefaultClaudeHome, getClaudeProjectsDir, } from './claudePaths';
-export { getSystemCodexHome, getCodexMonitoringHomes, resolveSidekickCodexHome, getCodexExecutionEnv, getCodexSessionsDirs, CODEX_SESSIONS_SUBDIR, CODEX_ARCHIVED_SESSIONS_SUBDIR, } from './codexPaths';
-export type { CodexSessionsDirsOptions } from './codexPaths';
+export { getSystemCodexHome, getCodexMonitoringHomes, resolveSidekickCodexHome, getCodexExecutionEnv, getCodexSessionsDirs, getCodexCredentialStoreMode, forceFileCredentialStore, CODEX_SESSIONS_SUBDIR, CODEX_ARCHIVED_SESSIONS_SUBDIR, } from './codexPaths';
+export type { CodexCredentialStoreMode, CodexSessionsDirsOptions } from './codexPaths';
+export { parseAuthJson as parseCodexAuthJson, readAuthIdentityFromRaw as readCodexAuthIdentity, readLastRefresh as readCodexLastRefresh, readAccessTokenExpiry as readCodexAccessTokenExpiry, identitiesMatch as codexIdentitiesMatch, codexRefreshFingerprint, compareCodexAuthFreshness, } from './codexAuth';
+export type { CodexAuthIdentity, CodexAuthJsonFile } from './codexAuth';
+export { atomicWriteJson, atomicWriteJsonSync } from './writers/atomic';
+export { parseClaudeAuthStatus, parseCodexLoginStatus } from './authStatus';
+export type { ParsedClaudeAuthStatus, ParsedCodexLoginStatus } from './authStatus';
+export { codexRolloutOrigin, codexSpawnParentFromSource } from './parsers/codexRolloutOrigin';
+export type { CodexRolloutOrigin } from './parsers/codexRolloutOrigin';
+export { getPricingCatalogInfo, registerModelPricing, clearRegisteredModelPricing, } from './modelInfo';
+export type { PricingCatalogInfo, PricingCatalogSource, RegisterModelPricingOptions, } from './modelInfo';
 export type { ProviderServiceSeverity, ProviderServiceComponent, ProviderServiceIncident, ProviderServiceStatusFailureReason, ObservedProviderServiceStatus, UnavailableProviderServiceStatus, ProviderServiceStatus, FetchProviderServiceStatusOptions, } from './providerServiceStatusTypes';
 export { fetchProviderServiceStatus } from './providerServiceStatus';
 export { classifyTool, TOOL_CATEGORIES } from './toolCategory';
@@ -65,5 +76,5 @@ export type { ClassifyToolOptions, ToolCategory } from './toolCategory';
 export { resolveWorkspaceRoots } from './workspaceRoots';
 export type { ResolveWorkspaceRootsOptions, ResolvedWorkspaceRoots } from './workspaceRoots';
 export { discoverWorktreeSiblings, resolveWorktreeMainRepo } from './parsers/sessionPathResolver';
-export { createJsonlTail, DEFAULT_JSONL_TAIL_MAX_LINE_BYTES, DEFAULT_JSONL_TAIL_READ_BYTES, } from './watchers/jsonlTail';
-export type { JsonlTail, JsonlTailBatch, JsonlTailLine, JsonlTailOptions, JsonlTailReset, JsonlTailResetReason, } from './watchers/jsonlTail';
+export { createJsonlTail, DEFAULT_JSONL_TAIL_MAX_LINE_BYTES, DEFAULT_JSONL_TAIL_READ_BYTES, JSONL_TAIL_CHECKPOINT_VERSION, JsonlTailSymlinkError, } from './watchers/jsonlTail';
+export type { JsonlTail, JsonlTailCheckpoint, JsonlTailReadResult, JsonlTailEntry, JsonlTailRewritePolicy, JsonlTailBatch, JsonlTailLine, JsonlTailOptions, JsonlTailReset, JsonlTailResetReason, } from './watchers/jsonlTail';

package/dist/node.js

@@ -7,8 +7,9 @@
  * for browser bundles — use `sidekick-shared/browser` there.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ACTIVE_SESSION_MTIME_THRESHOLD_MS = exports.sessionSummaryFromStats = exports.removeSessionSummary = exports.markFileImported = exports.isFileImported = exports.applySessionSummary = exports.subagentTokenTotals = exports.scanSessionSubagents = exports.readMainThreadTokenTotals = exports.combineSessionTokenTotals = exports.collectSessionTokenTotals = exports.pruneUsageCache = exports.getUsageCacheDir = exports.collectUsageEvents = exports.USAGE_CACHE_VERSION = exports.MAX_USAGE_CACHE_FILES = exports.findActiveBillingBlock = exports.computeBillingBlocks = exports.BILLING_BLOCK_DURATION_MS = exports.writeStateFile = exports.readStateFile = exports.quotaToStateFile = exports.getStateFilePath = exports.billingBlockToStateFile = exports.STATE_FILE_SCHEMA_VERSION = exports.STATE_FILE_NAME = exports.sessionFingerprintParts = exports.fingerprintString = exports.readSessionReportInputs = exports.readSessionFileStats = exports.providerContextSizeFn = exports.firstUserPrompt = exports.computeSessionFileStats = exports.isHumanPrompt = exports.humanPromptText = exports.HUMAN_CODEX_SOURCES = exports.HUMAN_CLAUDE_ENTRYPOINTS = exports.collectSessionPromptHistory = exports.parsePromptHistoryCursor = exports.isPromptHistorySessionSettled = exports.collectPromptHistory = exports.readSessionTranscript = exports.listRecentSessions = exports.getObservedContextWindowPath = exports.recordObservedContextWindow = exports.loadObservedContextWindows = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmContextWindows = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = void 0;
-exports.DEFAULT_JSONL_TAIL_READ_BYTES = exports.DEFAULT_JSONL_TAIL_MAX_LINE_BYTES = exports.createJsonlTail = exports.resolveWorktreeMainRepo = exports.discoverWorktreeSiblings = exports.resolveWorkspaceRoots = exports.TOOL_CATEGORIES = exports.classifyTool = exports.fetchProviderServiceStatus = exports.CODEX_ARCHIVED_SESSIONS_SUBDIR = exports.CODEX_SESSIONS_SUBDIR = exports.getCodexSessionsDirs = exports.getCodexExecutionEnv = exports.resolveSidekickCodexHome = exports.getCodexMonitoringHomes = exports.getSystemCodexHome = exports.getClaudeProjectsDir = exports.isDefaultClaudeHome = exports.getDefaultClaudeHome = exports.getLiveClaudeHome = exports.getClaudeSessionDirectory = exports.encodeClaudeWorkspacePath = exports.getDefaultConfigDir = exports.getConfigDirOverride = exports.getConfigDir = exports.CONFIG_DIR_ENV_VAR = exports.SYNTHETIC_MODEL = exports.createSessionProviders = exports.splitWatchedPath = exports.DirectoryListingCache = exports.fileFingerprintParts = exports.fileFingerprint = exports.observedSessionSourceFromProvider = exports.ObservedSessionCollector = exports.readSessionPreviewAsync = exports.readSessionPreview = exports.listSessionPreviewsAsync = exports.listSessionPreviews = exports.readCodexHistory = exports.walkRolloutFilesAsync = exports.walkRolloutFiles = exports.findCodexRolloutFile = exports.weekKey = exports.usageBucketKey = exports.summarizeUsageRows = exports.bucketUsage = exports.importSessionHistory = void 0;
+exports.removeSessionSummary = exports.markFileImported = exports.isFileImported = exports.applySessionSummary = exports.subagentTokenTotals = exports.scanSessionSubagents = exports.readMainThreadTokenTotals = exports.combineSessionTokenTotals = exports.collectSessionTokenTotals = exports.pruneUsageCache = exports.getUsageCacheDir = exports.collectUsageEvents = exports.USAGE_CACHE_VERSION = exports.MAX_USAGE_CACHE_FILES = exports.findActiveBillingBlock = exports.computeBillingBlocks = exports.BILLING_BLOCK_DURATION_MS = exports.writeStateFile = exports.readStateFile = exports.quotaToStateFile = exports.getStateFilePath = exports.billingBlockToStateFile = exports.STATE_FILE_SCHEMA_VERSION = exports.STATE_FILE_NAME = exports.sessionFingerprintParts = exports.fingerprintString = exports.readSessionReportInputs = exports.readSessionFileStats = exports.providerContextSizeFn = exports.firstUserPrompt = exports.computeSessionFileStats = exports.isHumanPrompt = exports.humanPromptText = exports.HUMAN_CODEX_SOURCES = exports.HUMAN_CLAUDE_ENTRYPOINTS = exports.collectSessionPromptHistory = exports.findToolCallOrigins = exports.PROMPT_HISTORY_ORDINAL_MAX_RECORD_BYTES = exports.parsePromptHistoryCursor = exports.isPromptHistorySessionSettled = exports.collectPromptHistory = exports.readSessionTranscript = exports.listRecentSessions = exports.getObservedContextWindowPath = exports.recordObservedContextWindow = exports.loadObservedContextWindows = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmContextWindows = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = void 0;
+exports.atomicWriteJson = exports.compareCodexAuthFreshness = exports.codexRefreshFingerprint = exports.codexIdentitiesMatch = exports.readCodexAccessTokenExpiry = exports.readCodexLastRefresh = exports.readCodexAuthIdentity = exports.parseCodexAuthJson = exports.CODEX_ARCHIVED_SESSIONS_SUBDIR = exports.CODEX_SESSIONS_SUBDIR = exports.forceFileCredentialStore = exports.getCodexCredentialStoreMode = exports.getCodexSessionsDirs = exports.getCodexExecutionEnv = exports.resolveSidekickCodexHome = exports.getCodexMonitoringHomes = exports.getSystemCodexHome = exports.getClaudeProjectsDir = exports.isDefaultClaudeHome = exports.getDefaultClaudeHome = exports.getLiveClaudeHome = exports.getClaudeSessionDirectory = exports.encodeClaudeWorkspacePath = exports.getDefaultConfigDir = exports.getConfigDirOverride = exports.getConfigDir = exports.CONFIG_DIR_ENV_VAR = exports.SYNTHETIC_MODEL = exports.createSessionProviders = exports.splitWatchedPath = exports.DirectoryListingCache = exports.fileFingerprintParts = exports.fileFingerprint = exports.observedSessionSourceFromProvider = exports.ObservedSessionCollector = exports.readSessionPreviewAsync = exports.readSessionPreview = exports.listSessionPreviewsAsync = exports.listSessionPreviews = exports.readCodexHistory = exports.walkRolloutFilesAsync = exports.walkRolloutFiles = exports.findCodexRolloutFile = exports.weekKey = exports.usageBucketKey = exports.summarizeUsageRows = exports.bucketUsage = exports.importSessionHistory = exports.ACTIVE_SESSION_MTIME_THRESHOLD_MS = exports.sessionSummaryFromStats = void 0;
+exports.JsonlTailSymlinkError = exports.JSONL_TAIL_CHECKPOINT_VERSION = exports.DEFAULT_JSONL_TAIL_READ_BYTES = exports.DEFAULT_JSONL_TAIL_MAX_LINE_BYTES = exports.createJsonlTail = exports.resolveWorktreeMainRepo = exports.discoverWorktreeSiblings = exports.resolveWorkspaceRoots = exports.TOOL_CATEGORIES = exports.classifyTool = exports.fetchProviderServiceStatus = exports.clearRegisteredModelPricing = exports.registerModelPricing = exports.getPricingCatalogInfo = exports.codexSpawnParentFromSource = exports.codexRolloutOrigin = exports.parseCodexLoginStatus = exports.parseClaudeAuthStatus = exports.atomicWriteJsonSync = void 0;
 var pricingCatalog_1 = require("./pricingCatalog");
 Object.defineProperty(exports, "hydratePricingCatalog", { enumerable: true, get: function () { return pricingCatalog_1.hydratePricingCatalog; } });
 Object.defineProperty(exports, "normalizeLiteLlmCatalog", { enumerable: true, get: function () { return pricingCatalog_1.normalizeLiteLlmCatalog; } });
@@ -25,6 +26,9 @@ var promptHistory_1 = require("./promptHistory");
 Object.defineProperty(exports, "collectPromptHistory", { enumerable: true, get: function () { return promptHistory_1.collectPromptHistory; } });
 Object.defineProperty(exports, "isPromptHistorySessionSettled", { enumerable: true, get: function () { return promptHistory_1.isPromptHistorySessionSettled; } });
 Object.defineProperty(exports, "parsePromptHistoryCursor", { enumerable: true, get: function () { return promptHistory_1.parsePromptHistoryCursor; } });
+Object.defineProperty(exports, "PROMPT_HISTORY_ORDINAL_MAX_RECORD_BYTES", { enumerable: true, get: function () { return promptHistory_1.PROMPT_HISTORY_ORDINAL_MAX_RECORD_BYTES; } });
+var toolCallOrigins_1 = require("./toolCallOrigins");
+Object.defineProperty(exports, "findToolCallOrigins", { enumerable: true, get: function () { return toolCallOrigins_1.findToolCallOrigins; } });
 var sessionPromptHistory_1 = require("./sessionPromptHistory");
 Object.defineProperty(exports, "collectSessionPromptHistory", { enumerable: true, get: function () { return sessionPromptHistory_1.collectSessionPromptHistory; } });
 var humanPrompt_1 = require("./humanPrompt");
@@ -126,8 +130,31 @@ Object.defineProperty(exports, "getCodexMonitoringHomes", { enumerable: true, ge
 Object.defineProperty(exports, "resolveSidekickCodexHome", { enumerable: true, get: function () { return codexPaths_1.resolveSidekickCodexHome; } });
 Object.defineProperty(exports, "getCodexExecutionEnv", { enumerable: true, get: function () { return codexPaths_1.getCodexExecutionEnv; } });
 Object.defineProperty(exports, "getCodexSessionsDirs", { enumerable: true, get: function () { return codexPaths_1.getCodexSessionsDirs; } });
+Object.defineProperty(exports, "getCodexCredentialStoreMode", { enumerable: true, get: function () { return codexPaths_1.getCodexCredentialStoreMode; } });
+Object.defineProperty(exports, "forceFileCredentialStore", { enumerable: true, get: function () { return codexPaths_1.forceFileCredentialStore; } });
 Object.defineProperty(exports, "CODEX_SESSIONS_SUBDIR", { enumerable: true, get: function () { return codexPaths_1.CODEX_SESSIONS_SUBDIR; } });
 Object.defineProperty(exports, "CODEX_ARCHIVED_SESSIONS_SUBDIR", { enumerable: true, get: function () { return codexPaths_1.CODEX_ARCHIVED_SESSIONS_SUBDIR; } });
+var codexAuth_1 = require("./codexAuth");
+Object.defineProperty(exports, "parseCodexAuthJson", { enumerable: true, get: function () { return codexAuth_1.parseAuthJson; } });
+Object.defineProperty(exports, "readCodexAuthIdentity", { enumerable: true, get: function () { return codexAuth_1.readAuthIdentityFromRaw; } });
+Object.defineProperty(exports, "readCodexLastRefresh", { enumerable: true, get: function () { return codexAuth_1.readLastRefresh; } });
+Object.defineProperty(exports, "readCodexAccessTokenExpiry", { enumerable: true, get: function () { return codexAuth_1.readAccessTokenExpiry; } });
+Object.defineProperty(exports, "codexIdentitiesMatch", { enumerable: true, get: function () { return codexAuth_1.identitiesMatch; } });
+Object.defineProperty(exports, "codexRefreshFingerprint", { enumerable: true, get: function () { return codexAuth_1.codexRefreshFingerprint; } });
+Object.defineProperty(exports, "compareCodexAuthFreshness", { enumerable: true, get: function () { return codexAuth_1.compareCodexAuthFreshness; } });
+var atomic_1 = require("./writers/atomic");
+Object.defineProperty(exports, "atomicWriteJson", { enumerable: true, get: function () { return atomic_1.atomicWriteJson; } });
+Object.defineProperty(exports, "atomicWriteJsonSync", { enumerable: true, get: function () { return atomic_1.atomicWriteJsonSync; } });
+var authStatus_1 = require("./authStatus");
+Object.defineProperty(exports, "parseClaudeAuthStatus", { enumerable: true, get: function () { return authStatus_1.parseClaudeAuthStatus; } });
+Object.defineProperty(exports, "parseCodexLoginStatus", { enumerable: true, get: function () { return authStatus_1.parseCodexLoginStatus; } });
+var codexRolloutOrigin_1 = require("./parsers/codexRolloutOrigin");
+Object.defineProperty(exports, "codexRolloutOrigin", { enumerable: true, get: function () { return codexRolloutOrigin_1.codexRolloutOrigin; } });
+Object.defineProperty(exports, "codexSpawnParentFromSource", { enumerable: true, get: function () { return codexRolloutOrigin_1.codexSpawnParentFromSource; } });
+var modelInfo_1 = require("./modelInfo");
+Object.defineProperty(exports, "getPricingCatalogInfo", { enumerable: true, get: function () { return modelInfo_1.getPricingCatalogInfo; } });
+Object.defineProperty(exports, "registerModelPricing", { enumerable: true, get: function () { return modelInfo_1.registerModelPricing; } });
+Object.defineProperty(exports, "clearRegisteredModelPricing", { enumerable: true, get: function () { return modelInfo_1.clearRegisteredModelPricing; } });
 var providerServiceStatus_1 = require("./providerServiceStatus");
 Object.defineProperty(exports, "fetchProviderServiceStatus", { enumerable: true, get: function () { return providerServiceStatus_1.fetchProviderServiceStatus; } });
 // Tool categories across providers
@@ -145,3 +172,5 @@ var jsonlTail_1 = require("./watchers/jsonlTail");
 Object.defineProperty(exports, "createJsonlTail", { enumerable: true, get: function () { return jsonlTail_1.createJsonlTail; } });
 Object.defineProperty(exports, "DEFAULT_JSONL_TAIL_MAX_LINE_BYTES", { enumerable: true, get: function () { return jsonlTail_1.DEFAULT_JSONL_TAIL_MAX_LINE_BYTES; } });
 Object.defineProperty(exports, "DEFAULT_JSONL_TAIL_READ_BYTES", { enumerable: true, get: function () { return jsonlTail_1.DEFAULT_JSONL_TAIL_READ_BYTES; } });
+Object.defineProperty(exports, "JSONL_TAIL_CHECKPOINT_VERSION", { enumerable: true, get: function () { return jsonlTail_1.JSONL_TAIL_CHECKPOINT_VERSION; } });
+Object.defineProperty(exports, "JsonlTailSymlinkError", { enumerable: true, get: function () { return jsonlTail_1.JsonlTailSymlinkError; } });

package/dist/parsers/codexParser.d.ts

@@ -53,6 +53,37 @@ export interface CodexRolloutParserOptions {
      * oldest. Bounds memory on long-running rollouts; default 4096.
      */
     maxTrackedToolCalls?: number;
+    /**
+     * Approximate bytes the parser may hold for pending tool calls: exec and
+     * MCP calls still waiting for their end event (with their buffered command
+     * or arguments) and `apply_patch` calls waiting for their output. Past the
+     * budget the oldest pending call is forgotten first, as
+     * `maxTrackedToolCalls` does by count, so its end event still emits a tool
+     * use but without the forgotten details; a single call larger than the
+     * budget is not kept at all. `getPendingStats()` counts the evictions.
+     * Default: unlimited.
+     */
+    maxPendingBytes?: number;
+    /**
+     * Metadata-only scan: tool-call inputs are emitted as `{}` plus the
+     * `_sidekick*` raw-name keys, tool results carry empty content (their
+     * `is_error` and `duration` are kept), reasoning is emitted with empty
+     * thinking text, and pending calls buffer no command or arguments. Tool
+     * names, ids, timestamps, models, usage, rate limits, and message text are
+     * unchanged. For cheap passes over large rollouts; default false.
+     */
+    metadataOnly?: boolean;
+}
+/** Pending tool-call state counters from {@link CodexRolloutParser.getPendingStats}. */
+export interface CodexPendingStats {
+    /** Tool calls waiting for their end or output event. */
+    pendingCalls: number;
+    /** Approximate bytes they hold; `null` unless `maxPendingBytes` is set. */
+    pendingBytes: number | null;
+    /** Pending calls forgotten because a table exceeded `maxTrackedToolCalls`. */
+    evictedByCount: number;
+    /** Pending calls forgotten because `maxPendingBytes` was exceeded. */
+    evictedByBytes: number;
 }
 /**
  * Stateful parser for Codex JSONL rollout lines.
@@ -78,7 +109,17 @@ export declare class CodexRolloutParser {
     private emittedToolUseIds;
     private patchExpandedToolUseIds;
     private readonly maxTrackedToolCalls;
+    /** Byte budget for pending calls; `null` = unlimited (no accounting). */
+    private readonly maxPendingBytes;
+    private readonly metadataOnly;
+    /** Pending calls in insertion order, for the byte budget. */
+    private pendingLedger;
+    private pendingBytes;
+    private evictedByCount;
+    private evictedByBytes;
     constructor(options?: CodexRolloutParserOptions);
+    /** Counters for the pending tool-call state and what the caps evicted. */
+    getPendingStats(): CodexPendingStats;
     /** Get stored session metadata. */
     getSessionMeta(): CodexSessionMeta | null;
     /** Get current model from turn_context. */
@@ -95,6 +136,20 @@ export declare class CodexRolloutParser {
     convertLine(line: CodexRolloutLine): SessionEvent[];
     /** Reset all parser state. */
     reset(): void;
+    /**
+     * Stores a pending call, refreshing its position, then enforces the count
+     * cap on its table and the byte budget across all pending tables, oldest
+     * first.
+     */
+    private putPending;
+    /** Removes and returns a pending call. */
+    private takePending;
+    private forgetPendingBytes;
+    private ledgerKey;
+    /** The emitted tool input: unchanged, or only its `_sidekick*` keys in metadata-only mode. */
+    private toolInput;
+    /** The emitted tool-result content: unchanged, or empty in metadata-only mode. */
+    private toolOutput;
     private handleSessionMeta;
     private handleResponseItem;
     private handleMessage;

package/dist/parsers/codexParser.js

@@ -178,6 +178,10 @@ function extractPatchFilePaths(input) {
 }
 /** Default cap on each piece of per-call correlation state the parser keeps. */
 exports.DEFAULT_MAX_TRACKED_TOOL_CALLS = 4096;
+/** Fixed per-entry cost added to each pending call's byte estimate. */
+const PENDING_ENTRY_OVERHEAD_BYTES = 64;
+/** Prefix of the bookkeeping keys the parser stashes inside tool inputs. */
+const SIDEKICK_INPUT_KEY_PREFIX = '_sidekick';
 /** Adds `key`, refreshing its position, and evicts the oldest past `max`. */
 function rememberBounded(set, key, max) {
     set.delete(key);
@@ -185,12 +189,31 @@ function rememberBounded(set, key, max) {
     while (set.size > max)
         set.delete(set.values().next().value);
 }
-/** Sets `key`, refreshing its position, and evicts the oldest past `max`. */
-function setBounded(map, key, value, max) {
-    map.delete(key);
-    map.set(key, value);
-    while (map.size > max)
-        map.delete(map.keys().next().value);
+function stringBytes(...values) {
+    let total = 0;
+    for (const value of values)
+        if (typeof value === 'string')
+            total += value.length;
+    return total;
+}
+function approxJsonBytes(value) {
+    if (value === undefined)
+        return 0;
+    try {
+        return JSON.stringify(value)?.length ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Only the `_sidekick*` bookkeeping keys of a tool input. */
+function sidekickKeysOnly(input) {
+    const kept = {};
+    for (const key of Object.keys(input)) {
+        if (key.startsWith(SIDEKICK_INPUT_KEY_PREFIX))
+            kept[key] = input[key];
+    }
+    return kept;
 }
 /**
  * Stateful parser for Codex JSONL rollout lines.
@@ -216,10 +239,35 @@ class CodexRolloutParser {
     emittedToolUseIds = new Set();
     patchExpandedToolUseIds = new Map();
     maxTrackedToolCalls;
+    /** Byte budget for pending calls; `null` = unlimited (no accounting). */
+    maxPendingBytes;
+    metadataOnly;
+    /** Pending calls in insertion order, for the byte budget. */
+    pendingLedger = new Map();
+    pendingBytes = 0;
+    evictedByCount = 0;
+    evictedByBytes = 0;
     constructor(options = {}) {
         const max = options.maxTrackedToolCalls;
         this.maxTrackedToolCalls =
             typeof max === 'number' && max >= 1 ? Math.floor(max) : exports.DEFAULT_MAX_TRACKED_TOOL_CALLS;
+        const maxBytes = options.maxPendingBytes;
+        this.maxPendingBytes =
+            typeof maxBytes === 'number' && Number.isFinite(maxBytes) && maxBytes >= 1
+                ? Math.floor(maxBytes)
+                : null;
+        this.metadataOnly = options.metadataOnly === true;
+    }
+    /** Counters for the pending tool-call state and what the caps evicted. */
+    getPendingStats() {
+        return {
+            pendingCalls: this.pendingExecCommands.size +
+                this.pendingMcpToolCalls.size +
+                this.patchExpandedToolUseIds.size,
+            pendingBytes: this.maxPendingBytes === null ? null : this.pendingBytes,
+            evictedByCount: this.evictedByCount,
+            evictedByBytes: this.evictedByBytes,
+        };
     }
     /** Get stored session metadata. */
     getSessionMeta() {
@@ -274,6 +322,72 @@ class CodexRolloutParser {
         this.inPlanMode = false;
         this.emittedToolUseIds.clear();
         this.patchExpandedToolUseIds.clear();
+        this.pendingLedger.clear();
+        this.pendingBytes = 0;
+        this.evictedByCount = 0;
+        this.evictedByBytes = 0;
+    }
+    // --- Pending call state ---
+    /**
+     * Stores a pending call, refreshing its position, then enforces the count
+     * cap on its table and the byte budget across all pending tables, oldest
+     * first.
+     */
+    putPending(table, callId, value, estimateBytes) {
+        this.forgetPendingBytes(table, callId);
+        table.delete(callId);
+        table.set(callId, value);
+        while (table.size > this.maxTrackedToolCalls) {
+            const oldest = table.keys().next().value;
+            table.delete(oldest);
+            this.forgetPendingBytes(table, oldest);
+            this.evictedByCount += 1;
+        }
+        if (this.maxPendingBytes === null)
+            return;
+        const bytes = PENDING_ENTRY_OVERHEAD_BYTES + estimateBytes();
+        this.pendingLedger.set(this.ledgerKey(table, callId), {
+            table: table,
+            callId,
+            bytes,
+        });
+        this.pendingBytes += bytes;
+        while (this.pendingBytes > this.maxPendingBytes && this.pendingLedger.size > 0) {
+            const [key, oldest] = this.pendingLedger.entries().next().value;
+            this.pendingLedger.delete(key);
+            this.pendingBytes -= oldest.bytes;
+            oldest.table.delete(oldest.callId);
+            this.evictedByBytes += 1;
+        }
+    }
+    /** Removes and returns a pending call. */
+    takePending(table, callId) {
+        const value = table.get(callId);
+        table.delete(callId);
+        this.forgetPendingBytes(table, callId);
+        return value;
+    }
+    forgetPendingBytes(table, callId) {
+        if (this.maxPendingBytes === null)
+            return;
+        const key = this.ledgerKey(table, callId);
+        const entry = this.pendingLedger.get(key);
+        if (!entry)
+            return;
+        this.pendingLedger.delete(key);
+        this.pendingBytes -= entry.bytes;
+    }
+    ledgerKey(table, callId) {
+        const kind = table === this.pendingExecCommands ? 'e' : table === this.pendingMcpToolCalls ? 'm' : 'p';
+        return `${kind}\u0000${callId}`;
+    }
+    /** The emitted tool input: unchanged, or only its `_sidekick*` keys in metadata-only mode. */
+    toolInput(input) {
+        return this.metadataOnly ? sidekickKeysOnly(input) : input;
+    }
+    /** The emitted tool-result content: unchanged, or empty in metadata-only mode. */
+    toolOutput(content) {
+        return this.metadataOnly ? '' : content;
     }
     // --- Handlers ---
     handleSessionMeta(timestamp, payload) {
@@ -380,7 +494,9 @@ class CodexRolloutParser {
                     role: 'assistant',
                     id: item.id,
                     model: this.currentModel || undefined,
-                    content: [{ type: 'thinking', thinking: summaryTexts.join('\n') }],
+                    content: [
+                        { type: 'thinking', thinking: this.metadataOnly ? '' : summaryTexts.join('\n') },
+                    ],
                 },
                 timestamp,
             },
@@ -388,11 +504,13 @@ class CodexRolloutParser {
     }
     handleFunctionCall(timestamp, item) {
         let parsedArgs = {};
-        try {
-            parsedArgs = JSON.parse(item.arguments);
-        }
-        catch {
-            parsedArgs = { raw: item.arguments };
+        if (!this.metadataOnly) {
+            try {
+                parsedArgs = JSON.parse(item.arguments);
+            }
+            catch {
+                parsedArgs = { raw: item.arguments };
+            }
         }
         const canonicalName = normalizeCodexToolName(item.name);
         const normalizedInput = normalizeCodexToolInput(canonicalName, item.name, parsedArgs);
@@ -409,7 +527,7 @@ class CodexRolloutParser {
                             type: 'tool_use',
                             id: item.call_id,
                             name: canonicalName,
-                            input: normalizedInput,
+                            input: this.toolInput(normalizedInput),
                         },
                     ],
                 },
@@ -429,7 +547,7 @@ class CodexRolloutParser {
                         {
                             type: 'tool_result',
                             tool_use_id: item.call_id,
-                            content: item.output,
+                            content: this.toolOutput(item.output),
                             is_error: isError,
                         },
                     ],
@@ -453,11 +571,11 @@ class CodexRolloutParser {
                             type: 'tool_use',
                             id: item.call_id,
                             name: 'Bash',
-                            input: {
+                            input: this.toolInput({
                                 command,
                                 workdir: item.action?.workdir,
                                 _sidekickRawToolName: 'local_shell_call',
-                            },
+                            }),
                         },
                     ],
                 },
@@ -471,7 +589,7 @@ class CodexRolloutParser {
             if (filePaths.length === 0)
                 return [];
             const toolUseIds = filePaths.map((fp) => `${item.call_id}-${fp}`);
-            setBounded(this.patchExpandedToolUseIds, item.call_id, toolUseIds, this.maxTrackedToolCalls);
+            this.putPending(this.patchExpandedToolUseIds, item.call_id, toolUseIds, () => stringBytes(item.call_id, ...toolUseIds));
             for (const id of toolUseIds) {
                 rememberBounded(this.emittedToolUseIds, id, this.maxTrackedToolCalls);
             }
@@ -486,10 +604,10 @@ class CodexRolloutParser {
                             type: 'tool_use',
                             id: `${item.call_id}-${fp}`,
                             name: 'Edit',
-                            input: {
+                            input: this.toolInput({
                                 file_path: fp,
                                 _sidekickRawToolName: 'apply_patch',
-                            },
+                            }),
                         },
                     ],
                 },
@@ -497,12 +615,14 @@ class CodexRolloutParser {
             }));
         }
         // Generic custom tool
-        let parsedInput;
-        try {
-            parsedInput = JSON.parse(item.input);
-        }
-        catch {
-            parsedInput = { raw: item.input };
+        let parsedInput = {};
+        if (!this.metadataOnly) {
+            try {
+                parsedInput = JSON.parse(item.input);
+            }
+            catch {
+                parsedInput = { raw: item.input };
+            }
         }
         const canonicalName = normalizeCodexToolName(item.name);
         const normalizedInput = normalizeCodexToolInput(canonicalName, item.name, parsedInput);
@@ -519,7 +639,7 @@ class CodexRolloutParser {
                             type: 'tool_use',
                             id: item.call_id,
                             name: canonicalName,
-                            input: normalizedInput,
+                            input: this.toolInput(normalizedInput),
                         },
                     ],
                 },
@@ -540,8 +660,9 @@ class CodexRolloutParser {
         catch {
             isError = parsePlainTextFailure(item.output);
         }
-        const toolUseIds = this.patchExpandedToolUseIds.get(item.call_id) ?? [item.call_id];
-        this.patchExpandedToolUseIds.delete(item.call_id);
+        const toolUseIds = this.takePending(this.patchExpandedToolUseIds, item.call_id) ?? [
+            item.call_id,
+        ];
         return toolUseIds.map((toolUseId) => ({
             type: 'user',
             message: {
@@ -551,7 +672,7 @@ class CodexRolloutParser {
                     {
                         type: 'tool_result',
                         tool_use_id: toolUseId,
-                        content: item.output,
+                        content: this.toolOutput(item.output),
                         is_error: isError,
                         duration,
                     },
@@ -615,18 +736,15 @@ class CodexRolloutParser {
             // response_item/message events which carry richer metadata (id, content parts, role).
             case 'exec_command_begin': {
                 const e = event;
-                setBounded(this.pendingExecCommands, e.call_id, {
-                    call_id: e.call_id,
-                    command: e.command,
-                    workdir: e.workdir,
-                    timestamp,
-                }, this.maxTrackedToolCalls);
+                const pending = this.metadataOnly
+                    ? { call_id: e.call_id, command: [], timestamp }
+                    : { call_id: e.call_id, command: e.command, workdir: e.workdir, timestamp };
+                this.putPending(this.pendingExecCommands, e.call_id, pending, () => stringBytes(pending.call_id, pending.workdir, pending.timestamp, ...(Array.isArray(pending.command) ? pending.command : [])));
                 return [];
             }
             case 'exec_command_end': {
                 const e = event;
-                const pending = this.pendingExecCommands.get(e.call_id);
-                this.pendingExecCommands.delete(e.call_id);
+                const pending = this.takePending(this.pendingExecCommands, e.call_id);
                 const command = pending?.command?.join(' ') || '';
                 const events = [];
                 if (!this.emittedToolUseIds.has(e.call_id)) {
@@ -642,18 +760,20 @@ class CodexRolloutParser {
                                     type: 'tool_use',
                                     id: e.call_id,
                                     name: 'Bash',
-                                    input: {
+                                    input: this.toolInput({
                                         command,
                                         workdir: pending?.workdir,
                                         _sidekickRawToolName: 'exec_command',
-                                    },
+                                    }),
                                 },
                             ],
                         },
                         timestamp: pending?.timestamp || timestamp,
                     });
                 }
-                const output = [e.stdout, e.stderr].filter(Boolean).join('\n') || '';
+                const output = this.metadataOnly
+                    ? ''
+                    : [e.stdout, e.stderr].filter(Boolean).join('\n') || '';
                 events.push({
                     type: 'user',
                     message: {
@@ -675,19 +795,20 @@ class CodexRolloutParser {
             }
             case 'mcp_tool_call_begin': {
                 const e = event;
-                setBounded(this.pendingMcpToolCalls, e.call_id, {
+                const pending = {
                     call_id: e.call_id,
                     server_name: e.server_name,
                     tool_name: e.tool_name,
-                    arguments: e.arguments,
+                    arguments: this.metadataOnly ? undefined : e.arguments,
                     timestamp,
-                }, this.maxTrackedToolCalls);
+                };
+                this.putPending(this.pendingMcpToolCalls, e.call_id, pending, () => stringBytes(pending.call_id, pending.server_name, pending.tool_name, timestamp) +
+                    approxJsonBytes(pending.arguments));
                 return [];
             }
             case 'mcp_tool_call_end': {
                 const e = event;
-                const pendingMcp = this.pendingMcpToolCalls.get(e.call_id);
-                this.pendingMcpToolCalls.delete(e.call_id);
+                const pendingMcp = this.takePending(this.pendingMcpToolCalls, e.call_id);
                 const toolName = pendingMcp?.tool_name || 'McpTool';
                 const events = [];
                 if (!this.emittedToolUseIds.has(e.call_id)) {
@@ -703,11 +824,11 @@ class CodexRolloutParser {
                                     type: 'tool_use',
                                     id: e.call_id,
                                     name: normalizeCodexToolName(toolName),
-                                    input: {
+                                    input: this.toolInput({
                                         ...(pendingMcp?.arguments || {}),
                                         _sidekickRawToolName: toolName,
                                         _sidekickMcpServerName: pendingMcp?.server_name,
-                                    },
+                                    }),
                                 },
                             ],
                         },
@@ -723,7 +844,7 @@ class CodexRolloutParser {
                             {
                                 type: 'tool_result',
                                 tool_use_id: e.call_id,
-                                content: e.result || '',
+                                content: this.toolOutput(e.result || ''),
                                 is_error: e.is_error || false,
                                 duration: e.duration_ms,
                             },
@@ -782,12 +903,12 @@ class CodexRolloutParser {
                                     type: 'tool_use',
                                     id: patchId,
                                     name: 'Edit',
-                                    input: {
+                                    input: this.toolInput({
                                         file_path: e.file_path,
                                         additions: e.additions ?? 0,
                                         deletions: e.deletions ?? 0,
                                         _sidekickRawToolName: 'patch_applied',
-                                    },
+                                    }),
                                 },
                             ],
                         },
@@ -814,10 +935,10 @@ class CodexRolloutParser {
                                     type: 'tool_use',
                                     id: `plan-enter-${timestamp}`,
                                     name: 'EnterPlanMode',
-                                    input: {
+                                    input: this.toolInput({
                                         source: 'codex_task_started',
                                         _sidekickRawToolName: 'task_started',
-                                    },
+                                    }),
                                 },
                             ],
                         },
@@ -841,10 +962,10 @@ class CodexRolloutParser {
                                     type: 'tool_use',
                                     id: `plan-exit-${timestamp}`,
                                     name: 'ExitPlanMode',
-                                    input: {
+                                    input: this.toolInput({
                                         source: 'codex_task_complete',
                                         _sidekickRawToolName: 'task_complete',
-                                    },
+                                    }),
                                 },
                             ],
                         },