codex-overleaf-link 2.3.6 → 2.4.1

package/extension/src/page/writebackRouter.js

@@ -392,54 +392,45 @@
       : result;
   }
 
-  async function applyOperationsWithNoTraceUndo(operations, options = {}) {
-    const initial = getReviewingState({});
-    if (isEditingConfirmedForNoTraceUndo(initial)) {
-      const result = await applyOperationsCore(operations, options);
-      return {
-        ...result,
-        reviewingPolicy: {
-          policy: 'no-trace-undo',
-          disabled: false,
-          restored: false,
-          reason: 'editing_already_confirmed'
-        }
-      };
-    }
-
-    const disabled = await setReviewingEnabled(false, { waitMs: 1800 });
-    if (!disabled.ok) {
-      return buildNoTraceUndoBlockedResult(operations, disabled);
-    }
+  async function confirmNoTraceUndoEditing() {
+    let changed = false;
+    let toggle = { ok: true, changed: false, enabled: false };
+    for (let attempt = 0; attempt < 2; attempt++) {
+      if (!isEditingConfirmedForNoTraceUndo(getReviewingState({}))) {
+        toggle = await setReviewingEnabled(false, { waitMs: 1800 });
+        if (!toggle.ok) return toggle;
+        changed = changed || toggle.changed === true;
+      }
+      await delay(180);
+      if (!isEditingConfirmedForNoTraceUndo(getReviewingState({}))) continue;
+      await delay(180);
+      if (isEditingConfirmedForNoTraceUndo(getReviewingState({})))
+        return { ...toggle, ok: true, changed, enabled: false };
+    }
+    return { ok: false, code: 'editing_not_confirmed',
+      reason: 'Overleaf Editing mode did not remain confirmed before undo; no undo write was started.' };
+  }
 
-    let result;
-    let applyError = null;
-    try {
-      result = await applyOperationsCore(operations, options);
-    } catch (error) {
-      applyError = error;
-    }
-    if (applyError) {
-      throw applyError;
+  async function applyOperationsWithNoTraceUndo(operations, options = {}) {
+    const disabled = await confirmNoTraceUndoEditing();
+    if (!disabled.ok) return buildNoTraceUndoBlockedResult(operations, disabled);
+    const result = await applyOperationsCore(operations, {
+      ...options, noTraceUndo: true, trackReviewingChanges: false
+    });
+    const reviewingPolicy = { policy: 'no-trace-undo', disabled: disabled.changed === true, restored: false,
+      reason: disabled.changed ? 'left_editing_after_undo' : 'editing_already_confirmed' };
+    if (disabled.changed) {
+      reviewingPolicy.leftEditing = true;
+      reviewingPolicy.disable = summarizeReviewingToggleResult(disabled);
     }
-
-    return {
-      ...result,
-      reviewingPolicy: {
-        policy: 'no-trace-undo',
-        disabled: true,
-        restored: false,
-        leftEditing: true,
-        reason: 'left_editing_after_undo',
-        disable: summarizeReviewingToggleResult(disabled)
-      }
-    };
+    return { ...result, reviewingPolicy };
   }
 
   async function applyOperationsCore(operations, options = {}) {
     const applied = [];
     const skipped = [];
     const trackedChanges = [];
+    const trackedChangeCaptures = [];
     const safeBaseFiles = normalizeBaseFilesForSafety(options.baseFiles);
     const baseFileLookup = window.CodexOverleafStaleGuard?.buildBaseFileLookup(safeBaseFiles);
     const baseBinaryFileLookup = buildBaseBinaryFileLookup(safeBaseFiles);
@@ -574,8 +565,10 @@
       let raceResult;
       if (operation.type === 'edit') {
         raceResult = await raceOpAgainstCancellation(applyEditOperation(operation, {
-          baseFileLookup,
-          trackReviewingChanges: options.trackReviewingChanges === true
+          baseFileLookup, runProjectId,
+          recheckWriteProject: writeGuardSurface ? () => writeGuardSurface.runWriteGuard({ runProjectId }) : null,
+          trackReviewingChanges: options.trackReviewingChanges === true,
+          noTraceUndo: options.noTraceUndo === true
         }));
       } else if (['binary-create', 'overwrite-binary'].includes(operation.type)) {
         raceResult = await raceOpAgainstCancellation(applyBinaryAssetOperation(operation, { baseFileLookup, baseBinaryFileLookup }));
@@ -604,6 +597,7 @@
         break;
       }
       const result = raceResult;
+      if (result.trackedChangeCapture) trackedChangeCaptures.push(result.trackedChangeCapture);
       if (operation.type === 'edit' && result.ok && Array.isArray(result.trackedChanges)) {
         trackedChanges.push(...result.trackedChanges);
       }
@@ -618,7 +612,8 @@
       ok: skipped.length === 0,
       applied,
       skipped,
-      trackedChanges: mergeTrackedChangeRefs(trackedChanges)
+      trackedChanges: trackedChangeCaptures.some(capture => capture.state !== 'observed') ? [] : mergeTrackedChangeRefs(trackedChanges),
+      trackedChangeCaptures
     };
   }
 
@@ -653,12 +648,17 @@
       return editorReady;
     }
 
