sidekick-shared 0.19.0 → 0.19.2

package/dist/schemas/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Schemas entry (`sidekick-shared/schemas`).
+ *
+ * Pure zod runtime validation for the data shapes that cross process/IPC
+ * boundaries: session events, quota state, quota history, account status,
+ * and assistant turn projections. No node:fs / node:path — safe to bundle
+ * for browser runtimes, and lean enough that importing it does not drag in
+ * the rest of the library.
+ *
+ * The mirrored TypeScript interfaces are re-exported as types so this
+ * subpath is self-sufficient for boundary-validation modules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assistantTurnToolRefSchema = exports.assistantTurnToolGroupStepSchema = exports.assistantTurnSubagentStatusSchema = exports.assistantTurnSubagentSchema = exports.assistantTurnProjectionSchema = exports.assistantTurnProcessStepSchema = exports.assistantTurnProcessSchema = exports.assistantTurnNarrationStepSchema = exports.assistantTurnEventTypeSchema = exports.assistantTurnEventSchema = 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 = void 0;
+var sessionEvent_1 = require("./sessionEvent");
+Object.defineProperty(exports, "messageUsageSchema", { enumerable: true, get: function () { return sessionEvent_1.messageUsageSchema; } });
+Object.defineProperty(exports, "sessionMessageSchema", { enumerable: true, get: function () { return sessionEvent_1.sessionMessageSchema; } });
+Object.defineProperty(exports, "sessionEventSchema", { enumerable: true, get: function () { return sessionEvent_1.sessionEventSchema; } });
+Object.defineProperty(exports, "permissionModeSchema", { enumerable: true, get: function () { return sessionEvent_1.permissionModeSchema; } });
+Object.defineProperty(exports, "extractSessionEvents", { enumerable: true, get: function () { return sessionEvent_1.extractSessionEvents; } });
+var quota_1 = require("./quota");
+Object.defineProperty(exports, "quotaWindowSchema", { enumerable: true, get: function () { return quota_1.quotaWindowSchema; } });
+Object.defineProperty(exports, "quotaStateSchema", { enumerable: true, get: function () { return quota_1.quotaStateSchema; } });
+Object.defineProperty(exports, "quotaFailureKindSchema", { enumerable: true, get: function () { return quota_1.quotaFailureKindSchema; } });
+Object.defineProperty(exports, "quotaProviderIdSchema", { enumerable: true, get: function () { return quota_1.quotaProviderIdSchema; } });
+Object.defineProperty(exports, "quotaSourceSchema", { enumerable: true, get: function () { return quota_1.quotaSourceSchema; } });
+Object.defineProperty(exports, "peakHoursStateSchema", { enumerable: true, get: function () { return quota_1.peakHoursStateSchema; } });
+Object.defineProperty(exports, "quotaFailureDescriptorSchema", { enumerable: true, get: function () { return quota_1.quotaFailureDescriptorSchema; } });
+Object.defineProperty(exports, "runtimeQuotaProviderSchema", { enumerable: true, get: function () { return quota_1.runtimeQuotaProviderSchema; } });
+Object.defineProperty(exports, "providerQuotaStateSchema", { enumerable: true, get: function () { return quota_1.providerQuotaStateSchema; } });
+Object.defineProperty(exports, "claudeProviderQuotaStateSchema", { enumerable: true, get: function () { return quota_1.claudeProviderQuotaStateSchema; } });
+Object.defineProperty(exports, "codexProviderQuotaStateSchema", { enumerable: true, get: function () { return quota_1.codexProviderQuotaStateSchema; } });
+Object.defineProperty(exports, "providerQuotaMapSchema", { enumerable: true, get: function () { return quota_1.providerQuotaMapSchema; } });
+var quotaHistory_1 = require("./quotaHistory");
+Object.defineProperty(exports, "quotaHistoryRuntimeProviderSchema", { enumerable: true, get: function () { return quotaHistory_1.quotaHistoryRuntimeProviderSchema; } });
+Object.defineProperty(exports, "quotaHistorySampleSchema", { enumerable: true, get: function () { return quotaHistory_1.quotaHistorySampleSchema; } });
+Object.defineProperty(exports, "quotaHistoryDailyBucketSchema", { enumerable: true, get: function () { return quotaHistory_1.quotaHistoryDailyBucketSchema; } });
+var accountStatus_1 = require("./accountStatus");
+Object.defineProperty(exports, "activeProviderAccountStatusSchema", { enumerable: true, get: function () { return accountStatus_1.activeProviderAccountStatusSchema; } });
+Object.defineProperty(exports, "activeAccountStatusSchema", { enumerable: true, get: function () { return accountStatus_1.activeAccountStatusSchema; } });
+var assistantTurn_1 = require("./assistantTurn");
+Object.defineProperty(exports, "assistantTurnEventSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnEventSchema; } });
+Object.defineProperty(exports, "assistantTurnEventTypeSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnEventTypeSchema; } });
+Object.defineProperty(exports, "assistantTurnNarrationStepSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnNarrationStepSchema; } });
+Object.defineProperty(exports, "assistantTurnProcessSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnProcessSchema; } });
+Object.defineProperty(exports, "assistantTurnProcessStepSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnProcessStepSchema; } });
+Object.defineProperty(exports, "assistantTurnProjectionSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnProjectionSchema; } });
+Object.defineProperty(exports, "assistantTurnSubagentSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnSubagentSchema; } });
+Object.defineProperty(exports, "assistantTurnSubagentStatusSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnSubagentStatusSchema; } });
+Object.defineProperty(exports, "assistantTurnToolGroupStepSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnToolGroupStepSchema; } });
+Object.defineProperty(exports, "assistantTurnToolRefSchema", { enumerable: true, get: function () { return assistantTurn_1.assistantTurnToolRefSchema; } });

package/dist/schemas/quota.d.ts

@@ -0,0 +1,499 @@
+/**
+ * Zod schemas for runtime validation of quota state.
+ *
+ * These schemas mirror the TypeScript interfaces in `quota.ts`,
+ * `peakHours.ts`, `quotaPresentation.ts`, and `providerQuota.ts` (keep in
+ * sync when those change). They let consumers validate quota payloads at
+ * process/IPC boundaries without hand-mirroring the interfaces.
+ *
+ * @module schemas/quota
+ */
+import { z } from 'zod';
+export declare const quotaWindowSchema: z.ZodObject<{
+    utilization: z.ZodNumber;
+    resetsAt: z.ZodString;
+}, z.core.$strip>;
+export declare const quotaFailureKindSchema: z.ZodEnum<{
+    unknown: "unknown";
+    rate_limit: "rate_limit";
+    auth: "auth";
+    network: "network";
+    server: "server";
+}>;
+export declare const quotaProviderIdSchema: z.ZodEnum<{
+    "claude-code": "claude-code";
+    codex: "codex";
+}>;
+export declare const quotaSourceSchema: z.ZodEnum<{
+    session: "session";
+    api: "api";
+    cache: "cache";
+}>;
+export declare const quotaStateSchema: 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>;
+    available: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+    failureKind: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        rate_limit: "rate_limit";
+        auth: "auth";
+        network: "network";
+        server: "server";
+    }>>;
+    httpStatus: z.ZodOptional<z.ZodNumber>;
+    retryAfterMs: z.ZodOptional<z.ZodNumber>;
+    projectedFiveHour: z.ZodOptional<z.ZodNumber>;
+    projectedSevenDay: z.ZodOptional<z.ZodNumber>;
+    providerId: z.ZodOptional<z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+    }>>;
+    source: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        api: "api";
+        cache: "cache";
+    }>>;
+    capturedAt: z.ZodOptional<z.ZodString>;
+    stale: z.ZodOptional<z.ZodBoolean>;
+    fiveHourLabel: z.ZodOptional<z.ZodString>;
+    sevenDayLabel: z.ZodOptional<z.ZodString>;
+    limitId: z.ZodOptional<z.ZodString>;
+    limitName: z.ZodOptional<z.ZodString>;
+    credits: z.ZodOptional<z.ZodUnknown>;
+    planType: z.ZodOptional<z.ZodString>;
+    rateLimitReachedType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const peakHoursStateSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        unknown: "unknown";
+        peak: "peak";
+        off_peak: "off_peak";
+    }>;
+    isPeak: z.ZodBoolean;
+    sessionLimitSpeed: z.ZodEnum<{
+        unknown: "unknown";
+        normal: "normal";
+        faster: "faster";
+    }>;
+    label: z.ZodString;
+    peakHoursDescription: z.ZodString;
+    nextChange: z.ZodNullable<z.ZodString>;
+    minutesUntilChange: z.ZodNullable<z.ZodNumber>;
+    note: z.ZodString;
+    updatedAt: z.ZodString;
+    unavailable: z.ZodBoolean;
+    notApplicable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const quotaFailureDescriptorSchema: z.ZodObject<{
+    severity: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warning: "warning";
+    }>;
+    title: z.ZodString;
+    message: z.ZodString;
+    detail: z.ZodOptional<z.ZodString>;
+    alertKey: z.ZodString;
+    isRetryable: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const runtimeQuotaProviderSchema: z.ZodEnum<{
+    codex: "codex";
+    claude: "claude";
+}>;
+export declare const providerQuotaStateSchema: 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>;
+    available: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+    failureKind: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        rate_limit: "rate_limit";
+        auth: "auth";
+        network: "network";
+        server: "server";
+    }>>;
+    httpStatus: z.ZodOptional<z.ZodNumber>;
+    retryAfterMs: z.ZodOptional<z.ZodNumber>;
+    projectedFiveHour: z.ZodOptional<z.ZodNumber>;
+    projectedSevenDay: z.ZodOptional<z.ZodNumber>;
+    providerId: z.ZodOptional<z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+    }>>;
+    source: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        api: "api";
+        cache: "cache";
+    }>>;
+    capturedAt: z.ZodOptional<z.ZodString>;
+    stale: z.ZodOptional<z.ZodBoolean>;
+    fiveHourLabel: z.ZodOptional<z.ZodString>;
+    sevenDayLabel: z.ZodOptional<z.ZodString>;
+    limitId: z.ZodOptional<z.ZodString>;
+    limitName: z.ZodOptional<z.ZodString>;
+    credits: z.ZodOptional<z.ZodUnknown>;
+    planType: z.ZodOptional<z.ZodString>;
+    rateLimitReachedType: z.ZodOptional<z.ZodString>;
+    accountLabel: z.ZodOptional<z.ZodString>;
+    accountDetail: z.ZodOptional<z.ZodString>;
+    peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            peak: "peak";
+            off_peak: "off_peak";
+        }>;
+        isPeak: z.ZodBoolean;
+        sessionLimitSpeed: z.ZodEnum<{
+            unknown: "unknown";
+            normal: "normal";
+            faster: "faster";
+        }>;
+        label: z.ZodString;
+        peakHoursDescription: z.ZodString;
+        nextChange: z.ZodNullable<z.ZodString>;
+        minutesUntilChange: z.ZodNullable<z.ZodNumber>;
+        note: z.ZodString;
+        updatedAt: z.ZodString;
+        unavailable: z.ZodBoolean;
+        notApplicable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        title: z.ZodString;
+        message: z.ZodString;
+        detail: z.ZodOptional<z.ZodString>;
+        alertKey: z.ZodString;
+        isRetryable: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    runtimeProvider: z.ZodEnum<{
+        codex: "codex";
+        claude: "claude";
+    }>;
+}, z.core.$strip>;
+export declare const claudeProviderQuotaStateSchema: 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>;
+    available: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+    failureKind: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        rate_limit: "rate_limit";
+        auth: "auth";
+        network: "network";
+        server: "server";
+    }>>;
+    httpStatus: z.ZodOptional<z.ZodNumber>;
+    retryAfterMs: z.ZodOptional<z.ZodNumber>;
+    projectedFiveHour: z.ZodOptional<z.ZodNumber>;
+    projectedSevenDay: z.ZodOptional<z.ZodNumber>;
+    providerId: z.ZodOptional<z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+    }>>;
+    source: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        api: "api";
+        cache: "cache";
+    }>>;
+    capturedAt: z.ZodOptional<z.ZodString>;
+    stale: z.ZodOptional<z.ZodBoolean>;
+    fiveHourLabel: z.ZodOptional<z.ZodString>;
+    sevenDayLabel: z.ZodOptional<z.ZodString>;
+    limitId: z.ZodOptional<z.ZodString>;
+    limitName: z.ZodOptional<z.ZodString>;
+    credits: z.ZodOptional<z.ZodUnknown>;
+    planType: z.ZodOptional<z.ZodString>;
+    rateLimitReachedType: z.ZodOptional<z.ZodString>;
+    accountLabel: z.ZodOptional<z.ZodString>;
+    accountDetail: z.ZodOptional<z.ZodString>;
+    peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            peak: "peak";
+            off_peak: "off_peak";
+        }>;
+        isPeak: z.ZodBoolean;
+        sessionLimitSpeed: z.ZodEnum<{
+            unknown: "unknown";
+            normal: "normal";
+            faster: "faster";
+        }>;
+        label: z.ZodString;
+        peakHoursDescription: z.ZodString;
+        nextChange: z.ZodNullable<z.ZodString>;
+        minutesUntilChange: z.ZodNullable<z.ZodNumber>;
+        note: z.ZodString;
+        updatedAt: z.ZodString;
+        unavailable: z.ZodBoolean;
+        notApplicable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        title: z.ZodString;
+        message: z.ZodString;
+        detail: z.ZodOptional<z.ZodString>;
+        alertKey: z.ZodString;
+        isRetryable: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    runtimeProvider: z.ZodLiteral<"claude">;
+}, z.core.$strip>;
+export declare const codexProviderQuotaStateSchema: 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>;
+    available: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+    failureKind: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        rate_limit: "rate_limit";
+        auth: "auth";
+        network: "network";
+        server: "server";
+    }>>;
+    httpStatus: z.ZodOptional<z.ZodNumber>;
+    retryAfterMs: z.ZodOptional<z.ZodNumber>;
+    projectedFiveHour: z.ZodOptional<z.ZodNumber>;
+    projectedSevenDay: z.ZodOptional<z.ZodNumber>;
+    providerId: z.ZodOptional<z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+    }>>;
+    source: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        api: "api";
+        cache: "cache";
+    }>>;
+    capturedAt: z.ZodOptional<z.ZodString>;
+    stale: z.ZodOptional<z.ZodBoolean>;
+    fiveHourLabel: z.ZodOptional<z.ZodString>;
+    sevenDayLabel: z.ZodOptional<z.ZodString>;
+    limitId: z.ZodOptional<z.ZodString>;
+    limitName: z.ZodOptional<z.ZodString>;
+    credits: z.ZodOptional<z.ZodUnknown>;
+    planType: z.ZodOptional<z.ZodString>;
+    rateLimitReachedType: z.ZodOptional<z.ZodString>;
+    accountLabel: z.ZodOptional<z.ZodString>;
+    accountDetail: z.ZodOptional<z.ZodString>;
+    peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            peak: "peak";
+            off_peak: "off_peak";
+        }>;
+        isPeak: z.ZodBoolean;
+        sessionLimitSpeed: z.ZodEnum<{
+            unknown: "unknown";
+            normal: "normal";
+            faster: "faster";
+        }>;
+        label: z.ZodString;
+        peakHoursDescription: z.ZodString;
+        nextChange: z.ZodNullable<z.ZodString>;
+        minutesUntilChange: z.ZodNullable<z.ZodNumber>;
+        note: z.ZodString;
+        updatedAt: z.ZodString;
+        unavailable: z.ZodBoolean;
+        notApplicable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        title: z.ZodString;
+        message: z.ZodString;
+        detail: z.ZodOptional<z.ZodString>;
+        alertKey: z.ZodString;
+        isRetryable: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    runtimeProvider: z.ZodLiteral<"codex">;
+}, z.core.$strip>;
+export declare const providerQuotaMapSchema: z.ZodObject<{
+    claude: z.ZodOptional<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>;
+        available: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+        failureKind: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            rate_limit: "rate_limit";
+            auth: "auth";
+            network: "network";
+            server: "server";
+        }>>;
+        httpStatus: z.ZodOptional<z.ZodNumber>;
+        retryAfterMs: z.ZodOptional<z.ZodNumber>;
+        projectedFiveHour: z.ZodOptional<z.ZodNumber>;
+        projectedSevenDay: z.ZodOptional<z.ZodNumber>;
+        providerId: z.ZodOptional<z.ZodEnum<{
+            "claude-code": "claude-code";
+            codex: "codex";
+        }>>;
+        source: z.ZodOptional<z.ZodEnum<{
+            session: "session";
+            api: "api";
+            cache: "cache";
+        }>>;
+        capturedAt: z.ZodOptional<z.ZodString>;
+        stale: z.ZodOptional<z.ZodBoolean>;
+        fiveHourLabel: z.ZodOptional<z.ZodString>;
+        sevenDayLabel: z.ZodOptional<z.ZodString>;
+        limitId: z.ZodOptional<z.ZodString>;
+        limitName: z.ZodOptional<z.ZodString>;
+        credits: z.ZodOptional<z.ZodUnknown>;
+        planType: z.ZodOptional<z.ZodString>;
+        rateLimitReachedType: z.ZodOptional<z.ZodString>;
+        accountLabel: z.ZodOptional<z.ZodString>;
+        accountDetail: z.ZodOptional<z.ZodString>;
+        peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                peak: "peak";
+                off_peak: "off_peak";
+            }>;
+            isPeak: z.ZodBoolean;
+            sessionLimitSpeed: z.ZodEnum<{
+                unknown: "unknown";
+                normal: "normal";
+                faster: "faster";
+            }>;
+            label: z.ZodString;
+            peakHoursDescription: z.ZodString;
+            nextChange: z.ZodNullable<z.ZodString>;
+            minutesUntilChange: z.ZodNullable<z.ZodNumber>;
+            note: z.ZodString;
+            updatedAt: z.ZodString;
+            unavailable: z.ZodBoolean;
+            notApplicable: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            severity: z.ZodEnum<{
+                error: "error";
+                info: "info";
+                warning: "warning";
+            }>;
+            title: z.ZodString;
+            message: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+            alertKey: z.ZodString;
+            isRetryable: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        runtimeProvider: z.ZodLiteral<"claude">;
+    }, z.core.$strip>>;
+    codex: z.ZodOptional<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>;
+        available: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+        failureKind: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            rate_limit: "rate_limit";
+            auth: "auth";
+            network: "network";
+            server: "server";
+        }>>;
+        httpStatus: z.ZodOptional<z.ZodNumber>;
+        retryAfterMs: z.ZodOptional<z.ZodNumber>;
+        projectedFiveHour: z.ZodOptional<z.ZodNumber>;
+        projectedSevenDay: z.ZodOptional<z.ZodNumber>;
+        providerId: z.ZodOptional<z.ZodEnum<{
+            "claude-code": "claude-code";
+            codex: "codex";
+        }>>;
+        source: z.ZodOptional<z.ZodEnum<{
+            session: "session";
+            api: "api";
+            cache: "cache";
+        }>>;
+        capturedAt: z.ZodOptional<z.ZodString>;
+        stale: z.ZodOptional<z.ZodBoolean>;
+        fiveHourLabel: z.ZodOptional<z.ZodString>;
+        sevenDayLabel: z.ZodOptional<z.ZodString>;
+        limitId: z.ZodOptional<z.ZodString>;
+        limitName: z.ZodOptional<z.ZodString>;
+        credits: z.ZodOptional<z.ZodUnknown>;
+        planType: z.ZodOptional<z.ZodString>;
+        rateLimitReachedType: z.ZodOptional<z.ZodString>;
+        accountLabel: z.ZodOptional<z.ZodString>;
+        accountDetail: z.ZodOptional<z.ZodString>;
+        peakHours: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                peak: "peak";
+                off_peak: "off_peak";
+            }>;
+            isPeak: z.ZodBoolean;
+            sessionLimitSpeed: z.ZodEnum<{
+                unknown: "unknown";
+                normal: "normal";
+                faster: "faster";
+            }>;
+            label: z.ZodString;
+            peakHoursDescription: z.ZodString;
+            nextChange: z.ZodNullable<z.ZodString>;
+            minutesUntilChange: z.ZodNullable<z.ZodNumber>;
+            note: z.ZodString;
+            updatedAt: z.ZodString;
+            unavailable: z.ZodBoolean;
+            notApplicable: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        failure: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            severity: z.ZodEnum<{
+                error: "error";
+                info: "info";
+                warning: "warning";
+            }>;
+            title: z.ZodString;
+            message: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+            alertKey: z.ZodString;
+            isRetryable: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        runtimeProvider: z.ZodLiteral<"codex">;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

