@narumitw/pi-codex-compact 0.49.5 → 0.50.1

package/README.md

@@ -2,10 +2,6 @@
 
 [![npm](https://img.shields.io/npm/v/@narumitw/pi-codex-compact)](https://www.npmjs.com/package/@narumitw/pi-codex-compact) [![Pi extension](https://img.shields.io/badge/Pi-extension-blue)](https://pi.dev) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
 
-> [!WARNING]
-> This extension is experimental. It depends on an undocumented OpenAI Codex Responses wire
-> contract and stores provider-specific opaque checkpoints. Keep backups of important sessions.
-
 `@narumitw/pi-codex-compact` adds Codex Remote Compaction V2 to the
 [Pi Coding Agent](https://pi.dev) for the built-in `openai-codex` OAuth provider. It replaces Pi's
 plaintext summary-generation call with a server-generated opaque compaction item and safely replays
@@ -47,7 +43,7 @@ pi -e npm:@narumitw/pi-codex-compact
 Try a local checkout from the repository root:
 
 ```bash
-pi -e ./experimental/pi-codex-compact
+pi -e ./packages/pi-codex-compact
 # or
 just try codex-compact
 ```
@@ -63,8 +59,7 @@ and the local workspace at the same time.
 4. Run `/codex-compact` to inspect the effective route or choose **Compact now**.
 5. After compaction, continue the session normally; compatible requests replay the opaque checkpoint.
 
-The extension shows an experimental warning at session start in UI-capable modes. When the active
-model is unsupported, compaction remains entirely Pi-native.
+When the active model is unsupported, compaction remains entirely Pi-native.
 
 ## 💬 Command
 
@@ -191,9 +186,10 @@ An individually oversized media item is dropped rather than making the session e
 oldest fitting text item may be partially truncated to preserve newer context. These hard byte
 ceilings are intentionally not configurable.
 
-## 🚧 Experimental limitations
+## 🚧 Known limitations
 
-- The wire contract is undocumented and can change independently of Pi or this package.
+- The wire contract is undocumented and can change independently of Pi or this package. Keep
+  backups of important sessions.
 - Full older history depends on this extension and the same compatible model. Removing the extension
   exposes only the portability fallback marker and Pi-retained recent messages.
 - The package does not reproduce Codex core's context-window UUID/number lineage, previous-model

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@narumitw/pi-codex-compact",
-	"version": "0.49.5",
-	"description": "Experimental Codex Remote Compaction V2 for Pi's OpenAI Codex provider.",
+	"version": "0.50.1",
+	"description": "Codex Remote Compaction V2 for Pi's OpenAI Codex provider.",
 	"type": "module",
 	"license": "MIT",
 	"private": false,
@@ -23,6 +23,9 @@
 			"./src/index.ts"
 		]
 	},
+	"piExtension": {
+		"lifecycle": "stable"
+	},
 	"scripts": {
 		"check": "biome check --vcs-use-ignore-file=false src test package.json tsconfig.json README.md && npm run typecheck",
 		"format": "biome check --write --vcs-use-ignore-file=false src test package.json tsconfig.json README.md",
@@ -38,15 +41,15 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.5.7",
-		"@earendil-works/pi-agent-core": "0.83.0",
-		"@earendil-works/pi-ai": "0.83.0",
-		"@earendil-works/pi-coding-agent": "0.83.0",
+		"@earendil-works/pi-agent-core": "0.84.1",
+		"@earendil-works/pi-ai": "0.84.1",
+		"@earendil-works/pi-coding-agent": "0.84.1",
 		"@types/node": "26.1.2",
 		"typescript": "7.0.2"
 	},
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/narumiruna/pi-extensions",
-		"directory": "experimental/pi-codex-compact"
+		"directory": "packages/pi-codex-compact"
 	}
 }

package/src/checkpoint.ts

@@ -123,6 +123,15 @@ export function latestCheckpoint(entries: readonly SessionEntry[]):
 	return undefined;
 }
 