+    if (options.noTraceUndo === true) {
+      const editing = await confirmNoTraceUndoEditing();
+      if (!editing.ok) return buildNoTraceUndoBlockedResult([operation], editing).skipped[0].result;
+    }
     const trackReviewingChanges = options.trackReviewingChanges === true;
     const forbidTrackedChanges = options.forbidTrackedChanges === true;
     const observeTrackedChanges = trackReviewingChanges || forbidTrackedChanges;
     const operationPaths = collectOperationPaths([operation]);
+    const captureBaseline = trackReviewingChanges ? prepareTrackedChangeCapture(operation.path) : null;
     const trackedBefore = observeTrackedChanges
-      ? collectTrackedChangeRefsForPaths(operationPaths)
+      ? (captureBaseline?.refs || collectTrackedChangeRefsForPaths(operationPaths))
       : [];
     let current = editorReady.text;
     let freshness = window.CodexOverleafStaleGuard?.checkOperationFreshness(
@@ -752,6 +752,25 @@
       };
     }
 
+    if (options.noTraceUndo === true) {
+      const blocked = typeof options.recheckWriteProject === 'function'
+        ? await options.recheckWriteProject()
+        : { ok: false, code: 'editor_project_id_unavailable',
+          failure: buildPageFailure('editor_project_id_unavailable', { file: operation.path,
+            operationType: 'undo', changedDocument: false,
+            userMessage: 'The project identity guard is unavailable; the undo write was not applied.' }) };
+      if (blocked) return blocked.skipped?.[0]?.result || blocked;
+      if (getActiveFilePath() !== operation.path || readActiveEditorText() !== current) {
+        const reason = 'The editor changed while confirming Editing mode; the undo write was not applied.';
+        return { ok: false, code: 'stale_source_changed', reason,
+          failure: buildPageFailure('stale_source_changed', { file: operation.path,
+            operationType: 'undo', changedDocument: false, userMessage: reason }) };
+      }
+      if (!isEditingConfirmedForNoTraceUndo(getReviewingState({})))
+        return buildNoTraceUndoBlockedResult([operation], { ok: false, code: 'editing_not_confirmed',
+          reason: 'Overleaf left Editing mode before the undo write.' }).skipped[0].result;
+    }
+
     const result = Array.isArray(operation.patches) && operation.patches.length
       ? replaceActiveEditorPatches(operation.patches, nextContent)
       : replaceActiveEditorText(nextContent);
@@ -784,6 +803,7 @@
       return decorated;
     }
     const trackedChanges = [];
