codex-overleaf-link 2.1.2 → 2.1.3

package/README.md

@@ -3,7 +3,7 @@
   <h1>Codex Overleaf Link</h1>
   <p><strong>Empower Overleaf with Codex.</strong></p>
   <p>
-    <img src="https://img.shields.io/badge/version-2.1.2-blue" alt="version">
+    <img src="https://img.shields.io/badge/version-2.1.3-blue" alt="version">
     <img src="https://img.shields.io/badge/platform-macOS%20%2F%20Windows%20%2F%20Linux-lightgrey" alt="platform">
     <img src="https://img.shields.io/badge/chrome-MV3-green" alt="chrome manifest v3">
     <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" alt="node version">
@@ -38,14 +38,14 @@ One command installs the managed native host **and** managed extension runtime.
 macOS / Linux:
 
 ```bash
-CODEX_OVERLEAF_REF=v2.1.2 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.2/install.sh)"
+CODEX_OVERLEAF_REF=v2.1.3 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.3/install.sh)"
 ```
 
 Windows PowerShell:
 
 ```powershell
-iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.2/install.ps1 -OutFile install.ps1
-$env:CODEX_OVERLEAF_REF='v2.1.2'
+iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.3/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v2.1.3'
 powershell -ExecutionPolicy Bypass -File install.ps1
 ```
 
@@ -56,7 +56,7 @@ Then, in the `chrome://extensions` tab the script opened: enable **Developer mod
 `npm exec` installs the same managed native host and extension runtime without keeping a source checkout. Use it if you prefer a pinned npm package.
 
 ```bash
-npm exec --yes codex-overleaf-link@2.1.2 -- install-managed
+npm exec --yes codex-overleaf-link@2.1.3 -- install-managed
 ```
 
 Then, in `chrome://extensions`, enable **Developer mode**, click **Load unpacked**, and select the managed extension path printed by the command. The Release extension zip remains available for explicitly unmanaged/manual installations.
@@ -86,9 +86,9 @@ npm installs, updates, and uninstalls the coordinated managed extension/native p
 
 | Action | Command |
 |--------|---------|
-| Install / update | `npm exec --yes codex-overleaf-link@2.1.2 -- install-managed` |
-| Diagnose | `npm exec --yes codex-overleaf-link@2.1.2 -- doctor` |
-| Uninstall | `npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed` |
+| Install / update | `npm exec --yes codex-overleaf-link@2.1.3 -- install-managed` |
+| Diagnose | `npm exec --yes codex-overleaf-link@2.1.3 -- doctor` |
+| Uninstall | `npm exec --yes codex-overleaf-link@2.1.3 -- uninstall-managed` |
 
 Use `--extension-id <chrome-extension-id>` only for a custom/dev unpacked extension id that differs from the official bundled id.
 
@@ -98,13 +98,13 @@ Managed installations discover signed stable updates automatically and apply the
 
 ## GitHub Release Artifacts
 
-The v2.1.2 GitHub Release contains:
+The v2.1.3 GitHub Release contains:
 
-- `codex-overleaf-link-extension-v2.1.2.zip`: loadable Chrome extension package for manual unpacked installation.
-- `codex-overleaf-native-host-v2.1.2.tar.gz`: native host runtime files used by the installer and release verification.
-- `codex-overleaf-link-2.1.2.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
-- `install.sh`: release-pinned macOS / Linux installer that defaults to `v2.1.2` when run directly from the release artifact.
-- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v2.1.2` when run directly from the release artifact.
+- `codex-overleaf-link-extension-v2.1.3.zip`: loadable Chrome extension package for manual unpacked installation.
+- `codex-overleaf-native-host-v2.1.3.tar.gz`: native host runtime files used by the installer and release verification.
+- `codex-overleaf-link-2.1.3.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
+- `install.sh`: release-pinned macOS / Linux installer that defaults to `v2.1.3` when run directly from the release artifact.
+- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v2.1.3` when run directly from the release artifact.
 - `uninstall-native-host.mjs`: native host uninstaller that removes the Chrome Native Messaging manifest, bridge executable, and runtime copy.
 - `nativeHostPlatform.js`, `manifest.js`, `runtimeInstaller.js`: helper files required by the loose uninstaller asset.
 - `SHA256SUMS` and `release-manifest.json`: checksum and artifact metadata for release verification.
