pi-cache-optimizer 2.8.17 → 2.8.18

package/README.md

@@ -110,6 +110,8 @@ Persistent feature settings are managed under the Pi agent directory by the nati
 /cache-optimizer config reset
 ```
 
+`openai-codex-responses` keeps Pi's native skill index even when skill compression is enabled. Real task-level benchmarks with `openai-codex/gpt-6-luna` showed that the shorter Markdown skill index could increase the model's tool-call trajectory and total task cost; Codex therefore keeps the native Pi XML skill list while still benefiting from the optimizer's other cache/runtime features.
+
 `config reset` reads the latest disk configuration under the shared transaction lock and removes only persistent feature overrides, preserving the latest footer mode, model-specific prompt-cache-key settings, and file permissions. Invalid JSON/schema, symlinks, non-regular targets, and concurrent manual changes are refused rather than overwritten. These commands do not modify shell startup files or `PI_CACHE_RETENTION`; `enable` and `disable` remain current-process runtime switches.
 
 ## Opt-in deterministic tool ordering

package/README.zh-CN.md

@@ -110,6 +110,8 @@ Doctor 显示的 endpoint URL 会移除用户名/密码、查询参数和 fragme
 /cache-optimizer config reset
 ```
 
+对于 `openai-codex-responses`，即使开启 skill compression，也会保留 Pi 原生 skill index。真实 `openai-codex/gpt-6-luna` 任务级 benchmark 表明，较短的 Markdown skill index 虽然减少了单次 prompt，但可能增加模型的工具调用轨迹和最终任务总成本；因此 Codex 保留 Pi 原生 XML skill 列表，同时继续使用本扩展的其他缓存与运行时优化。
+
 `config reset` 在共享事务锁内读取最新磁盘配置，只移除持久化 feature 覆盖，保留最新 footer mode、按模型配置的 prompt-cache-key 设置和文件权限。JSON/schema 无效、symlink、非普通文件或并发手动修改时会拒绝覆盖。这些命令不会修改 shell 启动文件或 `PI_CACHE_RETENTION`；`enable` 和 `disable` 仍然是当前进程的运行时开关。
 
 ## Opt-in 确定性工具排序

package/index.ts

@@ -1072,9 +1072,16 @@ export default function (pi: ExtensionAPI) {
       return {};
     }
 
+    // OpenAI Codex/Responses is unusually sensitive to skill-index shape: real
+    // TourStory task benchmarks showed the compressed Markdown index could
+    // lengthen the Pi tool trajectory enough to increase total task cost even
+    // though each request became shorter. Keep Pi's native skill block for the
+    // Codex transport; other providers retain the compression optimization.
+    const codexSkillCompressionBypass = model?.api === "openai-codex-responses";
+
     // Skill compression first, as a section edit when Pi supports it (see
     // compressSkillsViaSection); the string path below is the fallback.
-    const skillsViaSection = compressSkillsViaSection(event);
+    const skillsViaSection = codexSkillCompressionBypass ? false : compressSkillsViaSection(event);
 
     // Strip per-turn churn from <session-overview>.
     // Removing RECENT COMMITS, Working directory status, and
@@ -1088,14 +1095,18 @@ export default function (pi: ExtensionAPI) {
     // (Pi < 0.86, or a forced prompt from an earlier handler). Deterministic from the same `event.systemPromptOptions.skills`,
     // so cache stability is unchanged. No-op if opted out, below
     // SKILL_COMPRESSION_MIN_COUNT, or if pi emitted a format we don't recognize.
-    const compressedPrompt = compressSkillsInSystemPrompt(
-      strippedPrompt,
-      event.systemPromptOptions,
-    );
+    const compressedPrompt = codexSkillCompressionBypass
+      ? strippedPrompt
+      : compressSkillsInSystemPrompt(
+          strippedPrompt,
+          event.systemPromptOptions,
+        );
     // With a section edit and nothing to strip, Pi renders the compressed prompt
     // itself and no forced prompt is returned.
     recordSkillCompressionOutcome(
-      skillsViaSection
+      codexSkillCompressionBypass
+        ? { applied: false, reason: "OpenAI Codex uses Pi's native skill index to preserve task trajectory", visibleSkills, at: Date.now() }
+        : skillsViaSection
         ? { applied: "section", visibleSkills, at: Date.now() }
         : compressedPrompt !== strippedPrompt
           ? { applied: "string", visibleSkills, at: Date.now() }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cache-optimizer",
-  "version": "2.8.17",
+  "version": "2.8.18",
   "description": "Improve Pi prompt/KV cache hit rates with stable prompts, OpenAI-compatible cache keys, proxy compat warnings, and footer cache stats.",
   "keywords": [
     "pi-package",