codex-overleaf-link 2.3.0 → 2.3.1

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

@@ -2,9 +2,9 @@
   "schemaVersion": 1,
   "entry": "extension/entries/content-entry.mjs",
   "output": "extension/src/content/generated/content.bundle.js",
-  "sourceDigest": "83c5f2bc9eb28735ba091c432476e505b311cfba37d53aa205049ea70ef2d2fc",
-  "outputDigest": "582a7804b46491dd34cd9f6f24304597f4e946e79870e323b9868a825b4666dd",
-  "byteLength": 2277820,
+  "sourceDigest": "ddbc07ac8d34d864aa3648c53211c5858e0312a73df815a0392bc52ec5eac1cc",
+  "outputDigest": "42051c8624bdfca3094c8bef2430094e55b7e1ec49d475ac27f6df14629bf313",
+  "byteLength": 2285557,
   "inputs": [
     "extension/entries/content-entry.mjs",
     "extension/src/content/activeTurnControl.js",
@@ -81,6 +81,7 @@
     "extension/src/shared/runInputQueue.js",
     "extension/src/shared/scopedPersistenceBrowserAdapter.js",
     "extension/src/shared/scopedPersistenceQueuePolicy.js",
+    "extension/src/shared/scopedPersistenceReceipt.js",
     "extension/src/shared/scopedPersistenceTransaction.js",
     "extension/src/shared/sensitiveScan.js",
     "extension/src/shared/sessionState.js",

package/extension/src/content/markdownText.js

@@ -13,12 +13,14 @@
       tx,
       callPageBridge, getCurrentProjectId,
       getCurrentProjectReferenceFiles,
+      getCurrentProjectMathSources,
       showPluginToast
     } = deps;
 
   function renderMarkdownInlineText(target, value) {
     target.replaceChildren(...buildMarkdownInlineNodes(value));
   }
+  function getMathMacros() { return MathText?.buildMathMacros?.(getCurrentProjectMathSources?.() || []) || {}; }
 
   function sanitizeAssistantVisibleText(value) {
     if (typeof value !== 'string' || !value) {
@@ -67,11 +69,8 @@
     if (!mathText?.buildMathNodes) {
       return buildMarkdownInlineNodesWithoutMath(source);
     }
-    return mathText.buildMathNodes(source, {
-      document,
-      katex: window.katex,
-      renderText: buildMarkdownInlineNodesWithoutMath
-    });
+    return mathText.buildMathNodes(source, { document, katex: window.katex,
+      macros: getMathMacros(), renderText: buildMarkdownInlineNodesWithoutMath });
   }
 
   function buildMarkdownInlineNodesWithoutMath(value) {
@@ -109,6 +108,10 @@
   function buildInlineCodeNodes(value) {
     const source = String(value || '');
     const trimmed = source.trim();
+    const standaloneMath = MathText?.parseStandaloneMath?.(trimmed);
+    if (standaloneMath && MathText?.createMathNode) return [MathText.createMathNode(
+      standaloneMath, { document, katex: window.katex, macros: getMathMacros() }
+    )];
     const refs = trimmed ? parseRuntimeLineReferences(trimmed, 'plain-text-token') : [];
     const ref = refs.length === 1 && refs[0]?.rawText === trimmed ? refs[0] : null;
     if (ref && !isRuntimeLocalPathLike(ref.rawPath)) {
@@ -492,12 +495,11 @@
               `[${safeLabel.replace(/]/g, '\\]')}](${target.replace(/\)/g, '\\)')})`
             );
           },
-          renderCodeNodes: text => buildMarkdownInlineNodes(`\`${String(text || '').replace(/`/g, '\\`')}\``),
+          renderCodeNodes: text => buildInlineCodeNodes(text),
           sanitizeText: sanitizeAssistantVisibleText,
-          createMathNode: segment => runtimeRoot.CodexOverleafMathText.createMathNode(segment, {
-            document, katex: runtimeRoot.katex,
-            renderText: text => buildMarkdownInlineNodes(text)
-          }),
+          createMathNode: segment => runtimeRoot.CodexOverleafMathText.createMathNode(segment,
+            { document, katex: runtimeRoot.katex, macros: getMathMacros(),
+              renderText: text => buildMarkdownInlineNodes(text) }),
           recordDiagnostic: recordRenderingDiagnostic
         });
         return;

