@hashimkarim/usagestat-linux-x64-gnu 2.0.0-alpha.3 → 2.0.0-alpha.4

package/plugins/huggingface/plugin.js

@@ -0,0 +1,293 @@
+// Generated by tools/vendor-codexbar-providers.cjs; see LICENSE.
+globalThis.__usagestat_bundled_options = {"labels":["Inference","ZeroGPU","Additional"],"defaults":{},"autoMode":"api"};
+function _nullishCoalesce(lhs, rhsFn) {
+  if (lhs != null) {
+    return lhs;
+  } else {
+    return rhsFn();
+  }
+}
+function _optionalChain(ops) {
+  let lastAccessLHS = undefined;
+  let value = ops[0];
+  let i = 1;
+  while (i < ops.length) {
+    const op = ops[i];
+    const fn = ops[i + 1];
+    i += 2;
+    if ((op === "optionalAccess" || op === "optionalCall") && value == null) {
+      return undefined;
+    }
+    if (op === "access" || op === "optionalAccess") {
+      lastAccessLHS = value;
+      value = fn(value);
+    } else if (op === "call" || op === "optionalCall") {
+      value = fn((...args) => value.call(lastAccessLHS, ...args));
+      lastAccessLHS = undefined;
+    }
+  }
+  return value;
+}
+
+defineProvider({
+  id: "huggingface",
+  name: "Hugging Face",
+  endpoints: ["https://huggingface.co"],
+  settings: [{ key: "HF_TOKEN", title: "Access token", type: "secure" }],
+  capabilities: ["browser-cookies", "http-status"],
+  cookieDomains: ["huggingface.co"],
+  async fetchUsage(ctx) {
+    const fail = (field) => {
+      throw ctx.fail.parseFailure(`Hugging Face billing response format changed: ${field}`);
+    };
+    const object = (value, field) => {
+      if (!value || typeof value !== "object" || Array.isArray(value)) return fail(field);
+      return value;
+    };
+    const number = (value, field) => {
+      if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return fail(field);
+      return value;
+    };
+    const optionalNumber = (value, field) => (value === undefined || value === null ? undefined : number(value, field));
+    const parse = (body) => {
+      let value;
+      try {
+        value = JSON.parse(body);
+      } catch (error) {
+        void error;
+        return fail("invalid JSON");
+      }
+      return object(value, "expected an object");
+    };
+    const date = (value) => {
+      if (value === undefined || value === null) return undefined;
+      if (typeof value === "number") {
+        if (!Number.isFinite(value) || value <= 0 || value > 64092211200) return undefined;
+        return ctx.date.unixSeconds(value);
+      }
+      if (typeof value === "string") {
+        try {
+          return ctx.date.iso(value);
+        } catch (error) {
+          void error;
+        }
+      }
+      return undefined;
+    };
+    const text = (value) => (typeof value === "string" ? value.trim() || undefined : undefined);
+    const userID = (profile) =>
+      profile.type === "user" && typeof profile.id === "string" && profile.id.trim() ? profile.id : undefined;
+    // Keep bearer authority off requests that verify the browser session.
+    const token = ctx.settings.getSecret("HF_TOKEN");
+    if (!token) throw ctx.fail.missingCredential("Missing Hugging Face access token.");
+    const apiHeaders = { Authorization: `Bearer ${token}`, "User-Agent": "CodexBar" };
+    const now = ctx.date.now();
+    const start = Math.floor(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1) / 1000);
+    const end = Math.floor(now.getTime() / 1000);
+    const response = await ctx.http.get(
+      `https://huggingface.co/api/settings/billing/usage-v2?startDate=${start}&endDate=${end}`,
+      { timeoutSeconds: 15, headers: apiHeaders },
+    );
+    if (response.status === 401) {
+      throw ctx.fail.authenticationExpired("Hugging Face rejected the token. Check that it is valid and not expired.");
+    }
+    if (response.status === 403) {
+      throw ctx.fail.permissionDenied(
+        "The Hugging Face token lacks billing access. Use a classic read token or enable Billing read on a fine-grained token.",
+      );
+    }
+    if (response.status === 429) throw ctx.fail.rateLimited("Hugging Face rate limit reached. Retry later.");
+    if (response.status >= 500)
+      throw ctx.fail.providerUnavailable(`Hugging Face API returned HTTP ${response.status}.`);
+    if (response.status < 200 || response.status >= 300) {
+      throw ctx.fail.apiFailure(`Hugging Face API returned HTTP ${response.status}.`);
+    }
+    const usage = object(parse(response.bodyText).usage, "missing usage");
+    const inference = object(usage.inferenceProviders, "missing inferenceProviders usage");
+    const gross = number(inference.usedNanoUsd, "usedNanoUsd") / 1e9;
+    const included = number(inference.includedNanoUsd, "includedNanoUsd") / 1e9;
+    const billable = Math.max(0, gross - included);
+    const limit = _nullishCoalesce(optionalNumber(inference.limitNanoUsd, "limitNanoUsd"), () => 0) / 1e9;
+    const requests = optionalNumber(inference.numRequests, "numRequests");
+    if (requests !== undefined && !Number.isSafeInteger(requests)) return fail("numRequests");
+    let secondary;
+    let gpuRows = [];
+    try {
+      const gpuResponse = await ctx.http.get("https://huggingface.co/api/spaces/zero-gpu/quota", {
+        timeoutSeconds: 2,
+        headers: apiHeaders,
+      });
+      if (gpuResponse.status >= 200 && gpuResponse.status < 300) {
+        const gpu = parse(gpuResponse.bodyText);
+        const total = number(gpu.base, "ZeroGPU base");
+        const remaining = number(gpu.current, "ZeroGPU current");
+        if (total > 0) {
+          const consumed = Math.max(0, total - remaining);
+          secondary = {
+            usedPercent: ctx.pct(consumed, total),
+            resetsAt: date(gpu.resetsAt),
+            resetDescription: "ZeroGPU quota",
+          };
+          const minutes = (seconds) =>
+            `${ctx.format.number(seconds / 60, {
+              minimumFractionDigits: seconds >= 600 ? 0 : 1,
+              maximumFractionDigits: seconds >= 600 ? 0 : 1,
+            })} min`;
+          gpuRows = [
+            { label: "GPU time used", value: minutes(consumed) },
+            { label: "GPU time remaining", value: minutes(remaining) },
+          ];
+        }
+      }
+    } catch (error) {
+      void error;
+    }
+    const cacheKey = "whoami-v2:" + token;
+    let identity = ctx.cache.get(cacheKey);
+    if (!identity || now.getTime() - identity.fetchedAt < 0 || now.getTime() - identity.fetchedAt >= 43200000) {
+      identity = undefined;
+      try {
+        const whoami = await ctx.http.get("https://huggingface.co/api/whoami-v2", {
+          timeoutSeconds: 2,
+          headers: apiHeaders,
+        });
+        if (whoami.status >= 200 && whoami.status < 300) {
+          const profile = parse(whoami.bodyText);
+          const username = text(profile.name);
+          const email = text(profile.email);
+          if (username || email || userID(profile)) {
+            identity = {
+              fetchedAt: now.getTime(),
+              userID: userID(profile),
+              username,
+              email,
+              plan: typeof profile.isPro === "boolean" ? (profile.isPro ? "PRO" : "Free") : undefined,
+            };
+            ctx.cache.set(cacheKey, identity, 43200);
+          }
+        }
+      } catch (error) {
+        void error;
+      }
+    }
+    let balance;
+    const availability = ctx.browser.availability("huggingface.co");
+    if (
+      _optionalChain([identity, "optionalAccess", (_2) => _2.userID]) &&
+      (availability === "available" || availability === "manual")
+    ) {
+      try {
+        const cookie = await ctx.browser.cookieHeader("huggingface.co");
+        const web = async (path, accept) => {
+          const result = await ctx.http.get(`https://huggingface.co${path}`, {
+            headers: { Cookie: cookie, Accept: accept },
+            timeoutSeconds: 2,
+          });
+          if (result.status === 401 || result.status === 403) ctx.browser.rejectCookie("huggingface.co");
+          if (result.status !== 200) return fail("wallet unavailable");
+          return result;
+        };
+        const billing = await web("/settings/billing", "text/html");
+        if (
+          !_optionalChain([
+            billing,
+            "access",
+            (_3) => _3.headers,
+            "access",
+            (_4) => _4["content-type"],
+            "optionalAccess",
+            (_5) => _5.toLowerCase,
+            "call",
+            (_6) => _6(),
+            "access",
+            (_7) => _7.includes,
+            "call",
+            (_8) => _8("text/html"),
+          ])
+        )
+          return fail("wallet content type");
+        const current = [];
+        const legacy = [];
+        const entities = new Map([
+          ["amp", "&"],
+          ["apos", "'"],
+          ["gt", ">"],
+          ["lt", "<"],
+          ["nbsp", "\u00a0"],
+          ["quot", '"'],
+        ]);
+        const decode = (raw) =>
+          raw.replace(/&([^;]*);/g, (_, entity) => {
+            const named = entities.get(entity);
+            if (named !== undefined) return named;
+            const scalar = /^#x[0-9a-f]+$/i.test(entity)
+              ? parseInt(entity.slice(2), 16)
+              : /^#[0-9]+$/.test(entity)
+                ? Number(entity.slice(1))
+                : NaN;
+            if (!Number.isInteger(scalar) || scalar > 0x10ffff || (scalar >= 0xd800 && scalar <= 0xdfff))
+              return fail("wallet HTML entity");
+            return String.fromCodePoint(scalar);
+          });
+        for (const tag of _nullishCoalesce(billing.bodyText.match(/<div\b[^>]*>/gi), () => [])) {
+          const props = /\bdata-props\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i.exec(tag);
+          if (!props) continue;
+          const payload = JSON.parse(
+            decode(
+              _nullishCoalesce(
+                _nullishCoalesce(props[1], () => props[2]),
+                () => props[3],
+              ),
+            ),
+          );
+          if (!payload || typeof payload !== "object" || Array.isArray(payload)) continue;
+          const entity = payload.entity;
+          if (entity && Object.prototype.hasOwnProperty.call(entity, "currentBalanceUsd")) {
+            if (entity.type !== "user") return fail("wallet entity type");
+            current.push(entity.currentBalanceUsd);
+          }
+          if (Object.prototype.hasOwnProperty.call(payload, "invoiceCreditsCents"))
+            legacy.push(payload.invoiceCreditsCents);
+        }
+        let candidate;
+        if (current.length) {
+          if (current.length !== 1) return fail("ambiguous current wallet");
+          candidate = number(current[0], "currentBalanceUsd");
+        } else {
+          if (legacy.length !== 1) return fail("missing or ambiguous legacy wallet");
+          const cents = number(legacy[0], "invoiceCreditsCents");
+          if (!Number.isSafeInteger(cents)) return fail("invoiceCreditsCents");
+          candidate = cents / 100;
+        }
+        // The billing page's display names are not ownership proof. Resolve the same cookie without a bearer.
+        const profile = parse((await web("/api/whoami-v2", "application/json")).bodyText);
+        if (userID(profile) === identity.userID) balance = candidate;
+      } catch (error) {
+        void error;
+      }
+    }
+    // usage-v2 reports a query interval; its cutoff is not a quota reset.
+    // HF's billing UI deducts includedNanoUsd from usedNanoUsd to calculate the charge.
+    const rows = [{ label: "Billable usage", value: ctx.format.usd(billable) }];
+    if (included > 0) {
+      rows.push({ label: "Gross inference usage", value: ctx.format.usd(gross) });
+      rows.push({ label: "Included inference amount", value: ctx.format.usd(included) });
+    }
+    if (limit > 0) rows.push({ label: "Spending limit", value: ctx.format.usd(limit) });
+    if (requests !== undefined) rows.push({ label: "Requests", value: String(requests) });
+    const details = [{ title: "Inference Providers", rows }];
+    if (gpuRows.length) details.push({ title: "ZeroGPU", rows: gpuRows });
+    if (balance !== undefined)
+      details.push({ title: "Credits", rows: [{ label: "Prepaid balance", value: ctx.format.usd(balance) }] });
+    return {
+      secondary,
+      cost: { used: billable, balance, limit: limit > 0 ? limit : undefined, currency: "USD", period: "This month" },
+      details,
+      identity:
+        identity && (identity.username || identity.email || identity.plan)
+          ? { email: identity.email, accountID: identity.username, loginMethod: identity.plan }
+          : undefined,
+      dataConfidence: "exact",
+    };
+  },
+});

