codex-overleaf-link 2.3.1 → 2.3.2

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.1-blue" alt="version">
+    <img src="https://img.shields.io/badge/version-2.3.2-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.1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.1/install.sh)"
+CODEX_OVERLEAF_REF=v2.3.2 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.2/install.sh)"
 ```
 
 Windows PowerShell:
 
 ```powershell
-iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.1/install.ps1 -OutFile install.ps1
-$env:CODEX_OVERLEAF_REF='v2.3.1'
+iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.2/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v2.3.2'
 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.1 -- install-managed
+npm exec --yes codex-overleaf-link@2.3.2 -- 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.1 -- install-managed` |
-| Diagnose | `npm exec --yes codex-overleaf-link@2.3.1 -- doctor` |
-| Uninstall | `npm exec --yes codex-overleaf-link@2.3.1 -- uninstall-managed` |
+| Install / update | `npm exec --yes codex-overleaf-link@2.3.2 -- install-managed` |
+| Diagnose | `npm exec --yes codex-overleaf-link@2.3.2 -- doctor` |
+| Uninstall | `npm exec --yes codex-overleaf-link@2.3.2 -- 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.1 GitHub Release contains:
+The v2.3.2 GitHub Release contains:
 
-- `codex-overleaf-link-extension-v2.3.1.zip`: loadable Chrome extension package for manual unpacked installation.
-- `codex-overleaf-native-host-v2.3.1.tar.gz`: native host runtime files used by the installer and release verification.
-- `codex-overleaf-link-2.3.1.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.1` when run directly from the release artifact.
-- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v2.3.1` when run directly from the release artifact.
+- `codex-overleaf-link-extension-v2.3.2.zip`: loadable Chrome extension package for manual unpacked installation.
+- `codex-overleaf-native-host-v2.3.2.tar.gz`: native host runtime files used by the installer and release verification.
+- `codex-overleaf-link-2.3.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.3.2` when run directly from the release artifact.
+- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v2.3.2` 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.1 GitHub Release contains:
 Remove the native host (use `--browser chromium` on Linux Chromium):
 
 ```bash
-npm exec --yes codex-overleaf-link@2.3.1 -- uninstall-managed
+npm exec --yes codex-overleaf-link@2.3.2 -- 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.1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.1/install.sh)" -- --browser chromium
+CODEX_OVERLEAF_REF=v2.3.2 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.3.2/install.sh)" -- --browser chromium
 ```
 
 Linux Chromium uninstall:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.3.1 -- uninstall-managed --browser chromium
+npm exec --yes codex-overleaf-link@2.3.2 -- 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.1 -- install-managed
+npm exec --yes codex-overleaf-link@2.3.2 -- 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.1 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.1 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.1 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.1 -- install-managed --browser chromium` |
-| Uninstall command | `npm exec --yes codex-overleaf-link@2.3.1 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.1 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.1 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.1 -- uninstall-managed --browser chromium` |
+| Installer/update command | `npm exec --yes codex-overleaf-link@2.3.2 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.2 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.2 -- install-managed` | `npm exec --yes codex-overleaf-link@2.3.2 -- install-managed --browser chromium` |
+| Uninstall command | `npm exec --yes codex-overleaf-link@2.3.2 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.2 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.2 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.3.2 -- 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.1 -- install-managed
+npm exec --yes codex-overleaf-link@2.3.2 -- 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.1 -- install-native
+npm exec --yes codex-overleaf-link@2.3.2 -- install-native
 ```
 
 Legacy native-only installations can be removed with:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.3.1 -- uninstall-native
+npm exec --yes codex-overleaf-link@2.3.2 -- uninstall-native
 ```

package/extension/bootstrap/manifest.template.json

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

package/extension/src/content/assetTransferBroker.js

