opencode-visual-cache 1.6.2 → 1.7.0-beta.1

package/dist/core/currency.d.ts

@@ -0,0 +1,17 @@
+import type { BalanceEntry } from "../balance-providers";
+export declare const CURRENCIES: Record<string, string>;
+/** Approximate USD exchange rates — used as defaults when switching currency.
+ *  Users can override via /cache-rate.  Last updated 2026-05. */
+export declare const DEFAULT_RATES: Record<string, number>;
+/**
+ * 将余额从来源币种换算为目标币种。
+ * DEFAULT_RATES 以 USD=1 为基准：先折算为 USD，再换算到目标币种。
+ */
+export declare function convertBalance(target: string, targetRate: number, amount: number, from: string): number;
+/** 货币符号：优先取 /cache-currency 内置映射，未知币种回退为代码。 */
+export declare function balanceSymbol(currency: string): string;
+/**
+ * 将余额列表格式化为单行文本。
+ * 优先直接显示偏好币种（CNY/USD…）；偏好币种为换算币种时按汇率折算第一条余额。
+ */
+export declare function formatBalanceText(list: BalanceEntry[], pref: string, rate: number): string;

package/dist/core/currency.js

@@ -0,0 +1,43 @@
+import { formatBalanceAmount } from "./format";
+export const CURRENCIES = {
+    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 = {
+    USD: 1, CNY: 7.2, EUR: 0.92, JPY: 150, GBP: 0.79, KRW: 1350,
+};
+/**
+ * 将余额从来源币种换算为目标币种。
+ * DEFAULT_RATES 以 USD=1 为基准：先折算为 USD，再换算到目标币种。
+ */
+export function convertBalance(target, targetRate, amount, from) {
+    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) {
+    const sym = CURRENCIES[currency];
+    return sym ?? currency + " ";
+}
+/**
+ * 将余额列表格式化为单行文本。
+ * 优先直接显示偏好币种（CNY/USD…）；偏好币种为换算币种时按汇率折算第一条余额。
+ */
+export function formatBalanceText(list, pref, rate) {
+    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/dist/core/estimate.d.ts

@@ -0,0 +1 @@
+export declare function estimateTokens(text: string): number;

package/dist/core/estimate.js

@@ -0,0 +1,40 @@
+// ── 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) {
+    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));
+}

package/dist/core/format.d.ts

@@ -0,0 +1,15 @@
+/** CJK characters occupy 2 terminal columns; padEnd/padStart count
+ *  string length (=1 per char), which breaks alignment with mixed text. */
+export declare function charColumns(c: string): number;
+export declare function visualWidth(s: string): number;
+export declare function visualPadEnd(s: string, cols: number): string;
+/** Truncate `s` to fit within `maxCols` visual columns, appending "…" when cut. */
+export declare function truncateVisual(s: string, maxCols: number): string;
+export declare function progressBar(percent: number, width: number): string;
+export declare function fmt(n: number): string;
+export declare function num(v: unknown): number;
+export declare function fmtCost(n: number, symbol?: string, rate?: number): string;
+/** 紧凑数字缩写（底部状态栏用）：1234 → "1.2K"，1234567 → "1.2M"。 */
+export declare function fmtCompact(n: number): string;
+/** 余额数值格式化：≥1 或 0 显示固定 2 位小数；小额（<1）保留精度（最多 6 位），避免抹成 0.00。 */
+export declare function formatBalanceAmount(total: string): string;

package/dist/core/format.js

