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

package/extension/bootstrap/manifest.template.json

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

package/extension/src/content/contentRuntime.js

@@ -1,6 +1,5 @@
 (function initCodexOverleafContentRuntime(root) {
   'use strict';
-
   function init() {
   'use strict';
 
@@ -438,7 +437,7 @@
     saveState,
     saveStateSoon,
     readPanelInputs,
-    applyStateToPanel,
+    applyStateToPanel, syncSessionProvider: () => providerSettingsCoordinator.syncSessionProvider(),
     getPanel: () => panel,
     getState: () => state,
     setState: next => { state = next; },
@@ -569,7 +568,8 @@
     tr,
     tx,
     getLocale,
-    sendBackgroundNative,
+    sendBackgroundNative, getProviderSelection: () => providerSettingsCoordinator.getRunSelection(state?.providerId)
+      || { providerId: state?.providerId || 'builtin', providerRevision: 0 },
     readSelectedSpeedInput,
     getRenderedModelEntries,
     persistPanelInputs,
@@ -603,8 +603,8 @@
     document,
     window,
     getSettingsPanelInstance: () => settingsPanelInstance,
-    getSelectedModel: () => state?.model || '',
-    clearSelectedModel: () => { if (state) state.model = ''; },
+    getSelectedModel: () => state?.model || '', getSelectedProviderId: () => state?.providerId || 'builtin',
+    setSelectedProviderId: providerId => { state = updateActiveSession(state, { providerId: providerId || 'builtin' }); },
     refreshModelOptions: loadModelOptions, persistInputs: persistPanelInputs
   });
   // v1.8.1 D3: the dashboard was a one-shot render — another tab finishing a
@@ -898,9 +898,7 @@
         }
       })
       .catch(() => { /* fail-closed inside refreshAccountScopeId */ });
-    loadModelOptions().catch(error => {
-      applyFallbackModelOptions(resolveSelectedModel(), error);
-    });
+    providerSettingsCoordinator.syncSessionProvider().catch(() => {});
     syncOtWarmMirrorController().catch(error => {
       updateOtStatusDisplay('unavailable');
       appendPlainLog(tx(`Failed to sync experimental OT warm mirror: ${error.message}`, `同步实验性 OT 预热镜像失败：${error.message}`));
@@ -2935,7 +2933,7 @@
     });
     return {
       ...params,
-      providerSelection: providerSettingsCoordinator.getRunSelection()
+      providerSelection: providerSettingsCoordinator.getRunSelection(state?.providerId)
     };
   }
 
@@ -2949,6 +2947,7 @@
       sessionId: input.sessionId || '',
       turnId: currentRunView?.recordId || '',
       mode: input.mode || state?.mode || '',
+      ...providerSettingsCoordinator.getProviderSnapshot(state?.providerId),
       model: state?.model || '',
       reasoningEffort: state?.reasoningEffort || '',
       speedTier: state?.speedTier || '',