@@ -115,7 +115,7 @@ The v2.1.2 GitHub Release contains:
 Remove the native host (use `--browser chromium` on Linux Chromium):
 
 ```bash
-npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed
+npm exec --yes codex-overleaf-link@2.1.3 -- uninstall-managed
 ```
 
 The same command works on Windows PowerShell. If you installed from a manual checkout or source installer, you can also run `npm run uninstall:native` inside the repo, use `node ~/.codex-overleaf/source/scripts/uninstall-native-host.mjs` on macOS / Linux, or use `node $env:LOCALAPPDATA\CodexOverleaf\source\scripts\uninstall-native-host.mjs` on Windows PowerShell.
@@ -150,13 +150,13 @@ Then remove the extension from `chrome://extensions`. To delete local data: on m
 Linux Chromium install or update:
 
 ```bash
-CODEX_OVERLEAF_REF=v2.1.2 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.2/install.sh)" -- --browser chromium
+CODEX_OVERLEAF_REF=v2.1.3 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.3/install.sh)" -- --browser chromium
 ```
 
 Linux Chromium uninstall:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed --browser chromium
+npm exec --yes codex-overleaf-link@2.1.3 -- uninstall-managed --browser chromium
 ```
 
 ## Features
@@ -292,7 +292,7 @@ Composer attachments are turn-scoped Codex context. Limits are 8 attachments per
 Re-run any [native host installer](#install), reload the extension in `chrome://extensions`, then refresh the Overleaf tab. This also fixes extension/native version mismatch and native protocol mismatch.
 
 ```bash
-npm exec --yes codex-overleaf-link@2.1.2 -- install-managed
+npm exec --yes codex-overleaf-link@2.1.3 -- install-managed
 ```
 
 **The Windows popup or panel shows a Bash recovery command**
@@ -341,8 +341,8 @@ Use this matrix for release-candidate signoff and compatibility reports. Record
 | Browser/channel/version | Google Chrome channel and version. | Google Chrome channel and version. | Google Chrome channel and version. | Chromium channel/package and version. |
 | Install mode | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout; native host installed with `--browser chromium`. |
 | Extension id | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. |
-| Installer/update command | `npm exec --yes codex-overleaf-link@2.1.2 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- install-managed --browser chromium` |
-| Uninstall command | `npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed --browser chromium` |
+| Installer/update command | `npm exec --yes codex-overleaf-link@2.1.3 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.3 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.3 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.3 -- install-managed --browser chromium` |
+| Uninstall command | `npm exec --yes codex-overleaf-link@2.1.3 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.3 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.3 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.3 -- uninstall-managed --browser chromium` |
 | Manifest/registry path | `~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.codex.overleaf.json` | `HKCU\Software\Google\Chrome\NativeMessagingHosts\com.codex.overleaf` -> `%LOCALAPPDATA%\CodexOverleaf\native-host-runtime\com.codex.overleaf.json` | `~/.config/google-chrome/NativeMessagingHosts/com.codex.overleaf.json` | `~/.config/chromium/NativeMessagingHosts/com.codex.overleaf.json` |
 | Bridge/runtime/source path | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. | Bridge `%LOCALAPPDATA%\CodexOverleaf\codex-overleaf-bridge.cmd`; runtime `%LOCALAPPDATA%\CodexOverleaf\native-host-runtime`; source `%LOCALAPPDATA%\CodexOverleaf\source`. | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. |
 | Node/Git/Codex/TeX | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. |
@@ -378,7 +378,7 @@ Contributions are welcome. Please open an issue before submitting large changes
 The recommended v1.9 installation owns one stable unpacked-extension directory and a versioned native-host directory:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.1.2 -- install-managed
+npm exec --yes codex-overleaf-link@2.1.3 -- install-managed
 ```
 
 Load the printed extension path once from `chrome://extensions`. Starting with the next signed stable release, Codex Overleaf Link checks GitHub Releases automatically, downloads and verifies the coordinated extension/native-host bundle, waits until every connected Overleaf tab is saved and idle, and then updates both components together. A failed health check restores the previous version automatically.
@@ -388,11 +388,11 @@ The stable updater ignores drafts and prereleases, performs no telemetry, and ca
 The legacy native-only installer remains available for source or unmanaged extension directories:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.1.2 -- install-native
