@openlimiter/connectors 0.2.0 → 1.2.0

package/dist/antigravity.d.ts

@@ -1,4 +1,19 @@
-import type { ConnectorContract, RawMeter } from "@openlimiter/core";
+import type { ConnectionTool, 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,40 @@ 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>>;
+/**
+ * Every documented window in the tracked pool, as its own meter.
+ *
+ * The shell may still derive one binding percentage for advice and the tray,
+ * but the dashboard must not discard the other window to get there.
+ *
+ * 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;
+/** The local application that owns this credential. */
+export declare const ANTIGRAVITY_TOOL: ConnectionTool;
 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,cAAc,EACd,iBAAiB,EAGjB,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAW3B;;;;;;;;;;;;;;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;AA6DF;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,GACV,QAAQ,EAAE,GAAG,IAAI,CAkCnB;AAED,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,EAAE,cAA8B,CAAC;AAE9D,eAAO,MAAM,oBAAoB,EAAE,iBAmBlC,CAAC"}

package/dist/antigravity.js

@@ -1,4 +1,19 @@
-import { boundedNumber, futureInstant, rawMeter, record, shortExpiry } from "./shared.js";
+import { boundedFraction, connectorConnection, 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,39 +25,155 @@ 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({
+            meter: name.toLowerCase() === "5h" ? "FIVE_HOUR" : "SEVEN_DAY",
+            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;
+}
+/**
+ * Every documented window in the tracked pool, as its own meter.
+ *
+ * The shell may still derive one binding percentage for advice and the tray,
+ * but the dashboard must not discard the other window to get there.
+ *
+ * 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;
-    return [rawMeter({
-            provider: "ANTIGRAVITY",
-            meter: "PRIMARY",
-            value: percent,
-            window: { kind: "fixed" },
-            resetAt,
-            source: "internal_payload",
-            precision: "estimated",
-            observedAt: now,
-            expiresAt,
-            labels: antigravityLabels
-        })];
+    return tracked.map((candidate) => rawMeter({
+        provider: "ANTIGRAVITY",
+        meter: candidate.meter,
+        value: candidate.percent,
+        window: { kind: "rolling", durationSeconds: candidate.seconds },
+        resetAt: candidate.resetAt,
+        source: "internal_payload",
+        precision: "estimated",
+        observedAt: now,
+        expiresAt,
+        labels: antigravityLabels
+    }));
 }
+/** The local application that owns this credential. */
+export const ANTIGRAVITY_TOOL = "Antigravity";
 export const antigravityConnector = {
     id: "antigravity",
     displayName: "Antigravity",
+    encoding: "json",
     labels: antigravityLabels,
     detect(environment) {
         return environment["ANTIGRAVITY_USAGE_PAYLOAD"] === "1";
     },
     async read(context) {
         const meters = parseAntigravityPayload(context.payload, context.now);
+        const connection = connectorConnection(meters !== null, context.payload, ANTIGRAVITY_TOOL);
         return meters === null
-            ? { ok: false, reason: "unknown" }
-            : { ok: true, meters };
+            ? { ok: false, reason: "unknown", connection }
+            : { ok: true, meters, connection };
     }
 };
 //# sourceMappingURL=antigravity.js.map

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

@@ -1,4 +1,4 @@
-import type { ConnectorContract, RawMeter } from "@openlimiter/core";
+import type { ConnectionTool, ConnectorContract, RawMeter } from "@openlimiter/core";
 export declare const claudeLabels: {
     readonly credentialOrigin: "official-local-tool";
     readonly dataInterfaceStatus: "native-statusline-payload";
@@ -11,14 +11,80 @@ export declare const claudeInput: {
     readonly readMode: "read_only";
 };
 /**
- * Parse the rate limit block of a Claude Code statusline payload.
+ * The longest a window this reader was never told the length of may run.
  *
- * Shape: { "rate_limits": { "five_hour": { "utilization": 42,
- * "resets_at": "2026-09-01T05:00:00.000Z" }, "seven_day": { ... } } }
+ * A bucket whose key spells out no cadence still needs SOME plausibility bound,
+ * or a corrupt reset becomes a countdown to the year 2038. A month is the
+ * longest subscription window any provider in this product uses, so a reset
+ * beyond it is a corrupt field rather than a long wait.
+ */
+export declare const CLAUDE_UNKNOWN_WINDOW_SECONDS = 2678400;
+/** The prefix every model scoped weekly bucket's code is built on. */
+export declare const CLAUDE_MODEL_WEEKLY_PREFIX = "SEVEN_DAY_";
+/** Longest source string this reader will turn into a meter code. */
+export declare const MAX_METER_CODE_SOURCE_CHARS = 64;
+/**
+ * Parse a Claude usage document, in either shape the same credential produces.
+ *
+ * SHAPE ONE, the statusline payload, from
+ * https://code.claude.com/docs/en/statusline and observed on Claude Code
+ * 2.1.261 on 2026-09-04:
+ *
+ * ```json
+ * {
+ *   "rate_limits": {
+ *     "five_hour":            { "used_percentage": 23.5, "resets_at": 1738425600 },
+ *     "seven_day":            { "used_percentage": 41.2, "resets_at": 1738857600 },
+ *     "seven_day_oauth_apps": { "used_percentage": 3.1,  "resets_at": 1738857600 },
+ *     "seven_day_opus":       { "used_percentage": 61.0, "resets_at": 1738857600 },
+ *     "seven_day_sonnet":     { "used_percentage": 12.4, "resets_at": 1738857600 },
+ *     "model_scoped": [
+ *       { "display_name": "Fable 5", "utilization": 12, "resets_at": "2026-09-11T00:00:00Z" }
+ *     ]
+ *   }
+ * }
+ * ```
+ *
+ * SHAPE TWO, the `api/oauth/usage` document, which is what `openlimiter ingest`
+ * is handed. Its windows sit at the root, state `utilization` and an ISO reset,
+ * and it carries two things the statusline does not: an `extra_usage` pool
+ * stated in money, and a `limits` list of model scoped weekly buckets:
+ *
+ * ```json
+ * {
+ *   "five_hour":   { "utilization": 90, "resets_at": "2026-09-04T17:00:00Z" },
+ *   "seven_day":   { "utilization": 18, "resets_at": "2026-09-09T00:00:00Z" },
+ *   "extra_usage": { "used_amount": 12.47, "limit_amount": 20, "currency": "USD" },
+ *   "limits": [
+ *     {
+ *       "kind": "weekly_scoped",
+ *       "percent": 61,
+ *       "resets_at": "2026-09-09T00:00:00Z",
+ *       "scope": { "model": { "display_name": "Opus" } }
+ *     }
+ *   ]
+ * }
+ * ```
+ *
+ * Refusing the second shape was finding F-201: a real document, from a real
+ * account, over a healthy connection, answered null because this parser knew
+ * only `used_percentage` and only epoch seconds.
+ *
+ * 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 and
+ *    without any usage document field is an ordinary payload from a free
+ *    account or a session that has not called the API yet.
+ * 2. Each bucket may be independently absent, so one present bucket is one
+ *    meter and is a complete answer.
+ * 3. No bucket present is the honest unknown, not zero.
  *
- * 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.
+ * A bucket that fails validation is dropped and the rest still count, because
+ * one corrupt reset is not a reason to forget the whole session.
  */
 export declare function parseClaudePayload(payload: unknown, now: string): RawMeter[] | null;
+/** The local application that owns this credential. */
+export declare const CLAUDE_TOOL: ConnectionTool;
 export declare const claudeConnector: ConnectorContract;
 //# sourceMappingURL=claude.d.ts.map

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":"AAOA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAGjB,QAAQ,EAIT,MAAM,mBAAmB,CAAC;AAY3B,eAAO,MAAM,YAAY;;;;;CAKW,CAAC;AAErC,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAKX;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,UAAY,CAAC;AAgCvD,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,eAAe,CAAC;AAEvD,qEAAqE;AACrE,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAiY9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,CAmCnF;AAED,uDAAuD;AACvD,eAAO,MAAM,WAAW,EAAE,cAA8B,CAAC;AAEzD,eAAO,MAAM,eAAe,EAAE,iBAmB7B,CAAC"}