package/extension/src/content/mathText.js

@@ -9,6 +9,19 @@
   ]);
   const LONG_INLINE_MATH_CHARS = 120;
   const COMPLEX_INLINE_MATH_CHARS = 80;
+  const MAX_PROJECT_MACRO_SOURCES = 12;
+  const MAX_PROJECT_MACRO_SOURCE_CHARS = 256 * 1024;
+  const MAX_PROJECT_MACROS = 64;
+  const MAX_MACRO_EXPANSION_CHARS = 512;
+  const DEFAULT_MATH_MACROS = Object.freeze({
+    '\\E': '\\mathbb{E}',
+    '\\Var': '\\operatorname{Var}',
+    '\\Cov': '\\operatorname{Cov}',
+    '\\R': '\\mathbb{R}',
+    '\\N': '\\mathbb{N}',
+    '\\Z': '\\mathbb{Z}'
+  });
+  const UNSAFE_MACRO_PATTERN = /\\(?:href|url|includegraphics|input|include|write|openout|read|html\w*|class|style|data|def|gdef|edef|xdef|newcommand|renewcommand|providecommand|DeclareMathOperator)\b/i;
 
   function parseMathSegments(value) {
     const source = String(value || '');
@@ -74,9 +87,10 @@
         searchFrom = start + delimiter.open.length;
         continue;
       }
-      const value = source.slice(start + delimiter.open.length, closeStart);
+      const rawValue = source.slice(start + delimiter.open.length, closeStart);
+      const value = rawValue.trim();
       const end = closeStart + delimiter.close.length;
-      if (!isValidMathValue(value, delimiter) || overlapsCodeRange(start, end, codeRanges)) {
+      if (!isValidMathValue(rawValue, delimiter) || overlapsCodeRange(start, end, codeRanges)) {
         searchFrom = start + delimiter.open.length;
         continue;
       }
@@ -94,7 +108,7 @@
     }
     const previous = source[index - 1] || '';
     const next = source[index + 1] || '';
-    return previous !== '$' && next !== '$' && next !== '' && !/\s/.test(next);
+    return previous !== '$' && next !== '$' && next !== '';
   }
 
   function findClosingDelimiter(source, fromIndex, delimiter, codeRanges) {
@@ -107,7 +121,7 @@
       const previous = source[index - 1] || '';
       const next = source[index + delimiter.close.length] || '';
       const invalidSingleDollar = delimiter.singleDollar
-        && (previous === '$' || next === '$' || /\s/.test(previous));
+        && (previous === '$' || next === '$');
       if (!isEscaped(source, index) && !isInsideRange(index, codeRanges) && !invalidSingleDollar) {
         return index;
       }
@@ -118,10 +132,24 @@
 
   function isValidMathValue(value, delimiter) {
     const source = String(value || '');
-    if (!source.trim()) {
+    const trimmed = source.trim();
+    if (!trimmed) {
       return false;
     }
-    return delimiter.display || !/[\r\n]/.test(source);
+    if (!delimiter.display && /[\r\n]/.test(source)) {
+      return false;
+    }
+    if (!delimiter.singleDollar || (!/^\s/.test(source) && !/\s$/.test(source))) {
+      return true;
+    }
+    return looksLikeWhitespaceWrappedMath(trimmed);
+  }
+
+  function looksLikeWhitespaceWrappedMath(value) {
+    const source = String(value || '').trim();
+    return /\\[A-Za-z]+/.test(source)
+      || /[_^=<>+\-*/()[\]{}|]/.test(source)
+      || /^[A-Za-z](?:_[A-Za-z0-9{}]+|\^[A-Za-z0-9{}]+)?$/.test(source);
   }
 
   function collectInlineCodeRanges(source) {
@@ -179,7 +207,8 @@
       }
       nodes.push(createMathNode(segment, {
         document: documentRef,
-        katex: options.katex || root.katex
+        katex: options.katex || root.katex,
+        macros: options.macros || buildMathMacros(options.projectSources)
       }));
     }
     return nodes;
@@ -206,6 +235,7 @@
         strict: 'warn',
         maxExpand: 200,
         maxSize: 20,
+        macros: options.macros || buildMathMacros(),
         output: 'htmlAndMathml'
       });
       node.dataset.mathRendered = 'true';
