sidekick-shared 0.24.2 → 0.24.4

package/dist/index.js

@@ -3,13 +3,13 @@
  * Public API for sidekick-shared.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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.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.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 = 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 = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = void 0;
+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;
 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; } });
@@ -47,7 +47,11 @@ Object.defineProperty(exports, "PLAN_SCHEMA_VERSION", { enumerable: true, get: f
 Object.defineProperty(exports, "MAX_PLANS_PER_PROJECT", { enumerable: true, get: function () { return plan_1.MAX_PLANS_PER_PROJECT; } });
 // Paths
 var paths_1 = require("./paths");
+Object.defineProperty(exports, "CONFIG_DIR_ENV_VAR", { enumerable: true, get: function () { return paths_1.CONFIG_DIR_ENV_VAR; } });
 Object.defineProperty(exports, "getConfigDir", { enumerable: true, get: function () { return paths_1.getConfigDir; } });
+Object.defineProperty(exports, "getConfigDirOverride", { enumerable: true, get: function () { return paths_1.getConfigDirOverride; } });
+Object.defineProperty(exports, "getDefaultConfigDir", { enumerable: true, get: function () { return paths_1.getDefaultConfigDir; } });
+Object.defineProperty(exports, "setConfigDir", { enumerable: true, get: function () { return paths_1.setConfigDir; } });
 Object.defineProperty(exports, "getProjectDataPath", { enumerable: true, get: function () { return paths_1.getProjectDataPath; } });
 Object.defineProperty(exports, "getGlobalDataPath", { enumerable: true, get: function () { return paths_1.getGlobalDataPath; } });
 Object.defineProperty(exports, "encodeWorkspacePath", { enumerable: true, get: function () { return paths_1.encodeWorkspacePath; } });
@@ -494,6 +498,7 @@ Object.defineProperty(exports, "runDoctor", { enumerable: true, get: function ()
 // Peak Hours (PromoClock — third-party)
 var peakHours_1 = require("./peakHours");
 Object.defineProperty(exports, "createPeakHoursNotApplicableState", { enumerable: true, get: function () { return peakHours_1.createPeakHoursNotApplicableState; } });
+Object.defineProperty(exports, "DEFAULT_PEAK_HOURS_TIMEOUT_MS", { enumerable: true, get: function () { return peakHours_1.DEFAULT_PEAK_HOURS_TIMEOUT_MS; } });
 Object.defineProperty(exports, "fetchPeakHoursStatus", { enumerable: true, get: function () { return peakHours_1.fetchPeakHoursStatus; } });
 Object.defineProperty(exports, "isClaudeCodeSessionProvider", { enumerable: true, get: function () { return peakHours_1.isClaudeCodeSessionProvider; } });
 Object.defineProperty(exports, "scopePeakHoursToSessionProvider", { enumerable: true, get: function () { return peakHours_1.scopePeakHoursToSessionProvider; } });

package/dist/modelContext.js

@@ -63,6 +63,7 @@ const MODEL_CONTEXT_SIZES = {
     // observed-override layer.
     'gpt-5.6-sol': 1_050_000,
     'gpt-5.6-terra': 1_050_000,
+    'gpt-5.6-luna': 1_050_000,
     'gpt-5.6': 1_050_000,
     'gpt-5.5': 1_050_000,
     'gpt-5.4': 1_050_000,

package/dist/modelInfo.js

@@ -78,11 +78,14 @@ const PRICING_TABLE = {
     },
     // Sonnet 5 carries the standard rate here. The introductory $2/$10 (through
     // 2026-08-31) arrives via catalog hydration, which supersedes this baseline.
+    // Sonnet 5 is $2/$10, not the $3/$15 every earlier Sonnet charged, and it
+    // carries no >200K surcharge the way Sonnet 4.5 does. The catalog agrees
+    // across all eleven of its Sonnet 5 entries.
     'claude-sonnet-5': {
-        inputCostPerMillion: 3.0,
-        outputCostPerMillion: 15.0,
-        cacheWriteCostPerMillion: 3.75,
-        cacheReadCostPerMillion: 0.3,
+        inputCostPerMillion: 2.0,
+        outputCostPerMillion: 10.0,
+        cacheWriteCostPerMillion: 2.5,
+        cacheReadCostPerMillion: 0.2,
     },
     'claude-sonnet-4-6': {
         inputCostPerMillion: 3.0,
@@ -176,6 +179,21 @@ const PRICING_TABLE = {
         cacheReadCostPerMillion: 1.5,
     },
     // ── OpenAI: GPT-4.x family ──
+    // The `-tts`, `-transcribe`, and `-realtime-preview` variants also bill above
+    // the key they inherit, but no coding agent routes to them, so they are left
+    // out rather than carried here. Catalog hydration still prices them correctly.
+    'gpt-4.1-mini': {
+        inputCostPerMillion: 0.4,
+        outputCostPerMillion: 1.6,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0.1,
+    },
+    'gpt-4.1-nano': {
+        inputCostPerMillion: 0.1,
+        outputCostPerMillion: 0.4,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0.025,
+    },
     'gpt-4.1': {
         inputCostPerMillion: 2.0,
         outputCostPerMillion: 8.0,
@@ -188,6 +206,14 @@ const PRICING_TABLE = {
         cacheWriteCostPerMillion: 0,
         cacheReadCostPerMillion: 0.075,
     },
+    // The launch snapshot kept its original $5/$15 when gpt-4o was cut to
+    // $2.50/$10, so a pinned id must not read the current rate.
+    'gpt-4o-2024-05-13': {
+        inputCostPerMillion: 5.0,
+        outputCostPerMillion: 15.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0,
+    },
     'gpt-4o': {
         inputCostPerMillion: 2.5,
         outputCostPerMillion: 10.0,
@@ -202,8 +228,12 @@ const PRICING_TABLE = {
     },
     // ── OpenAI: GPT-5 family ──
     // Published rates, verified against the LiteLLM catalog. Runtime hydration
-    // still supersedes these; they are the offline baseline. Entries below
-    // `gpt-5.4` predate the published-rate pass and remain rough estimates.
+    // still supersedes these; they are the offline baseline.
+    //
+    // Every tier that ships at a rate of its own needs an entry of its own. Keys
+    // are matched longest-first, so a `-mini`/`-nano`/`-pro` variant with no entry
+    // silently inherits its base model's rate and reports a wrong number rather
+    // than none — `gpt-5-nano` read 25x its true cost this way.
     'gpt-5.6-sol': {
         inputCostPerMillion: 5.0,
         outputCostPerMillion: 30.0,
@@ -216,12 +246,24 @@ const PRICING_TABLE = {
         cacheWriteCostPerMillion: 3.13,
         cacheReadCostPerMillion: 0.25,
     },
+    'gpt-5.6-luna': {
+        inputCostPerMillion: 1.0,
+        outputCostPerMillion: 6.0,
+        cacheWriteCostPerMillion: 1.25,
+        cacheReadCostPerMillion: 0.1,
+    },
     'gpt-5.6': {
         inputCostPerMillion: 5.0,
         outputCostPerMillion: 30.0,
         cacheWriteCostPerMillion: 6.25,
         cacheReadCostPerMillion: 0.5,
     },
+    'gpt-5.5-pro': {
+        inputCostPerMillion: 30.0,
+        outputCostPerMillion: 180.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 3.0,
+    },
     'gpt-5.5': {
         inputCostPerMillion: 5.0,
         outputCostPerMillion: 30.0,
@@ -234,6 +276,18 @@ const PRICING_TABLE = {
         cacheWriteCostPerMillion: 0,
         cacheReadCostPerMillion: 0.07,
     },
+    'gpt-5.4-nano': {
+        inputCostPerMillion: 0.2,
+        outputCostPerMillion: 1.25,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0.02,
+    },
+    'gpt-5.4-pro': {
+        inputCostPerMillion: 30.0,
+        outputCostPerMillion: 180.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 3.0,
+    },
     'gpt-5.4': {
         inputCostPerMillion: 2.5,
         outputCostPerMillion: 15.0,
@@ -241,17 +295,63 @@ const PRICING_TABLE = {
         cacheReadCostPerMillion: 0.25,
     },
     'gpt-5.3-codex': {
-        inputCostPerMillion: 1.25,
-        outputCostPerMillion: 10.0,
+        inputCostPerMillion: 1.75,
+        outputCostPerMillion: 14.0,
         cacheWriteCostPerMillion: 0,
-        cacheReadCostPerMillion: 0.125,
+        cacheReadCostPerMillion: 0.175,
+    },
+    'gpt-5.3-chat-latest': {
+        inputCostPerMillion: 1.75,
+        outputCostPerMillion: 14.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0.175,
     },
+    // No bare `gpt-5.3` ships in the catalog; both real variants above are
+    // $1.75/$14. This entry stays an estimate and only answers ids that match
+    // neither variant.
     'gpt-5.3': {
         inputCostPerMillion: 1.25,
         outputCostPerMillion: 10.0,
         cacheWriteCostPerMillion: 0,
         cacheReadCostPerMillion: 0.125,
     },
+    'gpt-5.2-pro': {
+        inputCostPerMillion: 21.0,
+        outputCostPerMillion: 168.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0,
+    },
+    // Also answers `gpt-5.2-codex` and `gpt-5.2-chat*`, which bill at this rate.
+    'gpt-5.2': {
+        inputCostPerMillion: 1.75,
+        outputCostPerMillion: 14.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0.175,
+    },
+    'gpt-5.1-codex-mini': {
+        inputCostPerMillion: 0.25,
+        outputCostPerMillion: 2.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0.025,
+    },
+    'gpt-5-pro': {
+        inputCostPerMillion: 15.0,
+        outputCostPerMillion: 120.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0,
+    },
+    'gpt-5-mini': {
+        inputCostPerMillion: 0.25,
+        outputCostPerMillion: 2.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0.025,
+    },
+    'gpt-5-nano': {
+        inputCostPerMillion: 0.05,
+        outputCostPerMillion: 0.4,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0.005,
+    },
     'gpt-5': {
         inputCostPerMillion: 1.25,
         outputCostPerMillion: 10.0,
@@ -259,23 +359,46 @@ const PRICING_TABLE = {
         cacheReadCostPerMillion: 0.125,
     },
     // ── OpenAI: o-series (reasoning models) ──
+    // The `-pro` and deep-research tiers cost an order of magnitude more than the
+    // base model whose key they would otherwise match.
+    'o3-deep-research': {
+        inputCostPerMillion: 10.0,
+        outputCostPerMillion: 40.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 2.5,
+    },
     'o3-mini': {
         inputCostPerMillion: 1.1,
         outputCostPerMillion: 4.4,
         cacheWriteCostPerMillion: 0,
         cacheReadCostPerMillion: 0.55,
     },
+    'o3-pro': {
+        inputCostPerMillion: 20.0,
+        outputCostPerMillion: 80.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0,
+    },
     o3: {
         inputCostPerMillion: 2.0,
         outputCostPerMillion: 8.0,
         cacheWriteCostPerMillion: 0,
         cacheReadCostPerMillion: 0.5,
     },
+    // OpenAI cut o1-mini to $1.10/$4.40 after launch; $3/$12 was the launch rate.
+    // No bare catalog key settles it — Azure's $1.21/$4.84 is its usual 1.1x
+    // uplift on exactly this number, and Replicate's OpenAI passthrough agrees.
     'o1-mini': {
-        inputCostPerMillion: 3.0,
-        outputCostPerMillion: 12.0,
+        inputCostPerMillion: 1.1,
+        outputCostPerMillion: 4.4,
         cacheWriteCostPerMillion: 0,
-        cacheReadCostPerMillion: 1.5,
+        cacheReadCostPerMillion: 0.55,
+    },
+    'o1-pro': {
+        inputCostPerMillion: 150.0,
+        outputCostPerMillion: 600.0,
+        cacheWriteCostPerMillion: 0,
+        cacheReadCostPerMillion: 0,
     },
     o1: {
         inputCostPerMillion: 15.0,
@@ -309,7 +432,12 @@ function _clearPricingOverrides() {
     overrideSortedKeys = [];
 }
 // ── Model ID Parsing ──
-const CLAUDE_RE = /^claude-(haiku|sonnet|opus|fable)-([0-9.]+)/i;
+// Anthropic writes the minor version with a hyphen in modern IDs
+// (`claude-sonnet-4-6-20260321`) and a dot in older ones
+// (`claude-sonnet-4.5-20241022`). Accept both, then normalize to a dot.
+// The `{1,2}` bound plus the trailing `(?![0-9])` keep the 8-digit release
+// date from being mistaken for a minor version in `claude-opus-4-20250514`.
+const CLAUDE_RE = /^claude-(haiku|sonnet|opus|fable)-([0-9]+(?:[-.][0-9]{1,2})?)(?![0-9])/i;
 const LEGACY_CLAUDE_RE = /^claude-([0-9]+(?:[-.][0-9]+)?)-(haiku|sonnet|opus)(?:-|$)/i;
 const GPT_RE = /^gpt-([0-9][0-9.A-Za-z-]*)/i;
 const O_SERIES_RE = /^o([0-9]+)(-mini|-pro)?/i;
@@ -332,7 +460,11 @@ function parseModelId(modelId) {
         .toLowerCase();
     const claude = normalized.match(CLAUDE_RE);
     if (claude) {
-        return { provider: 'anthropic', family: claude[1].toLowerCase(), version: claude[2] };
+        return {
+            provider: 'anthropic',
+            family: claude[1].toLowerCase(),
+            version: claude[2].replace('-', '.'),
+        };
     }
     const legacyClaude = normalized.match(LEGACY_CLAUDE_RE);
     if (legacyClaude) {

package/dist/observedContextWindows.d.ts

@@ -33,6 +33,8 @@ export interface ObservedContextWindowStore {
 }
 /** Resolve the on-disk store path. */
 export declare function getObservedContextWindowPath(cacheDir?: string): string;
+/** Reset the per-store write dedupe. Test-only; not part of the public API. */
+export declare function _clearObservedContextWindowWriteCache(): void;
 /**
  * Load persisted observations and apply them as context-window overrides.
  *
@@ -44,11 +46,12 @@ export declare function loadObservedContextWindows(options?: ObservedContextWind
  * Record a provider-reported context window for a model.
  *
  * Applies in memory immediately, then persists — but only when the value
- * actually changed. Codex reports a window on every `token_count` event, so an
- * unconditional write would mean disk I/O many times per session for a value
- * that almost never moves.
+ * actually changed *for that store*. Codex reports a window on every
+ * `token_count` event, so an unconditional write would mean disk I/O many times
+ * per session for a value that almost never moves.
  *
  * Always resolves — never throws. Persistence failures are logged and dropped;
- * the in-memory override still stands for this process.
+ * the in-memory override still stands for this process, and the next call
+ * retries the write.
  */
 export declare function recordObservedContextWindow(modelId: string, contextWindow: number, options?: ObservedContextWindowOptions): Promise<void>;

package/dist/observedContextWindows.js

@@ -52,6 +52,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getObservedContextWindowPath = getObservedContextWindowPath;
+exports._clearObservedContextWindowWriteCache = _clearObservedContextWindowWriteCache;
 exports.loadObservedContextWindows = loadObservedContextWindows;
 exports.recordObservedContextWindow = recordObservedContextWindow;
 const node_fs_1 = require("node:fs");
@@ -69,6 +70,21 @@ function getObservedContextWindowPath(cacheDir) {
 function emptyStore() {
     return { version: STORE_VERSION, models: {} };
 }
+/**
+ * Last value successfully persisted, per resolved store path.
+ *
+ * The in-memory override table in `modelContext` is process-global by design —
+ * a lookup should answer the same way everywhere. That makes it unusable as the
+ * write dedupe: with two `cacheDir`s in one process (two temp dirs in a test
+ * suite, a multi-tenant host, a CLI and extension host sharing a process), the
+ * global would already hold the value from the first store and the second store
+ * would never be written at all.
+ */
+const lastPersistedByStore = new Map();
+/** Reset the per-store write dedupe. Test-only; not part of the public API. */
+function _clearObservedContextWindowWriteCache() {
+    lastPersistedByStore.clear();
+}
 /** Keep only well-formed entries; a hand-edited or partly-corrupt file shouldn't poison lookups. */
 function toOverrideMap(store) {
     const out = {};
@@ -110,12 +126,13 @@ async function loadObservedContextWindows(options = {}) {
  * Record a provider-reported context window for a model.
  *
  * Applies in memory immediately, then persists — but only when the value
- * actually changed. Codex reports a window on every `token_count` event, so an
- * unconditional write would mean disk I/O many times per session for a value
- * that almost never moves.
+ * actually changed *for that store*. Codex reports a window on every
+ * `token_count` event, so an unconditional write would mean disk I/O many times
+ * per session for a value that almost never moves.
  *
  * Always resolves — never throws. Persistence failures are logged and dropped;
- * the in-memory override still stands for this process.
+ * the in-memory override still stands for this process, and the next call
+ * retries the write.
  */
 async function recordObservedContextWindow(modelId, contextWindow, options = {}) {
     const normalizedId = modelId?.trim().toLowerCase();
@@ -124,10 +141,13 @@ async function recordObservedContextWindow(modelId, contextWindow, options = {})
     if (!Number.isFinite(contextWindow) || contextWindow <= 0)
         return;
     const current = (0, modelContext_1._getObservedContextWindows)();
-    if (current[normalizedId] === contextWindow)
-        return;
-    (0, modelContext_1._setObservedContextWindows)({ ...current, [normalizedId]: contextWindow });
+    if (current[normalizedId] !== contextWindow) {
+        (0, modelContext_1._setObservedContextWindows)({ ...current, [normalizedId]: contextWindow });
+    }
     const storePath = getObservedContextWindowPath(options.cacheDir);
+    const persisted = lastPersistedByStore.get(storePath);
+    if (persisted?.get(normalizedId) === contextWindow)
+        return;
     try {
         // Lock-guarded read-modify-write: the CLI and the extension host can both
         // be observing sessions at once, and each should merge rather than clobber.
@@ -143,6 +163,13 @@ async function recordObservedContextWindow(modelId, contextWindow, options = {})
                 },
             };
         });
+        // Recorded only on success, so a transient EACCES retries next time.
+        let store = lastPersistedByStore.get(storePath);
+        if (!store) {
+            store = new Map();
+            lastPersistedByStore.set(storePath, store);
+        }
+        store.set(normalizedId, contextWindow);
     }
     catch (err) {
         options.logger?.(`observedContextWindows: failed to persist ${storePath}: ${String(err)}`);

package/dist/paths.d.ts

@@ -3,9 +3,44 @@
  * Mirrors patterns from sidekick-vscode/src/services/SessionPathResolver.ts
  * and TaskPersistenceService.ts
  */
+/** Environment variable that redirects the Sidekick config root. */
+export declare const CONFIG_DIR_ENV_VAR = "SIDEKICK_CONFIG_DIR";
+/**
+ * The platform default config directory, ignoring both {@link setConfigDir}
+ * and `SIDEKICK_CONFIG_DIR`.
+ *
+ * `~/.config/sidekick` on Unix, `%APPDATA%/sidekick` on Windows.
+ */
+export declare function getDefaultConfigDir(): string;
+/**
+ * Redirect the Sidekick config root for this process.
+ *
+ * Takes precedence over `SIDEKICK_CONFIG_DIR`. Pass `null` (or an empty
+ * string) to clear it. Every reader and writer in the package resolves the
+ * root lazily through {@link getConfigDir}, so this takes effect immediately
+ * for all of them — including transitive callers of `getProjectDataPath`,
+ * `getGlobalDataPath`, and the account registry.
+ *
+ * Prefer `SIDEKICK_CONFIG_DIR` when the value is known before the process
+ * starts: it is read fresh on every call, so it stays correct even if a
+ * bundler ends up with more than one copy of this module.
+ *
+ * @example
+ * setConfigDir(path.join(os.tmpdir(), 'sidekick-fixture'));
+ * try {
+ *   await addTask(project, { subject: 'isolated' });
+ * } finally {
+ *   setConfigDir(null);
+ * }
+ */
+export declare function setConfigDir(dir: string | null | undefined): void;
+/** The active {@link setConfigDir} override, or `null` when unset. */
+export declare function getConfigDirOverride(): string | null;
 /**
  * Gets the Sidekick config directory.
- * ~/.config/sidekick on Unix, %APPDATA%/sidekick on Windows.
+ *
+ * Resolution order: {@link setConfigDir} override → `SIDEKICK_CONFIG_DIR`
+ * → {@link getDefaultConfigDir}.
  */
 export declare function getConfigDir(): string;
 /**

package/dist/paths.js

@@ -38,6 +38,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_DIR_ENV_VAR = void 0;
+exports.getDefaultConfigDir = getDefaultConfigDir;
+exports.setConfigDir = setConfigDir;
+exports.getConfigDirOverride = getConfigDirOverride;
 exports.getConfigDir = getConfigDir;
 exports.getProjectDataPath = getProjectDataPath;
 exports.getGlobalDataPath = getGlobalDataPath;
@@ -48,16 +52,68 @@ exports.getProjectSlugRaw = getProjectSlugRaw;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
+/** Environment variable that redirects the Sidekick config root. */
+exports.CONFIG_DIR_ENV_VAR = 'SIDEKICK_CONFIG_DIR';
+let configDirOverride = null;
 /**
- * Gets the Sidekick config directory.
- * ~/.config/sidekick on Unix, %APPDATA%/sidekick on Windows.
+ * The platform default config directory, ignoring both {@link setConfigDir}
+ * and `SIDEKICK_CONFIG_DIR`.
+ *
+ * `~/.config/sidekick` on Unix, `%APPDATA%/sidekick` on Windows.
  */
-function getConfigDir() {
+function getDefaultConfigDir() {
     if (process.platform === 'win32') {
         return path.join(process.env.APPDATA || os.homedir(), 'sidekick');
     }
     return path.join(os.homedir(), '.config', 'sidekick');
 }
+/**
+ * Redirect the Sidekick config root for this process.
+ *
+ * Takes precedence over `SIDEKICK_CONFIG_DIR`. Pass `null` (or an empty
+ * string) to clear it. Every reader and writer in the package resolves the
+ * root lazily through {@link getConfigDir}, so this takes effect immediately
+ * for all of them — including transitive callers of `getProjectDataPath`,
+ * `getGlobalDataPath`, and the account registry.
+ *
+ * Prefer `SIDEKICK_CONFIG_DIR` when the value is known before the process
+ * starts: it is read fresh on every call, so it stays correct even if a
+ * bundler ends up with more than one copy of this module.
+ *
+ * @example
+ * setConfigDir(path.join(os.tmpdir(), 'sidekick-fixture'));
+ * try {
+ *   await addTask(project, { subject: 'isolated' });
+ * } finally {
+ *   setConfigDir(null);
+ * }
+ */
+function setConfigDir(dir) {
+    // Resolve the trimmed value, not the original: `path.resolve('  /tmp/x  ')`
+    // treats the leading spaces as a relative segment and lands under cwd. The
+    // `SIDEKICK_CONFIG_DIR` branch in getConfigDir() already trims, and the two
+    // routes are documented as interchangeable.
+    const trimmed = dir?.trim();
+    configDirOverride = trimmed ? path.resolve(trimmed) : null;
+}
+/** The active {@link setConfigDir} override, or `null` when unset. */
+function getConfigDirOverride() {
+    return configDirOverride;
+}
+/**
+ * Gets the Sidekick config directory.
+ *
+ * Resolution order: {@link setConfigDir} override → `SIDEKICK_CONFIG_DIR`
+ * → {@link getDefaultConfigDir}.
+ */
+function getConfigDir() {
+    if (configDirOverride)
+        return configDirOverride;
+    const fromEnv = process.env[exports.CONFIG_DIR_ENV_VAR]?.trim();
+    if (fromEnv)
+        return path.resolve(fromEnv);
+    return getDefaultConfigDir();
+}
 /**
  * Gets the path to a project-specific data file.
  * e.g., ~/.config/sidekick/tasks/my-project.json

package/dist/peakHours.d.ts

@@ -23,6 +23,16 @@ export interface PeakHoursState {
     unavailable: boolean;
     notApplicable?: boolean;
 }
+/** Default budget for the promoclock.co request, in milliseconds. */
+export declare const DEFAULT_PEAK_HOURS_TIMEOUT_MS = 10000;
+/** Options for {@link fetchPeakHoursStatus}. */
+export interface FetchPeakHoursOptions {
+    /**
+     * Abort the request after this many milliseconds.
+     * Defaults to {@link DEFAULT_PEAK_HOURS_TIMEOUT_MS}.
+     */
+    timeoutMs?: number;
+}
 export declare function isClaudeCodeSessionProvider(providerId: ProviderId): boolean;
 export declare function createPeakHoursNotApplicableState(providerId: ProviderId): PeakHoursState;
 export declare function scopePeakHoursToSessionProvider(providerId: ProviderId, status: PeakHoursState | null | undefined): PeakHoursState | null;
@@ -30,6 +40,10 @@ export declare function scopePeakHoursToSessionProvider(providerId: ProviderId,
  * Fetch current Claude peak-hours state from promoclock.co.
  *
  * Single-shot — caller wraps in polling loop, EventEmitter, or interval.
- * Returns `unavailable: true` on any network or parse error.
+ * Returns `unavailable: true` on any network, timeout, or parse error.
+ *
+ * promoclock.co is a third-party host, so the request is always bounded by
+ * an abort timeout. Without one a hung host would stall the caller — and
+ * this is polled, so the stall would repeat.
  */
-export declare function fetchPeakHoursStatus(): Promise<PeakHoursState>;
+export declare function fetchPeakHoursStatus(options?: FetchPeakHoursOptions): Promise<PeakHoursState>;

package/dist/peakHours.js

@@ -11,11 +11,14 @@
  * Polling / eventing is the caller's responsibility.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PEAK_HOURS_TIMEOUT_MS = void 0;
 exports.isClaudeCodeSessionProvider = isClaudeCodeSessionProvider;
 exports.createPeakHoursNotApplicableState = createPeakHoursNotApplicableState;
 exports.scopePeakHoursToSessionProvider = scopePeakHoursToSessionProvider;
 exports.fetchPeakHoursStatus = fetchPeakHoursStatus;
 const PROMOCLOCK_ENDPOINT = 'https://promoclock.co/api/status';
+/** Default budget for the promoclock.co request, in milliseconds. */
+exports.DEFAULT_PEAK_HOURS_TIMEOUT_MS = 10_000;
 function unavailableState() {
     return {
         status: 'unknown',
@@ -73,11 +76,19 @@ function normalizeSpeed(raw) {
  * Fetch current Claude peak-hours state from promoclock.co.
  *
  * Single-shot — caller wraps in polling loop, EventEmitter, or interval.
- * Returns `unavailable: true` on any network or parse error.
+ * Returns `unavailable: true` on any network, timeout, or parse error.
+ *
+ * promoclock.co is a third-party host, so the request is always bounded by
+ * an abort timeout. Without one a hung host would stall the caller — and
+ * this is polled, so the stall would repeat.
  */
-async function fetchPeakHoursStatus() {
+async function fetchPeakHoursStatus(options = {}) {
+    const timeoutMs = options.timeoutMs ?? exports.DEFAULT_PEAK_HOURS_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    timeout.unref();
     try {
-        const res = await fetch(PROMOCLOCK_ENDPOINT);
+        const res = await fetch(PROMOCLOCK_ENDPOINT, { signal: controller.signal });
         if (!res.ok)
             return unavailableState();
         const data = await res.json();
@@ -98,6 +109,10 @@ async function fetchPeakHoursStatus() {
         };
     }
     catch {
+        // Covers AbortError from the timeout above alongside network/parse failures.
         return unavailableState();
     }
+    finally {
+        clearTimeout(timeout);
+    }
 }