package/dist/schemas/quota.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Zod schemas for runtime validation of quota state.
+ *
+ * These schemas mirror the TypeScript interfaces in `quota.ts`,
+ * `peakHours.ts`, `quotaPresentation.ts`, and `providerQuota.ts` (keep in
+ * sync when those change). They let consumers validate quota payloads at
+ * process/IPC boundaries without hand-mirroring the interfaces.
+ *
+ * @module schemas/quota
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.providerQuotaMapSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaStateSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaWindowSchema = void 0;
+const zod_1 = require("zod");
+// ── QuotaWindow ──
+exports.quotaWindowSchema = zod_1.z.object({
+    utilization: zod_1.z.number(),
+    resetsAt: zod_1.z.string(),
+});
+// ── QuotaState ──
+exports.quotaFailureKindSchema = zod_1.z.enum([
+    'auth',
+    'network',
+    'rate_limit',
+    'server',
+    'unknown',
+]);
+exports.quotaProviderIdSchema = zod_1.z.enum([
+    'claude-code',
+    'codex',
+]);
+exports.quotaSourceSchema = zod_1.z.enum([
+    'api',
+    'session',
+    'cache',
+]);
+exports.quotaStateSchema = zod_1.z.object({
+    fiveHour: exports.quotaWindowSchema,
+    sevenDay: exports.quotaWindowSchema,
+    available: zod_1.z.boolean(),
+    error: zod_1.z.string().optional(),
+    failureKind: exports.quotaFailureKindSchema.optional(),
+    httpStatus: zod_1.z.number().optional(),
+    retryAfterMs: zod_1.z.number().optional(),
+    projectedFiveHour: zod_1.z.number().optional(),
+    projectedSevenDay: zod_1.z.number().optional(),
+    providerId: exports.quotaProviderIdSchema.optional(),
+    source: exports.quotaSourceSchema.optional(),
+    capturedAt: zod_1.z.string().optional(),
+    stale: zod_1.z.boolean().optional(),
+    fiveHourLabel: zod_1.z.string().optional(),
+    sevenDayLabel: zod_1.z.string().optional(),
+    limitId: zod_1.z.string().optional(),
+    limitName: zod_1.z.string().optional(),
+    credits: zod_1.z.unknown().optional(),
+    planType: zod_1.z.string().optional(),
+    rateLimitReachedType: zod_1.z.string().optional(),
+});
+// ── PeakHoursState ──
+exports.peakHoursStateSchema = zod_1.z.object({
+    status: zod_1.z.enum(['peak', 'off_peak', 'unknown']),
+    isPeak: zod_1.z.boolean(),
+    sessionLimitSpeed: zod_1.z.enum(['normal', 'faster', 'unknown']),
+    label: zod_1.z.string(),
+    peakHoursDescription: zod_1.z.string(),
+    nextChange: zod_1.z.string().nullable(),
+    minutesUntilChange: zod_1.z.number().nullable(),
+    note: zod_1.z.string(),
+    updatedAt: zod_1.z.string(),
+    unavailable: zod_1.z.boolean(),
+    notApplicable: zod_1.z.boolean().optional(),
+});
+// ── QuotaFailureDescriptor ──
+exports.quotaFailureDescriptorSchema = zod_1.z.object({
+    severity: zod_1.z.enum(['info', 'warning', 'error']),
+    title: zod_1.z.string(),
+    message: zod_1.z.string(),
+    detail: zod_1.z.string().optional(),
+    alertKey: zod_1.z.string(),
+    isRetryable: zod_1.z.boolean(),
+});
+// ── ProviderQuotaState / ProviderQuotaMap ──
+exports.runtimeQuotaProviderSchema = zod_1.z.enum([
+    'claude',
+    'codex',
+]);
+/** Fields ProviderQuotaState adds on top of QuotaState, minus the provider tag. */
+const providerQuotaExtensionShape = {
+    accountLabel: zod_1.z.string().optional(),
+    accountDetail: zod_1.z.string().optional(),
+    peakHours: exports.peakHoursStateSchema.nullable().optional(),
+    failure: exports.quotaFailureDescriptorSchema.nullable().optional(),
+};
+exports.providerQuotaStateSchema = exports.quotaStateSchema.extend({
+    runtimeProvider: exports.runtimeQuotaProviderSchema,
+    ...providerQuotaExtensionShape,
+});
+exports.claudeProviderQuotaStateSchema = exports.quotaStateSchema.extend({
+    runtimeProvider: zod_1.z.literal('claude'),
+    ...providerQuotaExtensionShape,
+});
+exports.codexProviderQuotaStateSchema = exports.quotaStateSchema.extend({
+    runtimeProvider: zod_1.z.literal('codex'),
+    ...providerQuotaExtensionShape,
+});
+exports.providerQuotaMapSchema = zod_1.z.object({
+    claude: exports.claudeProviderQuotaStateSchema.optional(),
+    codex: exports.codexProviderQuotaStateSchema.optional(),
+});