sidekick-shared 0.21.0 → 0.21.2

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 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;

package/dist/schemas/index.d.ts

@@ -12,7 +12,7 @@
  */
 export { messageUsageSchema, sessionMessageSchema, sessionEventSchema, permissionModeSchema, extractSessionEvents, } from './sessionEvent';
 export type { MessageUsage, SessionMessage, SessionEvent, PermissionMode, } from '../types/sessionEvent';
-export { quotaWindowSchema, quotaStateSchema, quotaFailureKindSchema, quotaProviderIdSchema, quotaSourceSchema, peakHoursStateSchema, quotaFailureDescriptorSchema, runtimeQuotaProviderSchema, providerQuotaStateSchema, claudeProviderQuotaStateSchema, codexProviderQuotaStateSchema, providerQuotaMapSchema, } from './quota';
+export { quotaWindowSchema, quotaStateSchema, quotaFailureKindSchema, quotaProviderIdSchema, quotaSourceSchema, peakHoursStateSchema, quotaFailureDescriptorSchema, runtimeQuotaProviderSchema, providerQuotaStateSchema, claudeProviderQuotaStateSchema, codexProviderQuotaStateSchema, zaiProviderQuotaStateSchema, providerQuotaMapSchema, } from './quota';
 export type { QuotaWindow, QuotaState } from '../quota';
 export type { PeakHoursState } from '../peakHours';
 export type { QuotaFailureDescriptor } from '../quotaPresentation';

package/dist/schemas/index.js

@@ -12,7 +12,7 @@
  * subpath is self-sufficient for boundary-validation modules.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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.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;
+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 = 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; } });
@@ -31,6 +31,7 @@ Object.defineProperty(exports, "runtimeQuotaProviderSchema", { enumerable: true,
 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, "zaiProviderQuotaStateSchema", { enumerable: true, get: function () { return quota_1.zaiProviderQuotaStateSchema; } });
 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; } });

package/dist/schemas/quota.d.ts

