sidekick-shared 0.28.3 → 0.29.1

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 { captureJsonlCheckpoint, createJsonlTail, DEFAULT_JSONL_TAIL_MAX_LINE_BYTES, DEFAULT_JSONL_TAIL_READ_BYTES, JSONL_TAIL_CHECKPOINT_VERSION, JsonlTailSymlinkError, verifyJsonlCheckpoint, } 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.verifyJsonlCheckpoint = exports.JsonlTailSymlinkError = exports.JSONL_TAIL_CHECKPOINT_VERSION = exports.DEFAULT_JSONL_TAIL_READ_BYTES = exports.DEFAULT_JSONL_TAIL_MAX_LINE_BYTES = exports.createJsonlTail = exports.captureJsonlCheckpoint = 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
@@ -142,6 +169,10 @@ Object.defineProperty(exports, "discoverWorktreeSiblings", { enumerable: true, g
 Object.defineProperty(exports, "resolveWorktreeMainRepo", { enumerable: true, get: function () { return sessionPathResolver_2.resolveWorktreeMainRepo; } });
 // Bounded JSONL tail reader
 var jsonlTail_1 = require("./watchers/jsonlTail");
+Object.defineProperty(exports, "captureJsonlCheckpoint", { enumerable: true, get: function () { return jsonlTail_1.captureJsonlCheckpoint; } });
 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; } });
+Object.defineProperty(exports, "verifyJsonlCheckpoint", { enumerable: true, get: function () { return jsonlTail_1.verifyJsonlCheckpoint; } });

package/dist/observedContextWindows.js

@@ -72,6 +72,7 @@ exports.recordObservedContextWindow = recordObservedContextWindow;
 const node_fs_1 = require("node:fs");
 const path = __importStar(require("node:path"));
 const modelContext_1 = require("./modelContext");
+const ownKey_1 = require("./ownKey");
 const paths_1 = require("./paths");
 const atomic_1 = require("./writers/atomic");
 // ── Constants ──
@@ -120,7 +121,7 @@ function toOverrideMap(store, now = Date.now()) {
         const observedAt = typeof entry.observedAt === 'string' ? Date.parse(entry.observedAt) : NaN;
         if (Number.isFinite(observedAt) && now - observedAt > exports.OBSERVED_CONTEXT_WINDOW_TTL_MS)
             continue;
-        out[modelId] = window;
+        (0, ownKey_1.setOwnValue)(out, modelId, window);
     }
     return out;
 }

package/dist/ownKey.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Own-property lookups for plain-object tables indexed by external strings.
+ *
+ * `table[key]` also finds inherited members, so a model id, tool name, or
+ * error code such as `constructor`, `toString`, or `__proto__` would return an
+ * `Object.prototype` member instead of `undefined`.
+ *
+ * @module ownKey
+ */
+/** The value stored under `key` in `table` itself, or `undefined`. */
+export declare function ownValue<T>(table: Readonly<Record<string, T>>, key: string): T | undefined;
+/**
+ * Store `value` as an own, enumerable property, even for `__proto__`, which a
+ * plain assignment would treat as a prototype change.
+ */
+export declare function setOwnValue<T>(table: Record<string, T>, key: string, value: T): void;

package/dist/ownKey.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Own-property lookups for plain-object tables indexed by external strings.
+ *
+ * `table[key]` also finds inherited members, so a model id, tool name, or
+ * error code such as `constructor`, `toString`, or `__proto__` would return an
+ * `Object.prototype` member instead of `undefined`.
+ *
+ * @module ownKey
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ownValue = ownValue;
+exports.setOwnValue = setOwnValue;
+const hasOwn = Object.prototype.hasOwnProperty;
+/** The value stored under `key` in `table` itself, or `undefined`. */
+function ownValue(table, key) {
+    return hasOwn.call(table, key) ? table[key] : undefined;
+}
+/**
+ * Store `value` as an own, enumerable property, even for `__proto__`, which a
+ * plain assignment would treat as a prototype change.
+ */
+function setOwnValue(table, key, value) {
+    Object.defineProperty(table, key, {
+        value,
+        enumerable: true,
+        writable: true,
+        configurable: true,
+    });
+}

