sidekick-shared 0.18.4 → 0.19.0

package/README.md

@@ -26,17 +26,18 @@ npm install sidekick-shared
 | **Formatters** | Display helpers (`formatTokenCount()`, `formatDurationMs()`), tool summary, noise classification, session dump (text/markdown/JSON), event highlighting |
 | **Search** | Cross-session full-text search, advanced filtering (substring, fuzzy, regex, date) |
 | **Aggregation** | Event aggregation, frequency tracking, activity heatmaps, pattern extraction |
+| **Session Context** | Provider-neutral context evidence snapshots (`buildSessionContextSnapshot()`, `calculateSessionContextPressure()`, `createSessionContextProjector()`, `readSessionContextSnapshot()`): layered evidence sources, low/medium/high context pressure, and observed capabilities (tools, MCP servers, permission mode, rate limits) |
 | **Report** | Self-contained HTML session report generation |
 | **Credentials** | Claude Max OAuth credential reading from `~/.claude/.credentials.json` |
 | **Quota** | Claude Max subscription quota fetching (5-hour and 7-day windows) and Codex rate-limit extraction from event streams |
 | **Provider Status** | API health checking via status.claude.com and status.openai.com (indicator, components, incidents) |
 | **Schemas** | Zod schemas for runtime JSONL event validation (`sessionEventSchema`, `messageUsageSchema`, `sessionMessageSchema`) |
 | **Extractors** | Pure functions for single-event processing: `extractTokenUsage()`, `extractToolCall()` (top-level `tool_use`), `extractToolCalls()` (assistant content blocks) |
-| **Model Info & Pricing** | Model family parsing (Anthropic / OpenAI / Google, including legacy `claude-3-opus-…` and `claude-3-5-sonnet-…` IDs), context-window lookup (including Opus 4.7 / Sonnet 4.7 1M and GPT-5.x variants), pricing tables with optional LiteLLM hydration, null-aware cost (`calculateCost()`), provenance-preserving cost (`calculateCostWithProvenance()`, `mergeCostSources()`), and display helpers (`shortModelName()`, `getModelDisplayInfo()`, `compareModelIds()`, `sortModelIds()`, `formatCost()`) |
+| **Model Info & Pricing** | Model family parsing (Anthropic / OpenAI / Google, including legacy `claude-3-opus-…` and `claude-3-5-sonnet-…` IDs), context-window lookup (including Fable 5 / Opus 4.8 / Opus 4.7 / Sonnet 4.7 1M and GPT-5.x variants), pricing tables with optional LiteLLM hydration, null-aware cost (`calculateCost()`), provenance-preserving cost (`calculateCostWithProvenance()`, `mergeCostSources()`), and display helpers (`shortModelName()`, `getModelDisplayInfo()`, `compareModelIds()`, `sortModelIds()`, `formatCost()`) |
 | **Quota Polling** | `QuotaPoller` class with exponential backoff, active/idle intervals, and cached fallback |
 | **Multi-Provider Quota** | `MultiProviderQuotaService` orchestrates Claude polling + peak-hours + account labels + Codex quota updates behind one typed `{ claude?, codex? }` event stream. `CodexQuotaWatcher` watches the active Codex rollout for live rate limits with snapshot fallback |
 | **Accounts** | Multi-provider account registry (v2) with per-provider active account, save/switch/remove, v1 migration, `ensureDefaultAccounts()` for first-run bootstrap of the active system Claude/Codex credentials as a "Default" saved account, and `getActiveAccountStatus()` for a single-pass active-account read across providers |
-| **Codex Profiles** | Codex account lifecycle — prepare, finalize, switch, remove — with isolated `CODEX_HOME` directories and multi-home monitoring support |
+| **Codex Profiles** | Codex account lifecycle — prepare, finalize, switch, remove — switching atomically swaps the profile's backed-up credentials into the system `~/.codex/auth.json`, with rotated-token staleness protection, one-time dual-home migration, and legacy multi-home session monitoring |
 | **Quota Snapshots** | Persistent quota caching per provider/account for offline fallback |
 | **Phrases** | Curated humorous phrases for loading/idle states, available as a flat `ALL_PHRASES` array or grouped via `PHRASE_CATEGORIES` for category-aware UI |
 
