@narumitw/pi-codex-compact 0.50.1 → 0.51.0

package/README.md

@@ -1,30 +1,22 @@
-# 🗜️ pi-codex-compact — Remote Compaction V2 for Pi
+# 🗜️ pi-codex-compact — Use Codex Remote Compaction in Pi
 
 [![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)
 
-`@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
-that item in later OpenAI Codex Responses requests.
+Use Codex Remote Compaction V2 in Pi instead of generating a local plaintext summary for models that use the `openai-codex-responses` API.
 
-Pi remains responsible for deciding when compaction runs, including automatic thresholds, the
-built-in `/compact` command, overflow retries, retained-message selection, and append-only session
-publication. This package owns only the Remote V2 request, checkpoint persistence, and later payload
-replay.
+The extension requests and stores an opaque server-generated checkpoint, then safely replays it in later Codex Responses requests.
+
+Pi still decides when compaction runs and retains its normal `/compact`, threshold, overflow, and session-publication behavior.
 
 ## ✨ Features
 
-- Uses the active `openai-codex` OAuth credentials without persisting tokens or request headers.
-- Handles Pi's manual, threshold, and overflow compaction reasons through the same lifecycle hook.
-- Validates one bounded opaque `compaction` item from a completed Responses SSE stream.
-- Persists a versioned checkpoint in `CompactionEntry.details` and restores it after reload, resume,
-  or a fork that retains the checkpoint.
-- Replays the newest compatible checkpoint while preserving later conversation and extension-added
-  context.
-- Supports repeated compaction by carrying the previous opaque item into the next Remote V2 request.
-- Falls back to Pi's native plaintext compaction after authentication, transport, protocol, or
-  validation failure; user cancellation does not launch the fallback.
-- Provides `/codex-compact` for manual compaction, effective-route visibility, and bounded settings.
+- Uses the active Codex Responses provider and credentials without persisting secrets or request headers.
+- Handles manual, threshold, and overflow compaction through Pi's existing lifecycle.
+- Validates and persists one bounded opaque checkpoint that survives compatible reloads, resumes, and forks.
+- Replays the latest checkpoint while preserving newer conversation and extension context.
+- Supports repeated compaction by carrying the previous checkpoint into the next request.
+- Falls back to Pi's native plaintext compaction on non-cancellation failures.
+- Provides `/codex-compact` for route status, settings, and manual compaction.
 
 ## 📦 Install
 
@@ -43,32 +35,33 @@ pi -e npm:@narumitw/pi-codex-compact
 Try a local checkout from the repository root:
 
 ```bash
+npm --workspace @narumitw/pi-codex-compact run build
 pi -e ./packages/pi-codex-compact
-# or
-just try codex-compact
 ```
 
-Loading the package enables Remote V2 with safe defaults. Avoid loading a global npm installation
-and the local workspace at the same time.
+The package declares `dist/index.ts`, so an unbuilt local checkout must be built before Pi loads the package directory.
+Loading the package enables Remote V2 with safe defaults.
+Avoid loading a global npm installation and the local workspace at the same time.
 
 ## 🚀 Quick start
 
-1. Sign in through Pi's built-in OpenAI Codex OAuth provider.
-2. Select a model whose provider is `openai-codex` and API is `openai-codex-responses`.
-3. Work normally. Pi's automatic compaction and built-in `/compact` continue to operate.
+1. Sign in through Pi's built-in OpenAI Codex provider, or configure a custom provider that routes to a compatible Codex backend.
+2. Select a model whose API is `openai-codex-responses`.
+3. Work normally.
+   Pi's automatic compaction and built-in `/compact` continue to operate.
 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.
 
-When the active model is unsupported, compaction remains entirely Pi-native.
+When the active model uses another API, compaction remains entirely Pi-native.
 
-## 💬 Command
+## 💬 Commands
 
 ```text
 /codex-compact
 ```
 
-In TUI mode, the root menu shows whether Remote V2 is enabled, the active model, and whether a
-manual compact will use **Codex Remote V2** or **Pi native**. It contains:
+In TUI mode, the root menu shows whether Remote V2 is enabled, the active model, and whether a manual compact will use **Codex Remote V2** or **Pi native**.
+It contains:
 
 ```text
 Compact now
@@ -76,13 +69,12 @@ Settings
 Close
 ```
 
-**Compact now** closes the menu before asking Pi to compact the active session. Escape or Ctrl+C
-closes without compacting, and an obsolete menu cannot trigger work after session replacement or
-shutdown. **Settings** opens the bounded settings editor. In non-TUI modes, the command reports the
-manual settings path instead of opening custom UI or compacting.
+**Compact now** closes the menu before asking Pi to compact the active session.
+Escape or Ctrl+C closes without compacting, and an obsolete menu cannot trigger work after session replacement or shutdown.
+**Settings** opens the bounded settings editor.
+In non-TUI modes, the command reports the manual settings path instead of opening custom UI or compacting.
 
-Pi's built-in `/compact` remains available and follows the same extension hook when the active model
-is compatible.
+Pi's built-in `/compact` remains available and follows the same extension hook when the active model is compatible.
 
 ## ⚙️ Settings
 
@@ -92,8 +84,8 @@ The extension has one optional, global-only JSON settings file:
 <getAgentDir()>/pi-codex-compact.json
 ```
 
-The normal path is `~/.pi/agent/pi-codex-compact.json`. There is no environment-variable or
-project-level override.
+The normal path is `~/.pi/agent/pi-codex-compact.json`.
+There is no environment-variable or project-level override.
 
 ```json
 {
@@ -113,15 +105,14 @@ project-level override.
 | `replacementTokenBudget` | `64000` | Integer from 8,000 to 128,000 tokens | Bound approximate retained user-message text beside the opaque item. | Keep 64K; lower it to reduce session size or raise it only when recent user context is being lost. |
 | `notifyOnFallback` | `true` | Boolean | Warn when Remote V2 fails and Pi-native compaction takes over. | Keep enabled so silent fallback does not hide protocol or entitlement problems. |
 
-Missing fields use defaults. Settings reload on every `session_start`, including `/reload`, resume,
-and fork. Menu writes apply immediately, preserve unknown JSON fields, serialize within the current
-Pi process, and use a final conflict check plus same-directory atomic rename. On Unix, temporary
-files use mode `0600`.
+Missing fields use defaults.
+Settings reload on every `session_start`, including `/reload`, resume, and fork.
+Menu writes apply immediately, preserve unknown JSON fields, serialize within the current Pi process, and use a final conflict check plus same-directory atomic rename.
+On Unix, temporary files use mode `0600`.
 
-Malformed, invalid, oversized, or symlinked settings files are never overwritten. Safe defaults stay
-active, and the menu provides read-only repair guidance until the file is fixed and Pi is reloaded.
-Separate Pi processes do not share a mutation lock; a detected concurrent edit is rejected so the
-user can reopen Settings and retry.
+Malformed, invalid, oversized, or symlinked settings files are never overwritten.
+Safe defaults stay active, and the menu provides read-only repair guidance until the file is fixed and Pi is reloaded.
+Separate Pi processes do not share a mutation lock; a detected concurrent edit is rejected so the user can reopen Settings and retry.
 
 ### Relationship to Codex configuration
 
@@ -138,39 +129,35 @@ This extension does **not** read `~/.codex/config.toml`.
 ## ✅ Requirements and compatibility
 
 - Pi APIs compatible with the package's declared peer dependencies.
-- The built-in provider `openai-codex`.
 - API `openai-codex-responses` on the active model.
-- A working OpenAI Codex OAuth login and Remote V2 entitlement.
+- A built-in or custom provider that routes that API to a backend supporting `compaction_trigger` and opaque `compaction` replay.
+- Working credentials and Remote V2 entitlement for that backend.
 
-OpenAI API-key, Azure, GitHub Copilot, proxies, and arbitrary Responses-compatible providers are not
-supported. Switching to another provider or model leaves Pi's visible fallback marker plus retained
-recent messages in context. Switching back to the checkpoint's original compatible model restores
-opaque replay.
+The built-in `openai-codex` provider is supported, and a custom provider or proxy is eligible when its model explicitly uses `openai-codex-responses`.
+Generic `openai-responses`, `azure-openai-responses`, GitHub Copilot, and other merely Responses-compatible API labels are not eligible.
+The extension does not probe provider capabilities before compaction; a provider that declares `openai-codex-responses` owns compatible routing, authentication, request transforms, SSE transport, and opaque replay.
+A failed Remote V2 compaction attempt falls back to Pi native, but an ordinary request cannot transparently recover after an incompatible provider has already received an existing opaque checkpoint.
+Provider provenance is stored for diagnosis but is not a replay gate.
+Switching providers can replay a checkpoint only when the API and exact model ID still match; switching model IDs leaves Pi's visible fallback marker plus retained recent messages in context.
 
 ## 🔄 How it works
 
 1. Pi prepares compaction and selects the recent message suffix it will retain.
-2. The extension projects an earlier compatible checkpoint, if present, into the current Responses
-   input.
-3. It appends exactly one final `compaction_trigger` and sends a normal authenticated Codex Responses
-   SSE request with cache retention disabled.
+2. If an earlier compatible checkpoint is present, the extension identifies its boundary from the summary persisted on the active `CompactionEntry` and validates the retained suffix fingerprints.
+3. It projects that checkpoint into the current Responses input, appends exactly one final `compaction_trigger`, and sends a normal authenticated Codex Responses SSE request with cache retention disabled.
 4. It requires a completed response containing exactly one non-empty opaque `compaction` item.
-5. It constructs bounded replacement history from recent raw user-role Responses items followed by
-   the opaque item.
-6. It stores that history and fingerprints of Pi's retained suffix in versioned
-   `CompactionEntry.details`.
-7. On later compatible requests, it replaces an exactly validated marker with the persisted
-   replacement history immediately before provider dispatch.
+5. It constructs bounded replacement history from recent raw user-role Responses items followed by the opaque item.
+6. It stores that history and fingerprints of Pi's retained suffix in versioned `CompactionEntry.details`.
+7. On later compatible requests, it replaces an exactly validated marker with the persisted replacement history immediately before provider dispatch.
 
-If fingerprints, model identity, payload shape, or marker count do not match exactly, the extension
-leaves Pi's visible fallback context unchanged instead of guessing.
+The persisted entry remains the summary identity source, so replay does not depend on the wording generated by the currently installed extension version.
+If persisted summary identity, fingerprints, model identity, payload shape, or marker count do not match exactly, the extension leaves Pi's visible fallback context unchanged instead of guessing.
 
-## 🔐 Privacy, storage, and limits
+## 🔒 Security and privacy
 
-Remote compaction sends the active conversation context, system prompt, and active tool schemas to
-the same OpenAI Codex backend used by the selected model. The Pi session stores the encrypted
-compaction item and bounded recent user-role Responses items. It does not store OAuth tokens,
-authorization headers, or request headers in checkpoint details.
+Remote compaction sends the active conversation context, system prompt, and active tool schemas to the configured backend used by the selected Codex Responses provider.
+The Pi session stores the producing provider ID, encrypted compaction item, and bounded recent user-role Responses items.
+It does not store credentials, authorization headers, or request headers in checkpoint details.
 
 | Boundary | Limit |
 | --- | ---: |
@@ -182,22 +169,19 @@ authorization headers, or request headers in checkpoint details.
 | Transport retries | At most 2 |
 | Request timeout | At most 10 minutes |
 
-An individually oversized media item is dropped rather than making the session entry unbounded. The
-oldest fitting text item may be partially truncated to preserve newer context. These hard byte
-ceilings are intentionally not configurable.
+An individually oversized media item is dropped rather than making the session entry unbounded.
+The oldest fitting text item may be partially truncated to preserve newer context.
+These hard byte ceilings are intentionally not configurable.
 
-## 🚧 Known limitations
+## 🚧 Limitations
 
-- 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
-  compatibility fallback, exact pre-turn ordering, or exact mid-turn model-session ownership.
-- Remote failure falls back to Pi's plaintext summary, so a session can contain both remote opaque
-  and native compaction entries over time.
-- Settings concurrency is coordinated only within one Pi process; separate processes rely on the
-  final conflict check.
+- 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, the `openai-codex-responses` API, the exact checkpoint model ID, and a provider route whose backend accepts the opaque item.
+  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 compatibility fallback, exact pre-turn ordering, or exact mid-turn model-session ownership.
+- Remote failure falls back to Pi's plaintext summary, so a session can contain both remote opaque and native compaction entries over time.
+- Settings concurrency is coordinated only within one Pi process; separate processes rely on the final conflict check.
 
 ## 🗂️ Package layout
 
@@ -207,12 +191,38 @@ src/codex-compact.ts  Pi lifecycle, command, provider projection, and fallback
 src/remote.ts         Provider stream invocation, auth payload, timeout, and retry controls
 src/protocol.ts       Bounded SSE parsing and Remote V2 payload/output validation
 src/checkpoint.ts     Replacement history, fingerprints, persistence, and replay projection
+src/model-compatibility.ts  API-based Remote V2 model eligibility
 src/settings.ts       Global settings validation and atomic persistence
-src/settings-menu.ts  Manual compaction and settings TUI
+src/settings-menu.ts  First-use manual compaction and settings TUI
 
-test/                 Protocol, checkpoint, lifecycle, remote, settings, and menu coverage
+dist/                 Generated source-mapped Jiti runtime and lazy menu chunk
+scripts/              Runtime builder
+benchmark/            Three-arm compaction benchmark, self-test, and methodology
+test/                 Protocol, checkpoint, lifecycle, remote, settings, menu, and builder coverage
 ```
 
+## 📊 Benchmark
+
+The repository includes a seeded three-arm benchmark for uncompressed full context, Pi-native plaintext compaction, and this extension's Codex Remote Compaction V2 path.
+
+It holds history length nearly fixed while varying information density across five state categories and ten history epochs.
+
+Benchmark v3 uses repeated artifacts, isolated evaluator probes, seed-level paired statistics, one Pi SDK estimator for dry and live fixtures, and committed protocol manifests for confirmatory candidates.
+
+It never treats nominal Pi 20K and Codex 20K settings as equal information capacity or automatically claims that protocol-conformant evidence was genuinely held out.
+
+Preview its exploratory diagnostic without making a provider request:
+
+```bash
+just benchmark-codex-compact
+```
+
+A live run requires an explicit `--live` flag, reviewed request and cost exposure, OpenAI Codex OAuth, and Remote V2 entitlement.
+
+The repository preserves the explicitly labeled v2 matched-tail diagnostic and the v3 calibration evidence, while seeds 301–304 remain consumed and unavailable for future confirmatory protocols.
+
+See the [benchmark guide](https://github.com/narumiruna/pi-extensions/tree/main/packages/pi-codex-compact/benchmark) for manifests, repetitions, commands, privacy, cost semantics, and interpretation limits.
+
 ## 🧪 Development
 
 From the repository root:
@@ -223,14 +233,11 @@ npm test
 just pack codex-compact
 ```
 
-See
-[`docs/implementation-notes/codex-compaction-mechanism.md`](../../docs/implementation-notes/codex-compaction-mechanism.md)
-for the underlying Codex mechanism research and the extension boundary.
+See [`docs/implementation-notes/codex-compaction-mechanism.md`](../../docs/implementation-notes/codex-compaction-mechanism.md) for the underlying Codex mechanism research and the extension boundary.
 
 ## 🔎 Keywords
 
-Pi extension, Pi coding agent, OpenAI Codex, OAuth, Remote Compaction V2, opaque checkpoint,
-Responses API, context compaction.
+Pi extension, Pi coding agent, OpenAI Codex, custom provider, proxy, Remote Compaction V2, opaque checkpoint, Responses API, context compaction.
 
 ## 📄 License
 

package/dist/chunks/chunk-3WRPJHG2.ts

@@ -0,0 +1,13 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+
+// src/model-compatibility.ts
+import { hasApi } from "@earendil-works/pi-ai";
+function isCodexRemoteCompactionModel(model) {
+  return model !== void 0 && hasApi(model, "openai-codex-responses");
+}
+
+export {
+  isCodexRemoteCompactionModel
+};
+//# sourceMappingURL=chunk-3WRPJHG2.ts.map

package/dist/chunks/chunk-3WRPJHG2.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/model-compatibility.ts"],
+  "sourcesContent": ["import type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { hasApi } from \"@earendil-works/pi-ai\";\n\nexport function isCodexRemoteCompactionModel(\n\tmodel: Model<Api> | undefined,\n): model is Model<\"openai-codex-responses\"> {\n\treturn model !== undefined && hasApi(model, \"openai-codex-responses\");\n}\n"],
+  "mappings": ";;;;AACA,SAAS,cAAc;AAEhB,SAAS,6BACf,OAC2C;AAC3C,SAAO,UAAU,UAAa,OAAO,OAAO,wBAAwB;AACrE;",
+  "names": []
+}

package/dist/chunks/settings-menu-4YW2GOKW.ts

@@ -0,0 +1,191 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+import {
+  isCodexRemoteCompactionModel
+} from "./chunk-3WRPJHG2.js";
+
+// src/settings-menu.ts
+function safeText(value) {
+  return Array.from(value, (character) => {
+    const codePoint = character.codePointAt(0) ?? 0;
+    return codePoint < 32 || codePoint >= 127 && codePoint <= 159 ? " " : character;
+  }).join("");
+}
+function timeoutLabel(milliseconds) {
+  return `${milliseconds / 6e4} min`;
+}
+function retentionLabel(tokens) {
+  return `${tokens / 1e3}K tokens`;
+}
+async function update(runtime, ctx, patch, signal) {
+  try {
+    await runtime.update(patch, signal);
+    ctx.ui.notify("Codex compaction settings saved.", "info");
+    return { kind: "stay" };
+  } catch (error) {
+    if (signal.aborted) return { kind: "rejected" };
+    ctx.ui.notify(
+      `Could not save pi-codex-compact.json: ${safeText(error instanceof Error ? error.message : String(error))}`,
+      "error"
+    );
+    return { kind: "rejected" };
+  }
+}
+function createCodexCompactMenu(runtime, options = {}) {
+  return {
+    start: "main",
+    screens: {
+      main: ({ state }) => ({
+        kind: "actions",
+        title: "Codex Remote Compaction",
+        lines: [
+          `Remote V2: ${state.settings.enabled ? "On" : "Off"}`,
+          `Active model: ${safeText(options.status?.model ?? "none")}`,
+          `Compact route: ${safeText(compactRoute(state, options.status))}`
+        ],
+        items: [
+          {
+            id: "compact-now",
+            label: "Compact now",
+            description: "Close this menu and compact the active session immediately.",
+            action: "compact-now"
+          },
+          state.kind === "invalid" ? {
+            id: "settings",
+            label: "Settings",
+            description: "Read-only until the invalid settings file is repaired.",
+            to: "invalid"
+          } : { id: "settings", label: "Settings", to: "settings" },
+          { id: "close", label: "Close", close: true }
+        ],
+        hint: "close"
+      }),
+      settings: ({ state }) => ({
+        kind: "settings",
+        title: "Codex Remote Compaction Settings",
+        lines: [`User settings \xB7 ${safeText(state.path)}`],
+        items: [
+          {
+            id: "enabled",
+            label: "Remote compaction",
+            description: "Use Codex Remote V2 when the active model is compatible.",
+            currentValue: state.settings.enabled ? "On" : "Off",
+            values: ["On", "Off"],
+            action: "set-enabled"
+          },
+          {
+            id: "requestTimeoutMs",
+            label: "Request timeout",
+            description: "Maximum time for the extension-owned remote compaction request.",
+            currentValue: timeoutLabel(state.settings.requestTimeoutMs),
+            values: ["2 min", "5 min", "10 min"],
+            action: "set-timeout"
+          },
+          {
+            id: "maxRetries",
+            label: "Transport retries",
+            description: "Retry transient provider failures before falling back to Pi.",
+            currentValue: String(state.settings.maxRetries),
+            values: ["0", "1", "2"],
+            action: "set-retries"
+          },
+          {
+            id: "replacementTokenBudget",
+            label: "Retained user history",
+            description: "Approximate user-message budget kept beside the opaque checkpoint.",
+            currentValue: retentionLabel(state.settings.replacementTokenBudget),
+            values: ["32K tokens", "64K tokens", "96K tokens", "128K tokens"],
+            action: "set-retention"
+          },
+          {
+            id: "notifyOnFallback",
+            label: "Fallback notifications",
+            description: "Warn when Remote V2 fails and native Pi compaction takes over.",
+            currentValue: state.settings.notifyOnFallback ? "On" : "Off",
+            values: ["On", "Off"],
+            action: "set-notify"
+          }
+        ]
+      }),
+      invalid: ({ state }) => ({
+        kind: "detail",
+        title: "Codex Compact Settings \xB7 Read only",
+        lines: [
+          `Invalid settings file: ${safeText(state.path)}`,
+          `Issue: ${safeText(state.issue ?? "unknown validation error")}`,
+          "Built-in defaults are active. Repair the file and run /reload; it will not be overwritten."
+        ],
+        hint: "back"
+      })
+    },
+    actions: {
+      "compact-now": async () => {
+        options.onCompactRequested?.();
+        return { kind: "close" };
+      },
+      "set-enabled": ({ ctx, value, signal }) => update(runtime, ctx, { enabled: value === "On" }, signal),
+      "set-timeout": ({ ctx, value, signal }) => update(
+        runtime,
+        ctx,
+        { requestTimeoutMs: Number.parseInt(value ?? "5", 10) * 6e4 },
+        signal
+      ),
+      "set-retries": ({ ctx, value, signal }) => update(runtime, ctx, { maxRetries: Number.parseInt(value ?? "2", 10) }, signal),
+      "set-retention": ({ ctx, value, signal }) => update(
+        runtime,
+        ctx,
+        { replacementTokenBudget: Number.parseInt(value ?? "64", 10) * 1e3 },
+        signal
+      ),
+      "set-notify": ({ ctx, value, signal }) => update(runtime, ctx, { notifyOnFallback: value === "On" }, signal)
+    }
+  };
+}
+async function showCodexCompactMenu(runtime, ctx, owner) {
+  if (ctx.mode !== "tui") {
+    ctx.ui.notify(`Edit Codex compaction settings at ${safeText(runtime.get().path)}.`, "info");
+    return;
+  }
+  const { runMenu } = await import("@narumitw/pi-tui-kit");
+  if (owner.signal.aborted || !owner.isCurrent()) return;
+  let compactRequested = false;
+  await runMenu(
+    ctx,
+    createCodexCompactMenu(runtime, {
+      onCompactRequested: () => {
+        compactRequested = true;
+      },
+      status: compactMenuStatus(ctx)
+    }),
+    {
+      getState: () => runtime.get(),
+      signal: owner.signal,
+      isCurrent: owner.isCurrent
+    }
+  );
+  if (!compactRequested || owner.signal.aborted || !owner.isCurrent()) return;
+  ctx.compact({
+    onError: (error) => {
+      if (!owner.signal.aborted && owner.isCurrent()) {
+        ctx.ui.notify(`Compaction failed: ${safeText(error.message)}`, "error");
+      }
+    }
+  });
+}
+function compactMenuStatus(ctx) {
+  const model = ctx.model;
+  return {
+    model: model ? `${model.provider}/${model.id}` : "none",
+    remoteCompatible: isCodexRemoteCompactionModel(model)
+  };
+}
+function compactRoute(state, status) {
+  if (!state.settings.enabled) return "Pi native (Remote V2 off)";
+  return status?.remoteCompatible ? "Codex Remote V2" : "Pi native (model not compatible)";
+}
+export {
+  compactMenuStatus,
+  createCodexCompactMenu,
+  showCodexCompactMenu
+};
+//# sourceMappingURL=settings-menu-4YW2GOKW.ts.map

package/dist/chunks/settings-menu-4YW2GOKW.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/settings-menu.ts"],
+  "sourcesContent": ["import type { ExtensionCommandContext } from \"@earendil-works/pi-coding-agent\";\nimport type { MenuDefinition } from \"@narumitw/pi-tui-kit\";\nimport { isCodexRemoteCompactionModel } from \"./model-compatibility.js\";\nimport type {\n\tCodexCompactSettings,\n\tCodexCompactSettingsRuntime,\n\tCodexCompactSettingsState,\n} from \"./settings.js\";\n\ntype Screen = \"main\" | \"settings\" | \"invalid\";\ntype Action =\n\t| \"compact-now\"\n\t| \"set-enabled\"\n\t| \"set-timeout\"\n\t| \"set-retries\"\n\t| \"set-retention\"\n\t| \"set-notify\";\n\nexport interface SettingsMenuOwner {\n\tsignal: AbortSignal;\n\tisCurrent(): boolean;\n}\n\ninterface CompactMenuStatus {\n\tmodel: string;\n\tremoteCompatible: boolean;\n}\n\nfunction safeText(value: string): string {\n\treturn Array.from(value, (character) => {\n\t\tconst codePoint = character.codePointAt(0) ?? 0;\n\t\treturn codePoint < 32 || (codePoint >= 127 && codePoint <= 159) ? \" \" : character;\n\t}).join(\"\");\n}\n\nfunction timeoutLabel(milliseconds: number): string {\n\treturn `${milliseconds / 60_000} min`;\n}\n\nfunction retentionLabel(tokens: number): string {\n\treturn `${tokens / 1000}K tokens`;\n}\n\nasync function update(\n\truntime: CodexCompactSettingsRuntime,\n\tctx: ExtensionCommandContext,\n\tpatch: Partial<CodexCompactSettings>,\n\tsignal: AbortSignal,\n) {\n\ttry {\n\t\tawait runtime.update(patch, signal);\n\t\tctx.ui.notify(\"Codex compaction settings saved.\", \"info\");\n\t\treturn { kind: \"stay\" as const };\n\t} catch (error) {\n\t\tif (signal.aborted) return { kind: \"rejected\" as const };\n\t\tctx.ui.notify(\n\t\t\t`Could not save pi-codex-compact.json: ${safeText(error instanceof Error ? error.message : String(error))}`,\n\t\t\t\"error\",\n\t\t);\n\t\treturn { kind: \"rejected\" as const };\n\t}\n}\n\nexport function createCodexCompactMenu(\n\truntime: CodexCompactSettingsRuntime,\n\toptions: { onCompactRequested?: () => void; status?: CompactMenuStatus } = {},\n): MenuDefinition<CodexCompactSettingsState, Screen, Action, ExtensionCommandContext> {\n\treturn {\n\t\tstart: \"main\",\n\t\tscreens: {\n\t\t\tmain: ({ state }) => ({\n\t\t\t\tkind: \"actions\",\n\t\t\t\ttitle: \"Codex Remote Compaction\",\n\t\t\t\tlines: [\n\t\t\t\t\t`Remote V2: ${state.settings.enabled ? \"On\" : \"Off\"}`,\n\t\t\t\t\t`Active model: ${safeText(options.status?.model ?? \"none\")}`,\n\t\t\t\t\t`Compact route: ${safeText(compactRoute(state, options.status))}`,\n\t\t\t\t],\n\t\t\t\titems: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"compact-now\",\n\t\t\t\t\t\tlabel: \"Compact now\",\n\t\t\t\t\t\tdescription: \"Close this menu and compact the active session immediately.\",\n\t\t\t\t\t\taction: \"compact-now\",\n\t\t\t\t\t},\n\t\t\t\t\tstate.kind === \"invalid\"\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\tid: \"settings\",\n\t\t\t\t\t\t\t\tlabel: \"Settings\",\n\t\t\t\t\t\t\t\tdescription: \"Read-only until the invalid settings file is repaired.\",\n\t\t\t\t\t\t\t\tto: \"invalid\" as const,\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: { id: \"settings\", label: \"Settings\", to: \"settings\" as const },\n\t\t\t\t\t{ id: \"close\", label: \"Close\", close: true },\n\t\t\t\t],\n\t\t\t\thint: \"close\",\n\t\t\t}),\n\t\t\tsettings: ({ state }) => ({\n\t\t\t\tkind: \"settings\",\n\t\t\t\ttitle: \"Codex Remote Compaction Settings\",\n\t\t\t\tlines: [`User settings \u00B7 ${safeText(state.path)}`],\n\t\t\t\titems: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"enabled\",\n\t\t\t\t\t\tlabel: \"Remote compaction\",\n\t\t\t\t\t\tdescription: \"Use Codex Remote V2 when the active model is compatible.\",\n\t\t\t\t\t\tcurrentValue: state.settings.enabled ? \"On\" : \"Off\",\n\t\t\t\t\t\tvalues: [\"On\", \"Off\"],\n\t\t\t\t\t\taction: \"set-enabled\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"requestTimeoutMs\",\n\t\t\t\t\t\tlabel: \"Request timeout\",\n\t\t\t\t\t\tdescription: \"Maximum time for the extension-owned remote compaction request.\",\n\t\t\t\t\t\tcurrentValue: timeoutLabel(state.settings.requestTimeoutMs),\n\t\t\t\t\t\tvalues: [\"2 min\", \"5 min\", \"10 min\"],\n\t\t\t\t\t\taction: \"set-timeout\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"maxRetries\",\n\t\t\t\t\t\tlabel: \"Transport retries\",\n\t\t\t\t\t\tdescription: \"Retry transient provider failures before falling back to Pi.\",\n\t\t\t\t\t\tcurrentValue: String(state.settings.maxRetries),\n\t\t\t\t\t\tvalues: [\"0\", \"1\", \"2\"],\n\t\t\t\t\t\taction: \"set-retries\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"replacementTokenBudget\",\n\t\t\t\t\t\tlabel: \"Retained user history\",\n\t\t\t\t\t\tdescription: \"Approximate user-message budget kept beside the opaque checkpoint.\",\n\t\t\t\t\t\tcurrentValue: retentionLabel(state.settings.replacementTokenBudget),\n\t\t\t\t\t\tvalues: [\"32K tokens\", \"64K tokens\", \"96K tokens\", \"128K tokens\"],\n\t\t\t\t\t\taction: \"set-retention\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"notifyOnFallback\",\n\t\t\t\t\t\tlabel: \"Fallback notifications\",\n\t\t\t\t\t\tdescription: \"Warn when Remote V2 fails and native Pi compaction takes over.\",\n\t\t\t\t\t\tcurrentValue: state.settings.notifyOnFallback ? \"On\" : \"Off\",\n\t\t\t\t\t\tvalues: [\"On\", \"Off\"],\n\t\t\t\t\t\taction: \"set-notify\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t}),\n\t\t\tinvalid: ({ state }) => ({\n\t\t\t\tkind: \"detail\",\n\t\t\t\ttitle: \"Codex Compact Settings \u00B7 Read only\",\n\t\t\t\tlines: [\n\t\t\t\t\t`Invalid settings file: ${safeText(state.path)}`,\n\t\t\t\t\t`Issue: ${safeText(state.issue ?? \"unknown validation error\")}`,\n\t\t\t\t\t\"Built-in defaults are active. Repair the file and run /reload; it will not be overwritten.\",\n\t\t\t\t],\n\t\t\t\thint: \"back\",\n\t\t\t}),\n\t\t},\n\t\tactions: {\n\t\t\t\"compact-now\": async () => {\n\t\t\t\toptions.onCompactRequested?.();\n\t\t\t\treturn { kind: \"close\" };\n\t\t\t},\n\t\t\t\"set-enabled\": ({ ctx, value, signal }) =>\n\t\t\t\tupdate(runtime, ctx, { enabled: value === \"On\" }, signal),\n\t\t\t\"set-timeout\": ({ ctx, value, signal }) =>\n\t\t\t\tupdate(\n\t\t\t\t\truntime,\n\t\t\t\t\tctx,\n\t\t\t\t\t{ requestTimeoutMs: Number.parseInt(value ?? \"5\", 10) * 60_000 },\n\t\t\t\t\tsignal,\n\t\t\t\t),\n\t\t\t\"set-retries\": ({ ctx, value, signal }) =>\n\t\t\t\tupdate(runtime, ctx, { maxRetries: Number.parseInt(value ?? \"2\", 10) }, signal),\n\t\t\t\"set-retention\": ({ ctx, value, signal }) =>\n\t\t\t\tupdate(\n\t\t\t\t\truntime,\n\t\t\t\t\tctx,\n\t\t\t\t\t{ replacementTokenBudget: Number.parseInt(value ?? \"64\", 10) * 1000 },\n\t\t\t\t\tsignal,\n\t\t\t\t),\n\t\t\t\"set-notify\": ({ ctx, value, signal }) =>\n\t\t\t\tupdate(runtime, ctx, { notifyOnFallback: value === \"On\" }, signal),\n\t\t},\n\t};\n}\n\nexport async function showCodexCompactMenu(\n\truntime: CodexCompactSettingsRuntime,\n\tctx: ExtensionCommandContext,\n\towner: SettingsMenuOwner,\n): Promise<void> {\n\tif (ctx.mode !== \"tui\") {\n\t\tctx.ui.notify(`Edit Codex compaction settings at ${safeText(runtime.get().path)}.`, \"info\");\n\t\treturn;\n\t}\n\tconst { runMenu } = await import(\"@narumitw/pi-tui-kit\");\n\tif (owner.signal.aborted || !owner.isCurrent()) return;\n\tlet compactRequested = false;\n\tawait runMenu(\n\t\tctx,\n\t\tcreateCodexCompactMenu(runtime, {\n\t\t\tonCompactRequested: () => {\n\t\t\t\tcompactRequested = true;\n\t\t\t},\n\t\t\tstatus: compactMenuStatus(ctx),\n\t\t}),\n\t\t{\n\t\t\tgetState: () => runtime.get(),\n\t\t\tsignal: owner.signal,\n\t\t\tisCurrent: owner.isCurrent,\n\t\t},\n\t);\n\tif (!compactRequested || owner.signal.aborted || !owner.isCurrent()) return;\n\tctx.compact({\n\t\tonError: (error) => {\n\t\t\tif (!owner.signal.aborted && owner.isCurrent()) {\n\t\t\t\tctx.ui.notify(`Compaction failed: ${safeText(error.message)}`, \"error\");\n\t\t\t}\n\t\t},\n\t});\n}\n\nexport function compactMenuStatus(ctx: ExtensionCommandContext): CompactMenuStatus {\n\tconst model = ctx.model;\n\treturn {\n\t\tmodel: model ? `${model.provider}/${model.id}` : \"none\",\n\t\tremoteCompatible: isCodexRemoteCompactionModel(model),\n\t};\n}\n\nfunction compactRoute(\n\tstate: Readonly<CodexCompactSettingsState>,\n\tstatus: CompactMenuStatus | undefined,\n): string {\n\tif (!state.settings.enabled) return \"Pi native (Remote V2 off)\";\n\treturn status?.remoteCompatible ? \"Codex Remote V2\" : \"Pi native (model not compatible)\";\n}\n"],
+  "mappings": "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",
+  "names": []
+}