opencode-visual-cache 1.7.0-beta.3 → 1.7.0-beta.5

package/src/panel/panel-api.ts

@@ -1,104 +1,104 @@
-import type { Message, Part, Session } from "@opencode-ai/sdk"
-import type { TuiThemeCurrent } from "@opencode-ai/plugin/tui"
-import type { BalanceEntry } from "../balance-providers"
-import type { LangCode } from "../i18n"
-
-/** 会话信息（面板消费的字段；SDK Session 类型过严，用宽松接口） */
-export interface PanelSession {
-  id: string
-  title?: string
-  agent?: string
-  model?: { providerID?: string; id?: string }
-  tokens?: { input?: number; output?: number; reasoning?: number; cache?: { read?: number; write?: number } }
-  cost?: number
-  [key: string]: unknown
-}
-
-/**
- * Panel API 契约：TokenCachePanel 消费的宿主 API 子集。
- * V1（TuiPluginApi）天然满足；V2（opencode2 context）由 v2-panel-api 适配实现。
- */
-export interface PanelApi {
-  kv: {
-    ready: boolean
-    get<T>(key: string, fallback?: T): T | undefined
-    set(key: string, value: unknown): void | Promise<void>
-  }
-  state: {
-    session: {
-      get(id: string): PanelSession | undefined
-      /** V1 返回 sdk/v2 的 Message、V2 返回 SessionMessageInfo——统一放宽 */
-      messages(id: string): readonly any[]
-    }
-    provider: readonly Record<string, any>[]
-    config: any
-    part(messageID: string): readonly any[]
-    path: { directory: string }
-  }
-  event: {
-    on(type: string, handler: (event: unknown) => void): () => void
-  }
-  renderer: { terminalWidth: number }
-  keys: { formatBindings(binding: unknown): string | undefined }
-  tuiConfig: { keybinds: { get(command: string): unknown } }
-}
-
-export interface BalanceState {
-  status: "idle" | "loading" | "ok" | "error"
-  data: BalanceEntry[] | null
-  lastFetch: number
-  error?: string
-  key?: string // 上次成功/尝试查询所用的 key，用于检测 key 是否更换
-}
-
-/** Signals shared between the TUI component and slash commands.
- *  Created in the `tui` function scope so they do not survive module reload —
- *  the component re-creates them on mount and restores user config from kv. */
-export interface PanelSignals {
-  currencySymbol: () => string
-  setCurrencySymbol: (v: string) => void
-  exchangeRate: () => number
-  setExchangeRate: (v: number) => void
-  langCode: () => LangCode
-  setLangCode: (v: LangCode) => void
-  sectionDetail: () => boolean
-  setSectionDetail: (v: boolean) => void
-  sectionModel: () => boolean
-  setSectionModel: (v: boolean) => void
-  sectionDist: () => boolean
-  setSectionDist: (v: boolean) => void
-  sectionSkills: () => boolean
-  setSectionSkills: (v: boolean) => void
-  sectionBalance: () => boolean
-  setSectionBalance: (v: boolean) => void
-  /** Bottom status bar (prompt hint line) visibility. */
-  sectionBottom: () => boolean
-  setSectionBottom: (v: boolean) => void
-  /** Increment to force a balance re-fetch. */
-  balanceRefresh: () => number
-  setBalanceRefresh: (v: number) => void
-  /** Currently selected balance provider id (e.g. "deepseek"). */
-  balanceProviderId: () => string
-  setBalanceProviderId: (v: string) => void
-  /** Auto-switch to the session's provider for balance display. Manual switch disables it. */
-  autoBalance: () => boolean
-  setAutoBalance: (v: boolean) => void
-  /** True when the session's provider has no balance adapter (auto mode). Suppresses balance polling. */
-  balanceUnsupported: () => boolean
-  setBalanceUnsupported: (v: boolean) => void
-  /** Shared balance query state — single source of truth for sidebar and bottom bar. */
-  balanceState: () => BalanceState
-  /** Preferred currency code for balance display (CNY / USD / …). Empty = first entry. */
-  balanceCurrency: () => string
-  setBalanceCurrency: (v: string) => void
-  borderVisible: () => boolean
-  setBorderVisible: (v: boolean) => void
-  /** When set, the panel renders stats for this session instead of the main one. */
-  overrideSessionId: () => string | undefined
-  setOverrideSessionId: (v: string | undefined) => void
-  /** True while our sidebar panel is mounted — host sidebar is visible (occupies 42 cols). */
-  sidebarVisible: () => boolean
-  setSidebarVisible: (v: boolean) => void
-}
-
-export type { TuiThemeCurrent }
+import type { Message, Part, Session } from "@opencode-ai/sdk"
+import type { TuiThemeCurrent } from "@opencode-ai/plugin/tui"
+import type { BalanceEntry } from "../balance-providers"
+import type { LangCode } from "../i18n"
+
+/** 会话信息（面板消费的字段；SDK Session 类型过严，用宽松接口） */
+export interface PanelSession {
+  id: string
+  title?: string
+  agent?: string
+  model?: { providerID?: string; id?: string }
+  tokens?: { input?: number; output?: number; reasoning?: number; cache?: { read?: number; write?: number } }
+  cost?: number
+  [key: string]: unknown
+}
+
+/**
+ * Panel API 契约：TokenCachePanel 消费的宿主 API 子集。
+ * V1（TuiPluginApi）天然满足；V2（opencode2 context）由 v2-panel-api 适配实现。
+ */
+export interface PanelApi {
+  kv: {
+    ready: boolean
+    get<T>(key: string, fallback?: T): T | undefined
+    set(key: string, value: unknown): void | Promise<void>
+  }
+  state: {
+    session: {
+      get(id: string): PanelSession | undefined
+      /** V1 返回 sdk/v2 的 Message、V2 返回 SessionMessageInfo——统一放宽 */
+      messages(id: string): readonly any[]
+    }
+    provider: readonly Record<string, any>[]
+    config: any
+    part(messageID: string): readonly any[]
+    path: { directory: string }
+  }
+  event: {
+    on(type: string, handler: (event: unknown) => void): () => void
+  }
+  renderer: { terminalWidth: number }
+  keys: { formatBindings(binding: unknown): string | undefined }
+  tuiConfig: { keybinds: { get(command: string): unknown } }
+}
+
+export interface BalanceState {
+  status: "idle" | "loading" | "ok" | "error"
+  data: BalanceEntry[] | null
+  lastFetch: number
+  error?: string
+  key?: string // 上次成功/尝试查询所用的 key，用于检测 key 是否更换
+}
+
+/** Signals shared between the TUI component and slash commands.
+ *  Created in the `tui` function scope so they do not survive module reload —
+ *  the component re-creates them on mount and restores user config from kv. */
+export interface PanelSignals {
+  currencySymbol: () => string
+  setCurrencySymbol: (v: string) => void
+  exchangeRate: () => number
+  setExchangeRate: (v: number) => void
+  langCode: () => LangCode
+  setLangCode: (v: LangCode) => void
+  sectionDetail: () => boolean
+  setSectionDetail: (v: boolean) => void
+  sectionModel: () => boolean
+  setSectionModel: (v: boolean) => void
+  sectionDist: () => boolean
+  setSectionDist: (v: boolean) => void
+  sectionSkills: () => boolean
+  setSectionSkills: (v: boolean) => void
+  sectionBalance: () => boolean
+  setSectionBalance: (v: boolean) => void
+  /** Bottom status bar (prompt hint line) visibility. */
+  sectionBottom: () => boolean
+  setSectionBottom: (v: boolean) => void
+  /** Increment to force a balance re-fetch. */
+  balanceRefresh: () => number
+  setBalanceRefresh: (v: number) => void
+  /** Currently selected balance provider id (e.g. "deepseek"). */
+  balanceProviderId: () => string
+  setBalanceProviderId: (v: string) => void
+  /** Auto-switch to the session's provider for balance display. Manual switch disables it. */
+  autoBalance: () => boolean
+  setAutoBalance: (v: boolean) => void
+  /** True when the session's provider has no balance adapter (auto mode). Suppresses balance polling. */
+  balanceUnsupported: () => boolean
+  setBalanceUnsupported: (v: boolean) => void
+  /** Shared balance query state — single source of truth for sidebar and bottom bar. */
+  balanceState: () => BalanceState
+  /** Preferred currency code for balance display (CNY / USD / …). Empty = first entry. */
+  balanceCurrency: () => string
+  setBalanceCurrency: (v: string) => void
+  borderVisible: () => boolean
+  setBorderVisible: (v: boolean) => void
+  /** When set, the panel renders stats for this session instead of the main one. */
+  overrideSessionId: () => string | undefined
+  setOverrideSessionId: (v: string | undefined) => void
+  /** True while our sidebar panel is mounted — host sidebar is visible (occupies 42 cols). */
+  sidebarVisible: () => boolean
+  setSidebarVisible: (v: boolean) => void
+}
+
+export type { TuiThemeCurrent }

