@claudexor/schema 4.0.1 → 4.1.1

package/dist/quota-availability.js

@@ -0,0 +1,130 @@
+import { QuotaAvailability, quotaSnapshotIdentity, quotaConstraintAppliesToRequestKind, } from "./quota.js";
+/** Millisecond instant of a still-future ISO timestamp, else null. */
+function futureMs(iso, now) {
+    if (!iso)
+        return null;
+    const at = Date.parse(iso);
+    return Number.isFinite(at) && at > now ? at : null;
+}
+/** Literal family matching belongs to the quota contract, shared by display
+ * and admission. Prefixes must be declared by the vendor-specific producer;
+ * neither a missing model nor an unknown family proves a match. */
+export function quotaModelPrefixMatches(prefixes, model) {
+    return prefixes?.some((prefix) => prefix.length > 0 && model.startsWith(prefix)) === true;
+}
+/** API-parameter model matching, deliberately looser than the router's exact
+ * `quotaConstraintAppliesToModel` (@claudexor/budget): consumers pass whatever
+ * model string they route with ("claude-fable-5", "fable", a bracketed
+ * variant), while producers publish vendor alias lists — so match by
+ * case-insensitive alias containment in either direction. A null/empty scope
+ * list is a vendor-wide window and matches every model. */
+function modelScopeMatches(scope, model) {
+    if (scope == null || scope.length === 0)
+        return true;
+    const target = model.trim().toLowerCase();
+    return scope.some((alias) => {
+        const candidate = alias.trim().toLowerCase();
+        return (candidate !== "" &&
+            target !== "" &&
+            (candidate.includes(target) || target.includes(candidate)));
+    });
+}
+/** Derive one snapshot's typed model-aware availability — a pure projection
+ * over the snapshot's own constraints, never an aggregate across subjects.
+ * Blocking semantics mirror the router's `BudgetLedger`: a window
+ * blocks while its cooldown_until is in the future, or while used_ratio >= 1
+ * with a still-future resets_at (a spent ratio whose reset elapsed or is
+ * unknown is stale data, not a live block). Without `model`, only windows that
+ * apply to EVERY model can block; model-scoped spent windows are disclosed in
+ * model_scoped_exhaustions and leave state available — including a spent
+ * scoped window whose reset is UNKNOWN (disclosed with resets_at null, never
+ * blocking); one whose reset ELAPSED is provably released and not disclosed.
+ * With `model`, scoped windows matching it block too.
+ * Full-coverage inference ("every model is
+ * covered by some spent scoped window") is deliberately not attempted: the
+ * model universe is unknowable here, so that case stays available + disclosed. */
+export function quotaSnapshotAvailability(snapshot, opts = {}) {
+    const now = (opts.now ?? new Date()).getTime();
+    const model = opts.model ?? null;
+    const blocking = [];
+    const scopedExhaustions = [];
+    let sawExhausted = false;
+    let earliestRelease = null;
+    for (const constraint of snapshot.constraints) {
+        if (!quotaConstraintAppliesToRequestKind(constraint, opts.requestKind))
+            continue;
+        const resetAt = futureMs(constraint.resets_at, now);
+        const cooldownAt = futureMs(constraint.cooldown_until, now);
+        const exhausted = constraint.used_ratio !== null && constraint.used_ratio >= 1 && resetAt !== null;
+        const cooling = cooldownAt !== null;
+        // A spent ratio with an UNKNOWN reset never blocks (BudgetLedger mirror:
+        // stale data, not a live block), but a scoped one is still DISCLOSED below
+        // with resets_at null; an elapsed reset is provably released and stays
+        // undisclosed.
+        const spentUnknownReset = constraint.used_ratio !== null && constraint.used_ratio >= 1 && constraint.resets_at === null;
+        if (!exhausted && !cooling && !spentUnknownReset)
+            continue;
+        // A constraint stays blocked until EVERY active condition lifts, so its
+        // own release is the LATER of the two; the snapshot-level resets_at below
+        // is the EARLIEST such release across blocking constraints. A
+        // disclosure-only window (spent, unknown reset) has no release instant.
+        const release = !exhausted && !cooling
+            ? null
+            : exhausted && cooling
+                ? resetAt >= cooldownAt
+                    ? { iso: constraint.resets_at, at: resetAt }
+                    : { iso: constraint.cooldown_until, at: cooldownAt }
+                : exhausted
+                    ? { iso: constraint.resets_at, at: resetAt }
+                    : { iso: constraint.cooldown_until, at: cooldownAt };
+        const scope = constraint.applies_to_models ?? null;
+        const prefixes = constraint.applies_to_model_prefixes;
+        const scoped = (scope !== null && scope.length > 0) || (prefixes?.length ?? 0) > 0;
+        if (scoped) {
+            scopedExhaustions.push({
+                constraint_id: constraint.id,
+                applies_to_models: [...(scope ?? [])],
+                ...(prefixes?.length ? { applies_to_model_prefixes: [...prefixes] } : {}),
+                resets_at: release?.iso ?? null,
+            });
+        }
+        if (release === null)
+            continue;
+        // The projection and the router must answer the SAME question: a scoped
+        // window that declares it governs the unspecified-model route blocks a
+        // bare run, or the Accounts card would read "available" for an account the
+        // router is already refusing.
+        if (scoped &&
+            (model === null
+                ? constraint.applies_to_unspecified_model !== true
+                : !(quotaModelPrefixMatches(prefixes, model) ||
+                    (scope !== null && scope.length > 0 && modelScopeMatches(scope, model)))))
+            continue;
+        blocking.push(constraint.id);
+        if (exhausted)
+            sawExhausted = true;
+        if (earliestRelease === null || release.at < earliestRelease.at) {
+            earliestRelease = release;
+        }
+    }
+    return QuotaAvailability.parse({
+        state: blocking.length === 0 ? "available" : sawExhausted ? "exhausted" : "cooldown",
+        blocking_constraints: blocking,
+        resets_at: earliestRelease?.iso ?? null,
+        model_scoped_exhaustions: scopedExhaustions,
+    });
+}
+/** Decorate a quota response with per-snapshot availability projections —
+ * applied at the /v2/quota and atomic Accounts response boundaries so
+ * journals and raw projection signatures stay byte-identical. */
+export function withQuotaAvailability(response, opts = {}) {
+    return {
+        ...response,
+        snapshots: response.snapshots.map((snapshot) => ({
+            ...snapshot,
+            snapshot_id: quotaSnapshotIdentity(snapshot),
+            availability: quotaSnapshotAvailability(snapshot, opts),
+        })),
+    };
+}
+//# sourceMappingURL=quota-availability.js.map

