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

package/plugins/xai/plugin.js

@@ -0,0 +1,162 @@
+(function () {
+  var BASE_URL = "https://management-api.x.ai";
+  var HISTORY_DAYS = 30;
+
+  function clean(value) {
+    if (typeof value !== "string") return null;
+    var v = value.trim();
+    if (!v) return null;
+    if ((v[0] === "\"" && v[v.length - 1] === "\"") || (v[0] === "'" && v[v.length - 1] === "'")) v = v.slice(1, -1).trim();
+    if (v.slice(0, 7).toLowerCase() === "bearer ") v = v.slice(7).trim();
+    return v || null;
+  }
+
+  function env(ctx, name) {
+    try {
+      return clean(ctx.host.env.get(name));
+    } catch (_) {
+      return null;
+    }
+  }
+
+  function apiKey(ctx) {
+    return clean(ctx.provider && ctx.provider.apiKey) || env(ctx, "XAI_MANAGEMENT_API_KEY");
+  }
+
+  function teamId(ctx) {
+    var id = clean(ctx.provider && ctx.provider.workspaceId) || env(ctx, "XAI_TEAM_ID");
+    if (!id) return null;
+    if (id === "." || id === ".." || id.indexOf("/") >= 0 || id.indexOf("\\") >= 0) {
+      throw "The xAI team ID must be a single identifier without path separators.";
+    }
+    return id;
+  }
+
+  function requestJson(ctx, req) {
+    var result = ctx.util.requestJson(req);
+    if (ctx.util.isAuthStatus(result.resp.status)) {
+      throw "xAI rejected the Management API key. Create one in the xAI Console under Settings > Management Keys.";
+    }
+    if (result.resp.status === 404) throw "xAI returned 404 for this team. Check the team ID and Management key.";
+    if (result.resp.status === 429) throw "xAI Management API rate limit exceeded.";
+    if (result.resp.status < 200 || result.resp.status >= 300) throw "xAI Management API returned HTTP " + result.resp.status + ".";
+    if (!result.json || typeof result.json !== "object") throw "Could not parse xAI billing data.";
+    return result.json;
+  }
+
+  function balanceUsd(raw) {
+    var text = raw == null ? "" : String(raw).trim();
+    if (!/^-?\d+(?:\.\d+)?$/.test(text) || !Number.isFinite(Number(text))) throw "xAI balance total.val is not a cent amount.";
+    return -Number(text) / 100;
+  }
+
+  function pad(n) {
+    return n < 10 ? "0" + n : String(n);
+  }
+
+  function formatRequestTimestamp(date) {
+    return date.getUTCFullYear() + "-" + pad(date.getUTCMonth() + 1) + "-" + pad(date.getUTCDate()) +
+      " " + pad(date.getUTCHours()) + ":" + pad(date.getUTCMinutes()) + ":" + pad(date.getUTCSeconds());
+  }
+
+  function usageBody(now) {
+    var start = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
+    start = new Date(start.getTime() - (HISTORY_DAYS - 1) * 24 * 60 * 60 * 1000);
+    return JSON.stringify({
+      analyticsRequest: {
+        timeRange: {
+          startTime: formatRequestTimestamp(start),
+          endTime: formatRequestTimestamp(now),
+          timezone: "Etc/GMT",
+        },
+        timeUnit: "TIME_UNIT_DAY",
+        values: [{ name: "usd", aggregation: "AGGREGATION_SUM" }],
+        groupBy: [],
+        filters: [],
+      },
+    });
+  }
+
+  function dayKey(ctx, timestamp) {
+    var iso = ctx.util.toIso(timestamp);
+    if (typeof timestamp === "string" && /^\d{4}-\d{2}-\d{2}$/.test(timestamp) && iso && iso.slice(0, 10) !== timestamp) return null;
+    return iso ? iso.slice(0, 10) : null;
+  }
+
+  function shortDay(day) {
+    return Number(day.slice(5, 7)) + "/" + Number(day.slice(8, 10));
+  }
+
+  function fetchDaily(ctx, key, id) {
+    try {
+      var json = requestJson(ctx, {
+        method: "POST",
+        url: BASE_URL + "/v1/billing/teams/" + encodeURIComponent(id) + "/usage",
+        headers: {
+          Authorization: "Bearer " + key,
+          Accept: "application/json",
+          "Content-Type": "application/json",
+        },
+        bodyText: usageBody(new Date(ctx.nowIso)),
+        timeoutMs: 3000,
+      });
+      var totals = {};
+      if (!Array.isArray(json.timeSeries)) throw "Missing xAI usage time series.";
+      var series = json.timeSeries;
+      for (var i = 0; i < series.length; i++) {
+        var points = Array.isArray(series[i].dataPoints) ? series[i].dataPoints : [];
+        for (var j = 0; j < points.length; j++) {
+          var day = dayKey(ctx, points[j].timestamp);
+          var raw = Array.isArray(points[j].values) ? points[j].values[0] : null;
+          if (!day || (typeof raw !== "number" && typeof raw !== "string") || String(raw).trim() === "" || !Number.isFinite(Number(raw)) || Number(raw) < 0) throw "Invalid xAI usage history point.";
+          if (day <= ctx.nowIso.slice(0, 10)) totals[day] = (totals[day] || 0) + Number(raw);
+        }
+      }
+      return Object.keys(totals).sort().map(function (day) {
+        return { day: day, cost: totals[day] };
+      });
+    } catch (error) {
+      ctx.host.log.warn("xAI usage history request failed: " + String(error));
+      return [];
+    }
+  }
+
+  function probe(ctx) {
+    var key = apiKey(ctx);
+    if (!key) throw "Missing xAI Management API key. Set XAI_MANAGEMENT_API_KEY or provider apiKey.";
+    var id = teamId(ctx);
+    if (!id) throw "Missing xAI team ID. Set XAI_TEAM_ID or provider workspaceId.";
+
+    var balanceJson = requestJson(ctx, {
+      method: "GET",
+      url: BASE_URL + "/v1/billing/teams/" + encodeURIComponent(id) + "/prepaid/balance",
+      headers: { Authorization: "Bearer " + key, Accept: "application/json" },
+      timeoutMs: 15000,
+    });
+    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) })];
+
+    var daily = fetchDaily(ctx, key, id);
+    if (daily.length) {
+      try {
+        ctx.host.usageDaily.ingest({ provider: "xai", source: "api", daily: daily.map(function (row) {
+          return { date: row.day, costUsd: row.cost };
+        }) });
+      } catch (error) {
+        ctx.host.log.warn("Could not persist xAI usage history: " + String(error));
+      }
+      var total = daily.reduce(function (sum, row) { return sum + row.cost; }, 0);
+      metrics.push(ctx.line.text({ label: "Cost", value: "$" + total.toFixed(2), subtitle: "Last 30 days" }));
+      metrics.push(ctx.line.barChart({
+        label: "Cost History",
+        points: daily.map(function (row) { return { label: shortDay(row.day), value: row.cost, valueLabel: "$" + row.cost.toFixed(2) }; }),
+        note: "Recent xAI Management API usage.",
+        color: "#111111",
+      }));
+    }
+
+    return { displayName: "xAI", source: "api", plan: "Management API", lines: metrics };
+  }
+
+  globalThis.__openusage_plugin = { id: "xai", probe: probe };
+})();

