opencode-cache-hit 0.1.0 → 0.2.0

package/src/format-cost.ts

@@ -26,7 +26,7 @@ export const CURRENCY_PRESETS: Record<CurrencyCode, { symbol: string; decimals:
 export const DEFAULT_COST_DISPLAY: CostDisplayConfig = {
   currency: "CNY",
   costUnit: "USD",
-  rate: 7.2,
+  rate: 6.77,
 }
 
 function resolveExchangeRate(cfg: CostDisplayConfig): number {
@@ -88,3 +88,15 @@ export function createCostFormatter(config: CostDisplayConfig): (amountUsd: numb
     return "~" + symbol + v.toFixed(decimals)
   }
 }
+
+export function createRateFormatter(config: CostDisplayConfig): (perMillion: number) => string {
+  const preset = CURRENCY_PRESETS[config.currency]
+  const symbol = config.symbol ?? preset.symbol
+  const unit = config.costUnit ?? config.convert?.from ?? "USD"
+  const rate = unit === config.currency ? 1 : resolveExchangeRate(config)
+
+  return (perMillion: number) => {
+    const v = perMillion * rate
+    return symbol + v.toFixed(2)
+  }
+}

package/src/i18n.ts

@@ -10,7 +10,11 @@ export type UiStrings = {
   out: string
   reasoning: string
   cost: string
-  withAgents: string
+  saved: string
+  rate: string
+  rateIn: string
+  rateOut: string
+  rateCache: string
   hitFolded: string
   noData: string
   secDetail: string
@@ -19,6 +23,7 @@ export type UiStrings = {
   secAgents: string
   /** Shown in Agents section header: totals are child sessions only, not the parent session. */
   agentsScopeHint: string
+  secTTL: string
   tok: string
 }
 
@@ -32,7 +37,11 @@ const EN: UiStrings = {
   out: "Out:",
   reasoning: "Reason:",
   cost: "Cost:",
-  withAgents: "w/ Agents:",
+  saved: "Saved:",
+  rate: "Rate:",
+  rateIn: "/M in",
+  rateOut: "/M out",
+  rateCache: "/M cache",
   hitFolded: "hit",
   noData: "Waiting for cache data...",
   secDetail: "Detail",
@@ -40,6 +49,7 @@ const EN: UiStrings = {
   model: "Model:",
   secAgents: "Agents",
   agentsScopeHint: " · sub-sessions",
+  secTTL: "TTL:",
   tok: "tok",
 }
 
@@ -53,7 +63,11 @@ const ZH: UiStrings = {
   out: "输出:",
   reasoning: "推理:",
   cost: "费用:",
-  withAgents: "含 Agents:",
+  saved: "节省:",
+  rate: "单价:",
+  rateIn: "/M 输入",
+  rateOut: "/M 输出",
+  rateCache: "/M 缓存",
   hitFolded: "命中",
   noData: "等待缓存数据...",
   secDetail: "明细",
@@ -61,6 +75,7 @@ const ZH: UiStrings = {
   model: "模型:",
   secAgents: "子 Agent",
   agentsScopeHint: " · 仅子会话",
+  secTTL: "存活:",
   tok: "tok",
 }
 

package/src/load-config.ts

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from "node:fs"
-import { dirname, join } from "node:path"
+import { homedir } from "node:os"
+import { join } from "node:path"
 import { fileURLToPath } from "node:url"
 import {
   type PluginConfig,
@@ -9,6 +10,11 @@ import {
 
 /** Parent of `src/` (plugin package root). Do not wrap in `dirname` — `..` already resolves there. */
 export const PLUGIN_ROOT = fileURLToPath(new URL("..", import.meta.url))
+
+/** Preferred config: ~/.config/opencode/cache-hit.json (survives plugin updates). */
+export const XDG_CONFIG_PATH = join(homedir(), ".config", "opencode", "cache-hit.json")
+
+/** Legacy config: plugin-root `cache-hit.config.json` (for npm cache / local installs). */
 export const CONFIG_PATH = join(PLUGIN_ROOT, "cache-hit.config.json")
 
 function cloneDefault(): PluginConfig {
@@ -19,11 +25,24 @@ function cloneDefault(): PluginConfig {
   }
 }
 
-export function loadPluginConfig(): PluginConfig {
-  if (!existsSync(CONFIG_PATH)) return cloneDefault()
+function tryRead(path: string): PluginConfig | null {
   try {
-    return normalizePluginConfig(JSON.parse(readFileSync(CONFIG_PATH, "utf8")))
+    return normalizePluginConfig(JSON.parse(readFileSync(path, "utf8")))
   } catch {
-    return cloneDefault()
+    return null
+  }
+}
+
+export function loadPluginConfig(): PluginConfig {
+  // 1. XDG config dir (preferred — persists across updates)
+  if (existsSync(XDG_CONFIG_PATH)) {
+    const cfg = tryRead(XDG_CONFIG_PATH)
+    if (cfg) return cfg
+  }
+  // 2. Legacy plugin-root config (backward compatible)
+  if (existsSync(CONFIG_PATH)) {
+    const cfg = tryRead(CONFIG_PATH)
+    if (cfg) return cfg
   }
+  return cloneDefault()
 }

package/src/main-session-view.tsx

@@ -1,7 +1,10 @@
 /** @jsxImportSource @opentui/solid */
 import { Show } from "solid-js"
 import { TokenDetailRows } from "./cache-hit-rows.tsx"
+import { CacheTTLView } from "./cache-ttl-view.tsx"
 import type { CacheHitMetrics } from "./use-cache-hit-metrics.ts"
+import type { CacheTTLConfig } from "./plugin-config.ts"
+import type { AssistantMessage } from "./types.ts"
 import {
   TuiHitRow,
   TuiMetricRow,
@@ -9,6 +12,7 @@ import {
   type PanelLayout,
   type SectionFold,
 } from "./tui-panel/index.ts"
+import type { Accessor } from "solid-js"
 
 export function MainSessionView(props: {
   m: CacheHitMetrics
@@ -16,6 +20,9 @@ export function MainSessionView(props: {
   detail: SectionFold
   model: SectionFold
   formatCost: (n: number) => string
+  formatRate: (perMillion: number) => string
+  cacheTTL?: CacheTTLConfig
+  messages?: Accessor<AssistantMessage[]>
 }) {
   const { m, layout } = props
   return (
@@ -31,6 +38,15 @@ export function MainSessionView(props: {
         }
       />
       <TuiMetricRow pal={m.pal()} layout={layout} label={m.t().totalHit} value={m.sessionPct()} />
+      <Show when={props.cacheTTL?.enabled && props.messages}>
+        <CacheTTLView
+          messages={props.messages!}
+          config={props.cacheTTL!}
+          pal={m.pal()}
+          layout={layout}
+          label={m.t().secTTL}
+        />
+      </Show>
 
       <TuiSection
         pal={m.pal()}
@@ -40,12 +56,13 @@ export function MainSessionView(props: {
         onToggle={props.detail.toggle}
       >
         <TokenDetailRows pal={m.pal()} layout={layout} t={m.t()} snap={m.main()}>
-          <Show when={m.showCombinedHit()}>
+          <Show when={m.pricing().saved > 0}>
             <TuiMetricRow
               pal={m.pal()}
               layout={layout}
-              label={m.t().withAgents}
-              value={m.combinedPct()}
+              label={m.t().saved}
+              value={props.formatCost(m.pricing().saved)}
+              fg={m.pal().success}
             />
           </Show>
         </TokenDetailRows>
@@ -70,6 +87,29 @@ export function MainSessionView(props: {
         <Show when={m.modelShort()}>
           <TuiMetricRow pal={m.pal()} layout={layout} label={m.t().model} value={m.modelShort()} />
         </Show>
+        <Show when={m.pricing().inputRate > 0}>
+          <TuiMetricRow
+            pal={m.pal()}
+            layout={layout}
+            label={m.t().rate}
+            value={`${props.formatRate(m.pricing().inputRate)}${m.t().rateIn}`}
+            fg={m.pal().muted}
+          />
+          <TuiMetricRow
+            pal={m.pal()}
+            layout={layout}
+            label=""
+            value={`${props.formatRate(m.pricing().cacheReadRate)}${m.t().rateCache}`}
+            fg={m.pal().muted}
+          />
+          <TuiMetricRow
+            pal={m.pal()}
+            layout={layout}
+            label=""
+            value={`${props.formatRate(m.pricing().outputRate)}${m.t().rateOut}`}
+            fg={m.pal().muted}
+          />
+        </Show>
       </TuiSection>
     </>
   )

package/src/plugin-config.ts

@@ -19,7 +19,7 @@ export const DEFAULT_DISPLAY: DisplayConfig = {
 
 export type TimelineConfig = {
   enabled: boolean
-  /** Empty → plugin `logs/` directory */
+  /** Empty → `~/.local/share/opencode/logs/cache-hit`. Supports `~/…` expansion. */
   dir: string
   flushIncomplete: boolean
   logSummaryMessages: boolean
@@ -49,16 +49,29 @@ export const DEFAULT_TIMELINE: TimelineConfig = {
   maxLogFiles: 0,
 }
 
+export type CacheTTLConfig = {
+  enabled: boolean
+  /** TTL per provider (or provider:model). Values like "5m", "1h", "30s". Falls back to built-in defaults. */
+  providers: Record<string, string>
+}
+
+export const DEFAULT_CACHE_TTL: CacheTTLConfig = {
+  enabled: true,
+  providers: {},
+}
+
 export type PluginConfig = {
   cost: CostDisplayConfig
   display: DisplayConfig
   timeline: TimelineConfig
+  cacheTTL: CacheTTLConfig
 }
 
 export const DEFAULT_PLUGIN_CONFIG: PluginConfig = {
   cost: { ...DEFAULT_COST_DISPLAY },
   display: { ...DEFAULT_DISPLAY },
   timeline: { ...DEFAULT_TIMELINE },
+  cacheTTL: { ...DEFAULT_CACHE_TTL },
 }
 
 export function normalizeTimelineConfig(raw: unknown): TimelineConfig {
@@ -103,6 +116,50 @@ export function normalizeDisplayConfig(raw: unknown): DisplayConfig {
   return d
 }
 
+export function normalizeCacheTTLConfig(raw: unknown): CacheTTLConfig {
+  const t: CacheTTLConfig = { enabled: DEFAULT_CACHE_TTL.enabled, providers: {} }
+  if (!raw || typeof raw !== "object") return t
+  const o = raw as Record<string, unknown>
+  if (typeof o.enabled === "boolean") t.enabled = o.enabled
+  if (o.providers && typeof o.providers === "object") {
+    const providers = o.providers as Record<string, unknown>
+    for (const [key, value] of Object.entries(providers)) {
+      if (typeof value === "string") {
+        t.providers[key] = value
+      }
+    }
+  }
+  return t
+}
+
+const TIME_UNITS: Record<string, number> = {
+  s: 1000,
+  sec: 1000,
+  second: 1000,
+  seconds: 1000,
+  m: 60_000,
+  min: 60_000,
+  minute: 60_000,
+  minutes: 60_000,
+  h: 3_600_000,
+  hr: 3_600_000,
+  hour: 3_600_000,
+  hours: 3_600_000,
+}
+
+export function parseDuration(raw: string): number | null {
+  const match = raw.trim().match(/^(\d+(?:\.\d+)?)\s*([a-z]+)$/i)
+  if (!match) {
+    const num = Number(raw)
+    return Number.isFinite(num) && num > 0 ? Math.floor(num) : null
+  }
+  const value = Number(match[1])
+  const unit = match[2].toLowerCase()
+  const multiplier = TIME_UNITS[unit]
+  if (!multiplier || !Number.isFinite(value) || value <= 0) return null
+  return Math.floor(value * multiplier)
+}
+
 export function normalizePluginConfig(raw: unknown): PluginConfig {
   if (!raw || typeof raw !== "object") return { ...DEFAULT_PLUGIN_CONFIG }
   const o = raw as Record<string, unknown>
@@ -112,5 +169,6 @@ export function normalizePluginConfig(raw: unknown): PluginConfig {
     cost,
     display: normalizeDisplayConfig(displayRaw),
     timeline: normalizeTimelineConfig(o.timeline),
+    cacheTTL: normalizeCacheTTLConfig(o.cacheTTL),
   }
 }

package/src/plugin.tsx

@@ -1,7 +1,7 @@
 /** @jsxImportSource @opentui/solid */
 import { CacheHitSidebarHost } from "./sidebar-host.tsx"
 import { loadPluginConfig } from "./load-config.ts"
-import { createCostFormatter } from "./format-cost.ts"
+import { createCostFormatter, createRateFormatter } from "./format-cost.ts"
 import type { OpenCodeTuiApi } from "./types.ts"
 
 export const PLUGIN_ID = "opencode-cache-hit"
@@ -9,6 +9,7 @@ export const PLUGIN_ID = "opencode-cache-hit"
 export const tui = async (api: OpenCodeTuiApi) => {
   const pluginConfig = loadPluginConfig()
   const formatCost = createCostFormatter(pluginConfig.cost)
+  const formatRate = createRateFormatter(pluginConfig.cost)
 
   api.slots.register({
     order: 56,
@@ -20,7 +21,9 @@ export const tui = async (api: OpenCodeTuiApi) => {
             theme={ctx.theme.current}
             display={pluginConfig.display}
             timeline={pluginConfig.timeline}
+            cacheTTL={pluginConfig.cacheTTL}
             formatCost={formatCost}
+            formatRate={formatRate}
             api={api}
           />
         )

package/src/pricing.ts

@@ -0,0 +1,57 @@
+import type { ModelCost, ProviderInfo, SubAgentSummary } from "./types.ts"
+
+export type PricingInfo = {
+  inputRate: number
+  outputRate: number
+  cacheReadRate: number
+  cacheWriteRate: number
+  saved: number
+}
+
+export const EMPTY_PRICING: PricingInfo = {
+  inputRate: 0,
+  outputRate: 0,
+  cacheReadRate: 0,
+  cacheWriteRate: 0,
+  saved: 0,
+}
+
+export function lookupModelCost(
+  providers: ReadonlyArray<ProviderInfo>,
+  providerID: string | undefined,
+  modelID: string | undefined,
+): ModelCost | null {
+  if (!providerID || !modelID) return null
+  for (const p of providers) {
+    if (p.id !== providerID) continue
+    const model = p.models[modelID]
+    return model?.cost ?? null
+  }
+  return null
+}
+
+export function computePricing(
+  providers: ReadonlyArray<ProviderInfo>,
+  providerID: string | undefined,
+  modelID: string | undefined,
+  cacheRead: number,
+): PricingInfo {
+  const cost = lookupModelCost(providers, providerID, modelID)
+  if (!cost) return EMPTY_PRICING
+  const inputRate = cost.input
+  const outputRate = cost.output
+  const cacheReadRate = cost.cache.read
+  const cacheWriteRate = cost.cache.write
+  const saved =
+    inputRate > cacheReadRate ? (cacheRead * (inputRate - cacheReadRate)) / 1_000_000 : 0
+  return { inputRate, outputRate, cacheReadRate, cacheWriteRate, saved }
+}
+
+export function computeSubsSaved(subs: readonly SubAgentSummary[], providers: ReadonlyArray<ProviderInfo>): number {
+  let total = 0
+  for (const sub of subs) {
+    const p = computePricing(providers, sub.providerID, sub.model, sub.cacheRead)
+    total += p.saved
+  }
+  return total
+}

package/src/sidebar-host.tsx

@@ -1,7 +1,7 @@
 /** @jsxImportSource @opentui/solid */
 import { createSignal, createMemo, createEffect, onCleanup } from "solid-js"
 import { CacheHitSidebar } from "./widget.tsx"
-import type { DisplayConfig, TimelineConfig } from "./plugin-config.ts"
+import type { DisplayConfig, TimelineConfig, CacheTTLConfig } from "./plugin-config.ts"
 import { createTimelineCollector } from "./timeline/collector.ts"
 import type { AssistantMessage, OpenCodeTuiApi, SubAgentSummary } from "./types.ts"
 import {
@@ -22,7 +22,9 @@ export function CacheHitSidebarHost(props: {
   theme: Record<string, unknown>
   display: DisplayConfig
   timeline: TimelineConfig
+  cacheTTL: CacheTTLConfig
   formatCost: (amount: number) => string
+  formatRate: (perMillion: number) => string
   api: OpenCodeTuiApi
 }) {
   const [refreshTick, setRefreshTick] = createSignal(0)
@@ -34,6 +36,7 @@ export function CacheHitSidebarHost(props: {
     return loadPluginConfig()
   })
   const display = createMemo(() => runtimeConfig().display)
+  const cacheTTL = createMemo(() => runtimeConfig().cacheTTL)
 
   const bumpRefresh = () => setRefreshTick((v) => v + 1)
 
@@ -112,10 +115,13 @@ export function CacheHitSidebarHost(props: {
       sessionId={() => props.sessionId}
       theme={props.theme}
       display={display()}
+      cacheTTL={cacheTTL()}
       messages={mainMessages}
       main={mainSnap}
       subAgents={subAgentList}
+      providers={() => props.api.state.provider ?? []}
       formatCost={props.formatCost}
+      formatRate={props.formatRate}
     />
   )
 }

package/src/stats.ts

@@ -11,11 +11,12 @@ export function mainSessionHasStats(main: SessionSnapshot): boolean {
 }
 
 export function emptySessionSnapshot(): SessionSnapshot {
-  return { model: "", input: 0, output: 0, reasoning: 0, cacheRead: 0, cacheWrite: 0, cost: 0 }
+  return { model: "", providerID: "", input: 0, output: 0, reasoning: 0, cacheRead: 0, cacheWrite: 0, cost: 0 }
 }
 
 export function aggregateSessionFromMessages(messages: readonly AssistantMessage[]): SessionSnapshot {
   let model = "",
+    providerID = "",
     input = 0,
     output = 0,
     reasoning = 0,
@@ -32,13 +33,16 @@ export function aggregateSessionFromMessages(messages: readonly AssistantMessage
     cacheWrite += t.cache?.write ?? 0
     cost += msg.cost ?? 0
     if (msg.modelID) model = msg.modelID
+    if (msg.providerID) providerID = msg.providerID
   }
-  return { model, input, output, reasoning, cacheRead, cacheWrite, cost }
+  return { model, providerID, input, output, reasoning, cacheRead, cacheWrite, cost }
 }
 
 export function toSubAgentSummary(id: string, snap: SessionSnapshot): SubAgentSummary {
   return {
     id,
+    model: snap.model,
+    providerID: snap.providerID,
     cost: snap.cost,
     input: snap.input,
     output: snap.output,
@@ -66,19 +70,6 @@ export function cacheHitRatio(cacheRead: number, input: number): number {
   return denom > 0 ? cacheRead / denom : 0
 }
 
-export function combinedCacheHitRatio(
-  main: SessionSnapshot,
-  subs: readonly Pick<SubAgentSummary, "cacheRead" | "input">[],
-): number {
-  let cacheRead = main.cacheRead
-  let input = main.input
-  for (const s of subs) {
-    cacheRead += s.cacheRead
-    input += s.input
-  }
-  return cacheHitRatio(cacheRead, input)
-}
-
 export function subAgentHasStats(snap: SessionSnapshot): boolean {
   return (
     snap.cost > 0 ||

package/src/timeline/records.ts

@@ -3,6 +3,21 @@ import { perMessageHitPercent } from "../stats.ts"
 import type { AssistantMessage } from "../types.ts"
 import type { LlmCallRecord } from "./types.ts"
 
+/** Convert milliseconds timestamp to ISO 8601 with local timezone offset. */
+export function msToISOString(ms: number): string {
+  const d = new Date(ms)
+  const off = -d.getTimezoneOffset()
+  const sign = off >= 0 ? "+" : "-"
+  const hh = String(Math.floor(Math.abs(off) / 60)).padStart(2, "0")
+  const mm = String(Math.abs(off) % 60).padStart(2, "0")
+  const pad = (n: number, len = 2) => String(n).padStart(len, "0")
+  return (
+    `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}` +
+    `T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}` +
+    `.${pad(d.getMilliseconds(), 3)}${sign}${hh}:${mm}`
+  )
+}
+
 export function messageKeyFor(msg: AssistantMessage, sessionId: string): string {
   const id = msg.id ?? msg.messageID
   if (typeof id === "string" && id.length > 0) return `${sessionId}:${id}`
@@ -11,7 +26,15 @@ export function messageKeyFor(msg: AssistantMessage, sessionId: string): string
 }
 
 export function sortKeyForRecord(r: LlmCallRecord): number {
-  return r.completedAt ?? r.created
+  const ts = r.completedAt ?? r.created
+  return new Date(ts).getTime()
+}
+
+export function mergeAndSortRecords(chunks: readonly LlmCallRecord[][]): LlmCallRecord[] {
+  const all = chunks.flat()
+  const keyed = all.map(r => ({ r, k: sortKeyForRecord(r) }))
+  keyed.sort((a, b) => a.k - b.k)
+  return keyed.map(x => x.r)
 }
 
 export function assistantMessageToRecord(
@@ -28,14 +51,14 @@ export function assistantMessageToRecord(
   const skippedForHit = msg.summary === true
   return {
     schema: 1,
-    recordedAt,
+    recordedAt: msToISOString(recordedAt),
     sessionId,
     rootSessionId,
     scope,
     messageKey: messageKeyFor(msg, sessionId),
     modelId: msg.modelID ?? "",
-    created: timing.created,
-    completedAt: timing.completedAt,
+    created: msToISOString(timing.created),
+    completedAt: timing.completedAt !== undefined ? msToISOString(timing.completedAt) : undefined,
     durationMs: timing.durationMs,
     isComplete: timing.isComplete,
     input: t.input ?? 0,
@@ -67,7 +90,3 @@ export function buildCallRecords(
   return out
 }
 
-export function mergeAndSortRecords(chunks: readonly LlmCallRecord[][]): LlmCallRecord[] {
-  const all = chunks.flat()
-  return all.sort((a, b) => sortKeyForRecord(a) - sortKeyForRecord(b))
-}

package/src/timeline/types.ts

@@ -1,14 +1,14 @@
 /** Single LLM call row (one JSONL line). */
 export type LlmCallRecord = {
   schema: 1
-  recordedAt: number
+  recordedAt: string
   sessionId: string
   rootSessionId: string
   scope: "main" | "child"
   messageKey: string
   modelId: string
-  created: number
-  completedAt?: number
+  created: string
+  completedAt?: string
   durationMs?: number
   isComplete: boolean
   input: number

package/src/timeline/writer.ts

@@ -1,11 +1,11 @@
 import { appendFile, mkdir, readdir, stat, unlink } from "node:fs/promises"
+import { homedir } from "node:os"
 import { dirname, join } from "node:path"
 import type { TimelineConfig } from "../plugin-config.ts"
-import { PLUGIN_ROOT } from "../load-config.ts"
 import type { LlmCallRecord } from "./types.ts"
 import { rotateFileBySize, trimFileToMaxLines } from "./rotation.ts"
 
-export const DEFAULT_TIMELINE_DIR = join(PLUGIN_ROOT, "logs")
+export const DEFAULT_TIMELINE_DIR = join(homedir(), ".local", "share", "opencode", "logs", "cache-hit")
 export const TIMELINE_FILE_PREFIX = "timeline"
 
 export type TimelineWriteOptions = Pick<
@@ -14,8 +14,9 @@ export type TimelineWriteOptions = Pick<
 >
 
 export function resolveTimelineDir(config: TimelineConfig): string {
-  const raw = config.dir?.trim()
-  return raw.length > 0 ? raw : DEFAULT_TIMELINE_DIR
+  const raw = (config.dir ?? "").trim()
+  if (!raw) return DEFAULT_TIMELINE_DIR
+  return raw.startsWith("~/") ? join(homedir(), raw.slice(2)) : raw
 }
 
 /** Local calendar day `YYYY-MM-DD` for daily log files. */

package/src/types.ts

@@ -1,5 +1,6 @@
 export type SessionSnapshot = {
   model: string
+  providerID: string
   input: number
   output: number
   reasoning: number
@@ -10,6 +11,8 @@ export type SessionSnapshot = {
 
 export type SubAgentSummary = {
   id: string
+  model: string
+  providerID: string
   cost: number
   input: number
   output: number
@@ -23,6 +26,7 @@ export type AssistantMessage = {
   id?: string
   messageID?: string
   modelID?: string
+  providerID?: string
   cost?: number
   /** OpenCode SDK: true = summary/compaction message, not a full LLM pricing turn */
   summary?: boolean
@@ -38,9 +42,21 @@ export type AssistantMessage = {
   }
 }
 
+export type ModelCost = {
+  input: number
+  output: number
+  cache: { read: number; write: number }
+}
+
+export type ProviderInfo = {
+  id: string
+  models: { [key: string]: { cost: ModelCost } }
+}
+
 export type OpenCodeTuiApi = {
   state: {
     path: { directory: string }
+    provider: ReadonlyArray<ProviderInfo>
     session: {
       messages: (id: string) => unknown[] | undefined
       get: (id: string) => { parentID?: string } | undefined