@@ -180,6 +181,26 @@ const tools = extractToolCalls(event);           // ToolCall[]    — assistant
 const toolFromEvent = extractToolCall(event);    // ToolCall | null — top-level `tool_use` events
 ```
 
+### Project session context evidence
+
+Build a provider-neutral snapshot of what an assistant has "seen" in a session — layered evidence sources, context pressure, and observed capabilities. Read it through any session provider, or build it directly from a canonical `SessionEvent[]`.
+
+```typescript
+import { detectProvider, readSessionContextSnapshot } from 'sidekick-shared';
+
+const provider = await detectProvider('/path/to/project');
+if (provider) {
+  const snapshot = readSessionContextSnapshot(provider, '/path/to/session.jsonl');
+
+  console.log(snapshot.pressure);          // 'low' | 'medium' | 'high'
+  console.log(snapshot.contextTokens, '/', snapshot.contextWindow);
+  console.log(snapshot.capabilities.tools, snapshot.capabilities.mcpServers);
+  console.log(snapshot.sources.length, 'evidence sources');
+}
+```
+
+Use `createSessionContextProjector()` for incremental updates as new events stream in, or `calculateSessionContextPressure(contextTokens, contextWindow)` for the pressure band alone.
+
 ### Format shared dashboard values
 
 ```typescript

package/dist/accounts.d.ts