package/plugins/huggingface/plugin.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "id": "huggingface",
+  "name": "Hugging Face",
+  "version": "0.1.0",
+  "entry": "plugin.js",
+  "enabledByDefault": false,
+  "supportedModes": [
+    "api"
+  ],
+  "autoMode": "api",
+  "usageDashboardUrl": "https://huggingface.co/settings/billing",
+  "webUrl": "https://huggingface.co",
+  "envVars": [
+    "HF_TOKEN",
+    "HUGGINGFACE_COOKIE"
+  ],
+  "upstream": {
+    "repository": "https://github.com/steipete/CodexBar",
+    "revision": "78ba5a1e65e6859da59a21b799df95ab91bc0b89",
+    "path": "Sources/CodexBarCore/Resources/Plugins/huggingface.js",
+    "sha256": "78cb1bb09535c71f7cb9d1a6336efb4ead44b36a1d4716602c1f7a1e35821291",
+    "license": "MIT"
+  }
+}

package/plugins/hyper/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/hyper/plugin.js

@@ -0,0 +1,131 @@
+// Generated by tools/vendor-codexbar-providers.cjs; see LICENSE.
+globalThis.__usagestat_bundled_options = {"labels":["Balance","Balance","Additional"],"defaults":{},"autoMode":"api"};
+function _optionalChain(ops) {
+  let lastAccessLHS = undefined;
+  let value = ops[0];
+  let i = 1;
+  while (i < ops.length) {
+    const op = ops[i];
+    const fn = ops[i + 1];
+    i += 2;
+    if ((op === "optionalAccess" || op === "optionalCall") && value == null) {
+      return undefined;
+    }
+    if (op === "access" || op === "optionalAccess") {
+      lastAccessLHS = value;
+      value = fn(value);
+    } else if (op === "call" || op === "optionalCall") {
+      value = fn((...args) => value.call(lastAccessLHS, ...args));
+      lastAccessLHS = undefined;
+    }
+  }
+  return value;
+}
+defineProvider({
+  id: "hyper",
+  name: "Charm Hyper",
+  endpoints: ["https://hyper.charm.land"],
+  capabilities: ["browser-cookies", "http-status"],
+  cookieDomains: ["hyper.charm.land"],
+  settings: [
+    { key: "HYPER_API_KEY", title: "API key", type: "secure" },
+    { key: "SOURCE_MODE", title: "Source", type: "plain" },
+  ],
+  async fetchUsage(ctx) {
+    const domain = "hyper.charm.land";
+    const key = ctx.settings.getSecret("HYPER_API_KEY");
+    const webOnly = ctx.settings.get("SOURCE_MODE") === "web";
+    const missing = () => {
+      throw ctx.fail.missingCredential("Sign in to hyper.charm.land or configure a Charm Hyper API key.");
+    };
+    const request = (headers, timeoutSeconds = 10) =>
+      ctx.http.get(`https://${domain}/v1/credits`, {
+        headers,
+        timeoutSeconds,
+      });
+    let response;
+    let session = false;
+    if (ctx.browser.availability(domain) !== "off") {
+      try {
+        const cookie = await ctx.browser.cookieHeader(domain);
+        session = true;
+        response = await request({ Cookie: cookie }, 5);
+      } catch (error) {
+        if (error.transportClass === "cancelled") throw error;
+        if (webOnly || !key) {
+          if (session) throw ctx.fail.networkFailure("Charm Hyper session request failed.");
+          return missing();
+        }
+      }
+      if (
+        response &&
+        (response.status === 401 ||
+          response.status === 403 ||
+          (response.status >= 300 && response.status < 400) ||
+          (response.status === 200 &&
+            _optionalChain([
+              response,
+              "access",
+              (_) => _.headers,
+              "access",
+              (_2) => _2["content-type"],
+              "optionalAccess",
+              (_3) => _3.toLowerCase,
+              "call",
+              (_4) => _4(),
+              "access",
+              (_5) => _5.includes,
+              "call",
+              (_6) => _6("text/html"),
+            ])))
+      ) {
+        ctx.browser.rejectCookie(domain);
+        if (webOnly || !key) {
+          throw ctx.fail.authenticationExpired(
+            "Charm Hyper session expired. Sign in again or paste a fresh Cookie header.",
+          );
+        }
+        response = undefined;
+      }
+    }
+    if (!response) {
+      if (webOnly || !key) return missing();
+      response = await request({ Authorization: `Bearer ${key}` });
+      session = false;
+    }
+    if (response.status === 401) throw ctx.fail.authenticationExpired("Charm Hyper API key rejected (HTTP 401).");
+    if (response.status === 403)
+      throw ctx.fail.permissionDenied("Charm Hyper API key cannot access credits (HTTP 403).");
+    if (response.status === 429) throw ctx.fail.rateLimited("Charm Hyper credits requests are rate limited.");
+    if (response.status >= 500) throw ctx.fail.providerUnavailable(`Charm Hyper API error: HTTP ${response.status}`);
+    if (response.status !== 200) throw ctx.fail.apiFailure(`Charm Hyper API error: HTTP ${response.status}`);
+
+    let payload;
+    try {
+      payload = JSON.parse(response.bodyText);
+    } catch (error) {
+      void error;
+      throw ctx.fail.parseFailure("Charm Hyper credits response is not valid JSON.");
+    }
+    const balance = _optionalChain([payload, "optionalAccess", (_7) => _7.balance]);
+    if (typeof balance !== "number" || !Number.isFinite(balance) || balance < 0) {
+      throw ctx.fail.parseFailure("Charm Hyper balance must be a non-negative number.");
+    }
+    return {
+      details: [
+        {
+          title: "Hypercredits",
+          rows: [
+            {
+              label: "Balance",
+              value: `${ctx.format.number(balance, { maximumFractionDigits: 2 })} HC`,
+              usageValue: balance,
+            },
+          ],
+        },
+      ],
+      identity: { loginMethod: session ? "Browser session" : "API key" },
+      dataConfidence: "exact",
+    };
+  },
+});