@@ -0,0 +1,90 @@
+/** CJK characters occupy 2 terminal columns; padEnd/padStart count
+ *  string length (=1 per char), which breaks alignment with mixed text. */
+export function charColumns(c) {
+    const code = c.codePointAt(0) ?? 0;
+    if (code < 0x20)
+        return 0; // control
+    if (code < 0x7F)
+        return 1; // ASCII
+    if (code < 0xA0)
+        return 0; // C1 controls
+    // East-Asian wide / fullwidth ranges
+    if ((code >= 0x1100 && code <= 0x115F) || // Hangul Jamo
+        (code >= 0x2E80 && code <= 0xA4CF) || // CJK Radicals … Yi
+        (code >= 0xAC00 && code <= 0xD7A3) || // Hangul
+        (code >= 0xF900 && code <= 0xFAFF) || // CJK Compat
+        (code >= 0xFE10 && code <= 0xFE6F) || // Vertical / Compat
+        (code >= 0xFF01 && code <= 0xFF60) || // Fullwidth
+        (code >= 0xFFE0 && code <= 0xFFE6) || // Fullwidth signs
+        (code >= 0x1F300 && code <= 0x1F64F) || // Misc Symbols (emoji)
+        (code >= 0x20000 && code <= 0x3FFFD)) // SIP / TIP
+        return 2;
+    return 1;
+}
+export function visualWidth(s) {
+    let w = 0;
+    for (const c of s)
+        w += charColumns(c);
+    return w;
+}
+export function visualPadEnd(s, cols) {
+    const pad = cols - visualWidth(s);
+    return pad > 0 ? s + " ".repeat(pad) : s;
+}
+/** Truncate `s` to fit within `maxCols` visual columns, appending "…" when cut. */
+export function truncateVisual(s, maxCols) {
+    if (visualWidth(s) <= maxCols)
+        return s;
+    let result = "", w = 0;
+    for (const c of s) {
+        const cw = charColumns(c);
+        if (w + cw > maxCols - 1) {
+            result += "\u2026";
+            break;
+        }
+        result += c;
+        w += cw;
+    }
+    return result;
+}
+export function progressBar(percent, width) {
+    const clamped = Math.max(0, Math.min(100, percent));
+    const filled = Math.round((clamped / 100) * width);
+    const empty = Math.max(0, width - filled);
+    return "\u2588".repeat(filled) + "\u2591".repeat(empty);
+}
+export function fmt(n) {
+    if (n >= 1_000_000)
+        return (n / 1_000_000).toFixed(1) + "M";
+    if (n >= 10_000)
+        return (n / 1_000).toFixed(1) + "K";
+    return n.toLocaleString("en-US");
+}
+export function num(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+export function fmtCost(n, symbol = "$", rate = 1) {
+    const v = n * rate;
+    if (v >= 1)
+        return symbol + v.toFixed(2);
+    if (v >= 0.01)
+        return symbol + v.toFixed(3);
+    return symbol + v.toFixed(4);
+}
+/** 紧凑数字缩写（底部状态栏用）：1234 → "1.2K"，1234567 → "1.2M"。 */
+export function fmtCompact(n) {
+    if (n >= 1e6)
+        return (n / 1e6).toFixed(1) + "M";
+    if (n >= 1e3)
+        return (n / 1e3).toFixed(1) + "K";
+    return String(Math.round(n));
+}
+/** 余额数值格式化：≥1 或 0 显示固定 2 位小数；小额（<1）保留精度（最多 6 位），避免抹成 0.00。 */
+export function formatBalanceAmount(total) {
+    const n = parseFloat(total);
+    if (!Number.isFinite(n))
+        return total;
+    if (n === 0 || n >= 1)
+        return n.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+    return n.toLocaleString("en-US", { maximumFractionDigits: 6 });
+}

package/dist/core/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./color";
+export * from "./currency";
+export * from "./estimate";
+export * from "./format";
+export * from "./types";

package/dist/core/index.js

@@ -0,0 +1,5 @@
+export * from "./color";
+export * from "./currency";
+export * from "./estimate";
+export * from "./format";
+export * from "./types";

package/dist/core/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Token distribution breakdown for a session round.
+ * Pure data model shared by V1/V2 shells.
+ */
+export interface TokenDist {
+    system: number;
+    user: number;
+    agent: number;
+    toolCall: number;
+    toolResult: number;
+    output: number;
+    reasoning: number;
+    apiOutput: number;
+    apiInput: number;
+    stepCost: number;
+    stepCount: number;
+}

package/dist/core/types.js

@@ -0,0 +1 @@
+export {};