@hashimkarim/usagestat-linux-x64-gnu 2.0.1 → 2.1.0

package/plugins/workbuddy/plugin.js

@@ -0,0 +1,232 @@
+// 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;
+  } else {
+    return rhsFn();
+  }
+}
+defineProvider({
+  id: "workbuddy",
+  name: "WorkBuddy",
+  endpoints: ["https://www.workbuddy.cn"],
+  settings: [
+    { key: "webTimeoutSeconds", title: "Web timeout", type: "plain" },
+    { key: "resetDeadlineMillis", title: "Reset lookup deadline", type: "plain" },
+    { key: "chromeMajorVersion", title: "Chrome major version", type: "plain" },
+  ],
+  capabilities: ["browser-cookies", "http-status"],
+  cookieDomains: ["workbuddy.cn", "www.workbuddy.cn"],
+  cookiePolicy: {
+    selection: "request-url",
+    cache: "validated-single-entry",
+    imports: "access-gated",
+  },
+  async fetchUsage(ctx) {
+    const origin = "https://www.workbuddy.cn";
+    const domain = "www.workbuddy.cn";
+    const policy = ctx.browser.availability(domain);
+    if (policy === "off") throw ctx.fail.missingCredential("WorkBuddy cookies are disabled.");
+    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.
+    // The previous major covers an installed update that Chrome has not relaunched into yet.
+    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 =
+      Number.isSafeInteger(major) && major > 1 ? [userAgent(major), userAgent(major - 1)] : [undefined];
+
+    const fail = (field) => {
+      throw ctx.fail.parseFailure(`Invalid WorkBuddy billing response: ${field}`);
+    };
+    const object = (value, field) =>
+      value !== null && typeof value === "object" && !Array.isArray(value) ? value : fail(field);
+    // Billing amounts arrive as decimal strings ("500"); numbers are accepted for robustness.
+    const amount = (value, field) => {
+      if (typeof value === "number") return Number.isFinite(value) && value >= 0 ? value : fail(field);
+      if (typeof value !== "string" || !/^\d+(?:\.\d+)?$/.test(value.trim())) return fail(field);
+      const parsed = Number(value.trim());
+      return Number.isFinite(parsed) ? parsed : fail(field);
+    };
+    const text = (value) => (typeof value === "string" ? value.trim() || undefined : undefined);
+    const format = (value) => ctx.format.number(value, { maximumFractionDigits: 2 });
+    const decode = (bodyText, field) => {
+      let value;
+      try {
+        value = JSON.parse(bodyText);
+      } catch (error) {
+        void error;
+        return fail(field);
+      }
+      return object(value, field);
+    };
+
+    const sessionExpired = ctx.fail.authenticationExpired(
+      "WorkBuddy session expired. Sign in at www.workbuddy.cn or paste a fresh Cookie header.",
+    );
+    const post = async (session, agent, path, body, requestTimeout = timeoutSeconds) => {
+      const headers = {
+        Accept: "application/json",
+        Origin: origin,
+        Referer: `${origin}/profile/plans-usage`,
+      };
+      if (agent) headers["User-Agent"] = agent;
+      const response = await ctx.http.post(`${origin}${path}`, {
+        body,
+        timeoutSeconds: requestTimeout,
+        cookieSession: session.id,
+        headers,
+      });
+      if (response.status === 401) throw sessionExpired;
+      if (response.status === 403) throw ctx.fail.permissionDenied("WorkBuddy denied access to billing data.");
+      if (response.status === 429) throw ctx.fail.rateLimited("WorkBuddy billing requests are rate limited.");
+      if (response.status >= 500) {
+        throw ctx.fail.providerUnavailable(`WorkBuddy billing API returned HTTP ${response.status}.`);
+      }
+      if (response.status !== 200) throw ctx.fail.apiFailure(`WorkBuddy billing API returned HTTP ${response.status}.`);
+      const root = decode(response.bodyText, "expected a JSON object");
+      if (root.code !== 0) {
+        throw ctx.fail.apiFailure(`WorkBuddy billing API returned code ${String(root.code)}.`);
+      }
+      return object(root.data, "data");
+    };
+
+    // Cycle timestamps carry no zone; WorkBuddy uses China Standard Time.
+    const cycleEnd = (value) => {
+      const raw = text(value);
+      if (!raw) return undefined;
+      const match = /^(\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}:\d{2})$/.exec(raw);
+      if (!match) return undefined;
+      const end = ctx.date.iso(`${match[1]}T${match[2]}+08:00`);
+      // The dashboard refreshes one second after the inclusive end time.
+      return new Date(end.getTime() + 1000);
+    };
+    // Package codes the WorkBuddy client sends for its paid and free listings (WorkBuddy 5.6.2).
+    const paidPackageCodes = [
+      "TCACA_code_002_AkiJS3ZHF5",
+      "TCACA_code_005_maRGyrHhw1",
+      "TCACA_code_003_FAnt7lcmRT",
+      "TCACA_code_023_4xbGhMrE6q",
+      "TCACA_code_026_BaESVICNoi",
+      "TCACA_code_027_0FCGVA6vSa",
+      "TCACA_code_009_0XmEQc2xOf",
+      "TCACA_code_038_OhvqZtiPKr",
+      "TCACA_code_036_lupO5WgNdG",
+    ];
+    const freePackageCodes = [
+      "TCACA_code_001_PqouKr6QWV",
+      "TCACA_code_008_cfWoLwvjU4",
+      "TCACA_code_035_ArVxJcGDsm",
+      "TCACA_code_006_DbXS0lrypC",
+      "TCACA_code_039_KRcQj7wUat",
+      "TCACA_code_040_mi9rCYg46x",
+      "TCACA_code_007_nzdH5h4Nl0",
+      "TCACA_code_028_NtpWi0jzXs",
+      "TCACA_code_037_WxOD3MpI2o",
+      "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) => {
+      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],
+      ]) {
+        const budget = (deadline - Date.now()) / 1000;
+        if (budget < 1) break;
+        try {
+          // The listings reject requests without package codes (HTTP 400, code 10001). Status 0 is valid, 3 used up.
+          const page = await post(
+            session,
+            agent,
+            path,
+            { 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;
+          }
+        } catch (error) {
+          if (error.transportClass === "cancelled") throw error;
+        }
+        // Paid cycles refill the allowance; free grants may expire earlier.
+        if (earliest) return earliest;
+      }
+    };
+
+    let rejected = false;
+    for await (const session of ctx.browser.sessions(domain)) {
+      let summary;
+      let agent;
+      for (const candidate of userAgents) {
+        try {
+          summary = await post(session, candidate, "/billing/meter/get-user-resource-summary", {});
+          agent = candidate;
+          break;
+        } catch (error) {
+          if (error !== sessionExpired) throw error;
+        }
+      }
+      if (!summary) {
+        rejected = true;
+        ctx.browser.rejectCookie(domain, session);
+        if (policy === "manual") break;
+        continue;
+      }
+
+      if (!Array.isArray(summary.Packages)) return fail("Packages");
+      // The host caches an imported session only after the billing API accepts it.
+      if (policy !== "manual") ctx.browser.acceptCookie(domain, session);
+      let total = 0;
+      let remaining = 0;
+      let frozen = 0;
+      for (const raw of summary.Packages) {
+        const item = object(raw, "package");
+        if (item.CapacityUnit !== "credits") continue;
+        total += amount(item.CycleTotalCapacity, "CycleTotalCapacity");
+        remaining += amount(item.CycleRemainCapacity, "CycleRemainCapacity");
+        if (item.CycleFrozenCapacity !== undefined) frozen += amount(item.CycleFrozenCapacity, "CycleFrozenCapacity");
+      }
+      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) });
+      }
+      return {
+        primary:
+          total > 0
+            ? {
+                usedPercent: ctx.pct(Math.max(0, total - remaining), total),
+                resetsAt: await nextReset(session, agent),
+                resetDescription: `${format(remaining)} / ${format(total)} credits left`,
+              }
+            : undefined,
+        details: rows.length ? [{ title: "Credits", rows }] : undefined,
+        identity: plan ? { loginMethod: plan } : undefined,
+        dataConfidence: "exact",
+      };
+    }
+    if (rejected) throw sessionExpired;
+    throw ctx.fail.missingCredential(
+      `No WorkBuddy session cookies found. Sign in at www.workbuddy.cn (${ctx.browser.supportedBrowsers}) or paste a Cookie header.`,
+    );
+  },
+});
+
+// END UPSTREAM
+})(globalThis.defineProvider);