+npm exec --yes codex-overleaf-link@2.1.3 -- install-native
 ```
 
 Legacy native-only installations can be removed with:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-native
+npm exec --yes codex-overleaf-link@2.1.3 -- uninstall-native
 ```

package/extension/bootstrap/manifest.template.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Codex Overleaf Link",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Connect the active Overleaf project to a local Codex bridge.",
   "icons": {
     "16": "assets/icons/icon16.png",

package/extension/src/shared/compatibility.js

@@ -12,7 +12,7 @@
   const MIN_NATIVE_VERSION = '1.0.0';
   const MIN_COMPATIBLE_NATIVE_VERSION = '1.0.0';
   const MIN_COMPATIBLE_EXTENSION_VERSION = '1.0.0';
-  const BUILD_TARGET_VERSION = '2.1.2';
+  const BUILD_TARGET_VERSION = '2.1.3';
   const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
   const REQUIRED_CAPABILITIES = Object.freeze([
     'bridgePing',

package/native-host/src/codexRuntimeIdentity.js

@@ -0,0 +1,217 @@
+'use strict';
+
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+const RUNTIME_ENV_KEY = 'CODEX_OVERLEAF_CODEX_RUNTIME_JSON';
+const MAX_CODEX_CANDIDATES = 8;
+const VERSION_TIMEOUT_MS = 700;
+
+function buildCodexRuntimeIdentity(options = {}) {
+  const env = options.env || process.env;
+  const platform = options.platform || process.platform;
+  const delimiter = options.delimiter || (platform === 'win32' ? ';' : path.delimiter);
+  const selectedPath = String(options.selectedPath || '').trim();
+  const discovered = discoverCodexCandidates(options.pathValue || env.PATH || '', {
+    delimiter,
+    env,
+    platform
+  });
+  const candidatePaths = selectedPath
+    ? [selectedPath, ...discovered.filter(candidate => !sameExecutablePath(candidate, selectedPath, platform))]
+    : discovered;
+  const candidates = candidatePaths.slice(0, MAX_CODEX_CANDIDATES).map((candidatePath, index) => ({
+    path: candidatePath,
+    displayPath: compactHomePath(candidatePath, env, platform),
+    version: readCodexVersion(candidatePath, { env, platform }),
+    source: classifyCodexSource(candidatePath),
+    selected: index === 0 && Boolean(selectedPath)
+  }));
+  const selected = candidates.find(candidate => candidate.selected) || null;
+
+  return {
+    schemaVersion: 1,
+    selected,
+    candidates,
+    multipleInstallations: candidates.length > 1,
+    selectedBy: selected ? 'path-order' : 'not-found'
+  };
+}
+
+function discoverCodexCandidates(pathValue, options = {}) {
+  const platform = options.platform || process.platform;
+  const delimiter = options.delimiter || (platform === 'win32' ? ';' : path.delimiter);
+  const extensions = executableExtensions(options.env || process.env, platform);
+  const seen = new Set();
+  const result = [];
+
+  for (const rawSegment of String(pathValue || '').split(delimiter)) {
+    const segment = rawSegment.trim();
+    if (!segment) continue;
+    for (const extension of extensions) {
+      const candidate = path.join(segment, `codex${extension}`);
+      const key = platform === 'win32' ? candidate.toLowerCase() : candidate;
+      if (seen.has(key) || !isExecutableFile(candidate, platform)) continue;
+      seen.add(key);
+      result.push(candidate);
+      break;
+    }
+  }
+  return result;
+}
+
+function executableExtensions(env, platform) {
+  if (platform !== 'win32') return [''];
+  const configured = String(env.PATHEXT || '.COM;.EXE;.BAT;.CMD')
+    .split(';')
+    .map(value => value.trim().toLowerCase())
+    .filter(Boolean);
+  return ['', ...new Set(configured)];
+}
+
+function isExecutableFile(candidate, platform) {
+  try {
+    if (!fs.statSync(candidate).isFile()) return false;
+    fs.accessSync(candidate, platform === 'win32' ? fs.constants.F_OK : fs.constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function readCodexVersion(candidatePath, options = {}) {
+  if (!candidatePath) return '';
+  const platform = options.platform || process.platform;
+  const result = spawnSync(candidatePath, ['--version'], {
+    encoding: 'utf8',
+    env: options.env || process.env,
+    maxBuffer: 64 * 1024,
+    shell: platform === 'win32' && /\.(?:cmd|bat)$/i.test(candidatePath),
+    timeout: VERSION_TIMEOUT_MS,
+    windowsHide: true
+  });
+  const output = `${result.stdout || ''}\n${result.stderr || ''}`.trim();
+  const match = output.match(/\bcodex(?:-cli)?\s+v?([^\s]+)/i);
+  return match ? match[1] : '';
+}
+
+function classifyCodexSource(candidatePath) {
+  const normalized = normalizeSlashes(candidatePath).toLowerCase();
+  let resolved = normalized;
+  try {
+    resolved = normalizeSlashes(fs.realpathSync(candidatePath)).toLowerCase();
+  } catch {
+    // Keep the visible path when a symlink target cannot be resolved.
+  }
+  if (normalized.includes('/applications/chatgpt.app/')) return 'chatgpt-app';
+  if (normalized.includes('/applications/codex.app/')) return 'codex-app';
+  if (normalized.includes('/.nvm/versions/node/')) return 'npm-nvm';
+  if (resolved.includes('/node_modules/@openai/codex')) return 'npm-global';
+  if (normalized.includes('/opt/homebrew/') || normalized.includes('/homebrew/')) return 'homebrew-prefix';
+  if (normalized.includes('/.npm-global/')) return 'npm-global';
+  return 'path';
+}
+
+function compactHomePath(candidatePath, env = process.env, platform = process.platform) {
+  const home = String(env.HOME || env.USERPROFILE || os.homedir() || '');
+  if (!home) return candidatePath;
+  const caseFold = value => platform === 'win32' ? value.toLowerCase() : value;
+  const normalizedCandidate = path.normalize(candidatePath);
+  const normalizedHome = path.normalize(home);
+  if (caseFold(normalizedCandidate) === caseFold(normalizedHome)) return '~';
+  if (caseFold(normalizedCandidate).startsWith(`${caseFold(normalizedHome)}${path.sep}`)) {
+    return `~${path.sep}${normalizedCandidate.slice(normalizedHome.length + 1)}`;
+  }
+  return candidatePath;
+}
+
+function serializeCodexRuntimeIdentity(identity) {
+  return JSON.stringify(identity || emptyIdentity());
+}
+
+function getCodexRuntimeIdentityFromEnv(env = process.env) {
+  try {
+    const parsed = JSON.parse(String(env[RUNTIME_ENV_KEY] || ''));
+    if (parsed && typeof parsed === 'object' && Array.isArray(parsed.candidates)) return parsed;
+  } catch {
+    // Fall through to the legacy single-path representation.
+  }
+  const selectedPath = String(env.CODEX_OVERLEAF_CODEX_PATH || '').trim();
+  const selected = selectedPath ? {
+    path: selectedPath,
+    displayPath: compactHomePath(selectedPath, env, env.CODEX_OVERLEAF_PLATFORM || process.platform),
+    version: String(env.CODEX_OVERLEAF_CODEX_VERSION || ''),
+    source: String(env.CODEX_OVERLEAF_CODEX_SOURCE || classifyCodexSource(selectedPath)),
+    selected: true
+  } : null;
+  return {
+    schemaVersion: 1,
+    selected,
+    candidates: selected ? [selected] : [],
+    multipleInstallations: false,
+    selectedBy: selected ? 'legacy-path' : 'not-found'
+  };
+}
+
+function buildCodexRuntimeEvent(env = process.env) {
+  const identity = getCodexRuntimeIdentityFromEnv(env);
+  const selected = identity.selected;
+  if (!selected) return null;
+  const version = selected.version || 'unknown version';
+  const candidateCount = identity.candidates.length;
+  return {
+    type: 'codex.runtime.selected',
+    title: identity.multipleInstallations
+      ? `Using Codex CLI ${version}; ${candidateCount} installations were detected.`
+      : `Using Codex CLI ${version}.`,
+    status: 'completed',
+    detail: {
+      path: selected.displayPath || selected.path,
+      version: selected.version || '',
+      source: selected.source || 'path',
+      selectedBy: identity.selectedBy || 'path-order',
+      multipleInstallations: identity.multipleInstallations === true,
+      warningCode: identity.multipleInstallations ? 'multiple_codex_installations' : '',
+      candidates: identity.candidates.map(candidate => ({
+        path: candidate.displayPath || candidate.path,
+        version: candidate.version || '',
+        source: candidate.source || 'path',
+        selected: candidate.selected === true
+      })),
+      technical: true
+    }
+  };
+}
+
+function sameExecutablePath(left, right, platform) {
+  const normalize = value => path.normalize(String(value || ''));
+  return platform === 'win32'
+    ? normalize(left).toLowerCase() === normalize(right).toLowerCase()
+    : normalize(left) === normalize(right);
+}
+
+function normalizeSlashes(value) {
+  return String(value || '').replace(/\\/g, '/');
+}
+
+function emptyIdentity() {
+  return {
+    schemaVersion: 1,
+    selected: null,
+    candidates: [],
+    multipleInstallations: false,
+    selectedBy: 'not-found'
+  };
+}
+
+module.exports = {
+  RUNTIME_ENV_KEY,
+  buildCodexRuntimeEvent,
+  buildCodexRuntimeIdentity,
+  discoverCodexCandidates,
+  getCodexRuntimeIdentityFromEnv,
+  readCodexVersion,
+  serializeCodexRuntimeIdentity
+};

package/native-host/src/nativeDoctor.js

@@ -56,6 +56,7 @@ async function runDoctor(options = {}) {
       errors: []
     },
     bridge: null,
+    codex: null,
     ping: {
       attempted: false
     },
@@ -106,6 +107,10 @@ async function runDoctor(options = {}) {
   body.ping = pingResult;
 
   if (body.ping.ok) {
+    body.codex = sanitizeCodexRuntime(
+      rawPingResponse?.result?.environment?.codex,
+      pathOptions
+    );
     body.compatibility = sanitizeCompatibility(
       evaluateNativeCompatibility(rawPingResponse, { version: PACKAGE_VERSION })
     );
@@ -206,6 +211,19 @@ function formatDoctorHuman(body = {}) {
     lines.push(`Native compatibility: ${body.compatibility.classification || 'unknown'}`);
     lines.push(`Native version: ${body.compatibility.nativeVersion || 'unknown'}`);
   }
+  if (body.codex) {
+    lines.push(`Codex status: ${body.codex.ok ? 'available' : 'not found'}`);
+    lines.push(`Codex path: ${body.codex.path || 'unknown'}`);
+    lines.push(`Codex version: ${body.codex.version || 'unknown'}`);
+    lines.push(`Codex source: ${body.codex.source || 'unknown'}`);
+    if (body.codex.multipleInstallations) {
+      lines.push('Warning: multiple Codex installations detected.');
+      lines.push('Codex candidates:');
+      for (const candidate of body.codex.candidates) {
+        lines.push(`  ${candidate.selected ? '*' : '-'} ${candidate.path || 'unknown'} (${candidate.version || 'unknown'}, ${candidate.source || 'path'})`);
+      }
+    }
+  }
   if (body.ping?.ok === false) {
     lines.push(`Ping: failed (${body.ping.error || 'unknown error'})`);
   } else if (body.ping?.ok === true) {
@@ -255,6 +273,28 @@ function normalizeDiagnosticPath(targetPath, options = {}) {
   return value;
 }
 
+function sanitizeCodexRuntime(codex, pathOptions) {
+  if (!codex || typeof codex !== 'object') return null;
+  const normalizeCodexPath = value => {
+    const normalized = normalizeDiagnosticPath(value, pathOptions);
+    return normalized.includes('<absolute-path>') ? String(value || '') : normalized;
+  };
+  return {
+    ok: codex.ok === true,
+    path: normalizeCodexPath(codex.path || ''),
+    version: String(codex.version || ''),
+    source: String(codex.source || ''),
+    selectedBy: String(codex.selectedBy || ''),
+    multipleInstallations: codex.multipleInstallations === true,
+    candidates: Array.isArray(codex.candidates) ? codex.candidates.map(candidate => ({
+      path: normalizeCodexPath(candidate?.path || ''),
+      version: String(candidate?.version || ''),
+      source: String(candidate?.source || ''),
+      selected: candidate?.selected === true
+    })) : []
+  };
+}
+
 function finalizeDoctorResult(body) {
   const classification = classifyDoctorResult(body);
   body.ok = classification.ok;

package/native-host/src/nativeEnvironment.js

@@ -4,6 +4,11 @@ const fs = require('node:fs');
 const os = require('node:os');
 const path = require('node:path');
 const { spawnSync } = require('node:child_process');
+const {
+  buildCodexRuntimeIdentity,
+  getCodexRuntimeIdentityFromEnv,
+  serializeCodexRuntimeIdentity
+} = require('./codexRuntimeIdentity');
 
 const TOOL_NAMES = ['codex', 'latexmk', 'pdflatex', 'xelatex', 'lualatex', 'bibtex', 'biber'];
 const LATEX_TOOL_NAMES = ['latexmk', 'pdflatex', 'xelatex', 'lualatex', 'bibtex', 'biber'];
@@ -32,6 +37,16 @@ function buildNativeRuntimeEnv(baseEnv = process.env, options = {}) {
   for (const tool of TOOL_NAMES) {
     env[getToolEnvName(tool)] = resolveExecutable(tool, env.PATH, { ...runtimeOptions, env }) || '';
   }
+  const codexRuntime = buildCodexRuntimeIdentity({
+    selectedPath: env.CODEX_OVERLEAF_CODEX_PATH,
+    pathValue: env.PATH,
+    delimiter: runtimeOptions.delimiter,
+    env,
+    platform: runtimeOptions.platform
+  });
+  env.CODEX_OVERLEAF_CODEX_RUNTIME_JSON = serializeCodexRuntimeIdentity(codexRuntime);
+  env.CODEX_OVERLEAF_CODEX_VERSION = codexRuntime.selected?.version || '';
+  env.CODEX_OVERLEAF_CODEX_SOURCE = codexRuntime.selected?.source || '';
 
   return env;
 }
@@ -200,13 +215,25 @@ function resolveExecutable(name, pathValue, options = {}) {
 }
 
 function summarizeNativeEnvironment(env = process.env, options = {}) {
+  const codexRuntime = getCodexRuntimeIdentityFromEnv(env);
+  const selectedCodex = codexRuntime.selected || {};
   const runtimeOptions = { ...options, platform: getNativeRuntimePlatform({ ...options, env }) };
   const availableLatex = LATEX_TOOL_NAMES.filter(tool => Boolean(env[getToolEnvName(tool)]));
   const missingLatex = LATEX_TOOL_NAMES.filter(tool => !env[getToolEnvName(tool)]);
   return {
     codex: {
       ok: Boolean(env.CODEX_OVERLEAF_CODEX_PATH),
-      path: env.CODEX_OVERLEAF_CODEX_PATH || ''
+      path: env.CODEX_OVERLEAF_CODEX_PATH || '',
+      version: selectedCodex.version || '',
+      source: selectedCodex.source || '',
+      selectedBy: codexRuntime.selectedBy || 'not-found',
+      multipleInstallations: codexRuntime.multipleInstallations === true,
+      candidates: codexRuntime.candidates.map(candidate => ({
+        path: candidate.displayPath || candidate.path || '',
+        version: candidate.version || '',
+        source: candidate.source || 'path',
+        selected: candidate.selected === true
+      }))
     },
     latex: {
       ok: availableLatex.length > 0,

package/native-host/src/taskRunnerRuntime.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { buildCodexRuntimeEvent } = require('./codexRuntimeIdentity');
+
 const { spawn } = require('node:child_process');
 const crypto = require('node:crypto');
 const { buildOperationSummary, splitDeletePlan } = require('../../extension/src/shared/summary');
@@ -157,6 +159,10 @@ async function handleCodexRun(request, env, emit) {
       'Codex CLI was not found. Install Codex or make sure the `codex` command is available in your login shell.'
     );
   }
+  const codexRuntimeEvent = buildCodexRuntimeEvent(env);
+  if (codexRuntimeEvent && typeof emit === 'function') {
+    emit(codexRuntimeEvent);
+  }
 
   const projectKey = resolveProjectKey(params);
   const lockToken = acquireProjectLock(projectKey);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-overleaf-link",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Cross-platform Chrome bridge that connects Codex to the active Overleaf project.",
   "license": "MIT",
   "type": "commonjs",