sidekick-shared 0.13.4 → 0.13.5

package/README.md

@@ -29,6 +29,7 @@ npm install sidekick-shared
 | **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) |
+| **Provider Status** | Claude API health checking via status.claude.com (indicator, components, incidents) |
 
 ## Usage Examples
 
@@ -54,6 +55,20 @@ const tasks = readTasks({ projectSlug: slug });
 console.log(`Found ${tasks.length} tasks`);
 ```
 
+### Check provider status
+
+```typescript
+import { fetchProviderStatus } from 'sidekick-shared';
+
+const status = await fetchProviderStatus();
+if (status.indicator !== 'none') {
+  console.log(`Claude API: ${status.description}`);
+  for (const c of status.affectedComponents) {
+    console.log(`  ${c.name}: ${c.status}`);
+  }
+}
+```
+
 ### Fetch subscription quota
 
 ```typescript

package/dist/index.d.ts

@@ -83,3 +83,5 @@ export { readClaudeMaxCredentials, readClaudeMaxAccessTokenSync } from './creden
 export type { ClaudeMaxCredentials } from './credentials';
 export { fetchQuota } from './quota';
 export type { QuotaWindow, QuotaState } from './quota';
+export { fetchProviderStatus } from './providerStatus';
+export type { ProviderStatusState } from './providerStatus';

package/dist/index.js

@@ -5,7 +5,7 @@
 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.HeatmapTracker = exports.FrequencyTracker = exports.getSnapshotPath = exports.isSnapshotValid = exports.deleteSnapshot = exports.loadSnapshot = exports.saveSnapshot = exports.parseTodoDependencies = exports.EventAggregator = exports.getRandomPhrase = 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.toFollowEvents = exports.createWatcher = exports.parseChangelog = exports.extractProposedPlanShared = exports.parsePlanMarkdownShared = exports.PlanExtractor = 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.fetchQuota = exports.readClaudeMaxAccessTokenSync = exports.readClaudeMaxCredentials = exports.openInBrowser = exports.parseTranscript = exports.generateHtmlReport = exports.PatternExtractor = void 0;
+exports.fetchProviderStatus = exports.fetchQuota = exports.readClaudeMaxAccessTokenSync = exports.readClaudeMaxCredentials = exports.openInBrowser = exports.parseTranscript = exports.generateHtmlReport = exports.PatternExtractor = 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; } });
@@ -181,3 +181,6 @@ Object.defineProperty(exports, "readClaudeMaxAccessTokenSync", { enumerable: tru
 // Quota
 var quota_1 = require("./quota");
 Object.defineProperty(exports, "fetchQuota", { enumerable: true, get: function () { return quota_1.fetchQuota; } });
+// Provider Status
+var providerStatus_1 = require("./providerStatus");
+Object.defineProperty(exports, "fetchProviderStatus", { enumerable: true, get: function () { return providerStatus_1.fetchProviderStatus; } });

package/dist/providerStatus.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Stateless provider status fetcher for Claude API health.
+ *
+ * Calls the Atlassian Statuspage API at status.claude.com and returns
+ * current status information. Polling / eventing is the caller's responsibility.
+ */
+export interface ProviderStatusState {
+    indicator: 'none' | 'minor' | 'major' | 'critical';
+    description: string;
+    affectedComponents: Array<{
+        name: string;
+        status: string;
+    }>;
+    activeIncident: {
+        name: string;
+        impact: string;
+        shortlink: string;
+        updatedAt: string;
+    } | null;
+    updatedAt: string;
+}
+/**
+ * Fetch current Claude API status from status.claude.com.
+ *
+ * This is a **single-shot** function — it does not poll. The caller wraps
+ * it in a polling loop, VS Code EventEmitter, or CLI interval as needed.
+ *
+ * @returns ProviderStatusState with indicator, affected components, and active incident
+ */
+export declare function fetchProviderStatus(): Promise<ProviderStatusState>;

package/dist/providerStatus.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Stateless provider status fetcher for Claude API health.
+ *
+ * Calls the Atlassian Statuspage API at status.claude.com and returns
+ * current status information. Polling / eventing is the caller's responsibility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchProviderStatus = fetchProviderStatus;
+const STATUS_URL = 'https://status.claude.com/api/v2/status.json';
+const SUMMARY_URL = 'https://status.claude.com/api/v2/summary.json';
+function fallbackState() {
+    return {
+        indicator: 'none',
+        description: 'Status unavailable',
+        affectedComponents: [],
+        activeIncident: null,
+        updatedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Fetch current Claude API status from status.claude.com.
+ *
+ * This is a **single-shot** function — it does not poll. The caller wraps
+ * it in a polling loop, VS Code EventEmitter, or CLI interval as needed.
+ *
+ * @returns ProviderStatusState with indicator, affected components, and active incident
+ */
+async function fetchProviderStatus() {
+    try {
+        const statusRes = await fetch(STATUS_URL);
+        if (!statusRes.ok)
+            return fallbackState();
+        const statusData = await statusRes.json();
+        const indicator = (statusData.status?.indicator ?? 'none');
+        const description = statusData.status?.description ?? '';
+        const updatedAt = statusData.page?.updated_at ?? new Date().toISOString();
+        // All operational — no need to fetch summary
+        if (indicator === 'none') {
+            return { indicator, description, affectedComponents: [], activeIncident: null, updatedAt };
+        }
+        // Degraded — fetch summary for components + incidents
+        const summaryRes = await fetch(SUMMARY_URL);
+        if (!summaryRes.ok) {
+            return { indicator, description, affectedComponents: [], activeIncident: null, updatedAt };
+        }
+        const summaryData = await summaryRes.json();
+        // Filter to non-operational components only
+        const affectedComponents = (summaryData.components ?? [])
+            .filter(c => c.status && c.status !== 'operational')
+            .map(c => ({ name: c.name ?? 'Unknown', status: c.status ?? 'unknown' }));
+        // Pick first unresolved incident
+        const unresolvedIncident = (summaryData.incidents ?? [])
+            .find(i => i.status !== 'resolved' && i.status !== 'postmortem');
+        const activeIncident = unresolvedIncident
+            ? {
+                name: unresolvedIncident.name ?? 'Unknown incident',
+                impact: unresolvedIncident.impact ?? 'unknown',
+                shortlink: unresolvedIncident.shortlink ?? '',
+                updatedAt: unresolvedIncident.updated_at ?? updatedAt,
+            }
+            : null;
+        return { indicator, description, affectedComponents, activeIncident, updatedAt };
+    }
+    catch {
+        return fallbackState();
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sidekick-shared",
-  "version": "0.13.4",
+  "version": "0.13.5",
   "description": "Shared data access layer for Sidekick — readers, types, providers, credentials, quota",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",