package/src/v2/data.ts

@@ -1,112 +1,112 @@
-import type { Context, MessageInfo } from "./types"
-import { num } from "../core"
-
-/** 汇总一个会话的 token 用量与费用（V2 adapter → 同构模型）。 */
-export interface SessionStats {
-  input: number
-  output: number
-  cacheRead: number
-  cacheWrite: number
-  reasoning: number
-  cost: number
-  hasData: boolean
-}
-
-/** 从 messages 汇总 token：统计全部 assistant 消息的 API 精确值。 */
-export function collectSessionStats(context: Context, sessionID: string): SessionStats {
-  const msgs = context.data.session.message.list(sessionID) ?? []
-  let input = 0
-  let output = 0
-  let cacheRead = 0
-  let cacheWrite = 0
-  let reasoning = 0
-  let cost = 0
-  let hasData = false
-
-  for (const m of msgs) {
-    if (m.type !== "assistant") continue
-    const t = m.tokens
-    if (!t) continue
-    input += num(t.input)
-    output += num(t.output)
-    reasoning += num(t.reasoning)
-    cacheRead += num(t.cache?.read)
-    cacheWrite += num(t.cache?.write)
-    hasData = true
-  }
-  // 会话级费用优先（V2 提供 cost()），消息级 cost 兜底（结构未知，宽松读取）
-  const sessionCost = context.data.session.cost(sessionID)
-  if (Number.isFinite(sessionCost) && sessionCost > 0) cost = sessionCost
-  else {
-    for (const m of msgs) {
-      if (m.type !== "assistant" || m.cost == null) continue
-      const c = m.cost as { amount?: unknown; total?: unknown } | { amount?: unknown } | number
-      if (typeof c === "number" && Number.isFinite(c)) cost += c
-      else {
-        const amt = (c as { amount?: unknown }).amount
-        if (typeof amt === "number" && Number.isFinite(amt)) cost += amt
-        else if (typeof amt === "string") {
-          const n = parseFloat(amt)
-          if (Number.isFinite(n)) cost += n
-        }
-      }
-    }
-  }
-  return { input, output, cacheRead, cacheWrite, reasoning, cost, hasData }
-}
-
-/** 缓存命中率（0–100）：缓存读 /（新鲜输入 + 缓存读 + 缓存写），与 V1 口径一致。 */
-export function hitRate(stats: SessionStats): number {
-  const denom = stats.input + stats.cacheRead + stats.cacheWrite
-  if (denom <= 0) return 0
-  return (stats.cacheRead / denom) * 100
-}
-
-/** 输入侧总量（底部栏口径，不含输出）。 */
-export function inputTotal(stats: SessionStats): number {
-  return stats.input + stats.cacheRead + stats.cacheWrite
-}
-
-/** 单条命中率（V1 底部栏口径）：最后一条有 token 的 assistant 消息，
- *  分母含缓存写 read/(input+read+write)；prevHitRate 为上一条（趋势用）。 */
-export function collectLastHitRate(context: Context, sessionID: string): {
-  hitRate: number
-  prevHitRate: number
-  input: number
-  read: number
-  write: number
-} {
-  const msgs = context.data.session.message.list(sessionID) ?? []
-  const session = context.data.session.get(sessionID) as { tokens?: { input?: number; cache?: { read?: number; write?: number } } } | undefined
-  let input = num(session?.tokens?.input)
-  let read = num(session?.tokens?.cache?.read)
-  let write = num(session?.tokens?.cache?.write)
-  // 无 session 聚合字段 → 遍历消息累加（与 V1 fallback 一致）
-  if (session?.tokens == null) {
-    for (const m of msgs) {
-      if (m.type !== "assistant") continue
-      const t = m.tokens
-      if (!t) continue
-      input += num(t.input)
-      read += num(t.cache?.read)
-      write += num(t.cache?.write)
-    }
-  }
-  let hitRate = -1, prevHitRate = -1
-  for (let i = msgs.length - 1; i >= 0; i--) {
-    const m = msgs[i]
-    if (m.type !== "assistant") continue
-    const tk = m.tokens
-    if (!tk) continue
-    const mit = num(tk.input) + num(tk.cache?.read) + num(tk.cache?.write)
-    const mrt = num(tk.cache?.read)
-    if (mit <= 0) continue
-    const rate = (mrt / mit) * 100
-    if (hitRate < 0) { hitRate = rate; continue }
-    prevHitRate = rate
-    break
-  }
-  return { hitRate, prevHitRate, input, read, write }
-}
-
-export type { MessageInfo }
+import type { Context, MessageInfo } from "./types"
+import { num } from "../core"
+
+/** 汇总一个会话的 token 用量与费用（V2 adapter → 同构模型）。 */
+export interface SessionStats {
+  input: number
+  output: number
+  cacheRead: number
+  cacheWrite: number
+  reasoning: number
+  cost: number
+  hasData: boolean
+}
+
+/** 从 messages 汇总 token：统计全部 assistant 消息的 API 精确值。 */
+export function collectSessionStats(context: Context, sessionID: string): SessionStats {
+  const msgs = context.data.session.message.list(sessionID) ?? []
+  let input = 0
+  let output = 0
+  let cacheRead = 0
+  let cacheWrite = 0
+  let reasoning = 0
+  let cost = 0
+  let hasData = false
+
+  for (const m of msgs) {
+    if (m.type !== "assistant") continue
+    const t = m.tokens
+    if (!t) continue
+    input += num(t.input)
+    output += num(t.output)
+    reasoning += num(t.reasoning)
+    cacheRead += num(t.cache?.read)
+    cacheWrite += num(t.cache?.write)
+    hasData = true
+  }
+  // 会话级费用优先（V2 提供 cost()），消息级 cost 兜底（结构未知，宽松读取）
+  const sessionCost = context.data.session.cost(sessionID)
+  if (Number.isFinite(sessionCost) && sessionCost > 0) cost = sessionCost
+  else {
+    for (const m of msgs) {
+      if (m.type !== "assistant" || m.cost == null) continue
+      const c = m.cost as { amount?: unknown; total?: unknown } | { amount?: unknown } | number
+      if (typeof c === "number" && Number.isFinite(c)) cost += c
+      else {
+        const amt = (c as { amount?: unknown }).amount
+        if (typeof amt === "number" && Number.isFinite(amt)) cost += amt
+        else if (typeof amt === "string") {
+          const n = parseFloat(amt)
+          if (Number.isFinite(n)) cost += n
+        }
+      }
+    }
+  }
+  return { input, output, cacheRead, cacheWrite, reasoning, cost, hasData }
+}
+
+/** 缓存命中率（0–100）：缓存读 /（新鲜输入 + 缓存读 + 缓存写），与 V1 口径一致。 */
+export function hitRate(stats: SessionStats): number {
+  const denom = stats.input + stats.cacheRead + stats.cacheWrite
+  if (denom <= 0) return 0
+  return (stats.cacheRead / denom) * 100
+}
+
+/** 输入侧总量（底部栏口径，不含输出）。 */
+export function inputTotal(stats: SessionStats): number {
+  return stats.input + stats.cacheRead + stats.cacheWrite
+}
+
+/** 单条命中率（V1 底部栏口径）：最后一条有 token 的 assistant 消息，
+ *  分母含缓存写 read/(input+read+write)；prevHitRate 为上一条（趋势用）。 */
+export function collectLastHitRate(context: Context, sessionID: string): {
+  hitRate: number
+  prevHitRate: number
+  input: number
+  read: number
+  write: number
+} {
+  const msgs = context.data.session.message.list(sessionID) ?? []
+  const session = context.data.session.get(sessionID) as { tokens?: { input?: number; cache?: { read?: number; write?: number } } } | undefined
+  let input = num(session?.tokens?.input)
+  let read = num(session?.tokens?.cache?.read)
+  let write = num(session?.tokens?.cache?.write)
+  // 无 session 聚合字段 → 遍历消息累加（与 V1 fallback 一致）
+  if (session?.tokens == null) {
+    for (const m of msgs) {
+      if (m.type !== "assistant") continue
+      const t = m.tokens
+      if (!t) continue
+      input += num(t.input)
+      read += num(t.cache?.read)
+      write += num(t.cache?.write)
+    }
+  }
+  let hitRate = -1, prevHitRate = -1
+  for (let i = msgs.length - 1; i >= 0; i--) {
+    const m = msgs[i]
+    if (m.type !== "assistant") continue
+    const tk = m.tokens
+    if (!tk) continue
+    const mit = num(tk.input) + num(tk.cache?.read) + num(tk.cache?.write)
+    const mrt = num(tk.cache?.read)
+    if (mit <= 0) continue
+    const rate = (mrt / mit) * 100
+    if (hitRate < 0) { hitRate = rate; continue }
+    prevHitRate = rate
+    break
+  }
+  return { hitRate, prevHitRate, input, read, write }
+}
+
+export type { MessageInfo }