@1930dev/opencode-usage 0.3.1 → 0.3.3

package/README.md

@@ -123,7 +123,8 @@ Normalized percentage of budget consumed per provider, from these sources (in pr
    - `github-copilot`: premium requests entitlement (7000/mo)
    - `opencode-go` (Zen): rolling 5h / weekly / monthly % (binding window)
    - `openrouter`: credits used / total credits
-   - `zai`: coding plan quota
+   - `orcarouter`: spend since top-up; a per-key credit cap turns into a %
+   - `zai`: coding plan quota (needs an active GLM coding plan)
 
 2. **Documented limits** — published quotas, used when the provider reports none.
    Each one is read against the period it resets on: a daily limit against today,
@@ -138,10 +139,11 @@ Normalized percentage of budget consumed per provider, from these sources (in pr
    records tokens and requests; a credit and a neuron are the provider's own
    unit, derived from the model and the request by a rule it does not record.
    Give them a line in `budgets.json` to get a percentage in USD instead.
-   - `cloudflare-workers-ai`: 100k neurons/day (free tier)
-   - `nvidia`: 1000 credits/month (free tier)
-   - `orcarouter`: undocumented
-   - `snowflake-cortex`: 100 credits/month (paid)
+   - `cloudflare-workers-ai`: 10k neurons/day (free tier, resets 00:00 UTC)
+   - `nvidia`: credit allowance retired — the trial is rate-limited per model
+   - `opencode`: no spend API for API keys
+   - `snowflake-cortex`: 100 credits/month, billed per token
+   - `zai`: no coding plan on this key
 
 3. **budgets.json** — your monthly USD per provider, read against what the
    provider cost so far this calendar month:

package/dist/cli.js

@@ -328,6 +328,36 @@ async function fetchAmd(key) {
   }
 }
 
+// packages/core/src/quota/orcarouter.ts
+var CENTS_PER_USD = 100;
+var NO_CAP = 1e6;
+function parseOrcaRouter(usage, subscription) {
+  const spent = (usage.total_usage ?? 0) / CENTS_PER_USD;
+  const hard = subscription.hard_limit_usd ?? 0;
+  const soft = subscription.soft_limit_usd ?? 0;
+  const cap = hard > 0 && hard < NO_CAP ? hard : soft > 0 && soft < NO_CAP ? soft : 0;
+  const capped = cap > 0;
+  const pct = capped ? spent / cap * 100 : 0;
+  return {
+    provider: "orcarouter",
+    ok: true,
+    detail: `$${spent.toFixed(2)} spent`,
+    windows: [{ label: "spend", percentUsed: pct, detail: `$${spent.toFixed(2)}` }],
+    budget: capped ? { percentUsed: pct, label: `$${cap}` } : undefined,
+    raw: { usage, subscription }
+  };
+}
+async function fetchOrcaRouter(key) {
+  try {
+    const headers = { Authorization: `Bearer ${key}`, Accept: "application/json" };
+    const usage = await getJson("https://api.orcarouter.ai/v1/dashboard/billing/usage", headers);
+    const subscription = await getJson("https://api.orcarouter.ai/v1/dashboard/billing/subscription", headers);
+    return parseOrcaRouter(usage, subscription);
+  } catch (err) {
+    return { provider: "orcarouter", ok: false, detail: err.message, windows: [] };
+  }
+}
+
 // packages/core/src/providers.ts
 var TTL_MS = 15 * 60 * 1000;
 async function readCache() {
@@ -350,7 +380,8 @@ var FETCHERS = {
   openrouter: fetchOpenRouter,
   "github-copilot": fetchCopilot,
   zai: fetchZai,
-  amd: fetchAmd
+  amd: fetchAmd,
+  orcarouter: fetchOrcaRouter
 };
 async function providerStatuses(opts) {
   const auth = await readAuth();
@@ -638,10 +669,10 @@ var PROVIDER_LIMITS = [
     provider: "cloudflare-workers-ai",
     unit: "neurons",
     period: "day",
-    limit: 1e5,
+    limit: 1e4,
     tier: "free",
-    source: "https://developers.cloudflare.com/workers-ai/platform/limits/",
-    note: "A neuron is Cloudflare's own unit, per model. Not measurable from tokens."
+    source: "https://developers.cloudflare.com/workers-ai/platform/pricing/",
+    note: "10,000 neurons/day free, resets at 00:00 UTC. A neuron is Cloudflare's own unit, per model. Live usage needs an API token with the Analytics read scope; the Workers AI key does not carry one."
   },
   {
     provider: "digitalocean",
@@ -674,10 +705,19 @@ var PROVIDER_LIMITS = [
     provider: "nvidia",
     unit: "credits",
     period: "month",
-    limit: 1000,
+    limit: 0,
     tier: "free",
-    source: "https://build.nvidia.com/",
-    note: "NIM free tier ~1000 credits/month. A credit varies by model."
+    source: "https://forums.developer.nvidia.com/t/request-more-4-000-credits-option-on-build-nvidia-com/344567",
+    note: "The credit allowance was retired; build.nvidia.com now rate-limits the trial per model (about 40 RPM, unpublished, shown in the UI header). No usage endpoint exists."
+  },
+  {
+    provider: "opencode",
+    unit: "tokens",
+    period: "month",
+    limit: 0,
+    tier: "unknown",
+    source: "https://opencode.ai/docs/go/",
+    note: "The opencode gateway exposes no spend API to its API key; the dashboard balance needs a browser session. Go usage is measured through the opencode-go provider instead."
   },
   {
     provider: "orcarouter",
@@ -685,8 +725,8 @@ var PROVIDER_LIMITS = [
     period: "day",
     limit: 0,
     tier: "unknown",
-    source: "unknown",
-    note: "Proxy service. No public limits documented."
+    source: "https://docs.orcarouter.ai/operations/billing-and-usage",
+    note: "Pay-per-token at upstream rates with no markup. A per-key credit cap turns into a live budget; without one there is nothing to exhaust. Free models are rate-limited with unpublished numbers."
   },
   {
     provider: "snowflake-cortex",
@@ -694,8 +734,17 @@ var PROVIDER_LIMITS = [
     period: "month",
     limit: 100,
     tier: "paid",
-    source: "https://docs.snowflake.com/en/user-guide/snowflake-cortex",
-    note: "Credits follow warehouse time, not tokens. Not measurable from usage."
+    source: "https://docs.snowflake.com/en/sql-reference/account-usage/cortex_ai_functions_usage_history",
+    note: "Cortex AI Functions bill per token (credits per million tokens, Service Consumption Table). Usage lives in ACCOUNT_USAGE views, which the API key alone cannot read."
+  },
+  {
+    provider: "zai",
+    unit: "tokens",
+    period: "day",
+    limit: 0,
+    tier: "unknown",
+    source: "https://openusage.sh/docs/providers/zai/",
+    note: "The quota monitor answers only keys with an active GLM coding plan; this key reports none, so the endpoint returns an error. With a plan, the monitor exposes a rolling 5h window plus weekly and monthly limits."
   }
 ];
 var MEASURED_UNITS = new Set(["tokens", "requests"]);

package/dist/tui.js

@@ -318,6 +318,36 @@ async function fetchAmd(key) {
   }
 }
 
+// packages/core/src/quota/orcarouter.ts
+var CENTS_PER_USD = 100;
+var NO_CAP = 1e6;
+function parseOrcaRouter(usage, subscription) {
+  const spent = (usage.total_usage ?? 0) / CENTS_PER_USD;
+  const hard = subscription.hard_limit_usd ?? 0;
+  const soft = subscription.soft_limit_usd ?? 0;
+  const cap = hard > 0 && hard < NO_CAP ? hard : soft > 0 && soft < NO_CAP ? soft : 0;
+  const capped = cap > 0;
+  const pct = capped ? spent / cap * 100 : 0;
+  return {
+    provider: "orcarouter",
+    ok: true,
+    detail: `$${spent.toFixed(2)} spent`,
+    windows: [{ label: "spend", percentUsed: pct, detail: `$${spent.toFixed(2)}` }],
+    budget: capped ? { percentUsed: pct, label: `$${cap}` } : undefined,
+    raw: { usage, subscription }
+  };
+}
+async function fetchOrcaRouter(key) {
+  try {
+    const headers = { Authorization: `Bearer ${key}`, Accept: "application/json" };
+    const usage = await getJson("https://api.orcarouter.ai/v1/dashboard/billing/usage", headers);
+    const subscription = await getJson("https://api.orcarouter.ai/v1/dashboard/billing/subscription", headers);
+    return parseOrcaRouter(usage, subscription);
+  } catch (err) {
+    return { provider: "orcarouter", ok: false, detail: err.message, windows: [] };
+  }
+}
+
 // packages/core/src/providers.ts
 var TTL_MS = 15 * 60 * 1000;
 async function readCache() {
@@ -340,7 +370,8 @@ var FETCHERS = {
   openrouter: fetchOpenRouter,
   "github-copilot": fetchCopilot,
   zai: fetchZai,
-  amd: fetchAmd
+  amd: fetchAmd,
+  orcarouter: fetchOrcaRouter
 };
 async function providerStatuses(opts) {
   const auth = await readAuth();
@@ -403,10 +434,10 @@ var PROVIDER_LIMITS = [
     provider: "cloudflare-workers-ai",
     unit: "neurons",
     period: "day",
-    limit: 1e5,
+    limit: 1e4,
     tier: "free",
-    source: "https://developers.cloudflare.com/workers-ai/platform/limits/",
-    note: "A neuron is Cloudflare's own unit, per model. Not measurable from tokens."
+    source: "https://developers.cloudflare.com/workers-ai/platform/pricing/",
+    note: "10,000 neurons/day free, resets at 00:00 UTC. A neuron is Cloudflare's own unit, per model. Live usage needs an API token with the Analytics read scope; the Workers AI key does not carry one."
   },
   {
     provider: "digitalocean",
@@ -439,10 +470,19 @@ var PROVIDER_LIMITS = [
     provider: "nvidia",
     unit: "credits",
     period: "month",
-    limit: 1000,
+    limit: 0,
     tier: "free",
-    source: "https://build.nvidia.com/",
-    note: "NIM free tier ~1000 credits/month. A credit varies by model."
+    source: "https://forums.developer.nvidia.com/t/request-more-4-000-credits-option-on-build-nvidia-com/344567",
+    note: "The credit allowance was retired; build.nvidia.com now rate-limits the trial per model (about 40 RPM, unpublished, shown in the UI header). No usage endpoint exists."
+  },
+  {
+    provider: "opencode",
+    unit: "tokens",
+    period: "month",
+    limit: 0,
+    tier: "unknown",
+    source: "https://opencode.ai/docs/go/",
+    note: "The opencode gateway exposes no spend API to its API key; the dashboard balance needs a browser session. Go usage is measured through the opencode-go provider instead."
   },
   {
     provider: "orcarouter",
@@ -450,8 +490,8 @@ var PROVIDER_LIMITS = [
     period: "day",
     limit: 0,
     tier: "unknown",
-    source: "unknown",
-    note: "Proxy service. No public limits documented."
+    source: "https://docs.orcarouter.ai/operations/billing-and-usage",
+    note: "Pay-per-token at upstream rates with no markup. A per-key credit cap turns into a live budget; without one there is nothing to exhaust. Free models are rate-limited with unpublished numbers."
   },
   {
     provider: "snowflake-cortex",
@@ -459,8 +499,17 @@ var PROVIDER_LIMITS = [
     period: "month",
     limit: 100,
     tier: "paid",
-    source: "https://docs.snowflake.com/en/user-guide/snowflake-cortex",
-    note: "Credits follow warehouse time, not tokens. Not measurable from usage."
+    source: "https://docs.snowflake.com/en/sql-reference/account-usage/cortex_ai_functions_usage_history",
+    note: "Cortex AI Functions bill per token (credits per million tokens, Service Consumption Table). Usage lives in ACCOUNT_USAGE views, which the API key alone cannot read."
+  },
+  {
+    provider: "zai",
+    unit: "tokens",
+    period: "day",
+    limit: 0,
+    tier: "unknown",
+    source: "https://openusage.sh/docs/providers/zai/",
+    note: "The quota monitor answers only keys with an active GLM coding plan; this key reports none, so the endpoint returns an error. With a plan, the monitor exposes a rolling 5h window plus weekly and monthly limits."
   }
 ];
 var MEASURED_UNITS = new Set(["tokens", "requests"]);
@@ -580,7 +629,8 @@ async function getUsageSnapshot(sinceMs, groupBy, includePct) {
 }
 // packages/plugin/layout.ts
 var SIZE_WIDTH = { medium: 60, large: 88, xlarge: 116 };
-var PADDING = 1;
+var PADDING_X = 2;
+var PADDING_Y = 1;
 var WIDE_BAR = 12;
 var COMPACT_BAR = 6;
 var BUDGET_FIXED = WIDE_BAR + 6;
@@ -680,7 +730,7 @@ function barColor(pct, p) {
 }
 function chooseSize(terminal, needed) {
   const held = (s) => terminal >= SIZE_WIDTH[s] + 2;
-  if (held("large") && SIZE_WIDTH.large - PADDING * 2 >= needed)
+  if (held("large") && SIZE_WIDTH.large - PADDING_X * 2 >= needed)
     return "large";
   if (held("xlarge"))
     return "xlarge";
@@ -715,7 +765,7 @@ function terminalWidth(api) {
 }
 function innerWidth(api, needed) {
   const terminal = terminalWidth(api);
-  return Math.min(SIZE_WIDTH[chooseSize(terminal, needed)], terminal - 2) - PADDING * 2;
+  return Math.min(SIZE_WIDTH[chooseSize(terminal, needed)], terminal - 2) - PADDING_X * 2;
 }
 function neededWidth(snapshot) {
   const labels = Object.values(snapshot.pct ?? {}).map((b) => compactLabel(b.label ?? b.source).length);
@@ -726,7 +776,8 @@ function Frame(props) {
   return /* @__PURE__ */ jsxs("box", {
     flexDirection: "column",
     flexShrink: 0,
-    padding: PADDING,
+    paddingX: PADDING_X,
+    paddingY: PADDING_Y,
     children: [
       /* @__PURE__ */ jsxs("box", {
         flexDirection: "row",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1930dev/opencode-usage",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Usage tracking, budget percentages and model ranking for opencode — CLI plus a /usage TUI plugin",
   "type": "module",
   "bin": {