@chenlongapps/opencode-token-usage 0.4.6 → 0.4.8

package/dist/usage.d.ts

@@ -1,4 +1,5 @@
 import type { PerformanceSummary } from "./performance.js";
+import type { RuntimeSummary } from "./runtime.js";
 export interface Tokens {
     input: number;
     output: number;
@@ -42,6 +43,9 @@ export interface UsageMessage {
     id: string;
     type: string;
     status?: string;
+    finish?: string;
+    error?: unknown;
+    retry?: unknown;
     model?: ModelRef;
     cost?: number;
     tokens?: TokenInput;
@@ -128,13 +132,20 @@ export interface ContextUsage {
     limit: number;
     percent: number;
 }
-export interface ContextDetails {
-    usage: ContextUsage;
+export interface RequestDetails {
     tokens: Tokens;
+    total: number;
+    /** The selected assistant's stream end, completion, or creation time, in that order. */
+    time?: number | undefined;
 }
-export declare function contextDetails(messages: readonly UsageMessage[], limit?: number, revertMessageID?: string): ContextDetails | undefined;
+export declare function requestDetails(messages: readonly UsageMessage[], revertMessageID?: string): RequestDetails | undefined;
 export declare function contextUsage(messages: readonly UsageMessage[], limit?: number, revertMessageID?: string): ContextUsage | undefined;
 export declare function formatTokens(value: number): string;
+/** Native sub-minute precision; longer durations keep compact, readable units. */
+export declare function formatDuration(milliseconds: number, compact?: boolean): string;
+export declare function formatRunTime(runtime?: RuntimeSummary, compact?: boolean): string;
+/** Preserve session-local time on narrow terminals without adding composer height. */
+export declare function fitUsageSummary(fields: readonly (readonly [string, string])[], width: number, stale?: boolean): string;
 export declare const formatCost: (value: number) => string;
 export declare function formatEstimatedCost(cost: number, status: CostStatus): string | undefined;
 /** Per-million rates need more precision than a rounded total cost. */
@@ -152,9 +163,9 @@ export declare function bar(percent: number, width: number): {
  * One model request: the five categories of the last assistant call plus its cache rate.
  * Compact mode hides zero rows and drops percentages; detailed mode keeps both.
  */
-export declare function requestRows(details: ContextDetails, compact: boolean): readonly (readonly [string, string])[];
+export declare function requestRows(details: RequestDetails, compact: boolean): readonly (readonly [string, string])[];
 /** Tree summary rows for the dialog's detailed Session view, calls included. */
 export declare function summaryRows(summary: Summary): readonly (readonly [string, string])[];
 /** `1 step` reads better than `1 steps` in the dialog's single-line summaries. */
 export declare const countLabel: (value: number, noun: string) => string;
-export declare function usageRows(summary?: Summary, context?: ContextUsage, performance?: PerformanceSummary): readonly (readonly [string, string])[];
+export declare function usageRows(summary?: Summary, context?: ContextUsage, performance?: PerformanceSummary, runtime?: RuntimeSummary): readonly (readonly [string, string])[];

package/dist/usage.js

@@ -150,13 +150,12 @@ export function summarizeModels(messages, catalog = new Map()) {
     })).sort((a, b) => b.cost - a.cost || a.model.localeCompare(b.model));
 }
 const usableLimit = (value) => value !== undefined && Number.isFinite(value) && value > 0;
+const usableTime = (value) => value !== undefined && value >= 0 && Number.isFinite(new Date(value).getTime());
 // Matches the OpenCode 2.0.10 sidebar: the last assistant message with tokens that follows
 // the last completed compaction carries the current context size. Running or failed
-// compactions do not reset it, and a last message without usage hides the row entirely
-// instead of falling back to pre-compaction history.
-export function contextDetails(messages, limit, revertMessageID) {
-    if (!usableLimit(limit))
-        return undefined;
+// compactions do not reset it. Missing token reports are skipped, while an explicit
+// zero report is not replaced by older usage. Request details need no model limit.
+export function requestDetails(messages, revertMessageID) {
     // The staged revert excludes its boundary message and every later message.
     // Session.message.list is ascending; an absent marker can occur during a
     // concurrent commit, in which case the ordered ID still gives the cutoff.
@@ -178,17 +177,69 @@ export function contextDetails(messages, limit, revertMessageID) {
             continue;
         const tokens = normalize(message.tokens);
         const used = total(tokens);
-        return used > 0 ? { usage: { used, limit, percent: used / limit * 100 }, tokens } : undefined;
+        const time = [message.time?.streamed, message.time?.completed, message.time?.created].find(usableTime);
+        return used > 0 ? { tokens, total: used, time } : undefined;
     }
     return undefined;
 }
 export function contextUsage(messages, limit, revertMessageID) {
-    return contextDetails(messages, limit, revertMessageID)?.usage;
+    if (!usableLimit(limit))
+        return undefined;
+    const request = requestDetails(messages, revertMessageID);
+    return request ? { used: request.total, limit, percent: request.total / limit * 100 } : undefined;
 }
 export function formatTokens(value) {
     return Math.round(safe(value)).toLocaleString("en-US");
 }
-export const formatCost = (value) => value > 0 && value < 0.01 ? "<$0.01" : `$${safe(value).toFixed(2)}`;
+/** Native sub-minute precision; longer durations keep compact, readable units. */
+export function formatDuration(milliseconds, compact = false) {
+    if (!Number.isFinite(milliseconds) || milliseconds < 0)
+        return "—";
+    if (milliseconds === 0)
+        return "0s";
+    if (milliseconds < 1_000)
+        return `${milliseconds}ms`;
+    if (milliseconds < 60_000)
+        return `${(milliseconds / 1_000).toFixed(1)}s`;
+    const seconds = Math.floor(milliseconds / 1_000);
+    const hours = Math.floor(seconds / 3_600), minutes = Math.floor(seconds / 60) % 60, rest = seconds % 60;
+    if (hours > 0)
+        return compact ? `${hours}h${minutes}m${rest}s` : `${hours}h ${String(minutes).padStart(2, "0")}m ${String(rest).padStart(2, "0")}s`;
+    if (minutes > 0)
+        return compact ? `${minutes}m${rest}s` : `${minutes}m ${String(rest).padStart(2, "0")}s`;
+    return `${rest}s`;
+}
+export function formatRunTime(runtime, compact = false) {
+    if (runtime?.milliseconds === undefined)
+        return "—";
+    const time = formatDuration(runtime.milliseconds, compact);
+    return runtime.status === "stale" ? `${time} · ${compact ? "stale" : "Not updated"}` : time;
+}
+/** Preserve session-local time on narrow terminals without adding composer height. */
+export function fitUsageSummary(fields, width, stale = false) {
+    let visible = [...fields];
+    const suffix = stale ? " · Not updated" : "";
+    const render = (title) => `${title} · ${visible.map(([label, value]) => `${label} ${value}`).join(" · ")}${suffix}`;
+    for (const label of ["TPS", "Context", "Cost", "Total"]) {
+        if (render("Token Usage").length <= width)
+            return render("Token Usage");
+        visible = visible.filter(([name]) => name !== label);
+    }
+    if (render("Token Usage").length <= width)
+        return render("Token Usage");
+    if (render("Usage").length <= width)
+        return render("Usage");
+    // Remove the title before clipping any value; time is the final retained field.
+    return `${visible.map(([label, value]) => `${label} ${value}`).join(" · ")}${stale ? " · stale" : ""}`.slice(0, Math.max(0, width));
+}
+export const formatCost = (value) => {
+    const amount = safe(value);
+    if (amount === 0)
+        return "$0.00";
+    if (amount < 0.001)
+        return "<$0.001";
+    return `$${amount.toFixed(amount > 0.01 ? 2 : 3)}`;
+};
 export function formatEstimatedCost(cost, status) {
     if (status === "empty")
         return undefined;
@@ -251,7 +302,7 @@ export function requestRows(details, compact) {
     return [
         ...rows.map(([label, count]) => [
             label,
-            compact ? formatCompact(count) : `${formatTokens(count)} (${(count / details.usage.used * 100).toFixed(1)}%)`,
+            compact ? formatCompact(count) : `${formatTokens(count)} (${(count / details.total * 100).toFixed(1)}%)`,
         ]),
         ["Cache Rate", `${(incomingTokens ? t.cache.read / incomingTokens * 100 : 0).toFixed(1)}%`],
     ];
@@ -265,7 +316,7 @@ export function summaryRows(summary) {
 }
 /** `1 step` reads better than `1 steps` in the dialog's single-line summaries. */
 export const countLabel = (value, noun) => `${formatTokens(value)} ${noun}${value === 1 ? "" : "s"}`;
-export function usageRows(summary, context, performance) {
+export function usageRows(summary, context, performance, runtime) {
     const t = summary?.tokens;
     const number = (value) => value === undefined ? "—" : formatTokens(value);
     const rows = [];
@@ -284,5 +335,7 @@ export function usageRows(summary, context, performance) {
     if (performance?.ttft !== undefined && Number.isFinite(performance.ttft)) {
         rows.push(["TTFT", `${(Math.max(0, performance.ttft) / 1_000).toFixed(1)}s`]);
     }
+    if (runtime)
+        rows.push(["Run Time", formatRunTime(runtime)]);
     return rows;
 }

package/docs/verification.md

@@ -1,5 +1,102 @@
 # 验证记录
 
+## 2026-10-09 · Run Time 移至面板末行
+
+将侧边栏与子代理完整浮窗的行序调整为 TPS → TTFT → Run Time；任一性能指标缺失时，Run Time 仍为最后一行。保留原有分组空行，统计口径与子代理单行摘要不变，`/usage` 继续在 Session 区域末行显示耗时。
+
+已通过 `npm run typecheck`、160 项 `npm test`、`npm run build` 与真实 OpenCode 2.0.26 的完整 `npm run test:smoke`。行序测试覆盖只有 TPS、只有 TTFT、无性能数据及无效性能数值；真实终端分别核对侧边栏与子代理浮窗的末行位置。本次未升级版本、提交、推送或发布。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-8HSjAl`，其中 `05-message.txt` 显示 TPS、TTFT、Run Time 的最终行序。
+
+## 2026-10-09 · 当前会话累计原生对话耗时（未发布）
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包仍为 0.4.7、SDK 2.0.24、OpenTUI 0.5.14，真实宿主为 PATH 中的 OpenCode 2.0.26。本次未升级插件或 SDK 版本、未修改价格快照，未提交、推送或发布。
+
+新增 `src/runtime.ts`，复用 `message.list(order: "asc")` 的完整保留历史。口径核对版本固定的宿主源码 [`turnDuration` / `legacyTurns` / `inputIndex`](https://github.com/anomalyco/opencode/blob/v2.0.26/packages/tui/src/routes/session/rows.ts)：assistant 完成时间减去上一条 idle 之后首个 user／synthetic 输入的创建时间；无 idle 的旧历史取最近输入，无输入时取 assistant 创建时间，负差值按原生算法截为零。每个轮次只保留最终已完成回答的时长，工具调用等中间 step 不重复计入；未完成的 steer 保留同轮上一条已完成回答的值，后续完成时替换而不是叠加。先累加毫秒，再格式化为毫秒／一位小数秒／分时单位。
+
+累计范围仅为当前查看会话，不额外加入子会话耗时；主会话等待子代理的跨度自然包含在主轮次内。轮次之间的空闲不增长，生成中的回答不做实时计时估算。失败／中断回答有原生完成时间戳时累计；历史完成时间缺失或无效时显示 `—`，不冒充完整的零值或小计。普通读取失败保留上次快照并标注未更新。分叉继承副本不继承累计值；压缩保留历史轮次，暂存回退不扣除，但已提交回退删除消息后相应耗时也移除。
+
+侧边栏在用量与费用之后、TPS／TTFT 之前显示 `Run Time`；子代理摘要加入 `Time`，窄终端省略其他字段以保持单行，点击浮窗复用同一控制器；`/usage` 的 Session 区域独立显示 `Run Time (this session)`。原有 token、费用及性能统计仍覆盖会话树。已移除先前尝试的执行日志适配器、监视器与实时估算，不依赖默认未保存正文的实验性 `session.log`，也不需要服务端插件新增持久化。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 160 项通过，新增 23 项时间算法、5 项控制器与 3 项格式／行序／窄终端回归测试 |
+| `npm run build` | 通过，产物包含 `dist/runtime.js` 与类型声明 |
+| `npm run test:smoke` | 完整通过，真实打包／隔离安装 + OpenCode 2.0.26 + 本地模拟提供商 |
+
+自动化测试覆盖多轮空闲、重叠页脚去重、首个／最近输入、synthetic／steer、没有输入时的回退、无用量消息、时间缺失及无效日期、失败／中断、压缩、分叉副本及开放轮次边界、累计值重建、会话切换迟到结果隔离、子代理刷新范围、刷新失败保留快照与暂存／已提交回退。时间计算没有额外请求或每秒读取，沿用原有分页与消息快照。
+
+真实 TUI smoke 直接比对首次回答同屏的原生页脚与插件累计值，并以独立的向后扫描 oracle 核对逐轮毫秒合计；另验证空会话为 `0s`、生成中不伪造时长、空闲不增长、累计父轮次不额外加入子代理、切换和新 TUI 从消息历史恢复、子代理浮窗与 48 列单行摘要、中断增加已上报的原生时长，以及真实分叉不继承时间、已完成 compaction 保留升序完整历史。原有 `/usage`、模型切换、TPS／TTFT、未知上下文上限、逐消息定价等全部断言继续通过。
+
+本轮原生耗时的真实集成仅验证 2.0.26；旧历史语义由固定夹具覆盖，没有据此宣称在所有旧宿主重新完成验证。SDK 的已验证宿主记录加入 2.0.26，保留 2.0.11／2.0.22／2.0.24 的既有记录。Node 22 MockTimers 与 OpenTUI 引擎警告保留，没有隐藏或强制绕过。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-22Efc0`，其中 `05-message.txt` 保存同屏原生页脚与 `Run Time`，`result.json` 保存各会话累计毫秒和宿主版本。
+
+## 2026-10-09 · 统计钩子的 MCP 等待上限
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包仍为 0.4.6、SDK 2.0.24，真实宿主为 PATH 中的 OpenCode 2.0.25。未升级版本、提交、推送或发布。
+
+MCP 元数据缓存缺失或失效时，共享读取默认最多等待 100 ms，构造参数可注入测试预算。独立定时器结束等待，同时通过 SDK 的 `AbortSignal` 请求中止读取；忽略取消的迟到成功／失败不会更新缓存或清除后续读取。超时或错误时复用旧元数据，不延长缓存 TTL，后续请求可重试；无缓存则跳过本次估算，保留已有估算与时间戳，不写入伪造零值。成功读取的空列表仍是有效缓存。持久化继续按会话顺序异步执行。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `node --import tsx --test test/context-capture.test.ts` | 专项 14 项通过，新增 11 项回归测试 |
+| `npm test` | 129 项通过 |
+| `npm run build` | 通过 |
+| `npm run test:smoke` | 完整通过，打包／隔离安装 + 真实 OpenCode 2.0.25 + 本地模拟提供商 |
+
+新增测试覆盖永久挂起、100 ms 默认预算与可注入预算、并发共享读取、TTL／事件失效后的旧缓存回退、空缓存、超时后重试、迟到成功／失败与新读取的竞争、同步／异步错误、定时器清理，以及会话删除、flush 和服务端钩子的有界 MCP 等待。挂起与迟到竞态使用可控 Promise 和模拟时钟验证；真实 smoke 验证正常宿主链路，未在真实宿主中注入 MCP 挂起。Node 22 的 MockTimers 实验性警告和 OpenTUI 安装引擎警告未隐藏。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-Syw70N`。
+
+## 2026-10-09 · Last Request 与上下文上限解耦
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包 0.4.6、SDK 2.0.24，真实宿主为 PATH 中的 OpenCode 2.0.25。
+
+`requestDetails` 独立提取所选 assistant 的五类 token、总量和消息时间，`contextUsage` 单独校验模型上限。Last Request 的分类占比以请求总量为分母；上限缺失、为零、负值或非有限值时，实测请求仍可显示。时间依次取同一条消息有效的 `streamed`、`completed`、`created`，缺失时隐藏；来源估算的 `capturedAt` 仅显示在 Context Breakdown。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 116 项通过，新增 3 项请求明细、时间与边界回归测试，并扩展控制器生命周期断言 |
+| `npm run build` | 通过 |
+| `npm run test:smoke` | 完整通过，打包／隔离安装 + 真实 OpenCode 2.0.25 + 本地模拟提供商 |
+
+自动化测试覆盖有效／无效上限切换、请求分类与缓存率、时间优先级及无效日期、压缩与回退边界、子会话本地请求、刷新失败保留快照、跨会话清理，以及来源 RPC 缓慢／失败／返回另一轮请求的估算时间。
+
+真实终端验证新增上限为 0 的活动模型：Context Window 显示不可用，Last Request 在紧凑／详细模式下仍显示 `Cache Read 1.0K`／`1,000 (78.7%)` 与 `Cache Rate 83.3%`，切回有效上限后恢复 Context。另核对两个标题各自显示实测 assistant 的流式结束时间和来源估算采样时间，并验证空请求不显示时间。完整 smoke 同时通过 100／48 列布局、子代理全树汇总、TPS／TTFT、定价、真实分叉及已完成压缩与消息排序检查。启动时按既有版本策略提示 2.0.25 未验证，随后实际完成全部检查。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-12xAKR`，其中 `08-unknown-context-limit.txt` 保存未知上限下的详细弹窗。
+
+## 2026-10-07 · npm 发布可见性校验“假失败”修复
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，本地包版本为 0.4.5、SDK 为 2.0.24。本轮仅修改发布校验、工作流、测试与文档，未修改价格快照或插件运行时代码，未升级版本、移动标签、提交、推送、重跑 GitHub 工作流或实际发布 npm。
+
+只读诊断确认已有真实自动发布链路：
+
+- [价格更新运行 37555311596](https://github.com/chenlongapps/opencode-token-usage/actions/runs/37555311596) 由 `schedule` 触发，验证、patch 提交／原子推送、GitHub Release 和 dispatch 均成功。
+- [发布运行 37555363814](https://github.com/chenlongapps/opencode-token-usage/actions/runs/37555363814) 固定在 `v0.4.5`（`66e0584e1f125f2e5012b081014e42d7d8d57d19`）。`npm publish` 成功，生成 provenance，并在 UTC 01:06:28 提示包仍在处理、可能需几分钟才能可用；失败的是 UTC 01:08:21 的 registry 可见性校验。旧实现只查询 12 次、间隔 10 秒，约 2 分钟即超时。
+- 当前 registry 查询已返回目标版本与 `latest` 均为 `0.4.5`，`gitHead` 匹配上述提交，`dist.shasum` 为 `75f8490aa51a974a5d76942a4e1ffa2d9d13fd3c`，与真实发布日志一致。因此不能把该工作流的失败结论当作 npm 未收到版本，更不能为此另升 patch。
+
+修复将按次数重试改为默认 10 分钟总时限，使用单调时钟计算剩余预算；每次版本／`latest` 请求最多 30 秒，且不得超过剩余预算，等待同样按剩余时间截短。`NPM_VERIFY_TIMEOUT_MS` 与 `NPM_VERIFY_INTERVAL_MS` 可配置并校验合法性。日志显示轮询进度、当前 `latest` 与具体查询错误；最终超时仍返回非零退出码，在 Actions 摘要中保留最后原因及原标签重试提示，不用 `continue-on-error` 掩盖故障。发布校验步骤上限为 11 分钟，整个任务仍为 20 分钟；已发布版本跳过发布与 `latest` 核验，原有禁止倒退 `latest`、registry 故障不等于版本不存在等保护保持不变。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `node --test test/release.test.mjs` | 发布专项 23 项通过 |
+| `npm test` | 113 项通过，比上轮净增 10 项发布校验回归测试 |
+| `npm run build` | 通过 |
+| `npm pack --dry-run` | 通过，执行 `prepack` 构建，包含 37 个发布文件 |
+| `npm publish --dry-run` | 通过，执行类型检查、113 项测试与构建；未写入 registry |
+| GitHub 工作流 | 三个工作流均通过官方 actionlint 1.7.12 检查，下载产物已校验 SHA-256 |
+| npm 只读查询 | `publish-state` 返回 `published=true`；新版 `verify-published` 确认 `0.4.5` 与 `latest` |
+
+回归测试用注入时钟模拟版本在 3 分钟后可见、`latest` 在 4 分钟后更新；同时覆盖 404、HTTP 401／403／429／500／503、网络及无效响应、最后原因保留、单次请求 30 秒上限、请求与等待共用预算、到期后不再发起 `latest` 查询或判定成功，以及真实 AbortSignal 中止挂起请求。CLI 测试预载本地 registry 模拟，不访问真实 npm，验证环境配置、超时非零退出码和失败／成功摘要。
+
+以上真实 GitHub 运行属于修复前的已有标签；新校验逻辑尚未在新的真实发布工作流中验证。本次没有重跑 TUI smoke，之前的宿主验证记录保留。修复提交进入 `main` 后仅供后续新标签使用；旧标签不移动，重跑已可见的 `v0.4.5` 会由原实现跳过发布并核验现有版本。
+
 ## 2026-10-07 · SDK 2.0.24 升级
 
 环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包仍为 0.4.4。`@opencode/plugin`、`@opencode/client`、`@opencode/schema` 和 `@opencode/theme` 从 2.0.11 同步精确升级到 2.0.24；锁文件中的全部七个 OpenCode 包均为 2.0.24。OpenTUI 从 0.5.10 同步到 SDK 与 theme 配套的 0.5.14，没有追随独立发布的 0.5.15。未修改价格快照、未升插件包版本、未提交或推送、未实际发布 npm。

package/package.json

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