package/plugins/xai/plugin.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "id": "xai",
+  "name": "xAI",
+  "version": "0.1.0",
+  "entry": "plugin.js",
+  "enabledByDefault": false,
+  "supportedModes": [
+    "api"
+  ],
+  "autoMode": "api",
+  "usageDashboardUrl": "https://console.x.ai",
+  "statusPageUrl": "https://status.x.ai",
+  "links": [
+    {
+      "label": "Dashboard",
+      "url": "https://console.x.ai"
+    },
+    {
+      "label": "Status",
+      "url": "https://status.x.ai"
+    }
+  ],
+  "envVars": [
+    "XAI_MANAGEMENT_API_KEY",
+    "XAI_TEAM_ID"
+  ]
+}

package/plugins/zai/plugin.js

@@ -1,187 +1,137 @@
 (function () {
-  const BASE_URL = "https://api.z.ai"
-  const SUBSCRIPTION_URL = BASE_URL + "/api/biz/subscription/list"
-  const QUOTA_URL = BASE_URL + "/api/monitor/usage/quota/limit"
-  const PERIOD_MS = 5 * 60 * 60 * 1000
-  const WEEK_MS = 7 * 24 * 60 * 60 * 1000
-  const MONTH_MS = 30 * 24 * 60 * 60 * 1000
+  const HOUR_MS = 60 * 60 * 1000
+  const WEEK_MS = 7 * 24 * HOUR_MS
+  const MONTH_MS = 30 * 24 * HOUR_MS
+  const INVALID = "Z.ai usage response invalid. Try again later."
 
-  function loadApiKey(ctx) {
-    const zai = ctx.host.env.get("ZAI_API_KEY")
-    if (typeof zai === "string" && zai.trim()) return zai.trim()
-
-    const glm = ctx.host.env.get("GLM_API_KEY")
-    if (typeof glm === "string" && glm.trim()) return glm.trim()
-
-    return null
+  function clean(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null
   }
 
-  function fetchSubscription(ctx, apiKey) {
-    try {
-      const resp = ctx.util.request({
-        method: "GET",
-        url: SUBSCRIPTION_URL,
-        headers: {
-          Authorization: "Bearer " + apiKey,
-          Accept: "application/json",
-        },
-        timeoutMs: 10000,
-      })
-      if (resp.status < 200 || resp.status >= 300) {
-        ctx.host.log.warn("subscription request failed: HTTP " + resp.status)
-        return null
-      }
-      const data = ctx.util.tryParseJson(resp.bodyText)
-      if (!data) return null
-      const list = data.data
-      if (!Array.isArray(list) || list.length === 0) return null
-      return {
-        productName: list[0].productName || null,
-        nextRenewTime: list[0].nextRenewTime || null,
-      }
-    } catch (e) {
-      ctx.host.log.warn("subscription request exception: " + String(e))
-      return null
-    }
+  function number(value) {
+    if (typeof value !== "number" && typeof value !== "string") return null
+    if (typeof value === "string" && !value.trim()) return null
+    const parsed = Number(value)
+    return Number.isFinite(parsed) ? parsed : null
   }
 
-  function fetchQuota(ctx, apiKey) {
-    let resp
-    try {
-      resp = ctx.util.request({
-        method: "GET",
-        url: QUOTA_URL,
-        headers: {
-          Authorization: "Bearer " + apiKey,
-          Accept: "application/json",
-        },
-        timeoutMs: 10000,
-      })
-    } catch (e) {
-      ctx.host.log.error("usage request exception: " + String(e))
-      throw "Usage request failed. Check your connection."
-    }
-
-    if (ctx.util.isAuthStatus(resp.status)) {
-      throw "API key invalid. Check your Z.ai API key."
+  function credentials(ctx) {
+    const provider = ctx.provider || {}
+    const settings = provider.settings || {}
+    const env = (name) => clean(ctx.host.env.get(name))
+    const cnKey = env("BIGMODEL_API_KEY") || env("ZHIPU_API_KEY")
+    const key = clean(provider.apiKey) || env("ZAI_API_KEY") || env("Z_AI_API_KEY") || env("GLM_API_KEY") || cnKey
+    if (!key) throw "No ZAI_API_KEY found. Set a provider API key or environment variable."
+    const region = (clean(provider.region) || clean(settings.region) || env("Z_AI_REGION") || (key === cnKey ? "bigmodel-cn" : "global")).toLowerCase()
+    const china = ["cn", "china", "bigmodel-cn"].includes(region)
+    if (!china && region !== "global") throw "Unsupported Z.ai region. Use global or bigmodel-cn."
+    if (key === cnKey && !china) throw "BigModel API keys must use the bigmodel-cn region."
+    const headers = { Authorization: "Bearer " + key, Accept: "application/json" }
+    const scope = clean(settings.usageScope) || env("Z_AI_USAGE_SCOPE") || "personal"
+    if (!["personal", "team"].includes(scope)) throw "Unsupported Z.ai usage scope."
+    if (scope === "team") {
+      const organization = clean(settings.organization) || env("Z_AI_ORGANIZATION")
+      const project = clean(settings.project) || clean(provider.workspaceId) || env("Z_AI_PROJECT")
+      if (!organization || !project) throw "Z.ai team usage needs organization and project settings."
+      headers["Bigmodel-Organization"] = organization
+      headers["Bigmodel-Project"] = project
     }
+    return { base: china ? "https://open.bigmodel.cn" : "https://api.z.ai", china, headers, scope }
+  }
 
-    if (resp.status < 200 || resp.status >= 300) {
-      throw "Usage request failed (HTTP " + String(resp.status) + "). Try again later."
-    }
+  function request(ctx, auth, url, timeoutMs) {
+    const result = ctx.util.requestJson({ method: "GET", url, headers: auth.headers, timeoutMs })
+    if (ctx.util.isAuthStatus(result.resp.status)) throw "Z.ai API key invalid. Check its region and credentials."
+    if (result.resp.status < 200 || result.resp.status >= 300) throw "Z.ai API returned HTTP " + result.resp.status + "."
+    const root = result.json
+    if (!root || root.success === false || (root.code !== undefined && number(root.code) !== 200)) throw INVALID
+    return root
+  }
 
-    const data = ctx.util.tryParseJson(resp.bodyText)
-    if (!data) {
-      throw "Usage response invalid. Try again later."
-    }
+  function duration(entry) {
+    const multipliers = { 1: 24 * HOUR_MS, 3: HOUR_MS, 5: 60000, 6: WEEK_MS }
+    const unit = number(entry.unit)
+    const count = number(entry.number)
+    if ((entry.type || entry.name) === "TIME_LIMIT" && unit === 5 && count === 1) return MONTH_MS
+    if (count > 0 && multipliers[unit]) return count * multipliers[unit]
+    if (unit === 6) return WEEK_MS
+    if (unit === 3 || unit === null) return 5 * HOUR_MS
+    return null
+  }
 
-    return data
+  function reset(ctx, entry, periodMs) {
+    const raw = entry.nextResetTime
+    let ms = number(raw)
+    if (ms === null && typeof raw === "string") ms = Date.parse(raw)
+    if (!Number.isFinite(ms) || ms < 1000000000000 || ms > 4102444800000) return undefined
+    const now = Date.parse(ctx.nowIso) || Date.now()
+    if (periodMs === 5 * HOUR_MS && ms > now + periodMs + 60000) return undefined
+    return new Date(ms).toISOString()
   }
 
-  function findLimit(limits, type, unit) {
-    let fallback = null
-    for (let i = 0; i < limits.length; i++) {
-      const item = limits[i]
-      if (item.type === type || item.name === type) {
-        if (unit === undefined) {
-          return item
-        }
-        if (item.unit === unit) {
-          return item
-        }
-        // Store first entry without unit as fallback
-        if (fallback === null && item.unit === undefined) {
-          fallback = item
-        }
-      }
+  function quotaLine(ctx, entry) {
+    let used = number(entry.percentage)
+    const cap = number(entry.usage)
+    const current = number(entry.currentValue)
+    const remaining = number(entry.remaining)
+    if (cap > 0 && (current !== null || remaining !== null)) {
+      used = Math.max(current === null ? 0 : current, remaining === null ? 0 : cap - remaining) / cap * 100
     }
-    return fallback
+    if (used === null) throw INVALID
+    const periodMs = duration(entry)
+    const label = periodMs === WEEK_MS ? "Weekly" : periodMs === 5 * HOUR_MS ? "Session" : "Quota"
+    return ctx.line.progress({
+      label, used: Math.max(0, Math.min(100, used)), limit: 100,
+      format: { kind: "percent" }, periodDurationMs: periodMs || undefined,
+      resetsAt: reset(ctx, entry, periodMs),
+    })
   }
 
   function probe(ctx) {
-    const apiKey = loadApiKey(ctx)
-    if (!apiKey) {
-      throw "No ZAI_API_KEY found. Set up environment variable first."
-    }
-
-    const sub = fetchSubscription(ctx, apiKey)
-    const plan = sub && sub.productName ? ctx.fmt.planLabel(sub.productName) : null
-
-    const quota = fetchQuota(ctx, apiKey)
+    const auth = credentials(ctx)
+    const root = request(ctx, auth, auth.base + "/api/monitor/usage/quota/limit" + (auth.scope === "team" ? "?type=2" : ""), 10000)
+    const data = root.data || root
+    const limits = Array.isArray(data) ? data : data.limits
+    if (!Array.isArray(limits) || limits.some((item) => !item || typeof item !== "object")) throw INVALID
     const lines = []
-
-    const container = quota.data || quota
-    const limits = container.limits || container
-    if (!Array.isArray(limits) || limits.length === 0) {
-      lines.push(ctx.line.badge({ label: "Session", text: "No usage data", color: "#a3a3a3" }))
-      return { plan, lines }
+    const quota = limits.filter((item) => ["TOKENS_LIMIT", "CREDIT_LIMIT"].includes(item.type || item.name))
+      .sort((a, b) => (duration(a) || Infinity) - (duration(b) || Infinity))
+    for (const item of quota) lines.push(quotaLine(ctx, item))
+    const mcp = limits.find((item) => (item.type || item.name) === "TIME_LIMIT")
+    if (mcp) {
+      const used = number(mcp.currentValue)
+      const limit = number(mcp.usage)
+      if (used === null || limit === null || used < 0 || limit < 0) throw INVALID
+      lines.push(ctx.line.progress({ label: "Web Searches", used, limit,
+        format: { kind: "count", suffix: "searches" }, periodDurationMs: MONTH_MS,
+        resetsAt: reset(ctx, mcp, MONTH_MS) }))
     }
+    if (!lines.length) lines.push(ctx.line.badge({ label: "Status", text: "No usage data", color: "#a3a3a3" }))
 
-    const tokenLimit = findLimit(limits, "TOKENS_LIMIT", 3)
-
-    if (!tokenLimit) {
-      lines.push(ctx.line.badge({ label: "Session", text: "No usage data", color: "#a3a3a3" }))
-      return { plan, lines }
+    if (quota.some((item) => (item.type || item.name) === "CREDIT_LIMIT")) {
+      const now = new Date(ctx.nowIso)
+      const peak = now.getUTCDay() >= 1 && now.getUTCDay() <= 5 && now.getUTCHours() >= 6 && now.getUTCHours() < 10
+      lines.push(ctx.line.text({ label: "Quota rate", value: peak ? "Peak" : "Off-peak",
+        subtitle: "Peak: Mon-Fri 06:00-10:00 UTC" }))
     }
 
-    const used = typeof tokenLimit.percentage === "number" ? tokenLimit.percentage : 0
-    const resetsAt = tokenLimit.nextResetTime ? ctx.util.toIso(tokenLimit.nextResetTime) : undefined
-
-    const progressOpts = {
-      label: "Session",
-      used,
-      limit: 100,
-      format: { kind: "percent" },
-      periodDurationMs: PERIOD_MS,
+    let plan = clean(data.planName) || clean(data.plan) || clean(data.packageName)
+    if (!plan) {
+      try {
+        const sub = request(ctx, auth, auth.base + "/api/biz/subscription/list", 1500)
+        if (Array.isArray(sub.data) && sub.data.length) plan = clean(sub.data[0].productName)
+      } catch (_) { ctx.host.log.warn("Z.ai plan details unavailable") }
     }
-    if (resetsAt) {
-      progressOpts.resetsAt = resetsAt
+    if (auth.china) {
+      try {
+        const balance = request(ctx, auth, "https://www.bigmodel.cn/api/biz/account/query-customer-account-report", 3000)
+        const account = balance.data || {}
+        const available = number(account.availableBalance)
+        const value = available !== null ? available : number(account.balance)
+        if (value !== null) lines.push(ctx.line.text({ label: "Balance", value: "CNY " + value.toFixed(2) }))
+      } catch (_) { ctx.host.log.warn("BigModel balance unavailable") }
     }
-    lines.push(ctx.line.progress(progressOpts))
-
-    const weeklyTokenLimit = findLimit(limits, "TOKENS_LIMIT", 6)
-    if (weeklyTokenLimit) {
-      const weeklyUsed = Number.isFinite(weeklyTokenLimit.percentage) ? weeklyTokenLimit.percentage : 0
-      const weeklyResetsAt = weeklyTokenLimit.nextResetTime ? ctx.util.toIso(weeklyTokenLimit.nextResetTime) : undefined
-
-      const weeklyOpts = {
-        label: "Weekly",
-        used: weeklyUsed,
-        limit: 100,
-        format: { kind: "percent" },
-        periodDurationMs: WEEK_MS,
-      }
-      if (weeklyResetsAt) {
-        weeklyOpts.resetsAt = weeklyResetsAt
-      }
-      lines.push(ctx.line.progress(weeklyOpts))
-    }
-
-    const timeLimit = findLimit(limits, "TIME_LIMIT")
-
-    if (timeLimit) {
-      const webUsed = typeof timeLimit.currentValue === "number" ? timeLimit.currentValue : 0
-      const webTotal = typeof timeLimit.usage === "number" ? timeLimit.usage : 0
-      const now = new Date()
-      const nextMonth = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 1))
-      const webResetsAt = timeLimit.nextResetTime
-        ? ctx.util.toIso(timeLimit.nextResetTime)
-        : nextMonth.toISOString()
-
-      const webOpts = {
-        label: "Web Searches",
-        used: webUsed,
-        limit: webTotal,
-        format: { kind: "count", suffix: "/ " + webTotal },
-        periodDurationMs: MONTH_MS,
-      }
-      if (webResetsAt) {
-        webOpts.resetsAt = webResetsAt
-      }
-      lines.push(ctx.line.progress(webOpts))
-    }
-
-    return { plan, lines }
+    return { displayName: "Z.ai", source: "api", plan: plan || undefined, lines }
   }
 
   globalThis.__openusage_plugin = { id: "zai", probe }

package/plugins/zai/plugin.json

@@ -8,9 +8,12 @@
   "brandColor": "#2D2D2D",
   "supportedModes": ["api"],
   "autoMode": "api",
+  "envVars": ["ZAI_API_KEY", "Z_AI_API_KEY", "GLM_API_KEY", "BIGMODEL_API_KEY", "ZHIPU_API_KEY", "Z_AI_REGION", "Z_AI_USAGE_SCOPE", "Z_AI_ORGANIZATION", "Z_AI_PROJECT"],
   "lines": [
     { "type": "progress", "label": "Session", "scope": "overview", "primaryOrder": 1 },
     { "type": "progress", "label": "Weekly", "scope": "overview" },
-    { "type": "progress", "label": "Web Searches", "scope": "overview" }
+    { "type": "progress", "label": "Web Searches", "scope": "overview" },
+    { "type": "text", "label": "Quota rate", "scope": "detail" },
+    { "type": "text", "label": "Balance", "scope": "detail" }
   ]
 }

package/plugins/zenmux/icon.svg

@@ -0,0 +1,3 @@
+<svg width="160" height="160" viewBox="0 0 160 160" xmlns="http://www.w3.org/2000/svg" fill="none">
+  <path fill="black" fill-rule="evenodd" clip-rule="evenodd" d="m77.77641.42146c8.25008-.31709 24.94679.77406 38.30399 12.76765 10.95668 9.83841 14.73253 28.07814 12.17937 42.22111-2.34107 12.96444-7.85766 23.57181-5.69622 33.3933 2.16028 9.82161 7.65832 14.66392 12.33467 16.69671 4.51873 1.96441 8.88564 1.37451 8.05468 5.10748-.83212 3.73181-6.48199 5.10748-10.60784 5.10748-2.26226 0-9.10352-.5899-12.1388-2.55432-3.58694-2.32137-4.38661-4.40168-5.75185-6.07404-.23179-.28394-.6409-.08692-.58643.27583.62235 4.1131 2.33759 11.09459 5.12023 15.42326 2.25183 3.5035 3.18247 6.05781 8.34094 10.37952 5.15963 4.32055 7.56908 8.24938 2.55316 11.03201-4.45615 2.47087-14.14262-2.58561-19.83884-8.83928-5.12753-5.629-8.69708-12.57225-10.10891-17.08982-.75471-2.41524-1.5108-6.57007-2.26586-9.96926-.09921-.44619-.71113-.37434-.72434.08344-.25068 8.64922-1.61024 16.90903-3.59795 25.76454-1.43118 6.37536-4.91092 14.14262-8.05375 18.85722-3.83229 5.74837-9.52132 7.54242-13.75009 5.97089-3.38204-1.25746-.98209-5.53165 0-9.23217.98221-3.69936 2.94708-11.4388 4.27025-19.91765 1.19766-7.67454 1.51463-15.27144.98128-22.46965-.03303-.43924-.70765-.50646-.84429-.08808-1.10227 3.37601-3.18003 8.97256-4.69582 12.37639-3.16149 7.09855-5.50106 10.21379-11.98339 17.67741-5.82962 6.71378-22.59621 16.20671-24.74976 6.87603-.58932-2.55316 2.49811-3.67154 5.34541-5.89324 4.27999-3.33892 7.85661-9.26462 11.24769-16.49992 3.0449-6.49705 4.59256-12.78202 4.82933-16.79429.02237-.38709-.46335-.53312-.68134-.21325-1.40951 2.06756-3.48507 4.86526-5.77097 7.18547-3.81861 3.87668-8.05398 7.86693-12.96571 9.82207-7.89718 3.14306-15.95046.98163-15.36172-4.71459.49209-4.75748 5.80412-3.77237 12.41684-10.98681 6.4821-7.07154 8.64215-12.5726 9.03503-18.66205.31384-4.87163-4.45186-16.43398-6.87452-21.60682-3.86312-8.25019-6.71795-31.66462 4.9108-46.75062 14.53551-18.85687 32.01705-18.46573 37.12476-18.66193Zm-22.67525 32.97562c-5.40822 0-8.11251 4.15123-8.11262 9.27157 0 5.12057 3.00468 9.27157 8.11262 9.27157s8.11262-4.151 8.11262-9.27157c-.00012-5.12034-2.7044-9.27157-8.11262-9.27157Zm44.03996 0c-5.40822 0-8.11251 4.15123-8.11262 9.27157 0 5.12057 3.00468 9.27157 8.11262 9.27157s8.11274-4.151 8.11274-9.27157c0-5.12034-2.70452-9.27157-8.11274-9.27157Z"/>
+</svg>

package/plugins/zenmux/plugin.js

@@ -0,0 +1,102 @@
+(function () {
+  var BASE = "https://zenmux.ai/api/v1/management";
+
+  function clean(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+  }
+
+  function env(ctx, name) {
+    try {
+      return clean(ctx.host.env.get(name));
+    } catch (_) {
+      return null;
+    }
+  }
+
+  function apiKey(ctx) {
+    return clean(ctx.provider && ctx.provider.apiKey) || env(ctx, "ZENMUX_MANAGEMENT_API_KEY") || env(ctx, "ZENMUX_API_KEY");
+  }
+
+  function requestJson(ctx, path, key, timeoutMs) {
+    var result = ctx.util.requestJson({
+      method: "GET",
+      url: BASE + "/" + path,
+      headers: { Authorization: "Bearer " + key, Accept: "application/json" },
+      timeoutMs: timeoutMs || 15000,
+    });
+    if (ctx.util.isAuthStatus(result.resp.status)) throw "ZenMux Management API key invalid or expired.";
+    if (result.resp.status < 200 || result.resp.status >= 300) throw "ZenMux Management API returned HTTP " + result.resp.status + ".";
+    if (!result.json || typeof result.json !== "object") throw "Failed to parse ZenMux response.";
+    return result.json;
+  }
+
+  function iso(ctx, value) {
+    return value ? ctx.util.toIso(value) : null;
+  }
+
+  function title(value) {
+    var v = String(value || "").trim();
+    return v ? v.charAt(0).toUpperCase() + v.slice(1) : "";
+  }
+
+  function amount(value) {
+    var n = number(value);
+    if (n === null) return null;
+    return Math.abs(n - Math.round(n)) < 0.001 ? String(Math.round(n)) : n.toFixed(2);
+  }
+
+  function number(raw) {
+    if ((typeof raw !== "number" && typeof raw !== "string") || String(raw).trim() === "") return null;
+    var n = Number(raw);
+    return Number.isFinite(n) ? n : null;
+  }
+
+  function quotaLine(ctx, label, quota, minutes) {
+    if (!quota) return null;
+    var percent = number(quota.usage_percentage);
+    if (percent === null || percent < 0) throw "Invalid ZenMux usage percentage.";
+    var opts = {
+      label: label,
+      used: Math.max(0, Math.min(100, percent * 100)),
+      limit: 100,
+      format: { kind: "percent" },
+      periodDurationMs: minutes * 60 * 1000,
+    };
+    if (amount(quota.used_flows) !== null && amount(quota.max_flows) !== null) opts.detail = amount(quota.used_flows) + " / " + amount(quota.max_flows) + " flows";
+    var reset = iso(ctx, quota.resets_at);
+    if (reset) opts.resetsAt = reset;
+    return ctx.line.progress(opts);
+  }
+
+  function probe(ctx) {
+    var key = apiKey(ctx);
+    if (!key) throw "Missing ZenMux Management API key. Set ZENMUX_MANAGEMENT_API_KEY, ZENMUX_API_KEY, or provider apiKey.";
+    var sub = requestJson(ctx, "subscription/detail", key);
+    if (!sub.success || !sub.data) throw "ZenMux subscription response reported failure.";
+    var data = sub.data;
+    var plan = data.plan && title(data.plan.tier);
+    var status = title(data.account_status);
+    var planLabel = plan ? plan + " plan" : null;
+    if (status && status.toLowerCase() !== "healthy") planLabel = planLabel ? planLabel + " · " + status : status;
+    var metrics = [
+      quotaLine(ctx, "5-hour quota", data.quota_5_hour, 5 * 60),
+      quotaLine(ctx, "Weekly quota", data.quota_7_day, 7 * 24 * 60),
+    ].filter(function (line) { return line !== null; });
+    var expiresAt = iso(ctx, data.plan && data.plan.expires_at);
+    if (expiresAt) metrics.push(ctx.line.text({ label: "Subscription expires", value: expiresAt }));
+
+    try {
+      var bal = requestJson(ctx, "payg/balance", key, 3000);
+      if (bal.success && bal.data && number(bal.data.total_credits) !== null && String(bal.data.currency || "").toUpperCase() === "USD") {
+        metrics.push(ctx.line.text({ label: "PAYG Balance", value: "$" + number(bal.data.total_credits).toFixed(2) }));
+      }
+    } catch (error) {
+      ctx.host.log.warn("ZenMux PAYG balance request failed: " + String(error));
+    }
+
+    if (!metrics.length) throw "ZenMux returned no measurable usage or balance.";
+    return { displayName: "ZenMux", source: "api", plan: planLabel, lines: metrics };
+  }
+
+  globalThis.__openusage_plugin = { id: "zenmux", probe: probe };
+})();

package/plugins/zenmux/plugin.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "id": "zenmux",
+  "name": "ZenMux",
+  "version": "0.1.0",
+  "entry": "plugin.js",
+  "enabledByDefault": false,
+  "supportedModes": [
+    "api"
+  ],
+  "autoMode": "api",
+  "usageDashboardUrl": "https://zenmux.ai/platform/management",
+  "links": [
+    {
+      "label": "Dashboard",
+      "url": "https://zenmux.ai/platform/management"
+    }
+  ],
+  "envVars": [
+    "ZENMUX_MANAGEMENT_API_KEY",
+    "ZENMUX_API_KEY"
+  ]
+}