@krtclcdy/tersio 2.25.3 → 2.25.4

package/README.md

@@ -39,7 +39,7 @@ opencode plugin add @krtclcdy/tersio
 
 Pick one install method per host, not both. Using both registers every command twice.
 
-All hosts load the same five extensions from the same sources and read their session-start defaults from `~/.tersio/settings.json`. All five load always.
+All hosts load the same six extensions from the same sources and read their session-start defaults from `~/.tersio/settings.json`. All six load always.
 
 One-off use without installing:
 
@@ -155,7 +155,7 @@ Per host, written by `tersio install --host <omp|pi|opencode>`:
 | Host | Extensions | Ponytail |
 |---|---|---|
 | Oh My Pi | `~/.omp/agent/extensions/{caveman-session,rtk-session,combo-toggle,tersio-commands,ai-addons-updater}/` | nested plugin dependency under `~/.omp/plugins/node_modules/`, one Plugins row |
-| pi | `~/.pi/agent/extensions/{caveman-session,rtk-session,combo-toggle,tersio-commands,ai-addons-updater}/` — pi auto-discovers `<agent-dir>/extensions`, so there is nothing to register | `npm:@dietrichgebert/ponytail`, installed as a pi package |
+| pi | `~/.pi/agent/extensions/{caveman-session,rtk-session,rtk-filter,combo-toggle,tersio-commands,ai-addons-updater}/` — pi auto-discovers `<agent-dir>/extensions`, so there is nothing to register | `npm:@dietrichgebert/ponytail`, installed as a pi package |
 | OpenCode | `~/.config/opencode/plugins/tersio/` — registered in `opencode.json` plugins, so there is nothing else to register | bundled with Tersio; no separate package |
 
 All three hosts carry the same `shared/` and `lib/` modules and the same mode extensions from the same sources.

package/dist/cli/doctor-fix.js

