sidekick-shared 0.25.0 → 0.26.0

package/dist/schemas/quota.d.ts

@@ -29,6 +29,17 @@ export declare const quotaSourceSchema: z.ZodEnum<{
     api: "api";
     cache: "cache";
     session: "session";
+    statusline: "statusline";
+}>;
+export declare const quotaCapturedSourceSchema: z.ZodEnum<{
+    api: "api";
+    session: "session";
+    statusline: "statusline";
+}>;
+export declare const quotaFreshnessSchema: z.ZodEnum<{
+    fresh: "fresh";
+    aging: "aging";
+    stale: "stale";
 }>;
 export declare const codexResetCreditSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
@@ -84,9 +95,21 @@ export declare const quotaStateSchema: z.ZodObject<{
         api: "api";
         cache: "cache";
         session: "session";
+        statusline: "statusline";
+    }>>;
+    capturedSource: z.ZodOptional<z.ZodEnum<{
+        api: "api";
+        session: "session";
+        statusline: "statusline";
     }>>;
     capturedAt: z.ZodOptional<z.ZodString>;
     stale: z.ZodOptional<z.ZodBoolean>;
+    ageMs: z.ZodOptional<z.ZodNumber>;
+    freshness: z.ZodOptional<z.ZodEnum<{
+        fresh: "fresh";
+        aging: "aging";
+        stale: "stale";
+    }>>;
     fiveHourLabel: z.ZodOptional<z.ZodString>;
     sevenDayLabel: z.ZodOptional<z.ZodString>;
     limitId: z.ZodOptional<z.ZodString>;
