codex-overleaf-link 2.3.3 → 2.3.4

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.3.3-blue" alt="version">
+    <img src="https://img.shields.io/badge/version-2.3.4-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.3.3 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.3/install.sh)"
+CODEX_OVERLEAF_REF=v2.3.4 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.4/install.sh)"
 ```
 
 Windows PowerShell:
 
 ```powershell
-iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.3/install.ps1 -OutFile install.ps1
-$env:CODEX_OVERLEAF_REF='v2.3.3'
+iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.4/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v2.3.4'
 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.3.3 -- install-managed
+npm exec --yes codex-overleaf-link@2.3.4 -- 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.
@@ -88,9 +88,9 @@ npm installs, updates, and uninstalls the coordinated managed extension/native p
 
 | Action | Command |
 |--------|---------|
-| Install / update | `npm exec --yes codex-overleaf-link@2.3.3 -- install-managed` |
-| Diagnose | `npm exec --yes codex-overleaf-link@2.3.3 -- doctor` |
-| Uninstall | `npm exec --yes codex-overleaf-link@2.3.3 -- uninstall-managed` |
+| Install / update | `npm exec --yes codex-overleaf-link@2.3.4 -- install-managed` |
+| Diagnose | `npm exec --yes codex-overleaf-link@2.3.4 -- doctor` |
+| Uninstall | `npm exec --yes codex-overleaf-link@2.3.4 -- uninstall-managed` |
 
 Use `--extension-id <chrome-extension-id>` only for a custom/dev unpacked extension id that differs from the official bundled id.
 
@@ -104,13 +104,13 @@ Managed installations discover signed stable updates automatically and apply the
 
 v2.2.0 introduces Bootstrap protocol 2. Existing v2.1.x managed installations must run the pinned `install-managed` command once, then reload the extension and Overleaf. Later protocol-2 releases use the in-product signed updater for ordinary runtime, style, vendor, and Native Host feature changes.
 
-The v2.3.3 GitHub Release contains:
+The v2.3.4 GitHub Release contains:
 
-- `codex-overleaf-link-extension-v2.3.3.zip`: loadable Chrome extension package for manual unpacked installation.
-- `codex-overleaf-native-host-v2.3.3.tar.gz`: native host runtime files used by the installer and release verification.
-- `codex-overleaf-link-2.3.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.3.3` when run directly from the release artifact.
-- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v2.3.3` when run directly from the release artifact.
+- `codex-overleaf-link-extension-v2.3.4.zip`: loadable Chrome extension package for manual unpacked installation.
+- `codex-overleaf-native-host-v2.3.4.tar.gz`: native host runtime files used by the installer and release verification.
+- `codex-overleaf-link-2.3.4.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
+- `install.sh`: release-pinned macOS / Linux installer that defaults to `v2.3.4` when run directly from the release artifact.
+- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v2.3.4` 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.
@@ -121,7 +121,7 @@ The v2.3.3 GitHub Release contains:
 Remove the native host (use `--browser chromium` on Linux Chromium):
 
 ```bash
-npm exec --yes codex-overleaf-link@2.3.3 -- uninstall-managed
+npm exec --yes codex-overleaf-link@2.3.4 -- 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.
@@ -156,13 +156,13 @@ Then remove the extension from `chrome://extensions`. To delete local data: on m
 Linux Chromium install or update:
 
 ```bash
-CODEX_OVERLEAF_REF=v2.3.3 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.3/install.sh)" -- --browser chromium
+CODEX_OVERLEAF_REF=v2.3.4 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.4/install.sh)" -- --browser chromium
 ```
 
 Linux Chromium uninstall:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.3.3 -- uninstall-managed --browser chromium
+npm exec --yes codex-overleaf-link@2.3.4 -- uninstall-managed --browser chromium
 ```
 
 ## Features
@@ -298,7 +298,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.3.3 -- install-managed
+npm exec --yes codex-overleaf-link@2.3.4 -- install-managed
 ```
 
 **The Windows popup or panel shows a Bash recovery command**
@@ -347,8 +347,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.3.3 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.3 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.3 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.3 -- install-managed --browser chromium` |
-| Uninstall command | `npm exec --yes codex-overleaf-link@2.3.3 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.3 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.3 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.3 -- uninstall-managed --browser chromium` |
+| Installer/update command | `npm exec --yes codex-overleaf-link@2.3.4 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.4 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.4 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.4 -- install-managed --browser chromium` |
+| Uninstall command | `npm exec --yes codex-overleaf-link@2.3.4 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.4 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.4 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.4 -- 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. |
@@ -384,7 +384,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.3.3 -- install-managed
+npm exec --yes codex-overleaf-link@2.3.4 -- 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.
@@ -394,11 +394,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.3.3 -- install-native
+npm exec --yes codex-overleaf-link@2.3.4 -- install-native
 ```
 
 Legacy native-only installations can be removed with:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.3.3 -- uninstall-native
+npm exec --yes codex-overleaf-link@2.3.4 -- uninstall-native
 ```

package/extension/bootstrap/manifest.template.json

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

package/extension/src/content/contentRuntime.js

@@ -383,7 +383,8 @@
     getState: () => state,
     setState: next => { state = next; },
     getCurrentRunView: () => currentRunView,
-    getSettingsPanelInstance: () => settingsPanelInstance
+    getSettingsPanelInstance: () => settingsPanelInstance,
+    prepareRetryReplacement: run => prepareRetryReplacement(run)
   });
   const {
     showUndoFileSelection,
@@ -840,6 +841,7 @@
   let state = null;
   let storageKey = LEGACY_STORAGE_KEY;
   let currentRunView = null;
+  let pendingRetryReplacement = null;
   let runQueueScheduler = null;
   let runInputCoordinator = null;
   const activeTurnControl = ActiveTurnControl.create({ chrome });
@@ -936,6 +938,13 @@
       sendResponse?.(getPanelStateResponse());
       return;
     }
