sidekick-shared 0.24.4 → 0.24.5

package/dist/index.d.ts

@@ -38,7 +38,7 @@ export { readHistory } from './readers/history';
 export { readLatestHandoff } from './readers/handoff';
 export { readPlans, getLatestPlan, writePlans, getPlanAnalytics, readClaudeCodePlanFiles, } from './readers/plans';
 export type { ReadPlansOptions, PlanAnalytics } from './readers/plans';
-export { atomicWriteJson, atomicWriteJsonSync, updateJsonStoreAtomic } from './writers/atomic';
+export { atomicWriteJson, atomicWriteJsonSync, atomicWriteFileSync, updateJsonStoreAtomic, updateJsonStoreAtomicSync, withFileLockSync, } from './writers/atomic';
 export { addTask, completeTask } from './writers/tasks';
 export { addDecision, decisionFingerprint } from './writers/decisions';
 export { addNote } from './writers/notes';
@@ -50,7 +50,8 @@ export type { ObservationProvenanceV1, ObservedAgentSessionV1, ObservedValueV1,
 export { detectProvider, getAllDetectedProviders } from './providers/detect';
 export { ClaudeCodeProvider } from './providers/claudeCode';
 export { OpenCodeProvider, getOpenCodeDataDir } from './providers/openCode';
-export { CodexProvider } from './providers/codex';
+export { CodexProvider, findCodexRolloutFile } from './providers/codex';
+export type { FindCodexRolloutFileOptions } from './providers/codex';
 export { JsonlParser, TRUNCATION_PATTERNS } from './parsers/jsonl';
 export type { RawSessionEvent, JsonlParserCallbacks, JsonlParserOptions } from './parsers/jsonl';
 export { normalizeToolName, normalizeToolInput, detectPlanModeFromText, convertOpenCodeMessage, parseDbMessageData, parseDbPartData, } from './parsers/openCodeParser';
@@ -61,6 +62,12 @@ export type { SessionActivityState, SessionActivityResult, } from './parsers/ses
 export { encodeWorkspacePath as encodeClaudeWorkspacePath, getSessionDirectory as getClaudeSessionDirectory, discoverSessionDirectory, findActiveSession as findActiveClaudeSession, findAllSessions as findAllClaudeSessions, findSessionsInDirectory, findSubdirectorySessionDirs, getMostRecentlyActiveSessionDir, decodeEncodedPath, getAllProjectFolders as getAllClaudeProjectFolders, resolveWorktreeMainRepo, discoverWorktreeSiblings, findAllSessionsWithWorktrees, } from './parsers/sessionPathResolver';
 export { scanSubagentTraces } from './parsers/subagentTraceParser';
 export type { SubagentTrace, SubagentTraceEvent } from './parsers/subagentTraceParser';
+export { parseMcpToolName } from './parsers/mcpToolName';
+export type { McpToolNameParts } from './parsers/mcpToolName';
+export { readCodexHistory } from './parsers/codexHistory';
+export type { CodexHistoryEntry, ReadCodexHistoryOptions } from './parsers/codexHistory';
+export { listSessionPreviews, readSessionPreview } from './sessionPreviews';
+export type { ListSessionPreviewsOptions, ReadSessionPreviewOptions, SessionPreview, } from './sessionPreviews';
 export { parseDebugLog, filterByLevel, collapseDuplicates, discoverDebugLogs, } from './parsers/debugLogParser';
 export type { DebugLogEntry, DebugLogFile, DebugLogLevel } from './parsers/debugLogParser';
 export { OpenCodeDatabase } from './providers/openCodeDatabase';
@@ -126,7 +133,7 @@ export { ensureDefaultAccounts } from './ensureDefaultAccounts';
 export type { EnsureDefaultAccountStatus, EnsureDefaultAccountsOptions, EnsureDefaultAccountsResult, } from './ensureDefaultAccounts';
 export { readAccountRegistry, writeAccountRegistry, readActiveClaudeAccount, addCurrentAccount, switchToAccount, resolveActiveClaudeHome, applyActiveClaudeToLiveHome, reconcileClaudeAuthState, removeAccount, listAccounts, getActiveAccount, resolveActiveClaudeAccount, isMultiAccountEnabled, } from './accounts';
 export type { AccountEntry, AccountRegistry, ActiveAccountInfo, AccountManagerResult, } from './accounts';
-export { beginAccountLogin, getAccountLoginStatus, finalizeAccountLogin, spawnAccountLogin, switchAccount, listAllAccounts, resolveClaudeLoginCommand, } from './accountManager';
+export { beginAccountLogin, getAccountLoginStatus, getAccountLoginStatusAsync, finalizeAccountLogin, finalizeAccountLoginAsync, spawnAccountLogin, switchAccount, switchAccountAsync, listAllAccounts, resolveClaudeLoginCommand, } from './accountManager';
 export type { AccountLoginCommand, AccountLoginState, AccountLoginStatus, BeginAccountLoginResult, FinalizeAccountLoginOptions, ListAllAccountsResult, SpawnAccountLoginOptions, } from './accountManager';
 export { getAccountsDir, readSavedAccountRegistry, writeSavedAccountRegistry, listSavedAccountProfiles, getActiveSavedAccount, upsertSavedAccountProfile, setActiveSavedAccount, replaceSavedAccountProfiles, removeSavedAccountProfile, } from './accountRegistry';
 export type { AccountProviderId, AccountIdentityMetadata, ResolvedActiveAccount, SavedAccountProfile, SavedAccountRegistry, } from './accountRegistry';
@@ -134,7 +141,7 @@ export { getActiveAccountStatus } from './accountStatus';
 export type { ActiveAccountStatus, ActiveProviderAccountStatus } from './accountStatus';
 export { getClaudeProfilesDir, getClaudeProfileHome, claudeKeychainSuffix, claudeKeychainService, isClaudeProfileAuthenticated, readClaudeProfileIdentity, } from './claudeProfiles';
 export type { ClaudeProfileIdentity } from './claudeProfiles';
-export { getCodexProfilesDir, getCodexProfileHome, getCodexMonitoringHomes, getSystemCodexHome, listCodexAccounts, getActiveCodexAccount, resolveActiveCodexAccount, resolveSidekickCodexHome, getCodexExecutionEnv, prepareCodexAccount, finalizeCodexAccount, switchToCodexAccount, removeCodexAccount, } from './codexProfiles';
+export { getCodexProfilesDir, getCodexProfileHome, getCodexMonitoringHomes, getSystemCodexHome, listCodexAccounts, getActiveCodexAccount, resolveActiveCodexAccount, resolveSidekickCodexHome, getCodexExecutionEnv, prepareCodexAccount, prepareCodexAccountAsync, finalizeCodexAccount, finalizeCodexAccountAsync, switchToCodexAccount, switchToCodexAccountAsync, removeCodexAccount, } from './codexProfiles';
 export type { CodexAccountManagerResult } from './codexProfiles';
 export { setTerminalActiveProfile, installShellHook, uninstallShellHook, isShellHookInstalled, writeLauncher, removeLauncher, } from './terminalSync';
 export { DEFAULT_AUTO_SWITCH_CONFIG, decideAutoSwitch, AutoSwitchController } from './autoSwitch';

package/dist/index.js

@@ -3,13 +3,14 @@
  * Public API for sidekick-shared.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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.setConfigDir = exports.getDefaultConfigDir = exports.getConfigDirOverride = exports.getConfigDir = exports.CONFIG_DIR_ENV_VAR = 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.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 = exports.addNote = exports.decisionFingerprint = exports.addDecision = exports.completeTask = void 0;
-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 = exports.createSessionContextProjector = exports.calculateSessionContextPressure = exports.buildSessionContextSnapshot = exports.composeContext = void 0;
-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 = exports.scoreSessionQuality = exports.calculateQualityTrend = exports.PatternExtractor = exports.HeatmapTracker = void 0;
-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 = exports.getCodexProfileHome = exports.getCodexProfilesDir = exports.readClaudeProfileIdentity = exports.isClaudeProfileAuthenticated = void 0;
-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.getObservedContextWindowPath = exports.recordObservedContextWindow = exports.loadObservedContextWindows = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmContextWindows = 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 = exports.selectStatuslineAccount = exports.formatStatusline = exports.estimateTimeToQuota = exports.BurnRateCalculator = void 0;
-exports.scopePeakHoursToSessionProvider = exports.isClaudeCodeSessionProvider = exports.fetchPeakHoursStatus = exports.DEFAULT_PEAK_HOURS_TIMEOUT_MS = 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 = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.codexResetCreditsSnapshotSchema = void 0;
+exports.updateJsonStoreAtomic = exports.atomicWriteFileSync = 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.setConfigDir = exports.getDefaultConfigDir = exports.getConfigDirOverride = exports.getConfigDir = exports.CONFIG_DIR_ENV_VAR = 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.readSessionPreview = exports.listSessionPreviews = exports.readCodexHistory = exports.parseMcpToolName = 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.findCodexRolloutFile = 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.withFileLockSync = exports.updateJsonStoreAtomicSync = void 0;
+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 = exports.createSessionContextProjector = exports.calculateSessionContextPressure = exports.buildSessionContextSnapshot = exports.composeContext = exports.FilterEngine = exports.searchSessions = exports.CodexDatabase = exports.OpenCodeDatabase = exports.discoverDebugLogs = exports.collapseDuplicates = exports.filterByLevel = exports.parseDebugLog = void 0;
+exports.writeSavedAccountRegistry = exports.readSavedAccountRegistry = exports.getAccountsDir = exports.resolveClaudeLoginCommand = exports.listAllAccounts = exports.switchAccountAsync = exports.switchAccount = exports.spawnAccountLogin = exports.finalizeAccountLoginAsync = exports.finalizeAccountLogin = exports.getAccountLoginStatusAsync = 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 = 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 = void 0;
+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.switchToCodexAccountAsync = exports.switchToCodexAccount = exports.finalizeCodexAccountAsync = exports.finalizeCodexAccount = exports.prepareCodexAccountAsync = 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 = void 0;
+exports.extractErrorMessage = exports.categorizeError = exports.gatherAssetsForCwd = exports.codexSessions = exports.readCodexAssets = exports.claudeSessions = exports.readClaudeAssets = exports.extractCommands = exports.extractFilePaths = exports.extractUrls = exports.extractTokenUsage = exports.getObservedContextWindowPath = exports.recordObservedContextWindow = exports.loadObservedContextWindows = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmContextWindows = 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 = 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 = void 0;
+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 = 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 = void 0;
+exports.scopePeakHoursToSessionProvider = exports.isClaudeCodeSessionProvider = exports.fetchPeakHoursStatus = exports.DEFAULT_PEAK_HOURS_TIMEOUT_MS = exports.createPeakHoursNotApplicableState = exports.runDoctor = exports.getSessionDiagnostics = 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; } });
@@ -81,7 +82,10 @@ Object.defineProperty(exports, "readClaudeCodePlanFiles", { enumerable: true, ge
 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; } });
