@chenlongapps/opencode-token-usage 0.2.5 → 0.3.1

package/README.md

@@ -3,10 +3,10 @@
 <p align="center">A session-tree token usage monitor for OpenCode 2.</p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@chenlongapps/opencode-token-usage"><img alt="npm" src="https://img.shields.io/npm/v/%40chenlongapps%2Fopencode-token-usage?style=flat-square&logo=npm" /></a>
-  <a href="https://opencode.ai/"><img alt="OpenCode 2" src="https://img.shields.io/badge/OpenCode-2-5A67D8?style=flat-square" /></a>
-  <a href="https://github.com/chenlongapps/opencode-token-usage/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/chenlongapps/opencode-token-usage/ci.yml?style=flat-square&branch=main&label=ci" /></a>
-  <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
+  <a href="https://www.npmjs.com/package/@chenlongapps/opencode-token-usage" target="_blank" rel="noopener noreferrer"><img alt="npm" src="https://img.shields.io/npm/v/%40chenlongapps%2Fopencode-token-usage?style=flat-square&logo=npm" /></a>
+  <a href="https://opencode.ai/" target="_blank" rel="noopener noreferrer"><img alt="OpenCode 2" src="https://img.shields.io/badge/OpenCode-2-5A67D8?style=flat-square" /></a>
+  <a href="https://github.com/chenlongapps/opencode-token-usage/actions/workflows/ci.yml" target="_blank" rel="noopener noreferrer"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/chenlongapps/opencode-token-usage/ci.yml?style=flat-square&branch=main&label=ci" /></a>
+  <a href="LICENSE" target="_blank" rel="noopener noreferrer"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
 </p>
 
 <p align="center">
@@ -50,7 +50,7 @@ For remote sessions, add the package name to `plugins` in your local `~/.config/
 | `Total` | Sum of all five token categories |
 | `Context` | Latest context usage after the most recent completed compaction in the viewed session; not aggregated across the subtree |
 | `Steps` | Assistant message count across the session tree, including subagents; follows OpenCode's own stats definition, so compaction and user messages are not steps |
-| `Cost` | Estimated cost for the entire tree, recalculated using the viewed session's active model; not a provider bill |
+| `Cost` | Estimated cost across the tree, pricing each assistant and compaction call with its actual model |
 | `TPS` | Generation throughput for `Output + Reasoning` across the tree; live estimates are marked with `~` |
 | `TTFT` | Average time to first token across measurable assistant steps in the tree |
 
@@ -60,7 +60,9 @@ For remote sessions, add the package name to `plugins` in your local `~/.config/
 - A fork is a separate session tree. Inherited message copies are attributed only to their original source to prevent double counting.
 - `Context` only searches messages after the most recent compaction with `status === "completed"` and is hidden when reliable usage or a model context limit is unavailable.
 - `Steps` counts every assistant message in the tree, whether or not it reported usage, and reuses the fork-copy de-duplication so inherited history is never counted twice.
-- `Cost` applies the viewed session's active model to the whole tree. Missing applicable prices fall back to 0, matching OpenCode's behavior.
+- `Cost` prices every message with its recorded model. A complete applicable price resolved by OpenCode takes precedence; when OpenCode has no usable price, the plugin falls back to a packaged snapshot of manufacturer prices.
+- Gateway models can use manufacturer fallback prices through exact model IDs and documented aliases. The fallback does not include gateway markups, regional premiums, discounts, tool fees, or taxes, so Cost is an estimate rather than a provider bill.
+- Confirmed free usage displays `$0.00`; unavailable prices display `—`; known subtotals with unpriced messages are marked `partial`. See the [built-in price snapshot](docs/pricing.md) for coverage, sources, and limitations.
 - Initial read failures display `Unavailable`. Later failures retain the last complete snapshot, display `Not updated`, and retry automatically.
 
 ### Development