+    let trackedChangeCapture = null;
     if (observeTrackedChanges) {
       // Overleaf renders review markers asynchronously after the editor text
       // has already changed. A single 120 ms snapshot intermittently missed
@@ -791,10 +811,13 @@
       // Poll both paths: normal Reviewing writes get a shorter capture window,
       // while Accept replay keeps the longer safety window used to prove that
       // it did not create fresh tracked changes.
-      const trackedDiff = await waitForTrackedChangeDiff(trackedBefore, operationPaths, {
-        waitMs: forbidTrackedChanges ? 3600 : 1800,
-        intervalMs: 180
-      });
+      const trackedDiff = trackReviewingChanges
+        ? await captureTrackedWrite({ trackedBefore, captureBaseline, operation, beforeContent: current,
+          postContent: nextContent, runProjectId: options.runProjectId })
+        : await waitForTrackedChangeDiff(trackedBefore, operationPaths, {
+          waitMs: 3600, intervalMs: 180, stopOnFirst: true
+        });
+      trackedChangeCapture = trackedDiff.capture || null;
       trackedChanges.push(...trackedDiff.trackedChanges);
       if (forbidTrackedChanges && trackedChanges.length > 0) {
         return {
@@ -831,6 +854,7 @@
       ...result,
       verified: true,
       verifiedContent: nextContent,
+      trackedChangeCapture,
       trackedChanges: mergeTrackedChangeRefs(trackedChanges)
     };
   }
@@ -1352,6 +1376,8 @@
   }
 
   async function applyFileTreeOperation(operation, options = {}) {
+    const initialProjectId = treeOperations.getProjectId?.();
+    const initialCancellationSequence = readWriteCancellationSequence();
     const freshness = await checkFileTreeOperationFreshness(operation, options.baseFileLookup);
     if (!freshness.ok) {
       return freshness;
@@ -1400,8 +1426,21 @@
       }
     }
 
+    const nativeOperation = { create: deps.createTextFile, delete: deps.deleteTextFile }[operation.type];
+    if (typeof nativeOperation === 'function' && (operation.type === 'delete' || typeof operation.content === 'string')) {
+      const isCurrent = () => Boolean(initialProjectId) && treeOperations.getProjectId?.() === initialProjectId
+        && readWriteCancellationSequence() === initialCancellationSequence;
+      const created = await nativeOperation(operation, { isCurrent, expectedContent: options.baseFileLookup?.get(operation.path) });
+      if (!created.ok) return created;
+      if (!isCurrent() || created.verified !== true || created.verification !== 'overleaf-zip') {
+        return { ...fileTreeVerificationFailed(operation, 'Server receipt is missing or stale.'), changedDocument: true };
+      }
+      recordFileTreeOperationSuccess(operation, options.baseFileLookup);
+      return { ok: true, method: created.method, verified: true };
+    }
     return {
       ok: false,
+      code: 'file_tree_controls_unavailable',
       reason: 'No supported Overleaf file-tree method was detected'
     };
   }
@@ -1847,9 +1886,11 @@
       acceptTrackedChanges,
       rejectTrackedChanges,
       collectTrackedChangeRefsForPaths,
