pi-codex-compaction 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -6,6 +6,18 @@ This project follows the spirit of [Keep a Changelog](https://keepachangelog.com
 
 ## [Unreleased]
 
+## [0.1.5] - 2026-09-17
+
+### Fixed
+
+- Persist the Codex compaction confirmation as a rendered, non-model session entry so Pi's post-compaction chat rebuild does not erase it.
+
+## [0.1.4] - 2026-09-15
+
+### Added
+
+- Show `[compaction (codex)] Checkpoint saved.` in the TUI after a Codex checkpoint is saved, to distinguish it from standard Pi compaction.
+
 ## [0.1.3] - 2026-09-11
 
 ### Fixed

package/README.md

@@ -35,6 +35,13 @@ pi -e /path/to/pi-mono/packages/pi-codex-compaction
 
 ## Behavior
 
+After a Codex checkpoint is saved, the TUI shows
+`[compaction (codex)] Checkpoint saved.` Pi's built-in `[compaction]` heading
+remains unchanged. The notice is stored as a TUI-only custom session entry, so it
+survives the compaction chat rebuild and reload. It is not added to model context.
+Standard Pi compaction does not create a Codex success notice.
+Print, JSON, and RPC modes receive no extra notification.
+
 When Pi starts compaction on a supported Codex model, the extension sends a streamed Responses request whose `input` contains only discardable history, any compatible prior checkpoint, and a `compaction_trigger` item. The normal request envelope is retained because Codex's compaction path is parity-tested against ordinary Responses requests; this includes the effective system prompt, active tool definitions, reasoning level, prompt-cache fields, and routing fields. The request uses the `remote_compaction_v2` beta feature, and the returned opaque checkpoint and bounded provider usage are stored in the Pi compaction entry. Later requests rehydrate the raw checkpoint only when the model, endpoint, account, and authentication mode match; other providers/models receive the bounded textual fallback instead.
 
 Compaction uses the model active when Pi triggers it. If a session switches from a larger to a smaller model, the remote request is bounded against the new model's context window and tool outputs are reduced before sending. A previous opaque checkpoint is treated as incompatible after a model, endpoint, account, or authentication-mode switch; Pi's readable previous summary is sent instead. If the full request still cannot fit, the extension leaves compaction to Pi's normal implementation.
@@ -105,6 +112,11 @@ Costs follow Pi's catalog estimates. They are not a ChatGPT subscription bill.
 
 ### Reference and smoke test
 
+The automated display smoke tests exercise Pi's actual compaction-end handler
+and chat renderer for manual, threshold, and overflow compaction. They check
+redraw, reload, standard compaction, and exclusion from subsequent model requests.
+Only provider responses and terminal I/O are replaced with local fixtures.
+
 Behavior was checked against `openai/codex` commit
 `654b0a77d0d2f81aa21f61caf7af4be88fe550bb` (2026-09-11), notably
 `core/src/compact_remote_v2{,_attempt}.rs`. No Codex code was copied.
@@ -113,6 +125,10 @@ API. Async tools and mid-turn steering require upstream Pi support.
 
 For a small live test, load this package and select `openai-codex/gpt-6-astra`.
 Send two short messages, run `/compact`, then ask about the first message.
+Confirm `[compaction (codex)] Checkpoint saved.` remains visible after the
+compaction finishes and after `/reload`. Then run
+`/compact Focus on recent work` and confirm the standard-compaction warning
+appears without a new Codex success notice.
 Repeat with `/fast on` and `pi-codex-tools` loaded. Check that compaction succeeds,
 the continuation retains context, and session usage includes compaction tokens.
 Use only a temporary file if you test `apply_patch`. Do not generate images.

package/extensions/index.ts

@@ -3,6 +3,7 @@ import type {
   ExtensionHandler,
   SessionBeforeCompactEvent,
 } from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
 import { BETA_FEATURE, getCodexAccountFingerprint } from "../src/codex-wire.js";
 import { reportInstallTelemetry } from "../src/install-telemetry.js";
 import {
@@ -26,9 +27,15 @@ const FALLBACK_MESSAGES: Record<CompactionFallback["reason"], string> = {
   "remote-failed": "the remote request failed",
 };
 
+const COMPACTION_SAVED_ENTRY = "pi-codex-compaction:saved:v1";
+
 export default function piCodexCompaction(pi: ExtensionAPI): void {
   reportInstallTelemetry();
 
+  pi.registerEntryRenderer(COMPACTION_SAVED_ENTRY, (_entry, _options, theme) =>
+    new Text(theme.fg("dim", "[compaction (codex)] Checkpoint saved."), 1, 0),
+  );
+
   const onBeforeCompact: ExtensionHandler<SessionBeforeCompactEvent, { compaction?: NonNullable<Awaited<ReturnType<typeof createRemoteCompaction>>> }> = async (event, ctx) => {
     if (!supportsRemoteCompaction(ctx.model)) return undefined;
 
@@ -84,6 +91,18 @@ export default function piCodexCompaction(pi: ExtensionAPI): void {
   };
   pi.on("session_before_compact", onBeforeCompact);
 
+  pi.on("session_compact", (event, ctx) => {
+    if (ctx.mode !== "tui" || !ctx.hasUI || !event.fromExtension) return;
+    if (!findActiveRemoteCompaction([event.compactionEntry])) return;
+    try {
+      // Pi rebuilds chat after session_compact, removing transient notifications.
+      // A rendered custom entry survives that rebuild without entering LLM context.
+      pi.appendEntry(COMPACTION_SAVED_ENTRY, { version: 1 });
+    } catch {
+      // Display failures must not affect a saved checkpoint or continuation.
+    }
+  });
+
   pi.on("before_provider_headers", (event, ctx) => {
     if (!supportsRemoteCompaction(ctx.model)) return;
     const existing = event.headers["x-codex-beta-features"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-codex-compaction",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Use OpenAI Codex RemoteCompactionV2 for supported Pi sessions.",
   "type": "module",
   "license": "MIT",
@@ -49,11 +49,13 @@
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*"
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
   },
   "devDependencies": {
     "@earendil-works/pi-ai": "^0.85.1",
     "@earendil-works/pi-coding-agent": "^0.85.1",
+    "@earendil-works/pi-tui": "^0.85.1",
     "@types/node": "^26.2.0",
     "tsx": "^4.23.5",
     "typescript": "^7.0.2"