@@ -73,7 +75,7 @@ npm run build
 npm run test:smoke
 ```
 
-`test:smoke` packages the real artifact and validates loading, refreshes, subagent aggregation, model switching, TPS, and TTFT against an isolated OpenCode instance and a local mock provider. It requires Python 3, an available local port, and npm network access. It never modifies your existing OpenCode configuration or calls paid models.
+`test:smoke` packages the real artifact and validates loading, refreshes, subagent aggregation, per-message pricing, official-price fallback, model switching, TPS, and TTFT against an isolated OpenCode instance and a local mock provider. It requires Python 3, an available local port, and npm network access. It never modifies your existing OpenCode configuration or calls paid models.
 
 To load the plugin from source, build the project and add the repository's absolute path to `plugins` in the target project.
 

package/README.zh-CN.md

@@ -3,10 +3,10 @@
 <p align="center">面向 OpenCode 2 的会话树 token 用量监视器。</p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@chenlongapps/opencode-token-usage"><img alt="npm" src="https://img.shields.io/npm/v/%40chenlongapps%2Fopencode-token-usage?style=flat-square&logo=npm" /></a>
-  <a href="https://opencode.ai/"><img alt="OpenCode 2" src="https://img.shields.io/badge/OpenCode-2-5A67D8?style=flat-square" /></a>
-  <a href="https://github.com/chenlongapps/opencode-token-usage/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/chenlongapps/opencode-token-usage/ci.yml?style=flat-square&branch=main&label=ci" /></a>
-  <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
+  <a href="https://www.npmjs.com/package/@chenlongapps/opencode-token-usage" target="_blank" rel="noopener noreferrer"><img alt="npm" src="https://img.shields.io/npm/v/%40chenlongapps%2Fopencode-token-usage?style=flat-square&logo=npm" /></a>
+  <a href="https://opencode.ai/" target="_blank" rel="noopener noreferrer"><img alt="OpenCode 2" src="https://img.shields.io/badge/OpenCode-2-5A67D8?style=flat-square" /></a>
+  <a href="https://github.com/chenlongapps/opencode-token-usage/actions/workflows/ci.yml" target="_blank" rel="noopener noreferrer"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/chenlongapps/opencode-token-usage/ci.yml?style=flat-square&branch=main&label=ci" /></a>
+  <a href="LICENSE" target="_blank" rel="noopener noreferrer"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
 </p>
 
 <p align="center">
@@ -50,7 +50,7 @@ opencode plugin add @chenlongapps/opencode-token-usage
 | `Total` | 五类 token 之和 |
 | `Context` | 当前会话最后一次已完成压缩后的最新上下文用量，不随子树累计 |
 | `Steps` | 全树（含子代理）的 assistant 消息数，口径与 OpenCode 自带统计一致，compaction 与用户消息不计为 step |
-| `Cost` | 按当前会话活动模型重新估算的全树费用，不代表提供商账单 |
+| `Cost` | 按每条 assistant 与 compaction 消息实际模型估算的全树费用 |
 | `TPS` | 全树 `Output + Reasoning` 的生成速度；生成中的估算值带 `~` 标记 |
 | `TTFT` | 全树中可测 assistant step 的平均首 token 时间 |
 
@@ -60,7 +60,9 @@ opencode plugin add @chenlongapps/opencode-token-usage
 - 分叉会话是独立会话树。继承消息副本只归原始来源，避免重复计费。
 - `Context` 仅搜索最后一次 `status === "completed"` 的 compaction 之后；没有可靠用量或模型上限时隐藏。
 - `Steps` 统计树中全部 assistant 消息，无论是否已上报用量；复用分叉副本去重，继承历史不会重复计数。
-- `Cost` 使用当前查看会话的活动模型重算整棵树；缺失适用价格时按 OpenCode 行为回退为 0。
+- `Cost` 按每条消息记录的实际模型分别计算。OpenCode 当前解析出的完整适用价格优先；OpenCode 没有可用价格时，回退到插件内置的厂商官方价格快照。
+- 网关模型可通过精确模型 ID 和已记录别名使用厂商价格，但不包含网关加价、区域溢价、折扣、工具费和税费，因此 Cost 是估算而非提供商账单。
+- 确认免费时显示 `$0.00`；价格不可用时显示 `—`；只有部分消息可计算时在已知小计后标注 `partial`。覆盖范围、来源和限制见[内置官方价格快照](docs/pricing.md)。
 - 首次读取失败显示 `Unavailable`；后续失败保留上次完整快照、标注 `Not updated` 并自动重试。
 
 ### 开发
@@ -73,7 +75,7 @@ npm run build
 npm run test:smoke
 ```
 
-`test:smoke` 会打包真实产物，并在隔离的 OpenCode 与本地模拟提供商中验证加载、刷新、子代理累计、模型切换、TPS 和 TTFT。它需要 Python 3、可用的本地端口和 npm 网络访问，不会修改现有 OpenCode 配置或调用付费模型。
+`test:smoke` 会打包真实产物，并在隔离的 OpenCode 与本地模拟提供商中验证加载、刷新、子代理累计、逐消息计价、官方价格补全、模型切换、TPS 和 TTFT。它需要 Python 3、可用的本地端口和 npm 网络访问，不会修改现有 OpenCode 配置或调用付费模型。
 
 从源码加载时，先构建项目，再将仓库绝对路径加入目标项目的 `plugins`。
 

package/ROADMAP.md

