@pi-unipi/unipi 2.4.0 → 2.4.2

package/CHANGELOG.md

@@ -6,6 +6,49 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.4.2] — 2026-08-13
+
+This release closes the unreachable-code and misleading-contract audit across runtime behavior, package artifacts, and integration events.
+
+### Added
+
+- **Release contracts:** added package-entry, production-graph, all-tarball manifest, standalone Subagents import, and isolated Utility dependency checks.
+- **Workflow lifecycle events:** workflow commands now emit one start/end pair around their agent run; Milestone synchronizes on completion while retaining shutdown fallback.
+- **Compactor event delivery:** successful compactions now emit the documented completion event, and Ralph emits iteration completion only after a real advance.
+
+### Changed
+
+- **Compactor configuration is now truthful.** Session continuity and sandbox off modes are enforced; language allowlists and output limits are active. Unsupported FTS5, display, and pipeline controls are hidden/deprecated rather than presented as working features.
+- **Subagents honors type enablement.** JSON and custom-agent frontmatter disables are enforced before records or queue entries are created.
+- **Notification priority is effective.** Explicit low/normal/high requests map to Gotify 2/5/8 and ntfy 2/3/5; omission preserves configured platform priorities.
+- **Standalone Subagents ships built ESM.** The package now prebuilds verified `dist` JavaScript/declarations, publishes no tests or raw source, and exposes a standalone Pi extension entry.
+- **Utility declares its real dependencies.** Direct Shiki usage is backed by `shiki`, and Pi TUI is declared as a host-shared peer.
+- **Package roots and manifests were tightened.** Meaningful Footer/Updater barrels are canonical, redundant wrappers are gone, and root/workspace tarballs exclude tests while retaining every declared main.
+
+### Fixed
+
+- **Compactor resume context reaches the model once.** The hidden one-shot snapshot no longer gets consumed and discarded, and the system prompt remains prefix-cache stable.
+- **Compactor sandbox policy is enforced.** Disabled tools are not registered, disallowed languages are rejected, and configured output limits reach shared executors.
+- **`/unipi:status` responds immediately and truthfully.** Removed the dead request broadcast and guaranteed 500 ms wait; the command now points to live info and diagnostics surfaces.
+- **Footer event wiring no longer waits on stale stats events.** Live Compactor segments continue reading session state directly.
+- **Standalone package resolution works in strict installs.** Subagents imports by package name, and Utility resolves Shiki and Pi TUI from its installed package root.
+
+### Removed
+
+- Nine compiler-proven private declarations with no reads or callers.
+- Fourteen source modules absent from the production graph, after preserving active `SectionData` and `RuntimeStats` type contracts.
+- Permanently-zero Compactor indexed-byte accounting and unused package-root pass-through wrappers.
+
+### Known issue
+
+- The rank-2 LLM summarization provider still returns placeholder text. Its resolution is intentionally deferred pending the broader Wigolo/web-fetch architecture decision.
+
+## [2.4.1] — 2026-08-13
+
+### Fixed
+
+- **`ralph`: loop status no longer invalidates the DeepSeek prefix cache.** The `before_agent_start` hook appended `[RALPH LOOP - name - Iteration N]` to the system prompt on every turn; because the iteration number changes each turn, this mutated the request prefix on every turn of a Ralph loop, forcing a full DeepSeek prefix-cache miss (~60K tokens re-billed at uncached price) per turn. The loop status now rides a hidden tail message (`unipi-ralph-loop-reminder`) so the cacheable prefix (system prompt + prior history) stays byte-stable across turns. The model still sees the loop name, iteration, and instructions.
+
 ## [2.4.0] — 2026-08-09
 
 Image generation no longer requires an OpenRouter account, and `image_generate` can now edit an existing image.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -41,7 +41,11 @@
     "packages/*/SKILL.md",
     "packages/*/skills/**/*",
     "packages/*/README.md",
