pi-openai-codex-compat 0.0.10 → 0.0.11

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.0.11 - 2026-09-20
+
+### Fixed
+
+- Report missing Pi transcript APIs when loading the extension instead of
+  failing on the first request.
+
 ## 0.0.10 - 2026-09-20
 
 ### Added

package/README.md

@@ -25,6 +25,11 @@ Pi provides the Codex OAuth flow and model catalog. At session start, this packa
 - Pi `>=0.86.0 <0.87.0`
 - An OpenAI Codex login in Pi
 
+Restart Pi after upgrading its runtime. `/reload` reloads extensions but cannot
+upgrade the running Pi process. The extension checks the host's transcript APIs
+at load time. `PI_PACKAGE_DIR` can point an older executable at newer package
+metadata, so its displayed version alone does not establish compatibility.
+
 Authenticate through Pi if needed:
 
 ```text
@@ -581,6 +586,11 @@ mise run test:live:codex
 
 The task obtains the local Codex bearer token and runs the tests with
 `gpt-5.6-luna` at medium reasoning effort.
+It also packs the extension and loads that archive through the shipped Pi
+0.86.0 CLI. Ordinary Responses and Responses Lite tests exercise tool calls,
+prompt reload, native compaction, and persisted-session resume against Codex.
+Test credentials stay in memory and child-process environments. Test sessions
+and configuration are isolated from the user's agent directory.
 
 The public package entrypoint is `extensions/index.ts`; implementation modules remain under
 `extensions/openai-codex-compat/`. The focused Pi AI serializer copy lives under
@@ -593,7 +603,7 @@ search, and compaction continuation.
 ## Release staging
 
 1. Run `npm run release -- X.Y.Z` from a clean, synchronized `main`.
-2. The command builds the exact package locally, records its SHA-256 in an SSH-signed release commit, proves a clean rebuild is reproducible, and creates a lightweight tag.
+2. The command builds the exact package locally and runs live CLI tests against that archive. It also runs the existing live SDK tests against checkout source. Both suites must pass before it records the archive's SHA-256 in an SSH-signed release commit, proves a clean rebuild is reproducible, and creates a lightweight tag. Missing credentials or failing live tests stop the release.
 3. Inspect the result, then push atomically with `git push --atomic origin main vX.Y.Z`.
 4. A read-only GitHub Actions job validates and packs the package. After approval in the tag-restricted `npm-publish` environment, a separate GitHub-owned job verifies the signature and signed digest before attesting and staging that exact archive through npm trusted publishing.
 5. Approve the staged package on npmjs.com, or with `npm stage approve <stage-id>`.

package/extensions/openai-codex-compat/index.ts

@@ -1,4 +1,6 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import * as piAi from "@earendil-works/pi-ai";
+import { requirePiTranscriptRuntime } from "./pi-runtime.ts";
 import { DEFAULT_CONFIG, loadConfig, type CodexCompatConfig } from "./config.ts";
 import type { ConfigContext } from "./config-context.ts";
 import { registerCodexProvider } from "./codex-provider.ts";
@@ -21,6 +23,7 @@ export {
 } from "./codex-transport.ts";
 
 export default function registerOpenAICodexCompat(pi: ExtensionAPI): void {
+  requirePiTranscriptRuntime(piAi);
   let activeConfig: CodexCompatConfig | undefined;
   const resolveConfig = (ctx: ConfigContext): CodexCompatConfig => {
     activeConfig ??= loadConfig(ctx.cwd, ctx.isProjectTrusted());

package/extensions/openai-codex-compat/pi-runtime.ts

@@ -0,0 +1,20 @@
+const TRANSCRIPT_APIS = [
+  "normalizeContext",
+  "getCurrentSystemPrompt",
+  "getDeclaredTools",
+  "getInitialSystemMessage",
+  "resolveTranscriptTools",
+] as const;
+
+/** Check the loaded host, not package metadata that PI_PACKAGE_DIR can override. */
+export function requirePiTranscriptRuntime(api: Record<string, unknown>): void {
+  const missing = TRANSCRIPT_APIS.filter((name) => typeof api[name] !== "function");
+  if (missing.length > 0) {
+    throw new Error(
+      "pi-openai-codex-compat requires a running Pi 0.86.x runtime. " +
+        `Missing host APIs: ${missing.join(", ")}. ` +
+        "Exit Pi and start Pi 0.86.x after updating. /reload cannot upgrade the running " +
+        "runtime, and PI_PACKAGE_DIR can make an older executable report a newer version.",
+    );
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-openai-codex-compat",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "OpenAI Codex compatibility for Pi with native compaction, fast mode, and Codex-optimized capabilities",
   "keywords": [
     "pi-package"
@@ -36,7 +36,7 @@
   "scripts": {
     "check": "hk check --all --check",
     "test": "node --test --test-concurrency=4 test/*.test.ts",
-    "test:live:codex": "PI_CODEX_LIVE_TEST=1 node --test --test-concurrency=1 test/codex-host.live.test.ts",
+    "test:live:codex": "PI_CODEX_LIVE_TEST=1 node --test --test-concurrency=1 test/codex-host.live.test.ts test/codex-cli.live.test.ts",
     "pack:dry": "npm pack --dry-run --allow-directory=all",
     "release": "node scripts/release.ts",
     "fmt": "oxfmt",