@@ -0,0 +1,169 @@
+(function initCodexOverleafAssetTransferBroker(root, factory) {
+  const api = factory();
+  if (typeof module === 'object' && module.exports) module.exports = api;
+  if (root) root.CodexOverleafAssetTransferBroker = api;
+})(typeof window !== 'undefined' ? window : globalThis, function assetTransferBrokerFactory() {
+  'use strict';
+
+  const BINARY_TYPES = new Set(['binary-create', 'overwrite-binary']);
+
+  function create(deps = {}) {
+    const { callPageBridge, sendBackgroundNative } = deps;
+
+    async function applyOperations(input = {}) {
+      const results = [];
+      let textBatch = [];
+      async function flushTextBatch() {
+        if (!textBatch.length) return;
+        results.push(await callPageBridge('applyOperations', {
+          operations: textBatch,
+          baseFiles: input.baseFiles || [],
+          requireReviewing: input.requireReviewing === true,
+          requireEditing: input.requireEditing === true,
+          runProjectId: input.runProjectId || ''
+        }));
+        textBatch = [];
+      }
+      for (const operation of Array.isArray(input.operations) ? input.operations : []) {
+        if (!BINARY_TYPES.has(operation?.type)) {
+          textBatch.push(operation);
+          continue;
+        }
+        await flushTextBatch();
+        results.push(await applyBinaryOperation(operation, input));
+      }
+      await flushTextBatch();
+      return mergeApplyResults(results);
+    }
+
+    async function applyBinaryOperation(operation, input) {
+      const transferId = `asset_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+      const assetRef = operation.assetRef || null;
+      const safeOperation = sanitizeOperation(operation);
+      let pageBegun = false;
+      try {
+        const begin = await callPageBridge('binaryUploadBegin', {
+          transferId,
+          path: operation.path,
+          size: Number(operation.size || assetRef?.size || 0),
+          sha256: assetRef?.sha256 || operation.sha256 || '',
+          mimeType: assetRef?.mimeType || operation.mimeType || 'application/octet-stream',
+          overwrite: operation.type === 'overwrite-binary',
+          runProjectId: input.runProjectId || ''
+        });
+        if (!begin?.ok) throw responseError(begin, 'binary_upload_begin_failed');
+        pageBegun = true;
+        if (assetRef?.token) {
+          await streamNativeAsset(assetRef, transferId, input.runProjectId || '');
+        } else if (typeof operation.contentBase64 === 'string' && operation.contentBase64) {
+          const append = await callPageBridge('binaryUploadAppend', {
+            transferId,
+            offset: 0,
+            contentBase64: operation.contentBase64,
+            runProjectId: input.runProjectId || ''
+          });
+          if (!append?.ok) throw responseError(append, 'binary_upload_chunk_failed');
+        } else {
+          throw codedError('binary_asset_payload_missing', 'Binary asset payload is unavailable.');
+        }
+        const committed = await callPageBridge('binaryUploadCommit', {
+          transferId,
+          runProjectId: input.runProjectId || ''
+        });
+        if (!committed?.ok) throw responseError(committed, committed?.code || 'binary_upload_failed');
+        return { ok: true, applied: [{ operation: safeOperation, result: committed }], skipped: [] };
+      } catch (error) {
+        if (pageBegun) {
+          await callPageBridge('binaryUploadAbort', { transferId, runProjectId: input.runProjectId || '' }).catch(() => null);
+        }
+        const code = error.code || 'binary_upload_failed';
+        return {
+          ok: false,
+          applied: [],
+          skipped: [{
+            operation: safeOperation,
+            path: operation.path,
+            result: {
+              ok: false,
+              code,
+              reason: error.message || 'Binary asset upload failed.',
+              changedDocument: false,
+              failure: { code, stage: 'write', file: operation.path, changedDocument: false }
+            }
+          }]
+        };
+      } finally {
+        if (assetRef?.token) {
+          await sendBackgroundNative({ method: 'asset.release', params: { token: assetRef.token } }).catch(() => null);
+        }
+      }
+    }
+
+    async function streamNativeAsset(assetRef, transferId, runProjectId) {
+      let offset = 0;
+      while (offset < Number(assetRef.size || 0)) {
+        const response = await sendBackgroundNative({
+          method: 'asset.readChunk',
+          params: { token: assetRef.token, offset, length: assetRef.chunkSize || 196608 }
+        });
+        if (!response?.ok) throw responseError(response, response?.error?.code || 'asset_chunk_read_failed');
+        const chunk = response.result || {};
+        if (chunk.offset !== offset || typeof chunk.contentBase64 !== 'string' || chunk.nextOffset <= offset) {
+          throw codedError('asset_chunk_sequence_invalid', 'Native asset chunks arrived out of sequence.');
+        }
+        const appended = await callPageBridge('binaryUploadAppend', {
+          transferId,
+          offset,
+          contentBase64: chunk.contentBase64,
+          runProjectId
+        });
+        if (!appended?.ok) throw responseError(appended, appended?.code || 'binary_upload_chunk_failed');
+        offset = chunk.nextOffset;
+        if (chunk.eof) break;
+      }
+      if (offset !== Number(assetRef.size || 0)) {
+        throw codedError('asset_transfer_incomplete', 'Native asset transfer ended before the expected size.');
+      }
+    }
+
+    return { applyOperations };
+  }
+
+  function mergeApplyResults(results) {
+    const merged = { ok: true, applied: [], skipped: [], trackedChanges: [] };
+    for (const result of results) {
+      merged.applied.push(...(Array.isArray(result?.applied) ? result.applied : []));
+      merged.skipped.push(...(Array.isArray(result?.skipped) ? result.skipped : []));
+      // Text writeback returns the Reviewing references captured by the page
+      // bridge. They are lifecycle data, not diagnostics: dropping them makes
+      // recordUndoFromApply classify a successful Track write as legacy Undo,
+      // which hides Accept and prevents the lifecycle from surviving reload.
+      merged.trackedChanges.push(...(Array.isArray(result?.trackedChanges) ? result.trackedChanges : []));
+      if (result?.ok !== true) merged.ok = false;
+    }
+    if (merged.skipped.length) merged.ok = false;
+    return merged;
+  }
+
+  function sanitizeOperation(operation) {
+    const { contentBase64, assetRef, ...safe } = operation || {};
+    if (assetRef) {
+      safe.asset = {
+        path: assetRef.path || safe.path,
+        size: assetRef.size,
+        sha256: assetRef.sha256,
+        mimeType: assetRef.mimeType
+      };
+    }
+    return safe;
+  }
+
+  function responseError(response, fallbackCode) {
+    return codedError(
+      response?.code || response?.error?.code || fallbackCode,
+      response?.reason || response?.error?.message || response?.error || 'Asset transfer failed.'
+    );
+  }
+  function codedError(code, message) { const error = new Error(String(message || code)); error.code = code; return error; }
+  return { create, mergeApplyResults };
+});

package/extension/src/content/contentRuntime.js

@@ -398,8 +398,24 @@
     openStorageSettings
   } = panelMaintenance;
 
+  const sessionForkController = Modules.SessionForkController.create({
+    SessionState: Modules.SessionState,
+    getState: () => state,
+    setState: next => { state = next; },
+    sendBackgroundNative,
+    saveState,
+    applyStateToPanel,
+    showPluginToast,
+    tr
+  });
+  const runResultActions = Modules.RunResultActions.create({
+    tr,
+    getLocale,
+    forkRunFromNode: sessionForkController.forkRunFromNode
+  });
   const runTimelineView = Modules.RunTimelineView.create({
     RunGuidanceView: Modules.RunGuidanceView,
+    RunResultActions: runResultActions,
     tr,
     tx,
     getLocale,
@@ -516,6 +532,7 @@
   // lives in writebackOrchestrator.js. Every dep below is either a hoisted
   // function declaration, an already-initialized const above, or a lazy
   // accessor thunk — safe in the top-of-init() wiring zone.
+  const assetTransferBroker = Modules.AssetTransferBroker.create({ callPageBridge, sendBackgroundNative });
   const writebackOrchestrator = Modules.WritebackOrchestrator.create({
     tr,
     tx,
@@ -555,6 +572,7 @@
     confirmBinaryOperations,
     filterSyncChangesByOperations,
     writebackController,
+    assetTransferBroker,
     writebackSettlement: WritebackSettlement,
     compileAdapter: Modules.CompileAdapter,
     RUN_SNAPSHOT_ZIP_TIMEOUT_MS,
@@ -5477,6 +5495,7 @@
         speedTier: prefs.speedTier || '',
         mode: prefs.mode || '',
         locale: prefs.locale || '',
+        theme: ['dark', 'light', 'auto'].includes(prefs.theme) ? prefs.theme : 'dark',
         requireReviewing: prefs.requireReviewing !== false,
         autoRecompile: prefs.autoRecompile !== false,
         loadCodexLocalSkills: prefs.loadCodexLocalSkills !== false,
@@ -5527,6 +5546,7 @@
           reasoningEffort: fallback.reasoningEffort || '',
           speedTier: fallback.speedTier || '',
           locale: fallback.locale || '',
+          theme: ['dark', 'light', 'auto'].includes(fallback.theme) ? fallback.theme : 'dark',
           requireReviewing: fallback.requireReviewing !== false,
           autoOpen: fallback.autoOpen !== false,
           loadCodexLocalSkills: fallback.loadCodexLocalSkills !== false,
@@ -5876,7 +5896,13 @@
       saveStateSoon();
       return;
     }
-    if (event?.target?.matches?.('[data-speed]')) renderReasoningOptions(getRenderedModelEntries());
+    if (event?.target?.matches?.('[data-speed]')) {
+      // Capability rendering consults state.speedTier. Capture the user's
+      // choice before rebuilding the select, otherwise the rebuild projects
+      // the previous tier back into the DOM and makes Fast appear inert.
+      state.speedTier = event.target.value || 'standard';
+      renderReasoningOptions(getRenderedModelEntries());
+    }
     renderSpeedOptions(getRenderedModelEntries());
     readPanelInputs();
     renderModelConfigChoices();