package/plugins/hyper/plugin.json

@@ -0,0 +1,26 @@
+{
+  "schemaVersion": 1,
+  "id": "hyper",
+  "name": "Charm Hyper",
+  "version": "0.1.0",
+  "entry": "plugin.js",
+  "enabledByDefault": false,
+  "supportedModes": [
+    "api",
+    "web"
+  ],
+  "autoMode": "api",
+  "usageDashboardUrl": "https://hyper.charm.land",
+  "webUrl": "https://hyper.charm.land",
+  "envVars": [
+    "HYPER_API_KEY",
+    "HYPER_COOKIE"
+  ],
+  "upstream": {
+    "repository": "https://github.com/steipete/CodexBar",
+    "revision": "78ba5a1e65e6859da59a21b799df95ab91bc0b89",
+    "path": "Sources/CodexBarCore/Resources/Plugins/hyper.js",
+    "sha256": "893e1a9a91e7af57522bcc39791d77d6fe3b8ae0d61384aee1768f5f419636cd",
+    "license": "MIT"
+  }
+}

package/plugins/kilo/icon-color.svg

@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Kilo Code</title><path d="M0 0v24h24V0H0zm22.222 22.222H1.778V1.778h20.444v20.444zm-7.555-4.964h2.222v1.778h-2.794L12.89 17.83v-2.794h1.778v2.222zm4 0h-1.778v-2.222h-2.222v-1.778h2.793l1.207 1.207v2.793zm-7.556-2.591H9.333v-1.778h1.778v1.778zm-5.778-1.778h1.778v4h4v1.778H6.54L5.333 17.46V12.89zm13.334-3.556v1.778h-5.778V9.333h1.987V7.111h-1.987V5.333h2.558l1.206 1.207v2.793h2.014zm-11.556-2h2.222l1.778 1.778v2H9.333v-2H7.111v2H5.333V5.333h1.778v2zm4 0H9.333v-2h1.778v2z"></path></svg>

