iobroker.ai-usage 0.3.0 → 0.5.0

package/build/lib/http.js

@@ -39,12 +39,12 @@ async function getJson(url, headers) {
     throw new import_provider.FetchError("rate-limit", "HTTP 429");
   }
   if (!response.ok) {
-    throw new import_provider.FetchError("network", `HTTP ${response.status}`);
+    throw new import_provider.FetchError("service", `HTTP ${response.status}`);
   }
   try {
     return await response.json();
   } catch {
-    throw new import_provider.FetchError("network", "invalid JSON response");
+    throw new import_provider.FetchError("service", "invalid JSON response");
   }
 }
 async function postJson(url, body) {
@@ -66,12 +66,12 @@ async function postJson(url, body) {
     throw new import_provider.FetchError("rate-limit", "HTTP 429");
   }
   if (!response.ok) {
-    throw new import_provider.FetchError("network", `HTTP ${response.status}`);
+    throw new import_provider.FetchError("service", `HTTP ${response.status}`);
   }
   try {
     return await response.json();
   } catch {
-    throw new import_provider.FetchError("network", "invalid JSON response");
+    throw new import_provider.FetchError("service", "invalid JSON response");
   }
 }
 async function postForm(url, form, headers = {}) {
@@ -93,12 +93,12 @@ async function postForm(url, form, headers = {}) {
     throw new import_provider.FetchError("rate-limit", "HTTP 429");
   }
   if (!response.ok) {
-    throw new import_provider.FetchError("network", `HTTP ${response.status}`);
+    throw new import_provider.FetchError("service", `HTTP ${response.status}`);
   }
   try {
     return await response.json();
   } catch (e) {
-    throw new import_provider.FetchError("network", `invalid JSON: ${e instanceof Error ? e.message : String(e)}`);
+    throw new import_provider.FetchError("service", `invalid JSON: ${e instanceof Error ? e.message : String(e)}`);
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/build/lib/http.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/http.ts"],
-  "sourcesContent": ["import { FetchError } from \"./provider\";\n\n/** Per-request timeout (ms). */\nconst REQUEST_TIMEOUT_MS = 15000;\n\n/** The JSON-GET seam the provider modules use \u2014 injectable for tests. */\nexport type JsonFetch = (url: string, headers: Record<string, string>) => Promise<unknown>;\n\n/**\n * GET a JSON document with the shared failure classification: 401/403 become an\n * auth error, 429 a rate-limit error, everything else (bad status, network throw,\n * timeout, invalid JSON) a network error \u2014 the classes the poll engine acts on.\n *\n * @param url the request URL\n * @param headers request headers (Authorization etc.)\n * @returns the parsed JSON body\n */\nexport async function getJson(url: string, headers: Record<string, string>): Promise<unknown> {\n  let response: Response;\n  try {\n    response = await fetch(url, { headers, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });\n  } catch (e) {\n    throw new FetchError(\"network\", e instanceof Error ? e.message : String(e));\n  }\n  if (response.status === 401 || response.status === 403) {\n    throw new FetchError(\"auth\", `HTTP ${response.status}`);\n  }\n  if (response.status === 429) {\n    throw new FetchError(\"rate-limit\", \"HTTP 429\");\n  }\n  if (!response.ok) {\n    throw new FetchError(\"network\", `HTTP ${response.status}`);\n  }\n  try {\n    return await response.json();\n  } catch {\n    throw new FetchError(\"network\", \"invalid JSON response\");\n  }\n}\n\n/**\n * POST a JSON document with the same failure classification as {@link getJson}.\n *\n * @param url the request URL\n * @param body the JSON body\n * @returns the parsed JSON response\n */\nexport async function postJson(url: string, body: Record<string, unknown>): Promise<unknown> {\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n    });\n  } catch (e) {\n    throw new FetchError(\"network\", e instanceof Error ? e.message : String(e));\n  }\n  if (response.status === 401 || response.status === 403 || response.status === 400) {\n    throw new FetchError(\"auth\", `HTTP ${response.status}`);\n  }\n  if (response.status === 429) {\n    throw new FetchError(\"rate-limit\", \"HTTP 429\");\n  }\n  if (!response.ok) {\n    throw new FetchError(\"network\", `HTTP ${response.status}`);\n  }\n  try {\n    return await response.json();\n  } catch {\n    throw new FetchError(\"network\", \"invalid JSON response\");\n  }\n}\n\n/**\n * POST a form-encoded body and return the parsed JSON answer.\n *\n * OAuth code redemption uses form encoding while token refresh often uses JSON \u2014\n * ChatGPT/Codex needs BOTH, so the two shapes are separate helpers rather than one\n * guessing wrapper.\n *\n * @param url the request URL\n * @param form the form fields\n * @param headers extra headers\n * @returns the parsed JSON body\n */\nexport async function postForm(\n  url: string,\n  form: Record<string, string>,\n  headers: Record<string, string> = {},\n): Promise<unknown> {\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/x-www-form-urlencoded\", ...headers },\n      body: new URLSearchParams(form).toString(),\n      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n    });\n  } catch (e) {\n    throw new FetchError(\"network\", e instanceof Error ? e.message : String(e));\n  }\n  if (response.status === 400 || response.status === 401 || response.status === 403) {\n    throw new FetchError(\"auth\", `HTTP ${response.status}`);\n  }\n  if (response.status === 429) {\n    throw new FetchError(\"rate-limit\", \"HTTP 429\");\n  }\n  if (!response.ok) {\n    throw new FetchError(\"network\", `HTTP ${response.status}`);\n  }\n  try {\n    return await response.json();\n  } catch (e) {\n    throw new FetchError(\"network\", `invalid JSON: ${e instanceof Error ? e.message : String(e)}`);\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { FetchError } from \"./provider\";\n\n/** Per-request timeout (ms). */\nconst REQUEST_TIMEOUT_MS = 15000;\n\n/** The JSON-GET seam the provider modules use \u2014 injectable for tests. */\nexport type JsonFetch = (url: string, headers: Record<string, string>) => Promise<unknown>;\n\n/**\n * GET a JSON document with the shared failure classification: 401/403 become an\n * auth error, 429 a rate-limit error, any other bad status or unparsable body a\n * SERVICE error (the service answered and is broken), and only a throw \u2014 refused\n * connection, DNS failure, timeout \u2014 a network error. The poll engine turns that\n * split into \"the AI service is down\" versus \"this host has no connection\".\n *\n * @param url the request URL\n * @param headers request headers (Authorization etc.)\n * @returns the parsed JSON body\n */\nexport async function getJson(url: string, headers: Record<string, string>): Promise<unknown> {\n  let response: Response;\n  try {\n    response = await fetch(url, { headers, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });\n  } catch (e) {\n    throw new FetchError(\"network\", e instanceof Error ? e.message : String(e));\n  }\n  if (response.status === 401 || response.status === 403) {\n    throw new FetchError(\"auth\", `HTTP ${response.status}`);\n  }\n  if (response.status === 429) {\n    throw new FetchError(\"rate-limit\", \"HTTP 429\");\n  }\n  if (!response.ok) {\n    // 5xx = the service answered and is broken; anything else unexpected is treated\n    // the same way, because the service DID answer \u2014 only a throw above means we\n    // never reached it.\n    throw new FetchError(\"service\", `HTTP ${response.status}`);\n  }\n  try {\n    return await response.json();\n  } catch {\n    throw new FetchError(\"service\", \"invalid JSON response\");\n  }\n}\n\n/**\n * POST a JSON document with the same failure classification as {@link getJson}.\n *\n * @param url the request URL\n * @param body the JSON body\n * @returns the parsed JSON response\n */\nexport async function postJson(url: string, body: Record<string, unknown>): Promise<unknown> {\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n    });\n  } catch (e) {\n    throw new FetchError(\"network\", e instanceof Error ? e.message : String(e));\n  }\n  if (response.status === 401 || response.status === 403 || response.status === 400) {\n    throw new FetchError(\"auth\", `HTTP ${response.status}`);\n  }\n  if (response.status === 429) {\n    throw new FetchError(\"rate-limit\", \"HTTP 429\");\n  }\n  if (!response.ok) {\n    // 5xx = the service answered and is broken; anything else unexpected is treated\n    // the same way, because the service DID answer \u2014 only a throw above means we\n    // never reached it.\n    throw new FetchError(\"service\", `HTTP ${response.status}`);\n  }\n  try {\n    return await response.json();\n  } catch {\n    throw new FetchError(\"service\", \"invalid JSON response\");\n  }\n}\n\n/**\n * POST a form-encoded body and return the parsed JSON answer.\n *\n * OAuth code redemption uses form encoding while token refresh often uses JSON \u2014\n * ChatGPT/Codex needs BOTH, so the two shapes are separate helpers rather than one\n * guessing wrapper.\n *\n * @param url the request URL\n * @param form the form fields\n * @param headers extra headers\n * @returns the parsed JSON body\n */\nexport async function postForm(\n  url: string,\n  form: Record<string, string>,\n  headers: Record<string, string> = {},\n): Promise<unknown> {\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/x-www-form-urlencoded\", ...headers },\n      body: new URLSearchParams(form).toString(),\n      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n    });\n  } catch (e) {\n    throw new FetchError(\"network\", e instanceof Error ? e.message : String(e));\n  }\n  if (response.status === 400 || response.status === 401 || response.status === 403) {\n    throw new FetchError(\"auth\", `HTTP ${response.status}`);\n  }\n  if (response.status === 429) {\n    throw new FetchError(\"rate-limit\", \"HTTP 429\");\n  }\n  if (!response.ok) {\n    // 5xx = the service answered and is broken; anything else unexpected is treated\n    // the same way, because the service DID answer \u2014 only a throw above means we\n    // never reached it.\n    throw new FetchError(\"service\", `HTTP ${response.status}`);\n  }\n  try {\n    return await response.json();\n  } catch (e) {\n    throw new FetchError(\"service\", `invalid JSON: ${e instanceof Error ? e.message : String(e)}`);\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/build/lib/poll-engine.js

@@ -52,7 +52,11 @@ class PollEngine {
         skipUntil: 0,
         backoffMs: BACKOFF_START_MS,
         authNotified: false,
-        createdObjects: /* @__PURE__ */ new Set()
+        serviceOnline: false,
+        state: "no-connection",
+        error: "waiting for the first query",
+        createdObjects: /* @__PURE__ */ new Set(),
+        written: /* @__PURE__ */ new Map()
       });
     }
   }
