@minhspark/codex-mcp-bridge 1.24.0 → 1.25.0

package/.codex-plugin/plugin.json

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

package/CHANGELOG.md

@@ -4,6 +4,42 @@ Follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [SemVer](ht
 
 ## [Unreleased]
 
+## [1.25.0] - 2026-10-30
+
+### Added
+
+- Global npm installation now configures Claude Desktop, Claude Code, Codex and Antigravity in one command. On npm versions that require lifecycle-script authorization, use `npm install -g @minhspark/codex-mcp-bridge@latest --allow-scripts=@minhspark/codex-mcp-bridge`.
+- Setup creates the distinct shared Claude Desktop `codex-bridge-desktop` connector and user-level Claude Code `codex-bridge`, registers the native Codex relay and its executor, and installs Antigravity's inbound, outbound and sidecar entries. An absent Codex CLI is installed from the official package into a separate per-user tools directory.
+- `codex-bridge-setup` and `codex-mcp-bridge setup` support read-only `--check`, `--dry-run`, JSON reports and `--no-download`. Local dependency installation does not change application configuration; global setup can be skipped with `CODEX_BRIDGE_SKIP_SETUP=1`.
+- README troubleshooting now includes detailed recovery procedures and a versioned catalog of historical installation, routing, identity and reply-observation fixes.
+
+### Fixed
+
+- Initial Claude Code registration no longer requires hand-written JSON or an existing supervised entry. Setup preserves custom settings and scope, retargets recognized bridge paths, separates a shadowing shared connector, and reports conflicting entries instead of replacing them. Antigravity setup respects a custom Claude configuration directory and an explicitly disabled sidecar.
+- Setup detects Microsoft Store Claude data directories and explicit data-root overrides, refusing ambiguous installations. Antigravity registrations from recognized older package paths are also retargeted during setup.
+- Migrating a shared native entry into Claude Code retains its restrictions and implicit owned-thread policy. Missing saved Codex executable paths are refreshed, valid custom binaries remain selected, and incompatible shared native routing is reported instead of falsely verified.
+- Simultaneous Claude sender-ancestry checks now share one pending Windows inspector. Completed results and failures are discarded; subsequent operations still verify current OS identity, task and account.
+- A delivered Codex request with no matching reply marker no longer waits indefinitely when a new native turn remains finished and idle. After a bounded grace period and a fresh state check, the receipt reports `observation_unavailable` and directs the caller to inspect the existing task without resending or attributing unrelated output.
+- Tool instructions for already-open Claude sessions now require native session discovery and peer delivery. The misleading instruction to inspect a title in the app was removed, and external Computer Use typing/clicking is explicitly excluded as a delivery fallback.
+
+### Verification and limitations
+
+- Windows packed-package installation and configuration readback cover all registered clients. Focused regressions cover initial installation, existing settings, collisions, disabled components, lifecycle opt-outs, native CLI resolution, concurrent sender inspection, reply observation and MCP routing instructions.
+- Configuration verification does not prove that running applications have reloaded their MCP servers. Applications still need to be installed and signed in; native Desktop handoffs require the same saved project and retain host permissions. Shared Claude Desktop chat uses the legacy local app-server route.
+- Setup prewarms runtime snapshots, but the reported 30-second connection timeout was not reproduced and is not claimed resolved. Missing reply correlation still requires inspection of the original task. Updated tool instructions guide model behavior and cannot guarantee every model follows them.
+
+## [1.24.1] - 2026-10-29
+
+### Fixed
+
+- Native Codex turns whose `root_turn_id` names a different causal root are no longer rejected as contradictory. Membership comes from explicit turn IDs, contradictory explicit IDs are still rejected, and a turn is never selected only because its causal root matches the requested turn (#169, #171 by @deinspanjer).
+- An accepted Desktop send whose response cannot be verified now reports `status: observation_unavailable` with `nextAction: inspect_existing_task` and the original receipt, instead of `failed`. Desktop's own `failed` or `interrupted` status is still reported when it belongs to the exact observed turn. `wait_codex_reply` with `responsePreferences` returns the same next action plus `guidance` telling the caller not to resend the prompt.
+- When a Claude reply observation is interrupted by a new input boundary after an asynchronous or timed-out `send_to_claude_session`, the bridge now publishes a correlated bridge-status notification to `read_claude_inbox` and to the originating Codex task. It is labelled as a bridge notification rather than a Claude reply, keeps the original account and project scope, reports outcome unknown, task not cancelled and retry unsafe, and survives reload without duplication. Asynchronous send guidance now points to `read_claude_delivery` (#170, #172 by @deinspanjer).
+
+### Upgrade
+
+- `npm install -g @minhspark/codex-mcp-bridge@latest`, then restart Claude Desktop and Codex Desktop (or reconnect their MCP servers) so running bridges load 1.24.1.
+
 ## [1.24.0] - 2026-10-28
 
 ### Added