@openlimiter/connectors 0.2.0 → 1.2.0

package/dist/openrouter.js

@@ -1,4 +1,4 @@
-import { boundedNumber, rawMeter, record, shortExpiry } from "./shared.js";
+import { boundedNumber, connectorConnection, rawMeter, record, shortExpiry } from "./shared.js";
 export const openrouterLabels = {
     credentialOrigin: "user-key",
     dataInterfaceStatus: "documented-api",
@@ -48,8 +48,11 @@ export function parseOpenrouterPayload(payload, now) {
             amounts: { usedAmount: usage, limitAmount: credits, currency: "USD" }
         })];
 }
+/** No local application owns this key, so no instruction names one. */
+export const OPENROUTER_TOOL = null;
 export const openrouterConnector = {
     id: "openrouter",
+    encoding: "json",
     displayName: "OpenRouter",
     labels: openrouterLabels,
     detect(environment) {
@@ -57,9 +60,10 @@ export const openrouterConnector = {
     },
     async read(context) {
         const meters = parseOpenrouterPayload(context.payload, context.now);
+        const connection = connectorConnection(meters !== null, context.payload, OPENROUTER_TOOL);
         return meters === null
-            ? { ok: false, reason: "unknown" }
-            : { ok: true, meters };
+            ? { ok: false, reason: "unknown", connection }
+            : { ok: true, meters, connection };
     }
 };
 //# sourceMappingURL=openrouter.js.map

package/dist/openrouter.js.map

@@ -1 +1 @@
-{"version":3,"file":"openrouter.js","sourceRoot":"","sources":["../src/openrouter.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE3E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gBAAgB,EAAE,UAAU;IAC5B,mBAAmB,EAAE,gBAAgB;IACrC,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,YAAY;CACQ,CAAC;AAErC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,YAAY;IACrB,cAAc,EAAE,IAAI;IACpB,QAAQ,EAAE,WAAW;CACb,CAAC;AAEX,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,GAAW;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,IACE,OAAO,KAAK,IAAI;QAChB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,CAAC;QACZ,KAAK,GAAG,OAAO;QACf,SAAS,KAAK,IAAI;QAClB,OAAO,IAAI,CAAC;IACd,MAAM,OAAO,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IAC3E;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC;YACf,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;YAC5B,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,gBAAgB;YACxB,SAAS,EAAE,OAAO;YAClB,UAAU,EAAE,GAAG;YACf,SAAS;YACT,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;SACtE,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,EAAE,EAAE,YAAY;IAChB,WAAW,EAAE,YAAY;IACzB,MAAM,EAAE,gBAAgB;IACxB,MAAM,CAAC,WAAW;QAChB,OAAO,WAAW,CAAC,mCAAmC,CAAC,KAAK,WAAW,CAAC;IAC1E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,OAAO;QAChB,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACpE,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":"openrouter.js","sourceRoot":"","sources":["../src/openrouter.ts"],"names":[],"mappings":"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"}

package/dist/shared.d.ts

@@ -1,7 +1,111 @@
-import type { ConnectorLabels, ProviderCode, RawMeter, SnapshotAmounts, SnapshotPrecision, SnapshotSource, SnapshotWindow } from "@openlimiter/core";
+import type { ConnectionStatus, ConnectionTool, ConnectorLabels, ProviderCode, RawMeter, SnapshotAmounts, SnapshotPrecision, SnapshotSource, SnapshotWindow } from "@openlimiter/core";
+/**
+ * The connection lifecycle a reader reports beside its meters.
+ *
+ * Three outcomes, and the difference between the last two is the whole reason
+ * this exists. Nothing arrived at all is a tool that has not run yet, which is
+ * a person's next step and not a fault. Something arrived and this build could
+ * not read it is a FAULT, and it is ours rather than the provider's, which is
+ * exactly the failure the Claude statusline contract mismatch was: a healthy
+ * account, a well formed payload, and a parser that answered null in silence.
+ *
+ * `tool` names the local application that owns the credential, so an
+ * instruction can say which window to open. It is never a value a payload
+ * supplied, and no instruction it produces is something this app does by
+ * itself: OpenLimiter reads tokens and refreshes none of them.
+ */
+export declare function connectorConnection(parsed: boolean, payload: unknown, tool: ConnectionTool): ConnectionStatus;
 export declare function record(value: unknown): Record<string, unknown> | null;
 export declare function boundedNumber(value: unknown, maximum?: number): number | null;
 export declare function futureInstant(value: unknown, now: string): string | null;
+/**
+ * Largest epoch value that is still read as seconds.
+ *
+ * A number this size in seconds is the year 33658, and the same number read as
+ * milliseconds is 2001. Anything at or above it is therefore a millisecond
+ * stamp handed to a seconds field, which is the single most likely way this
+ * conversion gets a reset instant wrong, so it is refused rather than turned
+ * into a date thirty thousand years away.
+ */
+export declare const MAX_EPOCH_SECONDS = 1000000000000;
+/**
+ * Slack allowed between a machine's clock and a provider's clock.
+ *
+ * An hour covers a wrong time zone offset applied to a timestamp, which is the
+ * realistic way two correct systems disagree, without widening the plausibility
+ * bound below into something that accepts nonsense.
+ */
+export declare const CLOCK_SKEW_SECONDS = 3600;
+/**
+ * The furthest ahead a window of a given length may plausibly reset.
+ *
+ * A rolling window cannot reset more than one window from now, so twice the
+ * window is already generous, and the skew allowance sits on top of that. This
+ * is what stops a five hour meter from claiming it resets in 2038: such a value
+ * is not a reset, it is a corrupt field, a different unit, or a different
+ * meaning, and rendering a twelve year countdown beside a five hour window
+ * would be the product lying with a straight face.
+ */
+export declare function plausibleResetHorizon(windowSeconds: number): number;
+/**
+ * Read a reset instant stated as Unix epoch seconds.
+ *
+ * Claude Code states its reset times this way. The value must be a finite
+ * number, must be in seconds rather than milliseconds, must still be in the
+ * future against the supplied clock, because a window that has already reset
+ * says nothing about the window running now, and must be close enough to now to
+ * belong to the window it claims to describe. Nothing is repaired: a value that
+ * fails any of these is null and the caller drops that reading alone.
+ *
+ * `maxAheadSeconds` is the plausibility bound and is optional only so the
+ * helper stays usable for a source with no window length to reason from.
+ */
+export declare function futureInstantFromEpochSeconds(value: unknown, now: string, maxAheadSeconds?: number): string | null;
+/**
+ * A fraction of a whole, as Google's quota summary states remaining quota.
+ *
+ * Zero and one are both real answers, so the bound is inclusive. A boolean is
+ * refused explicitly: JavaScript will happily do arithmetic on `true`, and a
+ * `remainingFraction` of `true` would otherwise become a usage of zero percent,
+ * which is the most dangerous wrong answer this product can give.
+ */
+export declare function boundedFraction(value: unknown): number | null;
+/**
+ * A whole positive count of seconds, when a provider states a window length.
+ *
+ * Bounded above by a year, because a rolling window longer than that is not a
+ * subscription window, it is a misread field or a different unit.
+ */
+export declare const MAX_WINDOW_SECONDS = 31536000;
+export declare function windowSeconds(value: unknown): number | null;
+/**
+ * Read a reset instant stated as an RFC3339 timestamp.
+ *
+ * Google's quota summary states reset times this way, and the Antigravity
+ * client writes them with SEVEN fractional digits, which `Date.parse` on some
+ * runtimes reads and others do not. The fraction is normalised to three digits
+ * before parsing, which is the one repair made anywhere in this file, and it is
+ * a repair of ENCODING rather than of value: the instant it names is unchanged.
+ * Recorded 2026-08-07 against a real credential and a real response.
+ *
+ * An offsetless stamp is read as UTC explicitly. Both observed sources carry an
+ * offset today, so this is a guard rather than a fix, and it exists because the
+ * alternative is silent: a naive stamp read as local time moves a reset by the
+ * machine's offset instead of failing.
+ */
+export declare function futureInstantFromRfc3339(value: unknown, now: string, maxAheadSeconds?: number): string | null;
+/**
+ * Seconds from a duration a page spelled out in words, or null.
+ *
+ * OpenCode's workspace page prints "Resets in 5 days 20 hours" rather than a
+ * timestamp, so the only reset available is a countdown rendered for a human.
+ * Only consecutive number and unit pairs are read, and an empty or zero total
+ * is null rather than now: a reset of zero seconds would render as a countdown
+ * that has already finished.
+ */
+export declare function durationSecondsFromWords(text: string): number | null;
+/** An instant this many seconds after the supplied clock, or null. */
+export declare function instantAfter(now: string, seconds: number): string | null;
 export declare function shortExpiry(now: string): string | null;
 export declare function rawMeter(input: {
     provider: ProviderCode;

package/dist/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAIrE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAM,GAAG,MAAM,GAAG,IAAI,CAO1E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,GAAG,QAAQ,CAGX"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,cAAc,GACnB,gBAAgB,CAMlB;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAIrE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAM,GAAG,MAAM,GAAG,IAAI,CAO1E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,gBAAO,CAAC;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AAExC;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,GAAG,IAAI,CAef;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG7D;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,WAAa,CAAC;AAE7C,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,GAAG,IAAI,CAuBf;AAUD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAapE;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKxE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,GAAG,QAAQ,CAGX"}

package/dist/shared.js

@@ -1,3 +1,27 @@
+import { connectionStatus } from "@openlimiter/core";
+/**
+ * The connection lifecycle a reader reports beside its meters.
+ *
+ * Three outcomes, and the difference between the last two is the whole reason
+ * this exists. Nothing arrived at all is a tool that has not run yet, which is
+ * a person's next step and not a fault. Something arrived and this build could
+ * not read it is a FAULT, and it is ours rather than the provider's, which is
+ * exactly the failure the Claude statusline contract mismatch was: a healthy
+ * account, a well formed payload, and a parser that answered null in silence.
+ *
+ * `tool` names the local application that owns the credential, so an
+ * instruction can say which window to open. It is never a value a payload
+ * supplied, and no instruction it produces is something this app does by
+ * itself: OpenLimiter reads tokens and refreshes none of them.
+ */
+export function connectorConnection(parsed, payload, tool) {
+    if (parsed)
+        return connectionStatus("CONNECTED", null, tool);
+    if (payload === undefined || payload === null) {
+        return connectionStatus("DETECTED", "tool_not_running", tool);
+    }
+    return connectionStatus("ERROR", "shape_mismatch", tool);
+}
 export function record(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value)
         ? value
@@ -20,6 +44,172 @@ export function futureInstant(value, now) {
         ? new Date(parsed).toISOString()
         : null;
 }
+/**
+ * Largest epoch value that is still read as seconds.
+ *
+ * A number this size in seconds is the year 33658, and the same number read as
+ * milliseconds is 2001. Anything at or above it is therefore a millisecond
+ * stamp handed to a seconds field, which is the single most likely way this
+ * conversion gets a reset instant wrong, so it is refused rather than turned
+ * into a date thirty thousand years away.
+ */
+export const MAX_EPOCH_SECONDS = 1e12;
+/**
+ * Slack allowed between a machine's clock and a provider's clock.
+ *
+ * An hour covers a wrong time zone offset applied to a timestamp, which is the
+ * realistic way two correct systems disagree, without widening the plausibility
+ * bound below into something that accepts nonsense.
+ */
+export const CLOCK_SKEW_SECONDS = 3_600;
+/**
+ * The furthest ahead a window of a given length may plausibly reset.
+ *
+ * A rolling window cannot reset more than one window from now, so twice the
+ * window is already generous, and the skew allowance sits on top of that. This
+ * is what stops a five hour meter from claiming it resets in 2038: such a value
+ * is not a reset, it is a corrupt field, a different unit, or a different
+ * meaning, and rendering a twelve year countdown beside a five hour window
+ * would be the product lying with a straight face.
+ */
+export function plausibleResetHorizon(windowSeconds) {
+    return windowSeconds * 2 + CLOCK_SKEW_SECONDS;
+}
+/**
+ * Read a reset instant stated as Unix epoch seconds.
+ *
+ * Claude Code states its reset times this way. The value must be a finite
+ * number, must be in seconds rather than milliseconds, must still be in the
+ * future against the supplied clock, because a window that has already reset
+ * says nothing about the window running now, and must be close enough to now to
+ * belong to the window it claims to describe. Nothing is repaired: a value that
+ * fails any of these is null and the caller drops that reading alone.
+ *
+ * `maxAheadSeconds` is the plausibility bound and is optional only so the
+ * helper stays usable for a source with no window length to reason from.
+ */
+export function futureInstantFromEpochSeconds(value, now, maxAheadSeconds) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return null;
+    if (value <= 0 || value >= MAX_EPOCH_SECONDS)
+        return null;
+    const current = Date.parse(now);
+    if (!Number.isFinite(current))
+        return null;
+    const milliseconds = Math.round(value * 1_000);
+    if (milliseconds <= current)
+        return null;
+    if (typeof maxAheadSeconds === "number" &&
+        Number.isFinite(maxAheadSeconds) &&
+        maxAheadSeconds > 0 &&
+        milliseconds > current + maxAheadSeconds * 1_000)
+        return null;
+    const instant = new Date(milliseconds);
+    return Number.isFinite(instant.getTime()) ? instant.toISOString() : null;
+}
+/**
+ * A fraction of a whole, as Google's quota summary states remaining quota.
+ *
+ * Zero and one are both real answers, so the bound is inclusive. A boolean is
+ * refused explicitly: JavaScript will happily do arithmetic on `true`, and a
+ * `remainingFraction` of `true` would otherwise become a usage of zero percent,
+ * which is the most dangerous wrong answer this product can give.
+ */
+export function boundedFraction(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return null;
+    return value >= 0 && value <= 1 ? value : null;
+}
+/**
+ * A whole positive count of seconds, when a provider states a window length.
+ *
+ * Bounded above by a year, because a rolling window longer than that is not a
+ * subscription window, it is a misread field or a different unit.
+ */
+export const MAX_WINDOW_SECONDS = 31_536_000;
+export function windowSeconds(value) {
+    if (typeof value !== "number" || !Number.isInteger(value))
+        return null;
+    return value > 0 && value <= MAX_WINDOW_SECONDS ? value : null;
+}
+/**
+ * Read a reset instant stated as an RFC3339 timestamp.
+ *
+ * Google's quota summary states reset times this way, and the Antigravity
+ * client writes them with SEVEN fractional digits, which `Date.parse` on some
+ * runtimes reads and others do not. The fraction is normalised to three digits
+ * before parsing, which is the one repair made anywhere in this file, and it is
+ * a repair of ENCODING rather than of value: the instant it names is unchanged.
+ * Recorded 2026-08-07 against a real credential and a real response.
+ *
+ * An offsetless stamp is read as UTC explicitly. Both observed sources carry an
+ * offset today, so this is a guard rather than a fix, and it exists because the
+ * alternative is silent: a naive stamp read as local time moves a reset by the
+ * machine's offset instead of failing.
+ */
+export function futureInstantFromRfc3339(value, now, maxAheadSeconds) {
+    if (typeof value !== "string" || value.length > 64)
+        return null;
+    const trimmed = value.trim();
+    /* Three digits is what every runtime agrees on; the rest are dropped, not
+       rounded, because sub millisecond precision on a quota reset is noise. */
+    const normalized = trimmed.replace(/\.(\d{1,9})/u, (_match, digits) => "." + (digits + "000").slice(0, 3));
+    const withZone = /(?:Z|[+-]\d{2}:?\d{2})$/u.test(normalized)
+        ? normalized
+        : normalized + "Z";
+    const parsed = Date.parse(withZone);
+    const current = Date.parse(now);
+    if (!Number.isFinite(parsed) || !Number.isFinite(current))
+        return null;
+    if (parsed <= current)
+        return null;
+    if (typeof maxAheadSeconds === "number" &&
+        Number.isFinite(maxAheadSeconds) &&
+        maxAheadSeconds > 0 &&
+        parsed > current + maxAheadSeconds * 1_000)
+        return null;
+    return new Date(parsed).toISOString();
+}
+/** How many seconds each unit a provider spells out is worth. */
+const DURATION_UNITS = {
+    day: 86_400,
+    hour: 3_600,
+    minute: 60,
+    second: 1
+};
+/**
+ * Seconds from a duration a page spelled out in words, or null.
+ *
+ * OpenCode's workspace page prints "Resets in 5 days 20 hours" rather than a
+ * timestamp, so the only reset available is a countdown rendered for a human.
+ * Only consecutive number and unit pairs are read, and an empty or zero total
+ * is null rather than now: a reset of zero seconds would render as a countdown
+ * that has already finished.
+ */
+export function durationSecondsFromWords(text) {
+    let total = 0;
+    let seen = false;
+    const pattern = /(\d{1,6})\s*(day|hour|minute|second)s?/giu;
+    for (const match of text.matchAll(pattern)) {
+        const count = Number.parseInt(match[1] ?? "", 10);
+        const unit = DURATION_UNITS[(match[2] ?? "").toLowerCase()];
+        if (!Number.isFinite(count) || unit === undefined)
+            return null;
+        total += count * unit;
+        seen = true;
+    }
+    if (!seen || total <= 0 || total > MAX_WINDOW_SECONDS)
+        return null;
+    return total;
+}
+/** An instant this many seconds after the supplied clock, or null. */
+export function instantAfter(now, seconds) {
+    const current = Date.parse(now);
+    if (!Number.isFinite(current))
+        return null;
+    const instant = new Date(current + seconds * 1_000);
+    return Number.isFinite(instant.getTime()) ? instant.toISOString() : null;
+}
 export function shortExpiry(now) {
     const parsed = Date.parse(now);
     return Number.isFinite(parsed) ? new Date(parsed + 60_000).toISOString() : null;

package/dist/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,OAAO,GAAG,GAAG;IACzD,OAAO,OAAO,KAAK,KAAK,QAAQ;QAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACtB,KAAK,IAAI,CAAC;QACV,KAAK,IAAI,OAAO;QAChB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,GAAW;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,GAAG,OAAO;QAC5E,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE;QAChC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAmBxB;IACC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACnC,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;AACjF,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlimiter/connectors",
-  "version": "0.2.0",
+  "version": "1.2.0",
   "description": "Provider connectors that collect quota and usage data for OpenLimiter.",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,7 +19,7 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@openlimiter/core": "0.2.0"
+    "@openlimiter/core": "1.2.0"
   },
   "repository": {
     "type": "git",
@@ -45,7 +45,8 @@
     "node": ">=24"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",