package/dist/quota-availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-availability.js","sourceRoot":"","sources":["../src/quota-availability.ts"],"names":[],"mappings":"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"}

package/dist/quota-read.d.ts

@@ -3,11 +3,28 @@ import { z } from "zod/v3";
  * accept constraint freshness. Clients explicitly select the read projection;
  * operation discovery is optional, and old engines may return strict legacy data
  * (3.24) or reject the selector with HTTP 400 (3.25.0/3.25.1). */
-export declare const ControlQuotaReadRequest: z.ZodObject<{
+export declare const ControlQuotaReadRequest: z.ZodObject<Omit<{
+    target: z.ZodOptional<z.ZodObject<{
+        harness: z.ZodString;
+        profile_id: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        harness: string;
+        profile_id: string;
+    }, {
+        harness: string;
+        profile_id: string;
+    }>>;
+    requestKind: z.ZodOptional<z.ZodEnum<["text", "image"]>>;
+    model: z.ZodOptional<z.ZodString>;
+}, "target"> & {
     view: z.ZodOptional<z.ZodEnum<["resources", "constraint_freshness"]>>;
 }, "strict", z.ZodTypeAny, {
+    requestKind?: "image" | "text" | undefined;
+    model?: string | undefined;
     view?: "constraint_freshness" | "resources" | undefined;
 }, {
+    requestKind?: "image" | "text" | undefined;
+    model?: string | undefined;
     view?: "constraint_freshness" | "resources" | undefined;
 }>;
 export type ControlQuotaReadRequest = z.infer<typeof ControlQuotaReadRequest>;
@@ -28,7 +45,7 @@ export declare const ControlQuotaFreshnessSnapshot: z.ZodObject<{
         plan_label?: string | null | undefined;
         subject_id?: string | null | undefined;
     }>;
-    source: z.ZodEnum<["codex_app_server", "codex_rollout", "claude_statusline", "claude_api_retry", "claude_oauth_usage", "agy_command_usage", "cursor_rate_limit", "claude_rate_limit_event", "codex_app_server_event"]>;
+    source: z.ZodEnum<["codex_app_server", "codex_rollout", "claude_statusline", "claude_api_retry", "claude_oauth_usage", "agy_command_usage", "cursor_rate_limit", "claude_rate_limit_event", "codex_app_server_event", "codex_image_response"]>;
     observed_at: z.ZodString;
     freshness: z.ZodEnum<["fresh", "stale", "unknown"]>;
     snapshot_id: z.ZodOptional<z.ZodString>;
@@ -80,6 +97,7 @@ export declare const ControlQuotaFreshnessSnapshot: z.ZodObject<{
         applies_to_models: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
         applies_to_model_prefixes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         applies_to_unspecified_model: z.ZodOptional<z.ZodBoolean>;
+        applies_to_request_kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["text", "image"]>, "many">>;
         used_ratio: z.ZodNullable<z.ZodNumber>;
         window_seconds: z.ZodNullable<z.ZodNumber>;
         resets_at: z.ZodNullable<z.ZodString>;
@@ -92,6 +110,7 @@ export declare const ControlQuotaFreshnessSnapshot: z.ZodObject<{
         applies_to_models?: string[] | null | undefined;
         applies_to_model_prefixes?: string[] | undefined;
         applies_to_unspecified_model?: boolean | undefined;
+        applies_to_request_kinds?: ("image" | "text")[] | undefined;
         used_ratio: number | null;
         window_seconds: number | null;
         resets_at: string | null;
@@ -103,6 +122,7 @@ export declare const ControlQuotaFreshnessSnapshot: z.ZodObject<{
         applies_to_models?: string[] | null | undefined;
         applies_to_model_prefixes?: string[] | undefined;
         applies_to_unspecified_model?: boolean | undefined;
+        applies_to_request_kinds?: ("image" | "text")[] | undefined;
         used_ratio: number | null;
         window_seconds: number | null;
         resets_at: string | null;
@@ -116,7 +136,7 @@ export declare const ControlQuotaFreshnessSnapshot: z.ZodObject<{
         plan_label: string | null;
         subject_id: string | null;
     };
-    source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_rollout" | "cursor_rate_limit";
+    source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_image_response" | "codex_rollout" | "cursor_rate_limit";
     observed_at: string;
     freshness: "fresh" | "stale" | "unknown";
     snapshot_id?: string | undefined;
@@ -137,6 +157,7 @@ export declare const ControlQuotaFreshnessSnapshot: z.ZodObject<{
         applies_to_models?: string[] | null | undefined;
         applies_to_model_prefixes?: string[] | undefined;
         applies_to_unspecified_model?: boolean | undefined;
+        applies_to_request_kinds?: ("image" | "text")[] | undefined;
         used_ratio: number | null;
         window_seconds: number | null;
         resets_at: string | null;
@@ -150,7 +171,7 @@ export declare const ControlQuotaFreshnessSnapshot: z.ZodObject<{
         plan_label?: string | null | undefined;
         subject_id?: string | null | undefined;
     };
-    source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_rollout" | "cursor_rate_limit";
+    source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_image_response" | "codex_rollout" | "cursor_rate_limit";
     observed_at: string;
     freshness: "fresh" | "stale" | "unknown";
     snapshot_id?: string | undefined;
@@ -171,6 +192,7 @@ export declare const ControlQuotaFreshnessSnapshot: z.ZodObject<{
         applies_to_models?: string[] | null | undefined;
         applies_to_model_prefixes?: string[] | undefined;
         applies_to_unspecified_model?: boolean | undefined;
+        applies_to_request_kinds?: ("image" | "text")[] | undefined;
         used_ratio: number | null;
         window_seconds: number | null;
         resets_at: string | null;
@@ -281,7 +303,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             plan_label?: string | null | undefined;
             subject_id?: string | null | undefined;
         }>;
-        source: z.ZodEnum<["codex_app_server", "codex_rollout", "claude_statusline", "claude_api_retry", "claude_oauth_usage", "agy_command_usage", "cursor_rate_limit", "claude_rate_limit_event", "codex_app_server_event"]>;
+        source: z.ZodEnum<["codex_app_server", "codex_rollout", "claude_statusline", "claude_api_retry", "claude_oauth_usage", "agy_command_usage", "cursor_rate_limit", "claude_rate_limit_event", "codex_app_server_event", "codex_image_response"]>;
         observed_at: z.ZodString;
         freshness: z.ZodEnum<["fresh", "stale", "unknown"]>;
         snapshot_id: z.ZodOptional<z.ZodString>;
@@ -333,6 +355,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             applies_to_models: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
             applies_to_model_prefixes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             applies_to_unspecified_model: z.ZodOptional<z.ZodBoolean>;
+            applies_to_request_kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["text", "image"]>, "many">>;
             used_ratio: z.ZodNullable<z.ZodNumber>;
             window_seconds: z.ZodNullable<z.ZodNumber>;
             resets_at: z.ZodNullable<z.ZodString>;
@@ -345,6 +368,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             applies_to_models?: string[] | null | undefined;
             applies_to_model_prefixes?: string[] | undefined;
             applies_to_unspecified_model?: boolean | undefined;
+            applies_to_request_kinds?: ("image" | "text")[] | undefined;
             used_ratio: number | null;
             window_seconds: number | null;
             resets_at: string | null;
@@ -356,6 +380,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             applies_to_models?: string[] | null | undefined;
             applies_to_model_prefixes?: string[] | undefined;
             applies_to_unspecified_model?: boolean | undefined;
+            applies_to_request_kinds?: ("image" | "text")[] | undefined;
             used_ratio: number | null;
             window_seconds: number | null;
             resets_at: string | null;
@@ -369,7 +394,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             plan_label: string | null;
             subject_id: string | null;
         };
-        source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_rollout" | "cursor_rate_limit";
+        source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_image_response" | "codex_rollout" | "cursor_rate_limit";
         observed_at: string;
         freshness: "fresh" | "stale" | "unknown";
         snapshot_id?: string | undefined;
@@ -390,6 +415,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             applies_to_models?: string[] | null | undefined;
             applies_to_model_prefixes?: string[] | undefined;
             applies_to_unspecified_model?: boolean | undefined;
+            applies_to_request_kinds?: ("image" | "text")[] | undefined;
             used_ratio: number | null;
             window_seconds: number | null;
             resets_at: string | null;
@@ -403,7 +429,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             plan_label?: string | null | undefined;
             subject_id?: string | null | undefined;
         };
-        source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_rollout" | "cursor_rate_limit";
+        source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_image_response" | "codex_rollout" | "cursor_rate_limit";
         observed_at: string;
         freshness: "fresh" | "stale" | "unknown";
         snapshot_id?: string | undefined;
@@ -424,6 +450,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             applies_to_models?: string[] | null | undefined;
             applies_to_model_prefixes?: string[] | undefined;
             applies_to_unspecified_model?: boolean | undefined;
+            applies_to_request_kinds?: ("image" | "text")[] | undefined;
             used_ratio: number | null;
             window_seconds: number | null;
             resets_at: string | null;
@@ -462,7 +489,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             plan_label: string | null;
             subject_id: string | null;
         };
-        source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_rollout" | "cursor_rate_limit";
+        source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_image_response" | "codex_rollout" | "cursor_rate_limit";
         observed_at: string;
         freshness: "fresh" | "stale" | "unknown";
         snapshot_id?: string | undefined;
@@ -483,6 +510,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             applies_to_models?: string[] | null | undefined;
             applies_to_model_prefixes?: string[] | undefined;
             applies_to_unspecified_model?: boolean | undefined;
+            applies_to_request_kinds?: ("image" | "text")[] | undefined;
             used_ratio: number | null;
             window_seconds: number | null;
             resets_at: string | null;
@@ -521,7 +549,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             plan_label?: string | null | undefined;
             subject_id?: string | null | undefined;
         };
-        source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_rollout" | "cursor_rate_limit";
+        source: "agy_command_usage" | "claude_api_retry" | "claude_oauth_usage" | "claude_rate_limit_event" | "claude_statusline" | "codex_app_server" | "codex_app_server_event" | "codex_image_response" | "codex_rollout" | "cursor_rate_limit";
         observed_at: string;
         freshness: "fresh" | "stale" | "unknown";
         snapshot_id?: string | undefined;
@@ -542,6 +570,7 @@ export declare const ControlQuotaFreshnessResponse: z.ZodObject<{
             applies_to_models?: string[] | null | undefined;
             applies_to_model_prefixes?: string[] | undefined;
             applies_to_unspecified_model?: boolean | undefined;
+            applies_to_request_kinds?: ("image" | "text")[] | undefined;
             used_ratio: number | null;
             window_seconds: number | null;
             resets_at: string | null;

package/dist/quota-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quota-read.d.ts","sourceRoot":"","sources":["../src/quota-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAQ3B;;;kEAGkE;AAClE,eAAO,MAAM,uBAAuB;;;;;;EAEzB,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQxC,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAE1F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIzC,CAAC;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}
+{"version":3,"file":"quota-read.d.ts","sourceRoot":"","sources":["../src/quota-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAS3B;;;kEAGkE;AAClE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;EAKjC,CAAC;AACJ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQxC,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAE1F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIzC,CAAC;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/quota-read.js

@@ -1,12 +1,14 @@
 import { z } from "zod/v3";
+import { ControlQuotaRefreshRequest } from "./account-target.js";
 import { ControlQuotaResponse, ControlQuotaSnapshot, QuotaConstraint, QuotaFreshness, } from "./quota.js";
 /** Response-only schemas: neither persisted evidence nor legacy wire shapes
  * accept constraint freshness. Clients explicitly select the read projection;
  * operation discovery is optional, and old engines may return strict legacy data
  * (3.24) or reject the selector with HTTP 400 (3.25.0/3.25.1). */
-export const ControlQuotaReadRequest = z
-    .object({ view: z.enum(["resources", "constraint_freshness"]).optional() })
-    .strict();
+export const ControlQuotaReadRequest = ControlQuotaRefreshRequest.omit({ target: true })
+    .extend({ view: z.enum(["resources", "constraint_freshness"]).optional() })
+    .strict()
+    .describe("GET /v2/quota query selectors, each at most once; there is no body. Omitted requestKind means text availability, omitted model keeps the model-agnostic projection, and omitted view keeps the legacy shape. Reads cached snapshots without refreshing quota.");
 export const ControlQuotaFreshnessSnapshot = ControlQuotaSnapshot.extend({
     constraints: z.array(QuotaConstraint.extend({
         freshness: QuotaFreshness.describe("Read-time freshness from raw snapshot freshness, observation age (stale after 300000ms), and this constraint's own reset (stale at equality); a reset cutoff stales earlier evidence. Never inferred from aggregate freshness or a sibling reset; no refill is inferred. The compatibility reset_credits row reports its resets facet's freshness instead."),

package/dist/quota-read.js.map

@@ -1 +1 @@
-{"version":3,"file":"quota-read.js","sourceRoot":"","sources":["../src/quota-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB;;;kEAGkE;AAClE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;KAC1E,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC,MAAM,CAAC;IACvE,WAAW,EAAE,CAAC,CAAC,KAAK,CAClB,eAAe,CAAC,MAAM,CAAC;QACrB,SAAS,EAAE,cAAc,CAAC,QAAQ,CAChC,4VAA4V,CAC7V;KACF,CAAC,CACH;CACF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC,MAAM,CAAC;IACvE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC;CAClD,CAAC,CAAC,QAAQ,CACT,wLAAwL,CACzL,CAAC"}
+{"version":3,"file":"quota-read.js","sourceRoot":"","sources":["../src/quota-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB;;;kEAGkE;AAClE,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KACrF,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;KAC1E,MAAM,EAAE;KACR,QAAQ,CACP,+PAA+P,CAChQ,CAAC;AAGJ,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC,MAAM,CAAC;IACvE,WAAW,EAAE,CAAC,CAAC,KAAK,CAClB,eAAe,CAAC,MAAM,CAAC;QACrB,SAAS,EAAE,cAAc,CAAC,QAAQ,CAChC,4VAA4V,CAC7V;KACF,CAAC,CACH;CACF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC,MAAM,CAAC;IACvE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC;CAClD,CAAC,CAAC,QAAQ,CACT,wLAAwL,CACzL,CAAC"}

package/dist/quota-request-kind.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod/v3";
+/** Shared by quota evidence and account read/refresh requests without a schema cycle. */
+export declare const QuotaRequestKind: z.ZodEnum<["text", "image"]>;
+export type QuotaRequestKind = z.infer<typeof QuotaRequestKind>;
+/** Operation applicability is independent of any vendor model-id spelling. */
+export declare function quotaConstraintAppliesToRequestKind(constraint: {
+    applies_to_request_kinds?: QuotaRequestKind[];
+}, requestKind?: QuotaRequestKind): boolean;
+//# sourceMappingURL=quota-request-kind.d.ts.map

package/dist/quota-request-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-request-kind.d.ts","sourceRoot":"","sources":["../src/quota-request-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,8BAA4B,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,8EAA8E;AAC9E,wBAAgB,mCAAmC,CACjD,UAAU,EAAE;IAAE,wBAAwB,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAAE,EAC7D,WAAW,GAAE,gBAAyB,GACrC,OAAO,CAET"}

package/dist/quota-request-kind.js

@@ -0,0 +1,8 @@
+import { z } from "zod/v3";
+/** Shared by quota evidence and account read/refresh requests without a schema cycle. */
+export const QuotaRequestKind = z.enum(["text", "image"]);
+/** Operation applicability is independent of any vendor model-id spelling. */
+export function quotaConstraintAppliesToRequestKind(constraint, requestKind = "text") {
+    return constraint.applies_to_request_kinds?.includes(requestKind) ?? true;
+}
+//# sourceMappingURL=quota-request-kind.js.map

package/dist/quota-request-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-request-kind.js","sourceRoot":"","sources":["../src/quota-request-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,yFAAyF;AACzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAG1D,8EAA8E;AAC9E,MAAM,UAAU,mCAAmC,CACjD,UAA6D,EAC7D,WAAW,GAAqB,MAAM;IAEtC,OAAO,UAAU,CAAC,wBAAwB,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;AAC5E,CAAC"}