package/plugins/litellm/plugin.js

@@ -9,6 +9,8 @@
   }
 
   function apiKey(ctx) {
+    if (Object.prototype.hasOwnProperty.call(ctx.provider || {}, 'apiKey')) return ctx.provider.apiKey;
+    if (ctx.provider && ctx.provider.instanceId && ctx.provider.instanceId !== 'litellm') return null;
     var configured = ctx.provider && typeof ctx.provider.apiKey === "string" ? ctx.provider.apiKey.trim() : "";
     return configured || env(ctx, "LITELLM_API_KEY");
   }
@@ -51,13 +53,14 @@
     return Number.isFinite(ms) ? new Date(ms) : null;
   }
 
-  function requestJson(ctx, base, path, key) {
+  function requestJson(ctx, base, path, key, optional) {
     var resp = ctx.util.request({
       method: "GET",
       url: base + path,
       headers: { Authorization: "Bearer " + key, Accept: "application/json" },
       timeoutMs: 15000,
     });
+    if (optional && [401,403,404].includes(resp.status)) return null;
     if (ctx.util.isAuthStatus(resp.status)) throw "LiteLLM API key was rejected.";
     if (resp.status < 200 || resp.status >= 300) {
       throw "LiteLLM API request failed (HTTP " + resp.status + ").";
@@ -189,10 +192,58 @@
     var key = apiKey(ctx);
     if (!key) throw "Missing LiteLLM API key. Set LITELLM_API_KEY or provider apiKey.";
     var base = baseUrl(ctx);
-    var info = keyInfo(requestJson(ctx, base, "/key/info", key));
+    var keyData = requestJson(ctx, base, "/key/info", key, true);
+    if (keyData === null) {
+      var end = ctx.nowIso.slice(0,10), start = end.slice(0,7)+'-01';
+      var query = '?start_date='+start+'&end_date='+end;
+      var rows = requestJson(ctx, base, '/key/spend/report'+query, key, true);
+      if (rows === null) rows = requestJson(ctx, base, '/user/spend/report'+query, key);
+      if (!Array.isArray(rows) || !rows.length) throw new Error('LiteLLM spend report is empty or invalid.');
+      var cost = 0;
+      for (var row of rows) {
+        if (typeof row.total_cost !== 'number' || !Number.isFinite(row.total_cost) || row.total_cost < 0) throw new Error('Invalid LiteLLM spend.');
+        cost += row.total_cost;
+      }
+      if (!Number.isFinite(cost)) throw new Error('Invalid LiteLLM spend total.');
+      return {source:'api',lines:[ctx.line.text({label:'Month to date',value:usd(cost),subtitle:start+' to '+end+' UTC'})]};
+    }
+    var info = keyInfo(keyData);
     var snapshot = info.userID ? userSnapshot(ctx, base, key, info) : teamSnapshot(ctx, base, key, info);
     var plan = snapshot.team && snapshot.team.alias ? snapshot.team.alias : null;
-    return { displayName: "LiteLLM", source: "api", plan: plan, lines: linesFor(snapshot) };
+    var lines = linesFor(snapshot);
+    if (info.userID && (ctx.provider?.settings?.modelUsage === true || ctx.provider?.settings?.LITELLM_MODEL_USAGE_ENABLED === 'true')) {
+      try { lines.push.apply(lines, modelActivity(ctx,base,key,info.userID)); } catch (_) { ctx.host.log.warn('LiteLLM optional model activity unavailable.'); }
+    }
+    return { displayName: "LiteLLM", source: "api", plan: plan, lines: lines };
+  }
+
+  function modelActivity(ctx,base,key,user) {
+    var end=ctx.nowIso.slice(0,10),start=new Date(Date.parse(end)-29*86400000).toISOString().slice(0,10),totals={};
+    for(var page=1;page<=3;page++) {
+      var response=ctx.host.http.request({method:'GET',url:base+'/user/daily/activity?user_id='+encodeURIComponent(user)+'&start_date='+start+'&end_date='+end+'&page='+page+'&page_size=1000',
+        headers:{Authorization:'Bearer '+key,Accept:'application/json'},timeoutMs:2000});
+      if(response.status!==200) throw new Error('Unavailable');
+      var data=ctx.util.tryParseJson(response.bodyText);
+      if(!Array.isArray(data?.results)||data.results.length>31) throw new Error('Invalid activity');
+      for(var row of data.results) {
+        if(!/^\d{4}-\d{2}-\d{2}$/.test(row.date)||row.date<start||row.date>end||!row.breakdown?.models) throw new Error('Invalid day');
+        for(var [name, value] of Object.entries(row.breakdown.models)) {
+          if(!name.trim()||name.length>256||/[\x00-\x1f]/.test(name)||['__proto__','constructor','prototype'].includes(name)) throw new Error('Invalid model');
+          var metrics=value.metrics||value,prior=totals[name]||[0,0,0,0];
+          totals[name]=['prompt_tokens','completion_tokens','total_tokens','api_requests'].map(function(field,i){
+            var n=metrics[field]; if(!Number.isSafeInteger(n)||n<0||!Number.isSafeInteger(n+prior[i])) throw new Error('Invalid count'); return n+prior[i];
+          });
+          if(Object.keys(totals).length>1000) throw new Error('Too many models');
+        }
+      }
+      var metadata=data.metadata||{};
+      if(metadata.page!=null&&metadata.page!==page) throw new Error('Repeated page');
+      if(metadata.has_more!=null&&typeof metadata.has_more!=='boolean') throw new Error('Invalid page');
+      if(metadata.total_pages!=null&&(!Number.isSafeInteger(metadata.total_pages)||metadata.total_pages<1)) throw new Error('Invalid page');
+      if(metadata.has_more!==true&&page>=(metadata.total_pages||1)) return Object.entries(totals).sort((a,b)=>b[1][2]-a[1][2]).slice(0,20)
+        .map(([name,n])=>ctx.line.text({label:name,value:n[2]+' tokens / '+n[3]+' requests',subtitle:'30d UTC: '+n[0]+' input / '+n[1]+' output'}));
+    }
+    throw new Error('Incomplete activity');
   }
 
   globalThis.__openusage_plugin = { id: "litellm", probe: probe };

package/plugins/llmman/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.