+Object.defineProperty(exports, "atomicWriteFileSync", { enumerable: true, get: function () { return atomic_1.atomicWriteFileSync; } });
 Object.defineProperty(exports, "updateJsonStoreAtomic", { enumerable: true, get: function () { return atomic_1.updateJsonStoreAtomic; } });
+Object.defineProperty(exports, "updateJsonStoreAtomicSync", { enumerable: true, get: function () { return atomic_1.updateJsonStoreAtomicSync; } });
+Object.defineProperty(exports, "withFileLockSync", { enumerable: true, get: function () { return atomic_1.withFileLockSync; } });
 var tasks_2 = require("./writers/tasks");
 Object.defineProperty(exports, "addTask", { enumerable: true, get: function () { return tasks_2.addTask; } });
 Object.defineProperty(exports, "completeTask", { enumerable: true, get: function () { return tasks_2.completeTask; } });
@@ -105,6 +109,7 @@ Object.defineProperty(exports, "OpenCodeProvider", { enumerable: true, get: func
 Object.defineProperty(exports, "getOpenCodeDataDir", { enumerable: true, get: function () { return openCode_1.getOpenCodeDataDir; } });
 var codex_2 = require("./providers/codex");
 Object.defineProperty(exports, "CodexProvider", { enumerable: true, get: function () { return codex_2.CodexProvider; } });
+Object.defineProperty(exports, "findCodexRolloutFile", { enumerable: true, get: function () { return codex_2.findCodexRolloutFile; } });
 // Parsers — JSONL
 var jsonl_1 = require("./parsers/jsonl");
 Object.defineProperty(exports, "JsonlParser", { enumerable: true, get: function () { return jsonl_1.JsonlParser; } });
@@ -148,6 +153,16 @@ Object.defineProperty(exports, "findAllSessionsWithWorktrees", { enumerable: tru
 // Parsers — Subagent traces
 var subagentTraceParser_1 = require("./parsers/subagentTraceParser");
 Object.defineProperty(exports, "scanSubagentTraces", { enumerable: true, get: function () { return subagentTraceParser_1.scanSubagentTraces; } });
+// Parsers — MCP tool names
+var mcpToolName_1 = require("./parsers/mcpToolName");
+Object.defineProperty(exports, "parseMcpToolName", { enumerable: true, get: function () { return mcpToolName_1.parseMcpToolName; } });
+// Parsers — Codex native history
+var codexHistory_1 = require("./parsers/codexHistory");
+Object.defineProperty(exports, "readCodexHistory", { enumerable: true, get: function () { return codexHistory_1.readCodexHistory; } });
+// Session previews (bounded, stat-first)
+var sessionPreviews_1 = require("./sessionPreviews");
+Object.defineProperty(exports, "listSessionPreviews", { enumerable: true, get: function () { return sessionPreviews_1.listSessionPreviews; } });
+Object.defineProperty(exports, "readSessionPreview", { enumerable: true, get: function () { return sessionPreviews_1.readSessionPreview; } });
 // Parsers — Debug log parsing
 var debugLogParser_1 = require("./parsers/debugLogParser");
 Object.defineProperty(exports, "parseDebugLog", { enumerable: true, get: function () { return debugLogParser_1.parseDebugLog; } });
@@ -287,9 +302,12 @@ Object.defineProperty(exports, "isMultiAccountEnabled", { enumerable: true, get:
 var accountManager_1 = require("./accountManager");
 Object.defineProperty(exports, "beginAccountLogin", { enumerable: true, get: function () { return accountManager_1.beginAccountLogin; } });
 Object.defineProperty(exports, "getAccountLoginStatus", { enumerable: true, get: function () { return accountManager_1.getAccountLoginStatus; } });
+Object.defineProperty(exports, "getAccountLoginStatusAsync", { enumerable: true, get: function () { return accountManager_1.getAccountLoginStatusAsync; } });
 Object.defineProperty(exports, "finalizeAccountLogin", { enumerable: true, get: function () { return accountManager_1.finalizeAccountLogin; } });
+Object.defineProperty(exports, "finalizeAccountLoginAsync", { enumerable: true, get: function () { return accountManager_1.finalizeAccountLoginAsync; } });
 Object.defineProperty(exports, "spawnAccountLogin", { enumerable: true, get: function () { return accountManager_1.spawnAccountLogin; } });
 Object.defineProperty(exports, "switchAccount", { enumerable: true, get: function () { return accountManager_1.switchAccount; } });
+Object.defineProperty(exports, "switchAccountAsync", { enumerable: true, get: function () { return accountManager_1.switchAccountAsync; } });
 Object.defineProperty(exports, "listAllAccounts", { enumerable: true, get: function () { return accountManager_1.listAllAccounts; } });
 Object.defineProperty(exports, "resolveClaudeLoginCommand", { enumerable: true, get: function () { return accountManager_1.resolveClaudeLoginCommand; } });
 var accountRegistry_1 = require("./accountRegistry");
@@ -322,8 +340,11 @@ Object.defineProperty(exports, "resolveActiveCodexAccount", { enumerable: true,
 Object.defineProperty(exports, "resolveSidekickCodexHome", { enumerable: true, get: function () { return codexProfiles_1.resolveSidekickCodexHome; } });
 Object.defineProperty(exports, "getCodexExecutionEnv", { enumerable: true, get: function () { return codexProfiles_1.getCodexExecutionEnv; } });
 Object.defineProperty(exports, "prepareCodexAccount", { enumerable: true, get: function () { return codexProfiles_1.prepareCodexAccount; } });
+Object.defineProperty(exports, "prepareCodexAccountAsync", { enumerable: true, get: function () { return codexProfiles_1.prepareCodexAccountAsync; } });
 Object.defineProperty(exports, "finalizeCodexAccount", { enumerable: true, get: function () { return codexProfiles_1.finalizeCodexAccount; } });
+Object.defineProperty(exports, "finalizeCodexAccountAsync", { enumerable: true, get: function () { return codexProfiles_1.finalizeCodexAccountAsync; } });
 Object.defineProperty(exports, "switchToCodexAccount", { enumerable: true, get: function () { return codexProfiles_1.switchToCodexAccount; } });
+Object.defineProperty(exports, "switchToCodexAccountAsync", { enumerable: true, get: function () { return codexProfiles_1.switchToCodexAccountAsync; } });
 Object.defineProperty(exports, "removeCodexAccount", { enumerable: true, get: function () { return codexProfiles_1.removeCodexAccount; } });
 var terminalSync_1 = require("./terminalSync");
 Object.defineProperty(exports, "setTerminalActiveProfile", { enumerable: true, get: function () { return terminalSync_1.setTerminalActiveProfile; } });

package/dist/node.d.ts

@@ -11,5 +11,11 @@ export { loadObservedContextWindows, recordObservedContextWindow, getObservedCon
 export type { ObservedContextWindowOptions, ObservedContextWindowStore, } from './observedContextWindows';
 export { listRecentSessions, readSessionTranscript } from './sessionTranscripts';
 export type { ProviderSessionIndex, ListRecentSessionsOptions } from './sessionTranscripts';
+export { findCodexRolloutFile } from './providers/codex';
+export type { FindCodexRolloutFileOptions } from './providers/codex';
+export { readCodexHistory } from './parsers/codexHistory';
+export type { CodexHistoryEntry, ReadCodexHistoryOptions } from './parsers/codexHistory';
+export { listSessionPreviews, readSessionPreview } from './sessionPreviews';
+export type { ListSessionPreviewsOptions, ReadSessionPreviewOptions, SessionPreview, } from './sessionPreviews';
 export { ObservedSessionCollector, observedSessionSourceFromProvider, fileFingerprint, } from './observedSessionCollector';
 export type { ObservedSessionReference, ObservedSessionCollectionSource, ProviderObservedSessionCollectionSource, ObservedSessionDiagnosticKind, ObservedSessionDiagnostic, ObservedSessionCollection, ObservedSessionCollectorOptions, } from './observedSessionCollector';

package/dist/node.js

@@ -7,7 +7,7 @@
  * for browser bundles — use `sidekick-shared/browser` there.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fileFingerprint = exports.observedSessionSourceFromProvider = exports.ObservedSessionCollector = exports.readSessionTranscript = exports.listRecentSessions = exports.getObservedContextWindowPath = exports.recordObservedContextWindow = exports.loadObservedContextWindows = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmContextWindows = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = void 0;
+exports.fileFingerprint = exports.observedSessionSourceFromProvider = exports.ObservedSessionCollector = exports.readSessionPreview = exports.listSessionPreviews = exports.readCodexHistory = exports.findCodexRolloutFile = exports.readSessionTranscript = exports.listRecentSessions = exports.getObservedContextWindowPath = exports.recordObservedContextWindow = exports.loadObservedContextWindows = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmContextWindows = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = 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; } });
@@ -20,6 +20,13 @@ Object.defineProperty(exports, "getObservedContextWindowPath", { enumerable: tru
 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 codex_1 = require("./providers/codex");
+Object.defineProperty(exports, "findCodexRolloutFile", { enumerable: true, get: function () { return codex_1.findCodexRolloutFile; } });
+var codexHistory_1 = require("./parsers/codexHistory");
+Object.defineProperty(exports, "readCodexHistory", { enumerable: true, get: function () { return codexHistory_1.readCodexHistory; } });
+var sessionPreviews_1 = require("./sessionPreviews");
+Object.defineProperty(exports, "listSessionPreviews", { enumerable: true, get: function () { return sessionPreviews_1.listSessionPreviews; } });
+Object.defineProperty(exports, "readSessionPreview", { enumerable: true, get: function () { return sessionPreviews_1.readSessionPreview; } });
 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; } });

package/dist/observedContextWindows.d.ts

@@ -14,6 +14,19 @@
  * Precedence, most-trusted first: runtime → observed (here) → LiteLLM catalog →
  * static table. See `modelContext.ts`.
  *
+ * ## Where the store lives — two seams, one story
+ *
+ * Reader ({@link loadObservedContextWindows}) and writer
+ * ({@link recordObservedContextWindow}) resolve the store path identically:
+ * explicit `cacheDir` option → `setConfigDir()` / `SIDEKICK_CONFIG_DIR` (via
+ * `getConfigDir()`) → platform default. The global config-dir override is the
+ * deployment-level seam external consumers use to relocate every Sidekick
+ * store at once; the per-call `cacheDir` is the isolation seam for tests and
+ * multi-tenant hosts. Providers deliberately do NOT thread `cacheDir` —
+ * `CodexProvider` records observations with default options, which follow the
+ * global override, so a default-options load always sees what a
+ * default-options record wrote.
+ *
  * @module observedContextWindows
  */
 export interface ObservedContextWindowOptions {

package/dist/observedContextWindows.js

@@ -15,6 +15,19 @@
  * Precedence, most-trusted first: runtime → observed (here) → LiteLLM catalog →
  * static table. See `modelContext.ts`.
  *
+ * ## Where the store lives — two seams, one story
+ *
+ * Reader ({@link loadObservedContextWindows}) and writer
+ * ({@link recordObservedContextWindow}) resolve the store path identically:
+ * explicit `cacheDir` option → `setConfigDir()` / `SIDEKICK_CONFIG_DIR` (via
+ * `getConfigDir()`) → platform default. The global config-dir override is the
+ * deployment-level seam external consumers use to relocate every Sidekick
+ * store at once; the per-call `cacheDir` is the isolation seam for tests and
+ * multi-tenant hosts. Providers deliberately do NOT thread `cacheDir` —
+ * `CodexProvider` records observations with default options, which follow the
+ * global override, so a default-options load always sees what a
+ * default-options record wrote.
+ *
  * @module observedContextWindows
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {

package/dist/parsers/codexHistory.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Reader for Codex's append-only `~/.codex/history.jsonl` (Node-only).
+ *
+ * Each line is `{"session_id","ts","text"}` — one entry per user prompt. The
+ * file grows without bound, so this reader takes a bounded tail instead of the
+ * whole file, drops the leading partial line, and parses tolerantly. Pair an
+ * entry with {@link findCodexRolloutFile} (providers/codex) to jump from a
+ * history row to its full rollout transcript.
+ *
+ * @module codexHistory
+ */
+export interface CodexHistoryEntry {
+    sessionId: string;
+    /** Timestamp exactly as Codex recorded it (numeric epoch value). */
+    ts: number;
+    text: string;
+}
+export interface ReadCodexHistoryOptions {
+    /** Codex home containing `history.jsonl` (default: `$CODEX_HOME` or `~/.codex`). */
+    codexHome?: string;
+    /** Maximum entries returned, newest first (default 100). */
+    limit?: number;
+    /** Bytes read from the end of the file (default 512 KiB). */
+    maxTailBytes?: number;
+}
+/**
+ * Returns the newest history entries, newest first. A missing or unreadable
+ * file yields `[]`; malformed lines are skipped. Never throws.
+ */
+export declare function readCodexHistory(options?: ReadCodexHistoryOptions): CodexHistoryEntry[];

package/dist/parsers/codexHistory.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Reader for Codex's append-only `~/.codex/history.jsonl` (Node-only).
+ *
+ * Each line is `{"session_id","ts","text"}` — one entry per user prompt. The
+ * file grows without bound, so this reader takes a bounded tail instead of the
+ * whole file, drops the leading partial line, and parses tolerantly. Pair an
+ * entry with {@link findCodexRolloutFile} (providers/codex) to jump from a
+ * history row to its full rollout transcript.
+ *
+ * @module codexHistory
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCodexHistory = readCodexHistory;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const codexProfiles_1 = require("../codexProfiles");
+const DEFAULT_LIMIT = 100;
+const DEFAULT_TAIL_BYTES = 512 * 1024;
+/**
+ * Returns the newest history entries, newest first. A missing or unreadable
+ * file yields `[]`; malformed lines are skipped. Never throws.
+ */
+function readCodexHistory(options = {}) {
+    const limit = Math.max(0, options.limit ?? DEFAULT_LIMIT);
+    const maxTailBytes = Math.max(1, options.maxTailBytes ?? DEFAULT_TAIL_BYTES);
+    const historyPath = path.join(options.codexHome ?? (0, codexProfiles_1.getSystemCodexHome)(), 'history.jsonl');
+    let descriptor;
+    try {
+        descriptor = fs.openSync(historyPath, 'r');
+    }
+    catch {
+        return [];
+    }
+    try {
+        const size = fs.fstatSync(descriptor).size;
+        const readBytes = Math.min(size, maxTailBytes);
+        const buffer = Buffer.alloc(readBytes);
+        fs.readSync(descriptor, buffer, 0, readBytes, size - readBytes);
+        let content = buffer.toString('utf8');
+        if (readBytes < size) {
+            // The tail almost certainly starts mid-line; a multibyte character
+            // straddling the boundary decodes as replacement garbage inside that
+            // same partial line, so dropping through the first newline handles both.
+            const firstNewline = content.indexOf('\n');
+            content = firstNewline === -1 ? '' : content.slice(firstNewline + 1);
+        }
+        const entries = [];
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(trimmed);
+            }
+            catch {
+                continue;
+            }
+            if (typeof parsed.session_id !== 'string' ||
+                typeof parsed.ts !== 'number' ||
+                // JSON.parse('1e400') yields Infinity, which would later RangeError
+                // out of Date serialization in consumers.
+                !Number.isFinite(parsed.ts) ||
+                typeof parsed.text !== 'string') {
+                continue;
+            }
+            entries.push({ sessionId: parsed.session_id, ts: parsed.ts, text: parsed.text });
+        }
+        // The file is append-only, so on-disk order is oldest first.
+        entries.reverse();
+        return entries.slice(0, limit);
+    }
+    catch {
+        return [];
+    }
+    finally {
+        try {
+            fs.closeSync(descriptor);
+        }
+        catch {
+            // Already closed or invalid; nothing to release.
+        }
+    }
+}

package/dist/parsers/mcpToolName.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Claude Code exposes MCP tools under composite identifiers of the form
+ * `mcp__<server>__<tool>`. Splitting them correctly is subtle enough that
+ * consumers keep re-implementing it by hand (usually with a plain
+ * `split('__')`, which mangles server names containing single underscores).
+ * This module is the canonical splitter. Browser-safe: no Node imports.
+ *
+ * @module mcpToolName
+ */
+export interface McpToolNameParts {
+    serverName: string;
+    toolName: string;
+}
+/**
+ * Splits a Claude Code MCP tool identifier `mcp__<server>__<tool>` into parts.
+ *
+ * The server name ends at the first double underscore after the prefix, so
+ * single underscores stay inside it (`mcp__plugin_context7_context7__query-docs`
+ * → server `plugin_context7_context7`) and the tool keeps any further double
+ * underscores (`mcp__a__b__c` → tool `b__c`).
+ *
+ * Returns `null` for anything that is not a well-formed MCP tool id: a
+ * non-`mcp__` name, a missing or empty server or tool part, or a
+ * case-mismatched prefix. No trimming is applied.
+ */
+export declare function parseMcpToolName(name: string): McpToolNameParts | null;

package/dist/parsers/mcpToolName.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Claude Code exposes MCP tools under composite identifiers of the form
+ * `mcp__<server>__<tool>`. Splitting them correctly is subtle enough that
+ * consumers keep re-implementing it by hand (usually with a plain
+ * `split('__')`, which mangles server names containing single underscores).
+ * This module is the canonical splitter. Browser-safe: no Node imports.
+ *
+ * @module mcpToolName
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMcpToolName = parseMcpToolName;
+const MCP_TOOL_NAME_PATTERN = /^mcp__([^_]+(?:_[^_]+)*)__(.+)$/;
+/**
+ * Splits a Claude Code MCP tool identifier `mcp__<server>__<tool>` into parts.
+ *
+ * The server name ends at the first double underscore after the prefix, so
+ * single underscores stay inside it (`mcp__plugin_context7_context7__query-docs`
+ * → server `plugin_context7_context7`) and the tool keeps any further double
+ * underscores (`mcp__a__b__c` → tool `b__c`).
+ *
+ * Returns `null` for anything that is not a well-formed MCP tool id: a
+ * non-`mcp__` name, a missing or empty server or tool part, or a
+ * case-mismatched prefix. No trimming is applied.
+ */
+function parseMcpToolName(name) {
+    const match = MCP_TOOL_NAME_PATTERN.exec(name);
+    if (!match)
+        return null;
+    return { serverName: match[1], toolName: match[2] };
+}

package/dist/parsers/sessionPathResolver.d.ts

@@ -11,10 +11,17 @@
  */
 import type { ProjectFolderInfo } from '../providers/types';
 /**
- * Encodes a workspace path to Claude Code's directory naming scheme.
- *
- * Claude Code replaces path separators, colons, and underscores with hyphens
- * to create a flat directory structure.
+ * Encodes a workspace path to Claude Code's on-disk directory naming scheme
+ * under `~/.claude/projects/` — every non-ASCII-alphanumeric character
+ * (separators, colons, underscores, dots, spaces) becomes a hyphen, and case
+ * is preserved. Exported from the package root as `encodeClaudeWorkspacePath`.
+ *
+ * Not to be confused with the top-level `encodeWorkspacePath` export from
+ * `paths.ts`: that one is Sidekick's own config-store slug (it keeps dots) and
+ * does NOT match Claude Code's scheme — using it to build a
+ * `~/.claude/projects/` path silently misses for any workspace containing a
+ * dot or space. For lookups, prefer `getClaudeSessionDirectory` or the
+ * mismatch-tolerant `discoverSessionDirectory` over raw string encoding.
  *
  * @param workspacePath - Absolute path to workspace directory
  * @returns Encoded path string (e.g., "-home-user-code-project")

package/dist/parsers/sessionPathResolver.js

@@ -61,10 +61,17 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 /**
- * Encodes a workspace path to Claude Code's directory naming scheme.
- *
- * Claude Code replaces path separators, colons, and underscores with hyphens
- * to create a flat directory structure.
+ * Encodes a workspace path to Claude Code's on-disk directory naming scheme
+ * under `~/.claude/projects/` — every non-ASCII-alphanumeric character
+ * (separators, colons, underscores, dots, spaces) becomes a hyphen, and case
+ * is preserved. Exported from the package root as `encodeClaudeWorkspacePath`.
+ *
+ * Not to be confused with the top-level `encodeWorkspacePath` export from
+ * `paths.ts`: that one is Sidekick's own config-store slug (it keeps dots) and
+ * does NOT match Claude Code's scheme — using it to build a
+ * `~/.claude/projects/` path silently misses for any workspace containing a
+ * dot or space. For lookups, prefer `getClaudeSessionDirectory` or the
+ * mismatch-tolerant `discoverSessionDirectory` over raw string encoding.
  *
  * @param workspacePath - Absolute path to workspace directory
  * @returns Encoded path string (e.g., "-home-user-code-project")

package/dist/paths.d.ts

@@ -54,10 +54,14 @@ export declare function getProjectDataPath(slug: string, subdomain: string): str
  */
 export declare function getGlobalDataPath(filename: string): string;
 /**
- * Encodes a workspace path to Claude Code's directory naming scheme.
- * Replaces path separators, colons, and underscores with hyphens.
+ * Encodes a workspace path into Sidekick's own config-store slug — path
+ * separators, colons, and underscores become hyphens, dots are kept.
  *
- * From: sidekick-vscode/src/services/SessionPathResolver.ts:35-43
+ * This is NOT Claude Code's `~/.claude/projects/` naming scheme, despite the
+ * shared name: Claude Code also replaces dots, spaces, and every other
+ * non-alphanumeric character. To locate Claude Code session directories use
+ * `encodeClaudeWorkspacePath` / `getClaudeSessionDirectory` from
+ * `parsers/sessionPathResolver` instead.
  */
 export declare function encodeWorkspacePath(workspacePath: string): string;
 /**

package/dist/paths.js

@@ -129,10 +129,14 @@ function getGlobalDataPath(filename) {
     return path.join(getConfigDir(), filename);
 }
 /**
- * Encodes a workspace path to Claude Code's directory naming scheme.
- * Replaces path separators, colons, and underscores with hyphens.
+ * Encodes a workspace path into Sidekick's own config-store slug — path
+ * separators, colons, and underscores become hyphens, dots are kept.
  *
- * From: sidekick-vscode/src/services/SessionPathResolver.ts:35-43
+ * This is NOT Claude Code's `~/.claude/projects/` naming scheme, despite the
+ * shared name: Claude Code also replaces dots, spaces, and every other
+ * non-alphanumeric character. To locate Claude Code session directories use
+ * `encodeClaudeWorkspacePath` / `getClaudeSessionDirectory` from
+ * `parsers/sessionPathResolver` instead.
  */
 function encodeWorkspacePath(workspacePath) {
     const normalized = workspacePath.replace(/\\/g, '/');

package/dist/providers/claudeCode.d.ts

@@ -9,7 +9,7 @@
  */
 import type { ReadSessionContextSnapshotOptions, SessionContextSnapshot } from '../context/sessionContext';
 import type { SubagentStats, TokenUsage } from '../types/sessionEvent';
-import type { SessionProviderBase, SessionReader, SessionFileStats, SearchHit, ProjectFolderInfo, ProviderId } from './types';
+import type { SessionProviderBase, SessionReader, SessionFileInfo, SessionFileStats, SearchHit, ProjectFolderInfo, ProviderId } from './types';
 /**
  * Session provider for Claude Code CLI.
  *
@@ -30,6 +30,7 @@ export declare class ClaudeCodeProvider implements SessionProviderBase {
     findSessionFiles(workspacePath: string): string[];
     findSessionsInDirectory(dir: string): string[];
     getAllProjectFolders(workspacePath?: string): ProjectFolderInfo[];
+    listAllSessionFiles(): SessionFileInfo[];
     isSessionFile(filename: string): boolean;
     getSessionId(sessionPath: string): string;
     encodeWorkspacePath(workspacePath: string): string;

package/dist/providers/claudeCode.js

@@ -260,6 +260,24 @@ class ClaudeCodeProvider {
     getAllProjectFolders(workspacePath) {
         return (0, sessionPathResolver_1.getAllProjectFolders)(workspacePath);
     }
+    listAllSessionFiles() {
+        const results = [];
+        const seen = new Set();
+        for (const folder of this.getAllProjectFolders()) {
+            for (const sessionPath of this.findSessionsInDirectory(folder.dir)) {
+                if (seen.has(sessionPath))
+                    continue;
+                seen.add(sessionPath);
+                try {
+                    results.push({ path: sessionPath, mtime: fs.statSync(sessionPath).mtime });
+                }
+                catch {
+                    // Skip files that vanish between listing and stat.
+                }
+            }
+        }
+        return results;
+    }
     // --- File identification ---
     isSessionFile(filename) {
         return filename.endsWith('.jsonl');