@@ -131,6 +154,10 @@ export declare const peakHoursStateSchema: z.ZodObject<{
     updatedAt: z.ZodString;
     unavailable: z.ZodBoolean;
     notApplicable: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodOptional<z.ZodEnum<{
+        promoclock: "promoclock";
+        schedule: "schedule";
+    }>>;
 }, z.core.$strip>;
 export declare const quotaFailureDescriptorSchema: z.ZodObject<{
     severity: z.ZodEnum<{
@@ -180,9 +207,21 @@ export declare const providerQuotaStateSchema: z.ZodObject<{
         api: "api";
         cache: "cache";
         session: "session";
+        statusline: "statusline";
+    }>>;
+    capturedSource: z.ZodOptional<z.ZodEnum<{
+        api: "api";
+        session: "session";
+        statusline: "statusline";
     }>>;
     capturedAt: z.ZodOptional<z.ZodString>;
     stale: z.ZodOptional<z.ZodBoolean>;
+    ageMs: z.ZodOptional<z.ZodNumber>;
+    freshness: z.ZodOptional<z.ZodEnum<{
+        fresh: "fresh";
+        aging: "aging";
+        stale: "stale";
+    }>>;
     fiveHourLabel: z.ZodOptional<z.ZodString>;
     sevenDayLabel: z.ZodOptional<z.ZodString>;
     limitId: z.ZodOptional<z.ZodString>;
@@ -228,6 +267,10 @@ export declare const providerQuotaStateSchema: z.ZodObject<{
         updatedAt: z.ZodString;
         unavailable: z.ZodBoolean;
         notApplicable: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodEnum<{
+            promoclock: "promoclock";
+            schedule: "schedule";
+        }>>;
     }, z.core.$strip>>>;
     failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         severity: z.ZodEnum<{
@@ -278,9 +321,21 @@ export declare const claudeProviderQuotaStateSchema: z.ZodObject<{
         api: "api";
         cache: "cache";
         session: "session";
+        statusline: "statusline";
+    }>>;
+    capturedSource: z.ZodOptional<z.ZodEnum<{
+        api: "api";
+        session: "session";
+        statusline: "statusline";
     }>>;
     capturedAt: z.ZodOptional<z.ZodString>;
     stale: z.ZodOptional<z.ZodBoolean>;
+    ageMs: z.ZodOptional<z.ZodNumber>;
+    freshness: z.ZodOptional<z.ZodEnum<{
+        fresh: "fresh";
+        aging: "aging";
+        stale: "stale";
+    }>>;
     fiveHourLabel: z.ZodOptional<z.ZodString>;
     sevenDayLabel: z.ZodOptional<z.ZodString>;
     limitId: z.ZodOptional<z.ZodString>;
@@ -326,6 +381,10 @@ export declare const claudeProviderQuotaStateSchema: z.ZodObject<{
         updatedAt: z.ZodString;
         unavailable: z.ZodBoolean;
         notApplicable: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodEnum<{
+            promoclock: "promoclock";
+            schedule: "schedule";
+        }>>;
     }, z.core.$strip>>>;
     failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         severity: z.ZodEnum<{
@@ -372,9 +431,21 @@ export declare const codexProviderQuotaStateSchema: z.ZodObject<{
         api: "api";
         cache: "cache";
         session: "session";
+        statusline: "statusline";
+    }>>;
+    capturedSource: z.ZodOptional<z.ZodEnum<{
+        api: "api";
+        session: "session";
+        statusline: "statusline";
     }>>;
     capturedAt: z.ZodOptional<z.ZodString>;
     stale: z.ZodOptional<z.ZodBoolean>;
+    ageMs: z.ZodOptional<z.ZodNumber>;
+    freshness: z.ZodOptional<z.ZodEnum<{
+        fresh: "fresh";
+        aging: "aging";
+        stale: "stale";
+    }>>;
     fiveHourLabel: z.ZodOptional<z.ZodString>;
     sevenDayLabel: z.ZodOptional<z.ZodString>;
     limitId: z.ZodOptional<z.ZodString>;
@@ -420,6 +491,10 @@ export declare const codexProviderQuotaStateSchema: z.ZodObject<{
         updatedAt: z.ZodString;
         unavailable: z.ZodBoolean;
         notApplicable: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodEnum<{
+            promoclock: "promoclock";
+            schedule: "schedule";
+        }>>;
     }, z.core.$strip>>>;
     failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         severity: z.ZodEnum<{
@@ -466,9 +541,21 @@ export declare const zaiProviderQuotaStateSchema: z.ZodObject<{
         api: "api";
         cache: "cache";
         session: "session";
+        statusline: "statusline";
+    }>>;
+    capturedSource: z.ZodOptional<z.ZodEnum<{
+        api: "api";
+        session: "session";
+        statusline: "statusline";
     }>>;
     capturedAt: z.ZodOptional<z.ZodString>;
     stale: z.ZodOptional<z.ZodBoolean>;
+    ageMs: z.ZodOptional<z.ZodNumber>;
+    freshness: z.ZodOptional<z.ZodEnum<{
+        fresh: "fresh";
+        aging: "aging";
+        stale: "stale";
+    }>>;
     fiveHourLabel: z.ZodOptional<z.ZodString>;
     sevenDayLabel: z.ZodOptional<z.ZodString>;
     limitId: z.ZodOptional<z.ZodString>;
@@ -514,6 +601,10 @@ export declare const zaiProviderQuotaStateSchema: z.ZodObject<{
         updatedAt: z.ZodString;
         unavailable: z.ZodBoolean;
         notApplicable: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodEnum<{
+            promoclock: "promoclock";
+            schedule: "schedule";
+        }>>;
     }, z.core.$strip>>>;
     failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         severity: z.ZodEnum<{
@@ -561,9 +652,21 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
             api: "api";
             cache: "cache";
             session: "session";
+            statusline: "statusline";
+        }>>;
+        capturedSource: z.ZodOptional<z.ZodEnum<{
+            api: "api";
+            session: "session";
+            statusline: "statusline";
         }>>;
         capturedAt: z.ZodOptional<z.ZodString>;
         stale: z.ZodOptional<z.ZodBoolean>;
+        ageMs: z.ZodOptional<z.ZodNumber>;
+        freshness: z.ZodOptional<z.ZodEnum<{
+            fresh: "fresh";
+            aging: "aging";
+            stale: "stale";
+        }>>;
         fiveHourLabel: z.ZodOptional<z.ZodString>;
         sevenDayLabel: z.ZodOptional<z.ZodString>;
         limitId: z.ZodOptional<z.ZodString>;
@@ -609,6 +712,10 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
             updatedAt: z.ZodString;
             unavailable: z.ZodBoolean;
             notApplicable: z.ZodOptional<z.ZodBoolean>;
+            source: z.ZodOptional<z.ZodEnum<{
+                promoclock: "promoclock";
+                schedule: "schedule";
+            }>>;
         }, z.core.$strip>>>;
         failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             severity: z.ZodEnum<{
@@ -655,9 +762,21 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
             api: "api";
             cache: "cache";
             session: "session";
+            statusline: "statusline";
+        }>>;
+        capturedSource: z.ZodOptional<z.ZodEnum<{
+            api: "api";
+            session: "session";
+            statusline: "statusline";
         }>>;
         capturedAt: z.ZodOptional<z.ZodString>;
         stale: z.ZodOptional<z.ZodBoolean>;
+        ageMs: z.ZodOptional<z.ZodNumber>;
+        freshness: z.ZodOptional<z.ZodEnum<{
+            fresh: "fresh";
+            aging: "aging";
+            stale: "stale";
+        }>>;
         fiveHourLabel: z.ZodOptional<z.ZodString>;
         sevenDayLabel: z.ZodOptional<z.ZodString>;
         limitId: z.ZodOptional<z.ZodString>;
@@ -703,6 +822,10 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
             updatedAt: z.ZodString;
             unavailable: z.ZodBoolean;
             notApplicable: z.ZodOptional<z.ZodBoolean>;
+            source: z.ZodOptional<z.ZodEnum<{
+                promoclock: "promoclock";
+                schedule: "schedule";
+            }>>;
         }, z.core.$strip>>>;
         failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             severity: z.ZodEnum<{
@@ -749,9 +872,21 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
             api: "api";
             cache: "cache";
             session: "session";
+            statusline: "statusline";
+        }>>;
+        capturedSource: z.ZodOptional<z.ZodEnum<{
+            api: "api";
+            session: "session";
+            statusline: "statusline";
         }>>;
         capturedAt: z.ZodOptional<z.ZodString>;
         stale: z.ZodOptional<z.ZodBoolean>;
+        ageMs: z.ZodOptional<z.ZodNumber>;
+        freshness: z.ZodOptional<z.ZodEnum<{
+            fresh: "fresh";
+            aging: "aging";
+            stale: "stale";
+        }>>;
         fiveHourLabel: z.ZodOptional<z.ZodString>;
         sevenDayLabel: z.ZodOptional<z.ZodString>;
         limitId: z.ZodOptional<z.ZodString>;
@@ -797,6 +932,10 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
             updatedAt: z.ZodString;
             unavailable: z.ZodBoolean;
             notApplicable: z.ZodOptional<z.ZodBoolean>;
+            source: z.ZodOptional<z.ZodEnum<{
+                promoclock: "promoclock";
+                schedule: "schedule";
+            }>>;
         }, z.core.$strip>>>;
         failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             severity: z.ZodEnum<{

package/dist/schemas/quota.js

@@ -10,7 +10,7 @@
  * @module schemas/quota
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaWindowSchema = void 0;
+exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaFreshnessSchema = exports.quotaCapturedSourceSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaWindowSchema = void 0;
 const zod_1 = require("zod");
 const providerIds_1 = require("../providerIds");
 // ── QuotaWindow ──
@@ -27,7 +27,18 @@ exports.quotaFailureKindSchema = zod_1.z.enum([
     'unknown',
 ]);
 exports.quotaProviderIdSchema = zod_1.z.enum(providerIds_1.QUOTA_PROVIDER_IDS);
-exports.quotaSourceSchema = zod_1.z.enum(['api', 'session', 'cache']);
+exports.quotaSourceSchema = zod_1.z.enum([
+    'api',
+    'session',
+    'cache',
+    'statusline',
+]);
+exports.quotaCapturedSourceSchema = zod_1.z.enum([
+    'api',
+    'session',
+    'statusline',
+]);
+exports.quotaFreshnessSchema = zod_1.z.enum(['fresh', 'aging', 'stale']);
 exports.codexResetCreditSchema = zod_1.z.object({
     title: zod_1.z.string().optional(),
     status: zod_1.z.string(),
@@ -54,8 +65,11 @@ exports.quotaStateSchema = zod_1.z.object({
     projectedSevenDay: zod_1.z.number().optional(),
     providerId: exports.quotaProviderIdSchema.optional(),
     source: exports.quotaSourceSchema.optional(),
+    capturedSource: exports.quotaCapturedSourceSchema.optional(),
     capturedAt: zod_1.z.string().optional(),
     stale: zod_1.z.boolean().optional(),
+    ageMs: zod_1.z.number().finite().nonnegative().optional(),
+    freshness: exports.quotaFreshnessSchema.optional(),
     fiveHourLabel: zod_1.z.string().optional(),
     sevenDayLabel: zod_1.z.string().optional(),
     limitId: zod_1.z.string().optional(),
@@ -78,6 +92,7 @@ exports.peakHoursStateSchema = zod_1.z.object({
     updatedAt: zod_1.z.string(),
     unavailable: zod_1.z.boolean(),
     notApplicable: zod_1.z.boolean().optional(),
+    source: zod_1.z.enum(['promoclock', 'schedule']).optional(),
 });
 // ── QuotaFailureDescriptor ──
 exports.quotaFailureDescriptorSchema = zod_1.z.object({

package/dist/schemas/quotaHistory.d.ts

@@ -37,6 +37,7 @@ export declare const quotaHistorySampleSchema: z.ZodObject<{
         api: "api";
         cache: "cache";
         session: "session";
+        statusline: "statusline";
     }>>;
     stale: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;

package/dist/schemas/quotaHistory.js

@@ -28,7 +28,7 @@ exports.quotaHistorySampleSchema = zod_1.z.object({
     sevenDay: zod_1.z.object({ utilization: zod_1.z.number(), resetsAt: zod_1.z.string() }),
     available: zod_1.z.boolean(),
     error: zod_1.z.string().optional(),
-    source: zod_1.z.enum(['session', 'cache', 'api']).optional(),
+    source: zod_1.z.enum(['session', 'cache', 'api', 'statusline']).optional(),
     stale: zod_1.z.boolean().optional(),
 });
 // ── QuotaHistoryDailyBucket ──

package/dist/schemas/sessionEvent.d.ts

@@ -52,6 +52,7 @@ export declare const sessionMessageSchema: z.ZodObject<{
         }, z.core.$strip>;
     }, z.core.$strip>>;
     content: z.ZodOptional<z.ZodUnknown>;
+    stop_reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const permissionModeSchema: z.ZodEnum<{
     default: "default";
@@ -136,6 +137,7 @@ export declare const userSessionEventSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
         content: z.ZodOptional<z.ZodUnknown>;
+        stop_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const assistantSessionEventSchema: z.ZodObject<{
@@ -215,6 +217,7 @@ export declare const assistantSessionEventSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
         content: z.ZodOptional<z.ZodUnknown>;
+        stop_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const summarySessionEventSchema: z.ZodType<SummarySessionEvent>;
@@ -295,6 +298,7 @@ export declare const systemSessionEventSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
         content: z.ZodOptional<z.ZodUnknown>;
+        stop_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const toolUseSessionEventSchema: z.ZodObject<{
@@ -378,6 +382,7 @@ export declare const toolUseSessionEventSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
         content: z.ZodOptional<z.ZodUnknown>;
+        stop_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const toolResultSessionEventSchema: z.ZodObject<{
@@ -462,6 +467,7 @@ export declare const toolResultSessionEventSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
         content: z.ZodOptional<z.ZodUnknown>;
+        stop_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const sessionEventSchema: z.ZodType<SessionEvent>;

package/dist/schemas/sessionEvent.js

@@ -30,6 +30,7 @@ exports.sessionMessageSchema = zod_1.z.object({
     usage: exports.messageUsageSchema.optional(),
     normalizedUsage: usageNormalization_1.normalizedUsageSchema.optional(),
     content: zod_1.z.unknown().optional(),
+    stop_reason: zod_1.z.string().optional(),
 });
 // ── PermissionMode ──
 exports.permissionModeSchema = zod_1.z.enum([

package/dist/schemas/stateFile.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Zod schema for the public `state.json` contract (`schemaVersion: 1`).
+ *
+ * Mirrors the interfaces in `stateFile.ts` (keep in sync when those change;
+ * fields are only ever added). Consumers validating the file from another
+ * process import this from `sidekick-shared/schemas`.
+ *
+ * @module schemas/stateFile
+ */
+import { z } from 'zod';
+export declare const stateFileWriterSchema: z.ZodEnum<{
+    statusline: "statusline";
+    "cli-dashboard": "cli-dashboard";
+    "vscode-dashboard": "vscode-dashboard";
+}>;
+export declare const stateFileQuotaWindowSchema: z.ZodObject<{
+    utilization: z.ZodNumber;
+    resetsAt: z.ZodString;
+}, z.core.$strip>;
+export declare const stateFileQuotaSchema: z.ZodObject<{
+    fiveHour: z.ZodObject<{
+        utilization: z.ZodNumber;
+        resetsAt: z.ZodString;
+    }, z.core.$strip>;
+    sevenDay: z.ZodObject<{
+        utilization: z.ZodNumber;
+        resetsAt: z.ZodString;
+    }, z.core.$strip>;
+    source: z.ZodNullable<z.ZodEnum<{
+        api: "api";
+        cache: "cache";
+        session: "session";
+        statusline: "statusline";
+    }>>;
+    capturedSource: z.ZodNullable<z.ZodEnum<{
+        api: "api";
+        session: "session";
+        statusline: "statusline";
+    }>>;
+    capturedAt: z.ZodNullable<z.ZodString>;
+    ageMs: z.ZodNullable<z.ZodNumber>;
+    freshness: z.ZodNullable<z.ZodEnum<{
+        fresh: "fresh";
+        aging: "aging";
+        stale: "stale";
+    }>>;
+}, z.core.$strip>;
+export declare const stateFileAccountSchema: z.ZodObject<{
+    providerId: z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+    }>;
+    id: z.ZodNullable<z.ZodString>;
+    label: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const stateFileContextSchema: z.ZodObject<{
+    usedPercentage: z.ZodNullable<z.ZodNumber>;
+    contextWindowSize: z.ZodNullable<z.ZodNumber>;
+    totalInputTokens: z.ZodNullable<z.ZodNumber>;
+    totalOutputTokens: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const stateFileSessionSchema: z.ZodObject<{
+    sessionId: z.ZodNullable<z.ZodString>;
+    cwd: z.ZodNullable<z.ZodString>;
+    model: z.ZodNullable<z.ZodString>;
+    costUsd: z.ZodNullable<z.ZodNumber>;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    linesAdded: z.ZodNullable<z.ZodNumber>;
+    linesRemoved: z.ZodNullable<z.ZodNumber>;
+    promptCacheHitRatio: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const stateFileBillingBlockSchema: z.ZodObject<{
+    start: z.ZodString;
+    end: z.ZodString;
+    isActive: z.ZodBoolean;
+    tokens: z.ZodNumber;
+    costUsd: z.ZodNumber;
+    costProvenance: z.ZodEnum<{
+        none: "none";
+        reported: "reported";
+        estimated: "estimated";
+        unpriced: "unpriced";
+        mixed: "mixed";
+    }>;
+    burnRatePerMinute: z.ZodNumber;
+    projectedTokens: z.ZodNumber;
+    projectedCostUsd: z.ZodNumber;
+    remainingMs: z.ZodNumber;
+}, z.core.$strip>;
+export declare const sidekickStateFileSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    writtenAt: z.ZodString;
+    writer: z.ZodEnum<{
+        statusline: "statusline";
+        "cli-dashboard": "cli-dashboard";
+        "vscode-dashboard": "vscode-dashboard";
+    }>;
+    account: z.ZodNullable<z.ZodObject<{
+        providerId: z.ZodEnum<{
+            "claude-code": "claude-code";
+            codex: "codex";
+        }>;
+        id: z.ZodNullable<z.ZodString>;
+        label: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    quota: z.ZodObject<{
+        claude: z.ZodNullable<z.ZodObject<{
+            fiveHour: z.ZodObject<{
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodString;
+            }, z.core.$strip>;
+            sevenDay: z.ZodObject<{
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodString;
+            }, z.core.$strip>;
+            source: z.ZodNullable<z.ZodEnum<{
+                api: "api";
+                cache: "cache";
+                session: "session";
+                statusline: "statusline";
+            }>>;
+            capturedSource: z.ZodNullable<z.ZodEnum<{
+                api: "api";
+                session: "session";
+                statusline: "statusline";
+            }>>;
+            capturedAt: z.ZodNullable<z.ZodString>;
+            ageMs: z.ZodNullable<z.ZodNumber>;
+            freshness: z.ZodNullable<z.ZodEnum<{
+                fresh: "fresh";
+                aging: "aging";
+                stale: "stale";
+            }>>;
+        }, z.core.$strip>>;
+        codex: z.ZodNullable<z.ZodObject<{
+            fiveHour: z.ZodObject<{
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodString;
+            }, z.core.$strip>;
+            sevenDay: z.ZodObject<{
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodString;
+            }, z.core.$strip>;
+            source: z.ZodNullable<z.ZodEnum<{
+                api: "api";
+                cache: "cache";
+                session: "session";
+                statusline: "statusline";
+            }>>;
+            capturedSource: z.ZodNullable<z.ZodEnum<{
+                api: "api";
+                session: "session";
+                statusline: "statusline";
+            }>>;
+            capturedAt: z.ZodNullable<z.ZodString>;
+            ageMs: z.ZodNullable<z.ZodNumber>;
+            freshness: z.ZodNullable<z.ZodEnum<{
+                fresh: "fresh";
+                aging: "aging";
+                stale: "stale";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    context: z.ZodNullable<z.ZodObject<{
+        usedPercentage: z.ZodNullable<z.ZodNumber>;
+        contextWindowSize: z.ZodNullable<z.ZodNumber>;
+        totalInputTokens: z.ZodNullable<z.ZodNumber>;
+        totalOutputTokens: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    session: z.ZodNullable<z.ZodObject<{
+        sessionId: z.ZodNullable<z.ZodString>;
+        cwd: z.ZodNullable<z.ZodString>;
+        model: z.ZodNullable<z.ZodString>;
+        costUsd: z.ZodNullable<z.ZodNumber>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        linesAdded: z.ZodNullable<z.ZodNumber>;
+        linesRemoved: z.ZodNullable<z.ZodNumber>;
+        promptCacheHitRatio: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    billingBlock: z.ZodNullable<z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+        isActive: z.ZodBoolean;
+        tokens: z.ZodNumber;
+        costUsd: z.ZodNumber;
+        costProvenance: z.ZodEnum<{
+            none: "none";
+            reported: "reported";
+            estimated: "estimated";
+            unpriced: "unpriced";
+            mixed: "mixed";
+        }>;
+        burnRatePerMinute: z.ZodNumber;
+        projectedTokens: z.ZodNumber;
+        projectedCostUsd: z.ZodNumber;
+        remainingMs: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

package/dist/schemas/stateFile.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Zod schema for the public `state.json` contract (`schemaVersion: 1`).
+ *
+ * Mirrors the interfaces in `stateFile.ts` (keep in sync when those change;
+ * fields are only ever added). Consumers validating the file from another
+ * process import this from `sidekick-shared/schemas`.
+ *
+ * @module schemas/stateFile
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sidekickStateFileSchema = exports.stateFileBillingBlockSchema = exports.stateFileSessionSchema = exports.stateFileContextSchema = exports.stateFileAccountSchema = exports.stateFileQuotaSchema = exports.stateFileQuotaWindowSchema = exports.stateFileWriterSchema = void 0;
+const zod_1 = require("zod");
+exports.stateFileWriterSchema = zod_1.z.enum([
+    'statusline',
+    'cli-dashboard',
+    'vscode-dashboard',
+]);
+exports.stateFileQuotaWindowSchema = zod_1.z.object({
+    utilization: zod_1.z.number(),
+    resetsAt: zod_1.z.string(),
+});
+exports.stateFileQuotaSchema = zod_1.z.object({
+    fiveHour: exports.stateFileQuotaWindowSchema,
+    sevenDay: exports.stateFileQuotaWindowSchema,
+    source: zod_1.z.enum(['api', 'session', 'cache', 'statusline']).nullable(),
+    capturedSource: zod_1.z.enum(['api', 'session', 'statusline']).nullable(),
+    capturedAt: zod_1.z.string().nullable(),
+    ageMs: zod_1.z.number().nullable(),
+    freshness: zod_1.z.enum(['fresh', 'aging', 'stale']).nullable(),
+});
+exports.stateFileAccountSchema = zod_1.z.object({
+    providerId: zod_1.z.enum(['claude-code', 'codex']),
+    id: zod_1.z.string().nullable(),
+    label: zod_1.z.string().nullable(),
+});
+exports.stateFileContextSchema = zod_1.z.object({
+    usedPercentage: zod_1.z.number().nullable(),
+    contextWindowSize: zod_1.z.number().nullable(),
+    totalInputTokens: zod_1.z.number().nullable(),
+    totalOutputTokens: zod_1.z.number().nullable(),
+});
+exports.stateFileSessionSchema = zod_1.z.object({
+    sessionId: zod_1.z.string().nullable(),
+    cwd: zod_1.z.string().nullable(),
+    model: zod_1.z.string().nullable(),
+    costUsd: zod_1.z.number().nullable(),
+    durationMs: zod_1.z.number().nullable(),
+    linesAdded: zod_1.z.number().nullable(),
+    linesRemoved: zod_1.z.number().nullable(),
+    promptCacheHitRatio: zod_1.z.number().nullable(),
+});
+exports.stateFileBillingBlockSchema = zod_1.z.object({
+    start: zod_1.z.string(),
+    end: zod_1.z.string(),
+    isActive: zod_1.z.boolean(),
+    tokens: zod_1.z.number(),
+    costUsd: zod_1.z.number(),
+    costProvenance: zod_1.z.enum(['reported', 'estimated', 'mixed', 'unpriced', 'none']),
+    burnRatePerMinute: zod_1.z.number(),
+    projectedTokens: zod_1.z.number(),
+    projectedCostUsd: zod_1.z.number(),
+    remainingMs: zod_1.z.number(),
+});
+exports.sidekickStateFileSchema = zod_1.z.object({
+    schemaVersion: zod_1.z.literal(1),
+    writtenAt: zod_1.z.string(),
+    writer: exports.stateFileWriterSchema,
+    account: exports.stateFileAccountSchema.nullable(),
+    quota: zod_1.z.object({
+        claude: exports.stateFileQuotaSchema.nullable(),
+        codex: exports.stateFileQuotaSchema.nullable(),
+    }),
+    context: exports.stateFileContextSchema.nullable(),
+    session: exports.stateFileSessionSchema.nullable(),
+    billingBlock: exports.stateFileBillingBlockSchema.nullable(),
+});

package/dist/schemas/transcript.js

@@ -78,6 +78,8 @@ exports.canonicalSessionTranscriptSchema = zod_1.z.object({
             totalTokens: zod_1.z.number().finite().nonnegative(),
         }),
         totalCostUsd: zod_1.z.number().finite().nonnegative().nullable(),
+        pricedCostUsd: zod_1.z.number().finite().nonnegative(),
+        unpricedEvents: zod_1.z.number().int().nonnegative(),
     }),
     provenance: zod_1.z.object({
         source: zod_1.z.literal('session-events'),