@minhspark/codex-mcp-bridge 1.22.19 → 1.22.21

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-mcp-bridge",
-  "version": "1.22.19",
+  "version": "1.22.21",
   "description": "Connect ChatGPT to your own Codex Desktop projects and conversations.",
   "author": {
     "name": "Bui Dang Minh"

package/CHANGELOG.md

@@ -4,6 +4,38 @@ Follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [SemVer](ht
 
 ## [Unreleased]
 
+## [1.22.21] - 2026-10-26
+
+### Fixed
+
+- Recognize native Claude background-task completion notifications stored as inline attachments. A completed command could otherwise remain outstanding, hiding the final reply and blocking later messages with `PEER_REPLY_PENDING`. Both notification formats retain native-origin, exact task/tool-call identity and transcript ancestry checks; observing the original reply never resends its action.
+- Resolve Claude reply ancestry when a final response is persisted before its parent attachment. Process unambiguous records with ancestors first, reject cycles, and preserve input boundaries and pending ownership until the required parent arrives.
+
+### Verification
+
+- Three focused regressions fail against 1.22.20 and pass with this fix: inline completion, child-before-parent ancestry, and pending ownership recovery without repeating the original action.
+- Independent parser checks cover 1,320 record-order and invalid-notification combinations. Endpoint tests verify that missing parents keep ownership pending and that a distinct follow-up is allowed only after the original reply resolves.
+
+### Limitations
+
+- Missing or ambiguous transcript ancestry still cannot establish a reply. Inspect the existing task instead of resending its original action. An already blocked older runtime may need a client restart after upgrading to load this fix.
+
+## [1.22.20] - 2026-10-24
+
+### Fixed
+
+- A Claude Desktop target no longer stays blocked for good when another sender's peer message lands in a reply chain that is waiting on a background task. Reply observation used to drop that message and everything after it, so the delivery never resolved, every later send to that session failed with `PEER_REPLY_PENDING`, and reload stayed refused until Codex Desktop restarted. A peer message for a different message id now ends observation the same way human input does: the delivery is reported as interrupted, the task outcome stays unknown, and it is not marked safe to retry.
+- Peer interruption requires a nonblank string message id distinct from the tracked request. Missing, blank, non-string and matching ids cannot release pending ownership. Existing transcript ancestry, ambiguity and open-branch checks remain in force.
+
+### Tests
+
+- Transcript regressions cover a background wait interrupted by another peer, malformed peer ids, unrelated ancestry, incomplete or duplicate records, and unresolved sibling branches.
+- Endpoint regressions verify late interruption after a timeout, pending-send and reload recovery, retained interruption receipts across reload, and a separately requested follow-up without resending the original action.
+
+### Limitations
+
+- Interruption ends reply observation only. Background work may still be running; inspect the existing task before issuing a follow-up. The original action is never marked safe to retry.
+
 ## [1.22.19] - 2026-10-22
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minhspark/codex-mcp-bridge",
-  "version": "1.22.19",
+  "version": "1.22.21",
   "description": "Two-way MCP bridge between Claude and Codex: prompts into a live Codex thread, messages into a running Claude Code session.",
   "keywords": [
     "mcp",
@@ -83,6 +83,6 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.1",
-    "zod": "^3.25.76"
+    "zod": "^4.6.7"
   }
 }

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "codex-mcp-bridge",
-  "version": "1.22.19",
+  "version": "1.22.21",
   "description": "Connect ChatGPT to your own Codex Desktop projects and conversations.",
   "author": {
     "name": "Bui Dang Minh",

package/scripts/install-native-relay.mjs

@@ -25,7 +25,7 @@ import { removeRelayFile } from "../src/native-relay-files.mjs";
 
 exitForVersionRequest(import.meta.url);
 
-const VERSION = "1.22.19";
+const VERSION = "1.22.21";
 const root = stableInstallPath(path.resolve(path.dirname(fileURLToPath(import.meta.url)), ".."));
 const entry = path.join(root, "src", "mcp-supervisor.mjs");
 const entryArgs = ["native-relay-companion.mjs"];

package/src/claude-bridge.mjs

@@ -30,7 +30,7 @@ import { discoverClaudeProject } from "./claude-project-discovery.mjs";
 
 exitForVersionRequest(import.meta.url);
 
-const VERSION = "1.22.19";
+const VERSION = "1.22.21";
 void import("./telemetry.mjs").then(({ startUsageReporting }) => startUsageReporting({ version: VERSION })).catch(() => {});
 const FORWARD_MIN_INTERVAL_MS = 5000;
 const FORWARD_MAX_PER_SESSION = 50;

package/src/index.mjs

@@ -41,7 +41,7 @@ import { createRelayWake, relayKeeperEnabled, relayWakeStateFile, startRelayKeep
 
 exitForVersionRequest(import.meta.url);
 
-const VERSION = "1.22.19";
+const VERSION = "1.22.21";
 void import("./telemetry.mjs").then(({ startUsageReporting }) => startUsageReporting({ version: VERSION })).catch(() => {});
 const log = (msg) => process.stderr.write(`[codex-mcp-bridge] ${msg}\n`);
 

package/src/native-relay-companion.mjs

@@ -40,7 +40,7 @@ import { NativeCreationReceipts, creationIdValid } from "./native-creation-recei
 
 exitForVersionRequest(import.meta.url);
 
-const VERSION = "1.22.19";
+const VERSION = "1.22.21";
 const log = (msg) => process.stderr.write(`[native-relay] ${msg}\n`);
 
 function errorResponse(code, message, sent, details) {

package/src/peer-protocol.mjs

@@ -367,6 +367,12 @@ function injectedMessageRoot(entry, msgId) {
   return null;
 }
 
+function isOtherPeerInput(entry, msgId) {
+  const origin = entry.origin;
+  return origin?.kind === "peer" && typeof origin.msg_id === "string"
+    && origin.msg_id.trim().length > 0 && origin.msg_id !== msgId;
+}
+
 function isInterruptedDelivery(receipt) {
   return receipt?.status === "interrupted" && receipt.source === "transcript"
     && receipt.reasonCode === "CLAUDE_REPLY_INTERRUPTED"
@@ -480,6 +486,28 @@ export function readTranscriptOutcome(sessionId, cwd, msgId) {
   if (roots.length !== 1) return null;
   const { entry: root, absorbed } = roots[0];
   const entriesById = new Map(entries.map((entry) => [entry.uuid, entry]));
+  const orderedEntries = ambiguous ? entries : [];
+  if (!ambiguous) {
+    // Claude can persist a reply before its parent attachment; visit late
+    // ancestors before their children instead of assuming append order.
+    const visited = new Set();
+    for (const entry of entries) {
+      const ancestors = [];
+      const visiting = new Set();
+      let ancestor = entry;
+      while (ancestor && !visited.has(ancestor)) {
+        if (visiting.has(ancestor)) return null;
+        visiting.add(ancestor);
+        ancestors.push(ancestor);
+        ancestor = typeof ancestor.parentUuid === "string" ? entriesById.get(ancestor.parentUuid) : null;
+      }
+      while (ancestors.length) {
+        const ancestor = ancestors.pop();
+        visited.add(ancestor);
+        orderedEntries.push(ancestor);
+      }
+    }
+  }
   const descendants = new Map();
   const backgroundCalls = new Map();
   const openLeaves = new Set();
@@ -491,7 +519,7 @@ export function readTranscriptOutcome(sessionId, cwd, msgId) {
     openLeaves.delete(entry.parentUuid);
     interruptions.push({ entryId: entry.uuid, backgroundTaskIds: [...outstanding.keys()] });
   };
-  for (const entry of entries) {
+  for (const entry of orderedEntries) {
     if (entry === root) { descendants.set(entry.uuid, new Map()); openLeaves.add(entry.uuid); continue; }
     let parentUuid = entry.parentUuid;
     if (!ambiguous && !interruptions.length && descendants.has(entry.logicalParentUuid)
@@ -503,6 +531,7 @@ export function readTranscriptOutcome(sessionId, cwd, msgId) {
       }
     }
     if (!descendants.has(parentUuid)) continue;
+    let taskNotification = null;
     if (entry.type === "attachment" && entry.attachment?.type === "queued_command") {
       // Only a native command record is a boundary. Its text is never used as
       // proof of authorization, cancellation, or successful task completion.
@@ -510,12 +539,12 @@ export function readTranscriptOutcome(sessionId, cwd, msgId) {
         interrupt(entry, descendants.get(entry.parentUuid));
         continue;
       }
-      // An inline native task notification is not a new prompt. Preserve the
-      // active reply chain even when the notification belongs to another task;
-      // its text alone never completes any outstanding background command.
+      // Inline native notifications preserve the chain; only matching task and
+      // tool-call identities below can complete an outstanding command.
       if (entry.attachment.commandMode !== "task-notification"
         || entry.attachment.origin?.kind !== "task-notification"
         || entry.attachment.origin?.producer !== "session-task") continue;
+      taskNotification = entry.attachment.prompt;
     }
     const role = entry.message?.role;
     const content = entry.message?.content;
@@ -532,7 +561,7 @@ export function readTranscriptOutcome(sessionId, cwd, msgId) {
         && (typeof content === "string" && content.trim()
           || Array.isArray(content) && content.length > 0 && content.every((part) => part?.type === "text" && typeof part.text === "string")
             && content.some((part) => part.text.trim()));
-      if (ordinaryInput) {
+      if (ordinaryInput || isOtherPeerInput(entry, msgId)) {
         interrupt(entry, outstanding);
         continue;
       }
@@ -542,14 +571,18 @@ export function readTranscriptOutcome(sessionId, cwd, msgId) {
       if (entry.origin?.kind !== "task-notification" || entry.origin.producer !== "session-task"
         || entry.promptSource !== "system" || entry.turnOrigin !== "task_notification"
         || typeof content !== "string" || !/^<task-notification>\s[\s\S]*<\/task-notification>$/.test(content.trim())) continue;
+      taskNotification = content;
+    }
+    if (typeof taskNotification === "string" && /^<task-notification>\s[\s\S]*<\/task-notification>$/.test(taskNotification.trim())) {
       const field = (name) => {
-        const matches = [...content.matchAll(new RegExp(`<${name}>([^<>]+)</${name}>`, "g"))];
+        const matches = [...taskNotification.matchAll(new RegExp(`<${name}>([^<>]+)</${name}>`, "g"))];
         return matches.length === 1 ? matches[0][1] : null;
       };
       const taskId = field("task-id");
       if (!outstanding.has(taskId) || outstanding.get(taskId) !== field("tool-use-id")
-        || !["completed", "failed", "killed"].includes(field("status"))) continue;
-      outstanding.delete(taskId);
+        || !["completed", "failed", "killed"].includes(field("status"))) {
+        if (role === "user") continue;
+      } else outstanding.delete(taskId);
     }
     if (typeof entry.uuid !== "string" || !entry.uuid.trim()) continue;
     if (role === "assistant" && Array.isArray(content)) {