@reedchan/statusline 1.5.0 → 1.7.0

package/README.md

@@ -8,8 +8,8 @@ Replaces pi's footer with a labelled two-row one. Every value carries a word, so
 decoded from a symbol or remembered from a legend.
 
 ```
-Context  █████████▍░░░░░░░░░░  47.1%   471k / 1.0M                   Input 194k  ·  Output 89k  ·  Cache hit 99.9%  ·  Cost $0.229
-~/.pi (master)                                                               deepseek-flash · Effort high · TTFT 482ms · 729 tok/s
+Context  █████████▍░░░░░░░░░░  47%   471k / 1.0M     Input 194k  ·  Output 89k  |  Cache hit 99.9%  |  Cost $0.229  ·  Today $1.63
+~/.pi (master)                         deepseek-flash · Effort high | TTFT 482ms · Avg TTFT 612ms | Last 729 tok/s · Avg 512 tok/s
 LSP Active: typescript
 ```
 
@@ -19,17 +19,18 @@ columns only the meter is left. Every step is a whole value — a number is neve
 
 ## What each part is
 
-| Part                        | Meaning                                                                                                                                                                                      |
-| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Context` + meter + `47.1%` | Share of the model's context window in use. The fill turns `warning` above 70% and `error` above 90%, the same thresholds pi's shipped footer uses, and the percentage changes color with it |
-| `471k / 1.0M`               | Absolute context tokens over the window size. The first thing dropped when the terminal is narrow                                                                                            |
-| `Input` / `Output`          | Session prompt and completion tokens. `Input` counts the prompt tokens that were neither read from nor written to cache, because pi reports those two separately in the same `usage` object  |
-| `Cache hit`                 | The latest turn's cache hit rate, `cacheRead / (input + cacheRead + cacheWrite)`                                                                                                             |
-| `Cost`                      | Session cost, in USD unless a config file names another currency (see below)                                                                                                                 |
-| Effort                      | The active thinking level                                                                                                                                                                    |
-| `TTFT`                      | Time from request dispatch to the first streamed token                                                                                                                                       |
-| `tok/s`                     | Decode throughput, i.e. output tokens per second of decode time                                                                                                                              |
-| Last line                   | Other extensions' `ctx.ui.setStatus()` entries, so they do not silently disappear                                                                                                            |
+| Part                      | Meaning                                                                                                                                                                                      |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `Context` + meter + `47%` | Share of the model's context window in use. The fill turns `warning` above 70% and `error` above 90%, the same thresholds pi's shipped footer uses, and the percentage changes color with it |
+| `471k / 1.0M`             | Absolute context tokens over the window size. The first thing dropped when the terminal is narrow                                                                                            |
+| `Input` / `Output`        | Session prompt and completion tokens. `Input` counts the prompt tokens that were neither read from nor written to cache, because pi reports those two separately in the same `usage` object  |
+| `Cache hit`               | The latest turn's cache hit rate, `cacheRead / (input + cacheRead + cacheWrite)`                                                                                                             |
+| `Cost`                    | Session cost, in USD unless a config file names another currency (see below)                                                                                                                 |
+| `Today`                   | Today's running cost across every project, session and model on this machine                                                                                                                 |
+| Effort                    | The active thinking level                                                                                                                                                                    |
+| `TTFT`                    | Time from request dispatch to the first streamed token                                                                                                                                       |
+| `tok/s`                   | Decode throughput, i.e. output tokens per second of decode time                                                                                                                              |
+| Last line                 | Other extensions' `ctx.ui.setStatus()` entries, so they do not silently disappear                                                                                                            |
 
 ## The meter
 

package/README_CN.md

@@ -7,8 +7,8 @@
 替换 pi 的 footer，改成带文字标签的两行。每个值都带一个词，不需要靠符号猜、也不需要记图例。
 
 ```
