sidekick-shared 0.21.0 → 0.21.1

package/README.md

@@ -40,13 +40,13 @@ npm install sidekick-shared
 | **Assistant Turns** | Browser-safe timeline/process/answer projection for provider-normalized assistant turns (`segmentAssistantTurn()`, `assistantTurnEventsFromSessionEvents()`), including interleaved reasoning, compact tool groups, and Claude `Task` subagent refs without prompt leakage |
 | **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 |
+| **Quota** | Claude Max subscription quota fetching (5-hour and 7-day windows), Codex rate-limit extraction from event streams, and **estimated** z.ai Coding Plan quota derivation from observed OpenCode traffic (`accumulateZaiUsage()`, `inferZaiQuotaState()`, `parseZaiQuotaError()`, `resolveZaiTier()`, `ZAI_TIER_BUDGETS`) — z.ai exposes no usage API, so this is a best-effort estimate, not authoritative |
 | **Provider Status** | API health checking via status.claude.com and status.openai.com (indicator, components, incidents) |
 | **Schemas** | Zod schemas for runtime validation of data crossing process/IPC boundaries — JSONL session events (`sessionEventSchema`, `messageUsageSchema`, `sessionMessageSchema`), assistant turns, quota, account status, and quota history — plus `extractSessionEvents()` to unwrap `progress`-wrapped events. Also published fs-free via the [`sidekick-shared/schemas`](#supported-import-paths) subpath |
 | **Extractors** | Pure functions for single-event processing: `extractTokenUsage()`, `extractToolCall()` (top-level `tool_use`), `extractToolCalls()` (assistant content blocks), plus Node-only session asset extraction (`gatherAssetsForCwd()`, `readClaudeAssets()`, `readCodexAssets()`) for URLs, file paths, commands, and plans |
 | **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 |
+| **Multi-Provider Quota** | `MultiProviderQuotaService` orchestrates Claude polling + peak-hours + account labels + Codex/z.ai quota updates behind one typed event stream. `CodexQuotaWatcher` watches the active Codex rollout for live rate limits with snapshot fallback; `ZaiQuotaWatcher` derives an estimated z.ai Coding Plan quota from observed OpenCode turns (event-driven, snapshot + history) |
 | **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 |
 | **Account Management 2.0** | Provider-neutral acquisition + switching: `beginAccountLogin()` / `getAccountLoginStatus()` / `finalizeAccountLogin()` / `spawnAccountLogin()` drive a TTY-less, profile-isolated login that doesn't disturb the active account until finalization; `listAllAccounts()` and `switchAccount()` expose a shared switcher across Claude and Codex. Claude accounts get canonical profile homes with account-scoped macOS keychain suffixes and startup migration from legacy flat backups |
 | **Terminal sync & auto-switch** | Opt-in terminal profile pointers, shell-hook/launcher helpers, and a default-off `AutoSwitchController` (`decideAutoSwitch()`) that moves to a healthier saved account when quota crosses a configured threshold |

package/dist/index.d.ts

@@ -28,7 +28,7 @@ export type { ReadPlansOptions, PlanAnalytics } from './readers/plans';
 export type { ProviderId, SessionProvider, SessionProviderBase, SessionFileStats, SessionFileInfo, SearchHit, ProjectFolderInfo, SessionReader, ProviderRuntimeStatus } from './providers/types';
 export { detectProvider, getAllDetectedProviders } from './providers/detect';
 export { ClaudeCodeProvider } from './providers/claudeCode';
-export { OpenCodeProvider } from './providers/openCode';
+export { OpenCodeProvider, getOpenCodeDataDir } from './providers/openCode';
 export { CodexProvider } from './providers/codex';
 export { JsonlParser, TRUNCATION_PATTERNS } from './parsers/jsonl';
 export type { RawSessionEvent, JsonlParserCallbacks, JsonlParserOptions } from './parsers/jsonl';
@@ -121,9 +121,14 @@ export { fetchCodexQuotaFromApi, quotaFromCodexRateLimits, readLatestCodexQuotaF
 export type { CodexQuotaApiOptions, CodexQuotaCreditsSnapshot, CodexQuotaResolveOptions, CodexQuotaResolveSource, } from './codexQuota';
 export { CodexQuotaWatcher } from './codexQuotaWatcher';
 export type { CodexQuotaWatcherOptions } from './codexQuotaWatcher';
+export { accumulateZaiUsage, extractNextFlushTime, inferZaiQuotaState, isZaiProviderId, makeUnavailableZaiQuotaState, parseZaiQuotaError, resolveZaiTier, rowsToZaiTurnsAndErrors, turnTokenWeight, ZAI_PROMPT_INVOCATIONS, ZAI_PROVIDER_IDS, ZAI_TIER_BUDGETS, } from './zaiQuota';
+export type { ZaiAccumulatedUsage, ZaiAssistantTurn, ZaiOpenCodeRow, ZaiProviderId, ZaiQuotaError, ZaiQuotaErrorKind, ZaiTier, InferZaiQuotaStateOptions, } from './zaiQuota';
+export { ZaiQuotaWatcher } from './zaiQuotaWatcher';
+export type { ZaiQuotaWatcherOptions } from './zaiQuotaWatcher';
 export { MultiProviderQuotaService } from './multiProviderQuotaService';
 export type { MultiProviderQuotaServiceOptions } from './multiProviderQuotaService';
 export type { ProviderQuotaMap, ProviderQuotaState, RuntimeQuotaProvider } from './providerQuota';
+export type { QuotaSnapshotProviderId } from './quotaSnapshots';
 export { getModelContextWindowSize, DEFAULT_CONTEXT_WINDOW } from './modelContext';
 export { parseModelId, getModelPricing, getModelInfo, calculateCost, calculateCostWithPricing, calculateCostWithProvenance, mergeCostSources, shortModelName, getModelDisplayInfo, compareModelIds, sortModelIds, formatCost, } from './modelInfo';
 export type { ModelPricing, CostTokenUsage, CostSource, CostProvenanceInput, CostWithProvenance, ModelInfo, ModelProvider, ParsedModelId, ModelDisplayInfo, } from './modelInfo';
@@ -138,7 +143,7 @@ export { readCodexAssets, codexSessions } from './extractors/sources/codexAssets
 export { gatherAssetsForCwd } from './extractors/gatherAssets';
 export type { GatherAssetsOptions, GatherAssetsResult } from './extractors/gatherAssets';
 export { messageUsageSchema, sessionMessageSchema, sessionEventSchema, permissionModeSchema, extractSessionEvents, } from './schemas/sessionEvent';
-export { quotaWindowSchema, quotaStateSchema, quotaFailureKindSchema, quotaProviderIdSchema, quotaSourceSchema, peakHoursStateSchema, quotaFailureDescriptorSchema, runtimeQuotaProviderSchema, providerQuotaStateSchema, claudeProviderQuotaStateSchema, codexProviderQuotaStateSchema, providerQuotaMapSchema, } from './schemas/quota';
+export { quotaWindowSchema, quotaStateSchema, quotaFailureKindSchema, quotaProviderIdSchema, quotaSourceSchema, peakHoursStateSchema, quotaFailureDescriptorSchema, runtimeQuotaProviderSchema, providerQuotaStateSchema, claudeProviderQuotaStateSchema, codexProviderQuotaStateSchema, zaiProviderQuotaStateSchema, providerQuotaMapSchema, } from './schemas/quota';
 export { quotaHistoryRuntimeProviderSchema, quotaHistorySampleSchema, quotaHistoryDailyBucketSchema, } from './schemas/quotaHistory';
 export { activeProviderAccountStatusSchema, activeAccountStatusSchema, } from './schemas/accountStatus';
 export { accountProviderIdSchema, accountManagerResultSchema, beginAccountLoginResultSchema, accountLoginStatusSchema, accountEntrySchema, savedAccountProfileSchema, listAllAccountsResultSchema, } from './schemas/accountManager';

package/dist/index.js

@@ -3,12 +3,12 @@
  * Public API for sidekick-shared.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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.OpenCodeProvider = exports.ClaudeCodeProvider = exports.getAllDetectedProviders = exports.detectProvider = exports.readClaudeCodePlanFiles = exports.getPlanAnalytics = exports.writePlans = exports.getLatestPlan = exports.readPlans = exports.readLatestHandoff = exports.readHistory = exports.readNotes = exports.readDecisions = exports.readTasks = exports.getProjectSlugRaw = exports.getProjectSlug = exports.encodeWorkspacePath = exports.getGlobalDataPath = exports.getProjectDataPath = exports.getConfigDir = exports.MAX_PLANS_PER_PROJECT = exports.PLAN_SCHEMA_VERSION = exports.createEmptyTokenTotals = exports.HISTORICAL_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 = void 0;
-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 = exports.scanSubagentTraces = exports.findAllSessionsWithWorktrees = exports.discoverWorktreeSiblings = exports.resolveWorktreeMainRepo = exports.getAllClaudeProjectFolders = exports.decodeEncodedPath = exports.getMostRecentlyActiveSessionDir = exports.findSubdirectorySessionDirs = exports.findSessionsInDirectory = exports.findAllClaudeSessions = void 0;
-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.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.PatternExtractor = exports.HeatmapTracker = exports.FrequencyTracker = exports.getSnapshotPath = exports.isSnapshotValid = exports.deleteSnapshot = exports.loadSnapshot = exports.saveSnapshot = exports.parseTodoDependencies = exports.EventAggregator = exports.getRandomPhrase = exports.PHRASE_CATEGORIES = exports.ALL_PHRASES = exports.HIGHLIGHT_CSS = void 0;
-exports.getModelPricing = exports.parseModelId = exports.DEFAULT_CONTEXT_WINDOW = exports.getModelContextWindowSize = exports.MultiProviderQuotaService = exports.CodexQuotaWatcher = exports.resolveCodexQuotaFromLocalSources = exports.resolveCodexQuota = exports.readLatestCodexQuotaFromRollouts = exports.quotaFromCodexRateLimits = exports.fetchCodexQuotaFromApi = exports.getWorkspaceIdFromPath = exports.pruneQuotaHistory = exports.readQuotaHistoryDailyBuckets = exports.readQuotaHistoryRange = exports.appendQuotaHistorySample = exports.writeQuotaSnapshot = exports.readQuotaSnapshot = exports.QuotaPoller = exports.describeQuotaFailure = exports.fetchQuota = 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.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 = void 0;
-exports.accountLoginStatusSchema = exports.beginAccountLoginResultSchema = exports.accountManagerResultSchema = exports.accountProviderIdSchema = exports.activeAccountStatusSchema = exports.activeProviderAccountStatusSchema = exports.quotaHistoryDailyBucketSchema = exports.quotaHistorySampleSchema = exports.quotaHistoryRuntimeProviderSchema = exports.providerQuotaMapSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.extractSessionEvents = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.gatherAssetsForCwd = exports.codexSessions = exports.readCodexAssets = exports.claudeSessions = exports.readClaudeAssets = exports.extractCommands = exports.extractFilePaths = exports.extractUrls = exports.extractToolCalls = exports.extractToolCall = exports.extractTokenUsage = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = exports.formatCost = exports.sortModelIds = exports.compareModelIds = exports.getModelDisplayInfo = exports.shortModelName = exports.mergeCostSources = exports.calculateCostWithProvenance = exports.calculateCostWithPricing = exports.calculateCost = exports.getModelInfo = void 0;
-exports.scopePeakHoursToSessionProvider = exports.isClaudeCodeSessionProvider = exports.fetchPeakHoursStatus = exports.createPeakHoursNotApplicableState = 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 = void 0;
+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.readClaudeCodePlanFiles = exports.getPlanAnalytics = exports.writePlans = exports.getLatestPlan = exports.readPlans = exports.readLatestHandoff = exports.readHistory = exports.readNotes = exports.readDecisions = exports.readTasks = exports.getProjectSlugRaw = exports.getProjectSlug = exports.encodeWorkspacePath = exports.getGlobalDataPath = exports.getProjectDataPath = exports.getConfigDir = exports.MAX_PLANS_PER_PROJECT = exports.PLAN_SCHEMA_VERSION = exports.createEmptyTokenTotals = exports.HISTORICAL_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 = void 0;
+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 = exports.scanSubagentTraces = exports.findAllSessionsWithWorktrees = exports.discoverWorktreeSiblings = exports.resolveWorktreeMainRepo = exports.getAllClaudeProjectFolders = exports.decodeEncodedPath = exports.getMostRecentlyActiveSessionDir = exports.findSubdirectorySessionDirs = exports.findSessionsInDirectory = exports.findAllClaudeSessions = exports.findActiveClaudeSession = void 0;
+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.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.PatternExtractor = exports.HeatmapTracker = exports.FrequencyTracker = exports.getSnapshotPath = exports.isSnapshotValid = exports.deleteSnapshot = exports.loadSnapshot = exports.saveSnapshot = exports.parseTodoDependencies = exports.EventAggregator = exports.getRandomPhrase = exports.PHRASE_CATEGORIES = exports.ALL_PHRASES = exports.HIGHLIGHT_CSS = exports.clearHighlightCache = void 0;
+exports.isZaiProviderId = exports.inferZaiQuotaState = exports.extractNextFlushTime = exports.accumulateZaiUsage = exports.CodexQuotaWatcher = exports.resolveCodexQuotaFromLocalSources = exports.resolveCodexQuota = exports.readLatestCodexQuotaFromRollouts = exports.quotaFromCodexRateLimits = exports.fetchCodexQuotaFromApi = exports.getWorkspaceIdFromPath = exports.pruneQuotaHistory = exports.readQuotaHistoryDailyBuckets = exports.readQuotaHistoryRange = exports.appendQuotaHistorySample = exports.writeQuotaSnapshot = exports.readQuotaSnapshot = exports.QuotaPoller = exports.describeQuotaFailure = exports.fetchQuota = 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.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 = void 0;
+exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaStateSchema = exports.quotaWindowSchema = exports.extractSessionEvents = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.gatherAssetsForCwd = exports.codexSessions = exports.readCodexAssets = exports.claudeSessions = exports.readClaudeAssets = exports.extractCommands = exports.extractFilePaths = exports.extractUrls = exports.extractToolCalls = exports.extractToolCall = exports.extractTokenUsage = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = exports.formatCost = exports.sortModelIds = exports.compareModelIds = exports.getModelDisplayInfo = exports.shortModelName = exports.mergeCostSources = exports.calculateCostWithProvenance = exports.calculateCostWithPricing = exports.calculateCost = exports.getModelInfo = exports.getModelPricing = exports.parseModelId = exports.DEFAULT_CONTEXT_WINDOW = exports.getModelContextWindowSize = exports.MultiProviderQuotaService = exports.ZaiQuotaWatcher = exports.ZAI_TIER_BUDGETS = exports.ZAI_PROVIDER_IDS = exports.ZAI_PROMPT_INVOCATIONS = exports.turnTokenWeight = exports.rowsToZaiTurnsAndErrors = exports.resolveZaiTier = exports.parseZaiQuotaError = exports.makeUnavailableZaiQuotaState = void 0;
+exports.scopePeakHoursToSessionProvider = exports.isClaudeCodeSessionProvider = exports.fetchPeakHoursStatus = exports.createPeakHoursNotApplicableState = 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 = void 0;
 var taskPersistence_1 = require("./types/taskPersistence");
 Object.defineProperty(exports, "TASK_PERSISTENCE_SCHEMA_VERSION", { enumerable: true, get: function () { return taskPersistence_1.TASK_PERSISTENCE_SCHEMA_VERSION; } });
 Object.defineProperty(exports, "normalizeTaskStatus", { enumerable: true, get: function () { return taskPersistence_1.normalizeTaskStatus; } });
@@ -56,6 +56,7 @@ var claudeCode_1 = require("./providers/claudeCode");
 Object.defineProperty(exports, "ClaudeCodeProvider", { enumerable: true, get: function () { return claudeCode_1.ClaudeCodeProvider; } });
 var openCode_1 = require("./providers/openCode");
 Object.defineProperty(exports, "OpenCodeProvider", { enumerable: true, get: function () { return openCode_1.OpenCodeProvider; } });
+Object.defineProperty(exports, "getOpenCodeDataDir", { enumerable: true, get: function () { return openCode_1.getOpenCodeDataDir; } });
 var codex_1 = require("./providers/codex");
 Object.defineProperty(exports, "CodexProvider", { enumerable: true, get: function () { return codex_1.CodexProvider; } });
 // Parsers — JSONL
@@ -295,6 +296,21 @@ Object.defineProperty(exports, "resolveCodexQuota", { enumerable: true, get: fun
 Object.defineProperty(exports, "resolveCodexQuotaFromLocalSources", { enumerable: true, get: function () { return codexQuota_1.resolveCodexQuotaFromLocalSources; } });
 var codexQuotaWatcher_1 = require("./codexQuotaWatcher");
 Object.defineProperty(exports, "CodexQuotaWatcher", { enumerable: true, get: function () { return codexQuotaWatcher_1.CodexQuotaWatcher; } });
+var zaiQuota_1 = require("./zaiQuota");
+Object.defineProperty(exports, "accumulateZaiUsage", { enumerable: true, get: function () { return zaiQuota_1.accumulateZaiUsage; } });
+Object.defineProperty(exports, "extractNextFlushTime", { enumerable: true, get: function () { return zaiQuota_1.extractNextFlushTime; } });
+Object.defineProperty(exports, "inferZaiQuotaState", { enumerable: true, get: function () { return zaiQuota_1.inferZaiQuotaState; } });
+Object.defineProperty(exports, "isZaiProviderId", { enumerable: true, get: function () { return zaiQuota_1.isZaiProviderId; } });
+Object.defineProperty(exports, "makeUnavailableZaiQuotaState", { enumerable: true, get: function () { return zaiQuota_1.makeUnavailableZaiQuotaState; } });
+Object.defineProperty(exports, "parseZaiQuotaError", { enumerable: true, get: function () { return zaiQuota_1.parseZaiQuotaError; } });
+Object.defineProperty(exports, "resolveZaiTier", { enumerable: true, get: function () { return zaiQuota_1.resolveZaiTier; } });
+Object.defineProperty(exports, "rowsToZaiTurnsAndErrors", { enumerable: true, get: function () { return zaiQuota_1.rowsToZaiTurnsAndErrors; } });
+Object.defineProperty(exports, "turnTokenWeight", { enumerable: true, get: function () { return zaiQuota_1.turnTokenWeight; } });
+Object.defineProperty(exports, "ZAI_PROMPT_INVOCATIONS", { enumerable: true, get: function () { return zaiQuota_1.ZAI_PROMPT_INVOCATIONS; } });
+Object.defineProperty(exports, "ZAI_PROVIDER_IDS", { enumerable: true, get: function () { return zaiQuota_1.ZAI_PROVIDER_IDS; } });
+Object.defineProperty(exports, "ZAI_TIER_BUDGETS", { enumerable: true, get: function () { return zaiQuota_1.ZAI_TIER_BUDGETS; } });
+var zaiQuotaWatcher_1 = require("./zaiQuotaWatcher");
+Object.defineProperty(exports, "ZaiQuotaWatcher", { enumerable: true, get: function () { return zaiQuotaWatcher_1.ZaiQuotaWatcher; } });
 var multiProviderQuotaService_1 = require("./multiProviderQuotaService");
 Object.defineProperty(exports, "MultiProviderQuotaService", { enumerable: true, get: function () { return multiProviderQuotaService_1.MultiProviderQuotaService; } });
 // Model Context
@@ -361,6 +377,7 @@ Object.defineProperty(exports, "runtimeQuotaProviderSchema", { enumerable: true,
 Object.defineProperty(exports, "providerQuotaStateSchema", { enumerable: true, get: function () { return quota_2.providerQuotaStateSchema; } });
 Object.defineProperty(exports, "claudeProviderQuotaStateSchema", { enumerable: true, get: function () { return quota_2.claudeProviderQuotaStateSchema; } });
 Object.defineProperty(exports, "codexProviderQuotaStateSchema", { enumerable: true, get: function () { return quota_2.codexProviderQuotaStateSchema; } });
+Object.defineProperty(exports, "zaiProviderQuotaStateSchema", { enumerable: true, get: function () { return quota_2.zaiProviderQuotaStateSchema; } });
 Object.defineProperty(exports, "providerQuotaMapSchema", { enumerable: true, get: function () { return quota_2.providerQuotaMapSchema; } });
 // Schemas — Zod runtime validation for quota history
 var quotaHistory_2 = require("./schemas/quotaHistory");

package/dist/multiProviderQuotaService.d.ts

@@ -10,6 +10,11 @@ interface CodexWatcherLike extends Disposable {
     stop(): void;
     onUpdate(cb: (state: ProviderQuotaState<'codex'>) => void): Disposable;
 }
+interface ZaiWatcherLike extends Disposable {
+    start(): void;
+    stop(): void;
+    onUpdate(cb: (state: ProviderQuotaState<'zai'>) => void): Disposable;
+}
 export interface MultiProviderQuotaServiceOptions {
     activeIntervalMs?: number;
     idleIntervalMs?: number;
@@ -18,6 +23,7 @@ export interface MultiProviderQuotaServiceOptions {
     includePeakHours?: boolean;
     codexWorkspacePath?: string;
     codexWatcher?: CodexWatcherLike | null;
+    zaiWatcher?: ZaiWatcherLike | null;
     readClaudeCredentials?: () => Promise<ClaudeMaxCredentials | null>;
     readClaudeAccount?: typeof readActiveClaudeAccount;
     fetchClaudeQuota?: (accessToken: string) => Promise<QuotaState>;
@@ -39,6 +45,9 @@ export declare class MultiProviderQuotaService implements Disposable {
     private readonly codexWatcher;
     private readonly ownsCodexWatcher;
     private codexSubscription;
+    private readonly zaiWatcher;
+    private readonly ownsZaiWatcher;
+    private zaiSubscription;
     private timer;
     private polling;
     private quotaByProvider;
@@ -60,6 +69,7 @@ export declare class MultiProviderQuotaService implements Disposable {
     getLatest(): ProviderQuotaMap;
     updateProviderQuota(provider: 'claude', state: ProviderQuotaState<'claude'>): void;
     updateProviderQuota(provider: 'codex', state: ProviderQuotaState<'codex'>): void;
+    updateProviderQuota(provider: 'zai', state: ProviderQuotaState<'zai'>): void;
     dispose(): void;
     private refreshPeakHours;
     private poll;

package/dist/multiProviderQuotaService.js

@@ -59,6 +59,9 @@ class MultiProviderQuotaService {
     codexWatcher;
     ownsCodexWatcher;
     codexSubscription = null;
+    zaiWatcher;
+    ownsZaiWatcher;
+    zaiSubscription = null;
     timer;
     polling = false;
     quotaByProvider = {};
@@ -97,12 +100,24 @@ class MultiProviderQuotaService {
         this.codexSubscription = this.codexWatcher?.onUpdate((state) => {
             this.updateProviderQuota('codex', state);
         }) ?? null;
+        if (options.zaiWatcher !== undefined) {
+            this.zaiWatcher = options.zaiWatcher;
+            this.ownsZaiWatcher = false;
+        }
+        else {
+            this.zaiWatcher = null;
+            this.ownsZaiWatcher = false;
+        }
+        this.zaiSubscription = this.zaiWatcher?.onUpdate((state) => {
+            this.updateProviderQuota('zai', state);
+        }) ?? null;
     }
     startPolling() {
         if (this.polling)
             return;
         this.polling = true;
         this.codexWatcher?.start();
+        this.zaiWatcher?.start();
         void this.poll();
         this.log?.('[Quota] Polling started');
     }
@@ -115,6 +130,7 @@ class MultiProviderQuotaService {
             this.timer = undefined;
         }
         this.codexWatcher?.stop();
+        this.zaiWatcher?.stop();
         this.log?.('[Quota] Polling stopped');
     }
     setPollingMode(mode) {
@@ -165,6 +181,19 @@ class MultiProviderQuotaService {
             this.emit();
             return;
         }
+        if (provider === 'zai') {
+            const nextState = {
+                ...state,
+                runtimeProvider: 'zai',
+                providerId: 'zai',
+            };
+            this.quotaByProvider = {
+                ...this.quotaByProvider,
+                zai: nextState,
+            };
+            this.emit();
+            return;
+        }
         const nextState = {
             ...state,
             runtimeProvider: 'codex',
@@ -183,6 +212,11 @@ class MultiProviderQuotaService {
         if (this.ownsCodexWatcher) {
             this.codexWatcher?.dispose();
         }
+        this.zaiSubscription?.dispose();
+        this.zaiSubscription = null;
+        if (this.ownsZaiWatcher) {
+            this.zaiWatcher?.dispose();
+        }
         this.listeners.splice(0, this.listeners.length);
     }
     async refreshPeakHours() {

package/dist/providerQuota.d.ts

@@ -1,7 +1,7 @@
 import type { PeakHoursState } from './peakHours';
 import type { QuotaState } from './quota';
 import type { QuotaFailureDescriptor } from './quotaPresentation';
-export type RuntimeQuotaProvider = 'claude' | 'codex';
+export type RuntimeQuotaProvider = 'claude' | 'codex' | 'zai';
 export interface ProviderQuotaState<TProvider extends RuntimeQuotaProvider = RuntimeQuotaProvider> extends QuotaState {
     runtimeProvider: TProvider;
     accountLabel?: string;
@@ -12,4 +12,5 @@ export interface ProviderQuotaState<TProvider extends RuntimeQuotaProvider = Run
 export interface ProviderQuotaMap {
     claude?: ProviderQuotaState<'claude'>;
     codex?: ProviderQuotaState<'codex'>;
+    zai?: ProviderQuotaState<'zai'>;
 }

package/dist/providers/detect.js

@@ -44,17 +44,7 @@ const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const codexProfiles_1 = require("../codexProfiles");
-function getOpenCodeDataDir() {
-    const xdg = process.env.XDG_DATA_HOME;
-    if (xdg)
-        return path.join(xdg, 'opencode');
-    if (process.platform === 'darwin')
-        return path.join(os.homedir(), 'Library', 'Application Support', 'opencode');
-    if (process.platform === 'win32') {
-        return path.join(process.env.LOCALAPPDATA || process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Local'), 'opencode');
-    }
-    return path.join(os.homedir(), '.local', 'share', 'opencode');
-}
+const openCode_1 = require("./openCode");
 function getCodexHomes() {
     return (0, codexProfiles_1.getCodexMonitoringHomes)();
 }
@@ -109,7 +99,7 @@ function getMostRecentMtime(dir) {
     }
 }
 function getOpenCodeActivityMtime() {
-    const dataDir = getOpenCodeDataDir();
+    const dataDir = (0, openCode_1.getOpenCodeDataDir)();
     const dbPath = path.join(dataDir, 'opencode.db');
     try {
         const dbMtime = fs.statSync(dbPath).mtime.getTime();
@@ -137,7 +127,7 @@ function getCodexActivityMtime() {
 }
 function getProviderPaths() {
     const claudeBase = path.join(os.homedir(), '.claude', 'projects');
-    const openCodeDataDir = getOpenCodeDataDir();
+    const openCodeDataDir = (0, openCode_1.getOpenCodeDataDir)();
     const codexHomes = getCodexHomes();
     return {
         claudeBase,

package/dist/providers/openCode.d.ts

@@ -16,8 +16,20 @@
  * @module providers/openCode
  */
 import type { ReadSessionContextSnapshotOptions, SessionContextSnapshot } from '../context/sessionContext';
+import type { ZaiTier } from '../zaiQuota';
+import type { QuotaState } from '../quota';
 import type { SessionProviderBase, SessionReader, ProjectFolderInfo, SearchHit, SessionFileStats, ProviderId, ProviderRuntimeStatus } from './types';
 import type { TokenUsage, SubagentStats, ContextAttribution } from '../types/sessionEvent';
+/**
+ * Gets the OpenCode data directory.
+ *
+ * Resolves in priority order: `XDG_DATA_HOME` (if set), then whichever of
+ * the platform-default candidates actually contains an `opencode.db` file.
+ * OpenCode's CLI has historically used the Linux-style `~/.local/share/opencode`
+ * path even on macOS, so we probe both and pick whichever exists — falling
+ * back to the platform default when neither is present yet.
+ */
+export declare function getOpenCodeDataDir(): string;
 /**
  * Session provider for OpenCode CLI.
  *
@@ -77,4 +89,23 @@ export declare class OpenCodeProvider implements SessionProviderBase {
     /** Set a runtime-reported context window limit (overrides static map). */
     setDynamicContextWindowLimit(limit: number): void;
     dispose(): void;
+    /**
+     * Derives a z.ai coding-plan `QuotaState` from OpenCode assistant turns
+     * tagged with `providerID ∈ {zai, zai-coding-plan}`.
+     *
+     * z.ai does not expose a quota API (verified vs. docs.z.ai/openapi.json),
+     * so this method accumulates observed per-turn tokens from OpenCode's DB
+     * into 5-hour / 7-day rolling windows and infers utilization against the
+     * configured tier budget. Returns null when no z.ai routing is detected.
+     *
+     * @param tier  Plan tier; `'auto'` infers from observed weekly volume.
+     *              When the caller has no opinion, the heuristic falls back to
+     *              `'max'` (conservative — small overcount rather than large).
+     */
+    getZaiQuotaState(tier?: ZaiTier | 'auto'): QuotaState | null;
+    /**
+     * Cheap boolean: does the local OpenCode install currently route at z.ai?
+     * Used by callers to decide whether to render a z.ai quota surface.
+     */
+    isZaiRoutingActive(): boolean;
 }

package/dist/providers/openCode.js

@@ -51,6 +51,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenCodeProvider = void 0;
+exports.getOpenCodeDataDir = getOpenCodeDataDir;
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
@@ -58,19 +59,42 @@ const child_process_1 = require("child_process");
 const sessionContext_1 = require("../context/sessionContext");
 const openCodeParser_1 = require("../parsers/openCodeParser");
 const openCodeDatabase_1 = require("./openCodeDatabase");
+const zaiQuota_1 = require("../zaiQuota");
 const modelContext_1 = require("../modelContext");
 // ---------------------------------------------------------------------------
 // Helper functions
 // ---------------------------------------------------------------------------
 /**
  * Gets the OpenCode data directory.
- * Respects XDG_DATA_HOME if set, otherwise uses ~/.local/share/opencode/
+ *
+ * Resolves in priority order: `XDG_DATA_HOME` (if set), then whichever of
+ * the platform-default candidates actually contains an `opencode.db` file.
+ * OpenCode's CLI has historically used the Linux-style `~/.local/share/opencode`
+ * path even on macOS, so we probe both and pick whichever exists — falling
+ * back to the platform default when neither is present yet.
  */
 function getOpenCodeDataDir() {
     const xdg = process.env.XDG_DATA_HOME;
-    if (xdg) {
+    if (xdg)
         return path.join(xdg, 'opencode');
+    const candidates = [path.join(os.homedir(), '.local', 'share', 'opencode')];
+    if (process.platform === 'darwin') {
+        candidates.push(path.join(os.homedir(), 'Library', 'Application Support', 'opencode'));
+    }
+    else if (process.platform === 'win32') {
+        candidates.push(path.join(process.env.LOCALAPPDATA || process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Local'), 'opencode'));
+    }
+    for (const candidate of candidates) {
+        try {
+            if (fs.existsSync(path.join(candidate, 'opencode.db')))
+                return candidate;
+        }
+        catch {
+            // ignore — try the next candidate.
+        }
     }
+    // Nothing found yet — return the platform default so a fresh OpenCode
+    // install gets detected at the conventional location for this OS.
     if (process.platform === 'darwin') {
         return path.join(os.homedir(), 'Library', 'Application Support', 'opencode');
     }
@@ -1548,5 +1572,87 @@ class OpenCodeProvider {
         this.sessionMetaCache.clear();
         this.dynamicContextWindowLimit = null;
     }
+    // --- z.ai (GLM Coding Plan) quota derivation ---
+    /**
+     * Derives a z.ai coding-plan `QuotaState` from OpenCode assistant turns
+     * tagged with `providerID ∈ {zai, zai-coding-plan}`.
+     *
+     * z.ai does not expose a quota API (verified vs. docs.z.ai/openapi.json),
+     * so this method accumulates observed per-turn tokens from OpenCode's DB
+     * into 5-hour / 7-day rolling windows and infers utilization against the
+     * configured tier budget. Returns null when no z.ai routing is detected.
+     *
+     * @param tier  Plan tier; `'auto'` infers from observed weekly volume.
+     *              When the caller has no opinion, the heuristic falls back to
+     *              `'max'` (conservative — small overcount rather than large).
+     */
+    getZaiQuotaState(tier = 'auto') {
+        const db = this.ensureDb();
+        if (!db)
+            return null;
+        const sinceMs = Date.now() - 7 * 86_400_000;
+        let rawRows = [];
+        try {
+            rawRows = db.getAssistantMessagesByProviderId([...zaiQuota_1.ZAI_PROVIDER_IDS], sinceMs);
+        }
+        catch {
+            return null;
+        }
+        if (rawRows.length === 0)
+            return null;
+        const turns = rawRows.map(row => ({
+            timestampMs: row.timeCreated,
+            model: row.modelId,
+            inputTokens: row.inputTokens || 0,
+            outputTokens: row.outputTokens || 0,
+            cacheReadTokens: row.cacheReadTokens || 0,
+            cacheWriteTokens: row.cacheWriteTokens || 0,
+            reasoningTokens: row.reasoningTokens || 0,
+        }));
+        const accumulated = (0, zaiQuota_1.accumulateZaiUsage)(turns, Date.now());
+        // Default to 'max' on auto when usage is non-zero — overestimating the
+        // tier gives a lower (safer) utilization % until calibration runs.
+        const resolvedTier = tier === 'auto'
+            ? (accumulated.weeklyTurns > 0 ? 'max' : 'lite')
+            : tier;
+        // Walk rows again to trap any captured z.ai business errors.
+        let authoritativeFiveHourResetAt;
+        let authoritativeWeeklyResetAt;
+        for (const row of rawRows) {
+            if (row.errorCode == null && !row.errorMessage)
+                continue;
+            const parsed = (0, zaiQuota_1.parseZaiQuotaError)({
+                code: row.errorCode ?? undefined,
+                message: row.errorMessage ?? undefined,
+            });
+            if (!parsed?.resetsAt)
+                continue;
+            if (parsed.kind === 'exhausted') {
+                authoritativeFiveHourResetAt = parsed.resetsAt;
+                if (String(parsed.code) === '1310')
+                    authoritativeWeeklyResetAt = parsed.resetsAt;
+            }
+        }
+        return (0, zaiQuota_1.inferZaiQuotaState)(accumulated, resolvedTier, {
+            authoritativeFiveHourResetAt,
+            authoritativeWeeklyResetAt,
+        });
+    }
+    /**
+     * Cheap boolean: does the local OpenCode install currently route at z.ai?
+     * Used by callers to decide whether to render a z.ai quota surface.
+     */
+    isZaiRoutingActive() {
+        const db = this.ensureDb();
+        if (!db)
+            return false;
+        try {
+            const rows = db.getAssistantMessagesByProviderId([...zaiQuota_1.ZAI_PROVIDER_IDS], Date.now() - 7 * 86_400_000);
+            return rows.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
 }
 exports.OpenCodeProvider = OpenCodeProvider;

package/dist/providers/openCodeDatabase.d.ts

@@ -91,6 +91,25 @@ export declare class OpenCodeDatabase {
         sessionCount: number;
         maxTimeUpdated: number;
     }>;
+    /**
+     * Returns assistant messages tagged with the given providerID(s), completed
+     * within `sinceMs`. Used by the z.ai quota accumulator to walk OpenCode's
+     * per-turn token records without re-deriving the session filter.
+     *
+     * Results are ordered oldest-first by `time_created`.
+     */
+    getAssistantMessagesByProviderId(providerIds: readonly string[], sinceMs: number): Array<{
+        timeCreated: number;
+        modelId: string;
+        providerId: string;
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        reasoningTokens: number;
+        errorMessage: string | null;
+        errorCode: string | null;
+    }>;
     /** Get the database file's mtime (ms epoch). Returns 0 if unavailable. */
     getDbMtime(): number;
 }

package/dist/providers/openCodeDatabase.js

@@ -249,6 +249,34 @@ class OpenCodeDatabase {
     getProjectSessionStats() {
         return this.query('SELECT project_id AS projectId, COUNT(*) AS sessionCount, MAX(time_updated) AS maxTimeUpdated FROM session GROUP BY project_id');
     }
+    /**
+     * Returns assistant messages tagged with the given providerID(s), completed
+     * within `sinceMs`. Used by the z.ai quota accumulator to walk OpenCode's
+     * per-turn token records without re-deriving the session filter.
+     *
+     * Results are ordered oldest-first by `time_created`.
+     */
+    getAssistantMessagesByProviderId(providerIds, sinceMs) {
+        if (providerIds.length === 0)
+            return [];
+        const providerClauses = providerIds.map(() => 'json_extract(data, \'$.providerID\') = ?').join(' OR ');
+        return this.query(`SELECT
+         time_created AS timeCreated,
+         COALESCE(json_extract(data, '$.modelID'), 'unknown') AS modelId,
+         COALESCE(json_extract(data, '$.providerID'), '') AS providerId,
+         COALESCE(json_extract(data, '$.tokens.input'), 0) AS inputTokens,
+         COALESCE(json_extract(data, '$.tokens.output'), 0) AS outputTokens,
+         COALESCE(json_extract(data, '$.tokens.cache.read'), 0) AS cacheReadTokens,
+         COALESCE(json_extract(data, '$.tokens.cache.write'), 0) AS cacheWriteTokens,
+         COALESCE(json_extract(data, '$.tokens.reasoning'), 0) AS reasoningTokens,
+         json_extract(data, '$.error.message') AS errorMessage,
+         json_extract(data, '$.error.code') AS errorCode
+       FROM message
+       WHERE time_created >= ?
+         AND json_extract(data, '$.role') = 'assistant'
+         AND (${providerClauses})
+       ORDER BY time_created ASC`, [sinceMs, ...providerIds]);
+    }
     /** Get the database file's mtime (ms epoch). Returns 0 if unavailable. */
     getDbMtime() {
         try {

package/dist/quota.d.ts

@@ -28,7 +28,7 @@ export interface QuotaState {
     /** Projected 7-day utilization at reset (percentage, capped at 200) */
     projectedSevenDay?: number;
     /** Provider that produced this quota sample */
-    providerId?: 'claude-code' | 'codex';
+    providerId?: 'claude-code' | 'codex' | 'zai';
     /** Source of the sample */
     source?: 'api' | 'session' | 'cache';
     /** ISO timestamp when the sample was captured */

package/dist/quotaHistory.d.ts

@@ -6,7 +6,7 @@
  * dashboard, the `sidekick quota history` CLI, contextful_desktop) can render heatmaps and
  * trend visualisations over a 13-week window.
  */
-export type QuotaHistoryRuntimeProvider = 'claude' | 'codex';
+export type QuotaHistoryRuntimeProvider = 'claude' | 'codex' | 'zai';
 export interface QuotaHistorySample {
     timestamp: string;
     runtimeProvider: QuotaHistoryRuntimeProvider;

package/dist/quotaHistory.js

@@ -201,7 +201,7 @@ function pruneFileSync(filePath, retentionDays) {
     return { kept: keptLines.length, pruned };
 }
 function sampleToQuotaState(sample) {
-    const providerId = sample.runtimeProvider === 'claude' ? 'claude-code' : 'codex';
+    const providerId = runtimeProviderToSnapshotProvider(sample.runtimeProvider);
     return {
         fiveHour: { utilization: sample.fiveHour.utilization, resetsAt: sample.fiveHour.resetsAt },
         sevenDay: { utilization: sample.sevenDay.utilization, resetsAt: sample.sevenDay.resetsAt },
@@ -213,6 +213,18 @@ function sampleToQuotaState(sample) {
         stale: sample.stale,
     };
 }
+/**
+ * Maps a runtime provider to the snapshot storage key.
+ * `'zai'` is allowed at the storage layer even though it is not part of
+ * `AccountProviderId` (z.ai has no full account management in v1).
+ */
+function runtimeProviderToSnapshotProvider(runtime) {
+    if (runtime === 'claude')
+        return 'claude-code';
+    if (runtime === 'zai')
+        return 'zai';
+    return 'codex';
+}
 async function runAppend(sample, filePath, options) {
     let lastTs = lastWriteCache.get(filePath);
     if (lastTs === undefined) {
@@ -243,7 +255,7 @@ async function runAppend(sample, filePath, options) {
     // Backwards-compat: keep the latest-snapshot store hot so existing callers (DashboardViewProvider,
     // codex session provider, contextful_desktop) don't have to query history for "latest".
     try {
-        const providerId = sample.runtimeProvider === 'claude' ? 'claude-code' : 'codex';
+        const providerId = runtimeProviderToSnapshotProvider(sample.runtimeProvider);
         (0, quotaSnapshots_1.writeQuotaSnapshot)(providerId, sample.providerId, sampleToQuotaState(sample));
     }
     catch {

package/dist/quotaSnapshots.d.ts

@@ -1,4 +1,10 @@
 import type { QuotaState } from './quota';
 import type { AccountProviderId } from './accountRegistry';
-export declare function writeQuotaSnapshot(providerId: AccountProviderId, accountId: string, quota: QuotaState): void;
-export declare function readQuotaSnapshot(providerId: AccountProviderId, accountId: string): QuotaState | null;
+/**
+ * Storage key for a quota snapshot. Extends `AccountProviderId` with `'zai'`
+ * because z.ai has no full account-management surface in v1, but the snapshot
+ * store still needs a stable key for the derived z.ai quota cache.
+ */
+export type QuotaSnapshotProviderId = AccountProviderId | 'zai';
+export declare function writeQuotaSnapshot(providerId: QuotaSnapshotProviderId, accountId: string, quota: QuotaState): void;
+export declare function readQuotaSnapshot(providerId: QuotaSnapshotProviderId, accountId: string): QuotaState | null;