+    if (message?.type === 'codex-overleaf/toggle-launcher') {
+      const visible = !PanelRenderer.isLauncherVisible(panelRendererInstance);
+      PanelRenderer.setLauncherVisible(panelRendererInstance, visible, { persist: true });
+      if (!visible) closePanel();
+      sendResponse?.(getPanelStateResponse());
+      return;
+    }
     if (message?.type === 'codex-overleaf/toggle-panel') {
       if (isPanelOpen()) {
         closePanel();
@@ -1186,7 +1195,12 @@
         maxWidth: PANEL_MAX_WIDTH,
         pageMinWidth: PAGE_MIN_WIDTH,
         initialWidth: state?.panelWidth || PANEL_DEFAULT_WIDTH,
+        chromeApi: chrome,
+        launcherLabel: tx('Show or hide Codex panel', '显示或隐藏 Codex 边栏'),
         callbacks: {
+          onLauncherToggle: () => ensurePanelOpen(),
+          onClosePanel: () => closePanel(),
+          onLauncherVisibilityChange: visible => { if (!visible) closePanel(); },
           onRefresh: () => refreshProbe({ userInitiated: true }),
           onNewSession: () => startNewSession(),
           onChangeHistory: () => openChangeHistory(),
@@ -1364,7 +1378,8 @@
   function getPanelStateResponse() {
     return {
       ok: true,
-      open: isPanelOpen()
+      open: isPanelOpen(),
+      launcherVisible: PanelRenderer.isLauncherVisible(panelRendererInstance)
     };
   }
 
@@ -1789,6 +1804,12 @@
     // Freeze submitted run identity before the panel can change during the run.
     const submittedMode = executionSnapshot.mode;
     const submittedRequireReviewing = executionSnapshot.requireReviewing === true;
+    const replaceRunId = queuedInput ? '' : runController.resolveRetryReplacement({
+      candidate: pendingRetryReplacement,
+      activeSessionId: state.activeSessionId,
+      runs: state.runs,
+      projectRunSettlement: run => WritebackSettlement.projectRunSettlement(run)
+    });
 
     runCancellationRequested = false;
     runCancellationController = new AbortController();
@@ -1802,8 +1823,10 @@
       executionSnapshot,
       attachments: submittedAttachments,
       skillInvocation: submittedSkillInvocation,
-      queueItemId: queuedInput?.id || ''
+      queueItemId: queuedInput?.id || '',
+      replaceRunId
     });
+    if (!queuedInput) pendingRetryReplacement = null;
     const runSessionId = currentRunView.sessionId;
     let runAuditDraft = null;
     try {
@@ -6127,6 +6150,17 @@
     renderPendingInputs();
   }
 
+  function prepareRetryReplacement(run) {
+    const sessionId = state?.activeSessionId || '';
+    const source = findRunRecord(run?.id, sessionId);
+    const eligible = source && runController.isRetryReplacementEligible(
+      source,
+      WritebackSettlement.projectRunSettlement(source)
+    );
+    pendingRetryReplacement = eligible ? { sessionId, runId: source.id } : null;
+    return Boolean(eligible);
+  }
+
   function startRunView({
     task,
     mode,
@@ -6134,6 +6168,7 @@
     reasoningEffort,
     speedTier,
     queueItemId = '',
+    replaceRunId = '',
     executionSnapshot = null
   }) {
     let attachments = [];
@@ -6185,13 +6220,14 @@
       }
       : {};
     state = updateActiveSession(state, {
-      runs: [...(state.runs || []), record].slice(-20),
+      runs: runController.replaceRunForRetry(state.runs, replaceRunId, record),
       ...titlePatch
     });
-    saveStateSoon();
+    saveStateSoon(replaceRunId ? 0 : 120);
 
     const log = panel.querySelector('[data-log]');
     removeEmptyRunsMessage(log);
+    if (replaceRunId) log.querySelector(`[data-run-id="${cssEscape(replaceRunId)}"]`)?.remove();
     const root = renderRunCard(record);
     log.append(root);
     scrollLogToBottom({ force: true });

package/extension/src/content/generated/content.bundle.js

@@ -11368,7 +11368,7 @@ ${block}`;
       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.3.3";
+      const BUILD_TARGET_VERSION = "2.3.4";
       const DEFAULT_CHROME_EXTENSION_ID = "illdpneeeopfffmiepaejglgmhpmdhdc";
       const REQUIRED_CAPABILITIES = Object.freeze([
         "bridgePing",
@@ -16058,11 +16058,39 @@ ${block}`;
       function defaultIsUsableProjectFileContent(content) {
         return String(content || "").trim().length > 0;
       }
+      function isRetryReplacementEligible(run = {}, projection = {}) {
+        if (!run.id || !["failed", "interrupted"].includes(run.status)) return false;
+        if (run.trackedChangeStatus || run.undoStatus) return false;
+        if (["undoOperations", "undoTrackedChanges", "undoExpectedFiles", "undoBaseFiles", "appliedOperations"].some((field) => Array.isArray(run[field]) && run[field].length)) return false;
+        if (projection.canAccept || projection.canUndo || projection.changedDocument === true) return false;
+        if (projection.failureTerminalState === "needs_review" || projection.terminalState === "needs_review") return false;
+        return projection.changedDocument === false || run.mode === "ask" || hasZeroWriteReport(run.events);
+      }
+      function hasZeroWriteReport(events = []) {
+        return (Array.isArray(events) ? events : []).some((event) => {
+          const rows = Array.isArray(event?.detailStructured?.meta) ? event.detailStructured.meta : [];
+          return rows.some((row) => row?.key === "writeResult" && /(?:wrote|写入)\s*0\b[\s\S]*(?:skipped|跳过)\s*0\b/i.test(String(row.value || "")));
+        });
+      }
+      function resolveRetryReplacement({ candidate, activeSessionId, runs, projectRunSettlement } = {}) {
+        if (!candidate?.runId || candidate.sessionId !== activeSessionId) return "";
+        const source = (Array.isArray(runs) ? runs : []).find((run) => run?.id === candidate.runId);
+        if (!source) return "";
+        const projection = typeof projectRunSettlement === "function" ? projectRunSettlement(source) : {};
+        return isRetryReplacementEligible(source, projection) ? source.id : "";
+      }
+      function replaceRunForRetry(runs, sourceRunId, nextRun, maxRuns = 20) {
+        const retained = (Array.isArray(runs) ? runs : []).filter((run) => !sourceRunId || run?.id !== sourceRunId);
+        return [...retained, nextRun].slice(-Math.max(1, maxRuns));
+      }
       return {
         buildCodexRunParams,
         canUseFocusedPartialSnapshot,
         shouldRestrictWritebackToFocus,
         buildSessionHistoryResult,
+        isRetryReplacementEligible,
+        replaceRunForRetry,
+        resolveRetryReplacement,
         truncateSessionHistoryText,
         normalizeComposerAttachments,
         normalizeSkillInvocation
@@ -16772,10 +16800,13 @@ ${block}`;
       const ROOT_CLASS = "codex-overleaf-panel-mounted";
       const RESIZE_CLASS = "codex-overleaf-panel-resizing";
       const COMPACT_CLASS = "codex-overleaf-panel-compact";
+      const LAUNCHER_VISIBILITY_STORAGE_KEY = "codex-overleaf:launcher-visible";
       function codexIcon(name) {
         const icons = {
           refresh: '<path d="M4.2 5.3A5 5 0 1 1 3.6 10"/><path d="M4.2 2.2v3.1H1.1"/>',
           plus: '<path d="M8 3.2v9.6"/><path d="M3.2 8h9.6"/>',
+          panel: '<rect x="2.3" y="2.3" width="11.4" height="11.4" rx="2"/><path d="M9.2 2.5v11"/><path d="M5.1 6.1h1.5M5.1 8h1.5M5.1 9.9h1.5"/>',
+          collapse: '<path d="m6.1 3.3 4.7 4.7-4.7 4.7"/>',
           settings: '<path d="M3.4 5.2h5.9"/><path d="M11.7 5.2h.9"/><path d="M10.1 3.6v3.2"/><path d="M3.4 10.8h1"/><path d="M6.8 10.8h5.8"/><path d="M5.9 9.2v3.2"/>'
         };
         const safeName = Object.prototype.hasOwnProperty.call(icons, name) ? name : "settings";
@@ -16785,9 +16816,11 @@ ${block}`;
         const doc = options2.document || document;
         const container = options2.container || doc.documentElement;
         const panelEl = doc.createElement("aside");
+        const launcherEl = doc.createElement("button");
         const callbacks = options2.callbacks || {};
         const instance = {
           panelEl,
+          launcherEl,
           callbacks,
           defaultWidth: options2.defaultWidth || 380,
           minWidth: options2.minWidth || 340,
@@ -16796,8 +16829,16 @@ ${block}`;
           lastDesktopWidth: options2.initialWidth || options2.defaultWidth || 380,
           listeners: [],
           document: doc,
-          window: options2.window || window
+          window: options2.window || window,
+          chromeApi: options2.chromeApi || (typeof chrome !== "undefined" ? chrome : null),
+          storageChangeListener: null
         };
+        launcherEl.id = "codex-overleaf-launcher";
+        launcherEl.type = "button";
+        launcherEl.title = options2.launcherLabel || "Show or hide Codex panel";
+        launcherEl.setAttribute("aria-label", launcherEl.title);
+        launcherEl.setAttribute("aria-expanded", "false");
+        launcherEl.innerHTML = codexIcon("panel");
         panelEl.id = options2.panelId || "codex-overleaf-panel";
         panelEl.dataset.view = "session";
         panelEl.innerHTML = `
@@ -16809,6 +16850,7 @@ ${block}`;
           <div data-diagnostics-slot></div>
           <button type="button" data-new-session title="New Session" aria-label="New Session">${codexIcon("plus")}</button>
           <button type="button" data-custom-instructions-settings title="Project Settings" aria-label="Project Settings" aria-expanded="false">${codexIcon("settings")}</button>
+          <button type="button" data-close-panel title="Close Codex panel" aria-label="Close Codex panel">${codexIcon("collapse")}</button>
         </div>
       </div>
       <div data-settings-slot></div>
@@ -16823,6 +16865,7 @@ ${block}`;
       <div data-composer-slot></div>
     `;
         container.append(panelEl);
+        container.append(launcherEl);
         doc.documentElement.classList.add(ROOT_CLASS);
         instance.headerEl = panelEl.querySelector("[data-panel-header]");
         instance.bodyEl = panelEl.querySelector("[data-main]");
@@ -16835,6 +16878,8 @@ ${block}`;
         bind(instance, panelEl.querySelector("[data-refresh]"), "click", () => callbacks.onRefresh?.());
         bind(instance, panelEl.querySelector("[data-new-session]"), "click", () => callbacks.onNewSession?.());
         bind(instance, panelEl.querySelector("[data-custom-instructions-settings]"), "click", () => callbacks.onSettingsClick?.());
+        bind(instance, panelEl.querySelector("[data-close-panel]"), "click", () => callbacks.onClosePanel?.());
+        bind(instance, launcherEl, "click", () => callbacks.onLauncherToggle?.());
         bind(instance, panelEl.querySelector("[data-panel-resize-handle]"), "pointerdown", (event) => startResize(instance, event));
         bind(instance, panelEl.querySelector("[data-panel-resize-handle]"), "dblclick", (event) => {
           event?.preventDefault?.();
@@ -16848,8 +16893,10 @@ ${block}`;
           setWidth(instance, instance.lastDesktopWidth || instance.defaultWidth, { notify: true, persist: false });
         });
         setWidth(instance, options2.initialWidth || instance.defaultWidth, { notify: false });
+        initializeLauncherVisibility(instance);
         return {
           panelEl,
+          launcherEl,
           headerEl: instance.headerEl,
           bodyEl: instance.bodyEl,
           diagnosticsSlot: instance.diagnosticsSlot,
@@ -16944,10 +16991,58 @@ ${block}`;
       function setVisible(panelEl, visible) {
         panelEl?.classList?.toggle("is-open", Boolean(visible));
         document.documentElement.classList.toggle(ROOT_CLASS, Boolean(visible));
+        const launcherEl = panelEl?.ownerDocument?.getElementById?.("codex-overleaf-launcher");
+        launcherEl?.classList?.toggle("is-panel-open", Boolean(visible));
+        launcherEl?.setAttribute?.("aria-expanded", visible ? "true" : "false");
+        if (launcherEl) {
+          launcherEl.hidden = Boolean(visible) || launcherEl.dataset.enabled === "false";
+          launcherEl.setAttribute("aria-hidden", launcherEl.hidden ? "true" : "false");
+        }
         if (!visible) {
           document.documentElement.classList.remove(RESIZE_CLASS, COMPACT_CLASS);
         }
       }
+      function initializeLauncherVisibility(instance) {
+        const storage = instance.chromeApi?.storage;
+        if (!storage?.local?.get) {
+          setLauncherVisible(instance, true, { persist: false });
+          return;
+        }
+        Promise.resolve(storage.local.get({ [LAUNCHER_VISIBILITY_STORAGE_KEY]: true })).then((values) => applyLauncherVisibility(instance, values?.[LAUNCHER_VISIBILITY_STORAGE_KEY])).catch(() => applyLauncherVisibility(instance, true));
+        if (storage.onChanged?.addListener) {
+          instance.storageChangeListener = (changes, areaName) => {
+            if (areaName === "local" && changes?.[LAUNCHER_VISIBILITY_STORAGE_KEY]) {
+              applyLauncherVisibility(instance, changes[LAUNCHER_VISIBILITY_STORAGE_KEY].newValue);
+            }
+          };
+          storage.onChanged.addListener(instance.storageChangeListener);
+        }
+      }
+      function applyLauncherVisibility(instance, value) {
+        const visible = value !== false;
+        setLauncherVisible(instance, visible, { persist: false });
+        instance.callbacks.onLauncherVisibilityChange?.(visible);
+      }
+      function setLauncherVisible(target, visible, options2 = {}) {
+        const instance = target?._instance || target;
+        const launcherEl = instance?.launcherEl;
+        if (!launcherEl) return false;
+        const nextVisible = Boolean(visible);
+        launcherEl.dataset.enabled = nextVisible ? "true" : "false";
+        launcherEl.hidden = !nextVisible || instance.panelEl?.classList?.contains("is-open") === true;
+        launcherEl.setAttribute("aria-hidden", launcherEl.hidden ? "true" : "false");
+        if (options2.persist === true) {
+          Promise.resolve(instance.chromeApi?.storage?.local?.set?.({
+            [LAUNCHER_VISIBILITY_STORAGE_KEY]: nextVisible
+          })).catch(() => {
+          });
+        }
+        return nextVisible;
+      }
+      function isLauncherVisible(target) {
+        const instance = target?._instance || target;
+        return Boolean(instance?.launcherEl && instance.launcherEl.dataset.enabled !== "false");
+      }
       function setBadge(headerEl, badge = {}) {
         const actions = headerEl?.querySelector?.(".codex-vscode-head-actions");
         if (!actions) {
@@ -17075,12 +17170,18 @@ ${block}`;
           target.removeEventListener?.(type, listener, options2);
         }
         instance.panelEl?.remove?.();
+        instance.launcherEl?.remove?.();
+        if (instance.storageChangeListener) {
+          instance.chromeApi?.storage?.onChanged?.removeListener?.(instance.storageChangeListener);
+        }
         instance.document.documentElement.classList.remove(ROOT_CLASS, RESIZE_CLASS, COMPACT_CLASS);
       }
       window.CodexOverleafPanelRenderer = {
         create,
         createConfirmController,
         setVisible,
+        setLauncherVisible,
+        isLauncherVisible,
         setBadge,
         setWidth
       };
@@ -31470,7 +31571,7 @@ ${conclusion}` : `${label} ${conclusion}`;
           if (!efforts.length) {
             efforts = presentation === "none" ? ["none"] : ["low", "medium", "high", "xhigh"];
           }
-          const current = reasoningSelect.value || getState()?.reasoningEffort || "";
+          const current = getState()?.reasoningEffort || reasoningSelect.value || "";
           const fallback = efforts.includes(model?.defaultReasoningEffort) ? model.defaultReasoningEffort : efforts.includes("high") ? "high" : efforts[0];
           reasoningSelect.textContent = "";
           for (const effort of efforts) {
@@ -34456,6 +34557,7 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
           setState,
           getCurrentRunView,
           getSettingsPanelInstance,
+          prepareRetryReplacement,
           StorageDb
         } = deps;
         let auditHistoryRecords = [];
@@ -34608,6 +34710,7 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
             showPluginToast(tx("Nothing to refill: the original task text is unavailable.", "\u65E0\u6CD5\u56DE\u586B\uFF1A\u539F\u4EFB\u52A1\u6587\u672C\u4E0D\u53EF\u7528\u3002"));
             return;
           }
+          prepareRetryReplacement?.(run || null);
           input.value = task;
           getState().task = task;
           autosizeTaskTextarea();
@@ -35618,7 +35721,8 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
             state = next;
           },
           getCurrentRunView: () => currentRunView,
-          getSettingsPanelInstance: () => settingsPanelInstance
+          getSettingsPanelInstance: () => settingsPanelInstance,
+          prepareRetryReplacement: (run) => prepareRetryReplacement(run)
         });
         const {
           showUndoFileSelection,
@@ -36060,6 +36164,7 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
         let state = null;
         let storageKey = LEGACY_STORAGE_KEY;
         let currentRunView = null;
+        let pendingRetryReplacement = null;
         let runQueueScheduler = null;
         let runInputCoordinator = null;
         const activeTurnControl = ActiveTurnControl.create({ chrome });
@@ -36150,6 +36255,13 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
             sendResponse?.(getPanelStateResponse());
             return;
           }
+          if (message?.type === "codex-overleaf/toggle-launcher") {
+            const visible = !PanelRenderer.isLauncherVisible(panelRendererInstance);
+            PanelRenderer.setLauncherVisible(panelRendererInstance, visible, { persist: true });
+            if (!visible) closePanel();
+            sendResponse?.(getPanelStateResponse());
+            return;
+          }
           if (message?.type === "codex-overleaf/toggle-panel") {
             if (isPanelOpen()) {
               closePanel();
@@ -36363,7 +36475,14 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
               maxWidth: PANEL_MAX_WIDTH,
               pageMinWidth: PAGE_MIN_WIDTH,
               initialWidth: state?.panelWidth || PANEL_DEFAULT_WIDTH,
+              chromeApi: chrome,
+              launcherLabel: tx("Show or hide Codex panel", "\u663E\u793A\u6216\u9690\u85CF Codex \u8FB9\u680F"),
               callbacks: {
+                onLauncherToggle: () => ensurePanelOpen(),
+                onClosePanel: () => closePanel(),
+                onLauncherVisibilityChange: (visible) => {
+                  if (!visible) closePanel();
+                },
                 onRefresh: () => refreshProbe({ userInitiated: true }),
                 onNewSession: () => startNewSession(),
                 onChangeHistory: () => openChangeHistory(),
@@ -36527,7 +36646,8 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
         function getPanelStateResponse() {
           return {
             ok: true,
-            open: isPanelOpen()
+            open: isPanelOpen(),
+            launcherVisible: PanelRenderer.isLauncherVisible(panelRendererInstance)
           };
         }
         function toggleDiagnosticsMenu() {
@@ -36887,6 +37007,12 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
           ) : captureCurrentExecutionSnapshot(submittedPanelState);
           const submittedMode = executionSnapshot.mode;
           const submittedRequireReviewing = executionSnapshot.requireReviewing === true;
+          const replaceRunId = queuedInput ? "" : runController.resolveRetryReplacement({
+            candidate: pendingRetryReplacement,
+            activeSessionId: state.activeSessionId,
+            runs: state.runs,
+            projectRunSettlement: (run) => WritebackSettlement.projectRunSettlement(run)
+          });
           runCancellationRequested = false;
           runCancellationController = new AbortController();
           setRunning(true);
@@ -36899,8 +37025,10 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
             executionSnapshot,
             attachments: submittedAttachments,
             skillInvocation: submittedSkillInvocation,
-            queueItemId: queuedInput?.id || ""
+            queueItemId: queuedInput?.id || "",
+            replaceRunId
           });
+          if (!queuedInput) pendingRetryReplacement = null;
           const runSessionId = currentRunView.sessionId;
           let runAuditDraft = null;
           try {
@@ -40473,6 +40601,16 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
           panel.dataset.cancelling = running && runCancellationRequested ? "true" : "false";
           renderPendingInputs();
         }
+        function prepareRetryReplacement(run) {
+          const sessionId = state?.activeSessionId || "";
+          const source = findRunRecord(run?.id, sessionId);
+          const eligible = source && runController.isRetryReplacementEligible(
+            source,
+            WritebackSettlement.projectRunSettlement(source)
+          );
+          pendingRetryReplacement = eligible ? { sessionId, runId: source.id } : null;
+          return Boolean(eligible);
+        }
         function startRunView({
           task,
           mode,
@@ -40480,6 +40618,7 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
           reasoningEffort,
           speedTier,
           queueItemId = "",
+          replaceRunId = "",
           executionSnapshot = null
         }) {
           let attachments = [];
@@ -40527,12 +40666,13 @@ ${tx("Writeback note: Codex could not confirm any Overleaf write result entries,
             titleSource: "auto"
           } : {};
           state = updateActiveSession(state, {
-            runs: [...state.runs || [], record].slice(-20),
+            runs: runController.replaceRunForRetry(state.runs, replaceRunId, record),
             ...titlePatch
           });
-          saveStateSoon();
+          saveStateSoon(replaceRunId ? 0 : 120);
           const log = panel.querySelector("[data-log]");
           removeEmptyRunsMessage(log);
+          if (replaceRunId) log.querySelector(`[data-run-id="${cssEscape(replaceRunId)}"]`)?.remove();
           const root2 = renderRunCard(record);
           log.append(root2);
           scrollLogToBottom({ force: true });

package/extension/src/content/generated/content.bundle.meta.json

@@ -2,9 +2,9 @@
   "schemaVersion": 1,
   "entry": "extension/entries/content-entry.mjs",
   "output": "extension/src/content/generated/content.bundle.js",
-  "sourceDigest": "4b5c2f7a7653947ac71ae42a3301c7547f789c2ca33e25f99f6781f31d1147be",
-  "outputDigest": "4e32bcf7d8be72541bb39508e38335ad0e32e41844afa45d7f0d34c9481a1cec",
-  "byteLength": 2313648,
+  "sourceDigest": "48e7ba193b0723f8e135c4b52e3af1416b1fe35b3cb780207fb0600e7e0f8019",
+  "outputDigest": "866811d95e8bd58d369e0790bf2af5becc93946eb8ad987b80f0be0f80fa965f",
+  "byteLength": 2321914,
   "inputs": [
     "extension/entries/content-entry.mjs",
     "extension/src/content/activeTurnControl.js",

package/extension/src/content/modelPicker.js

@@ -319,7 +319,7 @@
     if (!efforts.length) {
       efforts = presentation === 'none' ? ['none'] : ['low', 'medium', 'high', 'xhigh'];
     }
-    const current = reasoningSelect.value || getState()?.reasoningEffort || '';
+    const current = getState()?.reasoningEffort || reasoningSelect.value || '';
     const fallback = efforts.includes(model?.defaultReasoningEffort)
       ? model.defaultReasoningEffort
       : efforts.includes('high') ? 'high' : efforts[0];

package/extension/src/content/panelMaintenance.js

@@ -29,6 +29,7 @@
       setState,
       getCurrentRunView,
       getSettingsPanelInstance,
+      prepareRetryReplacement,
       StorageDb
     } = deps;
 
@@ -218,6 +219,7 @@
       showPluginToast(tx('Nothing to refill: the original task text is unavailable.', '无法回填：原任务文本不可用。'));
       return;
     }
+    prepareRetryReplacement?.(run || null);
     input.value = task;
     getState().task = task;
     autosizeTaskTextarea();

package/extension/src/content/panelRenderer.js

@@ -4,11 +4,14 @@
   const ROOT_CLASS = 'codex-overleaf-panel-mounted';
   const RESIZE_CLASS = 'codex-overleaf-panel-resizing';
   const COMPACT_CLASS = 'codex-overleaf-panel-compact';
+  const LAUNCHER_VISIBILITY_STORAGE_KEY = 'codex-overleaf:launcher-visible';
 
   function codexIcon(name) {
     const icons = {
       refresh: '<path d="M4.2 5.3A5 5 0 1 1 3.6 10"/><path d="M4.2 2.2v3.1H1.1"/>',
       plus: '<path d="M8 3.2v9.6"/><path d="M3.2 8h9.6"/>',
+      panel: '<rect x="2.3" y="2.3" width="11.4" height="11.4" rx="2"/><path d="M9.2 2.5v11"/><path d="M5.1 6.1h1.5M5.1 8h1.5M5.1 9.9h1.5"/>',
+      collapse: '<path d="m6.1 3.3 4.7 4.7-4.7 4.7"/>',
       settings: '<path d="M3.4 5.2h5.9"/><path d="M11.7 5.2h.9"/><path d="M10.1 3.6v3.2"/><path d="M3.4 10.8h1"/><path d="M6.8 10.8h5.8"/><path d="M5.9 9.2v3.2"/>'
     };
     const safeName = Object.prototype.hasOwnProperty.call(icons, name) ? name : 'settings';
@@ -19,9 +22,11 @@
     const doc = options.document || document;
     const container = options.container || doc.documentElement;
     const panelEl = doc.createElement('aside');
+    const launcherEl = doc.createElement('button');
     const callbacks = options.callbacks || {};
     const instance = {
       panelEl,
+      launcherEl,
       callbacks,
       defaultWidth: options.defaultWidth || 380,
       minWidth: options.minWidth || 340,
@@ -30,9 +35,18 @@
       lastDesktopWidth: options.initialWidth || options.defaultWidth || 380,
       listeners: [],
       document: doc,
-      window: options.window || window
+      window: options.window || window,
+      chromeApi: options.chromeApi || (typeof chrome !== 'undefined' ? chrome : null),
+      storageChangeListener: null
     };
 
+    launcherEl.id = 'codex-overleaf-launcher';
+    launcherEl.type = 'button';
+    launcherEl.title = options.launcherLabel || 'Show or hide Codex panel';
+    launcherEl.setAttribute('aria-label', launcherEl.title);
+    launcherEl.setAttribute('aria-expanded', 'false');
+    launcherEl.innerHTML = codexIcon('panel');
+
     panelEl.id = options.panelId || 'codex-overleaf-panel';
     panelEl.dataset.view = 'session';
     panelEl.innerHTML = `
@@ -44,6 +58,7 @@
           <div data-diagnostics-slot></div>
           <button type="button" data-new-session title="New Session" aria-label="New Session">${codexIcon('plus')}</button>
           <button type="button" data-custom-instructions-settings title="Project Settings" aria-label="Project Settings" aria-expanded="false">${codexIcon('settings')}</button>
+          <button type="button" data-close-panel title="Close Codex panel" aria-label="Close Codex panel">${codexIcon('collapse')}</button>
         </div>
       </div>
       <div data-settings-slot></div>
@@ -59,6 +74,7 @@
     `;
 
     container.append(panelEl);
+    container.append(launcherEl);
     doc.documentElement.classList.add(ROOT_CLASS);
 
     instance.headerEl = panelEl.querySelector('[data-panel-header]');
@@ -73,6 +89,8 @@
     bind(instance, panelEl.querySelector('[data-refresh]'), 'click', () => callbacks.onRefresh?.());
     bind(instance, panelEl.querySelector('[data-new-session]'), 'click', () => callbacks.onNewSession?.());
     bind(instance, panelEl.querySelector('[data-custom-instructions-settings]'), 'click', () => callbacks.onSettingsClick?.());
+    bind(instance, panelEl.querySelector('[data-close-panel]'), 'click', () => callbacks.onClosePanel?.());
+    bind(instance, launcherEl, 'click', () => callbacks.onLauncherToggle?.());
     bind(instance, panelEl.querySelector('[data-panel-resize-handle]'), 'pointerdown', event => startResize(instance, event));
     bind(instance, panelEl.querySelector('[data-panel-resize-handle]'), 'dblclick', event => {
       event?.preventDefault?.();
@@ -87,9 +105,11 @@
     });
 
     setWidth(instance, options.initialWidth || instance.defaultWidth, { notify: false });
+    initializeLauncherVisibility(instance);
 
     return {
       panelEl,
+      launcherEl,
       headerEl: instance.headerEl,
       bodyEl: instance.bodyEl,
       diagnosticsSlot: instance.diagnosticsSlot,
@@ -198,11 +218,64 @@
   function setVisible(panelEl, visible) {
     panelEl?.classList?.toggle('is-open', Boolean(visible));
     document.documentElement.classList.toggle(ROOT_CLASS, Boolean(visible));
+    const launcherEl = panelEl?.ownerDocument?.getElementById?.('codex-overleaf-launcher');
+    launcherEl?.classList?.toggle('is-panel-open', Boolean(visible));
+    launcherEl?.setAttribute?.('aria-expanded', visible ? 'true' : 'false');
+    if (launcherEl) {
+      launcherEl.hidden = Boolean(visible) || launcherEl.dataset.enabled === 'false';
+      launcherEl.setAttribute('aria-hidden', launcherEl.hidden ? 'true' : 'false');
+    }
     if (!visible) {
       document.documentElement.classList.remove(RESIZE_CLASS, COMPACT_CLASS);
     }
   }
 
+  function initializeLauncherVisibility(instance) {
+    const storage = instance.chromeApi?.storage;
+    if (!storage?.local?.get) {
+      setLauncherVisible(instance, true, { persist: false });
+      return;
+    }
+    Promise.resolve(storage.local.get({ [LAUNCHER_VISIBILITY_STORAGE_KEY]: true }))
+      .then(values => applyLauncherVisibility(instance, values?.[LAUNCHER_VISIBILITY_STORAGE_KEY]))
+      .catch(() => applyLauncherVisibility(instance, true));
+    if (storage.onChanged?.addListener) {
+      instance.storageChangeListener = (changes, areaName) => {
+        if (areaName === 'local' && changes?.[LAUNCHER_VISIBILITY_STORAGE_KEY]) {
+          applyLauncherVisibility(instance, changes[LAUNCHER_VISIBILITY_STORAGE_KEY].newValue);
+        }
+      };
+      storage.onChanged.addListener(instance.storageChangeListener);
+    }
+  }
+
+  function applyLauncherVisibility(instance, value) {
+    const visible = value !== false;
+    setLauncherVisible(instance, visible, { persist: false });
+    instance.callbacks.onLauncherVisibilityChange?.(visible);
+  }
+
+  function setLauncherVisible(target, visible, options = {}) {
+    const instance = target?._instance || target;
+    const launcherEl = instance?.launcherEl;
+    if (!launcherEl) return false;
+    const nextVisible = Boolean(visible);
+    launcherEl.dataset.enabled = nextVisible ? 'true' : 'false';
+    launcherEl.hidden = !nextVisible || instance.panelEl?.classList?.contains('is-open') === true;
+    launcherEl.setAttribute('aria-hidden', launcherEl.hidden ? 'true' : 'false');
+    if (options.persist === true) {
+      Promise.resolve(instance.chromeApi?.storage?.local?.set?.({
+        [LAUNCHER_VISIBILITY_STORAGE_KEY]: nextVisible
+      })).catch(() => {});
+    }
+    return nextVisible;
+  }
+
+  function isLauncherVisible(target) {
+    const instance = target?._instance || target;
+    return Boolean(instance?.launcherEl && instance.launcherEl.dataset.enabled !== 'false');
+  }
+
   function setBadge(headerEl, badge = {}) {
     const actions = headerEl?.querySelector?.('.codex-vscode-head-actions');
     if (!actions) {
@@ -340,6 +413,10 @@
       target.removeEventListener?.(type, listener, options);
     }
     instance.panelEl?.remove?.();
+    instance.launcherEl?.remove?.();
+    if (instance.storageChangeListener) {
+      instance.chromeApi?.storage?.onChanged?.removeListener?.(instance.storageChangeListener);
+    }
     instance.document.documentElement.classList.remove(ROOT_CLASS, RESIZE_CLASS, COMPACT_CLASS);
   }
 
@@ -347,6 +424,8 @@
     create,
     createConfirmController,
     setVisible,
+    setLauncherVisible,
+    isLauncherVisible,
     setBadge,
     setWidth
   };

package/extension/src/content/runController.js

@@ -231,11 +231,46 @@
     return String(content || '').trim().length > 0;
   }
 
+  function isRetryReplacementEligible(run = {}, projection = {}) {
+    if (!run.id || !['failed', 'interrupted'].includes(run.status)) return false;
+    if (run.trackedChangeStatus || run.undoStatus) return false;
+    if (['undoOperations', 'undoTrackedChanges', 'undoExpectedFiles', 'undoBaseFiles', 'appliedOperations']
+      .some(field => Array.isArray(run[field]) && run[field].length)) return false;
+    if (projection.canAccept || projection.canUndo || projection.changedDocument === true) return false;
+    if (projection.failureTerminalState === 'needs_review' || projection.terminalState === 'needs_review') return false;
+    return projection.changedDocument === false || run.mode === 'ask' || hasZeroWriteReport(run.events);
+  }
+
+  function hasZeroWriteReport(events = []) {
+    return (Array.isArray(events) ? events : []).some(event => {
+      const rows = Array.isArray(event?.detailStructured?.meta) ? event.detailStructured.meta : [];
+      return rows.some(row => row?.key === 'writeResult'
+        && /(?:wrote|写入)\s*0\b[\s\S]*(?:skipped|跳过)\s*0\b/i.test(String(row.value || '')));
+    });
+  }
+
+  function resolveRetryReplacement({ candidate, activeSessionId, runs, projectRunSettlement } = {}) {
+    if (!candidate?.runId || candidate.sessionId !== activeSessionId) return '';
+    const source = (Array.isArray(runs) ? runs : []).find(run => run?.id === candidate.runId);
+    if (!source) return '';
+    const projection = typeof projectRunSettlement === 'function' ? projectRunSettlement(source) : {};
+    return isRetryReplacementEligible(source, projection) ? source.id : '';
+  }
+
+  function replaceRunForRetry(runs, sourceRunId, nextRun, maxRuns = 20) {
+    const retained = (Array.isArray(runs) ? runs : [])
+      .filter(run => !sourceRunId || run?.id !== sourceRunId);
+    return [...retained, nextRun].slice(-Math.max(1, maxRuns));
+  }
+
   return {
     buildCodexRunParams,
     canUseFocusedPartialSnapshot,
     shouldRestrictWritebackToFocus,
     buildSessionHistoryResult,
+    isRetryReplacementEligible,
+    replaceRunForRetry,
+    resolveRetryReplacement,
     truncateSessionHistoryText,
     normalizeComposerAttachments,
     normalizeSkillInvocation

package/extension/src/popup.js

@@ -18,7 +18,7 @@
   let currentInstallCommand = DEFAULT_INSTALL_COMMAND;
 
   installCommand.textContent = currentInstallCommand;
-  button.textContent = 'Open panel in Overleaf';
+  button.textContent = 'Show Codex button in Overleaf';
   setVersionStatus({
     status: 'native_missing',
     classification: 'incompatible',
@@ -32,7 +32,7 @@
       return;
     }
 
-    await chrome.tabs.sendMessage(tab.id, { type: 'codex-overleaf/toggle-panel' });
+    await chrome.tabs.sendMessage(tab.id, { type: 'codex-overleaf/toggle-launcher' });
     window.close();
   });
 
@@ -56,20 +56,20 @@
     const tab = await getActiveOverleafProjectTab();
     activeOverleafTab = tab;
     if (!tab?.id) {
-      button.textContent = 'Open panel in Overleaf';
+      button.textContent = 'Show Codex button in Overleaf';
       return;
     }
 
     try {
       const response = await chrome.tabs.sendMessage(tab.id, { type: 'codex-overleaf/get-panel-state' });
-      const open = response?.open === true;
-      button.textContent = open ? 'Close panel in Overleaf' : 'Open panel in Overleaf';
-      status.textContent = open
-        ? 'Panel is open in this Overleaf tab.'
-        : 'Panel is closed in this Overleaf tab.';
+      const visible = response?.launcherVisible !== false;
+      button.textContent = visible ? 'Hide Codex edge button' : 'Show Codex edge button';
+      status.textContent = visible
+        ? 'The edge button appears whenever the Codex panel is closed.'
+        : 'The Codex edge button is hidden in Overleaf.';
     } catch (_error) {
-      button.textContent = 'Open panel in Overleaf';
-      status.textContent = 'Refresh the Overleaf tab, then open the panel.';
+      button.textContent = 'Show Codex button in Overleaf';
+      status.textContent = 'Refresh the Overleaf tab, then show the Codex button.';
     }
   }
 

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.3.3';
+  const BUILD_TARGET_VERSION = '2.3.4';
   const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
   const REQUIRED_CAPABILITIES = Object.freeze([
     'bridgePing',

package/extension/styles/panel.css

@@ -650,6 +650,78 @@
   overflow: hidden;
 }
 
+#codex-overleaf-launcher {
+  position: fixed;
+  top: 50%;
+  right: 0;
+  z-index: 2147483646;
+  display: grid;
+  width: 26px;
+  height: 36px;
+  padding: 0;
+  place-items: center;
+  border: 1px solid #3a3a3a;
+  border-right: 0;
+  border-radius: 7px 0 0 7px;
+  background: #181818;
+  box-shadow: -1px 1px 5px rgba(0, 0, 0, 0.18);
+  color: #8a8a8a;
+  cursor: pointer;
+  opacity: 0.82;
+  transform: translateY(-50%);
+  transition: width 120ms ease, background 120ms ease, color 120ms ease, opacity 120ms ease;
+  appearance: none;
+}
+
+#codex-overleaf-launcher[hidden] { display: none !important; }
+
+#codex-overleaf-launcher:hover {
+  width: 29px;
+  background: #232323;
+  color: #b7b7b7;
+  opacity: 1;
+}
+
+#codex-overleaf-launcher:active {
+  background: #2a2d2e;
+}
+
+#codex-overleaf-launcher:focus-visible {
+  outline: 2px solid #6aa4d8;
+  outline-offset: 2px;
+}
+
+#codex-overleaf-launcher .codex-icon,
+#codex-overleaf-launcher .codex-icon svg {
+  display: block;
+  width: 14px;
+  height: 14px;
+}
+
+#codex-overleaf-launcher .codex-icon svg {
+  fill: none;
+  stroke: currentColor;
+  stroke-width: 1.45;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+}
+
+#codex-overleaf-panel[data-theme="light"] ~ #codex-overleaf-launcher {
+  border-color: #d7dbe0;
+  background: #f3f4f6;
+  box-shadow: -1px 1px 5px rgba(31, 35, 40, 0.12);
+  color: #6a7280;
+}
+
+#codex-overleaf-panel[data-theme="light"] ~ #codex-overleaf-launcher:hover {
+  background: #eef0f3;
+  color: #3d4651;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  #codex-overleaf-launcher { transition: none; }
+}
+
 :root.codex-overleaf-panel-compact body {
   width: auto !important;
   max-width: none !important;

package/package.json

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