@krtclcdy/tersio 2.24.1 → 2.25.1

package/extensions/combo-toggle/index.js

@@ -8,11 +8,13 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     return path;
 };
 import path from 'node:path';
+import { existsSync } from 'node:fs';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { activeModesSummary, COMBO_LEVELS, getSharedComboState, isComboPresetActive, normalizeComboLevel, paintableCtx, reconcileSharedComboEntries, sessionEntries, setSharedComboLevel, statusUi, setSharedComboListener, setSharedComboMode, systemPromptIncludes, themeStatus, } from '../shared/session-state.js';
+import { activeModesSummary, COMBO_LEVELS, getSharedComboState, hasModeState, normalizeComboLevel, reconcileSharedComboEntries, sessionEntries, setSharedComboLevel, setSharedComboListener, setSharedComboMode, systemPromptIncludes, } from '../shared/session-state.js';
 import { hostSelect, injectPromptText, onHostEvent, setExtensionLabel } from '../shared/host.js';
+import { announceStatus } from '../shared/status.js';
 import { isComboSetupComplete, readComboDefault, readPonytailDefault, saveComboSetup, } from '../shared/plugin-settings.js';
-import { findHoistedPackage } from '../lib/utils.js';
+import { findHoistedPackage, isPiProcess } from '../lib/utils.js';
 const EXTENSION_DIR = path.dirname(fileURLToPath(import.meta.url));
 const PONYTAIL_FALLBACK_INTENSITY = {
     lite: 'Prefer the simplest correct solution.',
@@ -22,16 +24,15 @@ export function ponytailFallback(mode) {
     const intensity = PONYTAIL_FALLBACK_INTENSITY[mode] ?? 'Use the minimum correct solution. Delete or reuse before adding.';
     return `🦥 PONYTAIL MODE ACTIVE — level: ${mode}\n${intensity} Understand the path first and fix root causes, not symptoms. Prefer the standard library and YAGNI. Avoid speculative abstractions and dependencies. Preserve correctness. Verify changed behavior.`;
 }
-function levelSummary(state) {
-    return `caveman=${state.caveman} rtk=${state.rtk} ponytail=${state.ponytail}`;
-}
-// Ponytail is hoisted, so one upward walk covers every install layout. The hook
-// is CommonJS, so both namespace shapes are tried.
+// Ponytail is hoisted, so one upward walk covers every install layout. The hook is CommonJS, so both namespace shapes are tried.
 async function loadPonytailInstructions(mode) {
     const installed = findHoistedPackage('@dietrichgebert/ponytail', EXTENSION_DIR, 'hooks', 'ponytail-instructions.js');
-    if (installed) {
+    // The OpenCode tree ships no node_modules; the installer bundles the ruleset beside the extensions.
+    const bundled = path.join(EXTENSION_DIR, '..', 'ponytail-bundle', 'hooks', 'ponytail-instructions.js');
+    const treeLocal = installed ?? (existsSync(bundled) ? bundled : null);
+    if (treeLocal) {
         try {
-            const loaded = await import(__rewriteRelativeImportExtension(pathToFileURL(installed).href));
+            const loaded = await import(__rewriteRelativeImportExtension(pathToFileURL(treeLocal).href));
             const build = loaded.getPonytailInstructions ?? loaded.default?.getPonytailInstructions;
             if (build)
                 return build(mode);
@@ -42,30 +43,8 @@ async function loadPonytailInstructions(mode) {
 }
 export default function comboToggleExtension(pi) {
     setExtensionLabel(pi, 'Combo session toggle (all 3 add-ons)');
-    let lastCtx = undefined;
     let setupPrompted = false;
-    function syncStatus(ctx) {
-        lastCtx = paintableCtx(lastCtx, ctx);
-        const ui = statusUi(lastCtx);
-        if (!ui)
-            return;
-        // One unified bar replaces the per-extension bars while a preset is active.
-        if (!isComboPresetActive()) {
-            ui.setStatus('combo', undefined);
-            return;
-        }
-        // Read the live bridge, not a cache: siblings reconcile it first.
-        const state = getSharedComboState();
-        const c0 = state.caveman.toUpperCase();
-        const r = state.rtk.toUpperCase();
-        const p = state.ponytail.toUpperCase();
-        const lvl = state.level.toUpperCase();
-        ui.setStatus('combo', themeStatus(ui, '🧩', `combo ${lvl}: 🪨caveman=${c0} ⚡rtk=${r} 🦥ponytail=${p}`, true));
-        // Our bar is canonical for the preset, so clear any sibling bar.
-        ui.setStatus('caveman', undefined);
-        ui.setStatus('rtk', undefined);
-        ui.setStatus('ponytail', undefined);
-    }
+    let lastInjected = undefined;
     // Siblings restore from these entries, so the fallback must write them too.
     function persistPreset(level) {
         const modes = COMBO_LEVELS[level];
@@ -74,18 +53,15 @@ export default function comboToggleExtension(pi) {
         pi.appendEntry?.('ponytail-mode', { mode: modes.ponytail });
         pi.appendEntry?.('combo-level', { level });
     }
-    function useState(state, ctx) {
-        syncStatus(ctx);
-        return state;
-    }
     function reconcile(ctx) {
         if (!ctx?.hasUI)
             return getSharedComboState();
-        return useState(reconcileSharedComboEntries(sessionEntries(ctx)), ctx);
+        return reconcileSharedComboEntries(sessionEntries(ctx));
     }
     function listen(ctx) {
-        if (ctx?.hasUI)
-            setSharedComboListener('combo', useState);
+        if (!ctx?.hasUI)
+            return;
+        setSharedComboListener('combo', (state) => { announceStatus(ctx); return state; });
     }
     function track(ctx) {
         listen(ctx);
@@ -98,8 +74,8 @@ export default function comboToggleExtension(pi) {
             listen(ctx);
             const arg = String(args || '').trim().toLowerCase();
             if (!arg || arg === 'status') {
-                const state = reconcile(ctx);
-                ctx?.ui?.notify?.(`Combo: ${state.level === 'custom' ? 'INACTIVE' : state.level.toUpperCase()} (${levelSummary(state)})`, 'info');
+                reconcile(ctx);
+                announceStatus(ctx);
                 return;
             }
             if (arg === 'help') {
@@ -115,9 +91,8 @@ export default function comboToggleExtension(pi) {
                 return;
             }
             persistPreset(level);
-            useState(setSharedComboLevel(level), ctx);
-            const active = activeModesSummary(getSharedComboState());
-            ctx?.ui?.notify?.(level === 'off' ? `Combo off — all tersio modes inactive for this session. Active: ${active}.` : `Combo ${level} on — ${active} active for this session.`, 'info');
+            setSharedComboLevel(level);
+            announceStatus(ctx);
         },
     });
     async function runFirstRunSetup(ctx) {
@@ -133,40 +108,39 @@ export default function comboToggleExtension(pi) {
         const level = choice || 'off';
         if (saveComboSetup(level) && level !== 'off') {
             persistPreset(level);
-            useState(setSharedComboLevel(level), ctx);
+            setSharedComboLevel(level);
             ctx.ui.notify?.(`Combo default saved: ${level} — ${activeModesSummary(getSharedComboState())} will activate on fresh sessions.`, 'info');
         }
     }
     pi.on('session_start', async (_event, ctx) => {
         track(ctx);
-        if (!ctx?.hasUI)
-            syncStatus(ctx);
         await runFirstRunSetup(ctx);
         // The configured default applies only when no persisted mode state exists.
         const entries = sessionEntries(ctx);
-        const hasModeState = entries.some((e) => e?.type === 'custom' && (e.customType === 'combo-level' || e.customType === 'caveman-mode' ||
-            e.customType === 'rtk-mode' || e.customType === 'ponytail-mode'));
-        if (getSharedComboState().level === 'off' && !hasModeState) {
+        const persisted = hasModeState(entries);
+        if (getSharedComboState().level === 'off' && !persisted) {
             const fallback = readComboDefault();
             if (fallback !== 'off') {
                 persistPreset(fallback);
-                useState(setSharedComboLevel(fallback), ctx);
-                ctx?.ui?.notify?.(`Combo default applied: ${fallback} — ${activeModesSummary(getSharedComboState())} active for this session.`, 'info');
+                setSharedComboLevel(fallback);
             }
         }
-        // No sibling restores a standalone ponytail default, so apply it here; skip
-        // it when the active preset already writes the same mode.
+        // No sibling restores a standalone ponytail default, so apply it here; skip it when the active preset already writes the same mode.
         if (!entries.some((e) => e?.type === 'custom' && e.customType === 'ponytail-mode')) {
             const ponytailFallback = readPonytailDefault();
             if (ponytailFallback !== 'off' && ponytailFallback !== getSharedComboState().ponytail) {
                 pi.appendEntry?.('ponytail-mode', { mode: ponytailFallback });
-                useState(setSharedComboMode('ponytail', ponytailFallback), ctx);
+                setSharedComboMode('ponytail', ponytailFallback);
             }
         }
+        // Announced last, so any default above is reflected.
+        announceStatus(ctx);
     });
-    for (const event of ['session_branch', 'session_tree', 'agent_start']) {
+    // Resume, branch, and compaction re-announce; dedupe keeps repeats silent.
+    for (const event of ['session_branch', 'session_tree', 'agent_start', 'session_switch', 'session_compact']) {
         onHostEvent(pi, event, async (_event, ctx) => {
             track(ctx);
+            announceStatus(ctx);
             if (event === 'agent_start')
                 await runFirstRunSetup(ctx);
         });
@@ -175,9 +149,17 @@ export default function comboToggleExtension(pi) {
         if (ctx?.hasUI)
             reconcile(ctx);
         const mode = getSharedComboState().ponytail;
-        if (mode === 'off' || systemPromptIncludes(event.systemPrompt, 'PONYTAIL MODE ACTIVE'))
+        // On pi the upstream ponytail pi-extension is the single injector; it reads these 'ponytail-mode' entries at session start, so Tersio only persists.
+        if (isPiProcess())
+            return;
+        // Match the level's own header: the shared phrase alone makes every level block every other, so a `/combo` level switch is ignored all session.
+        if (mode === 'off' || systemPromptIncludes(event.systemPrompt, `PONYTAIL MODE ACTIVE — level: ${mode}`))
             return;
-        return injectPromptText(pi, event, await loadPonytailInstructions(mode));
+        const instruction = await loadPonytailInstructions(mode);
+        // The previous level's block is replaced, not stacked on.
+        const stale = lastInjected;
+        lastInjected = instruction;
+        return injectPromptText(pi, event, instruction, stale);
     });
     // Slash commands only; natural-language input caused accidental toggles and has no reload context.
 }

package/extensions/combo-toggle/index.ts

@@ -1,31 +1,30 @@
 // /combo session toggle: off | medium | balanced | max.
 
 import path from 'node:path';
+import { existsSync } from 'node:fs';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import {
   activeModesSummary,
   COMBO_LEVELS,
   getSharedComboState,
-  isComboPresetActive,
+  hasModeState,
   normalizeComboLevel,
-  paintableCtx,
   reconcileSharedComboEntries,
   sessionEntries,
   setSharedComboLevel,
-  statusUi,
   setSharedComboListener,
   setSharedComboMode,
   systemPromptIncludes,
-  themeStatus,
 } from '../shared/session-state.ts';
 import { hostSelect, injectPromptText, onHostEvent, setExtensionLabel } from '../shared/host.ts';
+import { announceStatus } from '../shared/status.ts';
 import {
   isComboSetupComplete,
   readComboDefault,
   readPonytailDefault,
   saveComboSetup,
 } from '../shared/plugin-settings.ts';
-import { findHoistedPackage } from '../lib/utils.ts';
+import { findHoistedPackage, isPiProcess } from '../lib/utils.ts';
 import type { ComboState, ExtensionApi, ExtensionCtx, SystemPromptEvent } from '../shared/types.ts';
 
 const EXTENSION_DIR = path.dirname(fileURLToPath(import.meta.url));
@@ -40,17 +39,16 @@ export function ponytailFallback(mode: string): string {
   return `🦥 PONYTAIL MODE ACTIVE — level: ${mode}\n${intensity} Understand the path first and fix root causes, not symptoms. Prefer the standard library and YAGNI. Avoid speculative abstractions and dependencies. Preserve correctness. Verify changed behavior.`;
 }
 
-function levelSummary(state: ComboState): string {
-  return `caveman=${state.caveman} rtk=${state.rtk} ponytail=${state.ponytail}`;
-}
 
-// Ponytail is hoisted, so one upward walk covers every install layout. The hook
-// is CommonJS, so both namespace shapes are tried.
+// Ponytail is hoisted, so one upward walk covers every install layout. The hook is CommonJS, so both namespace shapes are tried.
 async function loadPonytailInstructions(mode: string): Promise<string> {
   const installed = findHoistedPackage('@dietrichgebert/ponytail', EXTENSION_DIR, 'hooks', 'ponytail-instructions.js');
-  if (installed) {
+  // The OpenCode tree ships no node_modules; the installer bundles the ruleset beside the extensions.
+  const bundled = path.join(EXTENSION_DIR, '..', 'ponytail-bundle', 'hooks', 'ponytail-instructions.js');
+  const treeLocal = installed ?? (existsSync(bundled) ? bundled : null);
+  if (treeLocal) {
     try {
-      const loaded = await import(pathToFileURL(installed).href) as {
+      const loaded = await import(pathToFileURL(treeLocal).href) as {
         getPonytailInstructions?: (level: string) => string;
         default?: { getPonytailInstructions?: (level: string) => string };
       };
@@ -64,30 +62,9 @@ async function loadPonytailInstructions(mode: string): Promise<string> {
 export default function comboToggleExtension(pi: ExtensionApi): void {
   setExtensionLabel(pi, 'Combo session toggle (all 3 add-ons)');
 
-  let lastCtx: ExtensionCtx | undefined = undefined;
   let setupPrompted = false;
+  let lastInjected: string | undefined = undefined;
 
-  function syncStatus(ctx?: ExtensionCtx): void {
-    lastCtx = paintableCtx(lastCtx, ctx);
-    const ui = statusUi(lastCtx);
-    if (!ui) return;
-    // One unified bar replaces the per-extension bars while a preset is active.
-    if (!isComboPresetActive()) {
-      ui.setStatus('combo', undefined);
-      return;
-    }
-    // Read the live bridge, not a cache: siblings reconcile it first.
-    const state = getSharedComboState();
-    const c0 = state.caveman.toUpperCase();
-    const r = state.rtk.toUpperCase();
-    const p = state.ponytail.toUpperCase();
-    const lvl = state.level.toUpperCase();
-    ui.setStatus('combo', themeStatus(ui, '🧩', `combo ${lvl}: 🪨caveman=${c0} ⚡rtk=${r} 🦥ponytail=${p}`, true));
-    // Our bar is canonical for the preset, so clear any sibling bar.
-    ui.setStatus('caveman', undefined);
-    ui.setStatus('rtk', undefined);
-    ui.setStatus('ponytail', undefined);
-  }
 
   // Siblings restore from these entries, so the fallback must write them too.
   function persistPreset(level: string): void {
@@ -98,17 +75,13 @@ export default function comboToggleExtension(pi: ExtensionApi): void {
     pi.appendEntry?.('combo-level', { level });
   }
 
-  function useState(state: Readonly<ComboState>, ctx?: ExtensionCtx): Readonly<ComboState> {
-    syncStatus(ctx);
-    return state;
-  }
-
   function reconcile(ctx?: ExtensionCtx): Readonly<ComboState> {
     if (!ctx?.hasUI) return getSharedComboState();
-    return useState(reconcileSharedComboEntries(sessionEntries(ctx)), ctx);
+    return reconcileSharedComboEntries(sessionEntries(ctx));
   }
   function listen(ctx?: ExtensionCtx): void {
-    if (ctx?.hasUI) setSharedComboListener('combo', useState);
+    if (!ctx?.hasUI) return;
+    setSharedComboListener('combo', (state) => { announceStatus(ctx); return state; });
   }
 
   function track(ctx?: ExtensionCtx): void {
@@ -123,11 +96,8 @@ export default function comboToggleExtension(pi: ExtensionApi): void {
       const arg = String(args || '').trim().toLowerCase();
 
       if (!arg || arg === 'status') {
-        const state = reconcile(ctx);
-        ctx?.ui?.notify?.(
-          `Combo: ${state.level === 'custom' ? 'INACTIVE' : state.level.toUpperCase()} (${levelSummary(state)})`,
-          'info'
-        );
+        reconcile(ctx);
+        announceStatus(ctx);
         return;
       }
 
@@ -152,13 +122,8 @@ export default function comboToggleExtension(pi: ExtensionApi): void {
       }
 
       persistPreset(level);
-      useState(setSharedComboLevel(level), ctx);
-
-      const active = activeModesSummary(getSharedComboState());
-      ctx?.ui?.notify?.(
-        level === 'off' ? `Combo off — all tersio modes inactive for this session. Active: ${active}.` : `Combo ${level} on — ${active} active for this session.`,
-        'info'
-      );
+      setSharedComboLevel(level);
+      announceStatus(ctx);
     },
   });
 
@@ -174,42 +139,41 @@ export default function comboToggleExtension(pi: ExtensionApi): void {
     const level = choice || 'off';
     if (saveComboSetup(level) && level !== 'off') {
       persistPreset(level);
-      useState(setSharedComboLevel(level), ctx);
+      setSharedComboLevel(level);
       ctx.ui.notify?.(`Combo default saved: ${level} — ${activeModesSummary(getSharedComboState())} will activate on fresh sessions.`, 'info');
     }
   }
 
   pi.on('session_start', async (_event, ctx) => {
     track(ctx);
-    if (!ctx?.hasUI) syncStatus(ctx);
     await runFirstRunSetup(ctx);
     // The configured default applies only when no persisted mode state exists.
     const entries = sessionEntries(ctx);
-    const hasModeState = entries.some((e) => e?.type === 'custom' && (
-      e.customType === 'combo-level' || e.customType === 'caveman-mode' ||
-      e.customType === 'rtk-mode' || e.customType === 'ponytail-mode'));
-    if (getSharedComboState().level === 'off' && !hasModeState) {
+    const persisted = hasModeState(entries);
+    if (getSharedComboState().level === 'off' && !persisted) {
       const fallback = readComboDefault();
       if (fallback !== 'off') {
         persistPreset(fallback);
-        useState(setSharedComboLevel(fallback), ctx);
-        ctx?.ui?.notify?.(`Combo default applied: ${fallback} — ${activeModesSummary(getSharedComboState())} active for this session.`, 'info');
+        setSharedComboLevel(fallback);
       }
     }
-    // No sibling restores a standalone ponytail default, so apply it here; skip
-    // it when the active preset already writes the same mode.
+    // No sibling restores a standalone ponytail default, so apply it here; skip it when the active preset already writes the same mode.
     if (!entries.some((e) => e?.type === 'custom' && e.customType === 'ponytail-mode')) {
       const ponytailFallback = readPonytailDefault();
       if (ponytailFallback !== 'off' && ponytailFallback !== getSharedComboState().ponytail) {
         pi.appendEntry?.('ponytail-mode', { mode: ponytailFallback });
-        useState(setSharedComboMode('ponytail', ponytailFallback), ctx);
+        setSharedComboMode('ponytail', ponytailFallback);
       }
     }
+    // Announced last, so any default above is reflected.
+    announceStatus(ctx);
   });
 
-  for (const event of ['session_branch', 'session_tree', 'agent_start']) {
+  // Resume, branch, and compaction re-announce; dedupe keeps repeats silent.
+  for (const event of ['session_branch', 'session_tree', 'agent_start', 'session_switch', 'session_compact']) {
     onHostEvent(pi, event, async (_event, ctx) => {
       track(ctx);
+      announceStatus(ctx);
       if (event === 'agent_start') await runFirstRunSetup(ctx);
     });
   }
@@ -217,8 +181,15 @@ export default function comboToggleExtension(pi: ExtensionApi): void {
   pi.on<SystemPromptEvent>('before_agent_start', async (event, ctx) => {
     if (ctx?.hasUI) reconcile(ctx);
     const mode = getSharedComboState().ponytail;
-    if (mode === 'off' || systemPromptIncludes(event.systemPrompt, 'PONYTAIL MODE ACTIVE')) return;
-    return injectPromptText(pi, event, await loadPonytailInstructions(mode));
+    // On pi the upstream ponytail pi-extension is the single injector; it reads these 'ponytail-mode' entries at session start, so Tersio only persists.
+    if (isPiProcess()) return;
+    // Match the level's own header: the shared phrase alone makes every level block every other, so a `/combo` level switch is ignored all session.
+    if (mode === 'off' || systemPromptIncludes(event.systemPrompt, `PONYTAIL MODE ACTIVE — level: ${mode}`)) return;
+    const instruction = await loadPonytailInstructions(mode);
+    // The previous level's block is replaced, not stacked on.
+    const stale = lastInjected;
+    lastInjected = instruction;
+    return injectPromptText(pi, event, instruction, stale);
   });
 
   // Slash commands only; natural-language input caused accidental toggles and has no reload context.

package/extensions/lib/utils.js

@@ -1,5 +1,4 @@
-// Shared helpers for the installer and the AI add-ons updater. Node built-ins
-// only — this module must stay dependency-free.
+// Shared helpers for the installer and the AI add-ons updater. Node built-ins only — this module must stay dependency-free.
 import { createHash } from 'node:crypto';
 import { accessSync, constants, createWriteStream, existsSync, mkdirSync, renameSync, statSync } from 'node:fs';
 import fs from 'node:fs/promises';
@@ -13,6 +12,11 @@ export function withResolvers() {
     const promise = new Promise((res, rej) => { resolve = res; reject = rej; });
     return { promise, resolve, reject };
 }
+// os.homedir() can ignore a runtime HOME, so a redirected home would read the real one.
+export function homeDir() {
+    const home = process.env.HOME || process.env.USERPROFILE;
+    return home && home.trim() !== '' ? home : os.homedir();
+}
 export const RTK_RELEASE_API = 'https://api.github.com/repos/rtk-ai/rtk/releases/latest';
 export const CAVEMAN_REMOTE_RULE = 'https://raw.githubusercontent.com/JuliusBrussee/caveman/main/skills/caveman/SKILL.md';
 const RTK_PLATFORM_SPECS = {
@@ -22,11 +26,13 @@ const RTK_PLATFORM_SPECS = {
     'darwin/x64': { triple: 'x86_64-apple-darwin', ext: '.tar.gz', binary: 'rtk' },
     'darwin/arm64': { triple: 'aarch64-apple-darwin', ext: '.tar.gz', binary: 'rtk' },
 };
-export function resolveRtkBinary(managedDir = path.join(os.homedir(), '.bun', 'bin')) {
-    const name = process.platform === 'win32' ? 'rtk.exe' : 'rtk';
-    const candidates = (process.env.PATH || '').split(path.delimiter).filter(Boolean).map((dir) => path.join(dir, name));
+// First executable `name` on PATH, else the managed Bun bin dir.
+function firstExecutable(name, managedDir) {
+    const ext = process.platform === 'win32' ? '.cmd' : '';
+    const candidates = (process.env.PATH || '').split(path.delimiter).filter(Boolean)
+        .flatMap((dir) => [path.join(dir, name + ext), path.join(dir, name)]);
     if (managedDir)
-        candidates.push(path.join(managedDir, name));
+        candidates.push(path.join(managedDir, name + ext), path.join(managedDir, name));
     for (const candidate of candidates) {
         try {
             if (!statSync(candidate).isFile())
@@ -38,6 +44,13 @@ export function resolveRtkBinary(managedDir = path.join(os.homedir(), '.bun', 'b
     }
     return null;
 }
+export function resolveRtkBinary(managedDir = path.join(homeDir(), '.bun', 'bin')) {
+    return firstExecutable(process.platform === 'win32' ? 'rtk.exe' : 'rtk', managedDir);
+}
+// A host binary to scan for its subagent marker.
+export function resolveHostBinary(name, managedDir = path.join(homeDir(), '.bun', 'bin')) {
+    return firstExecutable(name, managedDir);
+}
 export function rtkPlatformSpec(platform = process.platform, arch = process.arch) {
     return RTK_PLATFORM_SPECS[`${platform}/${arch}`] || null;
 }
@@ -48,23 +61,25 @@ function redirectNext(res, url) {
     }
     return null;
 }
-// pi sets PI_CODING_AGENT; OMP does not. OMP does read PI_CODING_AGENT_DIR as
-// its own relocation variable, so the override only counts under that marker.
+// pi sets PI_CODING_AGENT; OMP does not. OMP does read PI_CODING_AGENT_DIR as its own relocation variable, so the override only counts under that marker.
 export function isPiProcess() {
     return process.env.PI_CODING_AGENT === 'true';
 }
 export function piAgentDir() {
     const override = process.env.PI_CODING_AGENT_DIR;
-    return isPiProcess() && override ? override : path.join(os.homedir(), '.pi', 'agent');
+    return isPiProcess() && override ? override : path.join(homeDir(), '.pi', 'agent');
 }
-// Ponytail is a Tersio dependency that npm hoists, so it can sit in Tersio's
-// node_modules, a host's plugin dir, or beside it. Walking up covers all.
+// Ponytail is a Tersio dependency that npm hoists, so it can sit in Tersio's node_modules, a host's plugin dir, or beside it. Walking up covers all.
 export function findHoistedPackage(pkg, fromDir, ...relInside) {
     let dir = fromDir;
     for (;;) {
         const candidate = path.join(dir, 'node_modules', ...pkg.split('/'), ...relInside);
         if (existsSync(candidate))
             return candidate;
+        // pi installs npm packages under ~/.pi/agent/npm/node_modules.
+        const piCandidate = path.join(dir, 'npm', 'node_modules', ...pkg.split('/'), ...relInside);
+        if (existsSync(piCandidate))
+            return piCandidate;
         const parent = path.dirname(dir);
         if (parent === dir)
             return null;
@@ -194,15 +209,45 @@ export async function readTextIfExists(p) {
         return null;
     }
 }
-// Tersio-owned data home: ~/.tersio. First use moves legacy
-// ~/.omp/plugins/tersio-* files over so existing installs keep their history.
+// Chunked so a 200 MiB host binary is never held in memory. `tail` keeps the last needle.length-1 bytes of the previous chunk, because a match can begin near the end of one chunk and finish inside the next.
+export async function fileContains(filePath, needleText) {
+    const needle = Buffer.from(needleText, 'utf8');
+    if (needle.length === 0)
+        return false;
+    const keep = needle.length - 1;
+    let handle;
+    try {
+        handle = await fs.open(filePath, 'r');
+        const { size } = await handle.stat();
+        const chunk = Buffer.allocUnsafe(1 << 20);
+        let tail = Buffer.alloc(0);
+        for (let position = 0; position < size;) {
+            const { bytesRead } = await handle.read(chunk, 0, chunk.length, position);
+            if (bytesRead === 0)
+                break;
+            const window = Buffer.concat([tail, chunk.subarray(0, bytesRead)]);
+            if (window.includes(needle))
+                return true;
+            tail = window.subarray(Math.max(0, window.length - keep));
+            position += bytesRead;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        await handle?.close().catch(() => { });
+    }
+}
+// Tersio-owned data home: ~/.tersio. First use moves legacy ~/.omp/plugins/tersio-* files over so existing installs keep their history.
 const migratedTersioFiles = new Set();
 export function tersioHome() {
     // Matches the other TERSIO_* overrides so a test never reads the real home.
     const override = process.env.TERSIO_HOME;
     if (override && override.trim() !== '')
         return override;
-    return path.join(os.homedir(), '.tersio');
+    return path.join(homeDir(), '.tersio');
 }
 export function tersioDataPath(name, legacy) {
     const dest = path.join(tersioHome(), name);
@@ -210,7 +255,7 @@ export function tersioDataPath(name, legacy) {
         migratedTersioFiles.add(name);
         try {
             if (!existsSync(dest)) {
-                const src = path.join(os.homedir(), '.omp', 'plugins', legacy);
+                const src = path.join(homeDir(), '.omp', 'plugins', legacy);
                 if (existsSync(src)) {
                     mkdirSync(tersioHome(), { recursive: true });
                     renameSync(src, dest);