@@ -122,6 +126,9 @@ class PollEngine {
       runtime.authNotified = false;
       runtime.status.snapshot = snapshot;
       runtime.status.reachable = true;
+      runtime.serviceOnline = true;
+      runtime.state = "ok";
+      runtime.error = "";
       await this.applySnapshot(runtime, snapshot);
     } catch (e) {
       this.handleFailure(runtime, e);
@@ -149,20 +156,28 @@ class PollEngine {
     for (const write of writes) {
       this.deps.setState(write.id, write.value);
     }
-    const percent = (_a = (0, import_snapshot_tree.maxLimitPercent)(snapshot)) != null ? _a : 0;
+    const driver = (0, import_snapshot_tree.limitingWindow)(snapshot);
+    const percent = (_a = driver == null ? void 0 : driver.percent) != null ? _a : 0;
     const wasWarning = runtime.status.warning;
     runtime.status.warning = percent >= config.warnThreshold;
     this.deps.setState(`${config.id}.warning`, runtime.status.warning);
     this.deps.setState(`${config.id}.limitReached`, percent >= 100);
     if (runtime.status.warning && !wasWarning) {
-      const message = `${config.name}: usage at ${Math.round(percent)} % (threshold ${config.warnThreshold} %)`;
+      const window = driver ? `${driver.label} ` : "";
+      const message = `${config.name}: ${window}at ${Math.round(percent)} % (threshold ${config.warnThreshold} %)`;
       this.deps.log.warn(message);
       (_c = (_b = this.deps).notify) == null ? void 0 : _c.call(_b, config.name, message);
     }
   }
   /**
-   * Classify a fetch failure: auth = unreachable + ONE notification until it recovers;
-   * rate-limit = backoff, last values stay; network = tolerated MAX_NETWORK_FAILURES times.
+   * Classify a fetch failure.
+   *
+   * The split matters for the online indicator: with `auth` and `rate-limit` the AI
+   * service ANSWERED — it is online, it just said no — so only our own access is
+   * broken. `service` means the service answered with a fault of its own and is
+   * reported as down at once (it told us, that is not a flake). A `network` failure
+   * is tolerated MAX_NETWORK_FAILURES times before we call the connection gone, so
+   * a single hiccup does not make the indicator flap.
    *
    * @param runtime the account's runtime
    * @param error the thrown error
@@ -173,6 +188,9 @@ class PollEngine {
     const message = error instanceof Error ? error.message : String(error);
     if (error instanceof import_provider.FetchError && error.kind === "auth") {
       runtime.status.reachable = false;
+      runtime.serviceOnline = true;
+      runtime.state = "unauthorized";
+      runtime.error = `Sign-in rejected \u2014 ${message}`;
       if (!runtime.authNotified) {
         runtime.authNotified = true;
         const text = `${config.name}: credentials rejected \u2014 ${message}`;
@@ -182,6 +200,9 @@ class PollEngine {
       return;
     }
     if (error instanceof import_provider.FetchError && error.kind === "rate-limit") {
+      runtime.serviceOnline = true;
+      runtime.state = "rate-limited";
+      runtime.error = `Throttled by the provider \u2014 retrying in ${Math.round(runtime.backoffMs / 6e4)} min, last values kept`;
       runtime.skipUntil = this.deps.now() + runtime.backoffMs;
       this.deps.log.warn(
         `${config.name}: rate-limited \u2014 backing off for ${Math.round(runtime.backoffMs / 6e4)} min, keeping last values`
@@ -189,24 +210,70 @@ class PollEngine {
       runtime.backoffMs = Math.min(BACKOFF_MAX_MS, runtime.backoffMs * 2);
       return;
     }
+    if (error instanceof import_provider.FetchError && error.kind === "service") {
+      runtime.status.reachable = false;
+      runtime.failCount = 0;
+      if (runtime.serviceOnline) {
+        this.deps.log.warn(`${config.name}: the service reports a fault (${message}) \u2014 values kept`);
+      }
+      runtime.serviceOnline = false;
+      runtime.state = "service-down";
+      runtime.error = `The AI service reports a fault \u2014 ${message}`;
+      return;
+    }
     runtime.failCount++;
     this.deps.log.debug(`${config.name}: fetch failed (${message}), attempt ${runtime.failCount}`);
     if (runtime.failCount >= MAX_NETWORK_FAILURES) {
       runtime.status.reachable = false;
+      if (runtime.serviceOnline) {
+        this.deps.log.warn(`${config.name}: not reachable after ${runtime.failCount} attempts (${message})`);
+      }
+      runtime.serviceOnline = false;
+      runtime.state = "no-connection";
+      runtime.error = `Not reachable after ${runtime.failCount} attempts \u2014 ${message}`;
     }
   }
   /**
-   * Write one account's info states (reachable, last update).
+   * Write one account's info states (data received, service online, state, last update).
    *
    * @param runtime the account's runtime
    */
   writeAccountInfo(runtime) {
     const { config } = runtime;
-    this.deps.setState(`${config.id}.info.reachable`, runtime.status.reachable);
+    this.writeAccountStatus(runtime);
     if (runtime.status.reachable) {
       this.deps.setState(`${config.id}.info.lastUpdate`, new Date(this.deps.now()).toISOString());
     }
   }
+  /**
+   * Write the two status states.
+   *
+   * `unreach` says whether the AI SERVICE answered at all — a rejected sign-in or a
+   * throttle both mean it is up, so those leave the marker off and only fill the
+   * error text. Both are written on change only: an indicator rewritten every cycle
+   * floods the history and hides the real transition.
+   *
+   * @param runtime the account's runtime
+   */
+  writeAccountStatus(runtime) {
+    const { config } = runtime;
+    this.setIfChanged(runtime, `${config.id}.info.unreach`, !runtime.serviceOnline);
+    this.setIfChanged(runtime, `${config.id}.info.error`, runtime.error);
+  }
+  /**
+   * Write a state only when its value actually changed since the last write.
+   *
+   * @param runtime the account's runtime (holds the last-written cache)
+   * @param id the state id
+   * @param value the value
+   */
+  setIfChanged(runtime, id, value) {
+    if (runtime.written.get(id) === value) {
+      return;
+    }
+    runtime.written.set(id, value);
+    this.deps.setState(id, value);
+  }
   /** Recompute and write the totals + info.connection. */
   async writeTotals() {
     const totals = (0, import_totals.computeTotals)(this.runtimes.map((runtime) => runtime.status));
@@ -232,14 +299,27 @@ class PollEngine {
       { id: config.id, type: "device", common: { name: `${config.name} (${config.provider})` } },
       { id: `${config.id}.info`, type: "channel", common: { name: "Info" } },
       {
-        id: `${config.id}.info.provider`,
+        // The two slots ioBroker itself provides for this — measured against
+        // @iobroker/type-detector 6.0.0: `unreach` is the offline marker every
+        // device type carries (`indicator.reachable` is deprecated there), and
+        // `indicator.error` is the standard home for the reason.
+        id: `${config.id}.info.unreach`,
         type: "state",
-        common: { name: "Provider", type: "string", role: "text", read: true, write: false }
+        common: {
+          name: "AI service not reachable",
+          type: "boolean",
+          role: "indicator.maintenance.unreach",
+          read: true,
+          write: false
+        }
       },
       {
-        id: `${config.id}.info.reachable`,
+        // NOT `indicator.error`: the two official sources disagree — the type-detector
+        // lists that role as a String, the repochecker's validity whitelist allows
+        // boolean only (E1009). Validity wins, so the message rides on `text`.
+        id: `${config.id}.info.error`,
         type: "state",
-        common: { name: "Reachable", type: "boolean", role: "indicator.reachable", read: true, write: false }
+        common: { name: "Last error", type: "string", role: "text", read: true, write: false }
       },
       {
         id: `${config.id}.info.lastUpdate`,
@@ -254,15 +334,20 @@ class PollEngine {
       {
         id: `${config.id}.limitReached`,
         type: "state",
-        common: { name: "A limit window is full", type: "boolean", role: "indicator", read: true, write: false }
+        common: {
+          name: "A plan-wide limit window is full",
+          type: "boolean",
+          role: "indicator",
+          read: true,
+          write: false
+        }
       }
     ];
     for (const def of defs) {
       await this.deps.upsertObject(def);
       runtime.createdObjects.add(def.id);
     }
-    this.deps.setState(`${config.id}.info.provider`, config.provider);
-    this.deps.setState(`${config.id}.info.reachable`, false);
+    this.writeAccountStatus(runtime);
   }
   /** The totals skeleton (channel + states). */
   async createTotalsSkeleton() {
@@ -308,7 +393,7 @@ class PollEngine {
         id: "total.maxLimitPercent",
         type: "state",
         common: {
-          name: "Highest limit utilisation of any account",
+          name: "Highest plan-wide utilisation of any account",
           type: "number",
           role: "value",
           read: true,
@@ -330,7 +415,13 @@ class PollEngine {
       {
         id: "total.limitReached",
         type: "state",
-        common: { name: "Any limit window full", type: "boolean", role: "indicator", read: true, write: false }
+        common: {
+          name: "Any plan-wide limit window full",
+          type: "boolean",
+          role: "indicator",
+          read: true,
+          write: false
+        }
       },
       {
         id: "total.accountsReachable",

package/build/lib/poll-engine.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/poll-engine.ts"],
-  "sourcesContent": ["import type { AccountConfig } from \"./pure-helpers\";\nimport { FetchError, type UsageProvider, type UsageSnapshot } from \"./provider\";\nimport { mapSnapshot, maxLimitPercent, type ObjectDef } from \"./snapshot-tree\";\nimport { computeTotals, type AccountStatus } from \"./totals\";\n\n/** Consecutive network failures after which an account is judged unreachable. */\nconst MAX_NETWORK_FAILURES = 3;\n/** First backoff after a rate-limit answer (ms); doubles per repeat. */\nconst BACKOFF_START_MS = 10 * 60 * 1000;\n/** Backoff ceiling (ms). */\nconst BACKOFF_MAX_MS = 60 * 60 * 1000;\n/** Stagger between the accounts' first polls (ms) so they never fire in one burst. */\nconst STAGGER_MS = 3000;\n\n/** The adapter callbacks the engine drives \u2014 narrow, so tests need no adapter mock. */\nexport interface EngineDeps {\n  /** Create or update an object. */\n  upsertObject(def: ObjectDef): Promise<void>;\n  /** Write a state value with ack. */\n  setState(id: string, value: boolean | number | string): void;\n  /** Schedule a repeating callback; returns a cancel handle. */\n  schedule(cb: () => void, ms: number): unknown;\n  /** Schedule a one-shot callback; returns a cancel handle. */\n  scheduleOnce(cb: () => void, ms: number): unknown;\n  /** Cancel a handle from schedule/scheduleOnce. */\n  cancel(handle: unknown): void;\n  /** Current time (ms since epoch) \u2014 injected for tests. */\n  now(): number;\n  /** Adapter log. */\n  log: { debug(m: string): void; info(m: string): void; warn(m: string): void; error(m: string): void };\n  /** Raise a user-facing notification (threshold crossing, broken credentials). */\n  notify?(accountName: string, message: string): void;\n}\n\n/** One account's runtime state inside the engine. */\ninterface AccountRuntime {\n  config: AccountConfig;\n  provider: UsageProvider;\n  status: AccountStatus;\n  /** Consecutive network failures. */\n  failCount: number;\n  /** Skip polls until this time (rate-limit backoff). */\n  skipUntil: number;\n  /** Current backoff length (ms). */\n  backoffMs: number;\n  /** Whether the auth-broken notification has been raised (reset on success). */\n  authNotified: boolean;\n  /** Object ids already created for this account (create-once cache). */\n  createdObjects: Set<string>;\n}\n\n/**\n * Drives the polling of all configured accounts: staggered starts, one independent\n * cycle per account, typed failure handling (auth = immediate + one notification,\n * rate-limit = backoff keeping last values, network = tolerant), warn-threshold\n * transitions and the adapter-wide totals. Pure orchestration \u2014 all IO is injected.\n */\nexport class PollEngine {\n  private readonly runtimes: AccountRuntime[] = [];\n  private readonly handles: unknown[] = [];\n  private stopped = false;\n\n  /**\n   * @param accounts the validated account configs\n   * @param providers each account id's provider (accounts without one are skipped)\n   * @param intervalSec the poll interval in seconds\n   * @param deps the injected adapter callbacks\n   */\n  public constructor(\n    accounts: readonly AccountConfig[],\n    providers: ReadonlyMap<string, UsageProvider>,\n    private readonly intervalSec: number,\n    private readonly deps: EngineDeps,\n  ) {\n    for (const config of accounts) {\n      const provider = providers.get(config.id);\n      if (!provider) {\n        deps.log.warn(`${config.name}: provider \"${config.provider}\" is not available \u2014 account skipped`);\n        continue;\n      }\n      this.runtimes.push({\n        config,\n        provider,\n        status: { reachable: false, warning: false },\n        failCount: 0,\n        skipUntil: 0,\n        backoffMs: BACKOFF_START_MS,\n        authNotified: false,\n        createdObjects: new Set(),\n      });\n    }\n  }\n\n  /** Create the static per-account and totals objects, then arm the poll cycles. */\n  public async start(): Promise<void> {\n    for (const runtime of this.runtimes) {\n      await this.createAccountSkeleton(runtime);\n    }\n    await this.createTotalsSkeleton();\n    await this.writeTotals();\n    this.runtimes.forEach((runtime, index) => {\n      this.handles.push(\n        this.deps.scheduleOnce(() => void this.pollAccount(runtime), index * STAGGER_MS),\n        this.deps.schedule(() => void this.pollAccount(runtime), this.intervalSec * 1000),\n      );\n    });\n  }\n\n  /** Cancel every timer. Synchronous \u2014 safe from onUnload. */\n  public stop(): void {\n    this.stopped = true;\n    for (const handle of this.handles) {\n      this.deps.cancel(handle);\n    }\n    this.handles.length = 0;\n  }\n\n  /** The account ids the engine drives (for the stale-object cleanup). */\n  public get accountIds(): string[] {\n    return this.runtimes.map(runtime => runtime.config.id);\n  }\n\n  /**\n   * Poll one account immediately, by id. Used after a successful sign-in: waiting\n   * up to a full interval there reads as \"the sign-in did not work\".\n   *\n   * @param accountId the account's object id\n   */\n  public async pollNow(accountId: string): Promise<void> {\n    const runtime = this.runtimes.find(entry => entry.config.id === accountId);\n    if (runtime) {\n      // A fresh sign-in clears a previous auth failure and any backoff.\n      runtime.authNotified = false;\n      runtime.skipUntil = 0;\n      await this.pollAccount(runtime);\n    }\n  }\n\n  /**\n   * Poll one account now (also used by the staggered first run).\n   *\n   * @param runtime the account's runtime\n   */\n  private async pollAccount(runtime: AccountRuntime): Promise<void> {\n    if (this.stopped) {\n      return;\n    }\n    const { config } = runtime;\n    if (this.deps.now() < runtime.skipUntil) {\n      this.deps.log.debug(`${config.name}: in rate-limit backoff \u2014 poll skipped`);\n      return;\n    }\n    try {\n      const snapshot = await runtime.provider.fetch();\n      runtime.failCount = 0;\n      runtime.backoffMs = BACKOFF_START_MS;\n      runtime.authNotified = false;\n      runtime.status.snapshot = snapshot;\n      runtime.status.reachable = true;\n      await this.applySnapshot(runtime, snapshot);\n    } catch (e) {\n      this.handleFailure(runtime, e);\n    }\n    this.writeAccountInfo(runtime);\n    await this.writeTotals();\n  }\n\n  /**\n   * Write a successful snapshot: upsert new objects (create-once cache), write the\n   * values, and run the warn-threshold transition.\n   *\n   * @param runtime the account's runtime\n   * @param snapshot the fetched snapshot\n   */\n  private async applySnapshot(runtime: AccountRuntime, snapshot: UsageSnapshot): Promise<void> {\n    const { config } = runtime;\n    const { objects, writes } = mapSnapshot(config.id, config.name, config.provider, snapshot);\n    for (const object of objects) {\n      if (!runtime.createdObjects.has(object.id)) {\n        await this.deps.upsertObject(object);\n        runtime.createdObjects.add(object.id);\n      }\n    }\n    for (const write of writes) {\n      this.deps.setState(write.id, write.value);\n    }\n    const percent = maxLimitPercent(snapshot) ?? 0;\n    const wasWarning = runtime.status.warning;\n    runtime.status.warning = percent >= config.warnThreshold;\n    this.deps.setState(`${config.id}.warning`, runtime.status.warning);\n    this.deps.setState(`${config.id}.limitReached`, percent >= 100);\n    if (runtime.status.warning && !wasWarning) {\n      const message = `${config.name}: usage at ${Math.round(percent)} % (threshold ${config.warnThreshold} %)`;\n      this.deps.log.warn(message);\n      this.deps.notify?.(config.name, message);\n    }\n  }\n\n  /**\n   * Classify a fetch failure: auth = unreachable + ONE notification until it recovers;\n   * rate-limit = backoff, last values stay; network = tolerated MAX_NETWORK_FAILURES times.\n   *\n   * @param runtime the account's runtime\n   * @param error the thrown error\n   */\n  private handleFailure(runtime: AccountRuntime, error: unknown): void {\n    const { config } = runtime;\n    const message = error instanceof Error ? error.message : String(error);\n    if (error instanceof FetchError && error.kind === \"auth\") {\n      runtime.status.reachable = false;\n      if (!runtime.authNotified) {\n        runtime.authNotified = true;\n        const text = `${config.name}: credentials rejected \u2014 ${message}`;\n        this.deps.log.warn(text);\n        this.deps.notify?.(config.name, text);\n      }\n      return;\n    }\n    if (error instanceof FetchError && error.kind === \"rate-limit\") {\n      runtime.skipUntil = this.deps.now() + runtime.backoffMs;\n      this.deps.log.warn(\n        `${config.name}: rate-limited \u2014 backing off for ${Math.round(runtime.backoffMs / 60000)} min, keeping last values`,\n      );\n      runtime.backoffMs = Math.min(BACKOFF_MAX_MS, runtime.backoffMs * 2);\n      return;\n    }\n    runtime.failCount++;\n    this.deps.log.debug(`${config.name}: fetch failed (${message}), attempt ${runtime.failCount}`);\n    if (runtime.failCount >= MAX_NETWORK_FAILURES) {\n      runtime.status.reachable = false;\n    }\n  }\n\n  /**\n   * Write one account's info states (reachable, last update).\n   *\n   * @param runtime the account's runtime\n   */\n  private writeAccountInfo(runtime: AccountRuntime): void {\n    const { config } = runtime;\n    this.deps.setState(`${config.id}.info.reachable`, runtime.status.reachable);\n    if (runtime.status.reachable) {\n      this.deps.setState(`${config.id}.info.lastUpdate`, new Date(this.deps.now()).toISOString());\n    }\n  }\n\n  /** Recompute and write the totals + info.connection. */\n  private async writeTotals(): Promise<void> {\n    const totals = computeTotals(this.runtimes.map(runtime => runtime.status));\n    this.deps.setState(\"total.costs.today\", totals.costsToday);\n    this.deps.setState(\"total.costs.month\", totals.costsMonth);\n    this.deps.setState(\"total.costs.projectedMonth\", totals.costsProjectedMonth);\n    this.deps.setState(\"total.maxLimitPercent\", totals.maxLimitPercent);\n    this.deps.setState(\"total.warningsActive\", totals.warningsActive);\n    this.deps.setState(\"total.limitReached\", totals.limitReached);\n    this.deps.setState(\"total.accountsReachable\", totals.accountsReachable);\n    this.deps.setState(\"total.accounts\", totals.accounts);\n    this.deps.setState(\"info.connection\", totals.accountsReachable > 0);\n    return Promise.resolve();\n  }\n\n  /**\n   * The static per-account objects that exist regardless of what the source delivers.\n   *\n   * @param runtime the account's runtime\n   */\n  private async createAccountSkeleton(runtime: AccountRuntime): Promise<void> {\n    const { config } = runtime;\n    const defs: ObjectDef[] = [\n      { id: config.id, type: \"device\", common: { name: `${config.name} (${config.provider})` } },\n      { id: `${config.id}.info`, type: \"channel\", common: { name: \"Info\" } },\n      {\n        id: `${config.id}.info.provider`,\n        type: \"state\",\n        common: { name: \"Provider\", type: \"string\", role: \"text\", read: true, write: false },\n      },\n      {\n        id: `${config.id}.info.reachable`,\n        type: \"state\",\n        common: { name: \"Reachable\", type: \"boolean\", role: \"indicator.reachable\", read: true, write: false },\n      },\n      {\n        id: `${config.id}.info.lastUpdate`,\n        type: \"state\",\n        common: { name: \"Last successful update\", type: \"string\", role: \"date\", read: true, write: false },\n      },\n      {\n        id: `${config.id}.warning`,\n        type: \"state\",\n        common: { name: \"Above warn threshold\", type: \"boolean\", role: \"indicator\", read: true, write: false },\n      },\n      {\n        id: `${config.id}.limitReached`,\n        type: \"state\",\n        common: { name: \"A limit window is full\", type: \"boolean\", role: \"indicator\", read: true, write: false },\n      },\n    ];\n    for (const def of defs) {\n      await this.deps.upsertObject(def);\n      runtime.createdObjects.add(def.id);\n    }\n    this.deps.setState(`${config.id}.info.provider`, config.provider);\n    this.deps.setState(`${config.id}.info.reachable`, false);\n  }\n\n  /** The totals skeleton (channel + states). */\n  private async createTotalsSkeleton(): Promise<void> {\n    const defs: ObjectDef[] = [\n      { id: \"total.costs\", type: \"channel\", common: { name: \"Costs (USD accounts)\" } },\n      {\n        id: \"total.costs.today\",\n        type: \"state\",\n        common: {\n          name: \"Costs today (all accounts)\",\n          type: \"number\",\n          role: \"value\",\n          read: true,\n          write: false,\n          unit: \"USD\",\n        },\n      },\n      {\n        id: \"total.costs.month\",\n        type: \"state\",\n        common: {\n          name: \"Costs this month (all accounts)\",\n          type: \"number\",\n          role: \"value\",\n          read: true,\n          write: false,\n          unit: \"USD\",\n        },\n      },\n      {\n        id: \"total.costs.projectedMonth\",\n        type: \"state\",\n        common: {\n          name: \"Costs projected month-end (computed)\",\n          type: \"number\",\n          role: \"value\",\n          read: true,\n          write: false,\n          unit: \"USD\",\n        },\n      },\n      {\n        id: \"total.maxLimitPercent\",\n        type: \"state\",\n        common: {\n          name: \"Highest limit utilisation of any account\",\n          type: \"number\",\n          role: \"value\",\n          read: true,\n          write: false,\n          unit: \"%\",\n        },\n      },\n      {\n        id: \"total.warningsActive\",\n        type: \"state\",\n        common: {\n          name: \"Accounts above their warn threshold\",\n          type: \"number\",\n          role: \"value\",\n          read: true,\n          write: false,\n        },\n      },\n      {\n        id: \"total.limitReached\",\n        type: \"state\",\n        common: { name: \"Any limit window full\", type: \"boolean\", role: \"indicator\", read: true, write: false },\n      },\n      {\n        id: \"total.accountsReachable\",\n        type: \"state\",\n        common: { name: \"Reachable accounts\", type: \"number\", role: \"value\", read: true, write: false },\n      },\n      {\n        id: \"total.accounts\",\n        type: \"state\",\n        common: { name: \"Configured accounts\", type: \"number\", role: \"value\", read: true, write: false },\n      },\n    ];\n    for (const def of defs) {\n      await this.deps.upsertObject(def);\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { AccountConfig } from \"./pure-helpers\";\nimport { FetchError, type UsageProvider, type UsageSnapshot } from \"./provider\";\nimport { limitingWindow, mapSnapshot, type ObjectDef } from \"./snapshot-tree\";\nimport { computeTotals, type AccountStatus } from \"./totals\";\n\n/**\n * What the adapter currently knows about one account, in one word.\n *\n * `ok` and `rate-limited` mean the AI service is up and talking to us,\n * `unauthorized` means it is up but rejects our sign-in, `service-down` means the\n * service itself answered with a fault, `no-connection` means we never reached it.\n */\nexport type AccountState = \"ok\" | \"unauthorized\" | \"rate-limited\" | \"service-down\" | \"no-connection\";\n\n/** Consecutive network failures after which an account is judged unreachable. */\nconst MAX_NETWORK_FAILURES = 3;\n/** First backoff after a rate-limit answer (ms); doubles per repeat. */\nconst BACKOFF_START_MS = 10 * 60 * 1000;\n/** Backoff ceiling (ms). */\nconst BACKOFF_MAX_MS = 60 * 60 * 1000;\n/** Stagger between the accounts' first polls (ms) so they never fire in one burst. */\nconst STAGGER_MS = 3000;\n\n/** The adapter callbacks the engine drives \u2014 narrow, so tests need no adapter mock. */\nexport interface EngineDeps {\n  /** Create or update an object. */\n  upsertObject(def: ObjectDef): Promise<void>;\n  /** Write a state value with ack. */\n  setState(id: string, value: boolean | number | string): void;\n  /** Schedule a repeating callback; returns a cancel handle. */\n  schedule(cb: () => void, ms: number): unknown;\n  /** Schedule a one-shot callback; returns a cancel handle. */\n  scheduleOnce(cb: () => void, ms: number): unknown;\n  /** Cancel a handle from schedule/scheduleOnce. */\n  cancel(handle: unknown): void;\n  /** Current time (ms since epoch) \u2014 injected for tests. */\n  now(): number;\n  /** Adapter log. */\n  log: { debug(m: string): void; info(m: string): void; warn(m: string): void; error(m: string): void };\n  /** Raise a user-facing notification (threshold crossing, broken credentials). */\n  notify?(accountName: string, message: string): void;\n}\n\n/** One account's runtime state inside the engine. */\ninterface AccountRuntime {\n  config: AccountConfig;\n  provider: UsageProvider;\n  status: AccountStatus;\n  /** Consecutive network failures. */\n  failCount: number;\n  /** Skip polls until this time (rate-limit backoff). */\n  skipUntil: number;\n  /** Current backoff length (ms). */\n  backoffMs: number;\n  /** Whether the auth-broken notification has been raised (reset on success). */\n  authNotified: boolean;\n  /** Whether the AI service itself answered on the last attempt. */\n  serviceOnline: boolean;\n  /** The account's one-word state. */\n  state: AccountState;\n  /** Plain-text reason shown in `info.error`; empty while everything works. */\n  error: string;\n  /** Object ids already created for this account (create-once cache). */\n  createdObjects: Set<string>;\n  /** Last written value per state id \u2014 keeps unchanged values out of the history. */\n  written: Map<string, boolean | number | string>;\n}\n\n/**\n * Drives the polling of all configured accounts: staggered starts, one independent\n * cycle per account, typed failure handling (auth = immediate + one notification,\n * rate-limit = backoff keeping last values, service = reported down at once,\n * network = tolerated three times), warn-threshold transitions on the PLAN-WIDE\n * windows only, and the adapter-wide totals. Pure orchestration \u2014 all IO is injected.\n */\nexport class PollEngine {\n  private readonly runtimes: AccountRuntime[] = [];\n  private readonly handles: unknown[] = [];\n  private stopped = false;\n\n  /**\n   * @param accounts the validated account configs\n   * @param providers each account id's provider (accounts without one are skipped)\n   * @param intervalSec the poll interval in seconds\n   * @param deps the injected adapter callbacks\n   */\n  public constructor(\n    accounts: readonly AccountConfig[],\n    providers: ReadonlyMap<string, UsageProvider>,\n    private readonly intervalSec: number,\n    private readonly deps: EngineDeps,\n  ) {\n    for (const config of accounts) {\n      const provider = providers.get(config.id);\n      if (!provider) {\n        deps.log.warn(`${config.name}: provider \"${config.provider}\" is not available \u2014 account skipped`);\n        continue;\n      }\n      this.runtimes.push({\n        config,\n        provider,\n        status: { reachable: false, warning: false },\n        failCount: 0,\n        skipUntil: 0,\n        backoffMs: BACKOFF_START_MS,\n        authNotified: false,\n        serviceOnline: false,\n        state: \"no-connection\",\n        error: \"waiting for the first query\",\n        createdObjects: new Set(),\n        written: new Map(),\n      });\n    }\n  }\n\n  /** Create the static per-account and totals objects, then arm the poll cycles. */\n  public async start(): Promise<void> {\n    for (const runtime of this.runtimes) {\n      await this.createAccountSkeleton(runtime);\n    }\n    await this.createTotalsSkeleton();\n    await this.writeTotals();\n    this.runtimes.forEach((runtime, index) => {\n      this.handles.push(\n        this.deps.scheduleOnce(() => void this.pollAccount(runtime), index * STAGGER_MS),\n        this.deps.schedule(() => void this.pollAccount(runtime), this.intervalSec * 1000),\n      );\n    });\n  }\n\n  /** Cancel every timer. Synchronous \u2014 safe from onUnload. */\n  public stop(): void {\n    this.stopped = true;\n    for (const handle of this.handles) {\n      this.deps.cancel(handle);\n    }\n    this.handles.length = 0;\n  }\n\n  /** The account ids the engine drives (for the stale-object cleanup). */\n  public get accountIds(): string[] {\n    return this.runtimes.map(runtime => runtime.config.id);\n  }\n\n  /**\n   * Poll one account immediately, by id. Used after a successful sign-in: waiting\n   * up to a full interval there reads as \"the sign-in did not work\".\n   *\n   * @param accountId the account's object id\n   */\n  public async pollNow(accountId: string): Promise<void> {\n    const runtime = this.runtimes.find(entry => entry.config.id === accountId);\n    if (runtime) {\n      // A fresh sign-in clears a previous auth failure and any backoff.\n      runtime.authNotified = false;\n      runtime.skipUntil = 0;\n      await this.pollAccount(runtime);\n    }\n  }\n\n  /**\n   * Poll one account now (also used by the staggered first run).\n   *\n   * @param runtime the account's runtime\n   */\n  private async pollAccount(runtime: AccountRuntime): Promise<void> {\n    if (this.stopped) {\n      return;\n    }\n    const { config } = runtime;\n    if (this.deps.now() < runtime.skipUntil) {\n      this.deps.log.debug(`${config.name}: in rate-limit backoff \u2014 poll skipped`);\n      return;\n    }\n    try {\n      const snapshot = await runtime.provider.fetch();\n      runtime.failCount = 0;\n      runtime.backoffMs = BACKOFF_START_MS;\n      runtime.authNotified = false;\n      runtime.status.snapshot = snapshot;\n      runtime.status.reachable = true;\n      runtime.serviceOnline = true;\n      runtime.state = \"ok\";\n      runtime.error = \"\";\n      await this.applySnapshot(runtime, snapshot);\n    } catch (e) {\n      this.handleFailure(runtime, e);\n    }\n    this.writeAccountInfo(runtime);\n    await this.writeTotals();\n  }\n\n  /**\n   * Write a successful snapshot: upsert new objects (create-once cache), write the\n   * values, and run the warn-threshold transition.\n   *\n   * @param runtime the account's runtime\n   * @param snapshot the fetched snapshot\n   */\n  private async applySnapshot(runtime: AccountRuntime, snapshot: UsageSnapshot): Promise<void> {\n    const { config } = runtime;\n    const { objects, writes } = mapSnapshot(config.id, config.name, config.provider, snapshot);\n    for (const object of objects) {\n      if (!runtime.createdObjects.has(object.id)) {\n        await this.deps.upsertObject(object);\n        runtime.createdObjects.add(object.id);\n      }\n    }\n    for (const write of writes) {\n      this.deps.setState(write.id, write.value);\n    }\n    // Only PLAN-WIDE windows speak for the account \u2014 a per-model bucket at 100 %\n    // must not read as \"this AI is full\" (krobi 2026-08-26).\n    const driver = limitingWindow(snapshot);\n    const percent = driver?.percent ?? 0;\n    const wasWarning = runtime.status.warning;\n    runtime.status.warning = percent >= config.warnThreshold;\n    this.deps.setState(`${config.id}.warning`, runtime.status.warning);\n    this.deps.setState(`${config.id}.limitReached`, percent >= 100);\n    if (runtime.status.warning && !wasWarning) {\n      // Always name the window: \"usage at 100 %\" without it was misleading whenever\n      // several windows existed.\n      const window = driver ? `${driver.label} ` : \"\";\n      const message = `${config.name}: ${window}at ${Math.round(percent)} % (threshold ${config.warnThreshold} %)`;\n      this.deps.log.warn(message);\n      this.deps.notify?.(config.name, message);\n    }\n  }\n\n  /**\n   * Classify a fetch failure.\n   *\n   * The split matters for the online indicator: with `auth` and `rate-limit` the AI\n   * service ANSWERED \u2014 it is online, it just said no \u2014 so only our own access is\n   * broken. `service` means the service answered with a fault of its own and is\n   * reported as down at once (it told us, that is not a flake). A `network` failure\n   * is tolerated MAX_NETWORK_FAILURES times before we call the connection gone, so\n   * a single hiccup does not make the indicator flap.\n   *\n   * @param runtime the account's runtime\n   * @param error the thrown error\n   */\n  private handleFailure(runtime: AccountRuntime, error: unknown): void {\n    const { config } = runtime;\n    const message = error instanceof Error ? error.message : String(error);\n    if (error instanceof FetchError && error.kind === \"auth\") {\n      runtime.status.reachable = false;\n      runtime.serviceOnline = true;\n      runtime.state = \"unauthorized\";\n      runtime.error = `Sign-in rejected \u2014 ${message}`;\n      if (!runtime.authNotified) {\n        runtime.authNotified = true;\n        const text = `${config.name}: credentials rejected \u2014 ${message}`;\n        this.deps.log.warn(text);\n        this.deps.notify?.(config.name, text);\n      }\n      return;\n    }\n    if (error instanceof FetchError && error.kind === \"rate-limit\") {\n      runtime.serviceOnline = true;\n      runtime.state = \"rate-limited\";\n      runtime.error = `Throttled by the provider \u2014 retrying in ${Math.round(runtime.backoffMs / 60000)} min, last values kept`;\n      runtime.skipUntil = this.deps.now() + runtime.backoffMs;\n      this.deps.log.warn(\n        `${config.name}: rate-limited \u2014 backing off for ${Math.round(runtime.backoffMs / 60000)} min, keeping last values`,\n      );\n      runtime.backoffMs = Math.min(BACKOFF_MAX_MS, runtime.backoffMs * 2);\n      return;\n    }\n    if (error instanceof FetchError && error.kind === \"service\") {\n      runtime.status.reachable = false;\n      runtime.failCount = 0;\n      if (runtime.serviceOnline) {\n        this.deps.log.warn(`${config.name}: the service reports a fault (${message}) \u2014 values kept`);\n      }\n      runtime.serviceOnline = false;\n      runtime.state = \"service-down\";\n      runtime.error = `The AI service reports a fault \u2014 ${message}`;\n      return;\n    }\n    runtime.failCount++;\n    this.deps.log.debug(`${config.name}: fetch failed (${message}), attempt ${runtime.failCount}`);\n    if (runtime.failCount >= MAX_NETWORK_FAILURES) {\n      runtime.status.reachable = false;\n      if (runtime.serviceOnline) {\n        this.deps.log.warn(`${config.name}: not reachable after ${runtime.failCount} attempts (${message})`);\n      }\n      runtime.serviceOnline = false;\n      runtime.state = \"no-connection\";\n      runtime.error = `Not reachable after ${runtime.failCount} attempts \u2014 ${message}`;\n    }\n  }\n\n  /**\n   * Write one account's info states (data received, service online, state, last update).\n   *\n   * @param runtime the account's runtime\n   */\n  private writeAccountInfo(runtime: AccountRuntime): void {\n    const { config } = runtime;\n    this.writeAccountStatus(runtime);\n    if (runtime.status.reachable) {\n      this.deps.setState(`${config.id}.info.lastUpdate`, new Date(this.deps.now()).toISOString());\n    }\n  }\n\n  /**\n   * Write the two status states.\n   *\n   * `unreach` says whether the AI SERVICE answered at all \u2014 a rejected sign-in or a\n   * throttle both mean it is up, so those leave the marker off and only fill the\n   * error text. Both are written on change only: an indicator rewritten every cycle\n   * floods the history and hides the real transition.\n   *\n   * @param runtime the account's runtime\n   */\n  private writeAccountStatus(runtime: AccountRuntime): void {\n    const { config } = runtime;\n    this.setIfChanged(runtime, `${config.id}.info.unreach`, !runtime.serviceOnline);\n    this.setIfChanged(runtime, `${config.id}.info.error`, runtime.error);\n  }\n\n  /**\n   * Write a state only when its value actually changed since the last write.\n   *\n   * @param runtime the account's runtime (holds the last-written cache)\n   * @param id the state id\n   * @param value the value\n   */\n  private setIfChanged(runtime: AccountRuntime, id: string, value: boolean | number | string): void {\n    if (runtime.written.get(id) === value) {\n      return;\n    }\n    runtime.written.set(id, value);\n    this.deps.setState(id, value);\n  }\n\n  /** Recompute and write the totals + info.connection. */\n  private async writeTotals(): Promise<void> {\n    const totals = computeTotals(this.runtimes.map(runtime => runtime.status));\n    this.deps.setState(\"total.costs.today\", totals.costsToday);\n    this.deps.setState(\"total.costs.month\", totals.costsMonth);\n    this.deps.setState(\"total.costs.projectedMonth\", totals.costsProjectedMonth);\n    this.deps.setState(\"total.maxLimitPercent\", totals.maxLimitPercent);\n    this.deps.setState(\"total.warningsActive\", totals.warningsActive);\n    this.deps.setState(\"total.limitReached\", totals.limitReached);\n    this.deps.setState(\"total.accountsReachable\", totals.accountsReachable);\n    this.deps.setState(\"total.accounts\", totals.accounts);\n    this.deps.setState(\"info.connection\", totals.accountsReachable > 0);\n    return Promise.resolve();\n  }\n\n  /**\n   * The static per-account objects that exist regardless of what the source delivers.\n   *\n   * @param runtime the account's runtime\n   */\n  private async createAccountSkeleton(runtime: AccountRuntime): Promise<void> {\n    const { config } = runtime;\n    const defs: ObjectDef[] = [\n      { id: config.id, type: \"device\", common: { name: `${config.name} (${config.provider})` } },\n      { id: `${config.id}.info`, type: \"channel\", common: { name: \"Info\" } },\n      {\n        // The two slots ioBroker itself provides for this \u2014 measured against\n        // @iobroker/type-detector 6.0.0: `unreach` is the offline marker every\n        // device type carries (`indicator.reachable` is deprecated there), and\n        // `indicator.error` is the standard home for the reason.\n        id: `${config.id}.info.unreach`,\n        type: \"state\",\n        common: {\n          name: \"AI service not reachable\",\n          type: \"boolean\",\n          role: \"indicator.maintenance.unreach\",\n          read: true,\n          write: false,\n        },\n      },\n      {\n        // NOT `indicator.error`: the two official sources disagree \u2014 the type-detector\n        // lists that role as a String, the repochecker's validity whitelist allows\n        // boolean only (E1009). Validity wins, so the message rides on `text`.\n        id: `${config.id}.info.error`,\n        type: \"state\",\n        common: { name: \"Last error\", type: \"string\", role: \"text\", read: true, write: false },\n      },\n      {\n        id: `${config.id}.info.lastUpdate`,\n        type: \"state\",\n        common: { name: \"Last successful update\", type: \"string\", role: \"date\", read: true, write: false },\n      },\n      {\n        id: `${config.id}.warning`,\n        type: \"state\",\n        common: { name: \"Above warn threshold\", type: \"boolean\", role: \"indicator\", read: true, write: false },\n      },\n      {\n        id: `${config.id}.limitReached`,\n        type: \"state\",\n        common: {\n          name: \"A plan-wide limit window is full\",\n          type: \"boolean\",\n          role: \"indicator\",\n          read: true,\n          write: false,\n        },\n      },\n    ];\n    for (const def of defs) {\n      await this.deps.upsertObject(def);\n      runtime.createdObjects.add(def.id);\n    }\n    this.writeAccountStatus(runtime);\n  }\n\n  /** The totals skeleton (channel + states). */\n  private async createTotalsSkeleton(): Promise<void> {\n    const defs: ObjectDef[] = [\n      { id: \"total.costs\", type: \"channel\", common: { name: \"Costs (USD accounts)\" } },\n      {\n        id: \"total.costs.today\",\n        type: \"state\",\n        common: {\n          name: \"Costs today (all accounts)\",\n          type: \"number\",\n          role: \"value\",\n          read: true,\n          write: false,\n          unit: \"USD\",\n        },\n      },\n      {\n        id: \"total.costs.month\",\n        type: \"state\",\n        common: {\n          name: \"Costs this month (all accounts)\",\n          type: \"number\",\n          role: \"value\",\n          read: true,\n          write: false,\n          unit: \"USD\",\n        },\n      },\n      {\n        id: \"total.costs.projectedMonth\",\n        type: \"state\",\n        common: {\n          name: \"Costs projected month-end (computed)\",\n          type: \"number\",\n          role: \"value\",\n          read: true,\n          write: false,\n          unit: \"USD\",\n        },\n      },\n      {\n        id: \"total.maxLimitPercent\",\n        type: \"state\",\n        common: {\n          name: \"Highest plan-wide utilisation of any account\",\n          type: \"number\",\n          role: \"value\",\n          read: true,\n          write: false,\n          unit: \"%\",\n        },\n      },\n      {\n        id: \"total.warningsActive\",\n        type: \"state\",\n        common: {\n          name: \"Accounts above their warn threshold\",\n          type: \"number\",\n          role: \"value\",\n          read: true,\n          write: false,\n        },\n      },\n      {\n        id: \"total.limitReached\",\n        type: \"state\",\n        common: {\n          name: \"Any plan-wide limit window full\",\n          type: \"boolean\",\n          role: \"indicator\",\n          read: true,\n          write: false,\n        },\n      },\n      {\n        id: \"total.accountsReachable\",\n        type: \"state\",\n        common: { name: \"Reachable accounts\", type: \"number\", role: \"value\", read: true, write: false },\n      },\n      {\n        id: \"total.accounts\",\n        type: \"state\",\n        common: { name: \"Configured accounts\", type: \"number\", role: \"value\", read: true, write: false },\n      },\n    ];\n    for (const def of defs) {\n      await this.deps.upsertObject(def);\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/build/lib/provider.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/provider.ts"],
-  "sourcesContent": ["/** The provider kinds the adapter speaks. */\nexport type ProviderKind =\n  \"claude-sub\" | \"chatgpt-sub\" | \"gemini-sub\" | \"openrouter\" | \"deepseek\" | \"openai\" | \"anthropic-api\";\n\n/**\n * How a subscription account is signed in. Each provider dictates its own flow \u2014\n * the admin panel renders the matching instructions, the adapter drives the rest.\n *\n * - `paste-code`: the user opens a link, signs in and pastes the code shown there (Claude).\n * - `device-code`: the adapter shows a short code the user types on the provider's page,\n *   then polls until the user confirmed (ChatGPT/Codex).\n * - `paste-url`: the user opens a link, signs in and lands on a browser error page whose\n *   ADDRESS carries the code \u2014 the whole address is pasted back (Gemini, the only redirect\n *   Google accepts for the usable client; measured 2026-08-26).\n */\nexport type SignInFlow = \"paste-code\" | \"device-code\" | \"paste-url\";\n\n/** One limit window (session, week, per-model) \u2014 the same shape for every provider. */\nexport interface LimitWindow {\n  /** Window name; becomes the object id segment (session, week, a model name, month). */\n  name: string;\n  /** Human-readable label for the object name. */\n  label: string;\n  /** Utilisation in percent (0-100+). */\n  percent: number;\n  /** When the window resets (ISO timestamp), if the source reports it. */\n  resetAt?: string;\n}\n\n/** Granted budget (prepaid money or request credits). */\nexport interface CreditInfo {\n  /** Used amount. */\n  used?: number;\n  /** Granted ceiling; undefined = unlimited/unknown. */\n  limit?: number;\n  /** Remaining amount. */\n  remaining?: number;\n  /** Utilisation in percent, when both used and limit are known. */\n  percent?: number;\n  /** Granted (gifted) part of the balance, where the source distinguishes it (DeepSeek). */\n  granted?: number;\n  /** Topped-up (paid) part of the balance. */\n  toppedUp?: number;\n  /** Currency code (\"USD\", \"CNY\") \u2014 or a unit word for piece-counters. */\n  currency: string;\n  /** True when the credits are pieces (requests), not money \u2014 excluded from cost totals. */\n  pieces?: boolean;\n}\n\n/** Real money spent. */\nexport interface CostInfo {\n  /** Spent today. */\n  today?: number;\n  /** Spent this month (or billing period). */\n  month?: number;\n  /** Lifetime counter, where the source only reports that. */\n  total?: number;\n  /** Projected month-end spend (computed by the provider module, marked in the object name). */\n  projectedMonth?: number;\n  /** Currency code. */\n  currency: string;\n}\n\n/** Token counters (API accounts). */\nexport interface TokenInfo {\n  /** Input tokens today. */\n  inputToday?: number;\n  /** Output tokens today. */\n  outputToday?: number;\n  /** Per-model breakdown. */\n  perModel?: { model: string; tokens?: number; cost?: number }[];\n}\n\n/**\n * A transport-neutral usage snapshot \u2014 one fetch result. Only what the source\n * actually delivered is present; the tree builder creates nothing for absent parts.\n */\nexport interface UsageSnapshot {\n  /** Limit windows (subscription accounts). */\n  limits?: LimitWindow[];\n  /** Granted budget. */\n  credits?: CreditInfo;\n  /** Real money spent. */\n  costs?: CostInfo;\n  /** Token counters. */\n  tokens?: TokenInfo;\n  /** Provider-specific extra flags (e.g. DeepSeek `available`). */\n  available?: boolean;\n}\n\n/** Why a fetch failed \u2014 drives reachability, backoff and notifications. */\nexport type FetchErrorKind = \"auth\" | \"rate-limit\" | \"network\";\n\n/** A typed fetch failure. */\nexport class FetchError extends Error {\n  /**\n   * @param kind the failure class\n   * @param message the human-readable reason\n   */\n  public constructor(\n    public readonly kind: FetchErrorKind,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"FetchError\";\n  }\n}\n\n/** One account's usage source. Implementations are pure fetch+parse \u2014 no ioBroker inside. */\nexport interface UsageProvider {\n  /** Which provider this is. */\n  readonly kind: ProviderKind;\n  /** Fetch the current snapshot; throws {@link FetchError} on failure. */\n  fetch(): Promise<UsageSnapshot>;\n}\n\n/** Persisted OAuth tokens of one subscription account. */\nexport interface TokenSet {\n  /** The bearer token used for the usage call. */\n  accessToken: string;\n  /** The token used to obtain a fresh access token. */\n  refreshToken: string;\n  /** Absolute expiry of {@link accessToken} in ms since epoch. */\n  expiresAt: number;\n  /** Provider-specific extra the usage call needs (e.g. ChatGPT account id). */\n  accountRef?: string;\n}\n\n/** Where a subscription's tokens live. Keyed by PROVIDER, never by account name. */\nexport interface TokenStore {\n  /** Read the stored tokens, or null when never signed in. */\n  load(): Promise<TokenSet | null>;\n  /** Persist tokens (encrypted by the adapter). */\n  save(tokens: TokenSet): Promise<void>;\n  /** Forget the tokens (sign out / unusable refresh token). */\n  clear(): Promise<void>;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA8FO,MAAM,mBAAmB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,EAK7B,YACW,MAChB,SACA;AACA,UAAM,OAAO;AAHG;AAIhB,SAAK,OAAO;AAAA,EACd;AAAA,EALkB;AAMpB;",
+  "sourcesContent": ["/** The provider kinds the adapter speaks. */\nexport type ProviderKind =\n  \"claude-sub\" | \"chatgpt-sub\" | \"gemini-sub\" | \"openrouter\" | \"deepseek\" | \"openai\" | \"anthropic-api\";\n\n/**\n * How a subscription account is signed in. Each provider dictates its own flow \u2014\n * the admin panel renders the matching instructions, the adapter drives the rest.\n *\n * - `paste-code`: the user opens a link, signs in and pastes the code shown there (Claude).\n * - `device-code`: the adapter shows a short code the user types on the provider's page,\n *   then polls until the user confirmed (ChatGPT/Codex).\n * - `paste-url`: the user opens a link, signs in and lands on a browser error page whose\n *   ADDRESS carries the code \u2014 the whole address is pasted back (Gemini, the only redirect\n *   Google accepts for the usable client; measured 2026-08-26).\n */\nexport type SignInFlow = \"paste-code\" | \"device-code\" | \"paste-url\";\n\n/** One limit window (session, week, per-model) \u2014 the same shape for every provider. */\nexport interface LimitWindow {\n  /** Window name; becomes the object id segment (session, week, a model name, month). */\n  name: string;\n  /** Human-readable label for the object name. */\n  label: string;\n  /** Utilisation in percent (0-100+). */\n  percent: number;\n  /** When the window resets (ISO timestamp), if the source reports it. */\n  resetAt?: string;\n  /**\n   * True when this window covers only a PART of the plan \u2014 a single model or\n   * surface that sits next to a plan-wide window of the same period.\n   *\n   * Such a bucket is reported as its own datapoint but never drives the account's\n   * warning: a model the user does not use can sit at 100 % forever, and a counter\n   * that never falls is worse than no counter (krobi 2026-08-26: \"das betrifft nur\n   * Fable, nicht allgemein\"). Providers whose ONLY buckets are per-model (Google)\n   * leave this unset \u2014 there the model buckets are the plan.\n   */\n  scoped?: boolean;\n}\n\n/** Granted budget (prepaid money or request credits). */\nexport interface CreditInfo {\n  /** Used amount. */\n  used?: number;\n  /** Granted ceiling; undefined = unlimited/unknown. */\n  limit?: number;\n  /** Remaining amount. */\n  remaining?: number;\n  /** Utilisation in percent, when both used and limit are known. */\n  percent?: number;\n  /** Granted (gifted) part of the balance, where the source distinguishes it (DeepSeek). */\n  granted?: number;\n  /** Topped-up (paid) part of the balance. */\n  toppedUp?: number;\n  /** Currency code (\"USD\", \"CNY\") \u2014 or a unit word for piece-counters. */\n  currency: string;\n  /** True when the credits are pieces (requests), not money \u2014 excluded from cost totals. */\n  pieces?: boolean;\n}\n\n/** Real money spent. */\nexport interface CostInfo {\n  /** Spent today. */\n  today?: number;\n  /** Spent this month (or billing period). */\n  month?: number;\n  /** Lifetime counter, where the source only reports that. */\n  total?: number;\n  /** Projected month-end spend (computed by the provider module, marked in the object name). */\n  projectedMonth?: number;\n  /** Currency code. */\n  currency: string;\n}\n\n/** Token counters (API accounts). */\nexport interface TokenInfo {\n  /** Input tokens today. */\n  inputToday?: number;\n  /** Output tokens today. */\n  outputToday?: number;\n  /** Per-model breakdown. */\n  perModel?: { model: string; tokens?: number; cost?: number }[];\n}\n\n/**\n * A transport-neutral usage snapshot \u2014 one fetch result. Only what the source\n * actually delivered is present; the tree builder creates nothing for absent parts.\n */\nexport interface UsageSnapshot {\n  /** Limit windows (subscription accounts). */\n  limits?: LimitWindow[];\n  /** Granted budget. */\n  credits?: CreditInfo;\n  /** Real money spent. */\n  costs?: CostInfo;\n  /** Token counters. */\n  tokens?: TokenInfo;\n  /** Provider-specific extra flags (e.g. DeepSeek `available`). */\n  available?: boolean;\n}\n\n/**\n * Why a fetch failed \u2014 drives reachability, backoff and notifications.\n *\n * `auth` and `rate-limit` mean the AI service ANSWERED (it is online, it just said\n * no), `service` means it answered with a server fault of its own, and `network`\n * means we never reached it. Keeping the last two apart is what lets the adapter\n * say whether the AI service is down or the ioBroker host has no connection.\n */\nexport type FetchErrorKind = \"auth\" | \"rate-limit\" | \"service\" | \"network\";\n\n/** A typed fetch failure. */\nexport class FetchError extends Error {\n  /**\n   * @param kind the failure class\n   * @param message the human-readable reason\n   */\n  public constructor(\n    public readonly kind: FetchErrorKind,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"FetchError\";\n  }\n}\n\n/** One account's usage source. Implementations are pure fetch+parse \u2014 no ioBroker inside. */\nexport interface UsageProvider {\n  /** Which provider this is. */\n  readonly kind: ProviderKind;\n  /** Fetch the current snapshot; throws {@link FetchError} on failure. */\n  fetch(): Promise<UsageSnapshot>;\n}\n\n/** Persisted OAuth tokens of one subscription account. */\nexport interface TokenSet {\n  /** The bearer token used for the usage call. */\n  accessToken: string;\n  /** The token used to obtain a fresh access token. */\n  refreshToken: string;\n  /** Absolute expiry of {@link accessToken} in ms since epoch. */\n  expiresAt: number;\n  /** Provider-specific extra the usage call needs (e.g. ChatGPT account id). */\n  accountRef?: string;\n}\n\n/** Where a subscription's tokens live. Keyed by PROVIDER, never by account name. */\nexport interface TokenStore {\n  /** Read the stored tokens, or null when never signed in. */\n  load(): Promise<TokenSet | null>;\n  /** Persist tokens (encrypted by the adapter). */\n  save(tokens: TokenSet): Promise<void>;\n  /** Forget the tokens (sign out / unusable refresh token). */\n  clear(): Promise<void>;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgHO,MAAM,mBAAmB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,EAK7B,YACW,MAChB,SACA;AACA,UAAM,OAAO;AAHG;AAIhB,SAAK,OAAO;AAAA,EACd;AAAA,EALkB;AAMpB;",
   "names": []
 }

package/build/lib/providers/chatgpt-sub.js

@@ -73,6 +73,7 @@ function parseChatgptUsage(body) {
     }
     const window = readWindow(entry.rate_limit, name, label);
     if (window) {
+      window.scoped = true;
       limits.push(window);
     }
   }

package/build/lib/providers/chatgpt-sub.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/providers/chatgpt-sub.ts"],
-  "sourcesContent": ["import { getJson, type JsonFetch } from \"../http\";\nimport {\n  FetchError,\n  type LimitWindow,\n  type TokenSet,\n  type TokenStore,\n  type UsageProvider,\n  type UsageSnapshot,\n} from \"../provider\";\nimport { CHATGPT_OAUTH, refreshChatgptTokens, type JsonPost } from \"./chatgpt-auth\";\n\n/** Where the subscription usage lives (the endpoint OpenAI's own Codex client uses). */\nexport const CHATGPT_USAGE_URL = \"https://chatgpt.com/backend-api/wham/usage\";\n\n/**\n * Read one rate-limit window.\n *\n * Both windows may be null when they do not apply to the account, and `reset_at`\n * is in Unix SECONDS \u2014 a value that already looks like milliseconds is passed\n * through, so a future format change cannot produce a year-58000 timestamp.\n *\n * @param raw the window object\n * @param name the object id segment\n * @param label the human-readable label\n * @returns the window, or undefined when unusable\n */\nfunction readWindow(raw: unknown, name: string, label: string): LimitWindow | undefined {\n  if (typeof raw !== \"object\" || raw === null) {\n    return undefined;\n  }\n  const entry = raw as Record<string, unknown>;\n  const percent = Number(entry.used_percent);\n  if (!Number.isFinite(percent)) {\n    return undefined;\n  }\n  const window: LimitWindow = { name, label, percent };\n  const resetAt = Number(entry.reset_at);\n  if (Number.isFinite(resetAt) && resetAt > 0) {\n    const ms = resetAt > 1e12 ? resetAt : resetAt * 1000;\n    window.resetAt = new Date(ms).toISOString();\n  }\n  return window;\n}\n\n/**\n * Parse a `/wham/usage` answer into a snapshot.\n *\n * Fields follow OpenAI's own generated models: `plan_type`, `rate_limit` with a\n * 5-hour `primary_window` and a weekly `secondary_window`, plus `credits` whose\n * balance arrives as a string in the schema but as a number in practice.\n *\n * @param body the parsed answer\n * @returns the snapshot\n */\nexport function parseChatgptUsage(body: unknown): UsageSnapshot {\n  if (typeof body !== \"object\" || body === null) {\n    throw new FetchError(\"network\", \"unexpected usage response\");\n  }\n  const raw = body as Record<string, unknown>;\n  const limits: LimitWindow[] = [];\n  const rateLimit = (raw.rate_limit ?? {}) as Record<string, unknown>;\n  const session = readWindow(rateLimit.primary_window, \"session\", \"Session (5 h)\");\n  const week = readWindow(rateLimit.secondary_window, \"week\", \"Week\");\n  if (session) {\n    limits.push(session);\n  }\n  if (week) {\n    limits.push(week);\n  }\n  for (const extra of Array.isArray(raw.additional_rate_limits) ? raw.additional_rate_limits : []) {\n    if (typeof extra !== \"object\" || extra === null) {\n      continue;\n    }\n    const entry = extra as Record<string, unknown>;\n    const label = typeof entry.limit_name === \"string\" ? entry.limit_name : \"\";\n    // The name becomes an object-id segment, so it must survive sanitizing and must\n    // not collide with a window already collected \u2014 a name of \"Session\" would\n    // otherwise overwrite the 5-hour window with an unrelated counter.\n    const name = label\n      .toLowerCase()\n      .replace(/[^a-z0-9]+/g, \"-\")\n      .replace(/^-+|-+$/g, \"\");\n    if (!name || limits.some(window => window.name === name)) {\n      continue;\n    }\n    const window = readWindow(entry.rate_limit, name, label);\n    if (window) {\n      limits.push(window);\n    }\n  }\n\n  const snapshot: UsageSnapshot = {};\n  if (limits.length) {\n    snapshot.limits = limits;\n  }\n\n  const credits = (raw.credits ?? {}) as Record<string, unknown>;\n  const balance = Number(credits.balance);\n  if (Number.isFinite(balance) && credits.unlimited !== true) {\n    snapshot.credits = { remaining: balance, currency: \"USD\" };\n  }\n  return snapshot;\n}\n\n/**\n * The ChatGPT/Codex subscription provider.\n *\n * @param store where the tokens live (keyed by provider, shared by no one else)\n * @param fetchJson the JSON-GET seam\n * @param postJson the JSON-POST seam (token refresh)\n * @param now clock (ms)\n * @returns the provider\n */\nexport function chatgptSubProvider(\n  store: TokenStore,\n  fetchJson: JsonFetch = getJson,\n  postJson: JsonPost,\n  now: () => number = Date.now,\n): UsageProvider {\n  let cached: TokenSet | null = null;\n  return {\n    kind: \"chatgpt-sub\",\n    fetch: async (): Promise<UsageSnapshot> => {\n      cached ??= await store.load();\n      if (!cached) {\n        throw new FetchError(\"auth\", \"not signed in \u2014 start the ChatGPT sign-in in the instance settings\");\n      }\n      if (now() >= cached.expiresAt - 60_000) {\n        cached = await refreshChatgptTokens(cached, postJson, now());\n        await store.save(cached);\n      }\n      const headers: Record<string, string> = {\n        Authorization: `Bearer ${cached.accessToken}`,\n        \"User-Agent\": \"ioBroker.ai-usage\",\n      };\n      // Only send the account id when we have one \u2014 an empty header is rejected.\n      if (cached.accountRef) {\n        headers[\"ChatGPT-Account-Id\"] = cached.accountRef;\n      }\n      return parseChatgptUsage(await fetchJson(CHATGPT_USAGE_URL, headers));\n    },\n  };\n}\n\nexport { CHATGPT_OAUTH };\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { getJson, type JsonFetch } from \"../http\";\nimport {\n  FetchError,\n  type LimitWindow,\n  type TokenSet,\n  type TokenStore,\n  type UsageProvider,\n  type UsageSnapshot,\n} from \"../provider\";\nimport { CHATGPT_OAUTH, refreshChatgptTokens, type JsonPost } from \"./chatgpt-auth\";\n\n/** Where the subscription usage lives (the endpoint OpenAI's own Codex client uses). */\nexport const CHATGPT_USAGE_URL = \"https://chatgpt.com/backend-api/wham/usage\";\n\n/**\n * Read one rate-limit window.\n *\n * Both windows may be null when they do not apply to the account, and `reset_at`\n * is in Unix SECONDS \u2014 a value that already looks like milliseconds is passed\n * through, so a future format change cannot produce a year-58000 timestamp.\n *\n * @param raw the window object\n * @param name the object id segment\n * @param label the human-readable label\n * @returns the window, or undefined when unusable\n */\nfunction readWindow(raw: unknown, name: string, label: string): LimitWindow | undefined {\n  if (typeof raw !== \"object\" || raw === null) {\n    return undefined;\n  }\n  const entry = raw as Record<string, unknown>;\n  const percent = Number(entry.used_percent);\n  if (!Number.isFinite(percent)) {\n    return undefined;\n  }\n  const window: LimitWindow = { name, label, percent };\n  const resetAt = Number(entry.reset_at);\n  if (Number.isFinite(resetAt) && resetAt > 0) {\n    const ms = resetAt > 1e12 ? resetAt : resetAt * 1000;\n    window.resetAt = new Date(ms).toISOString();\n  }\n  return window;\n}\n\n/**\n * Parse a `/wham/usage` answer into a snapshot.\n *\n * Fields follow OpenAI's own generated models: `plan_type`, `rate_limit` with a\n * 5-hour `primary_window` and a weekly `secondary_window`, plus `credits` whose\n * balance arrives as a string in the schema but as a number in practice.\n *\n * @param body the parsed answer\n * @returns the snapshot\n */\nexport function parseChatgptUsage(body: unknown): UsageSnapshot {\n  if (typeof body !== \"object\" || body === null) {\n    throw new FetchError(\"network\", \"unexpected usage response\");\n  }\n  const raw = body as Record<string, unknown>;\n  const limits: LimitWindow[] = [];\n  const rateLimit = (raw.rate_limit ?? {}) as Record<string, unknown>;\n  const session = readWindow(rateLimit.primary_window, \"session\", \"Session (5 h)\");\n  const week = readWindow(rateLimit.secondary_window, \"week\", \"Week\");\n  if (session) {\n    limits.push(session);\n  }\n  if (week) {\n    limits.push(week);\n  }\n  for (const extra of Array.isArray(raw.additional_rate_limits) ? raw.additional_rate_limits : []) {\n    if (typeof extra !== \"object\" || extra === null) {\n      continue;\n    }\n    const entry = extra as Record<string, unknown>;\n    const label = typeof entry.limit_name === \"string\" ? entry.limit_name : \"\";\n    // The name becomes an object-id segment, so it must survive sanitizing and must\n    // not collide with a window already collected \u2014 a name of \"Session\" would\n    // otherwise overwrite the 5-hour window with an unrelated counter.\n    const name = label\n      .toLowerCase()\n      .replace(/[^a-z0-9]+/g, \"-\")\n      .replace(/^-+|-+$/g, \"\");\n    if (!name || limits.some(window => window.name === name)) {\n      continue;\n    }\n    const window = readWindow(entry.rate_limit, name, label);\n    if (window) {\n      // These sit next to the plan-wide session/week windows and cover one model\n      // each \u2014 reported, but never the reason for a warning (LimitWindow.scoped).\n      window.scoped = true;\n      limits.push(window);\n    }\n  }\n\n  const snapshot: UsageSnapshot = {};\n  if (limits.length) {\n    snapshot.limits = limits;\n  }\n\n  const credits = (raw.credits ?? {}) as Record<string, unknown>;\n  const balance = Number(credits.balance);\n  if (Number.isFinite(balance) && credits.unlimited !== true) {\n    snapshot.credits = { remaining: balance, currency: \"USD\" };\n  }\n  return snapshot;\n}\n\n/**\n * The ChatGPT/Codex subscription provider.\n *\n * @param store where the tokens live (keyed by provider, shared by no one else)\n * @param fetchJson the JSON-GET seam\n * @param postJson the JSON-POST seam (token refresh)\n * @param now clock (ms)\n * @returns the provider\n */\nexport function chatgptSubProvider(\n  store: TokenStore,\n  fetchJson: JsonFetch = getJson,\n  postJson: JsonPost,\n  now: () => number = Date.now,\n): UsageProvider {\n  let cached: TokenSet | null = null;\n  return {\n    kind: \"chatgpt-sub\",\n    fetch: async (): Promise<UsageSnapshot> => {\n      cached ??= await store.load();\n      if (!cached) {\n        throw new FetchError(\"auth\", \"not signed in \u2014 start the ChatGPT sign-in in the instance settings\");\n      }\n      if (now() >= cached.expiresAt - 60_000) {\n        cached = await refreshChatgptTokens(cached, postJson, now());\n        await store.save(cached);\n      }\n      const headers: Record<string, string> = {\n        Authorization: `Bearer ${cached.accessToken}`,\n        \"User-Agent\": \"ioBroker.ai-usage\",\n      };\n      // Only send the account id when we have one \u2014 an empty header is rejected.\n      if (cached.accountRef) {\n        headers[\"ChatGPT-Account-Id\"] = cached.accountRef;\n      }\n      return parseChatgptUsage(await fetchJson(CHATGPT_USAGE_URL, headers));\n    },\n  };\n}\n\nexport { CHATGPT_OAUTH };\n"],
+  "mappings": "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",
   "names": ["window"]
 }

package/build/lib/providers/claude-sub.js

@@ -34,7 +34,7 @@ function parseClaudeUsage(body) {
   const raw = body;
   const limits = [];
   const seen = /* @__PURE__ */ new Set();
-  const push = (name, label, percent, resetsAt) => {
+  const push = (name, label, percent, resetsAt, scoped = false) => {
     const id = (0, import_pure_helpers.sanitizeId)(name);
     const value = Number(percent);
     if (!id || seen.has(id) || !Number.isFinite(value)) {
@@ -45,6 +45,9 @@ function parseClaudeUsage(body) {
     if (typeof resetsAt === "string" && resetsAt) {
       window.resetAt = resetsAt;
     }
+    if (scoped) {
+      window.scoped = true;
+    }
     limits.push(window);
   };
   if (Array.isArray(raw.limits)) {
@@ -72,20 +75,21 @@ function parseClaudeUsage(body) {
         nameParts.push(surface);
         labelParts.push(`(${surface})`);
       }
-      push(nameParts.join("-"), labelParts.join(" "), limit.percent, limit.resets_at);
+      const scoped = kind !== "session" && kind !== "weekly_all";
+      push(nameParts.join("-"), labelParts.join(" "), limit.percent, limit.resets_at, scoped);
     }
   }
   if (limits.length === 0) {
-    const flat = (key, name, label) => {
+    const flat = (key, name, label, scoped = false) => {
       const block = raw[key];
       if (typeof block === "object" && block !== null) {
         const data = block;
-        push(name, label, data.utilization, data.resets_at);
+        push(name, label, data.utilization, data.resets_at, scoped);
       }
     };
     flat("five_hour", "session", "Session (5 h)");
     flat("seven_day", "week", "Week (all models)");
-    flat("seven_day_sonnet", "week-sonnet", "Week Sonnet");
+    flat("seven_day_sonnet", "week-sonnet", "Week Sonnet", true);
   }
   const snapshot = {};
   if (limits.length > 0) {