@openlimiter/connectors 0.2.0 → 0.4.0

package/dist/antigravity.d.ts

@@ -1,4 +1,19 @@
 import type { ConnectorContract, RawMeter } from "@openlimiter/core";
+/**
+ * The Antigravity quota reader.
+ *
+ * The shape below is the one a working reader observed against a real Google AI
+ * Pro account on 2026-08-07, recorded in
+ * `Product Idea/reference-implementation`. Design evidence, not verification
+ * evidence: Google publishes nothing about this surface, so the provider stays
+ * UNVERIFIED whatever we observe.
+ *
+ * The response is not a percentage in a field. It is a list of GROUPS, each
+ * holding a list of BUCKETS, each bucket carrying `remainingFraction` between
+ * zero and one, a window name, and an RFC3339 reset. Usage is one minus that
+ * fraction. The reader used to parse `quota.used_percent`, a shape from an
+ * early prototype that has never been seen on the wire.
+ */
 export declare const antigravityLabels: {
     readonly credentialOrigin: "official-local-tool";
     readonly dataInterfaceStatus: "internal-endpoint";
@@ -10,6 +25,39 @@ export declare const antigravityInput: {
     readonly pathTemplate: "{providerState}/quota.json";
     readonly readMode: "read_only";
 };
+/** What this reader reads. JSON, because the endpoint answers JSON. */
+export declare const antigravityEncoding: "json";
+/**
+ * The bucket prefix naming the pool this provider tracks.
+ *
+ * Matched against the prefix of `bucketId` EXACTLY, never as a substring. A
+ * hypothetical `3p-gemini-fallback` bucket would satisfy a naive containment
+ * test and let a third party pool overwrite the real one, which is a wrong
+ * number rather than a missing one.
+ */
+export declare const ANTIGRAVITY_TRACKED_POOL = "gemini";
+/**
+ * The window names this build understands, and how long each one is.
+ *
+ * Google spells them "5h" and "weekly". A window name outside this table is not
+ * dropped: the whole payload is refused. Dropping it would remove a window that
+ * might be the binding one and leave the meter confidently reporting a LOWER
+ * number than the truth, which is the exact failure this product exists to
+ * prevent.
+ */
+export declare const ANTIGRAVITY_WINDOWS: Readonly<Record<string, number>>;
+/**
+ * The tracked pool's binding window, as one meter.
+ *
+ * One meter rather than one per window, matching what the reference reader's
+ * bar shows and what the registry declares: the BINDING window, meaning the one
+ * with the highest usage, because that is the one that will stop the work.
+ *
+ * The third party pool that rides the same subscription is deliberately not
+ * modelled. It is a real second wallet, and reporting it under this provider's
+ * single meter would conflate two pools into one number. It needs its own
+ * identity in the registry before it can have one here.
+ */
 export declare function parseAntigravityPayload(payload: unknown, now: string): RawMeter[] | null;
 export declare const antigravityConnector: ConnectorContract;
 //# sourceMappingURL=antigravity.d.ts.map

package/dist/antigravity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"antigravity.d.ts","sourceRoot":"","sources":["../src/antigravity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EAGjB,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAG3B,eAAO,MAAM,iBAAiB;;;;;CAKM,CAAC;AAErC,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,CAmBxF;AAED,eAAO,MAAM,oBAAoB,EAAE,iBAalC,CAAC"}
+{"version":3,"file":"antigravity.d.ts","sourceRoot":"","sources":["../src/antigravity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EAGjB,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAU3B;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,iBAAiB;;;;;CAKM,CAAC;AAErC,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,EAAG,MAAe,CAAC;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,WAAW,CAAC;AAEjD;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGhE,CAAC;AAuDF;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,GACV,QAAQ,EAAE,GAAG,IAAI,CAsCnB;AAED,eAAO,MAAM,oBAAoB,EAAE,iBAclC,CAAC"}

package/dist/antigravity.js

@@ -1,4 +1,19 @@
-import { boundedNumber, futureInstant, rawMeter, record, shortExpiry } from "./shared.js";
+import { boundedFraction, futureInstantFromRfc3339, plausibleResetHorizon, rawMeter, record, shortExpiry } from "./shared.js";
+/**
+ * The Antigravity quota reader.
+ *
+ * The shape below is the one a working reader observed against a real Google AI
+ * Pro account on 2026-08-07, recorded in
+ * `Product Idea/reference-implementation`. Design evidence, not verification
+ * evidence: Google publishes nothing about this surface, so the provider stays
+ * UNVERIFIED whatever we observe.
+ *
+ * The response is not a percentage in a field. It is a list of GROUPS, each
+ * holding a list of BUCKETS, each bucket carrying `remainingFraction` between
+ * zero and one, a window name, and an RFC3339 reset. Usage is one minus that
+ * fraction. The reader used to parse `quota.used_percent`, a shape from an
+ * early prototype that has never been seen on the wire.
+ */
 export const antigravityLabels = {
     credentialOrigin: "official-local-tool",
     dataInterfaceStatus: "internal-endpoint",
@@ -10,20 +25,133 @@ export const antigravityInput = {
     pathTemplate: "{providerState}/quota.json",
     readMode: "read_only"
 };
+/** What this reader reads. JSON, because the endpoint answers JSON. */
+export const antigravityEncoding = "json";
+/**
+ * The bucket prefix naming the pool this provider tracks.
+ *
+ * Matched against the prefix of `bucketId` EXACTLY, never as a substring. A
+ * hypothetical `3p-gemini-fallback` bucket would satisfy a naive containment
+ * test and let a third party pool overwrite the real one, which is a wrong
+ * number rather than a missing one.
+ */
+export const ANTIGRAVITY_TRACKED_POOL = "gemini";
+/**
+ * The window names this build understands, and how long each one is.
+ *
+ * Google spells them "5h" and "weekly". A window name outside this table is not
+ * dropped: the whole payload is refused. Dropping it would remove a window that
+ * might be the binding one and leave the meter confidently reporting a LOWER
+ * number than the truth, which is the exact failure this product exists to
+ * prevent.
+ */
+export const ANTIGRAVITY_WINDOWS = {
+    "5h": 18_000,
+    weekly: 604_800
+};
+/**
+ * Every bucket of one group, or null if any one of them cannot be believed.
+ *
+ * Whole rather than per bucket, for the reason above: a partially read group is
+ * a group whose worst window may be the one that failed to read.
+ */
+function readBuckets(buckets, now) {
+    const windows = [];
+    for (const entry of buckets) {
+        const bucket = record(entry);
+        if (bucket === null)
+            return null;
+        const fraction = boundedFraction(bucket["remainingFraction"]);
+        if (fraction === null)
+            return null;
+        const name = bucket["window"];
+        if (typeof name !== "string")
+            return null;
+        const seconds = ANTIGRAVITY_WINDOWS[name.toLowerCase()];
+        if (seconds === undefined)
+            return null;
+        const resetAt = futureInstantFromRfc3339(bucket["resetTime"], now, plausibleResetHorizon(seconds));
+        if (resetAt === null)
+            return null;
+        /* One decimal, which is the precision the reference reader keeps and more
+           than a quota bar can show. Clamped, because floating point subtraction
+           of a fraction can land a hair outside the range. */
+        const percent = Math.round(Math.max(0, Math.min(100, (1 - fraction) * 100)) * 10) / 10;
+        windows.push({ percent, seconds, resetAt });
+    }
+    return windows.length === 0 ? null : windows;
+}
+/** The prefix of every bucket id in a group, or null if any is unreadable. */
+function poolPrefixes(buckets) {
+    const prefixes = new Set();
+    for (const entry of buckets) {
+        const bucket = record(entry);
+        if (bucket === null)
+            return null;
+        const id = bucket["bucketId"];
+        if (typeof id !== "string")
+            return null;
+        const separator = id.indexOf("-");
+        if (separator <= 0)
+            return null;
+        prefixes.add(id.slice(0, separator));
+    }
+    return prefixes;
+}
+/**
+ * The tracked pool's binding window, as one meter.
+ *
+ * One meter rather than one per window, matching what the reference reader's
+ * bar shows and what the registry declares: the BINDING window, meaning the one
+ * with the highest usage, because that is the one that will stop the work.
+ *
+ * The third party pool that rides the same subscription is deliberately not
+ * modelled. It is a real second wallet, and reporting it under this provider's
+ * single meter would conflate two pools into one number. It needs its own
+ * identity in the registry before it can have one here.
+ */
 export function parseAntigravityPayload(payload, now) {
     const root = record(payload);
-    const quota = record(root?.["quota"]);
-    const percent = boundedNumber(quota?.["used_percent"]);
-    const resetAt = futureInstant(quota?.["reset_at"], now);
+    const groups = root?.["groups"];
+    if (!Array.isArray(groups))
+        return null;
+    let tracked = null;
+    for (const entry of groups) {
+        const group = record(entry);
+        if (group === null)
+            return null;
+        const buckets = group["buckets"];
+        if (!Array.isArray(buckets))
+            return null;
+        const prefixes = poolPrefixes(buckets);
+        if (prefixes === null)
+            return null;
+        if (!prefixes.has(ANTIGRAVITY_TRACKED_POOL))
+            continue;
+        /* Two groups claiming the same pool is ambiguous, and picking one would be
+           picking at random. */
+        if (tracked !== null)
+            return null;
+        tracked = readBuckets(buckets, now);
+        if (tracked === null)
+            return null;
+    }
+    if (tracked === null)
+        return null;
     const expiresAt = shortExpiry(now);
-    if (percent === null || resetAt === null || expiresAt === null)
+    if (expiresAt === null)
         return null;
+    let binding = tracked[0];
+    for (const candidate of tracked.slice(1)) {
+        if (candidate.percent > binding.percent)
+            binding = candidate;
+    }
     return [rawMeter({
             provider: "ANTIGRAVITY",
             meter: "PRIMARY",
-            value: percent,
-            window: { kind: "fixed" },
-            resetAt,
+            value: binding.percent,
+            window: { kind: "rolling", durationSeconds: binding.seconds },
+            resetAt: binding.resetAt,
             source: "internal_payload",
             precision: "estimated",
             observedAt: now,
@@ -34,6 +162,7 @@ export function parseAntigravityPayload(payload, now) {
 export const antigravityConnector = {
     id: "antigravity",
     displayName: "Antigravity",
+    encoding: "json",
     labels: antigravityLabels,
     detect(environment) {
         return environment["ANTIGRAVITY_USAGE_PAYLOAD"] === "1";

package/dist/antigravity.js.map

@@ -1 +1 @@
-{"version":3,"file":"antigravity.js","sourceRoot":"","sources":["../src/antigravity.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1F,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,gBAAgB,EAAE,qBAAqB;IACvC,mBAAmB,EAAE,mBAAmB;IACxC,cAAc,EAAE,MAAM;IACtB,YAAY,EAAE,YAAY;CACQ,CAAC;AAErC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,0BAA0B;IAChC,YAAY,EAAE,4BAA4B;IAC1C,QAAQ,EAAE,WAAW;CACb,CAAC;AAEX,MAAM,UAAU,uBAAuB,CAAC,OAAgB,EAAE,GAAW;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5E,OAAO,CAAC,QAAQ,CAAC;YACf,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;YACzB,OAAO;YACP,MAAM,EAAE,kBAAkB;YAC1B,SAAS,EAAE,WAAW;YACtB,UAAU,EAAE,GAAG;YACf,SAAS;YACT,MAAM,EAAE,iBAAiB;SAC1B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,EAAE,EAAE,aAAa;IACjB,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,iBAAiB;IACzB,MAAM,CAAC,WAAW;QAChB,OAAO,WAAW,CAAC,2BAA2B,CAAC,KAAK,GAAG,CAAC;IAC1D,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,OAAO;QAChB,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACrE,OAAO,MAAM,KAAK,IAAI;YACpB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;YAClC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC"}
+{"version":3,"file":"antigravity.js","sourceRoot":"","sources":["../src/antigravity.ts"],"names":[],"mappings":"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"}

package/dist/claude.d.ts

@@ -13,8 +13,35 @@ export declare const claudeInput: {
 /**
  * Parse the rate limit block of a Claude Code statusline payload.
  *
- * Shape: { "rate_limits": { "five_hour": { "utilization": 42,
- * "resets_at": "2026-09-01T05:00:00.000Z" }, "seven_day": { ... } } }
+ * Documented shape, from https://code.claude.com/docs/en/statusline
+ * reviewed 2026-08-10:
+ *
+ * ```json
+ * {
+ *   "rate_limits": {
+ *     "five_hour": { "used_percentage": 23.5, "resets_at": 1738425600 },
+ *     "seven_day": { "used_percentage": 41.2, "resets_at": 1738857600 }
+ *   }
+ * }
+ * ```
+ *
+ * `used_percentage` is the share of the window consumed, from 0 to 100.
+ * `resets_at` is Unix epoch SECONDS, a number, not a date string.
+ *
+ * Three absences the documentation states, and none of them is an error:
+ *
+ * 1. `rate_limits` appears only for Claude.ai subscribers on Pro or Max, and
+ *    only after the first API response in the session. A payload without it is
+ *    an ordinary payload from a free account or a session that has not called
+ *    the API yet.
+ * 2. Each window may be independently absent, so one present window is one
+ *    meter and is a complete answer.
+ * 3. No window present is the honest unknown, not zero.
+ *
+ * An earlier version of this parser read a field named `utilization` and an ISO
+ * date string. No Claude Code release is known to have emitted either, and the
+ * only thing that ever agreed with them was our own fixture, so nothing here
+ * falls back to that shape.
  *
  * A window that fails validation is dropped and the other window still counts,
  * because one expired window is not a reason to forget the whole session.

package/dist/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../src/claude.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EAGjB,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAG3B,eAAO,MAAM,YAAY;;;;;CAKW,CAAC;AAErC,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAiCX;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,CAgBnF;AAED,eAAO,MAAM,eAAe,EAAE,iBAa7B,CAAC"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../src/claude.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,iBAAiB,EAGjB,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAU3B,eAAO,MAAM,YAAY;;;;;CAKW,CAAC;AAErC,eAAO,MAAM,WAAW;;;;CAId,CAAC;AA0CX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,CAgBnF;AAED,eAAO,MAAM,eAAe,EAAE,iBAc7B,CAAC"}

package/dist/claude.js

@@ -1,4 +1,4 @@
-import { boundedNumber, futureInstant, rawMeter, record, shortExpiry } from "./shared.js";
+import { boundedNumber, futureInstantFromEpochSeconds, plausibleResetHorizon, rawMeter, record, shortExpiry } from "./shared.js";
 export const claudeLabels = {
     credentialOrigin: "official-local-tool",
     dataInterfaceStatus: "native-statusline-payload",
@@ -14,8 +14,13 @@ function parseWindow(value, now, meter, durationSeconds) {
     const input = record(value);
     if (input === null)
         return null;
-    const percent = boundedNumber(input["utilization"]);
-    const resetAt = futureInstant(input["resets_at"], now);
+    const percent = boundedNumber(input["used_percentage"]);
+    /*
+     * The reset has to belong to the window that named it. A five hour window
+     * resetting years from now is a corrupt field, not a long wait, and it is
+     * dropped on its own so the other window still reports.
+     */
+    const resetAt = futureInstantFromEpochSeconds(input["resets_at"], now, plausibleResetHorizon(durationSeconds));
     const expiresAt = shortExpiry(now);
     if (percent === null || resetAt === null || expiresAt === null)
         return null;
@@ -39,8 +44,35 @@ const windows = [
 /**
  * Parse the rate limit block of a Claude Code statusline payload.
  *
- * Shape: { "rate_limits": { "five_hour": { "utilization": 42,
- * "resets_at": "2026-09-01T05:00:00.000Z" }, "seven_day": { ... } } }
+ * Documented shape, from https://code.claude.com/docs/en/statusline
+ * reviewed 2026-08-10:
+ *
+ * ```json
+ * {
+ *   "rate_limits": {
+ *     "five_hour": { "used_percentage": 23.5, "resets_at": 1738425600 },
+ *     "seven_day": { "used_percentage": 41.2, "resets_at": 1738857600 }
+ *   }
+ * }
+ * ```
+ *
+ * `used_percentage` is the share of the window consumed, from 0 to 100.
+ * `resets_at` is Unix epoch SECONDS, a number, not a date string.
+ *
+ * Three absences the documentation states, and none of them is an error:
+ *
+ * 1. `rate_limits` appears only for Claude.ai subscribers on Pro or Max, and
+ *    only after the first API response in the session. A payload without it is
+ *    an ordinary payload from a free account or a session that has not called
+ *    the API yet.
+ * 2. Each window may be independently absent, so one present window is one
+ *    meter and is a complete answer.
+ * 3. No window present is the honest unknown, not zero.
+ *
+ * An earlier version of this parser read a field named `utilization` and an ISO
+ * date string. No Claude Code release is known to have emitted either, and the
+ * only thing that ever agreed with them was our own fixture, so nothing here
+ * falls back to that shape.
  *
  * A window that fails validation is dropped and the other window still counts,
  * because one expired window is not a reason to forget the whole session.
@@ -62,6 +94,7 @@ export function parseClaudePayload(payload, now) {
 }
 export const claudeConnector = {
     id: "claude",
+    encoding: "json",
     displayName: "Claude",
     labels: claudeLabels,
     detect(environment) {

package/dist/claude.js.map

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

package/dist/codex.d.ts

@@ -1,4 +1,22 @@
 import type { ConnectorContract, RawMeter } from "@openlimiter/core";
+/**
+ * The Codex usage reader.
+ *
+ * The shape below is the one a working reader observed against a real account
+ * on 2026-08-07, recorded in `Product Idea/reference-implementation`. OpenAI
+ * publishes nothing about it, so it is DESIGN evidence and not verification
+ * evidence: it tells us what to parse, and it does not turn an internal
+ * endpoint into an official API. The labels below stay as they are, and the
+ * provider stays UNVERIFIED, until a sanitized capture lands in the fixture
+ * slot and even then the interface is still internal.
+ *
+ * The reader used to parse `rate_limits` with an s, a shape carried over from
+ * an early prototype and never seen on the wire. The real field is
+ * `rate_limit`, singular. That one letter is the whole reason the drift
+ * machinery exists: both shapes are well formed JSON, both would have arrived
+ * with a 200, and the wrong one produces no reading at all rather than a wrong
+ * one only because this parser refuses whatever it was not told to expect.
+ */
 export declare const codexLabels: {
     readonly credentialOrigin: "official-local-tool";
     readonly dataInterfaceStatus: "internal-endpoint";
@@ -10,6 +28,27 @@ export declare const codexInput: {
     readonly pathTemplate: "{providerState}/usage.json";
     readonly readMode: "read_only";
 };
+/** What this reader reads. JSON, because the endpoint answers JSON. */
+export declare const codexEncoding: "json";
+/**
+ * The observed response, reduced to what may be believed.
+ *
+ * `used_percent` is a percentage and `reset_at` is Unix epoch SECONDS. The
+ * encoding was not guessed: the reference reader passes `reset_at` through
+ * untouched into a cache whose consumers format it with an epoch formatter,
+ * while it explicitly converts the other two providers' RFC3339 stamps first.
+ *
+ * `limit_window_seconds` is the window's own length, stated by the provider. It
+ * is optional, because the reference treats it as optional, and its absence
+ * costs only the plausibility bound: a window whose length is unknown cannot be
+ * called rolling, so it is reported as an unknown window rather than as a five
+ * hour one this build made up.
+ *
+ * The secondary window is deliberately NOT modelled. Plans differ in whether
+ * they have one, the registry declares a single meter, and folding a second
+ * window into the same meter would silently report whichever one this build
+ * happened to read last.
+ */
 export declare function parseCodexPayload(payload: unknown, now: string): RawMeter[] | null;
 export declare const codexConnector: ConnectorContract;
 //# sourceMappingURL=codex.d.ts.map

package/dist/codex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../src/codex.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EAGjB,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAG3B,eAAO,MAAM,WAAW;;;;;CAKY,CAAC;AAErC,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,CAoBlF;AAED,eAAO,MAAM,cAAc,EAAE,iBAa5B,CAAC"}
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../src/codex.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EAGjB,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAW3B;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,WAAW;;;;;CAKY,CAAC;AAErC,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,aAAa,EAAG,MAAe,CAAC;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,CA4BlF;AAED,eAAO,MAAM,cAAc,EAAE,iBAc5B,CAAC"}

package/dist/codex.js

@@ -1,4 +1,22 @@
-import { boundedNumber, futureInstant, rawMeter, record, shortExpiry } from "./shared.js";
+import { boundedNumber, futureInstantFromEpochSeconds, plausibleResetHorizon, rawMeter, record, shortExpiry, windowSeconds } from "./shared.js";
+/**
+ * The Codex usage reader.
+ *
+ * The shape below is the one a working reader observed against a real account
+ * on 2026-08-07, recorded in `Product Idea/reference-implementation`. OpenAI
+ * publishes nothing about it, so it is DESIGN evidence and not verification
+ * evidence: it tells us what to parse, and it does not turn an internal
+ * endpoint into an official API. The labels below stay as they are, and the
+ * provider stays UNVERIFIED, until a sanitized capture lands in the fixture
+ * slot and even then the interface is still internal.
+ *
+ * The reader used to parse `rate_limits` with an s, a shape carried over from
+ * an early prototype and never seen on the wire. The real field is
+ * `rate_limit`, singular. That one letter is the whole reason the drift
+ * machinery exists: both shapes are well formed JSON, both would have arrived
+ * with a 200, and the wrong one produces no reading at all rather than a wrong
+ * one only because this parser refuses whatever it was not told to expect.
+ */
 export const codexLabels = {
     credentialOrigin: "official-local-tool",
     dataInterfaceStatus: "internal-endpoint",
@@ -10,20 +28,46 @@ export const codexInput = {
     pathTemplate: "{providerState}/usage.json",
     readMode: "read_only"
 };
+/** What this reader reads. JSON, because the endpoint answers JSON. */
+export const codexEncoding = "json";
+/**
+ * The observed response, reduced to what may be believed.
+ *
+ * `used_percent` is a percentage and `reset_at` is Unix epoch SECONDS. The
+ * encoding was not guessed: the reference reader passes `reset_at` through
+ * untouched into a cache whose consumers format it with an epoch formatter,
+ * while it explicitly converts the other two providers' RFC3339 stamps first.
+ *
+ * `limit_window_seconds` is the window's own length, stated by the provider. It
+ * is optional, because the reference treats it as optional, and its absence
+ * costs only the plausibility bound: a window whose length is unknown cannot be
+ * called rolling, so it is reported as an unknown window rather than as a five
+ * hour one this build made up.
+ *
+ * The secondary window is deliberately NOT modelled. Plans differ in whether
+ * they have one, the registry declares a single meter, and folding a second
+ * window into the same meter would silently report whichever one this build
+ * happened to read last.
+ */
 export function parseCodexPayload(payload, now) {
     const root = record(payload);
-    const limits = record(root?.["rate_limits"]);
+    const limits = record(root?.["rate_limit"]);
     const primary = record(limits?.["primary_window"]);
     const percent = boundedNumber(primary?.["used_percent"]);
-    const resetAt = futureInstant(primary?.["reset_at"], now);
+    if (percent === null)
+        return null;
+    const length = windowSeconds(primary?.["limit_window_seconds"]);
+    const resetAt = futureInstantFromEpochSeconds(primary?.["reset_at"], now, length === null ? undefined : plausibleResetHorizon(length));
     const expiresAt = shortExpiry(now);
-    if (percent === null || resetAt === null || expiresAt === null)
+    if (resetAt === null || expiresAt === null)
         return null;
     return [rawMeter({
             provider: "CODEX",
             meter: "PRIMARY",
             value: percent,
-            window: { kind: "rolling", durationSeconds: 18_000 },
+            window: length === null
+                ? { kind: "unknown" }
+                : { kind: "rolling", durationSeconds: length },
             resetAt,
             source: "internal_payload",
             precision: "estimated",
@@ -35,6 +79,7 @@ export function parseCodexPayload(payload, now) {
 export const codexConnector = {
     id: "codex",
     displayName: "Codex",
+    encoding: "json",
     labels: codexLabels,
     detect(environment) {
         return environment["CODEX_USAGE_PAYLOAD"] === "1";

package/dist/codex.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex.js","sourceRoot":"","sources":["../src/codex.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1F,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gBAAgB,EAAE,qBAAqB;IACvC,mBAAmB,EAAE,mBAAmB;IACxC,cAAc,EAAE,MAAM;IACtB,YAAY,EAAE,YAAY;CACQ,CAAC;AAErC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,0BAA0B;IAChC,YAAY,EAAE,4BAA4B;IAC1C,QAAQ,EAAE,WAAW;CACb,CAAC;AAEX,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,GAAW;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5E,OAAO,CAAC,QAAQ,CAAC;YACf,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE;YACpD,OAAO;YACP,MAAM,EAAE,kBAAkB;YAC1B,SAAS,EAAE,WAAW;YACtB,UAAU,EAAE,GAAG;YACf,SAAS;YACT,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,OAAO;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,CAAC,WAAW;QAChB,OAAO,WAAW,CAAC,qBAAqB,CAAC,KAAK,GAAG,CAAC;IACpD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,OAAO;QAChB,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/D,OAAO,MAAM,KAAK,IAAI;YACpB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;YAClC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC"}
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../src/codex.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,aAAa,EACb,6BAA6B,EAC7B,qBAAqB,EACrB,QAAQ,EACR,MAAM,EACN,WAAW,EACX,aAAa,EACd,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gBAAgB,EAAE,qBAAqB;IACvC,mBAAmB,EAAE,mBAAmB;IACxC,cAAc,EAAE,MAAM;IACtB,YAAY,EAAE,YAAY;CACQ,CAAC;AAErC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,0BAA0B;IAChC,YAAY,EAAE,4BAA4B;IAC1C,QAAQ,EAAE,WAAW;CACb,CAAC;AAEX,uEAAuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAG,MAAe,CAAC;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,GAAW;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IACzD,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,6BAA6B,CAC3C,OAAO,EAAE,CAAC,UAAU,CAAC,EACrB,GAAG,EACH,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAC5D,CAAC;IACF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,OAAO,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxD,OAAO,CAAC,QAAQ,CAAC;YACf,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,MAAM,KAAK,IAAI;gBACrB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;gBACrB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE;YAChD,OAAO;YACP,MAAM,EAAE,kBAAkB;YAC1B,SAAS,EAAE,WAAW;YACtB,UAAU,EAAE,GAAG;YACf,SAAS;YACT,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,OAAO;IACpB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,WAAW;IACnB,MAAM,CAAC,WAAW;QAChB,OAAO,WAAW,CAAC,qBAAqB,CAAC,KAAK,GAAG,CAAC;IACpD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,OAAO;QAChB,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/D,OAAO,MAAM,KAAK,IAAI;YACpB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;YAClC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC"}