@@ -23,6 +23,7 @@ export declare const quotaFailureKindSchema: z.ZodEnum<{
 export declare const quotaProviderIdSchema: z.ZodEnum<{
     "claude-code": "claude-code";
     codex: "codex";
+    zai: "zai";
 }>;
 export declare const quotaSourceSchema: z.ZodEnum<{
     api: "api";
@@ -54,6 +55,7 @@ export declare const quotaStateSchema: z.ZodObject<{
     providerId: z.ZodOptional<z.ZodEnum<{
         "claude-code": "claude-code";
         codex: "codex";
+        zai: "zai";
     }>>;
     source: z.ZodOptional<z.ZodEnum<{
         api: "api";
@@ -106,6 +108,7 @@ export declare const quotaFailureDescriptorSchema: z.ZodObject<{
 export declare const runtimeQuotaProviderSchema: z.ZodEnum<{
     codex: "codex";
     claude: "claude";
+    zai: "zai";
 }>;
 export declare const providerQuotaStateSchema: z.ZodObject<{
     fiveHour: z.ZodObject<{
@@ -132,6 +135,7 @@ export declare const providerQuotaStateSchema: z.ZodObject<{
     providerId: z.ZodOptional<z.ZodEnum<{
         "claude-code": "claude-code";
         codex: "codex";
+        zai: "zai";
     }>>;
     source: z.ZodOptional<z.ZodEnum<{
         api: "api";
@@ -185,6 +189,7 @@ export declare const providerQuotaStateSchema: z.ZodObject<{
     runtimeProvider: z.ZodEnum<{
         codex: "codex";
         claude: "claude";
+        zai: "zai";
     }>;
 }, z.core.$strip>;
 export declare const claudeProviderQuotaStateSchema: z.ZodObject<{
@@ -212,6 +217,7 @@ export declare const claudeProviderQuotaStateSchema: z.ZodObject<{
     providerId: z.ZodOptional<z.ZodEnum<{
         "claude-code": "claude-code";
         codex: "codex";
+        zai: "zai";
     }>>;
     source: z.ZodOptional<z.ZodEnum<{
         api: "api";
@@ -289,6 +295,7 @@ export declare const codexProviderQuotaStateSchema: z.ZodObject<{
     providerId: z.ZodOptional<z.ZodEnum<{
         "claude-code": "claude-code";
         codex: "codex";
+        zai: "zai";
     }>>;
     source: z.ZodOptional<z.ZodEnum<{
         api: "api";
@@ -341,6 +348,84 @@ export declare const codexProviderQuotaStateSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     runtimeProvider: z.ZodLiteral<"codex">;
 }, z.core.$strip>;
+export declare const zaiProviderQuotaStateSchema: 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";
+        auth: "auth";
+        network: "network";
+        rate_limit: "rate_limit";
+        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";
+        zai: "zai";
+    }>>;
+    source: z.ZodOptional<z.ZodEnum<{
+        api: "api";
+        session: "session";
+        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";
+            warning: "warning";
+            info: "info";
+        }>;
+        title: z.ZodString;
+        message: z.ZodString;
+        detail: z.ZodOptional<z.ZodString>;
+        alertKey: z.ZodString;
+        isRetryable: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    runtimeProvider: z.ZodLiteral<"zai">;
+}, z.core.$strip>;
 export declare const providerQuotaMapSchema: z.ZodObject<{
     claude: z.ZodOptional<z.ZodObject<{
         fiveHour: z.ZodObject<{
@@ -367,6 +452,7 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
         providerId: z.ZodOptional<z.ZodEnum<{
             "claude-code": "claude-code";
             codex: "codex";
+            zai: "zai";
         }>>;
         source: z.ZodOptional<z.ZodEnum<{
             api: "api";
@@ -444,6 +530,7 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
         providerId: z.ZodOptional<z.ZodEnum<{
             "claude-code": "claude-code";
             codex: "codex";
+            zai: "zai";
         }>>;
         source: z.ZodOptional<z.ZodEnum<{
             api: "api";
@@ -496,4 +583,82 @@ export declare const providerQuotaMapSchema: z.ZodObject<{
         }, z.core.$strip>>>;
         runtimeProvider: z.ZodLiteral<"codex">;
     }, z.core.$strip>>;
+    zai: 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";
+            auth: "auth";
+            network: "network";
+            rate_limit: "rate_limit";
+            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";
+            zai: "zai";
+        }>>;
+        source: z.ZodOptional<z.ZodEnum<{
+            api: "api";
+            session: "session";
+            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";
+                warning: "warning";
+                info: "info";
+            }>;
+            title: z.ZodString;
+            message: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+            alertKey: z.ZodString;
+            isRetryable: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        runtimeProvider: z.ZodLiteral<"zai">;
+    }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/schemas/quota.js

@@ -10,7 +10,7 @@
  * @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;
+exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = 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({
@@ -28,6 +28,7 @@ exports.quotaFailureKindSchema = zod_1.z.enum([
 exports.quotaProviderIdSchema = zod_1.z.enum([
     'claude-code',
     'codex',
+    'zai',
 ]);
 exports.quotaSourceSchema = zod_1.z.enum([
     'api',
@@ -83,6 +84,7 @@ exports.quotaFailureDescriptorSchema = zod_1.z.object({
 exports.runtimeQuotaProviderSchema = zod_1.z.enum([
     'claude',
     'codex',
+    'zai',
 ]);
 /** Fields ProviderQuotaState adds on top of QuotaState, minus the provider tag. */
 const providerQuotaExtensionShape = {
@@ -103,7 +105,12 @@ exports.codexProviderQuotaStateSchema = exports.quotaStateSchema.extend({
     runtimeProvider: zod_1.z.literal('codex'),
     ...providerQuotaExtensionShape,
 });
+exports.zaiProviderQuotaStateSchema = exports.quotaStateSchema.extend({
+    runtimeProvider: zod_1.z.literal('zai'),
+    ...providerQuotaExtensionShape,
+});
 exports.providerQuotaMapSchema = zod_1.z.object({
     claude: exports.claudeProviderQuotaStateSchema.optional(),
     codex: exports.codexProviderQuotaStateSchema.optional(),
+    zai: exports.zaiProviderQuotaStateSchema.optional(),
 });

package/dist/schemas/quotaHistory.d.ts

@@ -12,12 +12,14 @@ import { z } from 'zod';
 export declare const quotaHistoryRuntimeProviderSchema: z.ZodEnum<{
     codex: "codex";
     claude: "claude";
+    zai: "zai";
 }>;
 export declare const quotaHistorySampleSchema: z.ZodObject<{
     timestamp: z.ZodString;
     runtimeProvider: z.ZodEnum<{
         codex: "codex";
         claude: "claude";
+        zai: "zai";
     }>;
     providerId: z.ZodString;
     workspaceId: z.ZodString;

package/dist/schemas/quotaHistory.js

@@ -16,6 +16,7 @@ const zod_1 = require("zod");
 exports.quotaHistoryRuntimeProviderSchema = zod_1.z.enum([
     'claude',
     'codex',
+    'zai',
 ]);
 // ── QuotaHistorySample ──
 exports.quotaHistorySampleSchema = zod_1.z.object({

package/dist/zaiQuota.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Deprecated stateless quota accumulator for z.ai coding plans.
+ *
+ * This estimator is kept for compatibility with consumers that imported the
+ * old helpers directly. Product code should use `zaiQuotaApi.ts`, which calls
+ * z.ai's authoritative quota endpoint. The legacy estimator only uses:
+ *
+ *   1. Per-call token `usage` returned inline on each chat completion —
+ *      which OpenCode persists into `opencode.db` message rows tagged with
+ *      `providerID ∈ {"zai", "zai-coding-plan"}`.
+ *   2. Business error codes (`1308` / `1310` / `1313` / `1309`) returned
+ *      when a limit is actually hit, with `${next_flush_time}` embedded
+ *      in the human-readable message text.
+ *
+ * This module is therefore a **derivation** rather than a fetcher: callers
+ * feed it observed assistant turns (and any error events), and it computes a
+ * compatibility `QuotaState` keyed against the published per-tier budgets.
+ *
+ * Polling / eventing / persistence are the caller's responsibility —
+ * see `ZaiQuotaWatcher` for the bundled watcher.
+ */
+import type { QuotaState } from './quota';
+/**
+ * Published z.ai coding-plan prompt budgets.
+ *
+ * Source: https://docs.z.ai/devpack/overview & /devpack/faq.
+ * "One prompt ≈ one query; each prompt is estimated to invoke the model
+ * 15–20 times." We use the midpoint (17.5) when converting observed
+ * assistant turns into prompt equivalents.
+ */
+export declare const ZAI_TIER_BUDGETS: {
+    readonly lite: {
+        readonly fiveHour: 80;
+        readonly weekly: 400;
+    };
+    readonly pro: {
+        readonly fiveHour: 400;
+        readonly weekly: 2000;
+    };
+    readonly max: {
+        readonly fiveHour: 1600;
+        readonly weekly: 8000;
+    };
+};
+export type ZaiTier = 'lite' | 'pro' | 'max';
+/**
+ * Midpoint of z.ai's documented "15–20 model invocations per prompt" range.
+ * Used to convert accumulated assistant turns into prompt equivalents.
+ * Calibration note: this constant may need per-tier adjustment after
+ * real-world validation against the z.ai web UI.
+ */
+export declare const ZAI_PROMPT_INVOCATIONS = 17.5;
+/**
+ * Provider IDs that OpenCode tags on z.ai-routed messages.
+ * `zai-coding-plan` is the Coding Plan key; `zai` is the bare API key.
+ */
+export declare const ZAI_PROVIDER_IDS: readonly ["zai", "zai-coding-plan"];
+export type ZaiProviderId = (typeof ZAI_PROVIDER_IDS)[number];
+export declare function isZaiProviderId(value: unknown): value is ZaiProviderId;
+/**
+ * Minimal description of a z.ai-routed assistant turn needed to accumulate
+ * usage. Mirrors the fields OpenCode already extracts via its parser
+ * (`openCodeParser.ts:346-357`). Tokens are Anthropic-style for cross-
+ * provider comparability; cost is omitted (always 0 for z.ai).
+ *
+ * `timestampMs` is when the assistant turn completed (epoch milliseconds).
+ */
+export interface ZaiAssistantTurn {
+    timestampMs: number;
+    model?: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    reasoningTokens: number;
+}
+export interface ZaiAccumulatedUsage {
+    /** Number of z.ai assistant turns inside the 5-hour window. */
+    fiveHourTurns: number;
+    /** Number of z.ai assistant turns inside the 7-day window. */
+    weeklyTurns: number;
+    /** Sum of token fields across the 5-hour window. */
+    fiveHourTokens: number;
+    /** Sum of token fields across the 7-day window. */
+    weeklyTokens: number;
+    /** Estimated prompts consumed in the 5-hour window (turns / 17.5). */
+    fiveHourPrompts: number;
+    /** Estimated prompts consumed in the 7-day window (turns / 17.5). */
+    weeklyPrompts: number;
+    /** Earliest turn timestamp inside the 5-hour window (epoch ms), or null. */
+    fiveHourStartedAtMs: number | null;
+    /** Earliest turn timestamp inside the 7-day window (epoch ms), or null. */
+    weeklyStartedAtMs: number | null;
+}
+/**
+ * Sums the token fields of a single turn into a scalar.
+ * Cache reads are weighted at 0.1× (Anthropic convention) to avoid
+ * over-counting repeated context. Output and reasoning tokens are weighted 1×.
+ */
+export declare function turnTokenWeight(turn: Pick<ZaiAssistantTurn, 'inputTokens' | 'outputTokens' | 'cacheReadTokens' | 'cacheWriteTokens' | 'reasoningTokens'>): number;
+/**
+ * Reduces a stream of z.ai-routed assistant turns into rolling-window usage.
+ *
+ * Pure & stateless: the caller is responsible for passing the relevant turns.
+ * Turns outside the 7-day window are ignored; turns inside the 7-day window
+ * but outside the 5-hour window still count toward weekly usage.
+ */
+export declare function accumulateZaiUsage(turns: readonly ZaiAssistantTurn[], nowMs?: number): ZaiAccumulatedUsage;
+/**
+ * Resolves the effective z.ai tier when the user has selected `'auto'`.
+ *
+ * Heuristic: if accumulated weekly prompts already exceed a tier's budget,
+ * the user must be on a higher tier. This under-detects at the start of a
+ * weekly cycle (a Max user looks identical to a Lite user until they cross
+ * 400 prompts/week), so callers should still expose an explicit override.
+ */
+export declare function resolveZaiTier(configured: ZaiTier | 'auto', accumulated: ZaiAccumulatedUsage): ZaiTier;
+export interface InferZaiQuotaStateOptions {
+    /** ISO timestamp to stamp on the sample. Default: now. */
+    capturedAt?: string;
+    /** Mark the sample stale when the windows aren't fully observed yet. */
+    stale?: boolean;
+    /** Authoritative reset timestamp from a trapped 1308/1310 error. */
+    authoritativeFiveHourResetAt?: string;
+    authoritativeWeeklyResetAt?: string;
+}
+/**
+ * Converts accumulated usage into a shared `QuotaState`.
+ *
+ * The two windows reuse the `fiveHour` / `sevenDay` field names for cross-
+ * provider compatibility, but are labeled "5-Hour" and "Weekly" via
+ * `fiveHourLabel` / `sevenDayLabel` — mirroring how Codex relabels its
+ * generic primary/secondary windows.
+ *
+ * Reset timestamps are best-effort because z.ai does not expose them:
+ *   - `fiveHour.resetsAt` ← first turn in window + 5h, unless an error
+ *     event supplied an authoritative reset.
+ *   - `sevenDay.resetsAt` ← first turn in window + 7d (documented as
+ *     "7 days from order time" — order time is unknown, so this is a
+ *     lower bound at best).
+ */
+export declare function inferZaiQuotaState(accumulated: ZaiAccumulatedUsage, tier: ZaiTier, options?: InferZaiQuotaStateOptions): QuotaState;
+export type ZaiQuotaErrorKind = 'exhausted' | 'fup' | 'expired' | 'invalid';
+export interface ZaiQuotaError {
+    kind: ZaiQuotaErrorKind;
+    /** ISO timestamp parsed from `${next_flush_time}` in the error message, if present. */
+    resetsAt?: string;
+    /** The raw business error code from z.ai. */
+    code: string;
+    /** Human-readable message. */
+    message: string;
+}
+/**
+ * Extracts a z.ai quota error from a message-error payload, if present.
+ *
+ * The reset timestamp is embedded inside the human-readable `message` text
+ * as `${next_flush_time}`. z.ai's docs interpolate the value into the
+ * message string; we parse ISO datetimes, epoch seconds, and the literal
+ * `YYYY-MM-DD HH:mm:ss` form defensively.
+ *
+ * Returns `null` when the code is not a quota-related business error.
+ */
+export declare function parseZaiQuotaError(error: {
+    code?: string | number;
+    message?: string;
+    type?: string;
+}): ZaiQuotaError | null;
+/**
+ * Parses `${next_flush_time}` out of a z.ai error message.
+ *
+ * Handles ISO 8601 (`2025-01-31T14:00:00Z`), space-separated
+ * (`2025-01-31 14:00:00`), and epoch-seconds (1234567890) forms.
+ * Returns undefined when no parseable timestamp is found.
+ */
+export declare function extractNextFlushTime(message: string): string | undefined;
+/**
+ * Builds an unavailable z.ai `QuotaState` for the cold-start case where
+ * no z.ai traffic has been observed yet.
+ */
+export declare function makeUnavailableZaiQuotaState(error?: string, tier?: ZaiTier, capturedAt?: string): QuotaState;
+/**
+ * Shape of a row returned by `OpenCodeDatabase.getAssistantMessagesByProviderId`.
+ * Defined here to keep the sidekick-shared helper self-contained without
+ * leaking the OpenCode db module into the public quota surface.
+ */
+export interface ZaiOpenCodeRow {
+    timeCreated: number;
+    modelId: string;
+    providerId: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    reasoningTokens: number;
+    errorMessage: string | null;
+    errorCode: string | null;
+}
+/**
+ * Converts raw OpenCode DB rows (filtered to z.ai providerIDs by the caller)
+ * into the watcher's `ZaiAssistantTurn` shape, and surfaces any trapped
+ * business errors.
+ *
+ * Returns `{ turns, errors }` so callers can replay them through
+ * `ZaiQuotaWatcher.ingestAssistantTurns` and `ingestError`.
+ */
+export declare function rowsToZaiTurnsAndErrors(rows: readonly ZaiOpenCodeRow[]): {
+    turns: ZaiAssistantTurn[];
+    errors: ZaiQuotaError[];
+};