-    "packages/unipi/bundled.js"
+    "packages/unipi/bundled.js",
+    "!packages/**/__tests__/**",
+    "!packages/**/tests/**",
+    "!packages/**/*.test.ts",
+    "!packages/**/*.spec.ts"
   ],
   "pi": {
     "extensions": [
@@ -71,26 +75,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "2.4.0",
-    "@pi-unipi/btw": "2.4.0",
-    "@pi-unipi/compactor": "2.4.0",
-    "@pi-unipi/notify": "2.4.0",
-    "@pi-unipi/command-enchantment": "2.4.0",
-    "@pi-unipi/core": "2.4.0",
-    "@pi-unipi/info-screen": "2.4.0",
-    "@pi-unipi/mcp": "2.4.0",
-    "@pi-unipi/memory": "2.4.0",
-    "@pi-unipi/ralph": "2.4.0",
-    "@pi-unipi/subagents": "2.4.0",
-    "@pi-unipi/utility": "2.4.0",
-    "@pi-unipi/milestone": "2.4.0",
-    "@pi-unipi/kanboard": "2.4.0",
-    "@pi-unipi/web-api": "2.4.0",
-    "@pi-unipi/workflow": "2.4.0",
-    "@pi-unipi/footer": "2.4.0",
-    "@pi-unipi/updater": "2.4.0",
-    "@pi-unipi/input-shortcuts": "2.4.0",
-    "@pi-unipi/cocoindex": "2.4.0"
+    "@pi-unipi/ask-user": "2.4.1",
+    "@pi-unipi/btw": "2.4.1",
+    "@pi-unipi/compactor": "2.4.1",
+    "@pi-unipi/notify": "2.4.1",
+    "@pi-unipi/command-enchantment": "2.4.1",
+    "@pi-unipi/core": "2.4.1",
+    "@pi-unipi/info-screen": "2.4.1",
+    "@pi-unipi/mcp": "2.4.1",
+    "@pi-unipi/memory": "2.4.1",
+    "@pi-unipi/ralph": "2.4.2",
+    "@pi-unipi/subagents": "2.4.1",
+    "@pi-unipi/utility": "2.4.1",
+    "@pi-unipi/milestone": "2.4.1",
+    "@pi-unipi/kanboard": "2.4.1",
+    "@pi-unipi/web-api": "2.4.1",
+    "@pi-unipi/workflow": "2.4.1",
+    "@pi-unipi/footer": "2.4.1",
+    "@pi-unipi/updater": "2.4.1",
+    "@pi-unipi/input-shortcuts": "2.4.1",
+    "@pi-unipi/cocoindex": "2.4.1"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.80.0",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.4.0"
+    "@pi-unipi/core": "2.4.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",
@@ -24,7 +24,9 @@
   ],
   "files": [
     "src/**/*.ts",
-    "README.md"
+    "README.md",
+    "!src/__tests__/**",
+    "!src/**/*.test.ts"
   ],
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.80.0"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.4.0"
+    "@pi-unipi/core": "2.4.1"
   },
   "pi": {
     "extensions": [],

package/packages/cocoindex/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/cocoindex",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "CocoIndex integration for Pi — AST-aware content indexing, semantic vector search, and incremental pipeline management",
   "type": "module",
   "main": "index.ts",
@@ -25,7 +25,7 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.4.0"
+    "@pi-unipi/core": "2.4.1"
   },
   "optionalDependencies": {
     "@lancedb/lancedb": "^0.21.0"

package/packages/cocoindex/tools.ts

@@ -35,14 +35,6 @@ function textResult(text: string, details?: Record<string, unknown>): any {
   };
 }
 
-function jsonResult(data: unknown, label?: string): any {
-  const text = label ? `${label}:\n${JSON.stringify(data, null, 2)}` : JSON.stringify(data, null, 2);
-  return {
-    content: [{ type: "text", text }],
-    details: data as Record<string, unknown>,
-  };
-}
-
 // ─────────────────────────────────────────────────────────
 // Registration
 // ─────────────────────────────────────────────────────────

package/packages/compactor/README.md

@@ -72,14 +72,14 @@ Keyboard:
 
 ### Presets tab
 
-Presets are profiles that set strategies, pipeline switches, sandbox mode, and display mode.
+Presets are profiles that set strategies, the implemented Auto Injection pipeline behavior, and sandbox mode.
 
 | Preset | Intended use | Important effects |
 |---|---|---|