@@ -146,7 +146,7 @@ async function fixRtk(binDir) {
     console.log('  Doctor --fix: repairing RTK binary + wiring');
     const binDest = path.join(binDir, RTK_BINARY_NAME);
     if (dryRun) {
-        sayTagged(`  [dry-run] would download a checksum-verified rtk to ${binDest} and wire it into OMP`);
+        sayTagged(`  [dry-run] would download a checksum-verified rtk to ${binDest} and wire it into the installed hosts`);
         return;
     }
     const spec = rtkPlatformSpec();

package/dist/cli/doctor.js

@@ -252,7 +252,7 @@ async function runDoctorFix(tally) {
     console.log('\n  Doctor --fix: repairs done — rechecking.');
     const again = await runDoctor(true);
     if (again.missing + again.warn === 0)
-        console.log('  Doctor --fix: all checks pass. Restart OMP.');
+        console.log('  Doctor --fix: all checks pass. Restart your agent.');
     else
         console.log(`  Doctor --fix: still ${again.missing} missing + ${again.warn} warn — rerun or repair manually.`);
 }

package/dist/cli/install.js

@@ -356,6 +356,12 @@ async function stepRtkSession(extDir, options) {
         console.log('  RTK session — install session mode');
     await copySources(extDir, filesUnder('rtk-session'), 'rtk-session/index.ts', options);
 }
+// pi's built-in grep and glob never reach the bash hook, so this one filters their output.
+async function stepRtkFilter(extDir, options) {
+    if (!options.quiet)
+        console.log('  RTK filter — install built-in tool output filtering');
+    await copySources(extDir, filesUnder('rtk-filter'), 'rtk-filter/index.ts', options);
+}
 // rule.md ships with the package; the other bodies track upstream skills.
 // rule.md is a deliberate fork of upstream skills/caveman/SKILL.md; a blind sync would drop the mode switch line and the STE100 rules.
 const CAVEMAN_RULES = [
@@ -452,6 +458,7 @@ async function stepOpencode(options) {
         console.log(`  OpenCode — write the plugin tree (${dir})`);
     await stepSharedSessionState(dir, options);
     await copySources(dir, filesUnder('rtk-session'), 'rtk-session/index.ts', options);
+    await stepRtkFilter(dir, options);
     await copySources(dir, filesUnder('caveman-session'), 'caveman-session/index.ts', options);
     await stepCombo(dir, options);
     await copySources(dir, filesUnder('tersio-commands'), 'tersio-commands/index.ts', options);
@@ -661,6 +668,7 @@ async function stepPiLayer(options) {
     await stepSharedSessionState(extDir, options);
     // OMP loads rtk-session from its plugin manifest, so only the pi tree copies it.
     await copySources(extDir, filesUnder('rtk-session'), 'rtk-session/index.ts', options);
+    await stepRtkFilter(extDir, options);
     await stepCaveman(extDir, options);
     await stepCombo(extDir, options);
     await stepTersioCommands(extDir, options);
@@ -700,14 +708,30 @@ async function stepPonytailForPi(agentDir, options) {
     }
     if (options.dryRun)
         return;
+    // Only when pi still declares the npm spec: with nothing to remove, `pi remove` still
+    // shells out to npm, which warns on stderr and exits non-zero.
+    const declared = await piDeclaredPackages(agentDir);
+    if (declared.some(isNpmPonytailPackage)) {
+        try {
+            await execNetwork('Removing the pi npm copy of Ponytail', 'pi', ['remove', 'npm:@dietrichgebert/ponytail'], { timeout: 120000 });
+        }
+        catch (e) {
+            sayTagged(`  [warn] pi remove ponytail: ${shortError(e)}`);
+        }
+    }
+    await registerPiLocalPonytail(agentDir, dest, options);
+}
+// pi declares its package sources in settings.json; [] when the file is absent or unreadable.
+async function piDeclaredPackages(agentDir) {
     try {
-        await execNetwork('Removing the pi npm copy of Ponytail', 'pi', ['remove', 'npm:@dietrichgebert/ponytail'], { timeout: 120000 });
+        const settings = JSON.parse(await fs.readFile(path.join(agentDir, 'settings.json'), 'utf8'));
+        return Array.isArray(settings.packages) ? settings.packages : [];
     }
-    catch (e) {
-        sayTagged(`  [warn] pi remove ponytail: ${shortError(e)}`);
+    catch {
+        return [];
     }
-    await registerPiLocalPonytail(agentDir, dest, options);
 }
+const isNpmPonytailPackage = (value) => typeof value === 'string' && value.startsWith('npm:@dietrichgebert/ponytail');
 // pi lists package sources in settings; swap the npm spec for the local dir.
 async function registerPiLocalPonytail(agentDir, dest, options) {
     const settingsPath = path.join(agentDir, 'settings.json');
@@ -719,7 +743,7 @@ async function registerPiLocalPonytail(agentDir, dest, options) {
         return;
     }
     const packages = (Array.isArray(settings.packages) ? settings.packages : []);
-    const kept = packages.filter((p) => typeof p !== 'string' || !p.startsWith('npm:@dietrichgebert/ponytail'));
+    const kept = packages.filter((p) => !isNpmPonytailPackage(p));
     if (!kept.includes(dest))
         kept.push(dest);
     settings.packages = kept;
@@ -727,6 +751,10 @@ async function registerPiLocalPonytail(agentDir, dest, options) {
     if (!options.quiet)
         sayTagged(`  [write] pi package source → ${dest}`);
 }
+// Name the preset this run actually chose, instead of a hardcoded level.
+function comboHint(host, comboDefault) {
+    return comboDefault === 'off' ? `\nDone — restart ${host}.` : `\nDone — restart ${host}, then /combo ${comboDefault}.`;
+}
 async function runInstall() {
     // Without this guard a picked command re-enters here with command === null and loops straight back into the picker.
     if (command === null && tty() && !yes && !updatePromptDone) {
@@ -830,7 +858,7 @@ async function runInstall() {
         if (failures.length > 0)
             console.log(`\nDone with ${failures.length} failure(s) — see [fail] lines above.`);
         else
-            console.log('\nDone — restart OpenCode, then /combo balanced.');
+            console.log(comboHint('OpenCode', profile.comboDefault));
         closeRL();
         return;
     }
@@ -841,7 +869,7 @@ async function runInstall() {
         if (failures.length > 0)
             console.log(`\nDone with ${failures.length} failure(s) — see [fail] lines above.`);
         else
-            console.log('\nDone — restart pi, then /combo medium.');
+            console.log(comboHint('pi', profile.comboDefault));
         closeRL();
         return;
     }
@@ -851,6 +879,7 @@ async function runInstall() {
     await capture('ponytail', () => stepPonytail(OMP_PLUGINS_DIR, installOptions));
     await capture('rtk', () => stepRtk(BUN_BIN_DIR, installOptions));
     await capture('rtk session', () => stepRtkSession(userExtDir, installOptions));
+    await capture('rtk filter', () => stepRtkFilter(userExtDir, installOptions));
     await capture('caveman', () => stepCaveman(path.join(OMP_PLUGINS_DIR, 'node_modules', '@krtclcdy', 'tersio', 'extensions'), installOptions));
     await capture('combo', () => stepCombo(userExtDir, installOptions));
     await capture('commands', () => stepTersioCommands(userExtDir, installOptions));
@@ -862,7 +891,7 @@ async function runInstall() {
             console.log(`  add-ons: ${failures.length} failed (${failures.join(', ')}) — see [fail] lines above`);
     }
     else {
-        console.log(failures.length === 0 ? '\nDone — restart OMP, then /combo medium.' : `\nDone with ${failures.length} failure(s) — see [fail] lines above.`);
+        console.log(failures.length === 0 ? comboHint('OMP', profile.comboDefault) : `\nDone with ${failures.length} failure(s) — see [fail] lines above.`);
     }
     closeRL();
 }

package/dist/cli/manifest.js

@@ -24,6 +24,7 @@ export const TREE_FILES = [
     'caveman-session/rule-ultra.md',
     'caveman-session/rule-megacave.md',
     'rtk-session/index.ts',
+    'rtk-filter/index.ts',
     'combo-toggle/index.ts',
     'tersio-commands/index.ts',
     'ai-addons-updater/index.ts',

package/dist/extensions/ai-addons-updater/index.js

@@ -6,7 +6,7 @@ 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 '../lib/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';
@@ -18,8 +18,8 @@ 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/extensions/caveman-session/index.js

@@ -9,7 +9,12 @@ const CAVERN_DIR = dirname(fileURLToPath(import.meta.url));
 // Upstream ships one skill per register: default, ultracave, megacave.
 const RULE_FILES = { lite: 'rule.md', full: 'rule.md', ultra: 'rule-ultra.md', 'megacave-lite': 'rule-megacave.md', 'megacave-full': 'rule-megacave.md', 'megacave-ultra': 'rule-megacave.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();
 function buildInstruction(mode) {
+    const cached = instructionCache.get(mode);
+    if (cached)
+        return cached;
     const name = RULE_FILES[mode] ?? RULE_FILES.full;
     // Fail loud: a wrong rule reads to the model as the real one.
     let body;
@@ -17,9 +22,11 @@ function buildInstruction(mode) {
         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, fallback = DEFAULT_MODE) {
     return lastCustomValue(entries, 'caveman-mode', (data) => normalizeMode('caveman', data?.mode)) ?? fallback;
@@ -110,6 +117,6 @@ export default function cavemanSessionExtension(pi) {
         // 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/dist/extensions/combo-toggle/index.js

@@ -92,7 +92,7 @@ export default function comboToggleExtension(pi) {
             reconcile(ctx, resetEmpty);
     }
     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();
@@ -169,7 +169,7 @@ export default function comboToggleExtension(pi) {
         // 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/dist/extensions/opencode/server.js

@@ -2,6 +2,7 @@
 import { execFile } from 'node:child_process';
 import cavemanSessionExtension from '../caveman-session/index.js';
 import rtkSessionExtension from '../rtk-session/index.js';
+import rtkFilterExtension, { FILTER_BY_TOOL, MIN_FILTER_BYTES, filterThroughRtk, filterableText, rtkActive } from '../rtk-filter/index.js';
 import comboToggleExtension from '../combo-toggle/index.js';
 import tersioCommandsExtension from '../tersio-commands/index.js';
 import { getSharedComboState } from '../shared/session-state.js';
@@ -35,6 +36,7 @@ const plugin = {
             return list;
         };
         const persist = (sid) => {
+            // SAFETY: the storage API is generic over its payload; the value round-trips unchanged.
             void ctx.storage.set(`entries:${sid}`, sessionEntriesOf(sid)).catch(() => { });
         };
         const stubCtx = (sid) => ({
@@ -110,7 +112,7 @@ const plugin = {
                 lifecycle.set(event, list);
             },
         };
-        for (const extension of [cavemanSessionExtension, rtkSessionExtension, comboToggleExtension, tersioCommandsExtension])
+        for (const extension of [cavemanSessionExtension, rtkSessionExtension, rtkFilterExtension, comboToggleExtension, tersioCommandsExtension])
             extension(host);
         // The first hook of an unseen session runs its session_start handlers.
         const sidOf = (value) => typeof value === 'string' && value ? value : undefined;
@@ -200,8 +202,50 @@ const plugin = {
             if (rewritten)
                 input.command = rewritten;
         });
+        // Built-in grep and glob output never reaches the bash hook; mutate result.content in place.
+        try {
+            await ctx.tool.hook('execute.after', async (event) => {
+                const hook = event;
+                if (hook.status !== 'completed')
+                    return;
+                const filter = FILTER_BY_TOOL.get(String(hook.tool ?? '').toLowerCase());
+                if (!filter || !hook.result)
+                    return;
+                const text = filterableText(hook.result.content);
+                if (text === null || text.length < MIN_FILTER_BYTES)
+                    return;
+                // Read the mode from the payload's own session, not the last one to run a start hook.
+                const sid = typeof hook.sessionID === 'string' ? hook.sessionID : activeSid;
+                if (sid !== undefined)
+                    await ensureSession(sid);
+                if (!rtkActive(sid === undefined ? undefined : sessionEntriesOf(sid)))
+                    return;
+                const bin = resolveRtkBinary();
+                if (!bin)
+                    return;
+                const filtered = await filterThroughRtk(execRtk, { bin, filter, text });
+                if (filtered)
+                    hook.result.content = [{ type: 'text', text: filtered }];
+            });
+        }
+        catch {
+            // Hosts without the after-hook keep the unfiltered result.
+        }
     },
 };
+/** execFile with the promise shape `filterThroughRtk` expects. */
+function execRtk(cmd, args, opts) {
+    return new Promise((resolve) => {
+        execFile(cmd, args, { signal: opts?.signal, timeout: opts?.timeout }, (error, stdout) => {
+            const out = stdout ?? '';
+            if (!error)
+                return resolve({ stdout: out, code: 0 });
+            // A non-numeric code is a spawn failure (ENOENT, EACCES, killed) and must not read as success.
+            const raw = error.code;
+            resolve({ stdout: out, code: typeof raw === 'number' ? raw : 1 });
+        });
+    });
+}
 function rewriteCommand(command) {
     const bin = resolveRtkBinary();
     if (!bin)

package/dist/extensions/rtk-filter/index.js

@@ -0,0 +1,87 @@
+// 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 '../lib/utils.js';
+import { readRtkDefault } from '../shared/plugin-settings.js';
+import { getSharedComboState, lastCustomValue, sessionEntries } from '../shared/session-state.js';
+/** 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';
+function modeOf(value) {
+    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) {
+    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) {
+    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?.type !== 'text'))
+        return null;
+    return parts.map((part) => part?.text ?? '').join('\n');
+}
+/** Pipe text through one rtk filter; null on any failure, so the caller keeps its original. */
+export async function filterThroughRtk(exec, request) {
+    const { bin, filter, text, signal } = request;
+    let dir;
+    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) {
+    const bin = resolveRtkBinary();
+    const exec = pi.exec;
+    if (!bin || !exec)
+        return;
+    pi.on('tool_result', async (event, ctx) => {
+        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/dist/extensions/rtk-session/index.js

@@ -22,7 +22,8 @@ function setRtkProcessEnabled(enabled) {
     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) {
     let enabled = DEFAULT_ENABLED;
     function fail(text) {
@@ -125,6 +126,6 @@ export default function rtkSessionExtension(pi) {
         // 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' });
     });
 }

package/dist/extensions/shared/host.js

@@ -16,15 +16,21 @@ const piAdapter = {
             return undefined;
         return options[shown.indexOf(picked)]?.label ?? picked;
     },
-    inject(event, text, staleMarker) {
-        const marker = staleMarker?.replace(/^[^\w]+/, '').trim();
+    inject(event, block) {
+        const marker = block.staleMarker?.replace(/^[^\w]+/, '').trim();
         const dropStale = (parts) => (marker ? parts.filter((part) => !part.includes(marker)) : parts);
         const options = event.systemPromptOptions;
+        // A named section is replaced in place; returning systemPrompt replaces the whole prompt.
+        const sections = options?.sections;
+        if (block.sectionTag && sections && typeof sections === 'object') {
+            sections[block.sectionTag] = block.text;
+            return undefined;
+        }
         if (options && typeof options.appendSystemPrompt === 'string') {
-            options.appendSystemPrompt = dropStale([options.appendSystemPrompt]).concat(text).filter(Boolean).join('\n\n');
+            options.appendSystemPrompt = dropStale([options.appendSystemPrompt]).concat(block.text).filter(Boolean).join('\n\n');
             return undefined;
         }
-        return { systemPrompt: `${dropStale(asPromptArray(event.systemPrompt)).join('\n\n')}\n\n${text}` };
+        return { systemPrompt: `${dropStale(asPromptArray(event.systemPrompt)).join('\n\n')}\n\n${block.text}` };
     },
     stringArray(_pi, name, spec) {
         const array = { type: 'array', items: { type: 'string' } };
@@ -43,10 +49,10 @@ const ompAdapter = {
             return undefined;
         return ui.select(title, options, dialogOptions);
     },
-    inject(event, text, staleMarker) {
-        const marker = staleMarker?.replace(/^[^\w]+/, '').trim();
+    inject(event, block) {
+        const marker = block.staleMarker?.replace(/^[^\w]+/, '').trim();
         const dropStale = (parts) => (marker ? parts.filter((part) => !part.includes(marker)) : parts);
-        return { systemPrompt: [...dropStale(asPromptArray(event.systemPrompt)), text] };
+        return { systemPrompt: [...dropStale(asPromptArray(event.systemPrompt)), block.text] };
     },
     stringArray(pi, name, spec) {
         const { z } = pi.zod;
@@ -63,10 +69,10 @@ const opencodeAdapter = {
             return undefined;
         return ui.select(title, options, dialogOptions);
     },
-    inject(event, text, staleMarker) {
-        const marker = staleMarker?.replace(/^[^\w]+/, '').trim();
+    inject(event, block) {
+        const marker = block.staleMarker?.replace(/^[^\w]+/, '').trim();
         const dropStale = (parts) => (marker ? parts.filter((part) => !part.includes(marker)) : parts);
-        return { systemPrompt: [...dropStale(asPromptArray(event.systemPrompt)), text] };
+        return { systemPrompt: [...dropStale(asPromptArray(event.systemPrompt)), block.text] };
     },
     stringArray(_pi, name, spec) {
         const array = { type: 'array', items: { type: 'string' } };
@@ -99,8 +105,8 @@ export function onHostEvent(pi, event, handler) {
 export async function hostSelect(pi, ui, title, options, dialogOptions) {
     return adapterFor(pi).select(ui, title, options, dialogOptions);
 }
-export function injectPromptText(pi, event, text, staleMarker) {
-    return adapterFor(pi).inject(event, text, staleMarker);
+export function injectPromptText(pi, event, block) {
+    return adapterFor(pi).inject(event, block);
 }
 export function stringArrayToolParams(pi, name, spec = {}) {
     return adapterFor(pi).stringArray(pi, name, spec);

package/dist/extensions/shared/session-state.js

@@ -76,7 +76,9 @@ export function normalizeInputCommand(value) {
     return String(value || '').trim().toLowerCase().replace(/[.!?\s]+$/, '');
 }
 export function asPromptArray(systemPrompt) {
-    return Array.isArray(systemPrompt) ? systemPrompt : [systemPrompt];
+    const parts = Array.isArray(systemPrompt) ? systemPrompt : [systemPrompt];
+    // OMP can hand back a hole in the array; a non-string breaks every marker check.
+    return parts.filter((part) => typeof part === 'string');
 }
 export function systemPromptIncludes(systemPrompt, marker) {
     return asPromptArray(systemPrompt).some((prompt) => typeof prompt === 'string' && prompt.includes(marker));

package/extensions/ai-addons-updater/index.ts

@@ -18,7 +18,6 @@ import {
   findHoistedPackage,
   httpsGet,
   httpsDownload,
-  isPiProcess,
   sha256Hex,
   parseChecksum,
   normalizeRtkVersion,
@@ -39,8 +38,8 @@ const CAVEMAN_TRACKED: ReadonlyArray<{ file: string; remote: string }> = [
   { 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(): string | null {

package/extensions/caveman-session/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/index.ts

@@ -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/opencode/server.ts

@@ -3,6 +3,7 @@ import { execFile } from 'node:child_process';
 import type { Plugin } from '@opencode/plugin';
 import cavemanSessionExtension from '../caveman-session/index.ts';
 import rtkSessionExtension from '../rtk-session/index.ts';
+import rtkFilterExtension, { FILTER_BY_TOOL, MIN_FILTER_BYTES, filterThroughRtk, filterableText, rtkActive } from '../rtk-filter/index.ts';
 import comboToggleExtension from '../combo-toggle/index.ts';
 import tersioCommandsExtension from '../tersio-commands/index.ts';
 import { getSharedComboState } from '../shared/session-state.ts';
@@ -54,6 +55,7 @@ const plugin: Plugin.Plugin = {
       return list;
     };
     const persist = (sid: string): void => {
+      // SAFETY: the storage API is generic over its payload; the value round-trips unchanged.
       void ctx.storage.set(`entries:${sid}`, sessionEntriesOf(sid) as unknown as never).catch(() => {});
     };
     const stubCtx = (sid?: string): ExtensionCtx => ({
@@ -120,7 +122,7 @@ const plugin: Plugin.Plugin = {
       },
     };
 
-    for (const extension of [cavemanSessionExtension, rtkSessionExtension, comboToggleExtension, tersioCommandsExtension]) extension(host);
+    for (const extension of [cavemanSessionExtension, rtkSessionExtension, rtkFilterExtension, comboToggleExtension, tersioCommandsExtension]) extension(host);
 
     // The first hook of an unseen session runs its session_start handlers.
     const sidOf = (value: unknown): string | undefined =>
@@ -206,9 +208,44 @@ const plugin: Plugin.Plugin = {
       const rewritten = await rewriteCommand(input.command);
       if (rewritten) input.command = rewritten;
     });
+
+    // Built-in grep and glob output never reaches the bash hook; mutate result.content in place.
+    try {
+      await ctx.tool.hook('execute.after', async (event) => {
+        const hook = event as { tool?: unknown; status?: unknown; sessionID?: unknown; result?: { content?: unknown } };
+        if (hook.status !== 'completed') return;
+        const filter = FILTER_BY_TOOL.get(String(hook.tool ?? '').toLowerCase());
+        if (!filter || !hook.result) return;
+        const text = filterableText(hook.result.content);
+        if (text === null || text.length < MIN_FILTER_BYTES) return;
+        // Read the mode from the payload's own session, not the last one to run a start hook.
+        const sid = typeof hook.sessionID === 'string' ? hook.sessionID : activeSid;
+        if (sid !== undefined) await ensureSession(sid);
+        if (!rtkActive(sid === undefined ? undefined : sessionEntriesOf(sid))) return;
+        const bin = resolveRtkBinary();
+        if (!bin) return;
+        const filtered = await filterThroughRtk(execRtk, { bin, filter, text });
+        if (filtered) hook.result.content = [{ type: 'text', text: filtered }];
+      });
+    } catch {
+      // Hosts without the after-hook keep the unfiltered result.
+    }
   },
 };
 
+/** execFile with the promise shape `filterThroughRtk` expects. */
+function execRtk(cmd: string, args: string[], opts?: { signal?: AbortSignal; timeout?: number }): Promise<{ stdout: string; code: number }> {
+  return new Promise((resolve) => {
+    execFile(cmd, args, { signal: opts?.signal, timeout: opts?.timeout }, (error, stdout) => {
+      const out = stdout ?? '';
+      if (!error) return resolve({ stdout: out, code: 0 });
+      // A non-numeric code is a spawn failure (ENOENT, EACCES, killed) and must not read as success.
+      const raw = (error as { code?: unknown }).code;
+      resolve({ stdout: out, code: typeof raw === 'number' ? raw : 1 });
+    });
+  });
+}
+
 function rewriteCommand(command: string): Promise<string | null> {
   const bin = resolveRtkBinary();
   if (!bin) return Promise.resolve(null);