@@ -5967,7 +5966,7 @@
       const { prefs, sessions, activeSessionId } = await Migration.runMigrationIfNeeded(projectId, legacyKey);
 
       return {
-        model: prefs.model || '',
+        model: prefs.model || '', providerId: prefs.providerId || 'builtin',
         reasoningEffort: prefs.reasoningEffort || '',
         speedTier: prefs.speedTier || '',
         mode: prefs.mode || '',
@@ -5992,7 +5991,7 @@
           runs: Array.isArray(session.runs) ? session.runs : [],
           history: Array.isArray(session.history) ? session.history : [],
           task: typeof session.task === 'string' ? session.task : '',
-          mode: session.mode || prefs.mode || 'confirm',
+          mode: session.mode || prefs.mode || 'confirm', providerId: session.providerId || 'builtin',
           model: session.model || prefs.model || 'gpt-5.4',
           reasoningEffort: session.reasoningEffort || prefs.reasoningEffort || 'high',
           speedTier: session.speedTier || prefs.speedTier || 'standard',
@@ -6012,7 +6011,7 @@
       const fallback = stored[storageKey] || stored[LEGACY_STORAGE_KEY] || {};
       if (fallback?.__codexOverleafCompactFallback === true) {
         return {
-          mode: fallback.mode || '',
+          mode: fallback.mode || '', providerId: fallback.providerId || 'builtin',
           model: fallback.model || '',
           reasoningEffort: fallback.reasoningEffort || '',
           speedTier: fallback.speedTier || '',
@@ -6453,7 +6452,7 @@
 
   function applyStateToPanel() {
     applyPanelTheme(getThemePreference());
-    if (!modelSelectHasOption(state.model)) {
+    if ((state.providerId || 'builtin') === 'builtin' && !modelSelectHasOption(state.model)) {
       renderModelOptions(getModelCatalog().FALLBACK_MODELS, state.model);
     }
     panel.querySelector('[data-model]').value = state.model;
@@ -6545,6 +6544,7 @@
       id: createRunId(),
       task,
       mode,
+      ...providerSettingsCoordinator.getProviderSnapshot(state?.providerId),
       model,
       reasoningEffort,
       speedTier,

package/extension/src/content/modelPicker.js

@@ -13,6 +13,7 @@
       tx,
       getLocale,
       sendBackgroundNative,
+      getProviderSelection,
       readSelectedSpeedInput,
       getRenderedModelEntries,
       persistPanelInputs,
@@ -33,6 +34,7 @@
     } = Support;
 
   let modelDiscovery = { status: 'fallback', source: 'fallback', fetchedAt: '' };
+  let modelLoadGeneration = 0;
 
   function getModelDiscovery() {
     return modelDiscovery;
@@ -96,7 +98,9 @@
     updateModelDisplay();
     await persistPanelInputs();
   }
-  async function loadModelOptions() {
+  async function loadModelOptions(providerSelection) {
+    const generation = ++modelLoadGeneration;
+    const selection = providerSelection || getProviderSelection?.() || null;
     const selectedModel = resolveSelectedModel();
     const modelCatalog = getModelCatalog();
     const fallbackModels = modelCatalog.FALLBACK_MODELS;
@@ -104,8 +108,19 @@
     try {
       const response = await sendBackgroundNative({
         method: 'codex.models',
-        params: {}
+        params: selection ? { providerSelection: selection } : {}
       });
+      if (generation !== modelLoadGeneration) {
+        return { stale: true };
+      }
+      const responseProviderId = response?.result?.providerId || '';
+      if (selection?.providerId && responseProviderId && responseProviderId !== selection.providerId) {
+        return { stale: true };
+      }
+      if (selection?.providerId && selection.providerId !== 'builtin'
+        && Number(response?.result?.providerRevision) !== Number(selection.providerRevision)) {
+        return { stale: true };
+      }
       const currentSelectedModel = resolveSelectedModel() || selectedModel;
       const hasDiscoveredModels = response?.ok
         && Array.isArray(response.result?.models)
@@ -121,17 +136,25 @@
         applyUnavailableModelOptions({ code: 'provider_model_catalog_invalid', message: 'The active provider returned no usable models.' });
         return;
       }
-      renderModelOptions(normalized.models, retainedSelectedModel);
+      renderModelOptions(normalized.models, retainedSelectedModel, { allowUnknownSelected: false });
       modelDiscovery = {
         status: hasDiscoveredModels && !normalized.usedFallback ? 'discovered' : 'fallback',
         source: hasDiscoveredModels ? response.result?.source || 'unknown' : 'fallback',
         fetchedAt: hasDiscoveredModels ? response.result?.fetchedAt || '' : '',
         errorCode: hasDiscoveredModels ? '' : response?.error?.code || '',
-        errorMessage: hasDiscoveredModels ? '' : response?.error?.message || ''
+        errorMessage: hasDiscoveredModels ? '' : response?.error?.message || '',
+        providerId: responseProviderId || selection?.providerId || 'builtin',
+        providerRevision: Number(response?.result?.providerRevision || selection?.providerRevision || 0)
       };
       updateModelDisplay();
+      await persistPanelInputs();
+      return { stale: false, providerId: modelDiscovery.providerId };
     } catch (error) {
+      if (generation !== modelLoadGeneration) {
+        return { stale: true };
+      }
       applyUnavailableModelOptions(error);
+      return { stale: false, error };
     }
   }
 
@@ -140,14 +163,13 @@
     if (modelSelect) {
       modelSelect.textContent = '';
       const option = document.createElement('option');
-      option.value = '';
+      option.value = resolveSelectedModel();
       option.textContent = tx('Models unavailable', '模型不可用');
       option.disabled = true;
       modelSelect.append(option);
       modelSelect.value = '';
       modelSelect.disabled = true;
     }
-    if (getState()) getState().model = '';
     modelDiscovery = {
       status: 'unavailable',
       source: 'custom-provider',
@@ -182,7 +204,7 @@
     return Support.getModelCatalog({ getPanel });
   }
 
-  function renderModelOptions(models, selectedModel) {
+  function renderModelOptions(models, selectedModel, options = {}) {
     const modelSelect = getPanel()?.querySelector('[data-model]');
     if (!modelSelect) {
       return;
@@ -219,7 +241,7 @@
       }
     }
 
-    if (selectedId && !renderedSelected) {
+    if (selectedId && !renderedSelected && options.allowUnknownSelected !== false) {
       const option = document.createElement('option');
       option.value = selectedId;
       option.textContent = `${selectedId} (custom)`;

package/extension/src/content/providerSettingsCoordinator.js

@@ -8,6 +8,8 @@
       sendBackgroundNative: options.sendBackgroundNative,
       getSettingsPanelInstance: options.getSettingsPanelInstance || (() => null),
       getSelectedModel: options.getSelectedModel || (() => ''),
+      getSelectedProviderId: options.getSelectedProviderId || (() => 'builtin'),
+      setSelectedProviderId: options.setSelectedProviderId || (() => {}),
       clearSelectedModel: options.clearSelectedModel || (() => {}),
       refreshModelOptions: options.refreshModelOptions || (() => {}),
       persistInputs: options.persistInputs || (() => {}),
@@ -38,7 +40,12 @@
       open: () => open(instance),
       refreshSummary: () => refresh(instance),
       ensureLoaded: () => ensureLoaded(instance),
-      getRunSelection: () => instance.loaded ? Profiles.buildRunSelection(instance.catalog) : null,
+      getRunSelection: providerId => instance.loaded
+        ? Profiles.buildRunSelection(instance.catalog, providerId || instance.getSelectedProviderId())
+        : null,
+      getProviderSnapshot: providerId => getProviderSnapshot(instance, providerId),
+      isProviderAvailable: providerId => Boolean(Profiles.getProviderById(instance.catalog, providerId)),
+      syncSessionProvider: () => syncSessionProvider(instance),
       getCatalog: () => instance.catalog,
       destroy: () => destroy(instance),
       _instance: instance
@@ -86,19 +93,33 @@
     return instance.catalog;
   }
 
+  async function syncSessionProvider(instance) {
+    try {
+      await ensureLoaded(instance);
+    } catch (_error) {
+      return instance.refreshModelOptions(
+        window.CodexOverleafProviderProfiles.buildRunSelection(instance.catalog, instance.getSelectedProviderId())
+      );
+    }
+    return reconcileProviderSelection(instance, instance.catalog, { forceSessionRefresh: true });
+  }
+
   async function reconcileProviderSelection(instance, catalog, change = {}) {
-    if (!change.activeProviderChanged && !change.activeModelCatalogChanged) {
-      return;
+    const previousProviderId = instance.getSelectedProviderId() || 'builtin';
+    const requestedProviderId = typeof change.sessionProviderId === 'string' && change.sessionProviderId
+      ? change.sessionProviderId
+      : previousProviderId;
+    const sessionProviderChanged = requestedProviderId !== previousProviderId;
+    if (sessionProviderChanged) {
+      instance.setSelectedProviderId(requestedProviderId);
     }
-    const previousModel = instance.getSelectedModel();
-    const activeProvider = window.CodexOverleafProviderProfiles.getActiveProvider(catalog);
-    const previousModelUnavailable = activeProvider.kind === 'custom'
-      && previousModel
-      && !activeProvider.models.some(model => model.id === previousModel);
-    if (change.activeProviderChanged || previousModelUnavailable) {
-      instance.clearSelectedModel();
+    const changedProviderIds = Array.isArray(change.changedProviderIds) ? change.changedProviderIds : [];
+    if (!change.forceSessionRefresh && !sessionProviderChanged && !changedProviderIds.includes(requestedProviderId)) {
+      return;
     }
-    await instance.refreshModelOptions();
+    await instance.refreshModelOptions(
+      window.CodexOverleafProviderProfiles.buildRunSelection(catalog, requestedProviderId)
+    );
     await instance.persistInputs();
   }
 
@@ -174,7 +195,9 @@
         updateDialog: true,
         selectedId: result.savedProviderId
       });
-      await notifyChanged(instance, applied.change);
+      await notifyChanged(instance, applied.change, action.activate === true
+        ? { sessionProviderId: result.savedProviderId }
+        : {});
       instance.dialog.setBusy('', '');
       const fellBackToBuiltin = previousCatalog.activeProviderId === result.savedProviderId
         && result.activeProviderId === 'builtin'
@@ -249,7 +272,7 @@
         updateDialog: true,
         selectedId: context.profileId
       });
-      await notifyChanged(instance, applied.change);
+      await notifyChanged(instance, applied.change, { sessionProviderId: context.profileId });
       instance.dialog.setBusy('', '');
       instance.dialog.setStatus({
         tone: 'success',
@@ -269,7 +292,7 @@
         expectedRevision: 0
       });
       const applied = applyCatalog(instance, result, { updateDialog: true, selectedId: 'builtin' });
-      await notifyChanged(instance, applied.change);
+      await notifyChanged(instance, applied.change, { sessionProviderId: 'builtin' });
       instance.dialog.setBusy('', '');
       instance.dialog.setStatus({ tone: 'success', title: instance.tx('Built-in Codex is active.', '已启用内置 Codex。') });
     } catch (error) {
@@ -315,22 +338,22 @@
   function updateSettingsSummary(instance, override = {}) {
     const active = window.CodexOverleafProviderProfiles.getActiveProvider(instance.catalog);
     const summary = override.summary || (active.kind === 'builtin'
-      ? instance.tx('Built-in Codex is active', '当前使用内置 Codex')
-      : `${active.name} · ${active.defaultModelId || instance.tx('No model', '未配置模型')} · ${instance.tx('Active', '使用中')}`);
+      ? instance.tx('Built-in Codex · default for new sessions', '内置 Codex · 新会话默认')
+      : `${active.name} · ${active.defaultModelId || instance.tx('No model', '未配置模型')} · ${instance.tx('Default for new sessions', '新会话默认')}`);
     instance.getSettingsPanelInstance()?.setProviderSummary?.({
       summary,
       tone: override.tone || (active.kind === 'custom' && active.wireApiPreference === 'auto' && !active.resolvedWireApi ? 'warning' : 'ok')
     });
   }
 
-  async function notifyChanged(instance, change = emptyCatalogChange()) {
+  async function notifyChanged(instance, change = emptyCatalogChange(), localChange = {}) {
     try {
       instance.channel?.postMessage?.({ type: 'provider-settings-changed', change, at: Date.now() });
     } catch (_error) {
       // Revision checks remain authoritative when BroadcastChannel is unavailable.
     }
     try {
-      await instance.onProviderChanged(instance.catalog, change);
+      await instance.onProviderChanged(instance.catalog, { ...change, ...localChange });
     } catch (_error) {
       // The authoritative catalog is already saved. A later refresh can retry
       // the local model projection without rolling back the provider change.
@@ -356,9 +379,19 @@
   function describeCatalogChange(previous, next) {
     const previousActive = window.CodexOverleafProviderProfiles.getActiveProvider(previous);
     const nextActive = window.CodexOverleafProviderProfiles.getActiveProvider(next);
+    const providerIds = new Set([
+      ...(previous.providers || []).map(provider => provider.id),
+      ...(next.providers || []).map(provider => provider.id)
+    ]);
+    const changedProviderIds = Array.from(providerIds).filter(providerId => {
+      const previousProvider = window.CodexOverleafProviderProfiles.getProviderById(previous, providerId);
+      const nextProvider = window.CodexOverleafProviderProfiles.getProviderById(next, providerId);
+      return modelCatalogSignature(previousProvider) !== modelCatalogSignature(nextProvider);
+    });
     return {
       activeProviderChanged: previousActive.id !== nextActive.id,
-      activeModelCatalogChanged: modelCatalogSignature(previousActive) !== modelCatalogSignature(nextActive)
+      activeModelCatalogChanged: modelCatalogSignature(previousActive) !== modelCatalogSignature(nextActive),
+      changedProviderIds
     };
   }
 
@@ -377,7 +410,32 @@
   }
 
   function emptyCatalogChange() {
-    return { activeProviderChanged: false, activeModelCatalogChanged: false };
+    return { activeProviderChanged: false, activeModelCatalogChanged: false, changedProviderIds: [] };
+  }
+
+  function getProviderSnapshot(instance, providerId) {
+    const requestedId = providerId || instance.getSelectedProviderId() || 'builtin';
+    const provider = window.CodexOverleafProviderProfiles.getProviderById(instance.catalog, requestedId);
+    if (!provider) {
+      return {
+        providerId: requestedId,
+        providerName: 'Unavailable provider',
+        providerRevision: 0,
+        providerEndpointHost: ''
+      };
+    }
+    let endpointHost = '';
+    try {
+      endpointHost = provider.baseUrl ? new URL(provider.baseUrl).host : '';
+    } catch (_error) {
+      endpointHost = '';
+    }
+    return {
+      providerId: provider.id,
+      providerName: provider.name || provider.id,
+      providerRevision: provider.revision || 0,
+      providerEndpointHost: endpointHost
+    };
   }
 
   function formatError(instance, error) {

package/extension/src/content/providerSettingsDialog.js

@@ -408,10 +408,31 @@
           ))}</span>
       </label>
       <div class="codex-provider-test-row">
-        <select data-provider-test-model aria-label="${escapeAttr(tx('Model to test', '要测试的模型'))}">
-          ${(draft.models || []).map(model => `<option value="${escapeAttr(model.id)}" ${model.id === draft.defaultModelId ? 'selected' : ''}>${escapeHtml(model.label || model.id)}</option>`).join('')}
-        </select>
-        <button type="button" class="codex-provider-secondary-button" data-provider-action="test">${escapeHtml(tx('Test connection', '测试连接'))}</button>
+        <div class="codex-provider-test-copy">
+          <strong>${escapeHtml(tx('Connection check', '连接检查'))}</strong>
+          <span>${escapeHtml(tx('Probe one model before using this provider.', '使用此服务商前，可选择一个模型进行探测。'))}</span>
+        </div>
+        <div class="codex-provider-test-controls">
+          <label class="codex-provider-test-model">
+            <span class="codex-provider-test-model-label">${escapeHtml(tx('Test model', '测试模型'))}</span>
+            <span class="codex-provider-test-select-shell">
+              <select data-provider-test-model aria-label="${escapeAttr(tx('Model to test', '要测试的模型'))}">
+                ${(draft.models || []).map(model => `<option value="${escapeAttr(model.id)}" ${model.id === draft.defaultModelId ? 'selected' : ''}>${escapeHtml(model.label || model.id)}</option>`).join('')}
+              </select>
+              <svg class="codex-provider-test-chevron" viewBox="0 0 16 16" aria-hidden="true">
+                <path d="m4 6 4 4 4-4"></path>
+              </svg>
+            </span>
+          </label>
+          <button type="button" class="codex-provider-test-button" data-provider-action="test">
+            <svg viewBox="0 0 18 18" aria-hidden="true">
+              <circle cx="5" cy="9" r="2.25"></circle>
+              <circle cx="13" cy="9" r="2.25"></circle>
+              <path d="M7.25 9h3.5"></path>
+            </svg>
+            <span data-provider-test-action-label>${escapeHtml(tx('Test connection', '测试连接'))}</span>
+          </button>
+        </div>
         <span class="codex-provider-test-state" data-provider-test-state>${escapeHtml(formatVerification(instance, provider, draft.defaultModelId))}</span>
       </div>
     `;
@@ -918,9 +939,13 @@
     if (!button) return;
     const testing = instance.busy === 'testing';
     button.dataset.providerAction = testing ? 'cancel-test' : 'test';
-    button.textContent = testing
+    const actionLabel = testing
       ? instance.tx('Cancel test', '取消测试')
       : instance.tx('Test connection', '测试连接');
+    const labelEl = button.querySelector('[data-provider-test-action-label]');
+    if (labelEl) labelEl.textContent = actionLabel;
+    else button.textContent = actionLabel;
+    button.setAttribute('aria-label', actionLabel);
   }
 
   function formatSecretSavedAt(instance, value) {

package/extension/src/content/sessionManager.js

@@ -28,6 +28,7 @@
       saveStateSoon,
       readPanelInputs,
       applyStateToPanel,
+      syncSessionProvider,
       getPanel,
       getState,
       setState,
@@ -98,6 +99,7 @@
     }
     const session = createSession({
       mode: getState().mode,
+      providerId: getState().providerId || 'builtin',
       model: getState().model,
       reasoningEffort: getState().reasoningEffort,
       speedTier: getState().speedTier,
@@ -108,8 +110,9 @@
       sessions: [...(getState().sessions || []), session].slice(-20),
       activeSessionId: session.id
     }));
-    await saveState();
     applyStateToPanel();
+    await syncSessionProvider?.();
+    await saveState();
     getPanel().querySelector('[data-task]')?.focus();
   }
 
@@ -130,8 +133,9 @@
     }
     readPanelInputs();
     setState(setActiveSession(getState(), sessionId));
-    await saveState();
     applyStateToPanel();
+    await syncSessionProvider?.();
+    await saveState();
   }
 
   async function deleteSessionWithConfirm(sessionId) {

package/extension/src/shared/auditRecords.js

@@ -31,6 +31,10 @@
       createdAt: redactSecretLikeText(stringField(input.createdAt)) || now,
       completedAt: '',
       mode: redactSecretLikeText(stringField(input.mode)),
+      providerId: redactSecretLikeText(stringField(input.providerId)) || 'builtin',
+      providerName: redactSecretLikeText(stringField(input.providerName)),
+      providerRevision: finiteNumber(input.providerRevision) || 0,
+      providerEndpointHost: redactSecretLikeText(stringField(input.providerEndpointHost)),
       model: redactSecretLikeText(stringField(input.model)),
       reasoningEffort: redactSecretLikeText(stringField(input.reasoningEffort)),
       speedTier: redactSecretLikeText(stringField(input.speedTier)),
@@ -85,6 +89,10 @@
       createdAt: redactSecretLikeText(stringField(input.createdAt)) || new Date().toISOString(),
       completedAt: redactSecretLikeText(stringField(input.completedAt)),
       mode: redactSecretLikeText(stringField(input.mode)),
+      providerId: redactSecretLikeText(stringField(input.providerId)) || 'builtin',
+      providerName: redactSecretLikeText(stringField(input.providerName)),
+      providerRevision: finiteNumber(input.providerRevision) || 0,
+      providerEndpointHost: redactSecretLikeText(stringField(input.providerEndpointHost)),
       model: redactSecretLikeText(stringField(input.model)),
       reasoningEffort: redactSecretLikeText(stringField(input.reasoningEffort)),
       speedTier: redactSecretLikeText(stringField(input.speedTier)),

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

package/extension/src/shared/providerProfiles.js

@@ -175,11 +175,23 @@
       || buildBuiltinProvider();
   }
 
-  function buildRunSelection(catalog = {}) {
-    const active = getActiveProvider(catalog);
+  function getProviderById(catalog = {}, providerId = '') {
+    const normalized = normalizeCatalog(catalog);
+    const requestedId = normalizeText(providerId) || normalized.activeProviderId || BUILTIN_PROVIDER_ID;
+    if (requestedId === BUILTIN_PROVIDER_ID) {
+      return normalized.providers.find(provider => provider.id === BUILTIN_PROVIDER_ID)
+        || buildBuiltinProvider();
+    }
+    return normalized.providers.find(provider => provider.id === requestedId) || null;
+  }
+
+  function buildRunSelection(catalog = {}, providerId = '') {
+    const normalized = normalizeCatalog(catalog);
+    const requestedId = normalizeText(providerId) || normalized.activeProviderId || BUILTIN_PROVIDER_ID;
+    const provider = getProviderById(normalized, requestedId);
     return {
-      providerId: active.id,
-      providerRevision: active.revision || 0
+      providerId: requestedId,
+      providerRevision: provider?.revision || 0
     };
   }
 
@@ -277,6 +289,7 @@
     buildEmptyDraft,
     buildRunSelection,
     getActiveProvider,
+    getProviderById,
     normalizeCatalog,
     normalizeProvider
   };

package/extension/src/shared/sessionState.js

@@ -13,6 +13,7 @@
 
   const DEFAULT_PANEL_STATE = {
     mode: 'confirm',
+    providerId: 'builtin',
     model: 'gpt-5.4',
     reasoningEffort: 'high',
     speedTier: 'standard',
@@ -177,6 +178,7 @@
       ...legacySession,
       task: state.task,
       mode: state.mode,
+      providerId: 'builtin',
       model: state.model,
       reasoningEffort: state.reasoningEffort,
       speedTier: state.speedTier,
@@ -208,6 +210,9 @@
       runs,
       task: sanitizeAssistantVisibleText(session.task),
       mode: VALID_MODES.has(session.mode) ? session.mode : fallbackState.mode,
+      providerId: typeof session.providerId === 'string' && session.providerId.trim()
+        ? session.providerId.trim()
+        : 'builtin',
       model: typeof session.model === 'string' && session.model ? session.model : fallbackState.model,
       reasoningEffort: VALID_REASONING.has(session.reasoningEffort)
         ? session.reasoningEffort
@@ -237,6 +242,7 @@
         id: `recovered_${session.id}_${index}`,
         task,
         mode: session.mode,
+        providerId: session.providerId || 'builtin',
         model: session.model,
         reasoningEffort: session.reasoningEffort,
         speedTier: session.speedTier,
@@ -269,6 +275,7 @@
     if (!active) {
       const session = createSession({
         mode: state.mode,
+        providerId: state.providerId,
         model: state.model,
         reasoningEffort: state.reasoningEffort,
         speedTier: state.speedTier,
@@ -283,12 +290,16 @@
       id: active.id,
       history: Array.isArray(active.history) ? active.history.slice(-10) : [],
       focusFiles: normalizeFocusFiles(active.focusFiles),
-      codexThreadId: active.codexThreadId || ''
+      codexThreadId: active.codexThreadId || '',
+      providerId: active.providerId || 'builtin'
     };
     state.runs = Array.isArray(active.runs) ? active.runs : [];
     state.task = typeof active.task === 'string' ? active.task : '';
     state.focusFiles = normalizeFocusFiles(active.focusFiles);
     state.mode = VALID_MODES.has(active.mode) ? active.mode : DEFAULT_PANEL_STATE.mode;
+    state.providerId = typeof active.providerId === 'string' && active.providerId
+      ? active.providerId
+      : 'builtin';
     state.model = typeof active.model === 'string' && active.model ? active.model : DEFAULT_PANEL_STATE.model;
     state.reasoningEffort = VALID_REASONING.has(active.reasoningEffort)
       ? active.reasoningEffort
@@ -318,6 +329,9 @@
       runs,
       task: sanitizeAssistantVisibleText(overrides.task),
       mode: VALID_MODES.has(overrides.mode) ? overrides.mode : DEFAULT_PANEL_STATE.mode,
+      providerId: typeof overrides.providerId === 'string' && overrides.providerId.trim()
+        ? overrides.providerId.trim()
+        : 'builtin',
       model: typeof overrides.model === 'string' && overrides.model ? overrides.model : DEFAULT_PANEL_STATE.model,
       reasoningEffort: VALID_REASONING.has(overrides.reasoningEffort)
         ? overrides.reasoningEffort
@@ -404,6 +418,7 @@
     if (!remaining.length) {
       const replacement = createSession({
         mode: state.mode,
+        providerId: state.providerId,
         model: state.model,
         reasoningEffort: state.reasoningEffort,
         speedTier: state.speedTier,
@@ -589,6 +604,10 @@
       id: run.id,
       task: sanitizeAssistantVisibleText(run.task) || 'untitled task',
       mode: typeof run.mode === 'string' ? run.mode : '',
+      providerId: typeof run.providerId === 'string' && run.providerId ? run.providerId : 'builtin',
+      providerName: typeof run.providerName === 'string' ? run.providerName : '',
+      providerRevision: Number.isFinite(Number(run.providerRevision)) ? Number(run.providerRevision) : 0,
+      providerEndpointHost: typeof run.providerEndpointHost === 'string' ? run.providerEndpointHost : '',
       model: typeof run.model === 'string' ? run.model : '',
       reasoningEffort: typeof run.reasoningEffort === 'string' ? run.reasoningEffort : '',
       speedTier: typeof run.speedTier === 'string' ? run.speedTier : '',

package/extension/src/shared/storageDb.js

@@ -6,7 +6,7 @@
   }
 })(typeof globalThis !== 'undefined' ? globalThis : window, function storageDbFactory(StorageRunActions) {
   'use strict';
-  if (!StorageRunActions?.compactRunsForStorage || !StorageRunActions?.compactRunActionPayload) {
+  if (!StorageRunActions?.compactRunsForStorage || !StorageRunActions?.compactRunActionPayload || !StorageRunActions?.compactProviderSnapshot) {
     throw new Error('Codex Overleaf storage run-action helpers are unavailable.');
   }
   // IndexedDB versions are monotonic; v2.0 RC profiles have already opened v3.
@@ -275,7 +275,7 @@
       history: compactHistoryForStorage(input.history),
       runs: compactRunsForStorage(input.runs, options),
       task: normalizeDisplayTextForStorage(input.task, SESSION_STORAGE_LIMITS.taskChars),
-      mode: typeof input.mode === 'string' ? input.mode : '',
+      mode: typeof input.mode === 'string' ? input.mode : '', providerId: typeof input.providerId === 'string' && input.providerId ? input.providerId : 'builtin',
       model: typeof input.model === 'string' ? input.model : '',
       reasoningEffort: typeof input.reasoningEffort === 'string' ? input.reasoningEffort : '',
       speedTier: typeof input.speedTier === 'string' ? input.speedTier : '',
@@ -402,7 +402,7 @@
       turnId: typeof input.turnId === 'string' ? input.turnId : '',
       createdAt: typeof input.createdAt === 'string' ? input.createdAt : now,
       completedAt: typeof input.completedAt === 'string' ? input.completedAt : '',
-      mode: typeof input.mode === 'string' ? input.mode : '',
+      mode: typeof input.mode === 'string' ? input.mode : '', ...StorageRunActions.compactProviderSnapshot(input),
       model: typeof input.model === 'string' ? input.model : '',
       reasoningEffort: typeof input.reasoningEffort === 'string' ? input.reasoningEffort : '',
       speedTier: typeof input.speedTier === 'string' ? input.speedTier : '',
@@ -426,7 +426,7 @@
 
   function extractLightweightPrefs(state, projectId) {
     var prefs = {
-      storageSchemaVersion: TARGET_SCHEMA_VERSION,
+      storageSchemaVersion: TARGET_SCHEMA_VERSION, providerId: typeof state.providerId === 'string' && state.providerId ? state.providerId : 'builtin',
       model: typeof state.model === 'string' ? state.model : '',
       reasoningEffort: typeof state.reasoningEffort === 'string' ? state.reasoningEffort : '',
       speedTier: typeof state.speedTier === 'string' ? state.speedTier : '',
@@ -647,7 +647,7 @@
     var compact = {
       id: run.id,
       task: normalizeDisplayTextForStorage(run.task || 'untitled task', SESSION_STORAGE_LIMITS.taskChars),
-      mode: typeof run.mode === 'string' ? redactSecretLikeText(run.mode) : '',
+      mode: typeof run.mode === 'string' ? redactSecretLikeText(run.mode) : '', ...StorageRunActions.compactProviderSnapshot(run),
       model: normalizeTextField(run.model, 80),
       reasoningEffort: typeof run.reasoningEffort === 'string' ? redactSecretLikeText(run.reasoningEffort) : '',
       speedTier: typeof run.speedTier === 'string' ? redactSecretLikeText(run.speedTier) : '',

package/extension/src/shared/storageMigration.js

@@ -81,6 +81,7 @@
       runs: Array.isArray(legacy.runs) ? legacy.runs : [],
       task: typeof legacy.task === 'string' ? legacy.task : '',
       mode: typeof legacy.mode === 'string' ? legacy.mode : legacyBlob.mode || '',
+      providerId: typeof legacy.providerId === 'string' && legacy.providerId ? legacy.providerId : 'builtin',
       model: typeof legacy.model === 'string' ? legacy.model : legacyBlob.model || '',
       reasoningEffort: typeof legacy.reasoningEffort === 'string' ? legacy.reasoningEffort : legacyBlob.reasoningEffort || '',
       speedTier: typeof legacy.speedTier === 'string' ? legacy.speedTier : legacyBlob.speedTier || '',

package/extension/src/shared/storageRunActions.js

@@ -92,8 +92,18 @@
     return value.length * 2;
   }
 
+  function compactProviderSnapshot(value) {
+    return {
+      providerId: typeof value.providerId === 'string' && value.providerId ? value.providerId : 'builtin',
+      providerName: typeof value.providerName === 'string' ? value.providerName : '',
+      providerRevision: Number.isFinite(Number(value.providerRevision)) ? Number(value.providerRevision) : 0,
+      providerEndpointHost: typeof value.providerEndpointHost === 'string' ? value.providerEndpointHost : ''
+    };
+  }
+
   return {
     compactRunsForStorage: compactRunsForStorage,
-    compactRunActionPayload: compactRunActionPayload
+    compactRunActionPayload: compactRunActionPayload,
+    compactProviderSnapshot: compactProviderSnapshot
   };
 });

package/extension/styles/panel.css

@@ -264,14 +264,111 @@
 }
 
 .codex-provider-test-row {
-  display: flex;
-  align-items: center;
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
   gap: 12px;
   margin-top: 18px;
+  padding: 14px;
+  border: 1px solid rgba(255, 255, 255, 0.085);
+  border-radius: 12px;
+  background:
+    radial-gradient(circle at 0 0, rgba(121, 213, 138, 0.08), transparent 44%),
+    rgba(255, 255, 255, 0.025);
+  box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.025);
 }
 
-.codex-provider-test-state { color: var(--provider-muted); font-size: 11px; }
+.codex-provider-test-copy { display: grid; gap: 3px; min-width: 0; }
+.codex-provider-test-copy strong { color: var(--provider-text); font-size: 12px; font-weight: 750; letter-spacing: 0.01em; }
+.codex-provider-test-copy > span { color: var(--provider-muted); font-size: 11px; line-height: 1.4; }
+
+.codex-provider-test-controls {
+  display: grid;
+  grid-template-columns: minmax(180px, 1fr) auto;
+  align-items: end;
+  gap: 10px;
+  min-width: 0;
+}
+
+.codex-provider-test-model { display: grid; gap: 6px; min-width: 0; }
+.codex-provider-test-model-label {
+  color: var(--provider-muted);
+  font-size: 10px;
+  font-weight: 750;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.codex-provider-test-select-shell { position: relative; display: block; min-width: 0; border-radius: 9px; }
+.codex-provider-test-select-shell select {
+  width: 100%;
+  min-width: 0;
+  min-height: 40px;
+  padding: 0 38px 0 12px;
+  border: 1px solid var(--provider-line);
+  border-radius: 9px;
+  appearance: none;
+  -webkit-appearance: none;
+  background: rgba(7, 12, 10, 0.58);
+  color: var(--provider-text);
+  color-scheme: dark;
+  font: inherit;
+  font-size: 12px;
+  font-weight: 650;
+  line-height: 1;
+  outline: none;
+  cursor: pointer;
+}
+.codex-provider-test-select-shell select:hover { border-color: rgba(121, 213, 138, 0.34); background: rgba(12, 19, 15, 0.72); }
+.codex-provider-test-select-shell:focus-within { box-shadow: 0 0 0 3px rgba(121, 213, 138, 0.12); }
+.codex-provider-test-select-shell:focus-within select { border-color: rgba(121, 213, 138, 0.66); }
+.codex-provider-test-chevron {
+  position: absolute;
+  top: 50%;
+  right: 12px;
+  width: 16px;
+  height: 16px;
+  transform: translateY(-50%);
+  fill: none;
+  stroke: var(--provider-muted);
+  stroke-width: 1.7;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+  pointer-events: none;
+}
+
+.codex-provider-test-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  min-height: 40px;
+  padding: 0 14px;
+  border: 1px solid rgba(121, 213, 138, 0.36);
+  border-radius: 9px;
+  background: linear-gradient(180deg, rgba(66, 132, 78, 0.38), rgba(42, 91, 52, 0.34));
+  color: #b8edc2;
+  box-shadow: 0 5px 15px rgba(6, 19, 10, 0.16);
+  font: inherit;
+  font-size: 12px;
+  font-weight: 750;
+  white-space: nowrap;
+  cursor: pointer;
+  transition: border-color 140ms ease, background 140ms ease, color 140ms ease, transform 140ms ease;
+}
+.codex-provider-test-button svg { width: 16px; height: 16px; fill: none; stroke: currentColor; stroke-width: 1.6; }
+.codex-provider-test-button:not(:disabled):hover {
+  border-color: rgba(121, 213, 138, 0.7);
+  background: linear-gradient(180deg, rgba(72, 151, 88, 0.5), rgba(44, 102, 57, 0.46));
+  color: #d4f7da;
+  transform: translateY(-1px);
+}
+.codex-provider-test-button:not(:disabled):active { transform: translateY(0); }
+.codex-provider-test-button[data-provider-action="cancel-test"] { border-color: rgba(242, 129, 113, 0.42); background: rgba(122, 55, 47, 0.24); color: #f3aaa0; }
+
+.codex-provider-test-state { min-height: 16px; color: var(--provider-muted); font-size: 11px; line-height: 1.4; }
+.codex-provider-test-state:empty { display: none; }
 .codex-provider-test-state[data-tone="success"] { color: var(--provider-accent); }
+.codex-provider-test-state[data-tone="failed"] { color: var(--provider-danger); }
 
 .codex-provider-dialog-foot {
   min-height: 70px;
@@ -334,6 +431,11 @@
 .codex-provider-builtin .codex-provider-active-badge,
 .codex-provider-builtin button { margin-top: 18px; }
 
+@media (max-width: 620px) {
+  .codex-provider-test-controls { grid-template-columns: 1fr; align-items: stretch; }
+  .codex-provider-test-button { width: 100%; }
+}
+
 @keyframes codex-provider-spin { to { transform: rotate(360deg); } }
 
 @media (max-width: 720px) {

package/native-host/src/providerRuntime.js

@@ -213,12 +213,24 @@ function cancelProviderTest(operationId) {
 
 function resolveProviderModels(params = {}, env = process.env, resolveBuiltInModels) {
   const state = loadProviderState(env);
-  if (state.public.activeProviderId === 'builtin') {
-    return resolveBuiltInModels(params, env);
+  const selection = params.providerSelection;
+  const requestedProviderId = selection?.providerId || state.public.activeProviderId || 'builtin';
+  if (requestedProviderId === 'builtin') {
+    const result = resolveBuiltInModels(params, env);
+    const attachProvider = value => ({
+      ...(value || {}),
+      providerId: 'builtin',
+      providerRevision: 0,
+      providerName: 'Built-in Codex'
+    });
+    return result && typeof result.then === 'function' ? result.then(attachProvider) : attachProvider(result);
   }
-  const profile = state.public.profiles.find(item => item.id === state.public.activeProviderId);
+  const profile = state.public.profiles.find(item => item.id === requestedProviderId);
   if (!profile) {
-    throw providerError('provider_not_found', 'The active provider no longer exists.');
+    throw providerError('provider_not_found', 'The selected provider no longer exists.');
+  }
+  if (selection?.providerId && Number(selection.providerRevision) !== profile.revision) {
+    throw providerError('provider_revision_conflict', 'The selected provider changed. Refresh its model list and retry.');
   }
   return {
     providerId: profile.id,
@@ -245,10 +257,8 @@ function resolveRunProvider(params = {}, env = process.env) {
   const state = loadProviderState(env);
   const selection = params.providerSelection;
   const activeProviderId = state.public.activeProviderId || 'builtin';
-  if (selection?.providerId && selection.providerId !== activeProviderId) {
-    throw providerError('provider_revision_conflict', 'The active provider changed in another tab. Refresh and retry.');
-  }
-  if (activeProviderId === 'builtin') {
+  const requestedProviderId = selection?.providerId || activeProviderId;
+  if (requestedProviderId === 'builtin') {
     return {
       modelId: params.model || '',
       reasoningEffort: params.reasoningEffort || '',
@@ -256,15 +266,15 @@ function resolveRunProvider(params = {}, env = process.env) {
       providerSelection: { providerId: 'builtin', providerRevision: 0 }
     };
   }
-  const profile = state.public.profiles.find(item => item.id === activeProviderId);
+  const profile = state.public.profiles.find(item => item.id === requestedProviderId);
   if (!profile) {
-    throw providerError('provider_not_found', 'The active provider no longer exists.');
+    throw providerError('provider_not_found', 'The selected provider no longer exists.');
   }
   if (!selection?.providerId) {
     throw providerError('provider_selection_unavailable', 'The active provider has not been confirmed by this Overleaf tab. Wait for Provider settings to load and retry.');
   }
   if (Number(selection.providerRevision) !== profile.revision) {
-    throw providerError('provider_revision_conflict', 'The active provider changed in another tab. Refresh and retry.');
+    throw providerError('provider_revision_conflict', 'The selected provider changed. Refresh its model list and retry.');
   }
   const endpointHost = getEndpointHost(profile.baseUrl);
   if (profile.endpointDisclosureHost !== endpointHost || profile.endpointDisclosureBaseUrl !== profile.baseUrl) {
@@ -302,7 +312,9 @@ function resolveRunProvider(params = {}, env = process.env) {
       reasoningEffort,
       upstreamResponseMode: validDiagnostic ? diagnostic.upstreamResponseMode : ''
     }),
-    providerSelection: { providerId: profile.id, providerRevision: profile.revision }
+    providerSelection: { providerId: profile.id, providerRevision: profile.revision },
+    providerName: profile.name,
+    providerEndpointHost: endpointHost
   };
 }
 
@@ -315,9 +327,10 @@ async function resolveRunProviderForRun(params = {}, env = process.env, options
     }
   }
   const state = loadProviderState(env);
-  const profile = state.public.profiles.find(item => item.id === state.public.activeProviderId);
+  const requestedProviderId = params.providerSelection?.providerId || state.public.activeProviderId || 'builtin';
+  const profile = state.public.profiles.find(item => item.id === requestedProviderId);
   if (!profile) {
-    throw providerError('provider_not_found', 'The active provider no longer exists.');
+    throw providerError('provider_not_found', 'The selected provider no longer exists.');
   }
   const modelId = String(params.model || profile.defaultModelId).trim();
   options.emit?.({

package/package.json

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