@hashimkarim/usagestat-linux-x64-gnu 2.0.2 → 2.2.0

package/plugins/workbuddy/plugin.js

@@ -1,5 +1,7 @@
 // Generated by tools/vendor-codexbar-providers.cjs; see LICENSE.
 globalThis.__usagestat_bundled_options = {"labels":["Credits","Credits","Additional"],"defaults":{},"autoMode":"web"};
+(function(defineProvider) {
+// BEGIN UPSTREAM Sources/CodexBarCore/Resources/Plugins/workbuddy.js
 function _nullishCoalesce(lhs, rhsFn) {
   if (lhs != null) {
     return lhs;
@@ -15,6 +17,8 @@ defineProvider({
     { key: "webTimeoutSeconds", title: "Web timeout", type: "plain" },
     { key: "resetDeadlineMillis", title: "Reset lookup deadline", type: "plain" },
     { key: "chromeMajorVersion", title: "Chrome major version", type: "plain" },
+    { key: "manualUserAgent", title: "User-Agent", type: "plain" },
+    { key: "manualUserAgentError", title: "Invalid User-Agent message", type: "plain" },
   ],
   capabilities: ["browser-cookies", "http-status"],
   cookieDomains: ["workbuddy.cn", "www.workbuddy.cn"],
@@ -28,6 +32,16 @@ defineProvider({
     const domain = "www.workbuddy.cn";
     const policy = ctx.browser.availability(domain);
     if (policy === "off") throw ctx.fail.missingCredential("WorkBuddy cookies are disabled.");
+    const manualUserAgent = policy === "manual" ? _nullishCoalesce(ctx.settings.get("manualUserAgent"), () => "") : "";
+    if (/[^\x20-\x7e]/.test(manualUserAgent)) {
+      throw ctx.fail.missingCredential(
+        _nullishCoalesce(
+          ctx.settings.get("manualUserAgentError"),
+          () => "Paste the WorkBuddy User-Agent as a single request header value.",
+        ),
+      );
+    }
+    const override = manualUserAgent.trim();
     const timeoutRaw = Number(_nullishCoalesce(ctx.settings.get("webTimeoutSeconds"), () => "15"));
     const timeoutSeconds = Number.isFinite(timeoutRaw) ? Math.min(30, Math.max(1, Math.round(timeoutRaw))) : 15;
     // WorkBuddy binds the session to the browser User-Agent, and Chrome's reduced UA varies only by major version.
@@ -35,8 +49,9 @@ defineProvider({
     const major = Number(_nullishCoalesce(ctx.settings.get("chromeMajorVersion"), () => ""));
     const userAgent = (version) =>
       `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${version}.0.0.0 Safari/537.36`;
-    const userAgents =
+    const chromeUserAgents =
       Number.isSafeInteger(major) && major > 1 ? [userAgent(major), userAgent(major - 1)] : [undefined];
+    const userAgents = override ? [override] : chromeUserAgents;
 
     const fail = (field) => {
       throw ctx.fail.parseFailure(`Invalid WorkBuddy billing response: ${field}`);
@@ -93,7 +108,7 @@ defineProvider({
       return object(root.data, "data");
     };
 
-    // Cycle timestamps carry no zone. The billing cycle follows China Standard Time calendar months.
+    // Cycle timestamps carry no zone; WorkBuddy uses China Standard Time.
     const cycleEnd = (value) => {
       const raw = text(value);
       if (!raw) return undefined;
@@ -103,6 +118,16 @@ defineProvider({
       // The dashboard refreshes one second after the inclusive end time.
       return new Date(end.getTime() + 1000);
     };
+    // Spent grants stay in the listing until their cycle ends. The dashboard reports the lapse of the
+    // grants that still carry credits, so a grant with nothing left must not bound the reward window.
+    const creditsLeft = (value) => {
+      try {
+        return amount(value, "CycleCapacityRemain");
+      } catch (error) {
+        void error;
+        return undefined;
+      }
+    };
     // Package codes the WorkBuddy client sends for its paid and free listings (WorkBuddy 5.6.2).
     const paidPackageCodes = [
       "TCACA_code_002_AkiJS3ZHF5",
@@ -128,16 +153,21 @@ defineProvider({
       "TCACA_code_029_6wCGEWquYy",
       "TCACA_code_030_BjSt89qTvr",
     ];
-    // Reset time is optional: a failed or unexpected package listing must not discard the balance.
-    const nextReset = async (session, agent) => {
+    // Platform reward grants are aggregated under one package code in the summary. Only the free listing
+    // carries each grant's own cycle, so the reward expiry has to be read from there.
+    const benefitPackageCode = "TCACA_code_007_nzdH5h4Nl0";
+    // Reset and reward expiry are optional: a failed or unexpected package listing must not discard the balance.
+    const listings = async (session, agent, wantsRewards) => {
       const now = ctx.date.now().getTime();
       // Share five seconds across listings, retaining the host's margin for publishing the balance.
       const hostDeadline = Number(ctx.settings.get("resetDeadlineMillis"));
       const deadline = Math.min(Date.now() + 5000, hostDeadline > 0 ? hostDeadline : Infinity);
-      let earliest;
-      for (const [path, codes] of [
-        ["/billing/meter/get-user-resource-paid-packages", paidPackageCodes],
-        ["/billing/meter/get-user-resource-free-packages", freePackageCodes],
+      let paidReset;
+      let freeReset;
+      let rewardExpiry;
+      for (const [path, codes, isFree] of [
+        ["/billing/meter/get-user-resource-paid-packages", paidPackageCodes, false],
+        ["/billing/meter/get-user-resource-free-packages", freePackageCodes, true],
       ]) {
         const budget = (deadline - Date.now()) / 1000;
         if (budget < 1) break;
@@ -150,20 +180,41 @@ defineProvider({
             { PageNumber: 1, PageSize: 100, PackageCodes: codes, Status: [0, 3] },
             Math.min(timeoutSeconds, budget),
           );
-          if (!Array.isArray(page.Accounts)) continue;
-          for (const raw of page.Accounts) {
-            if (raw === null || typeof raw !== "object" || Array.isArray(raw)) continue;
-            const account = raw;
-            if (account.CapacityUnit !== "credits") continue;
-            const end = cycleEnd(account.CycleEndTime);
-            if (end && end.getTime() > now && (!earliest || end.getTime() < earliest.getTime())) earliest = end;
+          if (Array.isArray(page.Accounts)) {
+            for (const raw of page.Accounts) {
+              if (raw === null || typeof raw !== "object" || Array.isArray(raw)) continue;
+              const account = raw;
+              if (account.CapacityUnit !== "credits") continue;
+              const end = cycleEnd(account.CycleEndTime);
+              if (!end || end.getTime() <= now) continue;
+              if (isFree) {
+                // Reward grants expire piecewise; the earliest grant that still holds credits bounds the window.
+                const left = creditsLeft(account.CycleCapacityRemain);
+                if (
+                  account.PackageCode === benefitPackageCode &&
+                  left !== undefined &&
+                  left > 0 &&
+                  (!rewardExpiry || end.getTime() < rewardExpiry.getTime())
+                ) {
+                  rewardExpiry = end;
+                }
+                // Reward grants expire; they never supply the allowance's fallback reset.
+                if (account.PackageCode !== benefitPackageCode && (!freeReset || end.getTime() < freeReset.getTime())) {
+                  freeReset = end;
+                }
+              } else if (!paidReset || end.getTime() < paidReset.getTime()) {
+                paidReset = end;
+              }
+            }
           }
         } catch (error) {
-          const failure = error;
-          if (failure.transportClass === "cancelled") throw error;
+          if (error.transportClass === "cancelled") throw error;
         }
+        // Paid cycles refill the allowance; free grants may expire earlier. The free listing is only
+        // worth a request when it answers the reset or bounds the reward window.
+        if (!isFree && paidReset && !wantsRewards) break;
       }
-      return earliest;
+      return { reset: _nullishCoalesce(paidReset, () => freeReset), rewardExpiry };
     };
 
     let rejected = false;
@@ -199,21 +250,58 @@ defineProvider({
         remaining += amount(item.CycleRemainCapacity, "CycleRemainCapacity");
         if (item.CycleFrozenCapacity !== undefined) frozen += amount(item.CycleFrozenCapacity, "CycleFrozenCapacity");
       }
+      // Credit groups split the same allowance by origin. Rewards are optional, so an unexpected group
+      // shape must not discard the balance the dashboard shows.
+      let rewardTotal = 0;
+      let rewardRemaining = 0;
+      for (const raw of Array.isArray(summary.CreditGroups) ? summary.CreditGroups : []) {
+        if (raw === null || typeof raw !== "object" || Array.isArray(raw)) continue;
+        const group = raw;
+        if (group.Kind !== "benefit" || group.CapacityUnit !== "credits") continue;
+        try {
+          const groupTotal = amount(group.CycleTotalCapacity, "CycleTotalCapacity");
+          const groupRemaining = amount(group.CycleRemainCapacity, "CycleRemainCapacity");
+          rewardTotal += groupTotal;
+          rewardRemaining += groupRemaining;
+        } catch (error) {
+          void error;
+        }
+      }
       const plan = text(summary.SubscriptionPackageName);
       // Frozen credits are listed as reported; the meter uses the remaining amount the dashboard shows.
       const rows = frozen > 0 ? [{ label: "Reserved", value: format(frozen) }] : [];
       if (total <= 0) {
         rows.unshift({ label: "Left", value: format(remaining) }, { label: "Total", value: format(total) });
       }
+      const wantsRewards = rewardTotal > 0;
+      const cycle = await listings(session, agent, wantsRewards);
+      // The window carries the balance; it cannot carry a countdown, because reward credits lapse
+      // grant by grant instead of resetting, so the expiry stays a detail row.
+      if (wantsRewards && cycle.rewardExpiry) {
+        rows.push({ label: "Reward expiry", value: ctx.format.monthDay(cycle.rewardExpiry.getTime()) });
+      }
+      const extraWindows = wantsRewards
+        ? [
+            {
+              id: "rewards",
+              title: "Rewards",
+              window: {
+                usedPercent: ctx.pct(Math.max(0, rewardTotal - rewardRemaining), rewardTotal),
+                resetDescription: `${format(rewardRemaining)} / ${format(rewardTotal)} credits left`,
+              },
+            },
+          ]
+        : [];
       return {
         primary:
           total > 0
             ? {
                 usedPercent: ctx.pct(Math.max(0, total - remaining), total),
-                resetsAt: await nextReset(session, agent),
+                resetsAt: cycle.reset,
                 resetDescription: `${format(remaining)} / ${format(total)} credits left`,
               }
             : undefined,
+        extraWindows: extraWindows.length ? extraWindows : undefined,
         details: rows.length ? [{ title: "Credits", rows }] : undefined,
         identity: plan ? { loginMethod: plan } : undefined,
         dataConfidence: "exact",
@@ -225,3 +313,6 @@ defineProvider({
     );
   },
 });
+
+// END UPSTREAM
+})(globalThis.defineProvider);

package/plugins/workbuddy/plugin.json

@@ -16,6 +16,36 @@
   ],
   "setupHelp": "Use a Cookie header from www.workbuddy.cn and the full User-Agent from the same browser. Set Browser User-Agent below. Desktop login files are not imported.",
   "setupFields": [
+    {
+      "key": "webTimeoutSeconds",
+      "title": "Web timeout",
+      "type": "string",
+      "description": "Provider-specific account or source selection."
+    },
+    {
+      "key": "resetDeadlineMillis",
+      "title": "Reset lookup deadline",
+      "type": "string",
+      "description": "Provider-specific account or source selection."
+    },
+    {
+      "key": "chromeMajorVersion",
+      "title": "Chrome major version",
+      "type": "string",
+      "description": "Provider-specific account or source selection."
+    },
+    {
+      "key": "manualUserAgent",
+      "title": "User-Agent",
+      "type": "string",
+      "description": "Provider-specific account or source selection."
+    },
+    {
+      "key": "manualUserAgentError",
+      "title": "Invalid User-Agent message",
+      "type": "string",
+      "description": "Provider-specific account or source selection."
+    },
     {
       "key": "browserUserAgent",
       "title": "Browser User-Agent",
@@ -25,9 +55,9 @@
   ],
   "upstream": {
     "repository": "https://github.com/steipete/CodexBar",
-    "revision": "6ba06fe9ec1522dd5c59e16810115bce28aa148f",
+    "revision": "1f6da9bec44455288ddee5ef6f3617a803d8eb2a",
     "path": "Sources/CodexBarCore/Resources/Plugins/workbuddy.js",
-    "sha256": "d5dbd97ac32a7ceee75f0969415c7601e17402a6cad19a163735b4747e4d2e89",
+    "sha256": "4a440637dc7a8ec77592edf5d0fe50181eff9919be08fefa7007bc50476a4301",
     "license": "MIT"
   }
 }

package/plugins/xai/plugin.js

@@ -12,6 +12,7 @@
   }
 
   function env(ctx, name) {
+    if (ctx.provider && ctx.provider.instanceId && ctx.provider.instanceId !== 'xai') return null;
     try {
       return clean(ctx.host.env.get(name));
     } catch (_) {
@@ -135,6 +136,14 @@
     });
     var balance = balanceUsd(balanceJson.total && balanceJson.total.val);
     var metrics = [ctx.line.text({ label: "Balance", value: balance < 0 ? "Deficit: $" + (-balance).toFixed(2) : "$" + balance.toFixed(2) })];
+    try {
+      var preview = ctx.util.requestJson({method:'GET',url:BASE_URL+'/v1/billing/teams/'+encodeURIComponent(id)+'/postpaid/invoice/preview',
+        headers:{Authorization:'Bearer '+key,Accept:'application/json'},timeoutMs:5000});
+      var cents = preview.json && preview.json.coreInvoice && preview.json.coreInvoice.amountAfterVat;
+      if (preview.resp.status>=200 && preview.resp.status<300 && typeof cents==='string' && /^-?\d+$/.test(cents) && Number.isSafeInteger(Number(cents)))
+        metrics.push(ctx.line.text({label:'Live remaining (est.)',value:'$'+(balance-Number(cents)/100).toFixed(2),
+          subtitle:'Prepaid balance less the current invoice preview; not a settled charge.'}));
+    } catch (_) {ctx.host.log.warn('xAI invoice preview unavailable');}
 
     var daily = fetchDaily(ctx, key, id);
     if (daily.length) {

package/plugins/xapi/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Peter Steinberger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/plugins/xapi/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path fill="currentColor" d="M3 3h5.2l5.3 7.1L19.5 3H22l-7.3 8.9L22 21h-5.2l-5.7-7.5L4.7 21H2l7.9-9.3L3 3zm3.4 1.7 11.2 14.6h1.1L7.5 4.7H6.4z"/></svg>

package/plugins/xapi/plugin.js

@@ -0,0 +1,90 @@
+// Generated by tools/vendor-codexbar-providers.cjs; see LICENSE.
+globalThis.__usagestat_bundled_options = {"labels":["Balance","Additional","Additional"],"defaults":{},"autoMode":"web","balanceOnly":true};
+(function(defineProvider) {
+// BEGIN UPSTREAM Sources/CodexBarCore/Resources/Plugins/xapi.js
+defineProvider({
+  id: "xapi",
+  name: "X API",
+  settings: [],
+  endpoints: ["https://console.x.com"],
+  capabilities: ["browser-cookies", "http-status"],
+  cookieDomains: ["x.com", "console.x.com"],
+  cookiePolicy: {
+    selection: "request-url",
+    cache: "nonpersistent",
+    imports: "access-gated",
+    requiredCookies: ["auth_token", "ct0"],
+    headerEcho: { origin: "https://console.x.com", cookie: "ct0", header: "X-CSRF-Token" },
+  },
+  async fetchUsage(ctx) {
+    const domain = "console.x.com";
+    if (ctx.browser.availability(domain) === "off") throw ctx.fail.missingCredential("X API cookies are disabled.");
+    const invalid = () => {
+      throw ctx.fail.parseFailure("X API returned an unrecognized account or dollar balance.");
+    };
+    const amount = (value) => (typeof value === "number" && Number.isFinite(value) ? value : invalid());
+    const expired = ctx.fail.authenticationExpired("X API session expired. Sign in to console.x.com again.");
+    let rejected = false;
+    for await (const session of ctx.browser.sessions(domain)) {
+      const request = async (path) => {
+        const response = await ctx.http.get(`https://console.x.com${path}`, {
+          cookieSession: session.id,
+          headers: { Accept: "application/json" },
+        });
+        if (response.status === 401) throw expired;
+        if (response.status === 403) throw ctx.fail.permissionDenied("X developer console access was denied.");
+        if (response.status === 429)
+          throw ctx.fail.rateLimited("X API console is rate limited. Wait before refreshing.");
+        if (response.status >= 500) throw ctx.fail.providerUnavailable("X developer console is unavailable.");
+        let json;
+        try {
+          json = JSON.parse(response.bodyText);
+        } catch {
+          if (response.status === 200) return invalid();
+        }
+        // The console also reports expired authentication as HTTP 400 / code 215.
+        if (response.status === 400 && Array.isArray(json?.errors) && json.errors.some((error) => error?.code === 215))
+          throw expired;
+        if (response.status !== 200) throw ctx.fail.apiFailure(`X developer console returned HTTP ${response.status}.`);
+        return json;
+      };
+      try {
+        const me = await request("/api/me");
+        const id = me?.account?.id;
+        const account = Number.isSafeInteger(id) && id >= 0 ? String(id) : id;
+        if (typeof account !== "string" || !/^[A-Za-z0-9_-]{1,128}$/.test(account)) return invalid();
+        const credits = await request(`/api/accounts/${account}/credits`);
+        // The console renders these directly as dollars; its spend endpoint uses different units.
+        const paid = amount(credits?.credits?.balance);
+        const free = credits?.freeCredits === undefined ? 0 : amount(credits.freeCredits?.balance);
+        const balance = amount(paid + free);
+        return {
+          cost: { used: 0, balance, currency: "USD", period: "Prepaid credits" },
+          details: [
+            {
+              title: "Credits",
+              rows: [
+                { label: "Balance", value: ctx.format.currency(balance, "USD"), usageValue: balance },
+                { label: "Purchased credits", value: ctx.format.currency(paid, "USD") },
+                { label: "Free credits", value: ctx.format.currency(free, "USD") },
+              ],
+            },
+          ],
+          identity: { loginMethod: "Browser session" },
+          dataConfidence: "exact",
+        };
+      } catch (error) {
+        if (error !== expired) throw error;
+        ctx.browser.rejectCookie(domain, session);
+        rejected = true;
+      }
+    }
+    if (rejected) throw expired;
+    throw ctx.fail.missingCredential(
+      `Sign in to console.x.com. Supported browsers: ${ctx.browser.supportedBrowsers}. Or paste its Cookie header.`,
+    );
+  },
+});
+
+// END UPSTREAM
+})(globalThis.defineProvider);

package/plugins/xapi/plugin.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "id": "xapi",
+  "name": "X API",
+  "version": "0.1.0",
+  "entry": "plugin.js",
+  "enabledByDefault": false,
+  "supportedModes": [
+    "web"
+  ],
+  "autoMode": "web",
+  "usageDashboardUrl": "https://console.x.com",
+  "webUrl": "https://x.com",
+  "envVars": [
+    "XAPI_COOKIE"
+  ],
+  "setupFields": [],
+  "upstream": {
+    "repository": "https://github.com/steipete/CodexBar",
+    "revision": "1f6da9bec44455288ddee5ef6f3617a803d8eb2a",
+    "path": "Sources/CodexBarCore/Resources/Plugins/xapi.js",
+    "sha256": "c8aff7628f2a67a8726486d847747dd8121123da6526b2793b4b7b36ec37930f",
+    "license": "MIT"
+  }
+}

package/plugins/xkiro/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M3 4h5l4 5.5L16 4h5l-6.5 8L21 20h-5l-4-5.5L8 20H3l6.5-8Z"/></svg>

package/plugins/xkiro/plugin.js

@@ -1,5 +1,7 @@
 // Generated by tools/vendor-codexbar-providers.cjs; see LICENSE.
 globalThis.__usagestat_bundled_options = {"labels":["Daily free tokens","Weekly","Additional"],"defaults":{},"autoMode":"api"};
+(function(defineProvider) {
+// BEGIN UPSTREAM Sources/CodexBarCore/Resources/Plugins/xkiro.js
 function _nullishCoalesce(lhs, rhsFn) {
   if (lhs != null) {
     return lhs;
@@ -97,3 +99,6 @@ defineProvider({
     };
   },
 });
+
+// END UPSTREAM
+})(globalThis.defineProvider);

package/plugins/xkiro/plugin.json

@@ -13,9 +13,10 @@
   "envVars": [
     "XKIRO_API_KEY"
   ],
+  "setupFields": [],
   "upstream": {
     "repository": "https://github.com/steipete/CodexBar",
-    "revision": "6ba06fe9ec1522dd5c59e16810115bce28aa148f",
+    "revision": "1f6da9bec44455288ddee5ef6f3617a803d8eb2a",
     "path": "Sources/CodexBarCore/Resources/Plugins/xkiro.js",
     "sha256": "03bfcb8e518577ee18dd335e4e1e1f7d629d3e5abdf2216b187b1cba8b683853",
     "license": "MIT"