@@ -213,7 +243,7 @@
     } catch (_error) {
       node.classList.add('run-math--fallback');
       node.dataset.mathRendered = 'false';
-      node.textContent = segment.raw;
+      node.textContent = source;
       return node;
     }
   }
@@ -235,6 +265,120 @@
     return /(?:=|\\(?:le|ge|approx|sim|to|Rightarrow|Longrightarrow)\b|\\begin\{(?:aligned|gathered|split|array)\}|\\\\)/.test(source);
   }
 
+  function parseStandaloneMath(value) {
+    const source = String(value || '').trim();
+    if (!source) {
+      return null;
+    }
+    const segments = parseMathSegments(source);
+    if (segments.length !== 1 || segments[0].type !== 'math' || segments[0].raw !== source) {
+      return null;
+    }
+    return segments[0];
+  }
+
+  function buildMathMacros(projectSources = []) {
+    const macros = { ...DEFAULT_MATH_MACROS };
+    let remainingChars = MAX_PROJECT_MACRO_SOURCE_CHARS;
+    let projectMacroCount = 0;
+    for (const sourceRecord of Array.isArray(projectSources)
+      ? projectSources.slice(0, MAX_PROJECT_MACRO_SOURCES)
+      : []) {
+      if (projectMacroCount >= MAX_PROJECT_MACROS || remainingChars <= 0) {
+        break;
+      }
+      const path = String(sourceRecord?.path || '');
+      if (!/\.(?:tex|sty|cls|ltx)$/i.test(path)) {
+        continue;
+      }
+      const source = stripLatexComments(
+        String(sourceRecord?.content || '').slice(0, remainingChars)
+      );
+      remainingChars -= source.length;
+      const pattern = /\\(newcommand|renewcommand|providecommand|DeclareMathOperator)(\*)?/g;
+      let match;
+      while ((match = pattern.exec(source)) !== null && projectMacroCount < MAX_PROJECT_MACROS) {
+        let cursor = skipWhitespace(source, pattern.lastIndex);
+        const nameGroup = readBracedGroup(source, cursor);
+        if (!nameGroup) {
+          continue;
+        }
+        const macroName = nameGroup.value.trim();
+        cursor = skipWhitespace(source, nameGroup.end);
+        if (source[cursor] === '[') {
+          continue;
+        }
+        const expansionGroup = readBracedGroup(source, cursor);
+        if (!expansionGroup) {
+          continue;
+        }
+        let expansion = expansionGroup.value.trim();
+        if (match[1] === 'DeclareMathOperator') {
+          expansion = `\\operatorname${match[2] ? '*' : ''}{${expansion}}`;
+        }
+        if (!isSafeMacroDefinition(macroName, expansion)) {
+          continue;
+        }
+        macros[macroName] = expansion;
+        projectMacroCount++;
+        pattern.lastIndex = expansionGroup.end;
+      }
+    }
+    return macros;
+  }
+
+  function readBracedGroup(source, start) {
+    if (source[start] !== '{') {
+      return null;
+    }
+    let depth = 0;
+    for (let index = start; index < source.length; index++) {
+      if (source[index] === '{' && !isEscaped(source, index)) {
+        depth++;
+      } else if (source[index] === '}' && !isEscaped(source, index)) {
+        depth--;
+        if (depth === 0) {
+          return {
+            value: source.slice(start + 1, index),
+            end: index + 1
+          };
+        }
+      }
+    }
+    return null;
+  }
+
+  function skipWhitespace(source, start) {
+    let index = start;
+    while (index < source.length && /\s/.test(source[index])) {
+      index++;
+    }
+    return index;
+  }
+
+  function stripLatexComments(source) {
+    return String(source || '').split(/\r?\n/).map(line => {
+      for (let index = 0; index < line.length; index++) {
+        if (line[index] === '%' && !isEscaped(line, index)) {
+          return line.slice(0, index);
+        }
+      }
+      return line;
+    }).join('\n');
+  }
+
+  function isSafeMacroDefinition(name, expansion) {
+    const macroName = String(name || '');
+    const body = String(expansion || '');
+    return /^\\[A-Za-z@]+$/.test(macroName)
+      && body.length > 0
+      && body.length <= MAX_MACRO_EXPANSION_CHARS
+      && !body.includes('#')
+      && !body.includes(macroName)
+      && !UNSAFE_MACRO_PATTERN.test(macroName)
+      && !UNSAFE_MACRO_PATTERN.test(body);
+  }
+
   function toNodeArray(value) {
     if (Array.isArray(value)) {
       return value;
@@ -265,11 +409,13 @@
   }
 
   const api = {
+    buildMathMacros,
     buildMathNodes,
     createMathNode,
     matchMathAt,
     normalizeMathForRendering,
-    parseMathSegments
+    parseMathSegments,
+    parseStandaloneMath
   };
   root.CodexOverleafMathText = api;
   if (typeof module !== 'undefined' && module.exports) {

package/extension/src/content/nativeCompatibilityController.js

@@ -256,8 +256,8 @@
       tip.dataset.onboardingTip = 'true';
       tip.setAttribute('role', 'status');
       tip.textContent = tx(
-        'Tip: Start with Ask mode to explore safely. Switch to Suggest to review edits before applying.',
-        '提示：先用 Ask 模式安全探索；需要修改时切换到 Suggest，应用前可先审阅。'
+        'Tip: Start with Ask mode to explore safely. Switch to Auto only when you want Codex to edit files.',
+        '提示：先用 Ask 模式安全探索；只有需要 Codex 修改文件时才切换到 Auto。'
       );
       Object.assign(tip.style, {
         position: 'absolute',

package/extension/src/content/otWarmMirror.js

@@ -868,7 +868,7 @@
         applyResults: [],
         nextStep: tr('warmMirrorStaleBlockedNextStep')
       });
-      finishRunView(tr('warmMirrorStaleBlockedTitle'), 'failed');
+      await finishRunView(tr('warmMirrorStaleBlockedTitle'), 'failed');
       return { ok: false };
     }
     if (focusedPartialSnapshot) {

package/extension/src/content/runTimelineView.js

@@ -274,6 +274,9 @@
     if (status === 'failed') {
       return tr('processedFailed', { elapsed });
     }
+    if (status === 'rejected' || status === 'cancelled') {
+      return tr('processedCancelled', { elapsed });
+    }
     if (status === 'running') {
       return tr('processing', { elapsed });
     }
@@ -411,6 +414,9 @@
     if (run.startedAt && run.finishedAt) {
       return formatProcessedSummary(run.status || 'completed', new Date(run.finishedAt).getTime() - new Date(run.startedAt).getTime());
     }
+    if (run.status === 'rejected' || run.status === 'cancelled') {
+      return tx('Cancelled', '已取消');
+    }
     return run.status === 'failed' ? tx('Failed', '处理失败') : tx('Done', '已处理');
   }
 

package/extension/src/content/writebackOrchestrator.js

@@ -25,7 +25,6 @@
   let appendOperationsPreview;
   let appendPartialWritebackWarning;
   let appendApplyResult;
-  let renderDiffReview;
   let renderReadOnlyDiffReview;
   let showPluginConfirm;
   let callPageBridge;
@@ -96,8 +95,8 @@
         applyResults: [],
         mode: runMode,
         nextStep: tx(
-          'Switch to Suggest or Auto only when you want Codex to edit files.',
-          '只有希望 Codex 修改文件时，才需要切换到建议修改或自动写入。'
+          'Switch to Auto only when you want Codex to edit files.',
+          '只有希望 Codex 修改文件时，才需要切换到自动写入。'
         )
       });
       return {
@@ -178,51 +177,6 @@
       };
     }
 
