sidekick-shared 0.23.0 → 0.24.0

package/dist/codexQuotaWatcher.d.ts

@@ -15,6 +15,9 @@ export interface CodexQuotaWatcherOptions {
     discoveryPollIntervalMs?: number;
     maxTailBytes?: number;
     maxSessionFiles?: number;
+    /** Minimum interval between expensive rollout-tail fallback scans. */
+    localScanCacheMs?: number;
+    now?: () => number;
     providerFactory?: () => CodexProvider;
     getActiveAccount?: CodexAccountReader;
     readSnapshot?: SnapshotReader;
@@ -39,6 +42,8 @@ export declare class CodexQuotaWatcher implements Disposable {
     private readonly watchFile;
     private readonly maxTailBytes;
     private readonly maxSessionFiles;
+    private readonly localScanCacheMs;
+    private readonly now;
     private readonly workspaceId;
     private readonly appendHistorySample;
     private readonly listeners;
@@ -48,6 +53,8 @@ export declare class CodexQuotaWatcher implements Disposable {
     private fileWatcher;
     private sessionPath;
     private lastEmissionKey;
+    private lastLocalScanAt;
+    private lastLocalScanState;
     private running;
     constructor(workspacePath: string, options?: CodexQuotaWatcherOptions);
     start(): void;

package/dist/codexQuotaWatcher.js

@@ -41,6 +41,7 @@ const quotaSnapshots_1 = require("./quotaSnapshots");
 const quotaHistory_1 = require("./quotaHistory");
 const codex_1 = require("./providers/codex");
 const DEFAULT_DISCOVERY_POLL_INTERVAL_MS = 30_000;
+const DEFAULT_LOCAL_SCAN_CACHE_MS = 5 * 60_000;
 function accountEmail(account) {
     return account?.email ?? account?.metadata?.email;
 }
@@ -81,6 +82,8 @@ class CodexQuotaWatcher {
     watchFile;
     maxTailBytes;
     maxSessionFiles;
+    localScanCacheMs;
+    now;
     workspaceId;
     appendHistorySample;
     listeners = [];
@@ -90,6 +93,8 @@ class CodexQuotaWatcher {
     fileWatcher = null;
     sessionPath = null;
     lastEmissionKey = null;
+    lastLocalScanAt = Number.NEGATIVE_INFINITY;
+    lastLocalScanState = null;
     running = false;
     constructor(workspacePath, options = {}) {
         this.workspacePath = workspacePath;
@@ -110,6 +115,8 @@ class CodexQuotaWatcher {
         this.watchFile = options.watchFile ?? fs.watch;
         this.maxTailBytes = options.maxTailBytes;
         this.maxSessionFiles = options.maxSessionFiles;
+        this.localScanCacheMs = options.localScanCacheMs ?? DEFAULT_LOCAL_SCAN_CACHE_MS;
+        this.now = options.now ?? Date.now;
         this.workspaceId = options.workspaceId;
         this.appendHistorySample = options.appendHistorySample ?? quotaHistory_1.appendQuotaHistorySample;
     }
@@ -255,28 +262,39 @@ class CodexQuotaWatcher {
     }
     emitCachedOrUnavailable() {
         const account = this.getActiveAccount();
-        let localProvider = null;
-        try {
-            localProvider = this.providerFactory();
-            const local = (0, codexQuota_1.resolveCodexQuotaFromLocalSources)({
-                workspacePath: this.workspacePath,
-                activeAccount: account,
-                readSnapshot: this.readSnapshot,
-                writeSnapshot: this.writeSnapshot,
-                provider: localProvider,
-                maxTailBytes: this.maxTailBytes,
-                maxSessionFiles: this.maxSessionFiles,
-            });
-            if (local) {
-                this.emitState(local);
+        const scanNow = this.now();
+        if (scanNow - this.lastLocalScanAt < this.localScanCacheMs) {
+            if (this.lastLocalScanState) {
+                this.emitState(this.lastLocalScanState);
                 return;
             }
         }
-        catch {
-            // Fall through to account-scoped cache or unavailable state.
-        }
-        finally {
-            localProvider?.dispose();
+        else {
+            let localProvider = null;
+            this.lastLocalScanAt = scanNow;
+            this.lastLocalScanState = null;
+            try {
+                localProvider = this.providerFactory();
+                this.lastLocalScanState = (0, codexQuota_1.resolveCodexQuotaFromLocalSources)({
+                    workspacePath: this.workspacePath,
+                    activeAccount: account,
+                    readSnapshot: this.readSnapshot,
+                    writeSnapshot: this.writeSnapshot,
+                    provider: localProvider,
+                    maxTailBytes: this.maxTailBytes,
+                    maxSessionFiles: this.maxSessionFiles,
+                });
+                if (this.lastLocalScanState) {
+                    this.emitState(this.lastLocalScanState);
+                    return;
+                }
+            }
+            catch {
+                // Fall through to account-scoped cache or unavailable state.
+            }
+            finally {
+                localProvider?.dispose();
+            }
         }
         const cached = account ? this.readSnapshot('codex', account.id) : null;
         if (cached) {

package/dist/context/sessionContext.js

@@ -12,6 +12,7 @@ exports.createSessionContextProjector = createSessionContextProjector;
 exports.readSessionContextSnapshot = readSessionContextSnapshot;
 const EventAggregator_1 = require("../aggregation/EventAggregator");
 const modelContext_1 = require("../modelContext");
+const tokenEstimation_1 = require("../tokenEstimation");
 const DEFAULT_CONTEXT_SOURCE_LIMIT = 200;
 const DEFAULT_SNIPPET_MAX_CHARS = 240;
 const DEFAULT_BODY_MAX_CHARS = 5000;
@@ -57,6 +58,10 @@ function buildSessionContextSnapshot(events, options = {}) {
         if (event.rateLimits)
             lastRateLimits = event.rateLimits;
     }
+    return assembleSessionContextSnapshot(aggregator, sourceState, lastPermissionMode, lastRateLimits, options);
+}
+function assembleSessionContextSnapshot(aggregator, sourceState, lastPermissionMode, lastRateLimits, options) {
+    const providerId = options.providerId;
     const metrics = aggregator.getMetrics();
     const model = options.model ?? metrics.currentModel ?? metrics.modelStats[0]?.model;
     const contextWindow = options.contextWindow ??
@@ -100,24 +105,46 @@ function buildSessionContextSnapshot(events, options = {}) {
     };
 }
 function createSessionContextProjector(options = {}) {
-    let events = [];
+    let aggregator = createProjectorAggregator(options);
+    let sourceState = createSourceExtractionState(options);
+    let lastPermissionMode;
+    let lastRateLimits;
+    const process = (event) => {
+        aggregator.processEvent(event);
+        extractSourcesFromEvent(event, sourceState);
+        if (event.permissionMode)
+            lastPermissionMode = event.permissionMode;
+        if (event.rateLimits)
+            lastRateLimits = event.rateLimits;
+    };
+    const snapshot = () => assembleSessionContextSnapshot(aggregator, sourceState, lastPermissionMode, lastRateLimits, options);
     return {
         processEvent(event) {
-            events.push(event);
-            return buildSessionContextSnapshot(events, options);
+            process(event);
+            return snapshot();
         },
         processEvents(newEvents) {
-            events.push(...newEvents);
-            return buildSessionContextSnapshot(events, options);
+            for (const event of newEvents)
+                process(event);
+            return snapshot();
         },
         getSnapshot() {
-            return buildSessionContextSnapshot(events, options);
+            return snapshot();
         },
         reset() {
-            events = [];
+            aggregator = createProjectorAggregator(options);
+            sourceState = createSourceExtractionState(options);
+            lastPermissionMode = undefined;
+            lastRateLimits = undefined;
         },
     };
 }
+function createProjectorAggregator(options) {
+    return new EventAggregator_1.EventAggregator({
+        providerId: options.providerId,
+        computeContextSize: options.computeContextSize,
+    });
+}
 function readSessionContextSnapshot(provider, sessionPath, options = {}) {
     const reader = provider.createReader(sessionPath);
     const events = reader.readAll();
@@ -177,22 +204,23 @@ function extractSourcesFromEvent(event, state) {
                 layer: 'summary',
                 sourceType: 'summary',
                 title: 'Context summary',
-                text: extractText(event.message.content) || 'Context compacted',
+                text: extractText(event.message?.content) || 'Context compacted',
             });
             break;
     }
 }
 function extractSystemSource(event, state) {
-    const text = extractText(event.message.content);
-    const label = event.message.sourceLabel ?? event.message.role ?? 'system';
-    const usage = event.message.usage;
+    const message = event.message;
+    const text = extractText(message?.content);
+    const label = message?.sourceLabel ?? message?.role ?? 'system';
+    const usage = message?.usage;
     if (text) {
         addSource(state, {
             event,
             layer: 'system',
             sourceType: 'system',
             title: label,
-            sourceRef: event.message.id,
+            sourceRef: message?.id,
             text,
         });
     }
@@ -202,7 +230,7 @@ function extractSystemSource(event, state) {
             layer: 'runtime',
             sourceType: event.rateLimits ? 'rate_limit' : 'runtime',
             title: event.rateLimits ? 'Runtime usage and rate limits' : 'Runtime usage',
-            sourceRef: event.message.id,
+            sourceRef: message?.id,
             text: describeUsage(usage, event.rateLimits),
             metadata: {
                 usage,
@@ -394,7 +422,7 @@ function limitSources(sources, limit) {
 }
 function latestModel(events) {
     for (let i = events.length - 1; i >= 0; i--) {
-        const model = events[i].message.model;
+        const model = events[i].message?.model;
         if (model)
             return model;
     }
@@ -519,7 +547,7 @@ function truncateWithInfo(text, maxChars) {
     return { text: `${text.slice(0, maxChars - 3)}...`, truncated: true };
 }
 function estimateTokens(text) {
-    return Math.max(1, Math.ceil(text.length / 4));
+    return (0, tokenEstimation_1.estimateTextTokens)(text).count;
 }
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);

package/dist/credentialIO.js

@@ -52,6 +52,12 @@ const os = __importStar(require("os"));
 const child_process_1 = require("child_process");
 const claudeProfiles_1 = require("./claudeProfiles");
 exports.KEYCHAIN_SERVICE = 'Claude Code-credentials';
+function quoteSecurityInteractiveArg(value) {
+    // `security -i` is not a POSIX shell: adjacent quoted segments do NOT
+    // concatenate (so the shell-style '\'' splice splits the token), and
+    // backslash escapes the next character even inside single quotes.
+    return `'${value.replace(/\\/g, '\\\\').replace(/'/g, `\\'`)}'`;
+}
 function getCredentialsFilePath(configDir) {
     return path.join(configDir ?? path.join(os.homedir(), '.claude'), '.credentials.json');
 }
@@ -93,16 +99,24 @@ function writeActiveCredentials(credentials, configDir) {
     const json = JSON.stringify(credentials);
     JSON.parse(json); // validate round-trip
     if (process.platform === 'darwin') {
-        (0, child_process_1.execFileSync)('security', [
+        const service = (0, claudeProfiles_1.claudeKeychainService)(configDir);
+        const account = process.env.USER || 'user';
+        const command = [
             'add-generic-password',
             '-U',
             '-s',
-            (0, claudeProfiles_1.claudeKeychainService)(configDir),
+            quoteSecurityInteractiveArg(service),
             '-a',
-            process.env.USER || 'user',
+            quoteSecurityInteractiveArg(account),
             '-w',
-            json,
-        ], { stdio: ['pipe', 'pipe', 'pipe'], timeout: 4000, killSignal: 'SIGKILL' });
+            quoteSecurityInteractiveArg(json),
+        ].join(' ');
+        (0, child_process_1.execFileSync)('security', ['-i'], {
+            input: command + '\n',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 4000,
+            killSignal: 'SIGKILL',
+        });
         return;
     }
     // Linux / WSL / Windows — file-based

package/dist/errorHistory.d.ts

@@ -1,5 +1,6 @@
 import type { ErrorRollup, ErrorRollupEntry } from './aggregation/types';
 export declare const ERROR_HISTORY_SCHEMA_VERSION: 1;
+export declare const MAX_ERROR_HISTORY_SESSIONS = 500;
 export interface ErrorHistorySessionRecord {
     sessionId: string;
     providerId: string;

package/dist/errorHistory.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ERROR_HISTORY_SCHEMA_VERSION = void 0;
+exports.MAX_ERROR_HISTORY_SESSIONS = exports.ERROR_HISTORY_SCHEMA_VERSION = void 0;
 exports.appendErrorHistory = appendErrorHistory;
 exports.readErrorHistory = readErrorHistory;
 exports.getTopFailingTools = getTopFailingTools;
@@ -41,6 +41,7 @@ const fs = __importStar(require("fs"));
 const paths_1 = require("./paths");
 const atomic_1 = require("./writers/atomic");
 exports.ERROR_HISTORY_SCHEMA_VERSION = 1;
+exports.MAX_ERROR_HISTORY_SESSIONS = 500;
 function emptyStore() {
     return {
         schemaVersion: exports.ERROR_HISTORY_SCHEMA_VERSION,
@@ -59,7 +60,7 @@ async function appendErrorHistory(identity, rollup, filePath = (0, paths_1.getGl
     await (0, atomic_1.updateJsonStoreAtomic)(filePath, emptyStore, (store) => ({
         ...store,
         schemaVersion: exports.ERROR_HISTORY_SCHEMA_VERSION,
-        sessions: [...store.sessions, record],
+        sessions: [...(Array.isArray(store.sessions) ? store.sessions : []), record].slice(-exports.MAX_ERROR_HISTORY_SESSIONS),
         lastSaved: record.endedAt,
     }));
     return record;

package/dist/extractors/tokenUsage.js

@@ -35,7 +35,7 @@ function extractTokenUsage(event) {
         outputTokens: usage.output_tokens ?? 0,
         cacheWriteTokens: usage.cache_creation_input_tokens ?? 0,
         cacheReadTokens: usage.cache_read_input_tokens ?? 0,
-        model: event.message.model ?? 'unknown',
+        model: event.message?.model ?? 'unknown',
         timestamp: new Date(event.timestamp),
         reportedCost: usage.reported_cost,
         reasoningTokens: usage.reasoning_tokens,

package/dist/extractors/toolCall.js

@@ -85,7 +85,7 @@ class ToolCallTracker {
         }
         const topLevel = extractToolCall(event);
         if (topLevel) {
-            const id = event.message.id;
+            const id = event.message?.id;
             if (id) {
                 topLevel.toolUseId = id;
                 this.pending.set(id, topLevel);
@@ -94,7 +94,7 @@ class ToolCallTracker {
                 completed.push(topLevel);
             }
         }
-        const content = event.message.content;
+        const content = event.message?.content;
         if (!Array.isArray(content))
             return completed;
         for (const block of content) {

package/dist/index.d.ts

@@ -1,7 +1,17 @@
 /**
  * Public API for sidekick-shared.
  */
-export type { SessionEvent, ClaudeSessionEvent, MessageUsage, SessionMessage, TokenUsage, ToolCall, ToolAnalytics, TimelineEvent, PendingToolCall, TaskStatus as SessionTaskStatus, TrackedTask, TaskState, SubagentStats, PendingUserRequest, ResponseLatency, LatencyStats, PlanStep, PlanState, SessionStats, CompactionEvent, TruncationEvent, ContextAttribution, TurnAttribution, ContextSizePoint, PermissionMode, PermissionModeChange, } from './types/sessionEvent';
+export { normalizeProviderUsage, extractNormalizedUsage, calculateNormalizedUsageCost, } from './usageNormalization';
+export type { UsageProvider, UsageSemantics, UsageNormalizationProvenance, ProviderUsageInput, AnthropicUsageInput, OpenAIUsageInput, SidekickUsageInput, NormalizedUsage, PricingProvenance, NormalizedUsageCostInput, NormalizedUsageCost, } from './usageNormalization';
+export { estimateTextTokens, estimateSerializedTokens } from './tokenEstimation';
+export type { ExactTokenCounterContext, ExactTokenCounter, TokenEstimationMethod, TokenEstimationConfidence, TokenEstimationOptions, TokenEstimate, } from './tokenEstimation';
+export { projectSessionTranscript } from './transcript';
+export type { TranscriptFidelity, TranscriptSourceProvenance, CanonicalTranscriptBlock, CanonicalTranscriptMessage, CanonicalToolCall, CanonicalTranscriptUsageTotals, CanonicalSessionTranscript, ProjectSessionTranscriptOptions, } from './transcript';
+export { listRecentSessions, readSessionTranscript } from './sessionTranscripts';
+export type { ProviderSessionIndex, ListRecentSessionsOptions } from './sessionTranscripts';
+export { ObservedSessionCollector, observedSessionSourceFromProvider, fileFingerprint, } from './observedSessionCollector';
+export type { ObservedSessionReference, ObservedSessionCollectionSource, ObservedSessionDiagnosticKind, ObservedSessionDiagnostic, ObservedSessionCollection, ObservedSessionCollectorOptions, } from './observedSessionCollector';
+export type { SessionEvent, ClaudeSessionEvent, MessageUsage, SessionMessage, SessionEventBase, MessageSessionEvent, UserSessionEvent, AssistantSessionEvent, SummarySessionEvent, SystemSessionEvent, ToolUseSessionEvent, ToolResultSessionEvent, TokenUsage, ToolCall, ToolAnalytics, TimelineEvent, PendingToolCall, TaskStatus as SessionTaskStatus, TrackedTask, TaskState, SubagentStats, PendingUserRequest, ResponseLatency, LatencyStats, PlanStep, PlanState, SessionStats, CompactionEvent, TruncationEvent, ContextAttribution, TurnAttribution, ContextSizePoint, PermissionMode, PermissionModeChange, } from './types/sessionEvent';
 export type { OpenCodeSession, OpenCodeMessage, OpenCodePart, OpenCodeTextPart, OpenCodeReasoningPart, OpenCodeToolInvocationPart, OpenCodeCompactionPart, OpenCodeDbToolPart, OpenCodeStepStartPart, OpenCodeStepFinishPart, OpenCodePatchPart, OpenCodeSubtaskPart, OpenCodeAgentPart, OpenCodeFilePart, OpenCodeRetryPart, OpenCodeSnapshotPart, OpenCodeProject, DbProject as OpenCodeDbProject, DbSession as OpenCodeDbSession, DbMessage as OpenCodeDbMessage, DbPart as OpenCodeDbPart, } from './types/opencode';
 export type { CodexRolloutLine, CodexSessionMeta, CodexResponseItem, CodexMessageItem, CodexContentPart, CodexReasoningItem, CodexFunctionCallItem, CodexFunctionCallOutputItem, CodexLocalShellCallItem, CodexWebSearchCallItem, CodexCustomToolCallItem, CodexCustomToolCallOutputItem, CodexCompacted, CodexTurnContext, CodexEventMsg, CodexEvent, CodexTurnStartedEvent, CodexTurnCompleteEvent, CodexTaskStartedEvent, CodexTaskCompleteEvent, CodexTurnAbortedEvent, CodexTokenCountEvent, CodexTokenUsage, CodexRateLimits, CodexAgentMessageEvent, CodexAgentReasoningEvent, CodexUserMessageEvent, CodexExecCommandBeginEvent, CodexExecCommandEndEvent, CodexMcpToolCallBeginEvent, CodexMcpToolCallEndEvent, CodexErrorEvent, CodexContextCompactedEvent, CodexPatchAppliedEvent, CodexBackgroundEvent, CodexGenericEvent, CodexDbThread, CodexReasoningSummary, } from './types/codex';
 export { isAggregateCodexLimit } from './types/codex';
@@ -11,8 +21,8 @@ export type { DecisionEntry, DecisionLogStore, DecisionSource } from './types/de
 export { DECISION_LOG_SCHEMA_VERSION } from './types/decisionLog';
 export type { KnowledgeNote, KnowledgeNoteStore, KnowledgeNoteType, KnowledgeNoteSource, KnowledgeNoteStatus, KnowledgeNoteImportance, } from './types/knowledgeNote';
 export { KNOWLEDGE_NOTE_SCHEMA_VERSION, IMPORTANCE_DECAY_FACTORS, STALENESS_THRESHOLDS, } from './types/knowledgeNote';
-export type { HistoricalDataStore, DailyData, MonthlyData, AllTimeStats, TokenTotals, ModelUsageRecord, ToolUsageRecord, SessionSummary, SessionHistoryRecord, } from './types/historicalData';
-export { HISTORICAL_DATA_SCHEMA_VERSION, HISTORICAL_SESSION_RETENTION_LIMIT, createEmptyTokenTotals, } from './types/historicalData';
+export type { HistoricalDataStore, DailyData, HourlyData, MonthlyData, AllTimeStats, TokenTotals, ModelUsageRecord, ToolUsageRecord, SessionSummary, SessionHistoryRecord, } from './types/historicalData';
+export { HISTORICAL_DATA_SCHEMA_VERSION, HISTORICAL_SESSION_RETENTION_LIMIT, createEmptyTokenTotals, createEmptyDataStore, } from './types/historicalData';
 export type { PersistedPlan, PersistedPlanStep, PlanHistoryStore, PlanStepStatus, PlanStatus, PlanSource, PlanStepComplexity, } from './types/plan';
 export { PLAN_SCHEMA_VERSION, MAX_PLANS_PER_PROJECT } from './types/plan';
 export { getConfigDir, getProjectDataPath, getGlobalDataPath, encodeWorkspacePath, getProjectSlug, getProjectSlugRaw, resolveProjectIdentity, } from './paths';
@@ -93,7 +103,7 @@ export type { SerializedAggregatorState } from './aggregation/EventAggregator';
 export { saveSnapshot, loadSnapshot, deleteSnapshot, isSnapshotValid, getSnapshotPath, } from './aggregation/snapshot';
 export type { SessionSnapshot } from './aggregation/snapshot';
 export type { EventAggregatorOptions, AggregatedTokens, ModelUsageStats, BurnRateInfo, SubagentLifecycle, AggregatedMetrics, FrequencyMetric, PatternMetric, HeatmapBucketMetric, ErrorRollup, ErrorRollupEntry, ErrorBucketMetric, } from './aggregation/types';
-export { ERROR_HISTORY_SCHEMA_VERSION, appendErrorHistory, getTopFailingTools, readErrorHistory, } from './errorHistory';
+export { ERROR_HISTORY_SCHEMA_VERSION, MAX_ERROR_HISTORY_SESSIONS, appendErrorHistory, getTopFailingTools, readErrorHistory, } from './errorHistory';
 export type { ErrorHistorySessionRecord, ErrorHistoryStore, TopFailingTool } from './errorHistory';
 export { FrequencyTracker } from './aggregation/FrequencyTracker';
 export type { FrequencyEntry, SerializedFrequencyState } from './aggregation/FrequencyTracker';

package/dist/index.js

@@ -3,13 +3,29 @@
  * Public API for sidekick-shared.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeToolName = exports.TRUNCATION_PATTERNS = exports.JsonlParser = exports.CodexProvider = exports.getOpenCodeDataDir = exports.OpenCodeProvider = exports.ClaudeCodeProvider = exports.getAllDetectedProviders = exports.detectProvider = exports.derivePendingUserRequestV1 = exports.createProviderSessionAdapterV1 = exports.renderHandoffUrlTemplate = exports.addNote = exports.decisionFingerprint = exports.addDecision = exports.completeTask = exports.addTask = exports.updateJsonStoreAtomic = exports.atomicWriteJsonSync = exports.atomicWriteJson = exports.readClaudeCodePlanFiles = exports.getPlanAnalytics = exports.writePlans = exports.getLatestPlan = exports.readPlans = exports.readLatestHandoff = exports.readHistory = exports.readNotes = exports.readDecisions = exports.readTasks = exports.migrateLegacyProjectStores = exports.resolveProjectIdentity = exports.getProjectSlugRaw = exports.getProjectSlug = exports.encodeWorkspacePath = exports.getGlobalDataPath = exports.getProjectDataPath = exports.getConfigDir = exports.MAX_PLANS_PER_PROJECT = exports.PLAN_SCHEMA_VERSION = exports.createEmptyTokenTotals = exports.HISTORICAL_SESSION_RETENTION_LIMIT = exports.HISTORICAL_DATA_SCHEMA_VERSION = exports.STALENESS_THRESHOLDS = exports.IMPORTANCE_DECAY_FACTORS = exports.KNOWLEDGE_NOTE_SCHEMA_VERSION = exports.DECISION_LOG_SCHEMA_VERSION = exports.normalizeTaskStatus = exports.TASK_PERSISTENCE_SCHEMA_VERSION = exports.isAggregateCodexLimit = void 0;
-exports.toFollowEvents = exports.createWatcher = exports.parseChangelog = exports.extractProposedPlanShared = exports.parsePlanMarkdownShared = exports.PlanExtractor = exports.segmentAssistantTurn = exports.reasoningSummary = exports.isAssistantTurnSubagentTool = exports.extractTurnSubagents = exports.assistantTurnEventsFromSessionEvents = exports.readSessionContextSnapshot = exports.createSessionContextProjector = exports.calculateSessionContextPressure = exports.buildSessionContextSnapshot = exports.composeContext = exports.FilterEngine = exports.searchSessions = exports.CodexDatabase = exports.OpenCodeDatabase = exports.discoverDebugLogs = exports.collapseDuplicates = exports.filterByLevel = exports.parseDebugLog = exports.scanSubagentTraces = exports.findAllSessionsWithWorktrees = exports.discoverWorktreeSiblings = exports.resolveWorktreeMainRepo = exports.getAllClaudeProjectFolders = exports.decodeEncodedPath = exports.getMostRecentlyActiveSessionDir = exports.findSubdirectorySessionDirs = exports.findSessionsInDirectory = exports.findAllClaudeSessions = exports.findActiveClaudeSession = exports.discoverSessionDirectory = exports.getClaudeSessionDirectory = exports.encodeClaudeWorkspacePath = exports.detectSessionActivity = exports.extractTaskInfo = exports.scanSubagentDir = exports.normalizeCodexToolInput = exports.normalizeCodexToolName = exports.extractPatchFilePaths = exports.CodexRolloutParser = exports.parseDbPartData = exports.parseDbMessageData = exports.convertOpenCodeMessage = exports.detectPlanModeFromText = exports.normalizeToolInput = void 0;
-exports.readAccountRegistry = exports.ensureDefaultAccounts = exports.readClaudeMaxAccessTokenSync = exports.readClaudeMaxCredentials = exports.writeActiveCredentials = exports.readActiveCredentials = exports.openInBrowser = exports.parseTranscriptFromEvents = exports.parseTranscript = exports.generateHtmlReport = exports.formatCompactionLedger = exports.calculateCompactionLedger = exports.calculateCodeImpact = exports.scoreSessionQuality = exports.calculateQualityTrend = exports.PatternExtractor = exports.HeatmapTracker = exports.FrequencyTracker = exports.readErrorHistory = exports.getTopFailingTools = exports.appendErrorHistory = exports.ERROR_HISTORY_SCHEMA_VERSION = exports.getSnapshotPath = exports.isSnapshotValid = exports.deleteSnapshot = exports.loadSnapshot = exports.saveSnapshot = exports.SessionMonitor = exports.parseTodoDependencies = exports.EventAggregator = exports.getRandomPhrase = exports.PHRASE_CATEGORIES = exports.ALL_PHRASES = exports.HIGHLIGHT_CSS = exports.clearHighlightCache = exports.highlightEvent = exports.formatSessionJson = exports.formatSessionMarkdown = exports.formatSessionText = exports.classifyNoise = exports.shouldMergeWithPrevious = exports.classifyFollowEvent = exports.classifyMessage = exports.getSoftNoiseReason = exports.isHardNoiseFollowEvent = exports.isHardNoise = exports.formatToolSummary = exports.formatTokenCount = exports.formatDurationMs = exports.createJsonlTail = void 0;
-exports.installShellHook = exports.setTerminalActiveProfile = exports.removeCodexAccount = exports.switchToCodexAccount = exports.finalizeCodexAccount = exports.prepareCodexAccount = exports.getCodexExecutionEnv = exports.resolveSidekickCodexHome = exports.resolveActiveCodexAccount = exports.getActiveCodexAccount = exports.listCodexAccounts = exports.getSystemCodexHome = exports.getCodexMonitoringHomes = exports.getCodexProfileHome = exports.getCodexProfilesDir = exports.readClaudeProfileIdentity = exports.isClaudeProfileAuthenticated = exports.claudeKeychainService = exports.claudeKeychainSuffix = exports.getClaudeProfileHome = exports.getClaudeProfilesDir = exports.getActiveAccountStatus = exports.removeSavedAccountProfile = exports.replaceSavedAccountProfiles = exports.setActiveSavedAccount = exports.upsertSavedAccountProfile = exports.getActiveSavedAccount = exports.listSavedAccountProfiles = exports.writeSavedAccountRegistry = exports.readSavedAccountRegistry = exports.getAccountsDir = exports.resolveClaudeLoginCommand = exports.listAllAccounts = exports.switchAccount = exports.spawnAccountLogin = exports.finalizeAccountLogin = exports.getAccountLoginStatus = exports.beginAccountLogin = exports.isMultiAccountEnabled = exports.resolveActiveClaudeAccount = exports.getActiveAccount = exports.listAccounts = exports.removeAccount = exports.reconcileClaudeAuthState = exports.applyActiveClaudeToLiveHome = exports.resolveActiveClaudeHome = exports.switchToAccount = exports.addCurrentAccount = exports.readActiveClaudeAccount = exports.writeAccountRegistry = void 0;
-exports.sortModelIds = exports.compareModelIds = exports.getModelDisplayInfo = exports.shortModelName = exports.mergeCostSources = exports.calculateCostWithProvenance = exports.calculateCostWithPricing = exports.calculateCost = exports.getModelInfo = exports.getModelPricing = exports.parseModelId = exports.DEFAULT_CONTEXT_WINDOW = exports.getModelContextWindowSize = exports.selectStatuslineAccount = exports.formatStatusline = exports.estimateTimeToQuota = exports.BurnRateCalculator = exports.MultiProviderQuotaService = exports.resolveZaiQuota = exports.readZaiCredentials = exports.quotaStateFromZaiQuotaLimitPayload = exports.fetchZaiQuotaFromApi = exports.CodexQuotaWatcher = exports.resolveCodexQuotaFromLocalSources = exports.resolveCodexQuota = exports.readLatestCodexQuotaFromRollouts = exports.quotaFromCodexRateLimits = exports.fetchCodexQuotaFromApi = exports.fetchCodexResetCreditsFromApi = exports.getWorkspaceIdFromPath = exports.pruneQuotaHistory = exports.readQuotaHistoryDailyBuckets = exports.readQuotaHistoryRange = exports.appendQuotaHistorySample = exports.writeQuotaSnapshot = exports.readQuotaSnapshot = exports.QuotaPoller = exports.describeQuotaFailure = exports.withQuotaProjections = exports.projectQuotaWindow = exports.fetchQuota = exports.SEVEN_DAY_WINDOW_MS = exports.FIVE_HOUR_WINDOW_MS = exports.AutoSwitchController = exports.decideAutoSwitch = exports.DEFAULT_AUTO_SWITCH_CONFIG = exports.removeLauncher = exports.writeLauncher = exports.isShellHookInstalled = exports.uninstallShellHook = void 0;
-exports.listAllAccountsResultSchema = exports.savedAccountProfileSchema = exports.accountEntrySchema = exports.accountLoginStatusSchema = exports.beginAccountLoginResultSchema = exports.accountManagerResultSchema = exports.accountProviderIdSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.extractSessionEvents = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.ToolCallTracker = exports.extractToolCalls = exports.extractToolCall = exports.extractErrorMessage = exports.categorizeError = exports.gatherAssetsForCwd = exports.codexSessions = exports.readCodexAssets = exports.claudeSessions = exports.readClaudeAssets = exports.extractCommands = exports.extractFilePaths = exports.extractUrls = exports.extractTokenUsage = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = exports.formatCost = void 0;
-exports.scopePeakHoursToSessionProvider = exports.isClaudeCodeSessionProvider = exports.fetchPeakHoursStatus = exports.createPeakHoursNotApplicableState = exports.runDoctor = exports.getSessionDiagnostics = exports.formatHealthReport = exports.fetchOpenAIStatus = exports.fetchProviderStatus = exports.assistantTurnToolRefSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnTimelineItemSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnReasoningTimelineItemSchema = exports.assistantTurnProjectionSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnProcessSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnEventTypeSchema = exports.assistantTurnEventSchema = void 0;
+exports.addNote = exports.decisionFingerprint = exports.addDecision = exports.completeTask = exports.addTask = exports.updateJsonStoreAtomic = exports.atomicWriteJsonSync = exports.atomicWriteJson = exports.readClaudeCodePlanFiles = exports.getPlanAnalytics = exports.writePlans = exports.getLatestPlan = exports.readPlans = exports.readLatestHandoff = exports.readHistory = exports.readNotes = exports.readDecisions = exports.readTasks = exports.migrateLegacyProjectStores = exports.resolveProjectIdentity = exports.getProjectSlugRaw = exports.getProjectSlug = exports.encodeWorkspacePath = exports.getGlobalDataPath = exports.getProjectDataPath = exports.getConfigDir = exports.MAX_PLANS_PER_PROJECT = exports.PLAN_SCHEMA_VERSION = exports.createEmptyDataStore = exports.createEmptyTokenTotals = exports.HISTORICAL_SESSION_RETENTION_LIMIT = exports.HISTORICAL_DATA_SCHEMA_VERSION = exports.STALENESS_THRESHOLDS = exports.IMPORTANCE_DECAY_FACTORS = exports.KNOWLEDGE_NOTE_SCHEMA_VERSION = exports.DECISION_LOG_SCHEMA_VERSION = exports.normalizeTaskStatus = exports.TASK_PERSISTENCE_SCHEMA_VERSION = exports.isAggregateCodexLimit = exports.fileFingerprint = exports.observedSessionSourceFromProvider = exports.ObservedSessionCollector = exports.readSessionTranscript = exports.listRecentSessions = exports.projectSessionTranscript = exports.estimateSerializedTokens = exports.estimateTextTokens = exports.calculateNormalizedUsageCost = exports.extractNormalizedUsage = exports.normalizeProviderUsage = void 0;
+exports.createSessionContextProjector = exports.calculateSessionContextPressure = exports.buildSessionContextSnapshot = exports.composeContext = exports.FilterEngine = exports.searchSessions = exports.CodexDatabase = exports.OpenCodeDatabase = exports.discoverDebugLogs = exports.collapseDuplicates = exports.filterByLevel = exports.parseDebugLog = exports.scanSubagentTraces = exports.findAllSessionsWithWorktrees = exports.discoverWorktreeSiblings = exports.resolveWorktreeMainRepo = exports.getAllClaudeProjectFolders = exports.decodeEncodedPath = exports.getMostRecentlyActiveSessionDir = exports.findSubdirectorySessionDirs = exports.findSessionsInDirectory = exports.findAllClaudeSessions = exports.findActiveClaudeSession = exports.discoverSessionDirectory = exports.getClaudeSessionDirectory = exports.encodeClaudeWorkspacePath = exports.detectSessionActivity = exports.extractTaskInfo = exports.scanSubagentDir = exports.normalizeCodexToolInput = exports.normalizeCodexToolName = exports.extractPatchFilePaths = exports.CodexRolloutParser = exports.parseDbPartData = exports.parseDbMessageData = exports.convertOpenCodeMessage = exports.detectPlanModeFromText = exports.normalizeToolInput = exports.normalizeToolName = exports.TRUNCATION_PATTERNS = exports.JsonlParser = exports.CodexProvider = exports.getOpenCodeDataDir = exports.OpenCodeProvider = exports.ClaudeCodeProvider = exports.getAllDetectedProviders = exports.detectProvider = exports.derivePendingUserRequestV1 = exports.createProviderSessionAdapterV1 = exports.renderHandoffUrlTemplate = void 0;
+exports.scoreSessionQuality = exports.calculateQualityTrend = exports.PatternExtractor = exports.HeatmapTracker = exports.FrequencyTracker = exports.readErrorHistory = exports.getTopFailingTools = exports.appendErrorHistory = exports.MAX_ERROR_HISTORY_SESSIONS = exports.ERROR_HISTORY_SCHEMA_VERSION = exports.getSnapshotPath = exports.isSnapshotValid = exports.deleteSnapshot = exports.loadSnapshot = exports.saveSnapshot = exports.SessionMonitor = exports.parseTodoDependencies = exports.EventAggregator = exports.getRandomPhrase = exports.PHRASE_CATEGORIES = exports.ALL_PHRASES = exports.HIGHLIGHT_CSS = exports.clearHighlightCache = exports.highlightEvent = exports.formatSessionJson = exports.formatSessionMarkdown = exports.formatSessionText = exports.classifyNoise = exports.shouldMergeWithPrevious = exports.classifyFollowEvent = exports.classifyMessage = exports.getSoftNoiseReason = exports.isHardNoiseFollowEvent = exports.isHardNoise = exports.formatToolSummary = exports.formatTokenCount = exports.formatDurationMs = exports.createJsonlTail = exports.toFollowEvents = exports.createWatcher = exports.parseChangelog = exports.extractProposedPlanShared = exports.parsePlanMarkdownShared = exports.PlanExtractor = exports.segmentAssistantTurn = exports.reasoningSummary = exports.isAssistantTurnSubagentTool = exports.extractTurnSubagents = exports.assistantTurnEventsFromSessionEvents = exports.readSessionContextSnapshot = void 0;
+exports.getCodexProfileHome = exports.getCodexProfilesDir = exports.readClaudeProfileIdentity = exports.isClaudeProfileAuthenticated = exports.claudeKeychainService = exports.claudeKeychainSuffix = exports.getClaudeProfileHome = exports.getClaudeProfilesDir = exports.getActiveAccountStatus = exports.removeSavedAccountProfile = exports.replaceSavedAccountProfiles = exports.setActiveSavedAccount = exports.upsertSavedAccountProfile = exports.getActiveSavedAccount = exports.listSavedAccountProfiles = exports.writeSavedAccountRegistry = exports.readSavedAccountRegistry = exports.getAccountsDir = exports.resolveClaudeLoginCommand = exports.listAllAccounts = exports.switchAccount = exports.spawnAccountLogin = exports.finalizeAccountLogin = exports.getAccountLoginStatus = exports.beginAccountLogin = exports.isMultiAccountEnabled = exports.resolveActiveClaudeAccount = exports.getActiveAccount = exports.listAccounts = exports.removeAccount = exports.reconcileClaudeAuthState = exports.applyActiveClaudeToLiveHome = exports.resolveActiveClaudeHome = exports.switchToAccount = exports.addCurrentAccount = exports.readActiveClaudeAccount = exports.writeAccountRegistry = exports.readAccountRegistry = exports.ensureDefaultAccounts = exports.readClaudeMaxAccessTokenSync = exports.readClaudeMaxCredentials = exports.writeActiveCredentials = exports.readActiveCredentials = exports.openInBrowser = exports.parseTranscriptFromEvents = exports.parseTranscript = exports.generateHtmlReport = exports.formatCompactionLedger = exports.calculateCompactionLedger = exports.calculateCodeImpact = void 0;
+exports.selectStatuslineAccount = exports.formatStatusline = exports.estimateTimeToQuota = exports.BurnRateCalculator = exports.MultiProviderQuotaService = exports.resolveZaiQuota = exports.readZaiCredentials = exports.quotaStateFromZaiQuotaLimitPayload = exports.fetchZaiQuotaFromApi = exports.CodexQuotaWatcher = exports.resolveCodexQuotaFromLocalSources = exports.resolveCodexQuota = exports.readLatestCodexQuotaFromRollouts = exports.quotaFromCodexRateLimits = exports.fetchCodexQuotaFromApi = exports.fetchCodexResetCreditsFromApi = exports.getWorkspaceIdFromPath = exports.pruneQuotaHistory = exports.readQuotaHistoryDailyBuckets = exports.readQuotaHistoryRange = exports.appendQuotaHistorySample = exports.writeQuotaSnapshot = exports.readQuotaSnapshot = exports.QuotaPoller = exports.describeQuotaFailure = exports.withQuotaProjections = exports.projectQuotaWindow = exports.fetchQuota = exports.SEVEN_DAY_WINDOW_MS = exports.FIVE_HOUR_WINDOW_MS = exports.AutoSwitchController = exports.decideAutoSwitch = exports.DEFAULT_AUTO_SWITCH_CONFIG = exports.removeLauncher = exports.writeLauncher = exports.isShellHookInstalled = exports.uninstallShellHook = exports.installShellHook = exports.setTerminalActiveProfile = exports.removeCodexAccount = exports.switchToCodexAccount = exports.finalizeCodexAccount = exports.prepareCodexAccount = exports.getCodexExecutionEnv = exports.resolveSidekickCodexHome = exports.resolveActiveCodexAccount = exports.getActiveCodexAccount = exports.listCodexAccounts = exports.getSystemCodexHome = exports.getCodexMonitoringHomes = void 0;
+exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.extractSessionEvents = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.ToolCallTracker = exports.extractToolCalls = exports.extractToolCall = exports.extractErrorMessage = exports.categorizeError = exports.gatherAssetsForCwd = exports.codexSessions = exports.readCodexAssets = exports.claudeSessions = exports.readClaudeAssets = exports.extractCommands = exports.extractFilePaths = exports.extractUrls = exports.extractTokenUsage = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = exports.formatCost = exports.sortModelIds = exports.compareModelIds = exports.getModelDisplayInfo = exports.shortModelName = exports.mergeCostSources = exports.calculateCostWithProvenance = exports.calculateCostWithPricing = exports.calculateCost = exports.getModelInfo = exports.getModelPricing = exports.parseModelId = exports.DEFAULT_CONTEXT_WINDOW = exports.getModelContextWindowSize = void 0;
+exports.scopePeakHoursToSessionProvider = exports.isClaudeCodeSessionProvider = exports.fetchPeakHoursStatus = exports.createPeakHoursNotApplicableState = exports.runDoctor = exports.getSessionDiagnostics = exports.formatHealthReport = exports.fetchOpenAIStatus = exports.fetchProviderStatus = exports.assistantTurnToolRefSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnTimelineItemSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnReasoningTimelineItemSchema = exports.assistantTurnProjectionSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnProcessSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnEventTypeSchema = exports.assistantTurnEventSchema = exports.listAllAccountsResultSchema = exports.savedAccountProfileSchema = exports.accountEntrySchema = exports.accountLoginStatusSchema = exports.beginAccountLoginResultSchema = exports.accountManagerResultSchema = exports.accountProviderIdSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = void 0;
+var usageNormalization_1 = require("./usageNormalization");
+Object.defineProperty(exports, "normalizeProviderUsage", { enumerable: true, get: function () { return usageNormalization_1.normalizeProviderUsage; } });
+Object.defineProperty(exports, "extractNormalizedUsage", { enumerable: true, get: function () { return usageNormalization_1.extractNormalizedUsage; } });
+Object.defineProperty(exports, "calculateNormalizedUsageCost", { enumerable: true, get: function () { return usageNormalization_1.calculateNormalizedUsageCost; } });
+var tokenEstimation_1 = require("./tokenEstimation");
+Object.defineProperty(exports, "estimateTextTokens", { enumerable: true, get: function () { return tokenEstimation_1.estimateTextTokens; } });
+Object.defineProperty(exports, "estimateSerializedTokens", { enumerable: true, get: function () { return tokenEstimation_1.estimateSerializedTokens; } });
+var transcript_1 = require("./transcript");
+Object.defineProperty(exports, "projectSessionTranscript", { enumerable: true, get: function () { return transcript_1.projectSessionTranscript; } });
+var sessionTranscripts_1 = require("./sessionTranscripts");
+Object.defineProperty(exports, "listRecentSessions", { enumerable: true, get: function () { return sessionTranscripts_1.listRecentSessions; } });
+Object.defineProperty(exports, "readSessionTranscript", { enumerable: true, get: function () { return sessionTranscripts_1.readSessionTranscript; } });
+var observedSessionCollector_1 = require("./observedSessionCollector");
+Object.defineProperty(exports, "ObservedSessionCollector", { enumerable: true, get: function () { return observedSessionCollector_1.ObservedSessionCollector; } });
+Object.defineProperty(exports, "observedSessionSourceFromProvider", { enumerable: true, get: function () { return observedSessionCollector_1.observedSessionSourceFromProvider; } });
+Object.defineProperty(exports, "fileFingerprint", { enumerable: true, get: function () { return observedSessionCollector_1.fileFingerprint; } });
 var codex_1 = require("./types/codex");
 Object.defineProperty(exports, "isAggregateCodexLimit", { enumerable: true, get: function () { return codex_1.isAggregateCodexLimit; } });
 var taskPersistence_1 = require("./types/taskPersistence");
@@ -25,6 +41,7 @@ var historicalData_1 = require("./types/historicalData");
 Object.defineProperty(exports, "HISTORICAL_DATA_SCHEMA_VERSION", { enumerable: true, get: function () { return historicalData_1.HISTORICAL_DATA_SCHEMA_VERSION; } });
 Object.defineProperty(exports, "HISTORICAL_SESSION_RETENTION_LIMIT", { enumerable: true, get: function () { return historicalData_1.HISTORICAL_SESSION_RETENTION_LIMIT; } });
 Object.defineProperty(exports, "createEmptyTokenTotals", { enumerable: true, get: function () { return historicalData_1.createEmptyTokenTotals; } });
+Object.defineProperty(exports, "createEmptyDataStore", { enumerable: true, get: function () { return historicalData_1.createEmptyDataStore; } });
 var plan_1 = require("./types/plan");
 Object.defineProperty(exports, "PLAN_SCHEMA_VERSION", { enumerable: true, get: function () { return plan_1.PLAN_SCHEMA_VERSION; } });
 Object.defineProperty(exports, "MAX_PLANS_PER_PROJECT", { enumerable: true, get: function () { return plan_1.MAX_PLANS_PER_PROJECT; } });
@@ -213,6 +230,7 @@ Object.defineProperty(exports, "isSnapshotValid", { enumerable: true, get: funct
 Object.defineProperty(exports, "getSnapshotPath", { enumerable: true, get: function () { return snapshot_1.getSnapshotPath; } });
 var errorHistory_1 = require("./errorHistory");
 Object.defineProperty(exports, "ERROR_HISTORY_SCHEMA_VERSION", { enumerable: true, get: function () { return errorHistory_1.ERROR_HISTORY_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "MAX_ERROR_HISTORY_SESSIONS", { enumerable: true, get: function () { return errorHistory_1.MAX_ERROR_HISTORY_SESSIONS; } });
 Object.defineProperty(exports, "appendErrorHistory", { enumerable: true, get: function () { return errorHistory_1.appendErrorHistory; } });
 Object.defineProperty(exports, "getTopFailingTools", { enumerable: true, get: function () { return errorHistory_1.getTopFailingTools; } });
 Object.defineProperty(exports, "readErrorHistory", { enumerable: true, get: function () { return errorHistory_1.readErrorHistory; } });

package/dist/modelInfo.d.ts

@@ -24,16 +24,20 @@ export interface ModelPricing {
     cacheWriteCostPerMillion: number;
     cacheReadCostPerMillion: number;
 }
-/** Token usage for cost calculation. */
+/**
+ * Token usage for the legacy cost calculation contract.
+ * @deprecated Use NormalizedUsage and calculateNormalizedUsageCost. This shape
+ * cannot state whether reasoning is already included in output.
+ */
 export interface CostTokenUsage {
     inputTokens: number;
     outputTokens: number;
     cacheWriteTokens: number;
     cacheReadTokens: number;
     /**
-     * OpenAI o-series / Codex "reasoning" tokens. Billed at the output rate by
-     * OpenAI, so we multiply by `outputCostPerMillion` inside calculateCost.
-     * Optional for backward compatibility with existing callers.
+     * Legacy disjoint reasoning category. The compatibility calculator always
+     * adds it at the output rate, even when a provider already included it in
+     * output. Use NormalizedUsage to state inclusion semantics.
      */
     reasoningTokens?: number;
 }
@@ -55,7 +59,10 @@ export interface ModelInfo {
 }
 /** Provenance for a displayed cost value. */
 export type CostSource = 'reported' | 'estimated' | 'unpriced';
-/** Input for cost calculation that preserves reported-vs-estimated provenance. */
+/**
+ * Input for the legacy cost calculation contract.
+ * @deprecated Use NormalizedUsageCostInput.
+ */
 export interface CostProvenanceInput {
     usage: CostTokenUsage;
     modelId: string;
@@ -128,8 +135,9 @@ export declare function getModelInfo(modelId: string): ModelInfo;
 /**
  * Calculates cost from token usage and an explicit pricing object.
  *
- * Reasoning tokens (OpenAI o-series / Codex) are billed at the output rate,
- * matching OpenAI's billing behavior.
+ * Legacy behavior treats reasoning as disjoint and adds it at the output rate.
+ * @deprecated Use calculateNormalizedUsageCost. This legacy function always
+ * adds reasoning to output and cannot represent provider inclusion semantics.
  */
 export declare function calculateCostWithPricing(usage: CostTokenUsage, pricing: ModelPricing): number;
 /**
@@ -137,11 +145,13 @@ export declare function calculateCostWithPricing(usage: CostTokenUsage, pricing:
  *
  * Returns `null` for unknown models. Callers should render `—` in that case,
  * not $0 — so users don't confuse "missing pricing" with "free".
+ * @deprecated Use calculateNormalizedUsageCost.
  */
 export declare function calculateCost(usage: CostTokenUsage, modelId: string): number | null;
 /**
  * Calculates cost while preserving whether the value was provider-reported,
  * locally estimated from pricing, or unavailable because the model is unpriced.
+ * @deprecated Use calculateNormalizedUsageCost.
  */
 export declare function calculateCostWithProvenance(input: CostProvenanceInput): CostWithProvenance;
 /**

package/dist/modelInfo.js

@@ -142,6 +142,12 @@ const PRICING_TABLE = {
         cacheWriteCostPerMillion: 6.25,
         cacheReadCostPerMillion: 0.5,
     },
+    'claude-opus-4-5': {
+        inputCostPerMillion: 5.0,
+        outputCostPerMillion: 25.0,
+        cacheWriteCostPerMillion: 6.25,
+        cacheReadCostPerMillion: 0.5,
+    },
     'claude-opus-4.5': {
         inputCostPerMillion: 5.0,
         outputCostPerMillion: 25.0,
@@ -380,8 +386,9 @@ function getModelInfo(modelId) {
 /**
  * Calculates cost from token usage and an explicit pricing object.
  *
- * Reasoning tokens (OpenAI o-series / Codex) are billed at the output rate,
- * matching OpenAI's billing behavior.
+ * Legacy behavior treats reasoning as disjoint and adds it at the output rate.
+ * @deprecated Use calculateNormalizedUsageCost. This legacy function always
+ * adds reasoning to output and cannot represent provider inclusion semantics.
  */
 function calculateCostWithPricing(usage, pricing) {
     const reasoning = usage.reasoningTokens ?? 0;
@@ -396,6 +403,7 @@ function calculateCostWithPricing(usage, pricing) {
  *
  * Returns `null` for unknown models. Callers should render `—` in that case,
  * not $0 — so users don't confuse "missing pricing" with "free".
+ * @deprecated Use calculateNormalizedUsageCost.
  */
 function calculateCost(usage, modelId) {
     const pricing = getModelPricing(modelId);
@@ -406,6 +414,7 @@ function calculateCost(usage, modelId) {
 /**
  * Calculates cost while preserving whether the value was provider-reported,
  * locally estimated from pricing, or unavailable because the model is unpriced.
+ * @deprecated Use calculateNormalizedUsageCost.
  */
 function calculateCostWithProvenance(input) {
     if (typeof input.reportedCostUsd === 'number' && Number.isFinite(input.reportedCostUsd)) {