package/dist/parsers/codexParser.d.ts

@@ -13,6 +13,21 @@
  */
 import type { SessionEvent } from '../types/sessionEvent';
 import type { CodexRolloutLine, CodexSessionMeta, CodexTokenUsage, CodexRateLimits } from '../types/codex';
+/** Pending exec command awaiting its end event. */
+interface PendingExecCommand {
+    call_id: string;
+    command: string[];
+    workdir?: string;
+    timestamp: string;
+}
+/** Pending MCP tool call awaiting its end event. */
+interface PendingMcpToolCall {
+    call_id: string;
+    server_name?: string;
+    tool_name: string;
+    arguments?: Record<string, unknown>;
+    timestamp: string;
+}
 /**
  * Resolve the usage of the single call a Codex `token_count` event reports.
  *
@@ -53,7 +68,67 @@ 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;
+}
+/**
+ * JSON-serializable continuation state of a {@link CodexRolloutParser}, from
+ * `exportResumeState()`, for `importResumeState()` in a parser that resumes
+ * at the same rollout position (for example from a persisted session
+ * snapshot). Every table lists its entries oldest first.
+ */
+export interface CodexRolloutResumeState {
+    version: 1;
+    sessionMeta: CodexSessionMeta | null;
+    /** Model from the latest `turn_context`, attributed to later events. */
+    currentModel: string | null;
+    /** Cumulative total of the previous token_count event, to skip its duplicates. */
+    prevTotalUsage: CodexTokenUsage | null;
+    lastTokenUsage: CodexTokenUsage | null;
+    modelContextWindow: number | null;
+    lastRateLimits: CodexRateLimits | null;
+    hasAggregateRateLimits: boolean;
+    inPlanMode: boolean;
+    /** Call ids whose tool use was already emitted, so their end event does not emit another. */
+    emittedToolUseIds: string[];
+    /** `apply_patch` calls awaiting output: call id and its per-file tool-use ids. */
+    patchExpandedToolUseIds: Array<[string, string[]]>;
+    /** `exec_command_begin` events awaiting their end. */
+    pendingExecCommands: PendingExecCommand[];
+    /** `mcp_tool_call_begin` events awaiting their end. */
+    pendingMcpToolCalls: PendingMcpToolCall[];
 }
+/** A valid `CodexTokenUsage` (copied), `null` for `null`, or `undefined` when invalid. Internal. */
+export declare function codexTokenUsageFrom(value: unknown): CodexTokenUsage | null | undefined;
 /**
  * Stateful parser for Codex JSONL rollout lines.
  *
@@ -78,7 +153,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. */
@@ -89,12 +174,44 @@ export declare class CodexRolloutParser {
     getModelContextWindow(): number | null;
     /** Get the last observed rate limits from token_count events. */
     getLastRateLimits(): CodexRateLimits | null;
+    /**
+     * The state later lines depend on — session metadata, current model,
+     * previous cumulative token total, context window, rate limits, plan mode,
+     * and the tool-call correlation tables (newest `limit` entries each) — as
+     * JSON-serializable data. Eviction counters are not included.
+     */
+    exportResumeState(limit?: number): CodexRolloutResumeState;
+    /**
+     * Replaces this parser's state with one from {@link exportResumeState}, as
+     * if it had parsed the rollout up to where that state was taken. Returns
+     * false, changing nothing, when `state` is not a valid version-1 state.
+     * This parser's own `maxTrackedToolCalls`, `maxPendingBytes`, and
+     * `metadataOnly` options apply to the imported tables.
+     */
+    importResumeState(state: unknown): boolean;
     /**
      * Converts a single rollout line to zero or more session events.
      */
     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;
+    private putPendingExec;
+    private putPendingMcp;
+    private putPendingPatch;
+    /** 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;
@@ -109,3 +226,4 @@ export declare class CodexRolloutParser {
     private handleEventMsg;
     private handleTokenCount;
 }
+export {};