teamshare-bridge 0.14.17 → 0.14.18

package/dist/lib/usage-reader.d.ts

@@ -0,0 +1,46 @@
+export interface UsageSession {
+    title: string;
+    model: string;
+    providerID: string;
+    cost: number;
+    tokensInput: number;
+    tokensOutput: number;
+    tokensReasoning: number;
+    tokensCacheRead: number;
+    tokensCacheWrite: number;
+    timeCreated: number;
+    timeUpdated: number;
+    durationMin: number;
+    attribution: 'user' | 'agent';
+    teamshare: boolean;
+}
+export interface UsageReport {
+    day: string;
+    dbPath: string;
+    provider: string;
+    totalCost: number;
+    sessionCount: number;
+    userCost: number;
+    agentCost: number;
+    teamshareCost: number;
+    tokens: {
+        input: number;
+        output: number;
+        reasoning: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    sessions: UsageSession[];
+}
+export interface UsageOptions {
+    day?: string;
+    agent?: string;
+    /** Force a specific provider instead of auto-detecting. */
+    provider?: 'opencode' | 'codex';
+}
+/**
+ * Read the usage report directly from the harness database.
+ * Auto-detects the provider (opencode > codex) or uses the explicit option.
+ * Throws if no provider database is found.
+ */
+export declare function readUsageReport(opts?: UsageOptions): UsageReport;

package/dist/lib/usage-reader.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readUsageReport = readUsageReport;
+/**
+ * Usage report reader — reads cost data directly from harness databases.
+ *
+ * Replaces the Python tools/usage_report.py with in-process Node reads via
+ * better-sqlite3. Supports multiple providers:
+ *   - opencode: ~/.local/share/opencode/opencode.db (session table)
+ *   - codex: ~/.codex/logs_2.sqlite (logs table, no cost data yet)
+ *   - claude/gemini: no local cost database (returns empty)
+ *
+ * The report is fully offline, needs neither the backend nor the daemon.
+ */
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+// ── Provider-specific database paths ──────────────────────────────────────
+function opencodeDbPath() {
+    return (0, node_path_1.join)((0, node_os_1.homedir)(), '.local', 'share', 'opencode', 'opencode.db');
+}
+function codexDbPath() {
+    return (0, node_path_1.join)((0, node_os_1.homedir)(), '.codex', 'logs_2.sqlite');
+}
+/** Returns the first available provider path, or null if none found. */
+function detectProvider() {
+    const opencodePath = opencodeDbPath();
+    if ((0, node_fs_1.existsSync)(opencodePath))
+        return { name: 'opencode', dbPath: opencodePath };
+    const codexPath = codexDbPath();
+    if ((0, node_fs_1.existsSync)(codexPath))
+        return { name: 'codex', dbPath: codexPath };
+    return null;
+}
+// ── Day bounds (local midnight ms-epoch) ─────────────────────────────────
+function today() {
+    return new Date().toISOString().slice(0, 10);
+}
+function dayBounds(day) {
+    const d = new Date(`${day}T00:00:00`);
+    const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const start = new Date(d.toLocaleString('en-US', { timeZone: tz }));
+    const end = new Date(start.getTime() + 86_400_000);
+    return { startMs: start.getTime(), endMs: end.getTime() };
+}
+function parseModel(modelJson) {
+    if (!modelJson)
+        return {};
+    try {
+        const parsed = JSON.parse(modelJson);
+        return typeof parsed === 'object' && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+// ── Attribution ───────────────────────────────────────────────────────────
+function attributeSession(title, providerId) {
+    if (title?.startsWith('TeamShare '))
+        return { attribution: 'agent', teamshare: true };
+    // opencode-go / opencode: providerID == "opencode" or "opencode-go" = user sessions
+    if (providerId === 'opencode' || providerId === 'opencode-go')
+        return { attribution: 'user', teamshare: false };
+    // claude, codex, gemini, etc. — treat as agent sessions
+    return { attribution: 'agent', teamshare: false };
+}
+// ── opencode reader ──────────────────────────────────────────────────────
+function readOpencode(dbPath, day, agentFilter) {
+    // Lazy-import better-sqlite3 so non-opencode providers don't need it loaded.
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const Database = require('better-sqlite3');
+    const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+    try {
+        const { startMs, endMs } = dayBounds(day);
+        const rows = db.prepare(`SELECT title, model, cost, tokens_input, tokens_output,
+              tokens_reasoning, tokens_cache_read, tokens_cache_write,
+              time_created, time_updated
+       FROM session WHERE time_created >= ? AND time_created < ?
+       ORDER BY time_created`).all(startMs, endMs);
+        const sessions = [];
+        for (const row of rows) {
+            const title = row.title ?? '(untitled)';
+            // Skip opencode's "New session - ..." placeholders
+            if (title.startsWith('New session'))
+                continue;
+            const cost = row.cost ?? 0;
+            const tIn = row.tokens_input ?? 0;
+            const tOut = row.tokens_output ?? 0;
+            const tReason = row.tokens_reasoning ?? 0;
+            const tCr = row.tokens_cache_read ?? 0;
+            const tCw = row.tokens_cache_write ?? 0;
+            if (cost <= 0 && !tIn && !tOut && !tReason && !tCr && !tCw)
+                continue;
+            const model = parseModel(row.model);
+            const providerId = model.providerID ?? '';
+            const { attribution, teamshare } = attributeSession(title, providerId);
+            // Agent filter
+            if (agentFilter && !title.toLowerCase().includes(`agent ${agentFilter}`.toLowerCase()))
+                continue;
+            sessions.push({
+                title,
+                model: model.id ?? '',
+                providerID: providerId,
+                cost: round6(cost),
+                tokensInput: tIn,
+                tokensOutput: tOut,
+                tokensReasoning: tReason,
+                tokensCacheRead: tCr,
+                tokensCacheWrite: tCw,
+                timeCreated: row.time_created,
+                timeUpdated: row.time_updated,
+                durationMin: round1(Math.max(0, (row.time_updated || row.time_created) - row.time_created) / 60_000),
+                attribution,
+                teamshare,
+            });
+        }
+        return buildReport(day, dbPath, 'opencode', sessions);
+    }
+    finally {
+        db.close();
+    }
+}
+// ── Codex reader (placeholder — no cost data yet) ────────────────────────
+function readCodex(dbPath, day) {
+    const Database = require('better-sqlite3');
+    const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+    try {
+        // Codex logs_2.sqlite has a logs table but no cost/token columns yet.
+        // Return empty report — ready for when codex adds cost data.
+        return buildReport(day, dbPath, 'codex', []);
+    }
+    finally {
+        db.close();
+    }
+}
+// ── Report builder ────────────────────────────────────────────────────────
+function buildReport(day, dbPath, provider, sessions) {
+    const totalCost = round6(sessions.reduce((s, x) => s + x.cost, 0));
+    const userCost = round6(sessions.filter((s) => s.attribution === 'user').reduce((s, x) => s + x.cost, 0));
+    const agentCost = round6(totalCost - userCost);
+    const teamshareCost = round6(sessions.filter((s) => s.teamshare).reduce((s, x) => s + x.cost, 0));
+    return {
+        day,
+        dbPath,
+        provider,
+        totalCost,
+        sessionCount: sessions.length,
+        userCost,
+        agentCost,
+        teamshareCost,
+        tokens: {
+            input: sessions.reduce((s, x) => s + x.tokensInput, 0),
+            output: sessions.reduce((s, x) => s + x.tokensOutput, 0),
+            reasoning: sessions.reduce((s, x) => s + x.tokensReasoning, 0),
+            cacheRead: sessions.reduce((s, x) => s + x.tokensCacheRead, 0),
+            cacheWrite: sessions.reduce((s, x) => s + x.tokensCacheWrite, 0),
+        },
+        sessions,
+    };
+}
+// ── Helpers ───────────────────────────────────────────────────────────────
+function round6(n) { return Math.round(n * 1_000_000) / 1_000_000; }
+function round1(n) { return Math.round(n * 10) / 10; }
+// ── Public API ────────────────────────────────────────────────────────────
+/**
+ * Read the usage report directly from the harness database.
+ * Auto-detects the provider (opencode > codex) or uses the explicit option.
+ * Throws if no provider database is found.
+ */
+function readUsageReport(opts = {}) {
+    const day = opts.day ?? today();
+    if (opts.provider === 'opencode') {
+        const dbPath = opencodeDbPath();
+        if (!(0, node_fs_1.existsSync)(dbPath))
+            throw new Error(`opencode db not found at ${dbPath} — has opencode ever run?`);
+        return readOpencode(dbPath, day, opts.agent ?? null);
+    }
+    if (opts.provider === 'codex') {
+        const dbPath = codexDbPath();
+        if (!(0, node_fs_1.existsSync)(dbPath))
+            throw new Error(`codex db not found at ${dbPath} — has codex ever run?`);
+        return readCodex(dbPath, day);
+    }
+    // Auto-detect
+    const detected = detectProvider();
+    if (!detected) {
+        return {
+            day,
+            dbPath: '(no provider database found)',
+            provider: 'none',
+            totalCost: 0,
+            sessionCount: 0,
+            userCost: 0,
+            agentCost: 0,
+            teamshareCost: 0,
+            tokens: { input: 0, output: 0, reasoning: 0, cacheRead: 0, cacheWrite: 0 },
+            sessions: [],
+        };
+    }
+    if (detected.name === 'opencode')
+        return readOpencode(detected.dbPath, day, opts.agent ?? null);
+    if (detected.name === 'codex')
+        return readCodex(detected.dbPath, day);
+    return buildReport(day, '(unknown)', 'none', []);
+}
+//# sourceMappingURL=usage-reader.js.map

package/dist/lib/usage-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-reader.js","sourceRoot":"","sources":["../../src/lib/usage-reader.ts"],"names":[],"mappings":"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"}

package/dist/lib/usage.d.ts

@@ -1,52 +1,18 @@
-export interface UsageSession {
-    title: string;
-    model: string;
-    providerID: string;
-    cost: number;
-    tokensInput: number;
-    tokensOutput: number;
-    tokensReasoning: number;
-    tokensCacheRead: number;
-    tokensCacheWrite: number;
-    timeCreated: number;
-    timeUpdated: number;
-    durationMin: number;
-    /** 'user' = the user's own opencode windows; 'agent' = agent sessions. */
-    attribution: 'user' | 'agent';
-    /** True when the title starts with "TeamShare " (bridge/TeamShare work). */
-    teamshare: boolean;
-}
-export interface UsageReport {
-    day: string;
-    dbPath: string;
-    totalCost: number;
-    sessionCount: number;
-    userCost: number;
-    agentCost: number;
-    teamshareCost: number;
-    tokens: {
-        input: number;
-        output: number;
-        reasoning: number;
-        cacheRead: number;
-        cacheWrite: number;
-    };
-    sessions: UsageSession[];
-}
-export interface UsageOptions {
-    /** YYYY-MM-DD (default: today, local time). */
-    day?: string;
-    /** Filter to sessions whose title carries `agent <id>`. */
-    agent?: string;
-}
-/** Resolves the python binary: TEAMSHARE_PYTHON > known 3.14 > PATH python. */
-export declare function pythonBinary(): string;
-/** Absolute path to tools/usage_report.py (package root, whatever the cwd). */
-export declare function usageScriptPath(): string;
+/**
+ * Agent spend reporting — reads cost data directly from harness databases
+ * via better-sqlite3 (replaces the Python tools/usage_report.py).
+ *
+ * Supports opencode (SQLite session table with cost data) and codex
+ * (placeholder — no cost data yet). Falls back to empty report when
+ * no provider database is found. Fully offline; no backend/daemon needed.
+ */
+import { type UsageReport, type UsageOptions, type UsageSession } from './usage-reader';
+export type { UsageReport, UsageSession, UsageOptions };
 export declare class UsageError extends Error {
 }
 /**
- * Runs the read-only spend report. Throws UsageError when the script or the
- * db is unavailable (the caller decides how loudly to fail).
+ * Runs the read-only spend report directly from the harness database.
+ * Throws UsageError when the database is unavailable (the caller decides
+ * how loudly to fail).
  */
 export declare function runUsageReport(opts?: UsageOptions): UsageReport;

package/dist/lib/usage.js

@@ -1,69 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UsageError = void 0;
-exports.pythonBinary = pythonBinary;
-exports.usageScriptPath = usageScriptPath;
 exports.runUsageReport = runUsageReport;
 /**
- * Agent spend reporting - typed wrapper around tools/usage_report.py.
+ * Agent spend reporting — reads cost data directly from harness databases
+ * via better-sqlite3 (replaces the Python tools/usage_report.py).
  *
- * Node has no built-in sqlite, so the CLI (and the local-server /usage
- * endpoint) shells out to the Python script, which opens opencode.db with a
- * READ-ONLY sqlite uri. Never writes, never copies - the db is the source
- * of truth. Works fully offline; needs neither the backend nor the daemon.
+ * Supports opencode (SQLite session table with cost data) and codex
+ * (placeholder — no cost data yet). Falls back to empty report when
+ * no provider database is found. Fully offline; no backend/daemon needed.
  */
-const node_fs_1 = require("node:fs");
-const node_child_process_1 = require("node:child_process");
-const node_path_1 = require("node:path");
-/** Python 3.14 on this machine - has sqlite3 in stdlib and pip (unlike the
- * undocumented PATH python 3.11). env TEAMSHARE_PYTHON overrides. */
-const KNOWN_PYTHON = 'C:\\Users\\Dominion Banjo\\AppData\\Local\\Python\\bin\\python.exe';
-/** Resolves the python binary: TEAMSHARE_PYTHON > known 3.14 > PATH python. */
-function pythonBinary() {
-    if (process.env.TEAMSHARE_PYTHON)
-        return process.env.TEAMSHARE_PYTHON;
-    if ((0, node_fs_1.existsSync)(KNOWN_PYTHON))
-        return KNOWN_PYTHON;
-    return 'python';
-}
-/** Absolute path to tools/usage_report.py (package root, whatever the cwd). */
-function usageScriptPath() {
-    return (0, node_path_1.join)(__dirname, '..', '..', 'tools', 'usage_report.py');
-}
+const usage_reader_1 = require("./usage-reader");
 class UsageError extends Error {
 }
 exports.UsageError = UsageError;
 /**
- * Runs the read-only spend report. Throws UsageError when the script or the
- * db is unavailable (the caller decides how loudly to fail).
+ * Runs the read-only spend report directly from the harness database.
+ * Throws UsageError when the database is unavailable (the caller decides
+ * how loudly to fail).
  */
 function runUsageReport(opts = {}) {
-    const script = usageScriptPath();
-    if (!(0, node_fs_1.existsSync)(script)) {
-        throw new UsageError(`usage script not found: ${script} (reinstall teamshare-bridge)`);
-    }
-    const args = [script, '--json'];
-    if (opts.day)
-        args.push('--day', opts.day);
-    if (opts.agent)
-        args.push('--agent', opts.agent);
-    const res = (0, node_child_process_1.spawnSync)(pythonBinary(), args, { encoding: 'utf8' });
-    if (res.error) {
-        throw new UsageError(`could not run ${pythonBinary()} - is Python installed? (${res.error.message})`);
-    }
-    if (res.status !== 0) {
-        const detail = (res.stderr || res.stdout || '').trim();
-        throw new UsageError(detail || `usage report failed with exit code ${res.status}`);
-    }
     try {
-        const parsed = JSON.parse(res.stdout);
-        if (typeof parsed.totalCost !== 'number' || !Array.isArray(parsed.sessions)) {
-            throw new Error('unexpected report shape');
-        }
-        return parsed;
+        return (0, usage_reader_1.readUsageReport)(opts);
     }
     catch (err) {
-        throw new UsageError(`could not parse usage report output: ${err instanceof Error ? err.message : String(err)}`);
+        throw new UsageError(`Could not read usage data: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
 //# sourceMappingURL=usage.js.map

package/dist/lib/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/lib/usage.ts"],"names":[],"mappings":";;;AA6DA,oCAIC;AAGD,0CAEC;AAQD,wCA6BC;AA3GD;;;;;;;GAOG;AACH,qCAAqC;AACrC,2DAA+C;AAC/C,yCAAiC;AA8CjC;qEACqE;AACrE,MAAM,YAAY,GAAG,oEAAoE,CAAC;AAE1F,+EAA+E;AAC/E,SAAgB,YAAY;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACtE,IAAI,IAAA,oBAAU,EAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAC;IAClD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,+EAA+E;AAC/E,SAAgB,eAAe;IAC7B,OAAO,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AACjE,CAAC;AAED,MAAa,UAAW,SAAQ,KAAK;CAAG;AAAxC,gCAAwC;AAExC;;;GAGG;AACH,SAAgB,cAAc,CAAC,OAAqB,EAAE;IACpD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,IAAI,CAAC,IAAA,oBAAU,EAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAAC,2BAA2B,MAAM,+BAA+B,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,GAAG;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAA,8BAAS,EAAC,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,IAAI,UAAU,CAClB,iBAAiB,YAAY,EAAE,4BAA4B,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,CAChF,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,IAAI,UAAU,CAAC,MAAM,IAAI,sCAAsC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAgB,CAAC;QACrD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAClB,wCAAwC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC3F,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/lib/usage.ts"],"names":[],"mappings":";;;AAmBA,wCAQC;AA3BD;;;;;;;GAOG;AACH,iDAAyG;AAIzG,MAAa,UAAW,SAAQ,KAAK;CAAG;AAAxC,gCAAwC;AAExC;;;;GAIG;AACH,SAAgB,cAAc,CAAC,OAAqB,EAAE;IACpD,IAAI,CAAC;QACH,OAAO,IAAA,8BAAe,EAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAClB,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teamshare-bridge",
-  "version": "0.14.17",
+  "version": "0.14.18",
   "description": "Local bridge for TeamShare agents - CLI session runner, auto-wake WebSocket daemon, and teamshare:// protocol handler.",
   "type": "commonjs",
   "license": "MIT",
@@ -39,6 +39,8 @@
   },
   "dependencies": {
     "@napi-rs/keyring": "^1.3.0",
+    "@types/better-sqlite3": "^9.6.0",
+    "better-sqlite3": "^13.0.3",
     "socket.io-client": "^4.8.3"
   },
   "devDependencies": {

package/tools/usage_report.py

@@ -1,223 +0,0 @@
-#!/usr/bin/env python3
-"""
-usage_report.py - read-only agent spend report from the local opencode db.
-
-Queries ~/.local/share/opencode/opencode.db (SQLite, WAL mode, ~3.5 GB) with a
-READ-ONLY uri - never writes, never copies. Node has no built-in sqlite, so
-the teamshare-agent CLI shells out to this script (offline, no deps, stdlib
-only: sqlite3/argparse/json/datetime).
-
-Attribution rules (source of truth: the `session` table):
-  - title starting "TeamShare "        -> TeamShare bridge agent session
-  - providerID == "opencode"           -> the user's own opencode windows
-  - everything else                    -> other agent work (opencode-go, ...)
-
-Baseline (2026-08-16): $1.0445 across 14 cost-bearing sessions.
-
-Usage:
-  python usage_report.py [--day YYYY-MM-DD] [--agent <id>] [--json]
-"""
-import argparse
-import datetime
-import json
-import os
-import sqlite3
-import sys
-
-DB_PATH = os.path.join(
-    os.path.expanduser("~"), ".local", "share", "opencode", "opencode.db"
-)
-
-
-def db_uri() -> str:
-    """Read-only sqlite uri - NEVER open opencode.db for write (corruption
-    while opencode runs); NEVER copy the 3.5 GB file. Query in place."""
-    return "file:" + DB_PATH.replace("\\", "/") + "?mode=ro"
-
-
-def day_bounds(day: str) -> tuple[int, int]:
-    """Local-midnight ms-epoch bounds for a YYYY-MM-DD day."""
-    d = datetime.datetime.strptime(day, "%Y-%m-%d")
-    start = d.replace(tzinfo=datetime.datetime.now().astimezone().tzinfo)
-    end = start + datetime.timedelta(days=1)
-    return int(start.timestamp() * 1000), int(end.timestamp() * 1000)
-
-
-def parse_model(model_json: str | None) -> dict:
-    """`model` is a JSON string like {"id":..., "providerID":...}."""
-    if not model_json:
-        return {}
-    try:
-        parsed = json.loads(model_json)
-        return parsed if isinstance(parsed, dict) else {}
-    except (json.JSONDecodeError, TypeError):
-        return {}
-
-
-def attribution(title: str | None, provider_id: str | None) -> tuple[str, bool]:
-    """(label, is_teamshare): 'user' for the user's own windows, 'agent'
-    otherwise; TeamShare-titled sessions are flagged for the bridge split."""
-    if title and title.startswith("TeamShare "):
-        return "agent", True
-    if provider_id == "opencode":
-        return "user", False
-    return "agent", False
-
-
-def fmt_duration(ms: int) -> str:
-    seconds = max(0, ms) // 1000
-    if seconds < 60:
-        return f"{seconds}s"
-    minutes, sec = divmod(seconds, 60)
-    return f"{minutes}m {sec}s" if minutes < 60 else f"{minutes // 60}h {minutes % 60}m"
-
-
-def fmt_time(ms: int) -> str:
-    return datetime.datetime.fromtimestamp(ms / 1000).strftime("%H:%M")
-
-
-def run(day: str, agent: str | None, as_json: bool) -> int:
-    if not os.path.exists(DB_PATH):
-        print(
-            f"usage: opencode db not found at {DB_PATH} (has opencode ever run?)",
-            file=sys.stderr,
-        )
-        return 1
-    try:
-        con = sqlite3.connect(db_uri(), uri=True)
-    except sqlite3.Error as err:
-        print(f"usage: cannot open opencode db read-only: {err}", file=sys.stderr)
-        return 1
-
-    start_ms, end_ms = day_bounds(day)
-    try:
-        rows = con.execute(
-            "SELECT title, model, cost, tokens_input, tokens_output,"
-            " tokens_reasoning, tokens_cache_read, tokens_cache_write,"
-            " time_created, time_updated"
-            " FROM session WHERE time_created >= ? AND time_created < ?"
-            " ORDER BY time_created",
-            (start_ms, end_ms),
-        ).fetchall()
-    except sqlite3.Error as err:
-        print(f"usage: query failed: {err}", file=sys.stderr)
-        con.close()
-        return 1
-    con.close()
-
-    sessions = []
-    for (title, model_json, cost, t_in, t_out, t_reason, t_cr, t_cw,
-         created, updated) in rows:
-        cost = cost or 0.0
-        title = title or "(untitled)"
-        # Exclude opencode's "New session - ..." placeholders (empty shells
-        # that never carry a title; one even holds 547k cached tokens at
-        # $0). The baseline counts the remaining cost-bearing sessions, but
-        # REAL sessions on free models also matter for attribution - they
-        # show up at $0.0000 when they used tokens.
-        if title.startswith("New session"):
-            continue
-        if cost <= 0 and not (t_in or t_out or t_reason or t_cr or t_cw):
-            continue
-        model = parse_model(model_json)
-        provider_id = model.get("providerID") or ""
-        label, teamshare = attribution(title, provider_id)
-        sessions.append(
-            {
-                "title": title,
-                "model": model.get("id") or "",
-                "providerID": provider_id,
-                "cost": round(cost, 6),
-                "tokensInput": t_in or 0,
-                "tokensOutput": t_out or 0,
-                "tokensReasoning": t_reason or 0,
-                "tokensCacheRead": t_cr or 0,
-                "tokensCacheWrite": t_cw or 0,
-                "timeCreated": created,
-                "timeUpdated": updated,
-                "durationMin": round(max(0, (updated or created) - created) / 60000, 1),
-                "attribution": label,
-                "teamshare": teamshare,
-            }
-        )
-
-    total_cost = round(sum(s["cost"] for s in sessions), 6)
-    user_cost = round(sum(s["cost"] for s in sessions if s["attribution"] == "user"), 6)
-    agent_cost = round(total_cost - user_cost, 6)
-    teamshare_cost = round(sum(s["cost"] for s in sessions if s["teamshare"]), 6)
-
-    # --agent <id> filters to sessions whose title carries `agent <id>`
-    # (the format every bridge session now records: "TeamShare task <taskId>
-    # (agent <agentId>)").
-    if agent:
-        needle = f"agent {agent}".lower()
-        sessions = [s for s in sessions if needle in s["title"].lower()]
-        total_cost = round(sum(s["cost"] for s in sessions), 6)
-        user_cost = round(sum(s["cost"] for s in sessions if s["attribution"] == "user"), 6)
-        agent_cost = round(total_cost - user_cost, 6)
-        teamshare_cost = round(sum(s["cost"] for s in sessions if s["teamshare"]), 6)
-
-    tokens = {
-        "input": sum(s["tokensInput"] for s in sessions),
-        "output": sum(s["tokensOutput"] for s in sessions),
-        "reasoning": sum(s["tokensReasoning"] for s in sessions),
-        "cacheRead": sum(s["tokensCacheRead"] for s in sessions),
-        "cacheWrite": sum(s["tokensCacheWrite"] for s in sessions),
-    }
-
-    if as_json:
-        print(
-            json.dumps(
-                {
-                    "day": day,
-                    "dbPath": DB_PATH,
-                    "totalCost": total_cost,
-                    "sessionCount": len(sessions),
-                    "userCost": user_cost,
-                    "agentCost": agent_cost,
-                    "teamshareCost": teamshare_cost,
-                    "tokens": tokens,
-                    "sessions": sessions,
-                },
-                indent=2,
-            )
-        )
-        return 0
-
-    # Human table.
-    print(f"Agent spend report - {day} (local time)")
-    print(f"Source: {DB_PATH} (read-only)")
-    print(f"Total: ${total_cost:.4f} across {len(sessions)} sessions")
-    print(f"  user windows      : ${user_cost:.4f}")
-    print(f"  agent sessions    : ${agent_cost:.4f} (of which TeamShare ${teamshare_cost:.4f})")
-    print(f"Tokens: {tokens['input']:,} in / {tokens['output']:,} out / "
-          f"{tokens['reasoning']:,} reasoning / "
-          f"{tokens['cacheRead']:,} cache-read / {tokens['cacheWrite']:,} cache-write")
-    print()
-    print(f"{'time':<13} {'dur':<8} {'cost':<8} {'src':<8} {'model':<34} title")
-    print("-" * 110)
-    for s in sessions:
-        src = "user" if s["attribution"] == "user" else ("teamshare" if s["teamshare"] else "agent")
-        span = f"{fmt_time(s['timeCreated'])}-{fmt_time(s['timeUpdated'])}"
-        print(
-            f"{span:<13} {s['durationMin']:>4}m {s['cost']:>7.4f} {src:<8} "
-            f"{(s['providerID'] + '/' + s['model'])[:34]:<34} {s['title'][:60]}"
-        )
-    return 0
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(description="Read-only opencode spend report")
-    parser.add_argument(
-        "--day",
-        default=datetime.date.today().isoformat(),
-        help="YYYY-MM-DD (default: today, local time)",
-    )
-    parser.add_argument("--agent", default=None, help="filter sessions for one agent id")
-    parser.add_argument("--json", action="store_true", help="machine-readable output")
-    args = parser.parse_args()
-    return run(args.day, args.agent, args.json)
-
-
-if __name__ == "__main__":
-    sys.exit(main())