opencode-visual-cache 1.6.1 → 1.7.0-beta.0

package/package.json

@@ -1,67 +1,70 @@
-{
-  "name": "opencode-visual-cache",
-  "version": "1.6.1",
-  "description": "OpenCode TUI plugin displaying real-time token cache hit rate in the sidebar",
-  "type": "module",
-  "types": "dist/index.d.ts",
-  "exports": {
-    "./server": {
-      "import": "./dist/server.js",
-      "types": "./dist/server.d.ts"
-    },
-    "./tui": {
-      "import": "./dist/tui.js",
-      "config": {
-        "enabled": true
-      }
-    }
-  },
-  "files": [
-    "dist",
-    "src",
-    "install.mjs",
-    "README.md",
-    "README_EN.md"
-  ],
-  "bin": {
-    "opencode-visual-cache": "install.mjs"
-  },
-  "scripts": {
-    "build": "tsc && node build.tui.mjs",
-    "build:tui": "node build.tui.mjs",
-    "typecheck": "tsc --noEmit",
-    "version": "node -e \"require('fs').writeFileSync('src/_version.ts','// auto-generated\\nexport const PLUGIN_VERSION='+JSON.stringify(require('./package.json').version)+';\\n')\"",
-    "prepublishOnly": "tsc"
-  },
-  "keywords": [
-    "opencode",
-    "opencode-plugin",
-    "tui",
-    "token",
-    "cache-hit-rate",
-    "cost-tracking"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Hotakus/opencode-visual-cache.git"
-  },
-  "license": "MIT",
-  "peerDependencies": {
-    "@opencode-ai/plugin": ">=1.14.0",
-    "@opencode-ai/sdk": ">=1.14.0",
-    "@opentui/core": ">=0.2.0",
-    "@opentui/solid": ">=0.2.0",
-    "solid-js": ">=1.9.0"
-  },
-  "devDependencies": {
-    "@opencode-ai/plugin": "^1.18.16",
-    "@opencode-ai/sdk": "^1.18.16",
-    "@opentui/core": "^0.5.1",
-    "@opentui/solid": "^0.5.1",
-    "@opentui/keymap": "^0.5.1",
-    "esbuild": "^0.25.0",
-    "esbuild-plugin-solid": "^0.5.0",
-    "tsx": "^4.22.3",
-    "typescript": "^5.8.0"
-  }
-}
+{
+  "name": "opencode-visual-cache",
+  "version": "1.7.0-beta.0",
+  "description": "OpenCode TUI plugin displaying real-time token cache hit rate in the sidebar",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "exports": {
+    "./server": {
+      "import": "./dist/server.js",
+      "types": "./dist/server.d.ts"
+    },
+    "./tui": {
+      "import": "./dist/tui.js",
+      "config": {
+        "enabled": true
+      }
+    },
+    "./v2": {
+      "import": "./dist/v2.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "install.mjs",
+    "README.md",
+    "README_EN.md"
+  ],
+  "bin": {
+    "opencode-visual-cache": "install.mjs"
+  },
+  "scripts": {
+    "build": "tsc && node build.tui.mjs",
+    "build:tui": "node build.tui.mjs",
+    "typecheck": "tsc --noEmit",
+    "version": "node -e \"require('fs').writeFileSync('src/_version.ts','// auto-generated\\nexport const PLUGIN_VERSION='+JSON.stringify(require('./package.json').version)+';\\n')\"",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "tui",
+    "token",
+    "cache-hit-rate",
+    "cost-tracking"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hotakus/opencode-visual-cache.git"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.14.0",
+    "@opencode-ai/sdk": ">=1.14.0",
+    "@opentui/core": ">=0.2.0",
+    "@opentui/solid": ">=0.2.0",
+    "solid-js": ">=1.9.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.18.16",
+    "@opencode-ai/sdk": "^1.18.16",
+    "@opentui/core": "^0.5.1",
+    "@opentui/solid": "^0.5.1",
+    "@opentui/keymap": "^0.5.1",
+    "esbuild": "^0.25.0",
+    "esbuild-plugin-solid": "^0.5.0",
+    "tsx": "^4.22.3",
+    "typescript": "^5.8.0"
+  }
+}

package/src/_version.ts

@@ -1,2 +1,2 @@
 // auto-generated
-export const PLUGIN_VERSION="1.6.1";
+export const PLUGIN_VERSION="1.7.0-beta.0";

package/src/balance-providers.ts

@@ -1,153 +1,153 @@
-// ---------------------------------------------------------------------------
-// Balance providers — pluggable account-balance query adapters.
-// ---------------------------------------------------------------------------
-
-/** 归一化后的余额条目——显示层与具体 provider 解耦。 */
-export interface BalanceEntry {
-  currency: string   // 原生币种（CNY/USD…），复用现有汇率换算
-  total: string      // 余额字符串
-}
-
-/** provider 统一错误：message 即错误码（401/403/EMPTY/…），显示层直接展示。 */
-export class BalanceError extends Error {}
-
-/** 可插拔的余额 provider 适配器。 */
-export interface BalanceProvider {
-  id: string                    // 唯一标识，同时用作 KV key 命名空间
-  name: string                  // 显示名（专有名词，无需 i18n）
-  keyPlaceholder?: string       // key 输入框占位（如 "sk-..."）
-  fetchBalance(apiKey: string, signal?: AbortSignal): Promise<BalanceEntry[]>
-}
-
-const siliconflowProvider: BalanceProvider = {
-  id: "siliconflow",
-  name: "SiliconFlow",
-  keyPlaceholder: "sk-...",
-  async fetchBalance(apiKey, signal) {
-    // 国内站 api.siliconflow.cn（CNY）；国际站为 api.siliconflow.com（USD）
-    const res = await fetch("https://api.siliconflow.cn/v1/user/info", {
-      headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
-      signal,
-    })
-    if (!res.ok) {
-      if (res.status === 401) throw new BalanceError("401")
-      if (res.status === 403) throw new BalanceError("403")
-      throw new BalanceError(String(res.status))
-    }
-    const json = await res.json() as {
-      status?: boolean
-      data?: {
-        balance?: string | number
-        chargeBalance?: string | number
-        totalBalance?: string | number
-      }
-    }
-    // totalBalance 为总余额（含充值+赠送），缺失时回退 balance
-    const total = json.data?.totalBalance ?? json.data?.balance
-    if (typeof total === "undefined" || total === null) throw new BalanceError("EMPTY")
-    return [{ currency: "CNY", total: String(total) }]
-  },
-}
-
-const deepseekProvider: BalanceProvider = {
-  id: "deepseek",
-  name: "DeepSeek",
-  keyPlaceholder: "sk-...",
-  async fetchBalance(apiKey, signal) {
-    const res = await fetch("https://api.deepseek.com/user/balance", {
-      headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
-      signal,
-    })
-    if (!res.ok) {
-      if (res.status === 401) throw new BalanceError("401")
-      if (res.status === 402 || res.status === 403) throw new BalanceError("403")
-      throw new BalanceError(String(res.status))
-    }
-    const json = await res.json() as {
-      is_available?: boolean
-      balance_infos?: { currency: string; total_balance: string; granted_balance: string; topped_up_balance: string }[]
-    }
-    const infos = json.balance_infos ?? []
-    if (infos.length === 0) throw new BalanceError("EMPTY")
-    return infos.map((info) => ({
-      currency: info.currency ?? "CNY",
-      total: info.total_balance ?? "0",
-    }))
-  },
-}
-
-const openrouterProvider: BalanceProvider = {
-  id: "openrouter",
-  name: "OpenRouter",
-  keyPlaceholder: "sk-or-...",
-  async fetchBalance(apiKey, signal) {
-    // 官方文档标注需 Management key，实测普通 API key 亦可查询账户余额
-    const res = await fetch("https://openrouter.ai/api/v1/credits", {
-      headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
-      signal,
-    })
-    if (!res.ok) {
-      if (res.status === 401 || res.status === 403) throw new BalanceError("403")
-      throw new BalanceError(String(res.status))
-    }
-    const json = await res.json() as {
-      data?: { total_credits?: number; total_usage?: number }
-    }
-    const credits = json.data?.total_credits
-    const usage = json.data?.total_usage
-    if (typeof credits !== "number" || typeof usage !== "number") throw new BalanceError("EMPTY")
-    // 剩余额度 = 充值总额 - 已用
-    return [{ currency: "USD", total: (credits - usage).toFixed(2) }]
-  },
-}
-
-const moonshotProvider: BalanceProvider = {
-  id: "moonshot",
-  name: "Moonshot",
-  keyPlaceholder: "sk-...",
-  async fetchBalance(apiKey, signal) {
-    // 国内站 api.moonshot.cn（CNY）；国际站 api.moonshot.ai（USD）
-    const res = await fetch("https://api.moonshot.cn/v1/users/me/balance", {
-      headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
-      signal,
-    })
-    if (!res.ok) {
-      if (res.status === 401) throw new BalanceError("401")
-      if (res.status === 403) throw new BalanceError("403")
-      throw new BalanceError(String(res.status))
-    }
-    const json = await res.json() as {
-      data?: { available_balance?: string | number }
-    }
-    const balance = json.data?.available_balance
-    if (typeof balance === "undefined" || balance === null) throw new BalanceError("EMPTY")
-    return [{ currency: "CNY", total: String(balance) }]
-  },
-}
-
-/** 已注册的 provider 列表（按需追加新适配器）。 */
-export const balanceProviders: BalanceProvider[] = [deepseekProvider, siliconflowProvider, openrouterProvider, moonshotProvider]
-
-/** 按 id 取 provider；未知 id 回退到第一个。 */
-export function getBalanceProvider(id: string): BalanceProvider {
-  return balanceProviders.find((p) => p.id === id) ?? balanceProviders[0] ?? deepseekProvider
-}
-
-/**
- * 按 OpenCode providerID 匹配余额 provider。
- * 先精确匹配，再按前缀匹配（如 moonshotai-cn → moonshot）；未命中返回 undefined。
- * 比较不区分大小写，容忍 providerID 的大小写变体。
- */
-export function matchBalanceProvider(providerId: string): BalanceProvider | undefined {
-  const id = providerId.toLowerCase()
-  const exact = balanceProviders.find((p) => p.id.toLowerCase() === id)
-  if (exact) return exact
-  return balanceProviders.find((p) => id.startsWith(p.id.toLowerCase()))
-}
-
-/** key 脱敏：保留头 5 尾 5 字符，中间用 * 填充。 */
-export function maskKey(k: string): string {
-  if (!k) return ""
-  if (k.length <= 10) return k.slice(0, 5) + "*".repeat(Math.max(3, k.length - 5))
-  return k.slice(0, 5) + "*".repeat(Math.max(3, k.length - 10)) + k.slice(-5)
-}
+// ---------------------------------------------------------------------------
+// Balance providers — pluggable account-balance query adapters.
+// ---------------------------------------------------------------------------
+
+/** 归一化后的余额条目——显示层与具体 provider 解耦。 */
+export interface BalanceEntry {
+  currency: string   // 原生币种（CNY/USD…），复用现有汇率换算
+  total: string      // 余额字符串
+}
+
+/** provider 统一错误：message 即错误码（401/403/EMPTY/…），显示层直接展示。 */
+export class BalanceError extends Error {}
+
+/** 可插拔的余额 provider 适配器。 */
+export interface BalanceProvider {
+  id: string                    // 唯一标识，同时用作 KV key 命名空间
+  name: string                  // 显示名（专有名词，无需 i18n）
+  keyPlaceholder?: string       // key 输入框占位（如 "sk-..."）
+  fetchBalance(apiKey: string, signal?: AbortSignal): Promise<BalanceEntry[]>
+}
+
+const siliconflowProvider: BalanceProvider = {
+  id: "siliconflow",
+  name: "SiliconFlow",
+  keyPlaceholder: "sk-...",
+  async fetchBalance(apiKey, signal) {
+    // 国内站 api.siliconflow.cn（CNY）；国际站为 api.siliconflow.com（USD）
+    const res = await fetch("https://api.siliconflow.cn/v1/user/info", {
+      headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+      signal,
+    })
+    if (!res.ok) {
+      if (res.status === 401) throw new BalanceError("401")
+      if (res.status === 403) throw new BalanceError("403")
+      throw new BalanceError(String(res.status))
+    }
+    const json = await res.json() as {
+      status?: boolean
+      data?: {
+        balance?: string | number
+        chargeBalance?: string | number
+        totalBalance?: string | number
+      }
+    }
+    // totalBalance 为总余额（含充值+赠送），缺失时回退 balance
+    const total = json.data?.totalBalance ?? json.data?.balance
+    if (typeof total === "undefined" || total === null) throw new BalanceError("EMPTY")
+    return [{ currency: "CNY", total: String(total) }]
+  },
+}
+
+const deepseekProvider: BalanceProvider = {
+  id: "deepseek",
+  name: "DeepSeek",
+  keyPlaceholder: "sk-...",
+  async fetchBalance(apiKey, signal) {
+    const res = await fetch("https://api.deepseek.com/user/balance", {
+      headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+      signal,
+    })
+    if (!res.ok) {
+      if (res.status === 401) throw new BalanceError("401")
+      if (res.status === 402 || res.status === 403) throw new BalanceError("403")
+      throw new BalanceError(String(res.status))
+    }
+    const json = await res.json() as {
+      is_available?: boolean
+      balance_infos?: { currency: string; total_balance: string; granted_balance: string; topped_up_balance: string }[]
+    }
+    const infos = json.balance_infos ?? []
+    if (infos.length === 0) throw new BalanceError("EMPTY")
+    return infos.map((info) => ({
+      currency: info.currency ?? "CNY",
+      total: info.total_balance ?? "0",
+    }))
+  },
+}
+
+const openrouterProvider: BalanceProvider = {
+  id: "openrouter",
+  name: "OpenRouter",
+  keyPlaceholder: "sk-or-...",
+  async fetchBalance(apiKey, signal) {
+    // 官方文档标注需 Management key，实测普通 API key 亦可查询账户余额
+    const res = await fetch("https://openrouter.ai/api/v1/credits", {
+      headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+      signal,
+    })
+    if (!res.ok) {
+      if (res.status === 401 || res.status === 403) throw new BalanceError("403")
+      throw new BalanceError(String(res.status))
+    }
+    const json = await res.json() as {
+      data?: { total_credits?: number; total_usage?: number }
+    }
+    const credits = json.data?.total_credits
+    const usage = json.data?.total_usage
+    if (typeof credits !== "number" || typeof usage !== "number") throw new BalanceError("EMPTY")
+    // 剩余额度 = 充值总额 - 已用
+    return [{ currency: "USD", total: (credits - usage).toFixed(2) }]
+  },
+}
+
+const moonshotProvider: BalanceProvider = {
+  id: "moonshot",
+  name: "Moonshot",
+  keyPlaceholder: "sk-...",
+  async fetchBalance(apiKey, signal) {
+    // 国内站 api.moonshot.cn（CNY）；国际站 api.moonshot.ai（USD）
+    const res = await fetch("https://api.moonshot.cn/v1/users/me/balance", {
+      headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+      signal,
+    })
+    if (!res.ok) {
+      if (res.status === 401) throw new BalanceError("401")
+      if (res.status === 403) throw new BalanceError("403")
+      throw new BalanceError(String(res.status))
+    }
+    const json = await res.json() as {
+      data?: { available_balance?: string | number }
+    }
+    const balance = json.data?.available_balance
+    if (typeof balance === "undefined" || balance === null) throw new BalanceError("EMPTY")
+    return [{ currency: "CNY", total: String(balance) }]
+  },
+}
+
+/** 已注册的 provider 列表（按需追加新适配器）。 */
+export const balanceProviders: BalanceProvider[] = [deepseekProvider, siliconflowProvider, openrouterProvider, moonshotProvider]
+
+/** 按 id 取 provider；未知 id 回退到第一个。 */
+export function getBalanceProvider(id: string): BalanceProvider {
+  return balanceProviders.find((p) => p.id === id) ?? balanceProviders[0] ?? deepseekProvider
+}
+
+/**
+ * 按 OpenCode providerID 匹配余额 provider。
+ * 先精确匹配，再按前缀匹配（如 moonshotai-cn → moonshot）；未命中返回 undefined。
+ * 比较不区分大小写，容忍 providerID 的大小写变体。
+ */
+export function matchBalanceProvider(providerId: string): BalanceProvider | undefined {
+  const id = providerId.toLowerCase()
+  const exact = balanceProviders.find((p) => p.id.toLowerCase() === id)
+  if (exact) return exact
+  return balanceProviders.find((p) => id.startsWith(p.id.toLowerCase()))
+}
+
+/** key 脱敏：保留头 5 尾 5 字符，中间用 * 填充。 */
+export function maskKey(k: string): string {
+  if (!k) return ""
+  if (k.length <= 10) return k.slice(0, 5) + "*".repeat(Math.max(3, k.length - 5))
+  return k.slice(0, 5) + "*".repeat(Math.max(3, k.length - 10)) + k.slice(-5)
+}

package/src/core/color.ts

@@ -0,0 +1,108 @@
+/** Extract { r, g, b } (0–255) from a hex string or RGBA-like object. */
+export function rgb(raw: unknown): { r: number; g: number; b: number } | null {
+  if (typeof raw === "string" && raw.startsWith("#")) {
+    const h = raw.slice(1)
+    return {
+      r: parseInt(h.slice(0, 2), 16),
+      g: parseInt(h.slice(2, 4), 16),
+      b: parseInt(h.slice(4, 6), 16),
+    }
+  }
+  if (raw && typeof raw === "object") {
+    const o = raw as Record<string, unknown>
+    if (typeof o.r === "number" && typeof o.g === "number" && typeof o.b === "number") {
+      // RGBA channels may be 0-1 floats; detect and upscale.
+      const scale = o.r > 1 || o.g > 1 || o.b > 1 ? 1 : 255
+      return {
+        r: Math.round(o.r * scale),
+        g: Math.round(o.g * scale),
+        b: Math.round(o.b * scale),
+      }
+    }
+  }
+  return null
+}
+
+/** HSL saturation of an RGB color (0–1). */
+export function saturation(r: number, g: number, b: number): number {
+  const max = Math.max(r, g, b) / 255
+  const min = Math.min(r, g, b) / 255
+  const delta = max - min
+  if (delta === 0) return 0
+  const L = (max + min) / 2
+  return L <= 0.5 ? delta / (max + min) : delta / (2 - max - min)
+}
+
+/**
+ * If the colour's saturation exceeds `maxSat`, pull it toward grey
+ * until saturation drops to maxSat.  Returns a hex string.
+ */
+export function desaturateTo(raw: unknown, maxSat: number, fallback: string): string {
+  const c = rgb(raw)
+  if (!c) return fallback
+  const sat = saturation(c.r, c.g, c.b)
+  if (sat <= maxSat) {
+    // already muted — return as hex
+    return "#" + [c.r, c.g, c.b].map((v) => v.toString(16).padStart(2, "0")).join("")
+  }
+  /**
+   * Binary search for the optimal grey-mix ratio α (0…1).
+   *
+   * 12 iterations → 1/2^12 ≈ 1/4096 resolution.  The downstream RGB
+   * channels are only 0–255 (8 bit), so 8 iterations (1/256) would
+   * technically suffice; 12 is intentionally over-budget — the extra
+   * precision costs almost nothing and guarantees the saturation probe
+   * converges to within a fraction of an 8‑bit step, eliminating
+   * colour banding in edge cases.
+   */
+  // Bt.601 luma (perceptual brightness used as the grey anchor)
+  const luma = c.r * 0.299 + c.g * 0.587 + c.b * 0.114
+  let lo = 0, hi = 1
+  for (let i = 0; i < 12; i++) {
+    const mid = (lo + hi) / 2
+    const nr = Math.round(c.r + (luma - c.r) * mid)
+    const ng = Math.round(c.g + (luma - c.g) * mid)
+    const nb = Math.round(c.b + (luma - c.b) * mid)
+    if (saturation(nr, ng, nb) > maxSat) lo = mid
+    else hi = mid
+  }
+  const nr = Math.round(c.r + (luma - c.r) * hi)
+  const ng = Math.round(c.g + (luma - c.g) * hi)
+  const nb = Math.round(c.b + (luma - c.b) * hi)
+  return "#" + [nr, ng, nb].map((v) => Math.max(0, Math.min(255, v)).toString(16).padStart(2, "0")).join("")
+}
+
+/** Darken a hex colour by multiplying each channel by `factor` (0–1). */
+export function dimColor(hex: string, factor = 0.5): string {
+  const c = rgb(hex)
+  if (!c) return hex
+  const r = Math.round(c.r * factor)
+  const g = Math.round(c.g * factor)
+  const b = Math.round(c.b * factor)
+  return "#" + [r, g, b].map((v) => Math.max(0, Math.min(255, v)).toString(16).padStart(2, "0")).join("")
+}
+
+// Morandi fallbacks — used when a theme colour cannot be resolved
+export const FALLBACK = {
+  primary: "#8B9DAF",
+  text:    "#C5C5BB",
+  muted:   "#7A7A72",
+  success: "#9CAF8B",
+  warning: "#C5B88D",
+  error:   "#B08A8A",
+  border:  "#6B6B63",
+} as const
+
+/**
+ * Desaturation ceiling for the Morandi-style palette.
+ *
+ * Morandi colours float around 0.15–0.30 saturation in HSL space.
+ * 0.28 sits near the upper end of that range: it strips the aggressive
+ * punch from high-saturation themes (Dracula, Solarized …) while
+ * preserving enough colour identity that green / orange / red hit-rate
+ * coding stays distinguishable.
+ *
+ * Lower → more grey, harder to tell colours apart.
+ * Higher → bright themes bleed through and defeat the muted look.
+ */
+export const MAX_SAT = 0.28

package/src/core/currency.ts

@@ -0,0 +1,46 @@
+import type { BalanceEntry } from "../balance-providers"
+import { formatBalanceAmount } from "./format"
+
+export const CURRENCIES: Record<string, string> = {
+  USD: "$", CNY: "¥", EUR: "€", JPY: "JP¥", GBP: "£", KRW: "₩",
+}
+/** Approximate USD exchange rates — used as defaults when switching currency.
+ *  Users can override via /cache-rate.  Last updated 2026-05. */
+export const DEFAULT_RATES: Record<string, number> = {
+  USD: 1, CNY: 7.2, EUR: 0.92, JPY: 150, GBP: 0.79, KRW: 1350,
+}
+
+/**
+ * 将余额从来源币种换算为目标币种。
+ * DEFAULT_RATES 以 USD=1 为基准：先折算为 USD，再换算到目标币种。
+ */
+export function convertBalance(target: string, targetRate: number, amount: number, from: string): number {
+  if (from === target) return amount
+  const fromRate = DEFAULT_RATES[from] ?? 1
+  const usd = from === "USD" ? amount : amount / fromRate
+  return target === "USD" ? usd : usd * targetRate
+}
+
+/** 货币符号：优先取 /cache-currency 内置映射，未知币种回退为代码。 */
+export function balanceSymbol(currency: string): string {
+  const sym = CURRENCIES[currency]
+  return sym ?? currency + " "
+}
+
+/**
+ * 将余额列表格式化为单行文本。
+ * 优先直接显示偏好币种（CNY/USD…）；偏好币种为换算币种时按汇率折算第一条余额。
+ */
+export function formatBalanceText(list: BalanceEntry[], pref: string, rate: number): string {
+  const native = pref ? list.find((x) => x.currency === pref) : undefined
+  if (native) return balanceSymbol(native.currency) + formatBalanceAmount(native.total)
+  const base = list[0]
+  const baseAmt = parseFloat(base.total)
+  const converted = Number.isFinite(baseAmt)
+    ? convertBalance(pref || base.currency, rate, baseAmt, base.currency)
+    : baseAmt
+  const shown = pref && base.currency !== pref
+    ? converted.toLocaleString("en-US", { maximumFractionDigits: 2 })
+    : formatBalanceAmount(base.total)
+  return balanceSymbol(pref || base.currency) + shown
+}

package/src/core/estimate.ts

@@ -0,0 +1,36 @@
+// ── token estimation ──
+// Character-based BPE approximation.  Default ratios (~4 ASCII or ~1.5 CJK
+// chars per token) work well for natural language but systematically
+// under-count tokens in JSON and source code where every punctuation mark
+// tends to be its own token.  Detect these cases and tighten the ratio.
+// See: GPT-4 / Claude tokenizer behaviour with structured text.
+
+export function estimateTokens(text: string): number {
+  if (!text || text.length === 0) return 0
+  let ascii = 0
+  let cjk = 0
+  for (const c of text) {
+    const code = c.codePointAt(0) ?? 0
+    if (code >= 0x4E00 && code <= 0x9FFF) cjk++       // CJK Unified
+    else if (code >= 0x3040 && code <= 0x30FF) cjk++   // Hiragana/Katakana
+    else if (code >= 0xAC00 && code <= 0xD7A3) cjk++   // Hangul
+    else if (code >= 0x1100 && code <= 0x11FF) cjk++   // Hangul Jamo
+    else if (code >= 0x2E80 && code <= 0x2EFF) cjk++   // CJK Radicals
+    else ascii++
+  }
+
+  // Real BPE tokenizers (cl100k_base, o200k_base) average ~3.5-4.0
+  // ASCII chars/token for both JSON and source code — close to prose.
+  // The old 2.0 / 2.5 ratios matched minified-JS extremes, not typical
+  // payloads, and systematically over-estimated token counts.
+  const trimmed = text.trimStart()
+  // Strip markdown code-fence prefix so that ```json … is detected as JSON
+  const strippedFence = trimmed.replace(/^\x60{3}\w*\s*\n?/, "")
+  const jsonLike = (strippedFence.startsWith("{") || strippedFence.startsWith("["))
+    && /"[^"]+"\s*:/.test(text)
+  const codeLike = !jsonLike
+    && /```|^import |^export |^function |^const |^let |^var |^class |^interface |^type |^def |^fn |^pub |^use |^mod |^package /m.test(text)
+
+  const asciiPerToken = jsonLike ? 3.5 : codeLike ? 3.5 : 4
+  return Math.max(1, Math.ceil(ascii / asciiPerToken + cjk / 1.0))
+}