codex-overleaf-link 2.4.1 → 2.5.0

package/extension/bootstrap/background.js

@@ -6,15 +6,19 @@ const UPDATE_STATE_KEY = 'codex-overleaf-managed-update-state-v1';
 const UPDATE_RELOAD_TABS_KEY = 'codex-overleaf-managed-update-tabs-v1';
 const CHECK_ALARM = 'codex-overleaf-stable-update-check';
 const IDLE_ALARM = 'codex-overleaf-staged-update-idle';
-const OVERLEAF_EDITOR_MATCHES = [
-  'https://www.overleaf.com/project/*',
-  'https://overleaf.com/project/*'
-];
-const OVERLEAF_MATCHES = [
+// Built-in sites. The replaceable runtime manifest may list more; any extra
+// site is used only after Chrome reports its permission as granted, so a later
+// release can add an Overleaf site without changing this Bootstrap file.
+const BUILT_IN_OVERLEAF_MATCHES = Object.freeze([
   'https://www.overleaf.com/project',
   'https://overleaf.com/project',
-  ...OVERLEAF_EDITOR_MATCHES
-];
+  'https://cn.overleaf.com/project',
+  'https://www.overleaf.com/project/*',
+  'https://overleaf.com/project/*',
+  'https://cn.overleaf.com/project/*'
+]);
+let OVERLEAF_MATCHES = [...BUILT_IN_OVERLEAF_MATCHES];
+let OVERLEAF_HOSTS = hostsOf(OVERLEAF_MATCHES);
 const APPLYING_STATES = new Set(['applying', 'awaiting_health', 'rolling_back']);
 const FAST_IDLE_RETRY_BLOCKERS = new Set(['recent_user_activity', 'save_state_not_stable']);
 const FAST_IDLE_RETRY_MS = 4000;
@@ -58,6 +62,10 @@ chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => {
   return undefined;
 });
 
