opencode-tokenwatch 0.3.0 → 0.3.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 TTWK
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 TTWK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -1,97 +1,104 @@
-# opencode-tokenwatch
-
-**English** · [简体中文](./README.md)
-
-![Sidebar](./assets/sidebar.png)
-
-Real-time token usage, cache analytics & performance dashboard plugin for OpenCode CLI.
-
-## Features
-
-- **Sidebar panel** — Session-level and per-model real-time stats (requests, tokens, cache, latency, cost)
-- **Cache hit rate** — Inline progress bars with color thresholds, trend indicators (↑/↓), and global weighted cache hit rate in the summary row
-- **Performance metrics** — TTFT / TPS / End-to-end latency + P50/P95/P99 latency percentiles
-- **Token distribution** — 5-bucket role breakdown (system, user, Agent, Tool and other with fallback and adaptive scaling)
-- **Error rate statistics** — Detects and tracks failed requests (empty token response) and real-time error rate
-- **Model pricing** — Input/cache/output unit prices
-- **`/usage` command** — HTML Report → JSON Export → Text Report → Settings
-- **HTML report** — Interactive ECharts dashboard: Token distribution, performance percentiles, error rate analysis, model speed rankings (redesigned from overlapping scatter plots to horizontal bar charts), auto-opened in browser
-- **Multi-level collapse** — Panel, models, and sub-blocks collapsible with persisted state
-- **Language switching** — Auto-detect or manually switch between Chinese and English
-- **Per-request tracking** — TTFT/TPS/latency logged to JSONL for report analysis
-- **Adaptive coloring** — Colors auto-derived from theme
-
-## Install
-
-```sh
-npm install opencode-tokenwatch
-```
-
-Add to `opencode.json` or `opencode.jsonc`:
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-tokenwatch"]
-}
-```
-
-## Configuration
-
-```jsonc
-{
-  "plugin": ["opencode-tokenwatch"],
-  "pluginConfig": {
-    "opencode-tokenwatch": {
-      "sidebar": {
-        "showPerformance": true,
-        "showPricing": false,
-        "showTokenDistribution": false,
-        "showTrend": true
-      },
-      "language": "auto"
-    }
-  }
-}
-```
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `sidebar.showPerformance` | boolean | `true` | Show TTFT/TPS/latency |
-| `sidebar.showPricing` | boolean | `true` | Show model pricing |
-| `sidebar.showTokenDistribution` | boolean | `true` | Show token distribution |
-| `sidebar.showTrend` | boolean | `true` | Show trend indicator |
-| `language` | `"auto"` / `"zh"` / `"en"` | `"auto"` | UI language |
-
-Settings can also be toggled via `/usage` → Settings, taking precedence over `pluginConfig`.
-
-## Usage
-
-In OpenCode TUI, run `/usage`:
-
-- **HTML Report** — Pick a date range, generates a dashboard and opens it in browser
-- **JSON Export** — Exports full usage data to `~/.opencode/reports/`
-- **Text Report** — Exports Markdown report to `~/.opencode/reports/`
-- **Settings** — Toggle sidebar blocks, switch language
-
-## Requirements
-
-- OpenCode CLI (with `opencode db` command)
-- Node.js 18+
-
-## Build
-
-```sh
-npm install
-npm run build
-```
-
-## Related
-
-- [opencode-throughput](https://github.com/Howardzhangdqs/opencode-throughput) — Real-time LLM performance monitoring (TTFT/TPS/latency/cost)
-- [opencode-visual-cache](https://github.com/Hotakus/opencode-visual-cache) — TUI sidebar cache hit rate visualization, token distribution analysis
-- [magic-context](https://github.com/cortexkit/magic-context/) — Cache-aware infinite context + cross-session memory system
-
-## License
-
-MIT
+# opencode-tokenwatch
+
+**English** · [简体中文](./README.md)
+
+![Sidebar](./assets/sidebar.png)
+
+Real-time token usage, cache analytics & performance dashboard plugin for OpenCode CLI.
+
+## Features
+
+- **Sidebar panel** — Session-level and per-model real-time stats (requests, tokens, cache, cost)
+- **Cache hit rate** — Inline color progress bars with trend indicators (↑/↓) and global weighted hit rate
+- **Performance metrics** — TTFT / TPS / End-to-end latency + P50/P95/P99 latency percentiles
+- **Token distribution** — 5-bucket role breakdown (system / user / toolCall / toolResult / output + other fallback)
+- **Error rate tracking** — Detects failed requests (empty token response) and computes real-time error rate
+- **Cost display** — Per-model cost (requires provider billing data)
+- **`/usage` command** — HTML Report → JSON Export → Text Report → Settings
+- **HTML report** — Interactive ECharts dashboard: token distribution, performance percentiles, TPS horizontal ranking, error rate analysis — auto-opened in browser
+- **Persistent stats** — Performance metrics (TPS/TTFT/latency) written to a dedicated JSON file that accumulates forever, unaffected by log rotation
+- **Multi-level collapse** — Panel, models, and sub-blocks collapsible with persisted state
+- **Language switching** — Auto-detect or manually switch between Chinese and English
+
+## Install
+
+```sh
+npm install opencode-tokenwatch
+```
+
+Add to `opencode.json` or `opencode.jsonc`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-tokenwatch"]
+}
+```
+
+## Configuration
+
+```jsonc
+{
+  "plugin": ["opencode-tokenwatch"],
+  "pluginConfig": {
+    "opencode-tokenwatch": {
+      "sidebar": {
+        "showPerformance": true,
+        "showPricing": true,
+        "showTokenDistribution": true,
+        "showTrend": true
+      },
+      "language": "auto"
+    }
+  }
+}
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `sidebar.showPerformance` | boolean | `true` | Show TTFT/TPS/latency |
+| `sidebar.showPricing` | boolean | `true` | Show request cost |
+| `sidebar.showTokenDistribution` | boolean | `true` | Show token distribution |
+| `sidebar.showTrend` | boolean | `true` | Show trend indicator |
+| `language` | `"auto"` / `"zh"` / `"en"` | `"auto"` | UI language |
+
+Settings can also be toggled via `/usage` → Settings, taking precedence over `pluginConfig`.
+
+## Usage
+
+In OpenCode TUI, run `/usage`:
+
+- **HTML Report** — Pick a date range, generates a dashboard and opens it in browser
+- **JSON Export** — Exports full usage data to `~/.opencode/reports/`
+- **Text Report** — Exports Markdown report to `~/.opencode/reports/`
+- **Settings** — Toggle sidebar blocks, switch language
+
+## Data Files
+
+| File | Path | Description |
+|------|------|-------------|
+| JSONL log | `~/.opencode/tokenwatch.jsonl` | Raw per-request log, auto-rotated at 5 MB |
+| Aggregated stats | `~/.opencode/tokenwatch-stats.json` | Persistent performance stats, accumulates forever |
+| Report output | `~/.opencode/reports/` | HTML / JSON / Markdown reports |
+
+## Requirements
+
+- OpenCode CLI (with `opencode db` command)
+- Node.js 18+
+
+## Build
+
+```sh
+npm install
+npm run build
+```
+
+## Related
+
+- [opencode-throughput](https://github.com/Howardzhangdqs/opencode-throughput) — Real-time LLM performance monitoring (TTFT/TPS/latency/cost)
+- [opencode-visual-cache](https://github.com/Hotakus/opencode-visual-cache) — TUI sidebar cache hit rate visualization, token distribution analysis
+- [magic-context](https://github.com/cortexkit/magic-context/) — Cache-aware infinite context + cross-session memory system
+
+## License
+
+MIT

package/README.md

@@ -1,97 +1,104 @@
-# opencode-tokenwatch
-
-[English](./README.en.md) · **简体中文**
-
-![Sidebar](./assets/sidebar.png)
-
-OpenCode CLI 的实时 Token 用量统计、缓存分析与性能指标插件。
-
-## 功能
-
-- **侧边栏面板** — 会话级与按模型的实时统计（请求数、Token、缓存、耗时、成本）
-- **缓存命中率** — 模型行内彩色进度条，带趋势指示器（↑/↓），全局总计行显示**全局加权命中率**
-- **性能指标** — TTFT / TPS / 端到端延迟 + P50/P95/P99 延迟分位数
-- **Token 分布** — 5 桶角色分解（系统、用户、Agent、Tool 以及 other 兜底，支持自适应缩放）
-- **错误率统计** — 识别并统计失败请求（空 Token 响应），实时计算错误率
-- **模型定价** — 输入/缓存/输出单价
-- **`/usage` 命令** — HTML 报告 → JSON 导出 → 文本报告 → 设置
-- **HTML 报告** — 交互式 ECharts 仪表盘：Token 分布、性能分位数、错误率分析、模型效率水平排名（已重构重叠散点图为水平条形对比图），自动在浏览器打开
-- **多级折叠** — 面板、模型、子区块均可折叠，状态持久化
-- **语言切换** — 中英双语，可跟随系统或手动切换
-- **性能追踪** — 每次请求的 TTFT/TPS/延迟写入 JSONL，用于报告分析
-- **自适应配色** — 从主题色自动衍生
-
-## 安装
-
-```sh
-npm install opencode-tokenwatch
-```
-
-在 `opencode.json` 或 `opencode.jsonc` 中添加：
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-tokenwatch"]
-}
-```
-
-## 配置
-
-```jsonc
-{
-  "plugin": ["opencode-tokenwatch"],
-  "pluginConfig": {
-    "opencode-tokenwatch": {
-      "sidebar": {
-        "showPerformance": true,
-        "showPricing": false,
-        "showTokenDistribution": false,
-        "showTrend": true
-      },
-      "language": "auto"
-    }
-  }
-}
-```
-
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `sidebar.showPerformance` | boolean | `true` | 显示 TTFT/TPS/延迟 |
-| `sidebar.showPricing` | boolean | `true` | 显示模型定价 |
-| `sidebar.showTokenDistribution` | boolean | `true` | 显示 Token 分布 |
-| `sidebar.showTrend` | boolean | `true` | 显示趋势指示器 |
-| `language` | `"auto"` / `"zh"` / `"en"` | `"auto"` | 界面语言 |
-
-运行时也可通过 `/usage` → 设置 调整，优先级高于 `pluginConfig`。
-
-## 用法
-
-在 OpenCode TUI 中输入 `/usage`，选择：
-
-- **HTML 报告** — 选择日期范围，生成仪表盘并在浏览器打开
-- **JSON 导出** — 导出完整用量数据至 `~/.opencode/reports/`
-- **文本报告** — 导出 Markdown 格式至 `~/.opencode/reports/`
-- **设置** — 开关侧边栏显示项、切换语言
-
-## 系统要求
-
-- OpenCode CLI（支持 `opencode db` 命令）
-- Node.js 18+
-
-## 构建
-
-```sh
-npm install
-npm run build
-```
-
-## 相关项目
-
-- [opencode-throughput](https://github.com/Howardzhangdqs/opencode-throughput) — 实时 LLM 性能监控，采集 TTFT/TPS/延迟和成本
-- [opencode-visual-cache](https://github.com/Hotakus/opencode-visual-cache) — TUI 侧边栏缓存命中率可视化，Token 分布分析
-- [magic-context](https://github.com/cortexkit/magic-context/) — 缓存感知的无限上下文 + 跨会话记忆系统
-
-## 许可
-
-MIT
+# opencode-tokenwatch
+
+[English](./README.en.md) · **简体中文**
+
+![Sidebar](./assets/sidebar.png)
+
+OpenCode CLI 的实时 Token 用量统计、缓存分析与性能指标插件。
+
+## 功能
+
+- **侧边栏面板** — 会话级与按模型的实时统计（请求数、Token、缓存、成本）
+- **缓存命中率** — 模型行内彩色进度条，带趋势指示器（↑/↓），全局总计行显示**加权命中率**
+- **性能指标** — TTFT / TPS / 端到端延迟 + P50/P95/P99 延迟分位数
+- **Token 分布** — 5 桶角色分解（system / user / toolCall / toolResult / output + other 兜底）
+- **错误率统计** — 识别并统计失败请求（空 Token 响应），实时计算错误率
+- **成本展示** — 按模型显示 cost（需 provider 返回计费数据）
+- **`/usage` 命令** — HTML 报告 → JSON 导出 → 文本报告 → 设置
+- **HTML 报告** — 交互式 ECharts 仪表盘：Token 分布、性能分位数、TPS 水平排名、错误率分析，自动在浏览器打开
+- **持久化统计** — 性能指标（TPS/TTFT/延迟）写入独立 JSON 文件，永久累积，不受日志轮转影响
+- **多级折叠** — 面板、模型、子区块均可折叠，状态持久化
+- **语言切换** — 中英双语，跟随系统或手动切换
+
+## 安装
+
+```sh
+npm install opencode-tokenwatch
+```
+
+在 `opencode.json` 或 `opencode.jsonc` 中添加：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-tokenwatch"]
+}
+```
+
+## 配置
+
+```jsonc
+{
+  "plugin": ["opencode-tokenwatch"],
+  "pluginConfig": {
+    "opencode-tokenwatch": {
+      "sidebar": {
+        "showPerformance": true,
+        "showPricing": true,
+        "showTokenDistribution": true,
+        "showTrend": true
+      },
+      "language": "auto"
+    }
+  }
+}
+```
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `sidebar.showPerformance` | boolean | `true` | 显示 TTFT/TPS/延迟 |
+| `sidebar.showPricing` | boolean | `true` | 显示请求成本 |
+| `sidebar.showTokenDistribution` | boolean | `true` | 显示 Token 分布 |
+| `sidebar.showTrend` | boolean | `true` | 显示趋势指示器 |
+| `language` | `"auto"` / `"zh"` / `"en"` | `"auto"` | 界面语言 |
+
+运行时也可通过 `/usage` → 设置 调整，优先级高于 `pluginConfig`。
+
+## 用法
+
+在 OpenCode TUI 中输入 `/usage`，选择：
+
+- **HTML 报告** — 选择日期范围，生成仪表盘并在浏览器打开
+- **JSON 导出** — 导出完整用量数据至 `~/.opencode/reports/`
+- **文本报告** — 导出 Markdown 格式至 `~/.opencode/reports/`
+- **设置** — 开关侧边栏显示项、切换语言
+
+## 数据文件
+
+| 文件 | 路径 | 说明 |
+|------|------|------|
+| JSONL 日志 | `~/.opencode/tokenwatch.jsonl` | 原始请求日志，超 5MB 自动轮转 |
+| 聚合统计 | `~/.opencode/tokenwatch-stats.json` | 持久化性能统计，永久累积 |
+| 报告输出 | `~/.opencode/reports/` | HTML / JSON / Markdown 报告 |
+
+## 系统要求
+
+- OpenCode CLI（支持 `opencode db` 命令）
+- Node.js 18+
+
+## 构建
+
+```sh
+npm install
+npm run build
+```
+
+## 相关项目
+
+- [opencode-throughput](https://github.com/Howardzhangdqs/opencode-throughput) — 实时 LLM 性能监控，采集 TTFT/TPS/延迟和成本
+- [opencode-visual-cache](https://github.com/Hotakus/opencode-visual-cache) — TUI 侧边栏缓存命中率可视化，Token 分布分析
+- [magic-context](https://github.com/cortexkit/magic-context/) — 缓存感知的无限上下文 + 跨会话记忆系统
+
+## 许可
+
+MIT

package/dist/commands.js

@@ -0,0 +1,208 @@
+import { getUsageReport } from "./queries.js";
+import { formatUsageReport } from "./formatter.js";
+import { generateUsageHtml } from "./generate-usage-html.js";
+import { t } from "./i18n.js";
+import { readLogs } from "./perf-tracker.js";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+const DEFAULT_CONFIG = {
+    sidebar: { showPerformance: true, showPricing: true, showTokenDistribution: true, showTrend: true },
+    language: "auto",
+};
+export async function registerCommands(api) {
+    api.command?.register(() => [
+        {
+            value: "tokenwatch-html-report",
+            title: "Generate HTML report",
+            description: "Generate an HTML dashboard with token usage, cache efficiency, and performance charts",
+            category: "Stats",
+            slash: { name: "usage-html", aliases: ["usage"] },
+            onSelect: async () => {
+                await showHtmlReport(api);
+            },
+        },
+        {
+            value: "tokenwatch-json-export",
+            title: "Export as JSON",
+            description: "Export usage data as JSON file",
+            category: "Stats",
+            slash: { name: "usage-json" },
+            onSelect: async () => {
+                await showJsonExport(api);
+            },
+        },
+        {
+            value: "tokenwatch-text-report",
+            title: "Text report (legacy)",
+            description: "View plain text usage report in terminal",
+            category: "Stats",
+            slash: { name: "usage-text" },
+            onSelect: async () => {
+                await showTextReport(api);
+            },
+        },
+        {
+            value: "tokenwatch-settings",
+            title: "TokenWatch Settings",
+            description: "Configure sidebar display options",
+            category: "Stats",
+            slash: { name: "usage-settings", aliases: ["tokenwatch-settings"] },
+            onSelect: async () => {
+                await showSettingsDialog(api);
+            },
+        },
+    ]);
+}
+function ensureReportDir() {
+    const dir = join(homedir(), ".opencode", "reports");
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    return dir;
+}
+function openInBrowser(filePath) {
+    try {
+        const platform = process.platform;
+        if (platform === "win32")
+            execSync(`start "" "${filePath}"`, { windowsHide: true, timeout: 5000 });
+        else if (platform === "darwin")
+            execSync(`open "${filePath}"`, { timeout: 5000 });
+        else
+            execSync(`xdg-open "${filePath}"`, { timeout: 5000 });
+    }
+    catch { /* silently fail */ }
+}
+function aggregatePerfStats(logs) {
+    const map = new Map();
+    for (const entry of logs) {
+        const key = entry.model;
+        let s = map.get(key);
+        if (!s) {
+            s = {
+                model: key,
+                providerID: entry.providerID,
+                requestCount: 0,
+                totalInput: 0, totalOutput: 0, totalCacheRead: 0, totalCacheWrite: 0, totalCost: 0,
+                avgTTFT: null, maxTTFT: null, minTTFT: null,
+                avgTPS: null, maxTPS: null, minTPS: null,
+                avgLatency: null, maxLatency: null, minLatency: null,
+            };
+            map.set(key, s);
+        }
+        s.requestCount++;
+        s.totalInput += entry.inputTokens;
+        s.totalOutput += entry.outputTokens;
+        s.totalCacheRead += entry.cacheReadTokens;
+        s.totalCacheWrite += entry.cacheWriteTokens;
+        s.totalCost += entry.cost;
+        const c = s.requestCount;
+        if (entry.ttft_ms != null) {
+            s.avgTTFT = s.avgTTFT != null ? s.avgTTFT + (entry.ttft_ms - s.avgTTFT) / c : entry.ttft_ms;
+            s.maxTTFT = s.maxTTFT != null ? Math.max(s.maxTTFT, entry.ttft_ms) : entry.ttft_ms;
+            s.minTTFT = s.minTTFT != null ? Math.min(s.minTTFT, entry.ttft_ms) : entry.ttft_ms;
+        }
+        if (entry.tps != null) {
+            s.avgTPS = s.avgTPS != null ? s.avgTPS + (entry.tps - s.avgTPS) / c : entry.tps;
+            s.maxTPS = s.maxTPS != null ? Math.max(s.maxTPS, entry.tps) : entry.tps;
+            s.minTPS = s.minTPS != null ? Math.min(s.minTPS, entry.tps) : entry.tps;
+        }
+        if (entry.latency_ms != null) {
+            s.avgLatency = s.avgLatency != null ? s.avgLatency + (entry.latency_ms - s.avgLatency) / c : entry.latency_ms;
+            s.maxLatency = s.maxLatency != null ? Math.max(s.maxLatency, entry.latency_ms) : entry.latency_ms;
+            s.minLatency = s.minLatency != null ? Math.min(s.minLatency, entry.latency_ms) : entry.latency_ms;
+        }
+    }
+    return Array.from(map.values());
+}
+async function buildCombinedData(api) {
+    const report = await getUsageReport({});
+    const logs = readLogs(1000);
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    const meta = {
+        generatedAt: `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`,
+        dateRange: {
+            start: report.daily.length > 0 ? report.daily[report.daily.length - 1].day : "—",
+            end: report.daily.length > 0 ? report.daily[0].day : "—",
+        },
+    };
+    return {
+        ...report,
+        perfLogs: logs,
+        perfSummary: aggregatePerfStats(logs),
+        meta,
+    };
+}
+async function showHtmlReport(api) {
+    try {
+        const data = await buildCombinedData(api);
+        const html = generateUsageHtml(data);
+        const dir = ensureReportDir();
+        const dateStr = new Date().toISOString().slice(0, 10);
+        const filePath = join(dir, `tokenwatch-${dateStr}.html`);
+        writeFileSync(filePath, html, "utf-8");
+        api.ui.toast?.({ message: `Report: ${filePath}`, variant: "info" });
+        openInBrowser(filePath);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        api.ui.toast?.({ message: `Error: ${msg}`, variant: "error" });
+    }
+}
+async function showJsonExport(api) {
+    try {
+        const report = await getUsageReport({});
+        const dir = ensureReportDir();
+        const dateStr = new Date().toISOString().slice(0, 10);
+        const filePath = join(dir, `tokenwatch-${dateStr}.json`);
+        writeFileSync(filePath, JSON.stringify(report, null, 2), "utf-8");
+        api.ui.toast?.({ message: `JSON: ${filePath}`, variant: "info" });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        api.ui.toast?.({ message: `Error: ${msg}`, variant: "error" });
+    }
+}
+async function showTextReport(api) {
+    try {
+        const report = await getUsageReport({});
+        const formatted = formatUsageReport(report);
+        const dir = ensureReportDir();
+        const dateStr = new Date().toISOString().slice(0, 10);
+        const filePath = join(dir, `tokenwatch-${dateStr}.md`);
+        writeFileSync(filePath, formatted, "utf-8");
+        api.ui.toast?.({ message: `Report saved to ${filePath}`, variant: "info" });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        api.ui.toast?.({ message: `Error: ${msg}`, variant: "error" });
+    }
+}
+async function showSettingsDialog(api) {
+    const currentConfig = loadConfigFromStore(api);
+    const cfg = currentConfig.sidebar;
+    const options = [
+        `[${cfg.showPerformance ? "x" : " "}] ${t("showPerformance")}`,
+        `[${cfg.showPricing ? "x" : " "}] ${t("showPricing")}`,
+        `[${cfg.showTokenDistribution ? "x" : " "}] ${t("showTokenDistribution")}`,
+        `[${cfg.showTrend ? "x" : " "}] ${t("showTrend")}`,
+        `---`,
+        `${t("language")}: ${currentConfig.language}`,
+    ].join("\n");
+    api.ui.toast?.({ message: `TokenWatch settings:\n${options}`, variant: "info" });
+}
+function loadConfigFromStore(api) {
+    const base = { sidebar: { ...DEFAULT_CONFIG.sidebar }, language: DEFAULT_CONFIG.language };
+    try {
+        const stored = api.kv?.get?.("tokenwatch-config");
+        if (stored) {
+            if (stored.sidebar)
+                Object.assign(base.sidebar, stored.sidebar);
+            if (stored.language)
+                base.language = stored.language;
+        }
+    }
+    catch { /* defaults */ }
+    return base;
+}