-Context  █████████▍░░░░░░░░░░  47.1%   471k / 1.0M                   Input 194k  ·  Output 89k  ·  Cache hit 99.9%  ·  Cost $0.229
-~/.pi (master)                                                               deepseek-flash · Effort high · TTFT 482ms · 729 tok/s
+Context  █████████▍░░░░░░░░░░  47%   471k / 1.0M     Input 194k  ·  Output 89k  |  Cache hit 99.9%  |  Cost $0.229  ·  Today $1.63
+~/.pi (master)                         deepseek-flash · Effort high | TTFT 482ms · Avg TTFT 612ms | Last 729 tok/s · Avg 512 tok/s
 LSP Active: typescript
 ```
 
@@ -25,6 +25,7 @@ LSP Active: typescript
 | `Input` / `Output`         | 会话的输入与输出 token 量。`Input` 指既没命中缓存、也没写入缓存的那部分 prompt token，因为 pi 把这两种情况在同一个 `usage` 对象里分开报 |
 | `Cache hit`                | 最近一轮的缓存命中率，`cacheRead / (input + cacheRead + cacheWrite)`                                                                    |
 | `Cost`                     | 会话花费，默认美元；配置了其他币种则换算显示（见下）                                                                                    |
+| `Today`                    | 当天跨项目、跨会话、跨模型的累计花费                                                                                                    |
 | Effort                     | 当前思考等级                                                                                                                            |
 | `TTFT`                     | 从发出请求到第一个流式 token 的耗时                                                                                                     |
 | `tok/s`                    | 解码吞吐，即每秒解码时间产出的输出 token 数                                                                                             |

package/extensions/statusline/index.ts

@@ -18,7 +18,8 @@
  * stepStartTime; decodeMs = completedTime - firstTokenTime; tok/s = usage.output / (decodeMs / 1000)
  */
 
-import { readFile, writeFile } from 'node:fs/promises'
+import { readFile, readdir, writeFile } from 'node:fs/promises'
+import { stat } from 'node:fs/promises'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
 
@@ -36,6 +37,7 @@ import {
   formatCwd,
   formatLatency,
   formatTps,
+  avgMs,
   isQuietStatus,
   pair,
   cachedRates,
@@ -62,6 +64,10 @@ const FALLBACK_TOKENS_PER_CHAR = 0.25
 const CONFIG_PATH = join(homedir(), '.pi', 'agent', 'statusline.json')
 /** Free, keyless, and one request returns every currency — so the cache serves instant switching. */
 const RATES_URL = 'https://open.er-api.com/v6/latest/USD'
+/** Every session on this machine, for the day-cost total that spans projects and models. */
+const SESSIONS_DIR = join(homedir(), '.pi', 'agent', 'sessions')
+/** Where throughput metrics wait out a /reload: keyed by session file, so a reload restores. */
+const STATE_PATH = join(homedir(), '.pi', 'agent', 'statusline-state.json')
 const FETCH_TIMEOUT_MS = 5000
 
 function today(): string {
@@ -97,6 +103,83 @@ async function fetchRates(): Promise<Record<string, number> | null> {
  * Called once per session on purpose: a footer that stat'ed a file on every frame would be its own
  * bug. Editing the file therefore takes effect on `/reload`.
  */
+function startOfToday(): number {
+  const start = new Date()
+  start.setHours(0, 0, 0, 0)
+  return start.getTime()
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+}
+
+/** Coerces a persisted counter back to a non-negative finite number, or 0. */
+function num(value: unknown): number {
+  return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : 0
+}
+
+/** Today's provider cost of one session-file line, or null when the line bills nothing today. */
+function entryCost(line: string, since: number): number | null {
+  if (!line.includes('"usage"')) return null
+  let entry: unknown
+  try {
+    entry = JSON.parse(line)
+  } catch {
+    return null
+  }
+  if (!isRecord(entry) || typeof entry.timestamp !== 'string') return null
+  if (Date.parse(entry.timestamp) < since) return null
+  if (!isRecord(entry.usage) || !isRecord(entry.usage.cost)) return null
+  const total = entry.usage.cost.total
+  return typeof total === 'number' && Number.isFinite(total) ? total : null
+}
+
+/**
+ * Today's cost across every other session on this machine.
+ *
+ * Files not touched today are skipped unread, and this session's own file is skipped because its
+ * cost is already live in totals.cost — counting both would double a resumed session.
+ */
+async function sumOtherTodaysCost(currentFile: string | null, since: number): Promise<number> {
+  let dirs: string[] = []
+  try {
+    dirs = await readdir(SESSIONS_DIR)
+  } catch {
+    return 0
+  }
+  const lists = await Promise.all(
+    dirs.map(async (dir) => {
+      const dirPath = join(SESSIONS_DIR, dir)
+      let names: string[] = []
+      try {
+        names = await readdir(dirPath)
+      } catch {
+        return []
+      }
+      return names
+        .map((name) => join(dirPath, name))
+        .filter((path) => path.endsWith('.jsonl') && path !== currentFile)
+    }),
+  )
+  const costs = await Promise.all(
+    lists.flat().map(async (path) => {
+      try {
+        if ((await stat(path)).mtimeMs < since) return 0
+      } catch {
+        return 0
+      }
+      const text = await readFile(path, 'utf8').catch(() => '')
+      let total = 0
+      for (const line of text.split('\n')) {
+        const cost = entryCost(line, since)
+        if (cost !== null) total += cost
+      }
+      return total
+    }),
+  )
+  return costs.reduce((sum, value) => sum + value, 0)
+}
+
 async function loadCurrency(notify: (message: string) => void): Promise<Currency> {
   let text: string | null = null
   try {
@@ -167,6 +250,7 @@ interface Totals {
   cacheWrite: number
   cost: number
   cacheHitRate: number | null
+  todayCost: number
 }
 
 /** The usage fields this footer totals, read structurally so no cast is needed. */
@@ -178,7 +262,7 @@ type UsageTotals = {
   cost: { total: number }
 }
 
-function collectTotals(ctx: ExtensionContext): Totals {
+function collectTotals(ctx: ExtensionContext, since: number): Totals {
   const totals: Totals = {
     input: 0,
     output: 0,
@@ -186,29 +270,38 @@ function collectTotals(ctx: ExtensionContext): Totals {
     cacheWrite: 0,
     cost: 0,
     cacheHitRate: null,
+    todayCost: 0,
   }
   // `usage` stays optional here even though an assistant message always carries it:
   // a truncated or hand-edited session file is the case this guard is for.
-  const add = (usage: UsageTotals | undefined, assistant: boolean): void => {
+  const add = (usage: UsageTotals | undefined, assistant: boolean, isToday: boolean): void => {
     if (!usage) return
     totals.input += usage.input
     totals.output += usage.output
     totals.cacheRead += usage.cacheRead
     totals.cacheWrite += usage.cacheWrite
     totals.cost += usage.cost.total
+    if (isToday) totals.todayCost += usage.cost.total
     if (!assistant) return
     const prompt = usage.input + usage.cacheRead + usage.cacheWrite
     if (prompt > 0) totals.cacheHitRate = (usage.cacheRead / prompt) * 100
   }
   for (const entry of ctx.sessionManager.getEntries()) {
+    const stamp =
+      'timestamp' in entry && typeof entry.timestamp === 'string'
+        ? Date.parse(entry.timestamp)
+        : Number.NaN
+    const isToday = Number.isFinite(stamp) && stamp >= since
     if (entry.type === 'message') {
       const { message } = entry
-      if (message.role === 'assistant') add(message.usage, true)
-      else if (message.role === 'toolResult') add(message.usage, false)
+      if (message.role === 'assistant') add(message.usage, true, isToday)
+      else if (message.role === 'toolResult') add(message.usage, false, isToday)
       continue
     }
     // Compaction and branch summaries bill a model call of their own.
-    if (entry.type === 'compaction' || entry.type === 'branch_summary') add(entry.usage, false)
+    if (entry.type === 'compaction' || entry.type === 'branch_summary') {
+      add(entry.usage, false, isToday)
+    }
   }
   return totals
 }
@@ -240,6 +333,10 @@ export default function (pi: ExtensionAPI) {
   let requestAt: number | null = null
   let firstTokenAt: number | null = null
   let totalDecodeMs = 0
+  let totalMeasuredOutput = 0
+  let totalTtftMs = 0
+  let ttftCount = 0
+  let todayBase = 0
   let ticker: ReturnType<typeof setInterval> | null = null
   let windowAt = 0
   let windowTokens = 0
@@ -278,6 +375,48 @@ export default function (pi: ExtensionAPI) {
     }, TICK_MS)
   }
 
+  /**
+   * Writes the throughput metrics so a /reload can restore them.
+   *
+   * Decode timing only exists in live stream events — pi records nothing per message — so without
+   * this file the session's averages reset to zero every time the extension re-loads.
+   */
+  function persist(sessionFile: string | null): void {
+    if (sessionFile === null) return
+    const state = {
+      sessionFile,
+      totalDecodeMs,
+      totalMeasuredOutput,
+      totalTtftMs,
+      ttftCount,
+      last: reading,
+    }
+    void writeFile(STATE_PATH, `${JSON.stringify(state, null, 2)}\n`).catch(() => {})
+  }
+
+  /** Restores what persist wrote, but only for this exact session file. */
+  async function restore(sessionFile: string | null): Promise<void> {
+    if (sessionFile === null) return
+    let state: unknown
+    try {
+      state = JSON.parse(await readFile(STATE_PATH, 'utf8'))
+    } catch {
+      return
+    }
+    if (!isRecord(state) || state.sessionFile !== sessionFile) return
+    totalDecodeMs = num(state.totalDecodeMs)
+    totalMeasuredOutput = num(state.totalMeasuredOutput)
+    totalTtftMs = num(state.totalTtftMs)
+    ttftCount = num(state.ttftCount)
+    if (isRecord(state.last) && typeof state.last.rate === 'number') {
+      reading = {
+        rate: state.last.rate,
+        exact: state.last.exact === true,
+        ttftMs: typeof state.last.ttftMs === 'number' ? state.last.ttftMs : null,
+      }
+    }
+  }
+
   function installFooter(ctx: ExtensionContext): void {
     ctx.ui.setFooter((tui, theme, footerData: ReadonlyFooterDataProvider) => {
       requestRender = () => tui.requestRender()
@@ -289,8 +428,8 @@ export default function (pi: ExtensionAPI) {
         },
         render(width: number): string[] {
           const usage = ctx.getContextUsage()
-          const totals = collectTotals(ctx)
-          const avg = avgTokPerSec(totals.output, totalDecodeMs)
+          const totals = collectTotals(ctx, startOfToday())
+          const avg = avgTokPerSec(totalMeasuredOutput, totalDecodeMs)
           const row1 = contextRow(
             theme,
             width,
@@ -302,23 +441,36 @@ export default function (pi: ExtensionAPI) {
               output: totals.output,
               cacheHitRate: totals.cacheHitRate,
               cost: totals.cost,
+              todayCost: todayBase + totals.todayCost,
             },
             currency,
           )
 
-          // Row 2: model and the latest turn's timing on the right, path on the left.
+          // Row 2: model and the latest turn's timing on the right, path on the left. Three
+          // groups — identity, first token, throughput — separated by a wall instead of another
+          // dot, because a run of similar-looking pairs is what made the old footer unreadable.
           const model = ctx.model?.id ?? 'no model'
-          const row2Parts = [theme.fg('accent', model)]
-          if (ctx.thinkingLevel) row2Parts.push(pair(theme, 'Effort', ctx.thinkingLevel, 'muted'))
+          const separator = theme.fg('dim', '  ·  ')
+          const wall = theme.fg('dim', '  |  ')
+          const identity = [theme.fg('accent', model)]
+          if (ctx.thinkingLevel) identity.push(pair(theme, 'Effort', ctx.thinkingLevel, 'muted'))
+
+          const ttft: string[] = []
           const waiting = ttftDisplay(requestAt, firstTokenAt, Date.now())
           if (waiting !== null) {
             // The clock is running: this wait has no reading yet, so the previous turn's
-            // throughput would only be mistaken for the current one.
-            row2Parts.push(pair(theme, 'TTFT', waiting.text, 'muted'))
+            // numbers would only be mistaken for the current one.
+            ttft.push(pair(theme, 'TTFT', waiting.text, 'muted'))
           } else if (reading) {
             if (reading.ttftMs !== null)
-              row2Parts.push(pair(theme, 'TTFT', formatLatency(reading.ttftMs), 'muted'))
-            row2Parts.push(
+              ttft.push(pair(theme, 'TTFT', formatLatency(reading.ttftMs), 'muted'))
+          }
+          const avgTtft = avgMs(totalTtftMs, ttftCount)
+          if (avgTtft !== null) ttft.push(pair(theme, 'Avg TTFT', formatLatency(avgTtft), 'muted'))
+
+          const throughput: string[] = []
+          if (reading) {
+            throughput.push(
               pair(
                 theme,
                 'Last',
@@ -327,9 +479,12 @@ export default function (pi: ExtensionAPI) {
               ),
             )
           }
-          if (avg !== null) row2Parts.push(pair(theme, 'Avg', `${formatTps(avg)} tok/s`, 'muted'))
-          const row2Right = row2Parts.join(theme.fg('dim', '  ·  '))
+          if (avg !== null) throughput.push(pair(theme, 'Avg', `${formatTps(avg)} tok/s`, 'muted'))
 
+          const row2Right = [identity, ttft, throughput]
+            .filter((group) => group.length > 0)
+            .map((group) => group.join(separator))
+            .join(wall)
           const branch = footerData.getGitBranch()
           const path = formatCwd(ctx.cwd)
           const branchSuffix = branch ? ` (${branch})` : ''
@@ -388,9 +543,13 @@ export default function (pi: ExtensionAPI) {
     reading = null
     requestAt = null
     totalDecodeMs = 0
+    totalMeasuredOutput = 0
     stopTicker()
     resetStream()
     currency = await loadCurrency((message) => ctx.ui.notify(message, 'warning'))
+    const file = ctx.sessionManager.getSessionFile()
+    await restore(file ?? null)
+    todayBase = await sumOtherTodaysCost(file ?? null, startOfToday())
     installFooter(ctx)
   })
 
@@ -455,7 +614,7 @@ export default function (pi: ExtensionAPI) {
     publish(rate, false, ttftMs(requestAt, firstTokenAt))
   })
 
-  pi.on('message_end', async (event) => {
+  pi.on('message_end', async (event, ctx) => {
     if (event.message.role !== 'assistant') return
 
     const message = event.message as { content: unknown; usage?: { output?: number } }
@@ -470,8 +629,14 @@ export default function (pi: ExtensionAPI) {
     const measured = ttftMs(requestAt, firstTokenAt)
     const tokens = output > 0 ? output : totalChars * (ratio ?? FALLBACK_TOKENS_PER_CHAR)
     if (measured !== null && decodeMs >= MIN_SAMPLE_MS) {
-      // Session-average numerator lives in collectTotals; this is its denominator.
+      // The average's numerator and denominator must cover the same messages: totals.output spans
+      // the whole session (a reload replays none of it), so pairing it with the partial denominator
+      // below once produced an Avg of 4324 tok/s.
       totalDecodeMs += decodeMs
+      if (output > 0) totalMeasuredOutput += output
+      totalTtftMs += measured
+      ttftCount += 1
+      persist(ctx.sessionManager.getSessionFile() ?? null)
       publish((tokens / decodeMs) * 1000, output > 0, measured)
     }
     // Null it with the stream: a request that has produced its message is no longer in flight, and

package/extensions/statusline/render.ts

@@ -296,6 +296,11 @@ export function avgTokPerSec(outputTokens: number, decodeMs: number): number | n
   return outputTokens / (decodeMs / 1000)
 }
 
+/** Mean of `count` durations totalling `totalMs`; null when nothing was measured. */
+export function avgMs(totalMs: number, count: number): number | null {
+  return count > 0 ? totalMs / count : null
+}
+
 /**
  * The config file's text with the day's rates recorded in it, so the next session starts warm.
  *
@@ -397,6 +402,8 @@ export interface ContextRowParts {
   output: number
   cacheHitRate: number | null
   cost: number
+  /** Today's spend across every session on this machine, or 0 to hide the slot. */
+  todayCost: number
 }
 
 /**
@@ -421,7 +428,8 @@ export function contextRow(
   const fraction = parts.percent === null ? 0 : parts.percent / 100
   const percent = theme.fg(
     percentColor(parts.percent),
-    parts.percent === null ? '?' : `${parts.percent.toFixed(1)}%`,
+    // Whole percents: the meter carries the precision, and a decimal here is noise.
+    parts.percent === null ? '?' : `${Math.round(parts.percent)}%`,
   )
   const meter = `${theme.fg('dim', 'Context')}  ${bar(theme, BAR_CELLS, fraction)}  ${percent}`
   const detail =
@@ -432,15 +440,28 @@ export function contextRow(
   const volumes: string[] = []
   if (parts.input > 0) volumes.push(pair(theme, 'Input', formatTokens(parts.input)))
   if (parts.output > 0) volumes.push(pair(theme, 'Output', formatTokens(parts.output)))
-  const outcomes: string[] = []
+  const hit: string[] = []
   if (parts.cacheHitRate !== null) {
-    outcomes.push(pair(theme, 'Cache hit', `${parts.cacheHitRate.toFixed(1)}%`))
+    hit.push(pair(theme, 'Cache hit', `${parts.cacheHitRate.toFixed(1)}%`))
+  }
+  const money: string[] = []
+  if (parts.cost > 0) money.push(pair(theme, 'Cost', formatCost(parts.cost, currency)))
+  if (parts.todayCost > 0) {
+    money.push(pair(theme, 'Today', formatCost(parts.todayCost, currency)))
   }
-  if (parts.cost > 0) outcomes.push(pair(theme, 'Cost', formatCost(parts.cost, currency)))
 
   const separator = theme.fg('dim', '  ·  ')
-  const full = [...volumes, ...outcomes].join(separator)
-  const core = outcomes.join(separator)
+  // Groups, not a flat run of dots: volumes | cache | money. A wall between different kinds of
+  // number reads faster than another dot between similar-looking ones.
+  const groups: string[] = []
+  if (volumes.length > 0) groups.push(volumes.join(separator))
+  if (hit.length > 0) groups.push(hit.join(separator))
+  if (money.length > 0) groups.push(money.join(separator))
+  const full = groups.join(theme.fg('dim', '  |  '))
+  const core =
+    hit.length > 0 && money.length > 0
+      ? hit.join(separator) + theme.fg('dim', '  |  ') + money.join(separator)
+      : [...hit, ...money].join(separator)
   const fits = (left: string, right: string): boolean =>
     right === '' || visibleWidth(left) + 2 + visibleWidth(right) <= width
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reedchan/statusline",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Replaces pi's footer with a labelled two-row status line: context pressure as a fixed-size meter, cache and cost, the model and effort level, and the latest turn's TTFT and decode throughput in tokens/second.",
   "keywords": [
     "bun",