+      prepareTrackedChangeCapture, getTrackedChangeCaptureStatus,
+      captureTrackedWrite, reconcileTrackedChangeCapture,
       waitForTrackedChangeDiff
     } = trackedChangesLifecycleModule.create({
-      window,
+      window, confirmReviewWriteback: deps.confirmReviewWriteback,
       checkWritebackRunProjectId,
       buildNoTraceUndoBlockedResult,
       buildReviewingRequiredBlockedResult,
@@ -1868,6 +1909,9 @@
       buildPageFailure,
       delay,
       getActiveFilePath,
+      getProjectId: () => treeOperations.getProjectId?.() || '',
+      getCodeMirrorEditorView: deps.getCodeMirrorEditorView,
+      getTrackedChangeDocumentId: deps.getTrackedChangeDocumentId,
       getReviewingState,
       isEditorUndoControl,
       isInsideCodexPanel,
@@ -1885,6 +1929,8 @@
 
     return {
       applyOperations: applyOperationsForBridge,
+      getTrackedChangeCaptureStatus,
+      reconcileTrackedChangeCapture,
       rejectTrackedChanges,
       acceptTrackedChanges,
       verifySaveState

package/extension/src/pageBridge.js

@@ -67,7 +67,14 @@
     treeOperations,
     window
   });
+  const textFileCreator = requirePageModule('CodexOverleafTextFileCreator').create({
+    window, document, treeOperations, snapshotRouter,
+    collectElements, ensureEditing, ensureReviewing, readActiveEditorText, readWriteCancellationSequence,
+    uploadHelpers: requirePageModule('CodexOverleafBinaryAssetUploader')
+  });
   binaryAssetUploader = requirePageModule('CodexOverleafBinaryAssetUploader').create({
+    prepareUploadParent: textFileCreator.prepareUploadParent,
+    findFolderNode: textFileCreator.findFolderNode,
     document,
     snapshotRouter,
     treeOperations,
@@ -86,6 +93,11 @@
     window
   });
   writebackRouter = requirePageModule('CodexOverleafWritebackRouter').create({
+    confirmReviewWriteback: (params, result) => requirePageModule('CodexOverleafSaveState').confirmReviewWriteback({
+      params, result, getProjectId, delay, readSnapshot: options => snapshotRouter.fetchProjectZipSnapshot(options)
+    }),
+    createTextFile: textFileCreator.createFile,
+    deleteTextFile: textFileCreator.deleteFile,
     activeEditorIdentityChanged,
     clickNode,
     collectElements,
@@ -93,8 +105,14 @@
     compileBridge,
     delay,
     diagnosticsRevision: PAGE_BRIDGE_INSTALL_REVISION,
-    ensureEditing,
-    ensureReviewing,
+    getCodeMirrorEditorView,
+    getTrackedChangeDocumentId: filePath => {
+      const ids = new Set(collectDocRecords({ includeWindowGlobals: true })
+        .filter(record => record.path === filePath && typeof record.id === 'string' && record.id).map(record => record.id));
+      return ids.size === 1 ? Array.from(ids)[0] : '';
+    },
+    ensureEditing: params => textFileCreator.ensureWriteMode(false, params),
+    ensureReviewing: params => textFileCreator.ensureWriteMode(true, params),
     // Cross-world cancel: the router's per-op loop polls this each iteration
     // and aborts remaining ops when the value bumps. content-side cancel
     // invokes pageBridge.cancelActiveWrite which calls bumpWriteCancellationSequence.
@@ -205,20 +223,28 @@
       return { ok: true };
     },
     createCheckpoint: params => createCheckpoint(params.label),
-    ensureReviewing,
-    ensureEditing,
-    applyOperations: params => applyOperations(params.operations || [], {
+    ensureReviewing: params => textFileCreator.ensureWriteMode(true, params),
+    ensureEditing: params => textFileCreator.ensureWriteMode(false, params),
+    applyOperations: async params => {
+      if (params.reviewingPolicy === 'no-trace-undo') {
+        const prepared = await textFileCreator.prepareEditor(params);
+        if (prepared.ok !== true) return { applied: [], changedDocument: false,
+          skipped: (params.operations || []).map(operation => ({ operation, result: prepared })) };
+      }
+      return applyOperations(params.operations || [], {
         baseFiles: params.baseFiles || null,
         reviewingPolicy: params.reviewingPolicy || '',
         requireReviewing: params.requireReviewing === true,
         requireEditing: params.requireEditing === true,
         runProjectId: typeof params.runProjectId === 'string' ? params.runProjectId : ''
-      }),
+      });
+    },
     binaryUploadBegin: params => binaryAssetUploader.begin(params),
     binaryUploadAppend: params => binaryAssetUploader.append(params),
     binaryUploadCommit: params => binaryAssetUploader.commit(params),
     binaryUploadAbort: params => binaryAssetUploader.abort(params),
     jumpToPosition,
+    reconcileTrackedChangeCapture: params => writebackRouter.reconcileTrackedChangeCapture(params),
     rejectTrackedChanges,
     acceptTrackedChanges,
     triggerCompile: params => compileBridge.triggerCompile(params),
@@ -430,6 +456,7 @@
       editor,
       capabilities: pageRpcContract.withCapabilityReport(collectPageCapabilities(editor)),
       editorDiagnostics: buildEditorDiagnostics(editor),
+      trackedChangeCapture: writebackRouter.getTrackedChangeCaptureStatus?.(),
       projectDiagnostics: {
         internalRootKeys: collectInternalRootKeys(),
         docRecordCount: docRecords.length,
@@ -559,40 +586,26 @@
         reason: 'jumpToPosition requires a non-empty file path'
       };
     }
-    if (!projectPathExists(filePath)) {
-      return {
-        ok: false,
-        code: 'path_not_found',
-        reason: `Could not find ${filePath} in the Overleaf project`,
-        path: filePath,
-        failure: buildPageBridgeFailure('target_file_not_found', {
-          file: filePath,
-          operationType: 'jump',
-          changedDocument: false,
-          userMessage: `Codex could not find ${filePath} in this Overleaf project.`,
-          evidence: { originalCode: 'path_not_found', writeStarted: false }
-        })
-      };
-    }
-
     const navigating = getActiveFilePath() !== filePath;
     const previousEditorIdentity = navigating ? getActiveEditorIdentity() : null;
 
     if (navigating) {
       const opened = await openFileByPath(filePath);
       if (!opened.ok) {
+        const missing = !projectPathExists(filePath);
+        const code = missing ? 'path_not_found' : 'file_open_failed';
         return {
           ok: false,
-          code: 'file_open_failed',
+          code,
           reason: opened.reason || `Could not open ${filePath}`,
           path: filePath,
-          failure: buildPageBridgeFailure('target_file_open_failed', {
+          failure: buildPageBridgeFailure(missing ? 'target_file_not_found' : 'target_file_open_failed', {
             file: filePath,
             operationType: 'jump',
             changedDocument: false,
             userMessage: `Codex could not open ${filePath} in Overleaf.`,
             technicalMessage: opened.reason || '',
-            evidence: { originalCode: 'file_open_failed', writeStarted: false }
+            evidence: { originalCode: code, writeStarted: false }
           })
         };
       }
@@ -830,10 +843,35 @@
     return current.node !== previous.node;
   }
 
+  function readCurrentEditorMode() {
+    const selector = '.toolbar-editor .review-mode-switcher > .review-mode-switcher-toggle-button';
+    const controls = uniqueNodes(collectElements(selector, 16)).filter(node =>
+      String(node.className || '').split(/\s+/).includes('review-mode-switcher-toggle-button')
+      && node.ownerDocument === document && !isInsideCodexPanel(node));
+    if (!controls.length) return '';
+    const modes = controls.filter(node => {
+      const style = window.getComputedStyle?.(node);
+      return node.isConnected !== false && !node.hidden && !node.closest?.('[hidden],[aria-hidden="true"]')
+        && (node.getClientRects?.().length || 0) > 0 && style?.visibility !== 'hidden'
+        && style?.display !== 'none' && style?.opacity !== '0';
+    }).map(node => {
+      const classes = String(node.className || '').split(/\s+/);
+      const values = [node.getAttribute('aria-label'),
+        node.querySelector?.('.review-mode-switcher-toggle-label')?.textContent]
+        .map(value => normalizeReviewingSignalText(value).toLowerCase())
+        .filter(value => value === 'editing' || value === 'reviewing');
+      for (const mode of ['editing', 'reviewing']) if (classes.includes(mode)) values.push(mode);
+      return values.length && values.every(mode => mode === values[0]) ? values[0] : 'unknown';
+    });
+    return modes.length && modes.every(mode => mode === modes[0]) ? modes[0] : 'unknown';
+  }
+
   function getReviewingState(params = {}) {
     const signals = collectReviewingSignals({ ...params, manualOverride: false });
+    const editorMode = readCurrentEditorMode();
     return {
       signals,
+      ...(editorMode ? { editorMode } : {}),
       reviewing: window.CodexOverleafReviewing.detectReviewingFromSignals(signals)
     };
   }
@@ -986,6 +1024,7 @@
   }
 
   function isReviewingConfirmedForWrite(state = {}) {
+    if (state.editorMode) return state.editorMode === 'reviewing';
     const reviewing = state.reviewing || {};
     if (!reviewing.ok || reviewing.status === 'manual-override') {
       return false;
@@ -1015,6 +1054,7 @@
   }
 
   function isEditingConfirmedForNoTraceUndo(state = {}) {
+    if (state.editorMode) return state.editorMode === 'editing';
     if (isReviewingConfirmedForWrite(state)) {
       return false;
     }

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

package/extension/src/shared/i18n.js

@@ -508,14 +508,39 @@
       failureReason_editor_project_id_unavailable_next: 'Refresh the Overleaf tab and retry; if it persists, reload the extension.',
       // Welcome-panel + write-guard: Recent-projects
       // variant copy. Spec §5.3–§5.5, §5.8, §5.10 are the source of truth.
-      recentProjects_welcome: 'Codex Overleaf Link',
-      recentProjects_welcome_subtitle: 'Open a project from the Overleaf list on the left to start.',
-      recentProjects_empty: "You haven't run any Codex sessions yet. Open a project from the Overleaf list on the left to start.",
-      recentProjects_sessions_empty: 'No sessions in this project yet',
-      recentProjects_sessions_toggle: "Show / manage this project's sessions",
-      recentProjects_sessions_action: 'View runs',
-      recentProjects_sessions_action_open: 'Hide runs',
-      recentProjects_clearProject: 'Delete all sessions for this project',
+      recentProjects_welcome: 'Continue working',
+      recentProjects_focusEyebrow: 'Last conversation',
+      recentProjects_historyHeading: 'Other recent conversations',
+      recentProjects_historyHint: 'Select to continue',
+      recentProjects_projectConversations: "View this project's conversations",
+      recentProjects_allProjects: 'All projects',
+      recentProjects_showAllConversations: 'View all {count} conversations',
+      recentProjects_unstarted: 'Not started \u00b7 {count}',
+      recentProjects_unstartedHint: 'Empty conversations are kept here, without deleting their records.',
+      recentProjects_noStarted: 'No conversation has been started yet. Empty conversations are available below.',
+      recentProjects_savedDraft: 'Saved draft, ready to continue.',
+      recentProjects_attention: 'Needs attention',
+      recentProjects_unavailableRecords: 'Records with unavailable project links',
+      recentProjects_loadingHistory: 'Loading conversations...',
+      recentProjects_loadFailed: 'Conversation history could not be read. Please retry.',
+      recentProjects_continueHint: 'Open this conversation without automatically starting a task.',
+      recentProjects_more: 'More options',
+      recentProjects_continue: 'Continue',
+      recentProjects_openProject: 'Open project',
+      recentProjects_loadingConversation: 'Loading conversation...',
+      recentProjects_noConversation: 'No saved conversation',
+      recentProjects_noRuns: 'No runs yet',
+      recentProjects_previewUnavailable: 'Conversation unavailable',
+      recentProjects_previewUnavailableHint: 'Saved conversation could not be loaded.',
+      recentProjects_conversationGone: 'This conversation is no longer available. Choose another conversation from the refreshed list.',
+      recentProjects_continueFailed: 'Could not open the conversation. Please try again.',
+      recentProjects_welcome_subtitle: 'Conversations saved in this browser',
+      recentProjects_empty: 'No conversations saved in this browser yet. Open an Overleaf project and start a Codex conversation.',
+      recentProjects_sessions_empty: 'No saved conversations in this project',
+      recentProjects_sessions_toggle: "Show or manage this project's conversations",
+      recentProjects_sessions_action: 'All conversations',
+      recentProjects_sessions_action_open: 'Hide conversations',
+      recentProjects_clearProject: 'Delete this project\'s conversations',
       recentProjects_clearProject_title: 'Delete all Codex sessions for {project}?',
       recentProjects_clearProject_message: 'This permanently deletes all {count} plugin sessions, run history, and matching plugin-local Codex thread history for {project}. It will not modify Overleaf files or global Codex history.',
       recentProjects_clearProject_confirm: 'Delete all',
@@ -531,15 +556,17 @@
       recentProjects_degraded: 'Sign in to Overleaf to see your recent Codex projects.',
       recentProjects_row_projectLinkUnavailable: 'Project link unavailable.',
       recentProjects_settings_entry: 'Settings & Diagnostics',
-      recentProjects_badge_pending: 'pending',
-      recentProjects_badge_accepted: 'accepted',
-      recentProjects_badge_rejected: 'rejected',
-      recentProjects_badge_needs_review: 'pending',
-      recentProjects_badge_running: 'running',
-      recentProjects_badge_completed: 'completed',
-      recentProjects_badge_failed: 'failed',
-      recentProjects_badge_interrupted: 'interrupted',
-      recentProjects_badge_stale: 'stale',
+      recentProjects_settingsTitle: 'General Settings',
+      recentProjects_settingsSubtitle: 'Manage Codex preferences and local history across all projects.',
+      recentProjects_badge_pending: 'Last run pending',
+      recentProjects_badge_accepted: 'Last changes accepted',
+      recentProjects_badge_rejected: 'Last changes undone',
+      recentProjects_badge_needs_review: 'Last run needs review',
+      recentProjects_badge_running: 'Last recorded as running',
+      recentProjects_badge_completed: 'Last run completed',
+      recentProjects_badge_failed: 'Last run failed',
+      recentProjects_badge_interrupted: 'Last run may have been interrupted',
+      recentProjects_badge_stale: 'Last run status unconfirmed',
       recentProjects_unnamed: 'Project \u00b7 {prefix}',
       recentProjects_zombieRunningNote: 'Marked as running, but it may be a leftover from an interrupted run.',
       recentProjects_zombieDeleteConfirm: 'This session is marked as running. If no other tab is actually running it, you can delete it anyway.',
@@ -547,9 +574,9 @@
       recentProjects_degraded_hint: 'Could not identify the Overleaf account on this page, so the project list is hidden to avoid mixing accounts. This usually resolves on a reload.',
       recentProjects_sessionsCount: '{count} session(s)',
       recentProjects_welcome_stats: '{projects} projects \u00b7 {sessions} Codex sessions',
-      recentProjects_badge_background_completed: 'completed in background',
-      recentProjects_badge_needs_review_after_navigation: 'pending',
-      recentProjects_badge_abandoned_after_navigation: 'abandoned'
+      recentProjects_badge_background_completed: 'Last run completed in background',
+      recentProjects_badge_needs_review_after_navigation: 'Last run needs review',
+      recentProjects_badge_abandoned_after_navigation: 'Last run stopped after navigation'
     },
     zh: {
       resizePanel: '拖动调整 Codex 面板宽度，双击恢复默认宽度',
@@ -1047,14 +1074,39 @@
       failureReason_editor_project_id_unavailable_next: '请刷新 Overleaf 页面后重试；如果仍然失败，请重新加载扩展。',
       // Welcome-panel + write-guard: Recent-projects
       // variant copy. 见 spec §5.3–§5.5、§5.8、§5.10。
-      recentProjects_welcome: 'Codex Overleaf Link',
-      recentProjects_welcome_subtitle: '从左侧 Overleaf 项目列表中打开任意项目即可开始。',
-      recentProjects_empty: '你还没有运行过 Codex 会话。从左侧 Overleaf 项目列表中打开任意项目即可开始。',
-      recentProjects_sessions_empty: '该项目还没有会话',
-      recentProjects_sessions_toggle: '查看/管理该项目的会话',
-      recentProjects_sessions_action: '查看会话',
-      recentProjects_sessions_action_open: '收起会话',
-      recentProjects_clearProject: '删除该项目的全部会话',
+      recentProjects_welcome: '继续工作',
+      recentProjects_focusEyebrow: '上次对话',
+      recentProjects_historyHeading: '其他最近对话',
+      recentProjects_historyHint: '点击条目继续',
+      recentProjects_projectConversations: '查看该项目的全部对话',
+      recentProjects_allProjects: '所有项目',
+      recentProjects_showAllConversations: '查看全部 {count} 段对话',
+      recentProjects_unstarted: '未开始 · {count}',
+      recentProjects_unstartedHint: '空白对话收纳在这里，记录不会被删除。',
+      recentProjects_noStarted: '尚无已开始的对话，空白对话可在下方展开。',
+      recentProjects_savedDraft: '草稿已保存，可继续补充。',
+      recentProjects_attention: '需要查看',
+      recentProjects_unavailableRecords: '项目链接不可用的记录',
+      recentProjects_loadingHistory: '正在加载对话…',
+      recentProjects_loadFailed: '暂时无法读取对话历史，请重试。',
+      recentProjects_continueHint: '仅打开这段对话，不会自动启动任务。',
+      recentProjects_more: '更多选项',
+      recentProjects_continue: '继续',
+      recentProjects_openProject: '打开项目',
+      recentProjects_loadingConversation: '正在加载对话…',
+      recentProjects_noConversation: '暂无保存的对话',
+      recentProjects_noRuns: '尚未运行任务',
+      recentProjects_previewUnavailable: '暂时无法读取对话',
+      recentProjects_previewUnavailableHint: '已保存的对话暂时无法读取。',
+      recentProjects_conversationGone: '该对话已不可用，请从更新后的列表中选择其他对话。',
+      recentProjects_continueFailed: '暂时无法打开对话，请重试。',
+      recentProjects_welcome_subtitle: '当前浏览器保存的对话',
+      recentProjects_empty: '当前浏览器还没有保存的对话。打开一个 Overleaf 项目，与 Codex 开始对话即可。',
+      recentProjects_sessions_empty: '该项目还没有保存的对话',
+      recentProjects_sessions_toggle: '查看或管理该项目的对话',
+      recentProjects_sessions_action: '全部对话',
+      recentProjects_sessions_action_open: '收起对话',
+      recentProjects_clearProject: '删除该项目的全部对话',
       recentProjects_clearProject_title: '删除 {project} 的全部 Codex 会话？',
       recentProjects_clearProject_message: '这会永久删除 {project} 的全部 {count} 个插件会话、运行历史及对应的插件本地 Codex 线程历史。不会修改 Overleaf 文件或全局 Codex 历史。',
       recentProjects_clearProject_confirm: '全部删除',
@@ -1070,15 +1122,17 @@
       recentProjects_degraded: '请登录 Overleaf 后查看你最近的 Codex 项目。',
       recentProjects_row_projectLinkUnavailable: '项目链接不可用。',
       recentProjects_settings_entry: '设置与诊断',
-      recentProjects_badge_pending: '待处理',
-      recentProjects_badge_accepted: '已接受',
-      recentProjects_badge_rejected: '已撤回',
-      recentProjects_badge_needs_review: '待处理',
-      recentProjects_badge_running: '运行中',
-      recentProjects_badge_completed: '已完成',
-      recentProjects_badge_failed: '失败',
-      recentProjects_badge_interrupted: '已中断',
-      recentProjects_badge_stale: '久未处理',
+      recentProjects_settingsTitle: '通用设置',
+      recentProjects_settingsSubtitle: '管理适用于所有项目的 Codex 偏好设置与本地历史记录。',
+      recentProjects_badge_pending: '上次运行待处理',
+      recentProjects_badge_accepted: '上次修改已接受',
+      recentProjects_badge_rejected: '上次修改已撤回',
+      recentProjects_badge_needs_review: '上次运行需要检查',
+      recentProjects_badge_running: '上次记录为运行中',
+      recentProjects_badge_completed: '上次运行已完成',
+      recentProjects_badge_failed: '上次运行失败',
+      recentProjects_badge_interrupted: '上次运行可能已中断',
+      recentProjects_badge_stale: '上次运行状态未确认',
       recentProjects_unnamed: '项目 · {prefix}',
       recentProjects_zombieRunningNote: '标记为运行中，但可能是被中断后的残留。',
       recentProjects_zombieDeleteConfirm: '该会话标记为运行中。如果确认没有其他标签页在运行它，可以直接删除。',
@@ -1086,9 +1140,9 @@
       recentProjects_degraded_hint: '无法识别本页的 Overleaf 账号，为避免账号间串数据已隐藏项目列表。通常刷新即可恢复。',
       recentProjects_sessionsCount: '{count} 个会话',
       recentProjects_welcome_stats: '{projects} 个项目 · {sessions} 个 Codex 会话',
-      recentProjects_badge_background_completed: '后台已完成',
-      recentProjects_badge_needs_review_after_navigation: '待处理',
-      recentProjects_badge_abandoned_after_navigation: '已中止'
+      recentProjects_badge_background_completed: '上次运行已在后台完成',
+      recentProjects_badge_needs_review_after_navigation: '上次运行需要检查',
+      recentProjects_badge_abandoned_after_navigation: '上次运行已在离开页面后停止'
     }
   };
 

package/extension/src/shared/pageRpcContract.js

@@ -5,7 +5,7 @@
 })(typeof window !== 'undefined' ? window : (typeof globalThis !== 'undefined' ? globalThis : this), function () {
   'use strict';
 
-  var REVISION = '2026-08-04-page-rpc-contract-v15';
+  var REVISION = '2026-09-14-native-text-upload-v28';
   var METHODS = freezeCatalog({
     initializeCapability: entry('bridge.initialize', 'control', 'none', 'default', false, 'none'),
     probe: entry('bridge.probe', 'read', 'none', 'default', false, 'safe'),
@@ -22,6 +22,7 @@
     binaryUploadCommit: entry('asset.write', 'document', 'required', 'writeback', true, 'no_retry'),
     binaryUploadAbort: entry('asset.stage', 'cache', 'none', 'default', false, 'idempotent'),
     jumpToPosition: entry('editor.navigate', 'navigation', 'required', 'default', false, 'idempotent'),
+    reconcileTrackedChangeCapture: entry('tracked_changes.read', 'read', 'required', 'default', false, 'safe'),
     rejectTrackedChanges: entry('tracked_changes.reject', 'document', 'required', 'lifecycle', true, 'no_retry'),
     acceptTrackedChanges: entry('tracked_changes.accept', 'document', 'required', 'lifecycle', true, 'no_retry'),
     triggerCompile: entry('compile.trigger', 'page_state', 'required', 'compile', false, 'no_retry'),