+function isOlderCompactionSummary(message: AgentMessage, timestamp: number): boolean {
+	return (
+		message.role === "compactionSummary" &&
+		Number.isFinite(message.timestamp) &&
+		Number.isFinite(timestamp) &&
+		message.timestamp < timestamp
+	);
+}
+
 export function projectCheckpointContext(
 	messages: readonly AgentMessage[],
 	details: CodexCheckpointDetails,
@@ -132,21 +141,33 @@ export function projectCheckpointContext(
 		(message) => message.role === "compactionSummary" && message.summary === summary,
 	);
 	if (summaryIndex < 0) return undefined;
-	const keptStart = summaryIndex + 1;
-	const keptEnd = keptStart + details.keptMessageFingerprints.length;
-	if (keptEnd > messages.length) return undefined;
-	for (let index = keptStart; index < keptEnd; index++) {
-		if (
-			fingerprintMessage(messages[index]) !== details.keptMessageFingerprints[index - keptStart]
-		) {
-			return undefined;
+	const timestamp = messages[summaryIndex].timestamp;
+	let messageIndex = summaryIndex + 1;
+	let fingerprintIndex = 0;
+	while (fingerprintIndex < details.keptMessageFingerprints.length) {
+		if (messageIndex >= messages.length) return undefined;
+		const message = messages[messageIndex];
+		if (fingerprintMessage(message) === details.keptMessageFingerprints[fingerprintIndex]) {
+			messageIndex += 1;
+			fingerprintIndex += 1;
+			continue;
+		}
+		if (isOlderCompactionSummary(message, timestamp)) {
+			messageIndex += 1;
+			continue;
 		}
+		return undefined;
+	}
+	while (
+		messageIndex < messages.length &&
+		isOlderCompactionSummary(messages[messageIndex], timestamp)
+	) {
+		messageIndex += 1;
 	}
-	const timestamp = messages[summaryIndex].timestamp;
 	return [
 		...messages.slice(0, summaryIndex),
 		markerMessage(details.checkpointId, timestamp),
-		...messages.slice(keptEnd),
+		...messages.slice(messageIndex),
 	];
 }
 

package/src/codex-compact.ts

@@ -30,8 +30,6 @@ import {
 import { showCodexCompactMenu } from "./settings-menu.js";
 
 const STATUS_KEY = "codex-compact";
-const EXPERIMENTAL_WARNING =
-	"Experimental: Codex Remote Compaction V2 uses an opaque, provider-specific checkpoint. Sessions require this extension and openai-codex for full replay.";
 
 function isSupportedModel(model: Model<Api> | undefined): model is Model<"openai-codex-responses"> {
 	return model?.provider === "openai-codex" && hasApi(model, "openai-codex-responses");
@@ -186,7 +184,7 @@ export function createCodexCompactExtension(
 		let generation = 0;
 
 		pi.registerCommand("codex-compact", {
-			description: "Compact now or configure experimental Codex Remote Compaction V2",
+			description: "Compact now or configure Codex Remote Compaction V2",
 			handler: async (_args, ctx) => {
 				const ownerGeneration = generation;
 				await showCodexCompactMenu(settingsRuntime, ctx, {
@@ -223,14 +221,11 @@ export function createCodexCompactExtension(
 			) {
 				return;
 			}
-			if (ctx.hasUI) {
-				ctx.ui.notify(EXPERIMENTAL_WARNING, "warning");
-				if (state.kind === "invalid") {
-					ctx.ui.notify(
-						`Invalid pi-codex-compact.json; using defaults without overwriting it. ${state.issue}`,
-						"warning",
-					);
-				}
+			if (ctx.hasUI && state.kind === "invalid") {
+				ctx.ui.notify(
+					`Invalid pi-codex-compact.json; using defaults without overwriting it. ${state.issue}`,
+					"warning",
+				);
 			}
 		});