@krtclcdy/tersio 2.25.3 → 2.25.5

package/dist/extensions/shared/usage-store.js

@@ -2,8 +2,8 @@
 import { execFileSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
-import { RECENT_LIMIT, SQLITE_READ_BUFFER, canonicalModelId, classifySessionLine, classifyOpencodeMessage, costOf, durOf, hostOfSessionFile, ingestSessionRow, messageRowId, OPENCODE_DB_OVERLAP_MS, opencodeDbPath, opencodeSessionsDir, newSessionAccum, readOpencodeDbRows, sessionsDirs, walkJsonl, } from './usage-ledger.js';
-import { tersioDataPath } from '../lib/utils.js';
+import { RECENT_LIMIT, SQLITE_READ_BUFFER, canonicalModelId, classifySessionLine, classifyOpencodeMessage, costOf, durOf, agentOfSessionText, hostOfSessionFile, ingestSessionRow, messageRowId, OPENCODE_DB_OVERLAP_MS, opencodeDbPath, opencodeSessionsDir, newSessionAccum, readOpencodeDbRows, sessionsDirs, walkJsonl, } from './usage-ledger.js';
+import { tersioDataPath } from './utils.js';
 import { MODEL_ALIASES } from './pricing.js';
 import { tersioSettingsFile } from './plugin-settings.js';
 export function usageDbPath() {
@@ -41,7 +41,7 @@ function query(db, sql) {
         .map((line) => line.split('\t'));
 }
 // Bump on a parse change: unchanged transcripts are never re-read.
-const PARSER_VERSION = '11';
+const PARSER_VERSION = '12';
 // A re-parse that keeps less than half the rows means transcripts vanished mid-migration; the backup is restored instead of publishing the loss.
 const REPARSE_GUARD_RATIO = 0.5;
 let guardReport = null;
@@ -53,8 +53,25 @@ const SCHEMA_SQL = `CREATE TABLE IF NOT EXISTS meta (k TEXT PRIMARY KEY, v TEXT
     `CREATE TABLE IF NOT EXISTS files (id INTEGER PRIMARY KEY AUTOINCREMENT, path TEXT UNIQUE NOT NULL, mtime REAL NOT NULL, size INTEGER NOT NULL);` +
     `CREATE TABLE IF NOT EXISTS messages (file_id INTEGER NOT NULL REFERENCES files(id), t REAL, model TEXT NOT NULL,` +
     ` i INTEGER NOT NULL, o INTEGER NOT NULL, d REAL, cr INTEGER NOT NULL, cw INTEGER NOT NULL,` +
-    ` usd REAL, st TEXT NOT NULL, code REAL, note TEXT, tools TEXT NOT NULL DEFAULT '[]', h TEXT, id TEXT);` +
-    `CREATE INDEX IF NOT EXISTS idx_messages_file ON messages(file_id);`;
+    ` usd REAL, st TEXT NOT NULL, code REAL, note TEXT, tools TEXT NOT NULL DEFAULT '[]', h TEXT, a TEXT, id TEXT);` +
+    // Every read filters or orders by one of these three. Without them each sync and each read
+    // walks the whole table: the watermark scan, the day buckets, and the recent list all scan.
+    `CREATE INDEX IF NOT EXISTS idx_messages_file ON messages(file_id);` +
+    `CREATE INDEX IF NOT EXISTS idx_messages_t ON messages(t);` +
+    `CREATE INDEX IF NOT EXISTS idx_messages_h_t ON messages(h, t);` +
+    `CREATE INDEX IF NOT EXISTS idx_messages_model ON messages(model);`;
+/**
+ * WAL plus a checkpoint at the end of a sync: the write path stops paying an fsync per commit,
+ * and the main file still holds every row, so a backup that copies only usage.db loses nothing.
+ */
+function pragmas(db) {
+    run(db, 'PRAGMA journal_mode=WAL;' +
+        'PRAGMA synchronous=NORMAL;' +
+        'PRAGMA wal_autocheckpoint=256;' +
+        'PRAGMA cache_size=-8000;' +
+        'PRAGMA temp_store=MEMORY;' +
+        'PRAGMA mmap_size=268435456;');
+}
 function storedParserVersion(db) {
     try {
         const stored = query(db, `SELECT v FROM meta WHERE k='parser_version';`);
@@ -64,6 +81,14 @@ function storedParserVersion(db) {
         return null;
     }
 }
+// A store written by a newer tersio: this code has no forward migration, so a re-parse would swap rotated history for whatever transcripts are left.
+function isDowngrade(stored) {
+    if (stored === null)
+        return false;
+    const storedNum = Number(stored);
+    const currentNum = Number(PARSER_VERSION);
+    return Number.isFinite(storedNum) && Number.isFinite(currentNum) && storedNum > currentNum;
+}
 function countMessages(db) {
     try {
         const rows = query(db, `SELECT COUNT(*) FROM messages;`);
@@ -117,7 +142,7 @@ function migrateInPlace(db, preCount) {
             `INSERT INTO files_new (path, mtime, size) SELECT path, mtime, size FROM files;` +
             `CREATE TABLE messages_new (file_id INTEGER NOT NULL REFERENCES files_new(id), t REAL, model TEXT NOT NULL,` +
             ` i INTEGER NOT NULL, o INTEGER NOT NULL, d REAL, cr INTEGER NOT NULL, cw INTEGER NOT NULL,` +
-            ` usd REAL, st TEXT NOT NULL, code REAL, note TEXT, tools TEXT NOT NULL DEFAULT '[]', h TEXT, id TEXT);` +
+            ` usd REAL, st TEXT NOT NULL, code REAL, note TEXT, tools TEXT NOT NULL DEFAULT '[]', h TEXT, a TEXT, id TEXT);` +
             `INSERT INTO messages_new (file_id, ${cols}) SELECT (SELECT id FROM files_new WHERE files_new.path = messages.file), ${cols} FROM messages;` +
             `DROP TABLE messages;DROP TABLE files;` +
             `ALTER TABLE files_new RENAME TO files;ALTER TABLE messages_new RENAME TO messages;` +
@@ -135,6 +160,29 @@ function migrateInPlace(db, preCount) {
         return false;
     }
 }
+// v12 shape gains the agent kind (`main`, `subagent`) with a bare ALTER for the two names the
+// store already holds. No rows move and no re-parse is forced, so the existing rows read
+// `NULL` for it: a report then shows them under the main agent only, and new rows carry it.
+function canAddAgent(db) {
+    try {
+        const names = query(db, `PRAGMA table_info(messages);`).map((r) => r[1]);
+        return names.includes('file_id') && !names.includes('a');
+    }
+    catch {
+        return false;
+    }
+}
+// v12 shape gains the agent kind (`main`, `subagent`) with a bare ALTER: no rows move, so no
+// re-parse is forced. Existing rows read NULL, which a report folds under the main agent.
+function addAgentColumn(db) {
+    try {
+        run(db, `ALTER TABLE messages ADD COLUMN a TEXT;`);
+    }
+    catch {
+        return false;
+    }
+    return true;
+}
 // v10 shape gains the message id with a bare ALTER: no rows move, so no re-parse and no guard trip.
 function canAlterInPlace(db) {
     try {
@@ -154,15 +202,21 @@ function alterInPlace(db) {
     }
     return !canAlterInPlace(db);
 }
-function ensureSchema(db) {
+function ensureSchema(db, forceWipe) {
     fs.mkdirSync(path.dirname(db), { recursive: true });
     // Fold in rows stored under a pre-alias spelling; the mtime ledger will not re-read those transcripts.
     const rekeys = MODEL_ALIASES.map((a) => `UPDATE messages SET model='${a.id}' WHERE model='${a.feed}';`).join('');
     const stored = storedParserVersion(db);
+    pragmas(db);
     if (stored === PARSER_VERSION) {
         run(db, SCHEMA_SQL + rekeys);
         return;
     }
+    // A newer store keeps its rows: only an explicit force re-parse may wipe it.
+    if (!forceWipe && isDowngrade(stored)) {
+        run(db, SCHEMA_SQL + rekeys);
+        return;
+    }
     // A version bump rebuilds both tables, so no ALTER patchwork survives a migration.
     try {
         if (countMessages(db) > 0 && !newestBackupMatches(stored))
@@ -179,6 +233,12 @@ function ensureSchema(db) {
             run(db, `INSERT OR REPLACE INTO meta (k,v) VALUES ('parser_version','${PARSER_VERSION}');`);
             return;
         }
+        // The agent column is additive on the current shape: adding it keeps every row, and the
+        // unchanged transcripts that already hold their rows simply read NULL until a re-parse.
+        if (stored !== null && canAddAgent(db) && addAgentColumn(db)) {
+            run(db, `INSERT OR REPLACE INTO meta (k,v) VALUES ('parser_version','${PARSER_VERSION}');`);
+            return;
+        }
         run(db, `DROP TABLE IF EXISTS messages;DROP TABLE IF EXISTS files;` + SCHEMA_SQL +
             `INSERT OR REPLACE INTO meta (k,v) VALUES ('parser_version','${PARSER_VERSION}');`);
     }
@@ -287,7 +347,8 @@ function readFiles(db) {
     catch { /* fresh db */ }
     return known;
 }
-// OpenCode rows carry no status, code, note, or tool list; only tokens and the msg id.
+// OpenCode rows carry no status, code, note, tool list, or subagent marker: only tokens and the
+// msg id. They record as the main agent, so a store never holds a NULL kind.
 function opencodeStoredRow(oc, host, id) {
     return {
         t: oc.ms ?? null,
@@ -303,10 +364,11 @@ function opencodeStoredRow(oc, host, id) {
         note: undefined,
         tools: [],
         host,
+        agent: 'main',
         id,
     };
 }
-function parseFile(text, host, file) {
+function parseFile(text, host, file, agent) {
     const rows = [];
     // Guarded: a JSONL transcript must fall through, not abort the sync.
     let oc = null;
@@ -357,6 +419,7 @@ function parseFile(text, host, file) {
                     note: undefined,
                     tools: [],
                     host,
+                    agent,
                     id: rid,
                 });
                 continue;
@@ -381,6 +444,7 @@ function parseFile(text, host, file) {
                 note,
                 tools: parsed.tools ?? [],
                 host,
+                agent,
                 id: rid,
             });
         }
@@ -389,10 +453,10 @@ function parseFile(text, host, file) {
     return rows;
 }
 function insertSql(file, r) {
-    return `INSERT INTO messages (file_id, t, model, i, o, d, cr, cw, usd, st, code, note, tools, h, id) VALUES (` +
+    return `INSERT INTO messages (file_id, t, model, i, o, d, cr, cw, usd, st, code, note, tools, h, a, id) VALUES (` +
         `(SELECT id FROM files WHERE path=${esc(file)}),${r.t === null ? 'NULL' : String(r.t)},${esc(r.model)},${r.i},${r.o},` +
         `${nullNum(r.d)},${r.cr},${r.cw},${nullNum(r.usd)},${esc(r.st)},` +
-        `${nullNum(r.code)},${nullStr(r.note)},${esc(JSON.stringify(r.tools))},${nullStr(r.host)},${nullStr(r.id)});`;
+        `${nullNum(r.code)},${nullStr(r.note)},${esc(JSON.stringify(r.tools))},${nullStr(r.host)},${nullStr(r.agent ?? undefined)},${nullStr(r.id)});`;
 }
 // Unchanged transcripts are skipped via mtime+size; rows for deleted ones are kept so rotation never erases history. False when sqlite3 is unavailable.
 export function syncUsageDb() {
@@ -403,12 +467,16 @@ export function syncUsageDb() {
     try {
         db = usageDbPath();
         const stored = storedParserVersion(db);
-        migrated = stored !== null && stored !== PARSER_VERSION;
         // The operator deleted sessions on purpose and wants the mirror to match: bypass the guard.
         const forced = process.env.TERSIO_FORCE_REPARSE === '1';
+        // A downgrade keeps its rows: the wipe below cannot rebuild them from rotated transcripts.
+        const downgrade = !forced && isDowngrade(stored);
+        migrated = stored !== null && stored !== PARSER_VERSION && !downgrade;
+        if (downgrade)
+            guardReport = `store was written by a newer tersio (parser ${stored} > ${PARSER_VERSION}); kept its rows and skipped the re-parse`;
         if (migrated && !forced)
             preWipe = countMessages(db);
-        ensureSchema(db);
+        ensureSchema(db, forced);
         maybeScheduledBackup(db);
     }
     catch {
@@ -489,7 +557,7 @@ export function syncUsageDb() {
     try {
         for (const file of changed) {
             const text = fs.readFileSync(file, 'utf8');
-            for (const r of parseFile(text, hostOfSessionFile(file), file)) {
+            for (const r of parseFile(text, hostOfSessionFile(file), file, agentOfSessionText(text))) {
                 if (!push(insertSql(file, r)))
                     return false;
             }
@@ -531,6 +599,11 @@ export function syncUsageDb() {
         }
         catch { /* best-effort */ }
     }
+    // Fold the WAL back into the main file: a backup copies one file, and a checkpoint keeps it whole.
+    try {
+        run(db, `PRAGMA wal_checkpoint(TRUNCATE);`);
+    }
+    catch { /* best-effort */ }
     return true;
 }
 export function readUsageDb() {
@@ -544,21 +617,28 @@ export function readUsageDb() {
     }
     let rows;
     try {
-        rows = query(db, `SELECT t, model, i, o, d, cr, cw, usd, st, code, note, tools, h, id FROM messages;`);
+        // The `tools` column is the widest by far and the common case is the literal `[]`, so it is
+        // read as one column and skipped in JS rather than parsed per row. A store written before
+        // the agent column does not hold it, so the row is read without that column.
+        const names = query(db, `PRAGMA table_info(messages);`).map((r) => r[1]);
+        const agentCol = names.includes('a') ? 'a' : "''";
+        rows = query(db, `SELECT t, model, i, o, d, cr, cw, usd, st, code, note, tools, h, ${agentCol}, id FROM messages;`);
     }
     catch {
         return null;
     }
     const accum = newSessionAccum();
-    for (const [t, model, i, o, d, cr, cw, usd, st, code, note, tools, h, id] of rows) {
+    for (const [t, model, i, o, d, cr, cw, usd, st, code, note, tools, h, a, id] of rows) {
         const ts = t === '' ? undefined : Number(t);
         let toolNames = [];
-        try {
-            const parsed = JSON.parse(tools || '[]');
-            if (Array.isArray(parsed))
-                toolNames = parsed.filter((x) => typeof x === 'string');
+        if (tools && tools !== '[]' && tools !== '') {
+            try {
+                const parsed = JSON.parse(tools);
+                if (Array.isArray(parsed))
+                    toolNames = parsed.filter((x) => typeof x === 'string');
+            }
+            catch { /* keep empty */ }
         }
-        catch { /* keep empty */ }
         const usage = {
             input: Number(i) || 0,
             output: Number(o) || 0,
@@ -574,7 +654,7 @@ export function readUsageDb() {
             st: st === 'error' || st === 'aborted' ? st : 'completed',
             code: code === '' ? undefined : Number(code),
             note: note === '' ? undefined : note,
-        }, toolNames, h === '' ? undefined : h, id === '' || id === undefined ? undefined : id);
+        }, toolNames, h === '' ? undefined : h, id === '' || id === undefined ? undefined : id, a === '' ? undefined : a);
     }
     accum.recent.sort((a, b) => b.t - a.t);
     let syncedAt = 0;
@@ -594,6 +674,10 @@ export function readUsageDb() {
             byTool: accum.byTool,
             byModelMessages: accum.byModelMessages,
             byHost: accum.byHost,
+            byAgent: accum.byAgent,
+            byAgentMessages: accum.byAgentMessages,
+            byModelMeasured: accum.byModelMeasured,
+            byModelCostMessages: accum.byModelCostMessages,
             costMeasured: accum.costMeasured,
             recent: accum.recent.slice(0, RECENT_LIMIT),
         },

package/dist/extensions/{lib → shared}/utils.js

@@ -6,7 +6,7 @@ import https from 'node:https';
 import os from 'node:os';
 import path from 'node:path';
 // Promise.withResolvers is Node 22+; the package supports Node 18+.
-export function withResolvers() {
+function withResolvers() {
     let resolve;
     let reject;
     const promise = new Promise((res, rej) => { resolve = res; reject = rej; });

package/dist/extensions/{ai-addons-updater → updater}/index.js

@@ -1,25 +1,35 @@
 // /ai-addons manual updater. Node built-ins only. RTK ships SHA256 checksums with no signature, so checksum-only is the best available.
 import { execFileSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
+import fsSync from 'node:fs';
 import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { setExtensionLabel } from '../shared/host.js';
-import { CAVEMAN_REMOTE_ULTRA, CAVEMAN_REMOTE_MEGACAVE, RTK_RELEASE_API, fetchJson, findFile, findHoistedPackage, httpsGet, httpsDownload, isPiProcess, sha256Hex, parseChecksum, normalizeRtkVersion, readTextIfExists, rtkPlatformSpec, resolveRtkBinary, } from '../lib/utils.js';
+import { CAVEMAN_REMOTE_ULTRA, CAVEMAN_REMOTE_MEGACAVE, RTK_RELEASE_API, fetchJson, findFile, findHoistedPackage, httpsGet, httpsDownload, sha256Hex, parseChecksum, normalizeRtkVersion, readTextIfExists, rtkPlatformSpec, resolveRtkBinary, } from '../shared/utils.js';
 const IS_WINDOWS = process.platform === 'win32';
 const EXTENSION_DIR = path.dirname(fileURLToPath(import.meta.url));
 const PONYTAIL_REMOTE = 'https://raw.githubusercontent.com/DietrichGebert/ponytail/main/package.json';
 const RTK_BINARY = resolveRtkBinary();
-// Beside this file, not a host path: these are the rules /caveman reads.
-const cavemanRule = (name) => path.join(EXTENSION_DIR, '..', 'caveman-session', name);
+// Beside this file, not a host path: these are the rules /caveman reads. A retired
+// agent-tree copy has no `caveman` sibling, so the OMP plugin install is the
+// fallback: it is the one the plugin manifest loads from.
+const CAVEMAN_SIBLING = (name) => path.join(EXTENSION_DIR, '..', 'caveman', name);
+function cavemanRule(name) {
+    const beside = CAVEMAN_SIBLING(name);
+    if (fsSync.existsSync(beside))
+        return beside;
+    const plugin = path.join(os.homedir(), '.omp', 'plugins', 'node_modules', '@krtclcdy', 'tersio', 'extensions', 'caveman', name);
+    return fsSync.existsSync(plugin) ? plugin : beside;
+}
 const CAVEMAN_LOCAL = cavemanRule('rule.md');
 const CAVEMAN_TRACKED = [
     { file: cavemanRule('rule-ultra.md'), remote: CAVEMAN_REMOTE_ULTRA },
     { file: cavemanRule('rule-megacave.md'), remote: CAVEMAN_REMOTE_MEGACAVE },
 ];
-const HOST_NAME = isPiProcess() ? 'Pi' : 'OMP';
-const RELOAD_MSG = `Reminder: restart ${HOST_NAME} (or reload extensions) for updates to take effect.`;
+// Host-neutral: this updater runs inside pi, OMP, and OpenCode alike.
+const RELOAD_MSG = 'Reminder: restart your agent (or reload extensions) for updates to take effect.';
 // Ponytail is a hoisted dependency, so the installed copy is found by walking up rather than by naming a host directory.
 function ponytailLocal() {
     return findHoistedPackage('@dietrichgebert/ponytail', EXTENSION_DIR, 'package.json');

package/dist/probe-catalog.js

@@ -0,0 +1,48 @@
+// Throwaway: read the real rate cards out of the pi-catalog omp already ships.
+import { readFileSync } from "node:fs";
+const root = process.env.HOME + "/.bun/install/global/node_modules/@oh-my-pi/pi-catalog/src";
+const catalog = JSON.parse(readFileSync(root + "/models.json", "utf8"));
+const wanted = [
+    "space-bunny",
+    "muse-spark-1.3-contributor",
+    "glm-5.3-flash",
+    "qwen38-flash-next",
+    "muse-spark-1.2-contributor",
+    "qwen3.8-27b",
+    "m3",
+    "ox-alpha",
+    "deepseek-v4-flash",
+    "ling-3.0-flash-sante",
+    "qwen3.6-35b-a3b-fp8",
+    "mimo-v2.6-flash",
+    "deepseek-v4.1-flash",
+    "step-5-preview",
+    "ling-3.1-flash",
+    "longcat-2.5-preview",
+];
+let providers = 0;
+let rows = 0;
+const hits = new Map();
+for (const [provider, models] of Object.entries(catalog)) {
+    if (typeof models !== "object" || models === null)
+        continue;
+    providers += 1;
+    for (const [id, row] of Object.entries(models)) {
+        rows += 1;
+        const bare = id.toLowerCase().split("/").pop();
+        if (wanted.includes(bare)) {
+            const list = hits.get(bare) ?? [];
+            list.push({ provider, id, cost: row.cost, status: row.pricingStatus });
+            hits.set(bare, list);
+        }
+    }
+}
+console.log("providers:", providers, "model rows:", rows, "\n");
+for (const w of wanted) {
+    const list = hits.get(w) ?? [];
+    console.log(w.padEnd(26) + (list.length === 0 ? "  — NOT IN CATALOG —" : "  " + list.length + " row(s)"));
+    for (const h of list.slice(0, 4)) {
+        const c = h.cost;
+        console.log("    " + (h.provider + "/" + h.id).padEnd(52) + " in=" + String(c?.input ?? "?") + " out=" + String(c?.output ?? "?") + " status=" + JSON.stringify(h.status));
+    }
+}

package/dist/probe-catalog188.js

@@ -0,0 +1,44 @@
+// Throwaway: the current omp catalog's real rates for the fifteen models in the screenshot.
+import { readFileSync } from "node:fs";
+const root = process.env.HOME + "/.bun/install/global/node_modules/@oh-my-pi/pi-catalog/src";
+const catalog = JSON.parse(readFileSync(root + "/models.json", "utf8"));
+const wanted = [
+    "space-bunny",
+    "muse-spark-1.3-contributor",
+    "glm-5.3-flash",
+    "qwen38-flash-next",
+    "muse-spark-1.2-contributor",
+    "qwen3.8-27b",
+    "m3",
+    "ox-alpha",
+    "deepseek-v4-flash",
+    "ling-3.0-flash-sante",
+    "qwen3.6-35b-a3b-fp8",
+    "mimo-v2.6-flash",
+    "deepseek-v4.1-flash",
+    "step-5-preview",
+    "ling-3.1-flash",
+    "longcat-2.5-preview",
+];
+const hits = new Map();
+for (const [provider, models] of Object.entries(catalog)) {
+    if (!models || typeof models !== "object")
+        continue;
+    for (const [id, row] of Object.entries(models)) {
+        const bare = id.toLowerCase().split("/").pop();
+        if (!wanted.includes(bare))
+            continue;
+        const list = hits.get(bare) ?? [];
+        list.push({ key: provider + "/" + id, cost: row.cost, status: row.pricingStatus });
+        hits.set(bare, list);
+    }
+}
+for (const w of wanted) {
+    const list = hits.get(w) ?? [];
+    console.log("\n" + w.toUpperCase() + (list.length === 0 ? "  -- NOT IN CATALOG --" : "  -- " + list.length + " rows --"));
+    for (const h of list) {
+        const c = h.cost;
+        const zero = c && c.input === 0 && c.output === 0 && c.cacheRead === 0 && c.cacheWrite === 0;
+        console.log("   " + h.key.padEnd(50) + (zero ? "FREE ($0)" : "in=" + c?.input + " out=" + c?.output) + " status=" + JSON.stringify(h.status));
+    }
+}

package/dist/tersio.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // Install Tersio add-ons on any OMP device; see help for commands.
-import { PACKAGE_BIN, PACKAGE_VERSION, applyUpdate, commandArg, dashboard, dashboardExport, dashboardOpen, dashboardPort, doctor, reset, settings, showHelp, showVersion, uninstall, unknownCommand, update, usage, } from './cli/common.js';
+import { PACKAGE_BIN, PACKAGE_VERSION, applyUpdate, commandArg, dashboard, dashboardExport, dashboardOpen, dashboardPort, doctor, reset, settings, showHelp, showVersion, uninstall, unknownCommand, update, usage, currency, } from './cli/common.js';
 import { closeRL } from './cli/interactive.js';
 import { runInstall } from './cli/install.js';
 import { runDoctor } from './cli/doctor.js';
@@ -79,7 +79,7 @@ async function main() {
         return;
     }
     if (dashboard) {
-        await runDashboard({ port: dashboardPort, open: dashboardOpen, exportFile: dashboardExport });
+        await runDashboard({ port: dashboardPort, open: dashboardOpen, exportFile: dashboardExport, currency });
         closeRL();
         return;
     }

package/extensions/{caveman-session → caveman}/index.ts

@@ -13,14 +13,21 @@ const RULE_FILES = { lite: 'rule.md', full: 'rule.md', ultra: 'rule-ultra.md', '
 
 const DEFAULT_MODE = 'off';
 
+// A rule file is immutable for the process, so read each level once; reinstalling needs a restart.
+const instructionCache = new Map<string, string>();
+
 function buildInstruction(mode: string): string {
+  const cached = instructionCache.get(mode);
+  if (cached) return cached;
   const name = RULE_FILES[mode as keyof typeof RULE_FILES] ?? RULE_FILES.full;
   // Fail loud: a wrong rule reads to the model as the real one.
   let body: string;
   try { body = readFileSync(join(CAVERN_DIR, name), 'utf8'); } catch {
-    body = `Caveman ${mode} requested, but ${name} is missing. Run: tersio doctor --fix extensions`;
+    return `Caveman ${mode} requested, but ${name} is missing. Run: tersio doctor --fix extensions`;
   }
-  return `Caveman ${mode} active for this session.\n${body}`;
+  const instruction = `Caveman ${mode} active for this session.\n${body}`;
+  instructionCache.set(mode, instruction);
+  return instruction;
 }
 
 function resolveMode(entries: SessionEntry[] | null | undefined, fallback: string = DEFAULT_MODE): string {
@@ -118,6 +125,6 @@ export default function cavemanSessionExtension(pi: ExtensionApi): void {
     // The previous level's block is replaced, not stacked on.
     const stale = lastInjected;
     lastInjected = instruction;
-    return injectPromptText(pi, event, instruction, stale);
+    return injectPromptText(pi, event, { text: instruction, staleMarker: stale, sectionTag: 'caveman' });
   });
 }

package/extensions/{combo-toggle → combo}/index.ts

@@ -27,7 +27,7 @@ import {
   readRtkDefault,
   saveComboSetup,
 } from '../shared/plugin-settings.ts';
-import { findHoistedPackage, isPiProcess } from '../lib/utils.ts';
+import { findHoistedPackage, isPiProcess } from '../shared/utils.ts';
 import type { ComboState, ExtensionApi, ExtensionCtx, SystemPromptEvent } from '../shared/types.ts';
 
 const EXTENSION_DIR = path.dirname(fileURLToPath(import.meta.url));
@@ -113,7 +113,7 @@ export default function comboToggleExtension(pi: ExtensionApi): void {
   }
 
   pi.registerCommand?.('combo', {
-    description: 'Toggle all 3 OMP add-ons at once. Usage: /combo <off|medium|balanced|max|status>',
+    description: 'Toggle all 3 Tersio modes at once. Usage: /combo <off|medium|balanced|max|status>',
     handler: async (args, ctx) => {
       listen(ctx);
       const arg = String(args || '').trim().toLowerCase();
@@ -197,7 +197,7 @@ export default function comboToggleExtension(pi: ExtensionApi): void {
     // The previous level's block is replaced, not stacked on.
     const stale = lastInjected;
     lastInjected = instruction;
-    return injectPromptText(pi, event, instruction, stale);
+    return injectPromptText(pi, event, { text: instruction, staleMarker: stale, sectionTag: 'ponytail' });
   });
 
   // Slash commands only; natural-language input caused accidental toggles and has no reload context.

package/extensions/{tersio-commands → commands}/index.ts

@@ -9,7 +9,7 @@ import { setExtensionLabel } from '../shared/host.ts';
 import os from 'node:os';
 import path from 'node:path';
 import { appendUsage, readUsage } from '../shared/usage-ledger.ts';
-import { checkAddonsSummary, runAddonUpdate } from '../ai-addons-updater/index.ts';
+import { checkAddonsSummary, runAddonUpdate } from '../updater/index.ts';
 import type { ExtensionApi, ExtensionCtx } from '../shared/types.ts';
 
 const HELP = [

package/extensions/rtk/filter.ts

@@ -0,0 +1,90 @@
+// pi's built-in grep and glob never reach the bash hook; `read` is absent because rtk has no filter for it.
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { resolveRtkBinary } from '../shared/utils.ts';
+import { readRtkDefault } from '../shared/plugin-settings.ts';
+import { getSharedComboState, lastCustomValue, sessionEntries } from '../shared/session-state.ts';
+import type { ExtensionApi, ExtensionCtx, SessionEntry, ToolResultEvent } from '../shared/types.ts';
+
+/** Tool name to `rtk pipe --filter` name. Exported so the OpenCode host reuses one map. */
+export const FILTER_BY_TOOL = new Map([
+  ['grep', 'grep'],
+  ['glob', 'find'],
+  ['find', 'find'],
+]);
+
+/** Below this the rtk spawn costs more than the filter saves. */
+export const MIN_FILTER_BYTES = 1200;
+const FILTER_TIMEOUT_MS = 5000;
+
+/** Absolute, so a minimal PATH in the host cannot break the spawn. */
+const SHELL = '/bin/sh';
+
+export type FilterExec = (
+  cmd: string,
+  args: string[],
+  opts?: { signal?: AbortSignal; cwd?: string; timeout?: number },
+) => Promise<{ stdout: string; code: number }>;
+
+function modeOf(value: unknown): boolean | null {
+  if (value === true) return true;
+  if (value === false) return false;
+  return null;
+}
+
+/** True when rtk is on for the session: a persisted entry wins, then a live switch, then the configured default. */
+export function rtkActive(entries: SessionEntry[] | null | undefined): boolean {
+  const persisted = lastCustomValue(entries, 'rtk-mode', (data) => modeOf(data?.enabled));
+  if (persisted !== null) return persisted;
+  return getSharedComboState().rtk === 'on' || readRtkDefault();
+}
+
+/** The text in a result's content parts, or null when the parts are not plain text. */
+export function filterableText(parts: unknown): string | null {
+  if (!Array.isArray(parts) || parts.length === 0) return null;
+  // An image or a mixed result is not text to filter.
+  if (parts.some((part) => (part as { type?: unknown } | null)?.type !== 'text')) return null;
+  return parts.map((part) => (part as { text?: unknown } | null)?.text ?? '').join('\n');
+}
+
+/** Pipe text through one rtk filter; null on any failure, so the caller keeps its original. */
+export async function filterThroughRtk(
+  exec: FilterExec,
+  request: { bin: string; filter: string; text: string; signal?: AbortSignal },
+): Promise<string | null> {
+  const { bin, filter, text, signal } = request;
+  let dir: string | undefined;
+  try {
+    dir = mkdtempSync(join(tmpdir(), 'tersio-rtk-'));
+    const file = join(dir, 'in.txt');
+    writeFileSync(file, text, 'utf8');
+    // `rtk pipe` reads stdin only and execFile has no stdin, so one redirect.
+    const result = await exec(SHELL, ['-c', `"${bin}" pipe -f ${filter} < "${file}"`], { signal, timeout: FILTER_TIMEOUT_MS });
+    if (result.code !== 0) return null;
+    const out = result.stdout;
+    if (!out.trim() || out.length >= text.length) return null;
+    return out;
+  } catch {
+    return null;
+  } finally {
+    if (dir) rmSync(dir, { recursive: true, force: true });
+  }
+}
+
+export default function rtkFilterExtension(pi: ExtensionApi): void {
+  const bin = resolveRtkBinary();
+  const exec = pi.exec;
+  if (!bin || !exec) return;
+  pi.on<ToolResultEvent>('tool_result', async (event, ctx: ExtensionCtx) => {
+    const filter = FILTER_BY_TOOL.get(String(event?.toolName ?? '').toLowerCase());
+    if (!filter || event?.isError) return;
+    const text = filterableText(event?.content);
+    if (text === null || text.length < MIN_FILTER_BYTES) return;
+    if (!rtkActive(sessionEntries(ctx))) return;
+    const filtered = await filterThroughRtk(exec, { bin, filter, text, signal: ctx?.signal });
+    if (!filtered) return;
+    // Built-in grep and glob declare no output schema, so no structuredContent is lost.
+    return { content: [{ type: 'text', text: filtered }] };
+  });
+}

package/extensions/{rtk-session/index.ts → rtk/session.ts}

@@ -1,7 +1,7 @@
 import { getSharedComboState, hasModeState, isOmpSubagentPrompt, lastCustomValue, reconcileSharedComboEntries, sessionEntries, setSharedComboListener, setSharedComboMode, systemPromptIncludes } from '../shared/session-state.ts';
 import { injectPromptText, onHostEvent, setExtensionLabel, stringArrayToolParams } from '../shared/host.ts';
 import { readRtkDefault } from '../shared/plugin-settings.ts';
-import { resolveRtkBinary } from '../lib/utils.ts';
+import { resolveRtkBinary } from '../shared/utils.ts';
 import { announceStatus } from '../shared/status.ts';
 import type { ExtensionApi, ExtensionCtx, SessionEntry, SystemPromptEvent } from '../shared/types.ts';
 
@@ -23,7 +23,8 @@ function setRtkProcessEnabled(enabled: boolean): void {
   else process.env.RTK_DISABLED = '1';
 }
 
-const RTK_PROMPT = `RTK guidance active. RTK automatically rewrites eligible Bash calls through the installed rtk hook. Prefer rtk for noisy shell output, but use exact raw output for state changes, checksums, patches, and diagnostics that need full bytes.`;
+// rtk's awareness contract: state the output contract, never tell the model to type `rtk`.
+const RTK_PROMPT = `RTK guidance active. Bash output, and large grep and glob results, are condensed to save tokens: every signal kept, costly noise dropped. Treat a condensed result as complete. Re-run something unfiltered only when its result is empty, garbled, or contradicts its exit code.`;
 
 export default function rtkSessionExtension(pi: ExtensionApi): void {
   let enabled = DEFAULT_ENABLED;
@@ -134,6 +135,6 @@ export default function rtkSessionExtension(pi: ExtensionApi): void {
     if (!active) return;
     // Skip when already present, so a host that re-presents the prompt cannot stack it.
     if (systemPromptIncludes(event.systemPrompt, RTK_PROMPT)) return;
-    return injectPromptText(pi, event, RTK_PROMPT);
+    return injectPromptText(pi, event, { text: RTK_PROMPT, sectionTag: 'rtk' });
   });
 }