-| `precise` | Code-heavy work, minimal waste | Full compaction sections, safe-only sandbox, opencode display, Pipeline: `ttlCache` + `mmapPragma` on. |
-| `balanced` | Daily/default profile | Compact transcript, balanced display, FTS mode auto, sandbox all, Pipeline: all six switches on. |
-| `thorough` | Debug/audit sessions | Full transcript, verbose display, sandbox all, Pipeline: all six switches on. |
-| `lean` | Quick fixes or short sessions | Brief/minimal compaction sections, no sandbox, no session continuity, Pipeline: all off. |
+| `precise` | Code-heavy work, minimal waste | Full compaction sections, sandbox enabled, Auto Injection off. |
+| `balanced` | Daily/default profile | Compact transcript, sandbox enabled, Auto Injection on. |
+| `thorough` | Debug/audit sessions | Full transcript, sandbox enabled, Auto Injection on. |
+| `lean` | Quick fixes or short sessions | Brief/minimal compaction sections, no sandbox, no session continuity, Auto Injection off. |
 
 The **Project Override** row controls where settings are saved:
 
@@ -99,11 +99,10 @@ These settings control what is extracted into compaction summaries or how relate
 | `Outstanding Context` | `full`, `critical-only`, `off` | Keeps blockers, TODOs, pending decisions, and follow-ups. |
 | `User Preferences` | `all`, `recent-only`, `off` | Preserves user preferences learned during the session. |
 | `Brief Transcript` | `full`, `compact`, `minimal`, `off` | Keeps a rolling recent transcript after the structured sections. |
-| `Session Continuity` | `full`, `essential-only`, `off` | Controls XML-style resume snapshots that help the next turn continue after compaction. |
-| `Sandbox Execution` | `all`, `safe-only`, `off` | Controls agent-facing sandbox availability/intent. Safe-only is intended for less risky execution. |
-| `Tool Display` | `opencode`, `balanced`, `verbose`, `custom` | Controls built-in tool output rendering style and diff display behavior. |
+| `Session Continuity` | `full`, `off` | Controls XML-style resume snapshots. Off prevents snapshot creation and injection; Pi’s normal compaction summary still remains. |
+| `Sandbox Execution` | `all`, `off` | Controls sandbox tool registration. Changes require a session reload. Allowed languages and output limit are enforced from config. |
 
-Config-only legacy field: `fts5Index` remains in the schema for compatibility, but project indexing has moved to `@pi-unipi/cocoindex`.
+Config-only legacy field: `fts5Index` remains in the schema for compatibility, but project indexing has moved to `@pi-unipi/cocoindex`. It is hidden from Compactor settings and presets. Legacy `sessionContinuity.mode: "essential-only"`, `eventCategories`, and `sandboxExecution.mode: "safe-only"` values remain loadable; essential-only behaves as full and safe-only behaves as enabled/all until explicit filtering/security policies are designed. Legacy `toolDisplay` and `showTruncationHints` fields also remain loadable but are deprecated and ignored; their profile names were never mapped to runtime renderer modes. Narrow-terminal diff clamping remains active as independent safety behavior.
 
 ### Auto tab
 
@@ -133,20 +132,15 @@ Example config:
 
 ### Pipeline tab
 
-Pipeline switches are low-level feature flags used by presets and advanced users.
+The Pipeline tab exposes only behavior implemented by the current runtime.
 
 | Setting | Preset behavior | Current effect |
 |---|---|---|
-| `TTL Cache` | On in `precise`, `balanced`, `thorough`; off in `lean` | Reserved/compatibility switch for cache behavior. Search has an internal cache, but this toggle is not currently required for it. |
-| `Auto Injection` | On in `balanced`, `thorough`; off in `precise`, `lean` | Active. Adds behavioral/session state to the resume snapshot after compaction. |
-| `MMap Pragma` | On in `precise`, `balanced`, `thorough`; off in `lean` | Reserved/compatibility switch for SQLite mmap tuning. |
-| `Proximity Reranking` | On in `balanced`, `thorough`; off in `precise`, `lean` | Reserved/compatibility switch for future recall/search ranking. |
-| `Timeline Sort` | On in `balanced`, `thorough`; off in `precise`, `lean` | Reserved/compatibility switch for future chronological recall sorting. |
-| `Progressive Throttling` | On in `balanced`, `thorough`; off in `precise`, `lean` | Reserved/compatibility switch for future large-project throttling. |
+| `Auto Injection` | On in `balanced`, `thorough`; off in `precise`, `lean` | Adds behavioral/session state to the one-shot resume context after compaction. |
 