+// A newly granted site starts working without a reload or reinstall.
+chrome.permissions?.onAdded?.addListener(() => { registerManagedRuntime().catch(() => {}); });
+chrome.permissions?.onRemoved?.addListener(() => { registerManagedRuntime().catch(() => {}); });
+
 chrome.alarms.onAlarm.addListener(alarm => {
   if (alarm.name === CHECK_ALARM) {
     checkAndStage().catch(() => {});
@@ -105,6 +113,10 @@ async function registerManagedRuntime() {
   }
   const manifest = await response.json();
   validateRuntimeManifest(manifest);
+  const matches = await grantedMatches(manifest.matches);
+  if (!matches.length) throw new Error('No Overleaf site in the runtime manifest is permitted.');
+  OVERLEAF_MATCHES = [...new Set([...BUILT_IN_OVERLEAF_MATCHES, ...matches])];
+  OVERLEAF_HOSTS = hostsOf(OVERLEAF_MATCHES);
   managedRuntimeAssets = {
     js: ['bootstrap/runtimeContext.js', ...manifest.js.map(value => 'runtime/' + value)],
     css: manifest.css.map(value => 'runtime/' + value)
@@ -115,7 +127,7 @@ async function registerManagedRuntime() {
   }
   await chrome.scripting.registerContentScripts([{
     id: RUNTIME_SCRIPT_ID,
-    matches: manifest.matches,
+    matches,
     js: managedRuntimeAssets.js,
     css: managedRuntimeAssets.css,
     runAt: manifest.runAt || 'document_idle',
@@ -127,7 +139,7 @@ function validateRuntimeManifest(manifest) {
   if (!manifest || manifest.schemaVersion !== 1 || !Array.isArray(manifest.matches) || !Array.isArray(manifest.js) || !Array.isArray(manifest.css)) {
     throw new Error('Managed runtime manifest is invalid.');
   }
-  if (!manifest.matches.length || manifest.matches.some(value => !OVERLEAF_MATCHES.includes(value))) {
+  if (!manifest.matches.length || manifest.matches.some(value => !isProjectMatch(value))) {
     throw new Error('Managed runtime match patterns are invalid.');
   }
   const paths = [...manifest.js, ...manifest.css];
@@ -303,11 +315,36 @@ async function probeTabIdle(tab) {
   return { idle: false, blockers: ['tab_probe_unavailable'] };
 }
 
+// Only project pages on overleaf.com or one of its subdomains: the same scope
+// as optional_host_permissions and web_accessible_resources in the manifest.
+function isProjectMatch(value) {
+  return typeof value === 'string'
+    && /^https:\/\/(?:[a-z0-9-]+\.)*overleaf\.com\/project(?:\/\*)?$/.test(value);
+}
+
+function hostsOf(matches) {
+  return new Set(matches.map(value => {
+    try { return new URL(value.replace(/\*$/, '')).host; } catch (_error) { return ''; }
+  }).filter(Boolean));
+}
+
+// Built-in sites are granted at install; a site a later runtime adds only
+// counts once the user has approved Chrome's prompt for it (see the popup).
+async function grantedMatches(matches) {
+  const result = [];
+  for (const value of matches) {
+    if (BUILT_IN_OVERLEAF_MATCHES.includes(value)) { result.push(value); continue; }
+    const granted = await chrome.permissions.contains({ origins: [value] }).catch(() => false);
+    if (granted) result.push(value);
+  }
+  return result;
+}
+
 function isEditorProjectTab(tab) {
   try {
     const url = new URL(tab?.url || '');
     return url.protocol === 'https:' &&
-      (url.hostname === 'www.overleaf.com' || url.hostname === 'overleaf.com') &&
+      OVERLEAF_HOSTS.has(url.host) &&
       /^\/project\/[^/]+(?:\/|$)/.test(url.pathname);
   } catch (_error) {
     return false;

package/extension/bootstrap/manifest.template.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Codex Overleaf Link",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Connect the active Overleaf project to a local Codex bridge.",
   "icons": {
     "16": "assets/icons/icon16.png",
@@ -20,7 +20,12 @@
     "https://www.overleaf.com/project",
     "https://overleaf.com/project",
     "https://www.overleaf.com/project/*",
-    "https://overleaf.com/project/*"
+    "https://overleaf.com/project/*",
+    "https://cn.overleaf.com/project",
+    "https://cn.overleaf.com/project/*"
+  ],
+  "optional_host_permissions": [
+    "https://*.overleaf.com/*"
   ],
   "background": {
     "service_worker": "bootstrap/background.js"
@@ -36,8 +41,8 @@
         "runtime/src/pageBridge.js"
       ],
       "matches": [
-        "https://www.overleaf.com/*",
-        "https://overleaf.com/*"
+        "https://overleaf.com/*",
+        "https://*.overleaf.com/*"
       ]
     }
   ],

package/extension/bootstrap/popup.html

@@ -1,24 +1,18 @@
 <!doctype html>
-<html>
+<html lang="en" class="popup-minimal-root" data-popup-theme="dark">
   <head>
     <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Codex Overleaf Link</title>
-    <link rel="stylesheet" href="popup.css">
+    <link id="popup-styles" rel="stylesheet" href="../runtime/styles/popup.css">
   </head>
-  <body>
-    <h1 class="popup-brand">Codex Overleaf Link</h1>
-    <div class="version-status" data-popup-context>
-      <span id="compat-status-icon" class="status-icon incompatible" title="Native host incompatible">X</span>
-      <span id="version-pair">Extension unknown / Native unknown</span>
-    </div>
-    <button id="open-panel" data-popup-context>Open panel in Overleaf</button>
-    <p id="status" data-popup-context>Use this on an Overleaf project tab.</p>
-    <div id="native-install" class="install" data-popup-context hidden>
-      <strong>Native host attention required</strong>
-      <p>Run this command in Terminal, then reload this extension in Chrome.</p>
-      <code id="install-command"></code>
-      <button id="copy-install-command" class="secondary" type="button">Copy install command</button>
-    </div>
+  <body class="popup-minimal">
+    <!-- The popup body is drawn by the replaceable runtime (runtime/src/popup.js),
+         so popup changes ship through normal updates. This shell only holds
+         the fallback shown if the runtime cannot load. -->
+    <main id="popup-shell" data-bootstrap-shell>
+      <p class="popup-note">Codex Overleaf Link could not load its runtime. Rerun the installer, then reload the extension.</p>
+    </main>
     <script src="../runtime/src/shared/compatibility.js"></script>
     <script src="../runtime/src/popup.js"></script>
     <script src="updateStatus.js"></script>

package/extension/bootstrap/update.js

@@ -88,6 +88,7 @@
       up_to_date: ['Everything is up to date', 'Extension and Native Host are on the latest stable release.', 'Up to date', 'success'],
       checking: ['Checking for updates', 'Reading the latest signed stable release.', 'Checking', 'active'],
       update_available: ['A stable update is ready', 'Review the target version, then update when convenient.', 'Available', 'success'],
+      manual_install_required: ['This update needs a one-time reinstall', 'Update now cannot apply this release. Run the command below once, then reload the extension and refresh Overleaf. Your sessions, settings, provider keys and project mirrors are kept.', 'Reinstall', 'warning'],
       downloading: ['Downloading the signed release', 'The package is being fetched and verified before any files change.', 'Downloading', 'active'],
       staged: ['Update verified', 'The signed package is ready and waiting for a safe installation point.', 'Verified', 'active'],
       waiting: ['Waiting for a safe point', 'Active Overleaf work will finish before the runtime changes.', 'Waiting', 'warning'],
@@ -164,6 +165,12 @@
         { id: 'install', label: 'Update now', kind: 'primary' }
       ];
     }
+    if (phase === 'manual_install_required') {
+      return [
+        { id: 'later', label: 'Later', kind: 'quiet' },
+        { id: 'copy-command', label: 'Copy command', kind: 'primary' }
+      ];
+    }
     if (['failed', 'rolled_back'].includes(phase)) {
       return [
         { id: 'close', label: 'Close', kind: 'quiet' },
@@ -229,8 +236,14 @@
       ? 'The extension may restart briefly. This window will reconnect and restore the saved progress.'
       : 'This window can stay open while work continues elsewhere. Progress is saved automatically.';
 
-    const technical = technicalText(currentView);
-    elements.details.hidden = !technical || !['failed', 'rolled_back'].includes(presentation.phase);
+    // The signed reason and the exact reinstall command replace the generic
+    // detail; the command stays visible and selectable in the details box.
+    const manual = presentation.phase === 'manual_install_required';
+    const reason = manual ? String(currentView.manualReason?.en || currentView.manualReason?.zh || '').trim() : '';
+    if (reason) elements.detail.textContent = reason + ' ' + presentation.detail;
+    const technical = manual ? manualCommand(target) : technicalText(currentView);
+    elements.details.hidden = !technical || !['failed', 'rolled_back', 'manual_install_required'].includes(presentation.phase);
+    elements.details.open = manual || elements.details.open;
     elements.technicalMessage.textContent = technical;
     renderActions(presentation.phase);
     schedulePolling(presentation.phase);
@@ -286,8 +299,18 @@
     }, 1100);
   }
 
+  function manualCommand(version) {
+    const pinned = /^\d+\.\d+\.\d+$/.test(String(version || '')) ? version : 'latest';
+    return `npm exec --yes codex-overleaf-link@${pinned} -- install-managed`;
+  }
+
   async function runAction(action) {
     if (actionPending) return;
+    if (action === 'copy-command') {
+      const target = versionOf(currentView, ['latestVersion', 'targetVersion', 'availableVersion'], '');
+      await navigator.clipboard.writeText(manualCommand(target)).catch(() => {});
+      return;
+    }
     if (action === 'close') {
       window.close();
       return;

package/extension/runtime-manifest.json

@@ -4,7 +4,9 @@
     "https://www.overleaf.com/project",
     "https://overleaf.com/project",
     "https://www.overleaf.com/project/*",
-    "https://overleaf.com/project/*"
+    "https://overleaf.com/project/*",
+    "https://cn.overleaf.com/project",
+    "https://cn.overleaf.com/project/*"
   ],
   "js": [
     "src/content/generated/content.bundle.js"

package/extension/src/background.js

@@ -20,6 +20,29 @@ if (!globalThis.CodexOverleafGlobalPreferences) {
   importScripts(runtimeBase ? chrome.runtime.getURL(`${runtimeBase}/src/shared/globalPreferences.js`) : 'shared/globalPreferences.js');
 }
 globalThis.CodexOverleafGlobalPreferences?.installBackground(chrome);
+if (!globalThis.CodexOverleafStorageRunActions) {
+  const runtimeBase = String(globalThis.__CODEX_OVERLEAF_RUNTIME_BASE__ || '');
+  // The service worker has its own loading graph; the content bundle's
+  // registry and shared-module imports do not exist in this context.
+  const storageDependencies = [
+    ['CodexOverleafModuleRegistry', 'content/moduleRegistryKernel.js'],
+    ['CodexOverleafUndoOperations', 'shared/undoOperations.js'],
+    ['CodexOverleafSelectionContext', 'shared/selectionContext.js'],
+    ['CodexOverleafWritebackIntent', 'shared/writebackIntent.js'],
+    ['CodexOverleafWritingStyle', 'shared/writingStyle.js'],
+    ['CodexOverleafStorageRunActions', 'shared/storageRunActions.js']
+  ];
+  for (const [globalName, scriptPath] of storageDependencies) {
+    if (!globalThis[globalName]) {
+      importScripts(runtimeBase ? chrome.runtime.getURL(`${runtimeBase}/src/${scriptPath}`) : scriptPath);
+    }
+  }
+}
+if (!globalThis.CodexOverleafSharedSessionsBackground) {
+  const runtimeBase = String(globalThis.__CODEX_OVERLEAF_RUNTIME_BASE__ || '');
+  importScripts(runtimeBase ? chrome.runtime.getURL(`${runtimeBase}/src/backgroundSharedSessions.js`) : 'backgroundSharedSessions.js');
+}
+globalThis.CodexOverleafSharedSessionsBackground.installBackground(chrome);
 if (!globalThis.CodexOverleafUpdateRuntimeIdentity) {
   const runtimeBase = String(globalThis.__CODEX_OVERLEAF_RUNTIME_BASE__ || '');
   importScripts(runtimeBase ? chrome.runtime.getURL(`${runtimeBase}/src/shared/updateRuntimeIdentity.js`) : 'shared/updateRuntimeIdentity.js');
@@ -35,8 +58,10 @@ if (!globalThis.CodexOverleafUpdateRuntimeIdentity) {
   const MANAGED_OVERLEAF_MATCHES = [
     'https://www.overleaf.com/project',
     'https://overleaf.com/project',
+    'https://cn.overleaf.com/project',
     'https://www.overleaf.com/project/*',
-    'https://overleaf.com/project/*'
+    'https://overleaf.com/project/*',
+    'https://cn.overleaf.com/project/*'
   ];
   const COMPATIBILITY_REQUIRED_METHODS = new Set([
     'codex.run',
@@ -382,7 +407,7 @@ if (!globalThis.CodexOverleafUpdateRuntimeIdentity) {
     try {
       const url = new URL(tab?.url || '');
       return url.protocol === 'https:' &&
-        (url.hostname === 'www.overleaf.com' || url.hostname === 'overleaf.com') &&
+        (['overleaf.com', 'www.overleaf.com', 'cn.overleaf.com'].includes(url.hostname)) &&
         /^\/project\/[^/]+(?:\/|$)/.test(url.pathname);
     } catch (_error) {
       return false;
@@ -853,7 +878,7 @@ if (!globalThis.CodexOverleafUpdateRuntimeIdentity) {
     try {
       const url = new URL(senderUrl);
       return url.protocol === 'https:' && (
-        url.hostname === 'www.overleaf.com' || url.hostname === 'overleaf.com'
+        ['overleaf.com', 'www.overleaf.com', 'cn.overleaf.com'].includes(url.hostname)
       );
     } catch (_error) {
       return false;