package/plugins/workbuddy/plugin.json

@@ -0,0 +1,51 @@
+{
+  "schemaVersion": 1,
+  "id": "workbuddy",
+  "name": "WorkBuddy",
+  "version": "0.1.0",
+  "entry": "plugin.js",
+  "enabledByDefault": false,
+  "supportedModes": [
+    "web"
+  ],
+  "autoMode": "web",
+  "usageDashboardUrl": "https://www.workbuddy.cn",
+  "webUrl": "https://workbuddy.cn",
+  "envVars": [
+    "WORKBUDDY_COOKIE"
+  ],
+  "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": "browserUserAgent",
+      "title": "Browser User-Agent",
+      "type": "string",
+      "description": "Paste the full User-Agent from the same browser session that supplied the cookies. Required for WorkBuddy web readback."
+    }
+  ],
+  "upstream": {
+    "repository": "https://github.com/steipete/CodexBar",
+    "revision": "6070b29a1a5d51193a634dc1b0a14a67c39d0ccc",
+    "path": "Sources/CodexBarCore/Resources/Plugins/workbuddy.js",
+    "sha256": "9da73ec195a174e3ee96e3096a47db0b69295bc52dcfceb9fd9d1a2b8f74b08a",
+    "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": "6070b29a1a5d51193a634dc1b0a14a67c39d0ccc",
+    "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": "25bba9b7fd9ce83c33053958f7366e23b2dc8a82",
+    "revision": "6070b29a1a5d51193a634dc1b0a14a67c39d0ccc",
     "path": "Sources/CodexBarCore/Resources/Plugins/xkiro.js",
     "sha256": "03bfcb8e518577ee18dd335e4e1e1f7d629d3e5abdf2216b187b1cba8b683853",
     "license": "MIT"