-If all Pipeline values stay `off` after choosing a preset, that means the running version is not applying preset pipeline values correctly. Choose a preset, press **Enter** to save, and verify you are on a version containing the preset pipeline fix.
+Deprecated config-only compatibility fields are still accepted so existing files load without migration failures, but they are ignored and no longer controlled or advertised by presets: `ttlCache`, `mmapPragma`, `proximityReranking`, `timelineSort`, and `progressiveThrottling`.
 
-Config-only pipeline field:
+Other config-only pipeline field:
 
 | Field | Meaning |
 |---|---|
@@ -289,10 +283,12 @@ Practical interpretation:
 
 That means preset application is not updating `config.pipeline`. The intended behavior is:
 
-- `precise`: `ttlCache` + `mmapPragma` on.
-- `balanced`: all six pipeline switches on.
-- `thorough`: all six pipeline switches on.
-- `lean`: all pipeline switches off.
+- `precise`: Auto Injection off.
+- `balanced`: Auto Injection on.
+- `thorough`: Auto Injection on.
+- `lean`: Auto Injection off.
+
+The five deprecated compatibility fields remain off in every preset.
 
 Make sure you are running a version with the preset pipeline fix, select the preset, and press **Enter** to save.
 

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Context engine for Pi — zero-LLM compaction, session continuity, sandbox execution, and tool display optimization",
   "type": "module",
   "main": "src/index.ts",
@@ -34,8 +34,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.4.0",
-    "@pi-unipi/info-screen": "2.4.0",
+    "@pi-unipi/core": "2.4.1",
+    "@pi-unipi/info-screen": "2.4.1",
     "@earendil-works/pi-agent-core": "^0.80.0"
   },
   "peerDependencies": {

package/packages/compactor/src/compaction/build-sections.ts

@@ -9,8 +9,8 @@ import { extractFiles } from "./extract/files.js";
 import { extractPreferences, dedupPreferencesAgainstGoals } from "./extract/preferences.js";
 import { extractCommits, formatCommits } from "./extract/commits.js";
 import { buildBriefSections, sectionsToTranscript, stringifyBrief } from "./brief.js";
-import type { SectionData } from "./sections.js";
-export type { SectionData } from "./sections.js";
+import type { SectionData } from "../types.js";
+export type { SectionData } from "../types.js";
 
 const BLOCKER_RE =
   /\b(fail(ed|s|ure|ing)?|broken|cannot|can't|won't work|does not work|doesn't work|still (broken|failing|wrong)|blocked|blocker|not (fixed|resolved|working)|crash(es|ed|ing)?)\b/i;

package/packages/compactor/src/compaction/format.ts

@@ -2,7 +2,7 @@
  * Stage 5: Format — Render sections with separators
  */
 
-import type { SectionData } from "./sections.js";
+import type { SectionData } from "../types.js";
 
 const section = (title: string, items: string[]): string => {
   if (items.length === 0) return "";

package/packages/compactor/src/config/presets.ts

@@ -12,13 +12,11 @@ const pipeline = (overrides: Partial<CompactorConfig["pipeline"]> = {}): Compact
   customNoisePatterns: [...(overrides.customNoisePatterns ?? DEFAULT_COMPACTOR_CONFIG.pipeline.customNoisePatterns)],
 });
 
-const pipelineAllOn = (): CompactorConfig["pipeline"] => pipeline({
-  ttlCache: true,
+// Auto Injection is the only preset-controlled pipeline feature with a runtime
+// implementation. The other persisted fields are retained as ignored legacy
+// compatibility data, but presets must not advertise or enable them.
+const pipelineWithAutoInjection = (): CompactorConfig["pipeline"] => pipeline({
   autoInjection: true,
-  proximityReranking: true,
-  timelineSort: true,
-  progressiveThrottling: true,
-  mmapPragma: true,
 });
 
 const preset = (
@@ -33,30 +31,29 @@ const preset = (
   userPreferences: { ...DEFAULT_COMPACTOR_CONFIG.userPreferences, ...(overrides.userPreferences ?? {}) },
   briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, ...(overrides.briefTranscript ?? {}) },
   sessionContinuity: { ...DEFAULT_COMPACTOR_CONFIG.sessionContinuity, ...(overrides.sessionContinuity ?? {}) },
-  fts5Index: { ...DEFAULT_COMPACTOR_CONFIG.fts5Index, ...(overrides.fts5Index ?? {}) },
+  // Legacy compatibility data only; presets never advertise or alter it.
+  fts5Index: { ...DEFAULT_COMPACTOR_CONFIG.fts5Index },
   sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, ...(overrides.sandboxExecution ?? {}) },
-  toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, ...(overrides.toolDisplay ?? {}) },
+  // Legacy compatibility data only; presets never advertise or alter it.
+  toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay },
   pipeline: pipeline(overrides.pipeline),
   autoCompaction: { ...DEFAULT_COMPACTOR_CONFIG.autoCompaction, ...(overrides.autoCompaction ?? {}) },
 });
 