@@ -68,13 +68,19 @@ TTFT  2.7s
 Steps  1,234
 ```
 
-## v0.3.0 — 公开价格目录
+## v0.3.0 — 官方价格补全
 
-目标：提供可查询的价格目录，便于用户了解不同模型的计费档位。
+目标：按每条消息实际使用的模型统计费用，并在 OpenCode 缺少价格时使用厂商官方价格补全。
 
-* [ ] 构建公开价格目录，包含模型、价格档位及阈值
-* [ ] 只收录半年内发布的模型
-<!-- TODO -->
+* [x] 内置可追溯的厂商官方价格快照
+* [x] 首版收录最近半年发布且具有明确标准 token 定价的模型
+* [x] OpenCode 完整适用价格优先，缺失时整条消息回退到官方价格
+* [x] 按 assistant 与 compaction 消息实际模型分别计算
+* [x] 支持价格阶梯、缓存读写和 Reasoning 费用
+* [x] 支持网关模型到厂商模型的精确 ID 与明确别名映射
+* [x] 区分免费、部分可计算和价格不可用
+* [x] 已收录模型永久保留，后续持续核验价格和来源
+* [x] 通过单元测试与 OpenCode 2.0.11 打包集成验证
 
 ## v0.4.0 — 用量命令
 
@@ -88,5 +94,4 @@ Steps  1,234
 
 ## 后续评估
 
-* [ ] 公开价格目录与更新策略
 * [x] 首次 npm 发布：`@chenlongapps/opencode-token-usage@0.2.1`

package/dist/controller.js

@@ -137,7 +137,7 @@ export class UsageController {
             this.performanceTimer = undefined;
             this.update({
                 status: "ready",
-                summary: summarize(messages, snapshot.model.prices),
+                summary: summarize(messages, snapshot.model.catalog),
                 context: contextUsage(viewedMessages(snapshot), snapshot.model.context),
                 performance: this.performance.summary(messages, this.sessions),
                 model: snapshot.model.label,

package/dist/pricing.d.ts

@@ -0,0 +1,142 @@
+import type { ModelRef, Price } from "./usage.js";
+export interface OfficialPriceEntry {
+    /** Canonical model ID used by the model manufacturer. */
+    id: string;
+    /** First public release date, used to enforce the snapshot's inclusion window. */
+    released: string;
+    /** Exact alternate IDs used by supported gateways or manufacturer aliases. */
+    aliases?: readonly string[];
+    /** Standard, synchronous API token rates in USD per million tokens. */
+    prices: readonly Price[];
+    /** Manufacturer pricing page used to verify the rates. */
+    source: string;
+}
+export declare const OFFICIAL_PRICE_SNAPSHOT: {
+    readonly verified: "2026-09-23";
+    readonly newModelCutoff: "2026-03-22";
+    readonly entries: ({
+        id: string;
+        released: string;
+        source: string;
+        prices: ({
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+            };
+            tier?: never;
+        } | {
+            tier: {
+                type: "context";
+                size: number;
+            };
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+            };
+        })[];
+        aliases?: never;
+    } | {
+        id: string;
+        released: string;
+        source: string;
+        prices: ({
+            input: number;
+            output: number;
+            tier?: never;
+        } | {
+            tier: {
+                type: "context";
+                size: number;
+            };
+            input: number;
+            output: number;
+        })[];
+        aliases?: never;
+    } | {
+        id: string;
+        released: string;
+        source: string;
+        prices: ({
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+                write: number;
+            };
+            tier?: never;
+        } | {
+            tier: {
+                type: "context";
+                size: number;
+            };
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+                write: number;
+            };
+        })[];
+        aliases?: never;
+    } | {
+        id: string;
+        aliases: string[];
+        released: string;
+        source: string;
+        prices: {
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+                write: number;
+            };
+        }[];
+    } | {
+        id: string;
+        aliases: string[];
+        released: string;
+        source: string;
+        prices: ({
+            input: number;
+            output: number;
+            tier?: never;
+        } | {
+            tier: {
+                type: "context";
+                size: number;
+            };
+            input: number;
+            output: number;
+        })[];
+    } | {
+        id: string;
+        aliases: string[];
+        released: string;
+        source: string;
+        prices: ({
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+            };
+            tier?: never;
+        } | {
+            tier: {
+                type: "context";
+                size: number;
+            };
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+            };
+        })[];
+    })[];
+};
+/**
+ * Resolves exact manufacturer IDs through common gateway wrappers. It never
+ * performs substring or model-name matching, so similarly named variants do
+ * not silently inherit a different model's price.
+ */
+export declare function officialPrice(model: ModelRef): OfficialPriceEntry | undefined;