@jeffreyjyz/opencode-command-code 0.5.16 → 0.5.19

package/dist/cli.d.ts

@@ -10,6 +10,9 @@ export declare function mpcCandidates(env?: Record<string, string | undefined>):
 /** Same lookup for ocuse, the OpenCode Go/Zen reader shipped in the cmd-usage
  * crate: `OCUSE_BIN` wins when set, then the homebrew fallbacks. */
 export declare function ocuseCandidates(env?: Record<string, string | undefined>): string[];
+/** Same lookup for arkuse, the Volcengine ARK Agent Plan reader in the same
+ * crate: `ARKUSE_BIN` wins when set, then the homebrew fallbacks. */
+export declare function arkuseCandidates(env?: Record<string, string | undefined>): string[];
 /** Shell-words split: whitespace-separated, with single/double quoting and
  * backslash escapes ("--tz +05:30", arg='a b'). Unterminated quotes close at
  * end of input. */
@@ -28,6 +31,10 @@ export declare function buildMpcArgs(arg: string): string[];
  * watch loop and would never return, so empty input never passes through.
  */
 export declare function ocuseArgs(arg: string | undefined): string;
+/** The arg the arkuse_usage tool and the /arkuse-usage dialog pass on: the
+ *  agent's (or slash) args when given, else `-1`. A bare arkuse is the live
+ *  watch loop and would never return. */
+export declare function arkuseArgs(arg: string | undefined): string;
 export type RunOptions = {
     signal?: AbortSignal;
     /** Extra env for the child (CMD_API_KEY when the plugin resolved one). */
@@ -58,3 +65,7 @@ export declare function runMpc(arg: string | readonly string[], opts?: RunOption
  * hint is the same brew formula. A string arg is shell-split, an array used
  * as-is. */
 export declare function runOcuse(arg: string | readonly string[], opts?: RunOptions): Promise<string>;
+/** Run arkuse and return its plain-text stdout (Volcengine ARK usage). Same
+ *  contract as runCmduse; arkuse ships in the cmd-usage crate, so its install
+ *  hint is the same brew formula. */
+export declare function runArkuse(arg: string | readonly string[], opts?: RunOptions): Promise<string>;

package/dist/constants/binaries.d.ts

@@ -4,3 +4,5 @@ export declare const CMDUSE_BIN_CANDIDATES: readonly string[];
 export declare const MPC_BIN_CANDIDATES: readonly string[];
 /** Fallback lookup paths for ocuse (OCUSE_BIN wins when set). */
 export declare const OCUSE_BIN_CANDIDATES: readonly string[];
+/** Fallback lookup paths for arkuse (ARKUSE_BIN wins when set). */
+export declare const ARKUSE_BIN_CANDIDATES: readonly string[];

package/dist/constants/providers.d.ts

@@ -11,12 +11,16 @@ export declare const GO_PROVIDER_ID = "opencode-go";
 /** OpenCode Zen provider id and its `opencode-zen` alias prefix. */
 export declare const ZEN_PROVIDER_ID = "opencode";
 export declare const ZEN_PROVIDER_PREFIX = "opencode-zen";
+/** Volcengine ARK Agent Plan provider id (what opencode records for its rows). */
+export declare const ARK_PROVIDER_ID = "agent-plan";
 /** TUI plugin id (stable contract; test/tui.test.ts pins it). */
 export declare const TUI_ID = "command-code.tui";
 /** The v2 /cmd-usage slash command id (registered and bound in tui.tsx). */
 export declare const CMD_USAGE_COMMAND_ID = "command-code.cmd-usage";
 /** The v2 /ocuse-usage slash command id (registered and bound in tui.tsx). */
 export declare const OCUSE_USAGE_COMMAND_ID = "command-code.ocuse-usage";
+/** The v2 /arkuse-usage slash command id (registered and bound in tui.tsx). */
+export declare const ARKUSE_USAGE_COMMAND_ID = "command-code.arkuse-usage";
 /** The cmd_usage tool description, shared by the v1 and v2 halves. */
 export declare const TOOL_DESCRIPTION = "Fetch live Command Code plan/usage: plan name, monthly credits, 5-hour & weekly windows, billing-period summary. Pass arg='plans' for the plan comparison table only, or extra cmduse flags (e.g. '--tz +05:30 daily').";
 /** The mpc_prices tool description, shared by the v1 and v2 halves. */
@@ -27,6 +31,10 @@ export declare const MPC_TOOL_ARG_DESCRIPTION = "Optional mpc flags: '--model <r
 export declare const OCUSE_TOOL_DESCRIPTION = "Fetch live OpenCode Go/Zen usage: the account's window meters, per-model spend against limits, 5-hour & weekly windows, billing-period summary. Defaults to the one-shot dashboard; pass extra ocuse flags for more (e.g. '--plan go-plus', 'daily', '--json').";
 /** The ocuse_usage `arg` description, shared by the v1 and v2 halves. */
 export declare const OCUSE_TOOL_ARG_DESCRIPTION = "Optional: extra ocuse flags (e.g. '--plan go-plus', 'daily', '--json'); empty means the one-shot dashboard";
+/** The arkuse_usage tool description, shared by the v1 and v2 halves. */
+export declare const ARKUSE_TOOL_DESCRIPTION = "Fetch live Volcengine ARK Agent Plan usage in AFP: the plan's 5-hour/weekly/monthly meters from arkcli, this machine's per-model AFP, and the reconciliation between them. Defaults to the one-shot dashboard; pass extra arkuse flags for more (e.g. 'daily', '--plan medium', '--json').";
+/** The arkuse_usage `arg` description, shared by the v1 and v2 halves. */
+export declare const ARKUSE_TOOL_ARG_DESCRIPTION = "Optional: extra arkuse flags (e.g. '--plan medium', '--profile <name>', 'daily', '--json'); empty means the one-shot dashboard";
 export type Lane = {
     id: "command-code-anthropic" | "command-code-openai";
     name: string;

package/dist/constants/timing.d.ts

@@ -11,3 +11,8 @@ export declare const MODELS_CACHE_TTL_MS: number;
 export declare const CATALOG_CACHE_TTL_MS: number;
 /** Re-read window for the sidebar colour prefs file (src/sidebar/prefs.ts). */
 export declare const PREFS_CACHE_MS = 5000;
+/** Process-lifetime cache for the ARK sidebar snapshot: every `arkuse` run
+ * shells out to `arkcli` for the plan meters, so polling it at the 5s cadence
+ * would be one control-plane round-trip per tick. A minute keeps the meters
+ * fresh enough while the store-backed rows still update on the poll. */
+export declare const ARK_SNAPSHOT_TTL_MS = 60000;

package/dist/index.js

@@ -2414,7 +2414,7 @@ function superRefine(fn) {
 // package.json
 var package_default = {
   name: "@jeffreyjyz/opencode-command-code",
-  version: "0.5.16",
+  version: "0.5.19",
   description: "Command Code provider + usage dashboard for opencode: two providers (Anthropic wire for Claude, OpenAI wire for everything else) against api.commandcode.ai, live model list, plan gating, /cmd-usage. Requires the cmduse CLI for usage rendering.",
   type: "module",
   main: "dist/index.js",
@@ -3242,6 +3242,11 @@ var OCUSE_BIN_CANDIDATES = [
   "/opt/homebrew/bin/ocuse",
   "/usr/local/bin/ocuse"
 ];
+var ARKUSE_BIN_CANDIDATES = [
+  "arkuse",
+  "/opt/homebrew/bin/arkuse",
+  "/usr/local/bin/arkuse"
+];
 
 // src/constants/cli.ts
 var DEFAULT_ARGS = ["-1", "--plain"];
@@ -3273,6 +3278,11 @@ function ocuseCandidates(env = process.env) {
   return candidates.filter((bin) => Boolean(bin));
 }
 var OCUSE_CANDIDATES = ocuseCandidates();
+function arkuseCandidates(env = process.env) {
+  const candidates = [env.ARKUSE_BIN, ...ARKUSE_BIN_CANDIDATES];
+  return candidates.filter((bin) => Boolean(bin));
+}
+var ARKUSE_CANDIDATES = arkuseCandidates();
 function splitCliArgs(input) {
   const out = [];
   let cur = "";
@@ -3328,6 +3338,9 @@ function buildMpcArgs(arg) {
 function ocuseArgs(arg) {
   return arg !== undefined && arg.trim() !== "" ? arg : "-1";
 }
+function arkuseArgs(arg) {
+  return arg !== undefined && arg.trim() !== "" ? arg : "-1";
+}
 function stderrTail(text) {
   const lines = text.trimEnd().split(`
 `);
@@ -3428,6 +3441,21 @@ async function runOcuse(arg, opts = {}) {
   }
   throw new Error(`ocuse binary not found (install: brew install JeffreyJYZ/tap/cmduse)${last instanceof Error && last.message !== last.name ? ` \u2014 ${last.message}` : ""}`, { cause: last });
 }
+async function runArkuse(arg, opts = {}) {
+  const args = resolveArgs(arg, splitCliArgs);
+  const candidates = opts.candidates ?? ARKUSE_CANDIDATES;
+  let last;
+  for (const bin of candidates) {
+    try {
+      return await runOnce(bin, args, opts, "arkuse");
+    } catch (e) {
+      last = e;
+      if (e?.code !== "ENOENT")
+        throw e;
+    }
+  }
+  throw new Error(`arkuse binary not found (install: brew install JeffreyJYZ/tap/cmduse)${last instanceof Error && last.message !== last.name ? ` \u2014 ${last.message}` : ""}`, { cause: last });
+}
 
 // src/constants/models.ts
 var MODEL_CAPABILITIES = {
@@ -3458,6 +3486,8 @@ var MPC_TOOL_DESCRIPTION = "Per-model price comparison: what a model costs per r
 var MPC_TOOL_ARG_DESCRIPTION = "Optional mpc flags: '--model <regex>' filters rows, '--minimal' | '--medium' | '--detail' set table width, '--json' for full structured rows, '--cc-plan'/'--oc-plan' pick a plan, '--usage' projects real usage";
 var OCUSE_TOOL_DESCRIPTION = "Fetch live OpenCode Go/Zen usage: the account's window meters, per-model spend against limits, 5-hour & weekly windows, billing-period summary. Defaults to the one-shot dashboard; pass extra ocuse flags for more (e.g. '--plan go-plus', 'daily', '--json').";
 var OCUSE_TOOL_ARG_DESCRIPTION = "Optional: extra ocuse flags (e.g. '--plan go-plus', 'daily', '--json'); empty means the one-shot dashboard";
+var ARKUSE_TOOL_DESCRIPTION = "Fetch live Volcengine ARK Agent Plan usage in AFP: the plan's 5-hour/weekly/monthly meters from arkcli, this machine's per-model AFP, and the reconciliation between them. Defaults to the one-shot dashboard; pass extra arkuse flags for more (e.g. 'daily', '--plan medium', '--json').";
+var ARKUSE_TOOL_ARG_DESCRIPTION = "Optional: extra arkuse flags (e.g. '--plan medium', '--profile <name>', 'daily', '--json'); empty means the one-shot dashboard";
 var LANES = [
   {
     id: "command-code-anthropic",
@@ -5015,6 +5045,26 @@ var commandCodeV2 = {
           };
         }
       });
+      editor.add({
+        name: "arkuse_usage",
+        description: ARKUSE_TOOL_DESCRIPTION,
+        input: {
+          type: "object",
+          properties: {
+            arg: {
+              type: "string",
+              description: ARKUSE_TOOL_ARG_DESCRIPTION
+            }
+          },
+          additionalProperties: false
+        },
+        async execute(input) {
+          const arg = typeof input?.arg === "string" ? input.arg : undefined;
+          return {
+            content: await runArkuse(arkuseArgs(arg))
+          };
+        }
+      });
     });
     let hasConnection = false;
     let connectionMs = 0;
@@ -5231,6 +5281,10 @@ var CommandCodePlugin = async (_input) => {
         description: "Show OpenCode Go/Zen usage: account meters and per-model spend",
         template: "Call the ocuse_usage tool and present its markdown output verbatim to the user. If the tool errors, the Go key is missing or has no subscription \u2014 usage still shows where the store has it. $ARGUMENTS"
       };
+      cfg.command["arkuse-usage"] = {
+        description: "Show Volcengine ARK Agent Plan usage: AFP meters per model",
+        template: "Call the arkuse_usage tool and present its markdown output verbatim to the user. If the tool errors, arkcli or its agent-plan profile is missing \u2014 usage still shows where the store has it. $ARGUMENTS"
+      };
     },
     provider: {
       id: ANTHROPIC.id,
@@ -5276,6 +5330,15 @@ var CommandCodePlugin = async (_input) => {
         async execute(args) {
           return runOcuse(ocuseArgs(args.arg));
         }
+      }),
+      arkuse_usage: tool({
+        description: ARKUSE_TOOL_DESCRIPTION,
+        args: {
+          arg: string2().optional().describe(ARKUSE_TOOL_ARG_DESCRIPTION)
+        },
+        async execute(args) {
+          return runArkuse(arkuseArgs(args.arg));
+        }
       })
     }
   };

package/dist/sidebar/ark.d.ts

@@ -0,0 +1,72 @@
+import { type SidebarRow } from "./rows";
+export interface ArkTotals {
+    afp: number;
+    requests: number;
+    tokensIn: number;
+    tokensOut: number;
+    cacheRead: number;
+}
+/** One of the plan's own meters (`arkuse`'s `account` block). Every field is
+ *  optional-ish by parsing: a malformed meter must not raise a cap flag. */
+export interface ArkMeter {
+    status: string;
+    percent: number;
+    used: number;
+    total: number;
+    resetAt?: number;
+}
+export interface ArkModel {
+    id: string;
+    coef: number;
+    fiveHour: ArkTotals;
+    weekly: ArkTotals;
+    month: ArkTotals;
+}
+/** This store's own view of one window (`arkuse`'s `windows` block): AFP against
+ *  the plan's published quota, the percentage that yields, and the boundary the
+ *  row counts down to. Present even when no meter answered, which is what keeps
+ *  a panel row from degrading to AFP alone. */
+export interface ArkWindow {
+    quota?: number;
+    percent?: number;
+    resetAt?: number;
+}
+export interface ArkUsage {
+    plan: string;
+    profile?: string;
+    periodStart?: number;
+    periodEndAt?: number;
+    summary: ArkTotals & {
+        yuan?: number;
+    };
+    fiveHour: ArkTotals;
+    weekly: ArkTotals;
+    month: ArkTotals;
+    daily?: ArkTotals;
+    windows?: {
+        fiveHour?: ArkWindow;
+        weekly?: ArkWindow;
+        monthly?: ArkWindow;
+    };
+    account?: {
+        fiveHour: ArkMeter;
+        daily?: ArkMeter;
+        weekly: ArkMeter;
+        monthly: ArkMeter;
+    };
+    accountError?: string;
+    afpPerRequest?: number;
+    reconciledPct?: number;
+    /** Keyed by model id, the same key the session's model id uses. */
+    models: Map<string, ArkModel>;
+}
+/** Parse `arkuse -1 --json`. A malformed body reads as an empty snapshot, never
+ *  as a fabricated plan. */
+export declare function parseArkJson(text: string): ArkUsage;
+/**
+ * The ARK panel: plan, the window meters, a rule, then the active model's own
+ * AFP for the period. `fallbackName` is the session's model id, which is the
+ * key `arkuse` uses, so the model block renders even when nothing else knows the
+ * name.
+ */
+export declare function arkRows(usage: ArkUsage | undefined, fallbackName?: string): SidebarRow[];

package/dist/sidebar/data.d.ts

@@ -1,4 +1,5 @@
 import { type OcPlan } from "../constants/sidebar";
+import { type ArkUsage } from "./ark";
 import { type ModelMeta, type Usage } from "./rows";
 import { type ZenUsage } from "./zen";
 /** Parse `cmduse -1 --json` into the usage snapshot. */
@@ -39,3 +40,10 @@ export declare function loadUsage(): Promise<Usage>;
  * caller then omits the panel.
  */
 export declare function loadZen(plan?: OcPlan): Promise<ZenUsage>;
+/**
+ * One Volcengine ARK snapshot from `arkuse -1 --json`: the plan's own meters
+ * (through `arkcli`) plus this store's AFP per model. Cached for a minute
+ * because the spawn costs a control-plane round-trip; throws when `arkuse` is
+ * missing or fails, and the caller then keeps the last snapshot.
+ */
+export declare function loadArk(): Promise<ArkUsage>;

package/dist/sidebar/useRows.d.ts

@@ -1,3 +1,4 @@
+import { type ArkUsage } from "./ark";
 import { type ModelMeta, type ModelUsage, type SidebarRow, type Usage } from "./rows";
 import { type ZenUsage } from "./zen";
 /**
@@ -6,7 +7,7 @@ import { type ZenUsage } from "./zen";
  * resolved the new session's model; it must not be read as someone else's, or
  * the panel blanks and refetches on every tab change.
  */
-export type SessionKind = "ours" | "go" | "zen" | "other" | "unknown";
+export type SessionKind = "ours" | "go" | "zen" | "ark" | "other" | "unknown";
 export declare function sessionKind(providerID: string | undefined): SessionKind;
 /** The section's title, per family. */
 export declare function panelTitle(kind: SessionKind): string;
@@ -40,4 +41,8 @@ export declare function seededMeta(): Map<string, ModelMeta>;
 export declare function rememberZen(usage: ZenUsage): void;
 /** The remembered Go/Zen snapshot, or undefined on the first panel. */
 export declare function seededZen(): ZenUsage | undefined;
+/** Keep an ARK snapshot for the next panel that needs it. */
+export declare function rememberArk(usage: ArkUsage): void;
+/** The remembered ARK snapshot, or undefined on the first panel. */
+export declare function seededArk(): ArkUsage | undefined;
 export declare function useRows(activeModelId: () => string | undefined, providerID: () => string | undefined, sessionID: () => string | undefined): import("solid-js").Accessor<SidebarRow[]>;

package/dist/tui.js

@@ -11,6 +11,7 @@ import { join } from "path";
 var CMDUSE_BIN_CANDIDATES = ["cmduse", "/opt/homebrew/bin/cmduse", "/usr/local/bin/cmduse"];
 var MPC_BIN_CANDIDATES = ["mpc", join(homedir(), ".bun/bin/mpc"), "/opt/homebrew/bin/mpc"];
 var OCUSE_BIN_CANDIDATES = ["ocuse", "/opt/homebrew/bin/ocuse", "/usr/local/bin/ocuse"];
+var ARKUSE_BIN_CANDIDATES = ["arkuse", "/opt/homebrew/bin/arkuse", "/usr/local/bin/arkuse"];
 
 // src/constants/cli.ts
 var DEFAULT_ARGS = ["-1", "--plain"];
@@ -37,6 +38,11 @@ function ocuseCandidates(env = process.env) {
   return candidates.filter((bin) => Boolean(bin));
 }
 var OCUSE_CANDIDATES = ocuseCandidates();
+function arkuseCandidates(env = process.env) {
+  const candidates = [env.ARKUSE_BIN, ...ARKUSE_BIN_CANDIDATES];
+  return candidates.filter((bin) => Boolean(bin));
+}
+var ARKUSE_CANDIDATES = arkuseCandidates();
 function splitCliArgs(input) {
   const out = [];
   let cur = "";
@@ -92,6 +98,9 @@ function buildMpcArgs(arg) {
 function ocuseArgs(arg) {
   return arg !== undefined && arg.trim() !== "" ? arg : "-1";
 }
+function arkuseArgs(arg) {
+  return arg !== undefined && arg.trim() !== "" ? arg : "-1";
+}
 function stderrTail(text) {
   const lines = text.trimEnd().split(`
 `);
@@ -203,15 +212,34 @@ async function runOcuse(arg, opts = {}) {
     cause: last
   });
 }
+async function runArkuse(arg, opts = {}) {
+  const args = resolveArgs(arg, splitCliArgs);
+  const candidates = opts.candidates ?? ARKUSE_CANDIDATES;
+  let last;
+  for (const bin of candidates) {
+    try {
+      return await runOnce(bin, args, opts, "arkuse");
+    } catch (e) {
+      last = e;
+      if (e?.code !== "ENOENT")
+        throw e;
+    }
+  }
+  throw new Error(`arkuse binary not found (install: brew install JeffreyJYZ/tap/cmduse)${last instanceof Error && last.message !== last.name ? ` \u2014 ${last.message}` : ""}`, {
+    cause: last
+  });
+}
 
 // src/constants/providers.ts
 var PROVIDER_ID_PREFIX = "command-code";
 var GO_PROVIDER_ID = "opencode-go";
 var ZEN_PROVIDER_ID = "opencode";
 var ZEN_PROVIDER_PREFIX = "opencode-zen";
+var ARK_PROVIDER_ID = "agent-plan";
 var TUI_ID = "command-code.tui";
 var CMD_USAGE_COMMAND_ID = "command-code.cmd-usage";
 var OCUSE_USAGE_COMMAND_ID = "command-code.ocuse-usage";
+var ARKUSE_USAGE_COMMAND_ID = "command-code.arkuse-usage";
 
 // src/sidebar/panel.tsx
 import { createComponent as _$createComponent } from "@opentui/solid";
@@ -926,6 +954,7 @@ var CHILD_TIMEOUT_MS = 30000;
 var MODELS_CACHE_TTL_MS = 5 * 60 * 1000;
 var CATALOG_CACHE_TTL_MS = 60 * 60 * 1000;
 var PREFS_CACHE_MS = 5000;
+var ARK_SNAPSHOT_TTL_MS = 60000;
 
 // src/sidebar/prefs.ts
 var cached;
@@ -2095,13 +2124,196 @@ function minPlan(id) {
   return MODEL_CATALOG[id]?.minPlan ?? null;
 }
 
+// src/sidebar/ark.ts
+function totals(value) {
+  const v = value ?? {};
+  const num = (key) => typeof v[key] === "number" ? v[key] : 0;
+  return {
+    afp: num("afp"),
+    requests: num("requests"),
+    tokensIn: num("tokensIn"),
+    tokensOut: num("tokensOut"),
+    cacheRead: num("cacheRead")
+  };
+}
+function meter(value) {
+  const v = value && typeof value === "object" ? value : {};
+  return {
+    status: typeof v.status === "string" ? v.status : "ok",
+    percent: typeof v.percent === "number" ? v.percent : 0,
+    used: typeof v.used === "number" ? v.used : 0,
+    total: typeof v.total === "number" ? v.total : 0,
+    resetAt: typeof v.resetAt === "number" ? v.resetAt : undefined
+  };
+}
+function storeWindow(value) {
+  if (!value || typeof value !== "object")
+    return;
+  const v = value;
+  return {
+    quota: typeof v.quota === "number" ? v.quota : undefined,
+    percent: typeof v.percent === "number" ? v.percent : undefined,
+    resetAt: typeof v.resetAt === "number" ? v.resetAt : undefined
+  };
+}
+function parseArkJson(text) {
+  let body;
+  try {
+    body = JSON.parse(text);
+  } catch {
+    body = {};
+  }
+  const account = body.account ?? {};
+  const models = new Map;
+  const rawModels = body.models ?? {};
+  for (const [id, raw] of Object.entries(rawModels)) {
+    const m = raw ?? {};
+    models.set(id, {
+      id,
+      coef: typeof m.coef === "number" ? m.coef : 0,
+      fiveHour: totals(m.fiveHour),
+      weekly: totals(m.weekly),
+      month: totals(m.month)
+    });
+  }
+  const summary = body.summary ?? {};
+  const windows = body.windows ?? {};
+  return {
+    plan: typeof body.plan === "string" ? body.plan : "medium",
+    profile: typeof body.profile === "string" ? body.profile : undefined,
+    periodStart: typeof body.periodStart === "number" ? body.periodStart : undefined,
+    periodEndAt: typeof body.periodEndAt === "number" ? body.periodEndAt : undefined,
+    summary: {
+      ...totals(summary),
+      yuan: typeof summary.yuan === "number" ? summary.yuan : undefined
+    },
+    fiveHour: totals(body.fiveHour),
+    weekly: totals(body.weekly),
+    month: totals(body.monthly),
+    daily: body.daily ? totals(body.daily) : undefined,
+    windows: body.windows ? {
+      fiveHour: storeWindow(windows.fiveHour),
+      weekly: storeWindow(windows.weekly),
+      monthly: storeWindow(windows.monthly)
+    } : undefined,
+    account: body.account ? {
+      fiveHour: meter(account.fiveHour),
+      daily: account.daily ? meter(account.daily) : undefined,
+      weekly: meter(account.weekly),
+      monthly: meter(account.monthly)
+    } : undefined,
+    accountError: typeof body.accountError === "string" && body.accountError ? body.accountError : undefined,
+    afpPerRequest: typeof body.afpPerRequest === "number" ? body.afpPerRequest : undefined,
+    reconciledPct: typeof body.reconciledPct === "number" ? body.reconciledPct : undefined,
+    models
+  };
+}
+function monthPeriod(usage) {
+  const {
+    periodStart,
+    periodEndAt
+  } = usage;
+  if (typeof periodStart !== "number" || typeof periodEndAt !== "number")
+    return;
+  const durSecs = Math.round((periodEndAt - periodStart) / 1000);
+  if (durSecs <= 0)
+    return;
+  return {
+    resetAt: periodEndAt,
+    durSecs
+  };
+}
+function afp(value) {
+  return `${grouped(Math.round(value))} AFP`;
+}
+function grouped(value) {
+  return String(value).replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+}
+function brief(value) {
+  const rounded = Math.round(value);
+  const trim = (n) => n.toFixed(1).replace(/\.0$/, "");
+  if (rounded >= 1e6)
+    return `${trim(rounded / 1e6)}M`;
+  if (rounded >= 1000)
+    return `${trim(rounded / 1000)}K`;
+  return String(rounded);
+}
+function meterRows(label, meter, local, now, durSecs) {
+  const pct = meter.percent;
+  const pctText = Number.isInteger(pct) ? String(pct) : pct.toFixed(1);
+  return windowRows(label, {
+    cap: meter.total > 0 ? meter.total : undefined,
+    used: meter.used,
+    resetAt: meter.resetAt,
+    sharePct: pct,
+    exceeded: pct >= 100 || meter.status !== "ok"
+  }, now, durSecs, `${afp(local.afp)} local${local.requests > 0 ? ` \xB7 ${count(local.requests)} req` : ""}`, (used, cap) => `${brief(used)}/${brief(cap)} (${pctText}%)`);
+}
+function localRows(label, totals, window, now, durSecs) {
+  const quota = window?.quota;
+  const percent = window?.percent;
+  if (typeof quota !== "number" || quota <= 0 || typeof percent !== "number") {
+    const detail = totals.requests > 0 ? ` \xB7 ${count(totals.requests)} req` : "";
+    return [[label, `${afp(totals.afp)}${detail}`, "base"]];
+  }
+  const pctText = percent.toFixed(1);
+  return windowRows(label, {
+    cap: quota,
+    used: totals.afp,
+    resetAt: window?.resetAt,
+    sharePct: percent,
+    exceeded: percent >= 100
+  }, now, durSecs, `${count(totals.requests)} req`, (used, cap) => `${brief(used)}/${brief(cap)} (${pctText}% est.)`);
+}
+function arkRows(usage, fallbackName) {
+  if (!usage)
+    return [];
+  const now = Date.now();
+  const rows = [["Plan", clip(`${usage.plan} \xB7 AFP plan${usage.profile ? ` \xB7 ${usage.profile}` : ""}`, valueWidth("Plan")), "base", true]];
+  if (usage.accountError) {
+    rows.push(["", clip(`usage API: ${usage.accountError}`, valueWidth("")), "warn"]);
+  }
+  const period = monthPeriod(usage);
+  if (usage.account) {
+    const account = usage.account;
+    rows.push(...meterRows("5-hour", account.fiveHour, usage.fiveHour, now, FIVE_HOUR_SECS));
+    if (account.daily) {
+      rows.push(...meterRows("Daily", account.daily, usage.daily ?? usage.month, now, 86400));
+    }
+    rows.push(...meterRows("Weekly", account.weekly, usage.weekly, now, WEEKLY_SECS));
+    rows.push(...meterRows("Monthly", account.monthly, usage.month, now, period?.durSecs ?? 0));
+  } else {
+    const windows = usage.windows;
+    rows.push(...localRows("5-hour", usage.fiveHour, windows?.fiveHour, now, FIVE_HOUR_SECS));
+    rows.push(...localRows("Weekly", usage.weekly, windows?.weekly, now, WEEKLY_SECS));
+    rows.push(...localRows("Monthly", usage.month, windows?.monthly, now, period?.durSecs ?? 0));
+  }
+  const yuan = typeof usage.summary.yuan === "number" ? ` (${money(usage.summary.yuan)})` : "";
+  rows.push(["Period", clip(`${count(usage.summary.requests)} requests \xB7 ${afp(usage.summary.afp)}${yuan}`, valueWidth("Period")), "base"]);
+  if (typeof usage.afpPerRequest === "number" && usage.afpPerRequest > 0) {
+    const drift = typeof usage.reconciledPct === "number" ? ` \xB7 ${usage.reconciledPct >= 0 ? "+" : ""}${usage.reconciledPct.toFixed(1)}% vs meter` : "";
+    rows.push(["", clip(`${usage.afpPerRequest.toFixed(0)} AFP/request${drift}`, valueWidth("")), "muted"]);
+  }
+  rows.push(separator());
+  if (!fallbackName)
+    return rows;
+  const model = usage.models.get(fallbackName);
+  rows.push(["Model", clip(fallbackName, valueWidth("Model")), "strong", true]);
+  rows.push(["AFP (this model)", model ? clip(`${afp(model.month.afp)} \xB7 ${count(model.month.requests)} req`, valueWidth("AFP (this model)")) : "no usage in this period", "base"]);
+  if (model && usage.summary.afp > 0) {
+    const share = model.month.afp / usage.summary.afp * 100;
+    rows.push(["", clip(`${share.toFixed(1)}% of the period \xB7 coef ${model.coef.toFixed(2)}`, Math.min(ROW_WIDTH, valueWidth(""))), "muted"]);
+  }
+  return rows;
+}
+
 // src/sidebar/data.ts
 import { mkdir, readFile, writeFile } from "fs/promises";
 import { homedir as homedir3 } from "os";
 import { dirname, join as join3 } from "path";
 
 // src/sidebar/zen.ts
-function totals(value) {
+function totals2(value) {
   const v = value ?? {};
   const num = (key) => typeof v[key] === "number" ? v[key] : 0;
   return {
@@ -2110,7 +2322,7 @@ function totals(value) {
     tokens: num("tokens")
   };
 }
-function meter(value) {
+function meter2(value) {
   const v = value ?? {};
   return {
     status: typeof v.status === "string" ? v.status : "ok",
@@ -2133,9 +2345,9 @@ function parseZenJson(text) {
       id: raw.id,
       provider: typeof raw.provider === "string" ? raw.provider : "",
       limit: typeof raw.limit === "number" ? raw.limit : undefined,
-      fiveHour: totals(raw.fiveHour),
-      weekly: totals(raw.weekly),
-      month: totals(raw.month)
+      fiveHour: totals2(raw.fiveHour),
+      weekly: totals2(raw.weekly),
+      month: totals2(raw.month)
     });
   }
   const top = body.totals ?? {};
@@ -2144,20 +2356,20 @@ function parseZenJson(text) {
     periodEndAt: typeof body.periodEndAt === "number" ? body.periodEndAt : undefined,
     source: typeof body.source === "string" ? body.source : undefined,
     account: body.account ? {
-      rolling: meter(body.account.rolling),
-      weekly: meter(body.account.weekly),
-      monthly: meter(body.account.monthly)
+      rolling: meter2(body.account.rolling),
+      weekly: meter2(body.account.weekly),
+      monthly: meter2(body.account.monthly)
     } : undefined,
     accountError: typeof body.accountError === "string" && body.accountError ? body.accountError : undefined,
     totals: {
-      fiveHour: totals(top.fiveHour),
-      weekly: totals(top.weekly),
-      month: totals(top.month)
+      fiveHour: totals2(top.fiveHour),
+      weekly: totals2(top.weekly),
+      month: totals2(top.month)
     },
     models
   };
 }
-function monthPeriod(usage) {
+function monthPeriod2(usage) {
   const {
     periodStart,
     periodEndAt
@@ -2213,7 +2425,7 @@ function zenRows(usage, meta, modelUsage, session, fallbackName, windows) {
   const mine = usage.models.get(modelKey(fallbackName ?? "")) ?? (meta ? usage.models.get(modelKey(meta.name)) : undefined);
   const limit = oc?.allowance ?? mine?.limit;
   const cap = mine ? limit : undefined;
-  const period = monthPeriod(usage);
+  const period = monthPeriod2(usage);
   if (usage.account) {
     rows.push(...zenMeterRows("5-hour", usage.account.rolling, now, FIVE_HOUR_SECS, usage.totals.fiveHour.cost));
     rows.push(...zenMeterRows("Weekly", usage.account.weekly, now, WEEKLY_SECS, usage.totals.weekly.cost));
@@ -2370,6 +2582,19 @@ async function loadUsage() {
 async function loadZen(plan = OC_PLAN_DEFAULT) {
   return parseZenJson(await runOcuse(zenArgs(plan), SIDEBAR_OPTS));
 }
+var arkCache;
+async function loadArk() {
+  const now = Date.now();
+  if (arkCache && now - arkCache.at < ARK_SNAPSHOT_TTL_MS) {
+    return arkCache.usage;
+  }
+  const usage = parseArkJson(await runArkuse("-1 --json", SIDEBAR_OPTS));
+  arkCache = {
+    at: now,
+    usage
+  };
+  return usage;
+}
 
 // src/sidebar/usageDb.ts
 import { Database } from "bun:sqlite";
@@ -2561,16 +2786,20 @@ function sessionKind(providerID) {
     return "go";
   if (providerID === ZEN_PROVIDER_ID || providerID.startsWith(ZEN_PROVIDER_PREFIX))
     return "zen";
+  if (providerID.startsWith(ARK_PROVIDER_ID))
+    return "ark";
   return "other";
 }
 function shows(kind) {
-  return kind === "ours" || kind === "go" || kind === "zen";
+  return kind === "ours" || kind === "go" || kind === "zen" || kind === "ark";
 }
 function panelTitle(kind) {
   if (kind === "ours")
     return "Command Code";
   if (kind === "zen")
     return "OpenCode Zen";
+  if (kind === "ark")
+    return "Volcengine ARK";
   return "OpenCode Go";
 }
 var lastSnapshot;
@@ -2613,9 +2842,17 @@ function rememberZen(usage) {
 function seededZen() {
   return lastZen;
 }
+var lastArk;
+function rememberArk(usage) {
+  lastArk = usage;
+}
+function seededArk() {
+  return lastArk;
+}
 function useRows(activeModelId, providerID, sessionID) {
   const [usage, setUsage] = createSignal(seededRows());
   const [zen, setZen] = createSignal(seededZen());
+  const [ark, setArk] = createSignal(seededArk());
   const [meta, setMeta] = createSignal(seededMeta());
   const [modelUsage, setModelUsage] = createSignal(lastModelUsage);
   const [sessionUsage, setSessionUsage] = createSignal();
@@ -2671,6 +2908,10 @@ function useRows(activeModelId, providerID, sessionID) {
         setZen(snapshot);
         refreshModelUsage(activeModelId());
         refreshModelWindows(activeModelId());
+      } else if (kind === "ark") {
+        const snapshot = await loadArk();
+        rememberArk(snapshot);
+        setArk(snapshot);
       }
     } catch {} finally {
       inFlight = false;
@@ -2715,6 +2956,9 @@ function useRows(activeModelId, providerID, sessionID) {
     if (kind === "go" || kind === "zen") {
       return zenRows(zen(), found, usageFor(id), sessionUsage(), fallbackName, modelWindows());
     }
+    if (kind === "ark") {
+      return arkRows(ark(), fallbackName);
+    }
     const model = found ? {
       ...found,
       tier: found.tier ?? (id ? tierFor(id) : undefined),
@@ -2834,8 +3078,35 @@ var commandCodeTui = {
                 message: text.trimEnd()
               });
             }
+          }, {
+            id: ARKUSE_USAGE_COMMAND_ID,
+            title: "Volcengine ARK usage",
+            group: "Command Code",
+            slash: {
+              name: "arkuse-usage",
+              arguments: true
+            },
+            enabled: () => true,
+            suggested: true,
+            run: async (input) => {
+              let text;
+              try {
+                text = await runArkuse(arkuseArgs(input));
+              } catch (error) {
+                ctx.ui.toast.show({
+                  title: "arkuse-usage failed",
+                  message: error instanceof Error ? error.message : String(error),
+                  variant: "error"
+                });
+                return;
+              }
+              await ctx.ui.dialog.alert({
+                title: "Volcengine ARK usage",
+                message: text.trimEnd()
+              });
+            }
           }],
-          bindings: [CMD_USAGE_COMMAND_ID, OCUSE_USAGE_COMMAND_ID]
+          bindings: [CMD_USAGE_COMMAND_ID, OCUSE_USAGE_COMMAND_ID, ARKUSE_USAGE_COMMAND_ID]
         }));
       }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jeffreyjyz/opencode-command-code",
-	"version": "0.5.16",
+	"version": "0.5.19",
 	"description": "Command Code provider + usage dashboard for opencode: two providers (Anthropic wire for Claude, OpenAI wire for everything else) against api.commandcode.ai, live model list, plan gating, /cmd-usage. Requires the cmduse CLI for usage rendering.",
 	"type": "module",
 	"main": "dist/index.js",