-// Pipeline feature defaults per preset:
-// precise: ttlCache+mmap on, rest off
-// balanced: all on
-// thorough: all on
-// lean: all off
+// Active pipeline behavior per preset:
+// precise/lean: auto-injection off
+// balanced/thorough: auto-injection on
+// Reserved compatibility fields remain at their inert defaults in all presets.
 
 export const PRESET_CONFIGS: Record<CompactorPreset, CompactorConfig> = {
   // New preset names
   precise: preset({
-    pipeline: pipeline({ ttlCache: true, mmapPragma: true }),
-    sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, mode: "safe-only" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, mode: "opencode" },
+    pipeline: pipeline(),
+    sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, mode: "all" },
   }),
   thorough: preset({
-    pipeline: pipelineAllOn(),
+    pipeline: pipelineWithAutoInjection(),
     briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, mode: "full" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, mode: "verbose" },
   }),
   lean: preset({
     pipeline: pipeline(),
@@ -67,27 +64,21 @@ export const PRESET_CONFIGS: Record<CompactorPreset, CompactorConfig> = {
     userPreferences: { ...DEFAULT_COMPACTOR_CONFIG.userPreferences, enabled: false, mode: "off" },
     briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, enabled: true, mode: "minimal" },
     sessionContinuity: { ...DEFAULT_COMPACTOR_CONFIG.sessionContinuity, enabled: false, mode: "off" },
-    fts5Index: { ...DEFAULT_COMPACTOR_CONFIG.fts5Index, enabled: false, mode: "off" },
     sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, enabled: false, mode: "off" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, enabled: true, mode: "opencode" },
   }),
   balanced: preset({
-    pipeline: pipelineAllOn(),
+    pipeline: pipelineWithAutoInjection(),
     briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, mode: "compact" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, mode: "balanced" },
-    fts5Index: { ...DEFAULT_COMPACTOR_CONFIG.fts5Index, mode: "auto" },
   }),
 
   // Backward-compat aliases — map old names to new
   opencode: preset({
-    pipeline: pipeline({ ttlCache: true, mmapPragma: true }),
-    sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, mode: "safe-only" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, mode: "opencode" },
+    pipeline: pipeline(),
+    sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, mode: "all" },
   }),
   verbose: preset({
-    pipeline: pipelineAllOn(),
+    pipeline: pipelineWithAutoInjection(),
     briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, mode: "full" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, mode: "verbose" },
   }),
   minimal: preset({
     pipeline: pipeline(),
@@ -98,9 +89,7 @@ export const PRESET_CONFIGS: Record<CompactorPreset, CompactorConfig> = {
     userPreferences: { ...DEFAULT_COMPACTOR_CONFIG.userPreferences, enabled: false, mode: "off" },
     briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, enabled: true, mode: "minimal" },
     sessionContinuity: { ...DEFAULT_COMPACTOR_CONFIG.sessionContinuity, enabled: false, mode: "off" },
-    fts5Index: { ...DEFAULT_COMPACTOR_CONFIG.fts5Index, enabled: false, mode: "off" },
     sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, enabled: false, mode: "off" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, enabled: true, mode: "opencode" },
   }),
   custom: structuredClone(DEFAULT_COMPACTOR_CONFIG),
 };

package/packages/compactor/src/index.ts

@@ -15,15 +15,14 @@ import {
 } from "./compaction/auto-trigger.js";
 import { SessionDB, getWorktreeSuffix } from "./session/db.js";
 import { extractEventsFromToolResult } from "./session/extract.js";
