@chenlongapps/opencode-token-usage 0.3.2 → 0.3.3

package/README.md

@@ -60,8 +60,8 @@ 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` 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.
+- `Cost` prices every message with its recorded model. A complete non-zero price resolved by OpenCode takes precedence. If OpenCode reports a complete zero price, a complete official snapshot price overrides it; incomplete prices fall back for the whole message without mixing rates.
+- Gateway models can use fallback prices through exact model IDs, documented aliases, and known wrappers. A terminal `-free` or `:free` is removed only for an exact base ID lookup; other suffixes are not stripped. The fallback excludes gateway markups, regional premiums, unlisted discounts, tool fees, and 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.
 

package/README.zh-CN.md

@@ -60,8 +60,8 @@ opencode plugin add @chenlongapps/opencode-token-usage
 - 分叉会话是独立会话树。继承消息副本只归原始来源，避免重复计费。
 - `Context` 仅搜索最后一次 `status === "completed"` 的 compaction 之后；没有可靠用量或模型上限时隐藏。
 - `Steps` 统计树中全部 assistant 消息，无论是否已上报用量；复用分叉副本去重，继承历史不会重复计数。
-- `Cost` 按每条消息记录的实际模型分别计算。OpenCode 当前解析出的完整适用价格优先；OpenCode 没有可用价格时，回退到插件内置的厂商官方价格快照。
-- 网关模型可通过精确模型 ID 和已记录别名使用厂商价格，但不包含网关加价、区域溢价、折扣、工具费和税费，因此 Cost 是估算而非提供商账单。
+- `Cost` 按每条消息记录的实际模型分别计算。OpenCode 当前解析出的完整非零价格优先；若 OpenCode 给出完整零价，且内置价格快照可以完整计价，则采用快照价格。价格不完整时整条消息回退，不混用两套费率。
+- 网关模型通过精确模型 ID、明确别名和已知包装格式匹配；也会尝试移除终尾 `-free` 或 `:free` 后精确查找基础 ID，其他后缀不会剥离。快照不包含网关加价、区域溢价、未列明的折扣、工具费和税费，因此 Cost 是估算而非提供商账单。
 - 确认免费时显示 `$0.00`；价格不可用时显示 `—`；只有部分消息可计算时在已知小计后标注 `partial`。覆盖范围、来源和限制见[内置官方价格快照](docs/pricing.md)。
 - 首次读取失败显示 `Unavailable`；后续失败保留上次完整快照、标注 `Not updated` 并自动重试。
 

package/dist/pricing.js

@@ -175,9 +175,7 @@ export const OFFICIAL_PRICE_SNAPSHOT = {
             source: "https://cohere.com/pricing",
             prices: [{ input: 2.5, output: 10 }],
         },
-        // Meta Model API standard-tier rates. The contributor tier is a separate
-        // discounted program that permits training on prompts and completions, so
-        // it is intentionally not part of the standard snapshot.
+        // Meta Model API standard-tier rates.
         {
             id: "muse-spark-1.1", released: "2026-07-09", source: "https://ai.developer.meta.com/docs/pricing-rate-limits",
             prices: [{ input: 1.25, output: 4.25, cache: { read: 0.15 } }],
@@ -190,6 +188,17 @@ export const OFFICIAL_PRICE_SNAPSHOT = {
             id: "muse-spark-1.3", released: "2026-09-02", source: "https://ai.developer.meta.com/docs/pricing-rate-limits",
             prices: [{ input: 1.25, output: 4.25, cache: { read: 0.15 } }],
         },
+        // Meta Contributor rates are conditional on allowing Meta to use prompts
+        // and completions for training. OpenCode's contributor-free model IDs
+        // resolve here after removing their terminal -free suffix.
+        {
+            id: "muse-spark-1.2-contributor", released: "2026-08-05", source: "https://ai.developer.meta.com/docs/pricing-rate-limits",
+            prices: [{ input: 0.1, output: 0.2, cache: { read: 0.002 } }],
+        },
+        {
+            id: "muse-spark-1.3-contributor", released: "2026-09-02", source: "https://ai.developer.meta.com/docs/pricing-rate-limits",
+            prices: [{ input: 0.1, output: 0.2, cache: { read: 0.002 } }],
+        },
         // Inception's current Mercury 2.5 API page shows an 80% launch discount;
         // the snapshot records the billed standard-platform rates on verification
         // day rather than the crossed-out list prices. No cache-write token rate is
@@ -498,5 +507,14 @@ export function officialPrice(model) {
         if (entry)
             return entry;
     }
+    for (const candidate of candidates) {
+        for (const suffix of ["-free", ":free"]) {
+            if (!candidate.endsWith(suffix))
+                continue;
+            const entry = index.get(candidate.slice(0, -suffix.length));
+            if (entry)
+                return entry;
+        }
+    }
     return undefined;
 }

package/dist/usage.d.ts

@@ -83,8 +83,9 @@ export declare function estimate(tokens: Tokens, prices?: readonly Price[]): {
     defaultPrice: boolean;
 };
 export type CostStatus = "empty" | "complete" | "partial" | "unavailable";
-/** Prices every call with its recorded model. OpenCode's resolved price wins;
- * the built-in manufacturer snapshot is used only when that price is incomplete. */
+/** Prices every call with its recorded model. A complete non-zero OpenCode
+ * price wins; a complete snapshot price can replace a complete OpenCode zero.
+ * Incomplete OpenCode prices fall back to the snapshot as a whole. */
 export declare function summarize(messages: Iterable<UsageMessage>, catalog?: PriceCatalog): {
     tokens: Tokens;
     total: number;

package/dist/usage.js

@@ -22,8 +22,9 @@ export function estimate(tokens, prices = []) {
             && (rate === undefined || !Number.isFinite(rate) || rate < 0))),
     };
 }
-/** Prices every call with its recorded model. OpenCode's resolved price wins;
- * the built-in manufacturer snapshot is used only when that price is incomplete. */
+/** Prices every call with its recorded model. A complete non-zero OpenCode
+ * price wins; a complete snapshot price can replace a complete OpenCode zero.
+ * Incomplete OpenCode prices fall back to the snapshot as a whole. */
 export function summarize(messages, catalog = new Map()) {
     const tokens = normalize();
     let cost = 0;
@@ -50,8 +51,11 @@ export function summarize(messages, catalog = new Map()) {
             continue;
         }
         let value = estimate(t, catalog.get(modelKey(message.model)));
-        if (value.defaultPrice)
-            value = estimate(t, officialPrice(message.model)?.prices);
+        if (value.defaultPrice || value.cost === 0) {
+            const snapshot = estimate(t, officialPrice(message.model)?.prices);
+            if (!snapshot.defaultPrice)
+                value = snapshot;
+        }
         if (value.defaultPrice)
             missingCosts++;
         else {

package/docs/pricing.md

@@ -1,14 +1,14 @@
 # 内置官方价格快照
 
-插件自 v0.3.0 起，在 OpenCode 当前模型目录没有可用于某条消息的完整价格时，使用本页所列的厂商官方标准价补全。v0.3.2 快照核验于 **2026-09-23**，共收录 74 个模型，金额均为美元 / 100 万 token。
+插件自 v0.3.0 起，在 OpenCode 当前模型目录没有可用于某条消息的完整价格时，使用本页所列的公开 API 价格补全。若 OpenCode 给出完整零价，而快照能完整计价，则使用快照价格。快照核验于 **2026-09-23**，共收录 79 个模型，金额均为美元 / 100 万 token。
 
 ## 规则
 
 - 每条 assistant 与 compaction 消息按自身记录的 `providerID`、模型 ID 和 token 用量分别计算。
-- OpenCode 当前解析出的完整适用价格优先；仅当适用档位或本次实际使用的 token 类别缺价时，整条消息回退到内置价格，不混用两套费率。
-- 网关模型只通过精确厂商 ID、精确别名及已知包装格式匹配，例如 `openai/gpt-5.6-luna`、`us.anthropic.claude-opus-5` 和 `claude-opus-5@default`。不按相似名称猜测。
-- 目录首版只新增 2026-03-22 至 2026-09-22 发布、具有明确标准 token 价格的模型。后续版本只限制新增窗口，已经收录的模型不会因超过半年而自动删除。
-- 采用标准同步 API 的公开价，不含 Batch、Flex、Fast/Priority、区域溢价、网关加价、免费额度、企业折扣、工具费和税费，因此 Cost 仍是估算，不代表账单。
+- OpenCode 当前解析出的完整适用非零价格优先。若完整适用价格为零，则尝试使用内置价格；只有快照能完整覆盖该消息实际使用的 token 类别时才覆盖零价，否则保留 OpenCode 的零价。OpenCode 价格不完整时，整条消息回退到内置价格，不混用两套费率。
+- 网关模型只通过精确厂商 ID、精确别名及已知包装格式匹配，例如 `openai/gpt-5.6-luna`、`us.anthropic.claude-opus-5` 和 `claude-opus-5@default`。匹配这些现有形式后，也会尝试仅移除模型 ID 的末尾 `-free` 或 `:free` 再精确匹配基础 ID，例如 `mimo-v2.6-flash-free`、`meta/muse-spark-1.3:free` 和 `muse-spark-1.3-contributor-free`；`-pro`、`-fast`、`-free-preview` 等其他后缀不会剥离。不按相似名称猜测。
+- 目录首版只新增 2026-03-22 至 2026-09-22 发布、具有明确 token 费率的模型。后续版本只限制新增窗口，已经收录的条目不会因超过半年而自动删除。
+- 采用标准同步 API 的公开价；Meta Contributor 条件价按单独标注的来源记录。不含 Batch、Flex、Fast/Priority、区域溢价、网关加价、企业折扣、工具费和税费，因此 Cost 仍是估算，不代表账单。
 - 任一有用量消息仍无法定价时，已知小计标记 `partial`；全部无法定价时显示 `—`。明确零价才显示 `$0.00`。
 - 促销价按核验日官网显示的费率收录（如 `gpt-5.6-sol`、MiniMax-M3 的"长期 5 折"标价），不用划线原价。
 
@@ -199,7 +199,14 @@ Step 5 Preview 官方明确说明 cache-miss Input 包含首次缓存写入，
 | `muse-spark-1.2` | 2026-08-05 | 1.25 | 4.25 | 0.15 |
 | `muse-spark-1.3` | 2026-09-02 | 1.25 | 4.25 | 0.15 |
 
-这里只收录 Standard tier。Contributor tier 虽然也是官方 API，但以允许 Meta 使用提示词和回答训练为条件的折扣方案，不属于标准价；官方没有 cache write token 价。
+Contributor tier 以允许 Meta 使用提示词和回答进行训练为条件，按独立 tier 记录。官方没有公布 cache write token 价。
+
+| Contributor 模型 | 发布日期 | Input | Output | Cache Read | Cache Write |
+| --- | --- | ---: | ---: | ---: | ---: |
+| `muse-spark-1.2-contributor` | 2026-08-05 | 0.10 | 0.20 | 0.002 | — |
+| `muse-spark-1.3-contributor` | 2026-09-02 | 0.10 | 0.20 | 0.002 | — |
+
+OpenCode Zen 的 `muse-spark-1.2-contributor-free` 和 `muse-spark-1.3-contributor-free` 会精确匹配各自 Contributor 条目；Cost 因此按 Meta Contributor 费率估算。
 
 ## Inception
 
@@ -278,7 +285,7 @@ Fugu Ultra 的编排 token 已包含在 API 返回的 input/output 用量中，
 - Realtime、音频、图片、视频、embedding、按页、按分钟和按工具调用收费的模型无法仅由当前五类 token 用量准确计算。
 - `grok-4.20`、`grok-4.20-multi-agent` 发布于 2026-03-09，早于目录收录窗口起点 2026-03-22。
 - Fast/Priority 等加速档（`claude-opus-*-fast`、`gpt-5.6-*-pro`、`gpt-6-astra-pro`、MiniMax priority 档）不是标准同步价。
-- 免费模型（Gemma 系列、`cohere/north-mini-code` 等开源或网关零价款）不设价格条目。
-- 无法从厂商官方页面确认标准 token 价格的模型不猜价，包括 OpenRouter stealth/alpha 匿名模型、`z-ai/glm-5v-turbo`、`qwen3.6-plus-preview`、腾讯 `hy3-preview` 与 `hy-mt2-*`、`kwaipilot/kat-coder-pro-v2.5` 及其 Air 版本、`inclusionai/ling-3.0-*`、`bytedance-seed/seed-2.0-code` 等。这些模型目前只能查到 OpenRouter、AtlasCloud、DeepInfra 等网关或第三方报价，不能据此推断厂商标准价。
+- 其他免费模型（Gemma 系列、`cohere/north-mini-code` 等开源或网关零价款）不设价格条目。
+- 无法从厂商官方页面确认标准 token 价格的模型不猜价，包括 OpenRouter stealth/alpha 匿名模型、`z-ai/glm-5v-turbo`、`qwen3.6-plus-preview`、腾讯 `hy3-preview` 与 `hy-mt2-*`、`kwaipilot/kat-coder-pro-v2.5` 及其 Air 版本、除上表 OpenCode Zen SKU 外的 `inclusionai/ling-3.0-*`、`bytedance-seed/seed-2.0-code` 等。这些模型目前只能查到 OpenRouter、AtlasCloud、DeepInfra 等网关或第三方报价，不能据此推断厂商标准价。
 - 浮动别名（`-latest` 指针与 OpenRouter `~` 前缀条目）随底层模型漂移，不收录固定价。
 - 只有询价、托管部署价或无法从厂商官方页面确认标准 token 价格的模型不猜价。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenlongapps/opencode-token-usage",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Session-tree token usage, live performance, context window and estimated cost for OpenCode 2",
   "keywords": [
     "opencode",