-    if (runMode === 'confirm') {
-      appendRunEvent({
-        title: tx(
-          `Local Codex produced ${operations.length} change(s). Review the diff before applying.`,
-          `本地 Codex 产生了 ${operations.length} 项改动，请查看差异后确认。`
-        ),
-        status: 'running'
-      });
-      const accepted = await renderDiffReview(visibleSyncChanges);
-      if (!accepted.length) {
-        appendRunEvent({
-          title: tx('Sync cancelled: Overleaf was not modified.', '已取消同步：Overleaf 没有被修改。'),
-          status: 'completed'
-        });
-        appendCompletionReport({
-          conclusion: tx('You cancelled syncing. Local Codex changes were not written back to Overleaf.', '你取消了同步，本地 Codex 改动没有写回 Overleaf。'),
-          status: 'rejected',
-          operations: [],
-          applyResults: [],
-          mode: runMode,
-          nextStep: tx('Run the task again, or switch to Auto if you want changes synced directly.', '可以重新运行任务，或切换到自动写入后再同步。')
-        });
-        return {
-          summaryLine: tx('Sync cancelled', '已取消同步'),
-          hasSkippedOperations: additionalSkippedEntries.length > 0,
-          settlement: buildSettlement({
-            operations,
-            applyResult: { ok: false, applied: [], skipped: additionalSkippedEntries }
-          }),
-          audit: buildAuditSummaryFromApply({
-            operations,
-            applyResults: additionalSkippedEntries.length ? [{ ok: false, applied: [], skipped: additionalSkippedEntries }] : [],
-            blockedFiles: additionalSkippedEntries.map(item => summarizeOperationForAudit(item.operation, item.result, 'blocked')),
-            resultStatus: 'rejected'
-          })
-        };
-      }
-      operations = buildSyncApplyOperations(accepted, project);
-      const acceptedPathSafety = partitionUnsafeProjectPathOperations(operations);
-      if (acceptedPathSafety.skipped.length) {
-        additionalSkippedEntries.push(...acceptedPathSafety.skipped);
-        operations = acceptedPathSafety.safe;
-      }
-    }
-
     const deleteOperations = operations.filter(operation => operation.type === 'delete');
     if (deleteOperations.length) {
       const approved = await showPluginConfirm({
@@ -872,7 +826,6 @@
       appendOperationsPreview,
       appendPartialWritebackWarning,
       appendApplyResult,
-      renderDiffReview,
       renderReadOnlyDiffReview,
       showPluginConfirm,
       callPageBridge,

package/extension/src/page/trackedChangesLifecycle.js

@@ -971,8 +971,15 @@
     }
 
     for (const path of paths) {
-      if (path && getActiveFilePath() !== path) {
-        const opened = await openFileByPath(path);
+      const postContent = postByPath.get(path);
+      const activePathMatches = getActiveFilePath() === path;
+      const activeContentMatches = readActiveEditorText() === postContent;
+      // Overleaf can update the selected tree path before CodeMirror swaps its
+      // document. In that state getActiveFilePath() already names `path`, while
+      // readActiveEditorText() still belongs to the previously viewed file.
+      // Force-reopen the target whenever either identity signal disagrees.
+      if (path && (!activePathMatches || !activeContentMatches)) {
+        const opened = await openFileByPath(path, { force: true });
         if (!opened.ok) {
           return {
             ok: false,
@@ -983,8 +990,7 @@
         }
       }
 
-      const postContent = postByPath.get(path);
-      const postReady = await waitForActiveEditorExpectedText(path, postContent, 2500);
+      const postReady = await waitForActiveEditorExpectedText(path, postContent, 9000);
       if (!postReady.ok) {
         return {
           ok: false,

package/extension/src/page/writebackRouter.js

@@ -1667,13 +1667,17 @@
         continue;
       }
       const key = typeof ref.key === 'string' ? ref.key : '';
-      if (!key || seen.has(key)) {
+      if (!key) {
         continue;
       }
-      seen.add(key);
       const hasPath = typeof ref.path === 'string';
       const hasExplicitPath = hasPath && ref.path.trim() !== '';
       const path = hasPath ? normalizeSafeProjectPath(ref.path) : '';
+      const identity = `${path}\u0000${key}`;
+      if (seen.has(identity)) {
+        continue;
+      }
+      seen.add(identity);
       normalized.push({
         key,
         id: typeof ref.id === 'string' ? ref.id : '',

package/extension/src/shared/agentTranscript.js

@@ -727,10 +727,17 @@
     if (providerError) {
       return providerError;
     }
-    if (/Mode must be "confirm" or "auto"/i.test(text)) {
+    if (/suggest_mode_removed|Suggest mode has been removed/i.test(text)) {
+      return {
+        conclusion: textFor(locale, '建议修改模式已经移除。', 'Suggest mode has been removed.'),
+        nextStep: textFor(locale, '请刷新扩展，然后选择“只问不改”或“自动写入”。', 'Reload the extension, then choose Ask or Auto.'),
+        failureCode: 'suggest_mode_removed'
+      };
+    }
+    if (/Mode must be "(?:confirm|ask)" or "auto"/i.test(text)) {
       return {
         conclusion: textFor(locale, '这轮没有写入：当前是“只问不改”，但这个任务需要写入权限。', 'No files were written: this task needs write access, but the current mode is Ask.'),
-        nextStep: textFor(locale, '请切换到“建议修改”或“自动写入”后重新运行。', 'Switch to Suggest or Auto and run the task again.'),
+        nextStep: textFor(locale, '请切换到“自动写入”后重新运行。', 'Switch to Auto and run the task again.'),
         failureCode: null  // no direct catalog match — preflight / governance
       };
     }
@@ -797,7 +804,7 @@
     if (/checkpoint/i.test(text)) {
       return {
         conclusion: textFor(locale, '这轮没有自动写入：Codex 没有拿到可恢复版本。', 'This run did not auto-write: Codex did not get a recoverable version.'),
-        nextStep: textFor(locale, '请切换到“建议修改”，或确认 Overleaf Reviewing 已开启后再用“自动写入”。', 'Switch to Suggest, or confirm Overleaf Reviewing is enabled before using Auto.'),
+        nextStep: textFor(locale, '请确认 Overleaf Reviewing 已开启后再用“自动写入”。', 'Confirm that Overleaf Reviewing is enabled before using Auto.'),
         failureCode: null  // no current catalog code; preflight reviewing issue
       };
     }

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

package/extension/src/shared/i18n.js

@@ -266,8 +266,6 @@
       writeMode: 'Write mode',
       modeAsk: 'Ask',
       modeAskTitle: 'Read and analyze only. Do not write to Overleaf.',
-      modeConfirm: 'Suggest',
-      modeConfirmTitle: 'Show a change plan first, then write after approval.',
       modeAuto: 'Auto',
       modeAutoTitle: 'Write directly after authorization. Deletes still require confirmation.',
       addContext: 'Add @ context',
@@ -403,6 +401,7 @@
       refreshProbeDone: 'Refreshed: {status}',
       refreshProbeFailed: 'Refresh failed. Reload Overleaf and try again.',
       processedFailed: 'Failed {elapsed}',
+      processedCancelled: 'Cancelled {elapsed}',
       processing: 'Running {elapsed}',
       processed: 'Done {elapsed}',
       restoredRunStoppedTitle: 'Stopped tracking this run after a page refresh',
@@ -779,8 +778,6 @@
       writeMode: '写入模式',
       modeAsk: '只问不改',
       modeAskTitle: '只读取和分析，不写入 Overleaf',
-      modeConfirm: '建议修改',
-      modeConfirmTitle: '先给出修改方案，确认后写入',
       modeAuto: '自动写入',
       modeAutoTitle: '授权后直接写入，删除仍需确认',
       addContext: '添加 @ 上下文',
@@ -916,6 +913,7 @@
       refreshProbeDone: '已重新检测：{status}',
       refreshProbeFailed: '检测失败：请刷新 Overleaf 页面后重试',
       processedFailed: '处理失败 {elapsed}',
+      processedCancelled: '已取消 {elapsed}',
       processing: '处理中 {elapsed}',
       processed: '已处理 {elapsed}',
       restoredRunStoppedTitle: '页面刷新后已停止跟踪这轮任务',

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-07-26-page-rpc-contract-v13';
+  var REVISION = '2026-07-31-page-rpc-contract-v14';
   var METHODS = freezeCatalog({
     initializeCapability: entry('bridge.initialize', 'control', 'none', 'default', false, 'none'),
     probe: entry('bridge.probe', 'read', 'none', 'default', false, 'safe'),
@@ -67,7 +67,7 @@
       file_list: 35000,
       compile: 75000,
       lifecycle: 120000,
-      writeback: 30000
+      writeback: 45000
     };
     var candidate = Number(overrides[timeoutClass]);
     return Number.isFinite(candidate) && candidate > 0 ? candidate : defaults[timeoutClass];

package/extension/src/shared/runExecutionSnapshot.js

@@ -28,7 +28,10 @@
       : rawQueueItem;
     const persisted = rawQueueItem?.executionSnapshot || rawPayload?.executionSnapshot;
     if (persisted && typeof persisted === 'object') {
-      return Codec.normalizeSnapshot(persisted, { source: persisted.source || 'submitted' });
+      return Codec.normalizeSnapshot(persisted, {
+        source: persisted.source || 'submitted',
+        migrateLegacyConfirm: true
+      });
     }
     const raw = rawPayload && typeof rawPayload === 'object' ? rawPayload : {};
     const fallback = fallbackInput && typeof fallbackInput === 'object' ? fallbackInput : {};
@@ -48,13 +51,17 @@
       inferred = true;
     }
     return Codec.normalizeSnapshot(captured, {
-      source: inferred ? 'legacy-inferred' : 'legacy-captured'
+      source: inferred ? 'legacy-inferred' : 'legacy-captured',
+      migrateLegacyConfirm: true
     });
   }
 
   function resolveForExecution(value = {}, options = {}) {
     const persisted = value.executionSnapshot || value;
-    const snapshot = Codec.normalizeSnapshot(persisted, { source: persisted.source || 'submitted' });
+    const snapshot = Codec.normalizeSnapshot(persisted, {
+      source: persisted.source || 'submitted',
+      migrateLegacyConfirm: true
+    });
     if (snapshot.providerId === 'builtin') return Codec.normalizeSnapshot(snapshot, { source: snapshot.source });
     const catalog = options.catalog || {};
     const provider = ProviderProfiles?.getProviderById
@@ -80,7 +87,10 @@
 
   function snapshotOf(value = {}) {
     const persisted = value.executionSnapshot || value;
-    return Codec.normalizeSnapshot(persisted, { source: persisted.source || 'submitted' });
+    return Codec.normalizeSnapshot(persisted, {
+      source: persisted.source || 'submitted',
+      migrateLegacyConfirm: true
+    });
   }
 
   function cloneSnapshot(value = {}) {

package/extension/src/shared/runExecutionSnapshotCodec.js

@@ -8,7 +8,7 @@
   'use strict';
 
   const SCHEMA_VERSION = 1;
-  const VALID_MODES = new Set(['ask', 'confirm', 'auto']);
+  const VALID_MODES = new Set(['ask', 'auto']);
   const VALID_SOURCES = new Set(['submitted', 'legacy-captured', 'legacy-inferred']);
   const TUPLE_FIELDS = Object.freeze([
     'mode', 'providerId', 'providerRevision', 'model', 'reasoningEffort',
@@ -19,12 +19,15 @@
   function normalizeSnapshot(value = {}, options = {}) {
     const input = value && typeof value === 'object' ? value : {};
     assertNoSecretFields(input);
+    if (input.mode === 'confirm' && options.migrateLegacyConfirm !== true) {
+      throw snapshotError('suggest_mode_removed', 'Suggest mode has been removed. Choose Ask or Auto.');
+    }
     const providerId = normalizeText(input.providerId) || 'builtin';
     const revision = normalizeRevisionResult(input.providerRevision);
     if (!revision.ok) throw snapshotError('provider_revision_conflict', revision.error);
     const snapshot = {
       schemaVersion: SCHEMA_VERSION,
-      mode: VALID_MODES.has(input.mode) ? input.mode : 'ask',
+      mode: input.mode === 'auto' ? 'auto' : 'ask',
       providerId,
       providerRevision: providerId === 'builtin' ? '' : revision.value,
       model: normalizeText(input.model).slice(0, 160),