-import { injectResumeSnapshot } from "./session/resume-inject.js";
+import { buildResumeContextMessage, isSessionContinuityEnabled } from "./session/resume-inject.js";
 import { PolyglotExecutor } from "./executor/executor.js";
 import { registerCommands } from "./commands/index.js";
 import { registerCompactorTools } from "./tools/register.js";
 import { normalizeMessages } from "./compaction/normalize.js";
 import { filterNoise } from "./compaction/filter-noise.js";
 import { recallBlocksFromContext } from "./session/recall-blocks.js";
-import type { NormalizedBlock, CompactorStrategyConfig, RuntimeCounters } from "./types.js";
-import type { RuntimeStats } from "./session/analytics.js";
+import type { NormalizedBlock, CompactorStrategyConfig, RuntimeCounters, RuntimeStats } from "./types.js";
 
 /** Debug logger — only logs when config.debug === true */
 function createDebugLogger(getConfig: () => { debug: boolean }) {
@@ -63,11 +62,6 @@ function isSandboxTool(name: string): boolean {
   return name === "bash" || name === "Bash";
 }
 
-/** Check if a tool is an index tool (content goes to FTS5, not context). Future-proofing. */
-function isIndexTool(_name: string): boolean {
-  return false;
-}
-
 export default function compactorExtension(pi: ExtensionAPI): void {
   let sessionDB: SessionDB | null = null;
   let executor: PolyglotExecutor | null = null;
@@ -86,7 +80,6 @@ export default function compactorExtension(pi: ExtensionAPI): void {
 
   const runtimeStats: RuntimeStats = {
     bytesReturned: {},
-    bytesIndexed: 0,
     bytesSandboxed: 0,
     calls: {},
     sessionStart: Date.now(),
@@ -114,7 +107,7 @@ export default function compactorExtension(pi: ExtensionAPI): void {
       sessionDB = null;
     }
 
-    executor = new PolyglotExecutor();
+    executor = null;
   };
 
   // Register compaction hooks with lazy deps — sessionDB/sessionId may not be
@@ -156,7 +149,6 @@ export default function compactorExtension(pi: ExtensionAPI): void {
 
     // Reset runtime stats for new session
     runtimeStats.bytesReturned = {};
-    runtimeStats.bytesIndexed = 0;
     runtimeStats.bytesSandboxed = 0;
     runtimeStats.calls = {};
     runtimeStats.sessionStart = Date.now();
@@ -168,11 +160,19 @@ export default function compactorExtension(pi: ExtensionAPI): void {
 
     // Register all compactor tools with Pi (deps now have live sessionDB)
     if (sessionDB) {
+      const sandboxEnabled = config.sandboxExecution.enabled && config.sandboxExecution.mode !== "off";
+      executor = sandboxEnabled
+        ? new PolyglotExecutor({ hardCapBytes: config.sandboxExecution.outputLimit, projectRoot: projectDir })
+        : null;
       registerCompactorTools(pi, {
         sessionDB,
         getSessionId: () => currentSessionId,
         getBlocks: () => cachedBlocks,
         getCounters,
+        sandbox: executor ? {
+          executor,
+          allowedLanguages: config.sandboxExecution.allowedLanguages,
+        } : undefined,
       });
     }
 
@@ -277,25 +277,11 @@ export default function compactorExtension(pi: ExtensionAPI): void {
       // Non-fatal: recall will work on empty blocks
     }
 
-    if (sessionDB) {
-      const snapshot = await injectResumeSnapshot(sessionDB, currentSessionId);
-      debug("resume_snapshot", { injected: !!snapshot });
-
-      // Auto-injection on compact: inject behavioral state after compaction
-      if (snapshot && sessionDB) {
-        try {
-          const { buildAutoInjection } = await import("./session/auto-inject.js");
-          const events = sessionDB.getEvents(currentSessionId, { limit: 100 });
-          const autoInjection = buildAutoInjection(events);
-          if (autoInjection) {
-            debug("auto_injection", { tokens: autoInjection.tokens, length: autoInjection.text.length });
-            // Note: auto-injection is included in the resume snapshot context
-            // The model receives it as part of the session state restoration
-          }
-        } catch (err) {
-          debug("auto_injection_error", { error: String(err) });
-        }
-      }
+    const continuityEnabled = isSessionContinuityEnabled(config);
+    if (sessionDB && continuityEnabled) {
+      const resumeContext = await buildResumeContextMessage(sessionDB, currentSessionId);
+      debug("resume_snapshot", { injected: !!resumeContext });
+      return resumeContext;
     }
   });
 
@@ -358,7 +344,8 @@ export default function compactorExtension(pi: ExtensionAPI): void {
   });
 
   pi.on("session_before_compact", async (event, _ctx) => {
-    if (sessionDB) {
+    const continuityEnabled = isSessionContinuityEnabled(config);
+    if (sessionDB && continuityEnabled) {
       // Use closure currentSessionId — Pi's session_before_compact event
       // does not include sessionId at the top level.
       const sessionId = currentSessionId;
@@ -386,14 +373,21 @@ export default function compactorExtension(pi: ExtensionAPI): void {
       const compactionEntry = (event as any).compactionEntry;
       const tokensBefore = compactionEntry?.tokensBefore ?? 0;
 
+      let summarized = 0;
+      let kept = 0;
+      let tokensSaved = 0;
+
       if (tokensBefore > 0) {
         // Use actual token count from Pi's compactionEntry.
         // Compaction typically keeps ~10-15% of original context.
         const charsBefore = tokensBefore * 4;
-        const tokensAfter = (event as any).tokensAfter ?? Math.round(tokensBefore * 0.12);
+        const tokensAfter = Math.round(tokensBefore * 0.12);
+        kept = tokensAfter;
+        tokensSaved = tokensBefore - tokensAfter;
         const charsKept = tokensAfter * 4;
         const messagesSummarized = Math.max(1, Math.round(tokensBefore / 500));
-        counters.totalTokensCompacted += tokensBefore - tokensAfter;
+        summarized = messagesSummarized;
+        counters.totalTokensCompacted += tokensSaved;
         sessionDB.addCompactionStats(sessionId, charsBefore, charsKept, messagesSummarized);
       } else {
         // tokensBefore unavailable — use session event count as a rough heuristic.
@@ -407,13 +401,24 @@ export default function compactorExtension(pi: ExtensionAPI): void {
             const estTokensAfter = Math.round(estTokensBefore * 0.12);
             const charsBefore = estTokensBefore * 4;
             const charsKept = estTokensAfter * 4;
-            counters.totalTokensCompacted += estTokensBefore - estTokensAfter;
+            summarized = eventCount;
+            kept = estTokensAfter;
+            tokensSaved = estTokensBefore - estTokensAfter;
+            counters.totalTokensCompacted += tokensSaved;
             sessionDB.addCompactionStats(sessionId, charsBefore, charsKept, eventCount);
           }
         } catch {
           // Non-fatal: heuristic estimation failed
         }
       }
+      const totalEstimated = tokensSaved + kept;
+      emitEvent(pi, UNIPI_EVENTS.COMPACTOR_COMPACTED, {
+        sessionId,
+        summarized,
+        kept,
+        tokensSaved,
+        compressionRatio: kept > 0 ? `${Math.round(totalEstimated / kept)}:1` : "0:1",
+      });
       debug("session_compact", { sessionId, tokensBefore, hasCompactionEntry: !!compactionEntry });
     }
   });
@@ -531,34 +536,12 @@ export default function compactorExtension(pi: ExtensionAPI): void {
         if (isSandboxTool(tName)) {
           runtimeStats.bytesSandboxed += responseBytes;
         }
-        if (isIndexTool(tName)) {
-          runtimeStats.bytesIndexed += responseBytes;
-        }
       }
     } catch {
       // Non-blocking: byte tracking errors silently skipped
     }
 
-    // Apply display overrides for built-in tools
     const toolName = (event as any).toolName ?? "";
-    const td = config.toolDisplay;
-    const toolConfig = {
-      readOutputMode: td?.mode as any,
-      searchOutputMode: td?.mode as any,
-      bashOutputMode: td?.mode as any,
-      previewLines: 20,
-      bashCollapsedLines: 5,
-      showTruncationHints: true,
-    };
-    try {
-      const { applyToolDisplayOverride } = await import("./display/tool-overrides.js");
-      const override = applyToolDisplayOverride(toolName, event as any, toolConfig);
-      if (override !== undefined) {
-        return override as any;
-      }
-    } catch {
-      // Non-fatal: display override failed
-    }
 
     // Width-safe diff truncation for edit/write tool results.
     // Pi's renderDiff() does not truncate lines to terminal width,