@@ -22,6 +22,7 @@ export interface ActiveAccountInfo {
 export interface AccountManagerResult {
     success: boolean;
     error?: string;
+    warning?: string;
     needsLogin?: boolean;
     profileId?: string;
     codexHome?: string;

package/dist/aggregation/EventAggregator.js

@@ -157,25 +157,29 @@ class EventAggregator {
         if (event.message.model) {
             this.currentModel = event.message.model;
         }
-        // 3. Skip synthetic token-count events for messageCount
+        // 3. Skip system/audit events and synthetic token-count events for messageCount
         const msgId = event.message.id ?? '';
-        if (!msgId.startsWith('token-count-')) {
+        if (event.type !== 'system' && !msgId.startsWith('token-count-')) {
             this.messageCount++;
         }
         // 4. Latency tracking
-        this.processLatency(event);
+        if (event.type !== 'system') {
+            this.processLatency(event);
+        }
         // 5. Token accumulation
         if (event.message.usage) {
             this.accumulateUsage(event.message.usage, event.timestamp, event.message.model);
         }
-        // 6. Tool extraction from content blocks
-        this.extractToolsFromContent(event);
-        // 7. Task state
-        this.extractTaskStateFromEvent(event);
-        // 8. Subagent tracking
-        this.extractSubagentFromEvent(event);
-        // 9. Plan extraction — convert SessionEvent to a FollowEvent shape for PlanExtractor
-        this.extractPlanFromSessionEvent(event);
+        if (event.type !== 'system') {
+            // 6. Tool extraction from content blocks
+            this.extractToolsFromContent(event);
+            // 7. Task state
+            this.extractTaskStateFromEvent(event);
+            // 8. Subagent tracking
+            this.extractSubagentFromEvent(event);
+            // 9. Plan extraction — convert SessionEvent to a FollowEvent shape for PlanExtractor
+            this.extractPlanFromSessionEvent(event);
+        }
         // 10. Context attribution
         this.attributeContextFromEvent(event);
         // 11. Permission mode tracking
@@ -1447,6 +1451,12 @@ class EventAggregator {
                 this.contextAttribution.other += this.estimateTokens(text);
             }
         }
+        else if (event.type === 'system') {
+            const text = this.extractTextContent(event) || '';
+            if (text) {
+                this.contextAttribution.systemPrompt += this.estimateTokens(text);
+            }
+        }
     }
     // ═══════════════════════════════════════════════════════════════════════
     // Private: Context Attribution from FollowEvent
@@ -1591,6 +1601,11 @@ class EventAggregator {
                 description = 'Context compacted';
                 noiseLevel = 'system';
                 break;
+            case 'system':
+                tlType = 'session_start';
+                description = this.extractTextContent(event) ?? event.message.sourceLabel ?? 'System event';
+                noiseLevel = 'system';
+                break;
             default:
                 tlType = 'session_start';
                 description = 'Event';

package/dist/browser.d.ts

@@ -10,5 +10,7 @@
 export { getModelContextWindowSize, DEFAULT_CONTEXT_WINDOW } from './modelContext';
 export { formatDurationMs, formatTokenCount } from './formatting';
 export type { FormatDurationMsOptions, FormatTokenCountOptions } from './formatting';
+export { buildSessionContextSnapshot, calculateSessionContextPressure, createSessionContextProjector, } from './context/sessionContext';
+export type { BuildSessionContextSnapshotOptions, SessionContextCapabilities, SessionContextLayerBreakdown, SessionContextPressure, SessionContextProjector, SessionContextSnapshot, SessionContextSource, SessionContextSourceType, } from './context/sessionContext';
 export { parseModelId, getModelPricing, getModelInfo, calculateCost, calculateCostWithPricing, calculateCostWithProvenance, mergeCostSources, shortModelName, getModelDisplayInfo, compareModelIds, sortModelIds, formatCost, } from './modelInfo';
 export type { ModelPricing, CostTokenUsage, CostSource, CostProvenanceInput, CostWithProvenance, ModelProvider, ParsedModelId, ModelInfo, ModelDisplayInfo, } from './modelInfo';

package/dist/browser.js

@@ -9,13 +9,17 @@
  * For pricing hydration (LiteLLM catalog refresh), use `sidekick-shared/node`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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.formatTokenCount = exports.formatDurationMs = exports.DEFAULT_CONTEXT_WINDOW = exports.getModelContextWindowSize = void 0;
+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.createSessionContextProjector = exports.calculateSessionContextPressure = exports.buildSessionContextSnapshot = exports.formatTokenCount = exports.formatDurationMs = exports.DEFAULT_CONTEXT_WINDOW = exports.getModelContextWindowSize = void 0;
 var modelContext_1 = require("./modelContext");
 Object.defineProperty(exports, "getModelContextWindowSize", { enumerable: true, get: function () { return modelContext_1.getModelContextWindowSize; } });
 Object.defineProperty(exports, "DEFAULT_CONTEXT_WINDOW", { enumerable: true, get: function () { return modelContext_1.DEFAULT_CONTEXT_WINDOW; } });
 var formatting_1 = require("./formatting");
 Object.defineProperty(exports, "formatDurationMs", { enumerable: true, get: function () { return formatting_1.formatDurationMs; } });
 Object.defineProperty(exports, "formatTokenCount", { enumerable: true, get: function () { return formatting_1.formatTokenCount; } });
+var sessionContext_1 = require("./context/sessionContext");
+Object.defineProperty(exports, "buildSessionContextSnapshot", { enumerable: true, get: function () { return sessionContext_1.buildSessionContextSnapshot; } });
+Object.defineProperty(exports, "calculateSessionContextPressure", { enumerable: true, get: function () { return sessionContext_1.calculateSessionContextPressure; } });
+Object.defineProperty(exports, "createSessionContextProjector", { enumerable: true, get: function () { return sessionContext_1.createSessionContextProjector; } });
 var modelInfo_1 = require("./modelInfo");
 Object.defineProperty(exports, "parseModelId", { enumerable: true, get: function () { return modelInfo_1.parseModelId; } });
 Object.defineProperty(exports, "getModelPricing", { enumerable: true, get: function () { return modelInfo_1.getModelPricing; } });

package/dist/codexProfiles.d.ts

@@ -14,6 +14,7 @@ export declare function getActiveCodexAccount(): SavedAccountProfile | null;
 export declare function resolveSidekickCodexHome(): string;
 export declare function getCodexExecutionEnv(baseEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
 export declare function prepareCodexAccount(label: string): CodexAccountManagerResult;
-export declare function finalizeCodexAccount(profileId: string): AccountManagerResult;
-export declare function switchToCodexAccount(profileId: string): AccountManagerResult;
+export declare function finalizeCodexAccount(profileId: string): CodexAccountManagerResult;
+export declare function switchToCodexAccount(profileId: string): CodexAccountManagerResult;
+export declare function reconcileCodexAuthState(): void;
 export declare function removeCodexAccount(profileId: string): AccountManagerResult;