codex-overleaf-link 2.0.0 → 2.1.0

package/extension/src/shared/agentTranscript.js

@@ -584,6 +584,132 @@
     };
   }
 
+  function translateProviderError(text, locale) {
+    const rules = [
+      {
+        pattern: /provider_revision_conflict|active provider changed|provider changed in another tab/i,
+        conclusionZh: '这轮没有启动：模型服务配置已在另一个标签页发生变化。',
+        conclusionEn: 'This run did not start: the model provider configuration changed in another tab.',
+        nextZh: '请刷新模型服务配置，然后重新运行任务。',
+        nextEn: 'Refresh the provider configuration, then run the task again.',
+        code: 'provider_revision_conflict'
+      },
+      {
+        pattern: /provider_auth_rejected|rejected the API key|denied access for this credential/i,
+        conclusionZh: '这轮没有继续：第三方模型服务拒绝了当前 API 密钥。',
+        conclusionEn: 'This run did not continue: the third-party provider rejected the current API key.',
+        nextZh: '请在 Settings 的模型服务配置中替换 API 密钥并测试连接。',
+        nextEn: 'Replace the API key in Model Providers and run Test connection.',
+        code: 'provider_auth_rejected'
+      },
+      {
+        pattern: /provider_model_not_found|configured model was not found/i,
+        conclusionZh: '这轮没有继续：第三方模型服务中找不到所选模型。',
+        conclusionEn: 'This run did not continue: the selected model was not found by the third-party provider.',
+        nextZh: '请检查模型 ID，测试连接后重试。',
+        nextEn: 'Check the model ID, test the connection, and retry.',
+        code: 'provider_model_not_found'
+      },
+      {
+        pattern: /provider_model_not_configured|selected model is not configured|at least one model ID is required/i,
+        conclusionZh: '这轮没有启动：当前模型没有配置在启用的模型服务中。',
+        conclusionEn: 'This run did not start: the current model is not configured for the active provider.',
+        nextZh: '请打开模型服务配置，添加或选择一个可用模型。',
+        nextEn: 'Open Model Providers and add or select an available model.',
+        code: 'provider_model_not_configured'
+      },
+      {
+        pattern: /provider_protocol_unverified|test connection before (activating|using)/i,
+        conclusionZh: '这轮没有启动：自动 API 协议尚未完成验证。',
+        conclusionEn: 'This run did not start: the automatic API protocol has not been verified.',
+        nextZh: '请在模型服务配置中运行“测试连接”，保存后重试。',
+        nextEn: 'Run Test connection in Model Providers, save, and retry.',
+        code: 'provider_protocol_unverified'
+      },
+      {
+        pattern: /provider_protocol_incompatible|incompatible with this API protocol/i,
+        conclusionZh: '这轮没有继续：端点与所选 API 协议不兼容。',
+        conclusionEn: 'This run did not continue: the endpoint is incompatible with the selected API protocol.',
+        nextZh: '请切换 Responses 或 Chat Completions，或使用自动检测重新测试。',
+        nextEn: 'Switch between Responses and Chat Completions, or test again with Auto detection.',
+        code: 'provider_protocol_incompatible'
+      },
+      {
+        pattern: /provider_rate_limited|rate limit was reached/i,
+        conclusionZh: '这轮没有完成：第三方模型服务触发了限流。',
+        conclusionEn: 'This run did not finish: the third-party provider rate limit was reached.',
+        nextZh: '请等待限流窗口恢复后重试。',
+        nextEn: 'Wait for the provider rate-limit window to recover, then retry.',
+        code: 'provider_rate_limited'
+      },
+      {
+        pattern: /provider_connection_timeout|provider connection.*timed out/i,
+        conclusionZh: '这轮没有完成：连接第三方模型服务超时。',
+        conclusionEn: 'This run did not finish: the third-party provider connection timed out.',
+        nextZh: '请检查端点和网络，或提高模型服务的请求超时后重试。',
+        nextEn: 'Check the endpoint and network, or increase the provider timeout before retrying.',
+        code: 'provider_connection_timeout'
+      },
+      {
+        pattern: /provider_dns_failed|hostname could not be resolved/i,
+        conclusionZh: '这轮没有启动：无法解析第三方模型服务的主机名。',
+        conclusionEn: 'This run did not start: the third-party provider hostname could not be resolved.',
+        nextZh: '请检查 Base URL 和本机 DNS 后重试。',
+        nextEn: 'Check the Base URL and local DNS, then retry.',
+        code: 'provider_dns_failed'
+      },
+      {
+        pattern: /provider_tls_failed|TLS verification failed/i,
+        conclusionZh: '这轮没有启动：第三方模型服务的 TLS 验证失败。',
+        conclusionEn: 'This run did not start: TLS verification failed for the third-party provider.',
+        nextZh: '请检查端点证书和 Base URL，修复后重试。',
+        nextEn: 'Check the endpoint certificate and Base URL, then retry.',
+        code: 'provider_tls_failed'
+      },
+      {
+        pattern: /provider_not_found|active provider no longer exists/i,
+        conclusionZh: '这轮没有启动：启用的模型服务已经不存在。',
+        conclusionEn: 'This run did not start: the active model provider no longer exists.',
+        nextZh: '请在 Settings 中选择内置 Codex 或另一个模型服务。',
+        nextEn: 'Select Built-in Codex or another provider in Settings.',
+        code: 'provider_not_found'
+      },
+      {
+        pattern: /provider_store_corrupt|provider stores are out of sync|provider store.*invalid/i,
+        conclusionZh: '这轮没有启动：本地模型服务配置存储已损坏或不同步。',
+        conclusionEn: 'This run did not start: the local provider configuration store is corrupt or out of sync.',
+        nextZh: '请打开技术详情，修复或重建本地模型服务配置。',
+        nextEn: 'Open Technical Details and repair or rebuild the local provider configuration.',
+        code: 'provider_store_corrupt'
+      },
+      {
+        pattern: /provider_store_unavailable|provider settings could not be saved/i,
+        conclusionZh: '模型服务操作失败：Native Host 无法访问本地配置存储。',
+        conclusionEn: 'The provider operation failed: the Native Host could not access local provider storage.',
+        nextZh: '请检查本地目录权限和 Native Host 状态后重试。',
+        nextEn: 'Check local directory permissions and Native Host status, then retry.',
+        code: 'provider_store_unavailable'
+      },
+      {
+        pattern: /provider_response_invalid|provider connection test failed/i,
+        conclusionZh: '这轮没有继续：第三方模型服务返回了不兼容或无效的响应。',
+        conclusionEn: 'This run did not continue: the third-party provider returned an incompatible or invalid response.',
+        nextZh: '请测试连接并确认服务兼容所选 API 协议。',
+        nextEn: 'Test the connection and confirm that the endpoint supports the selected API protocol.',
+        code: 'provider_response_invalid'
+      }
+    ];
+    const rule = rules.find(candidate => candidate.pattern.test(text));
+    if (!rule) {
+      return null;
+    }
+    return {
+      conclusion: textFor(locale, rule.conclusionZh, rule.conclusionEn),
+      nextStep: textFor(locale, rule.nextZh, rule.nextEn),
+      failureCode: rule.code
+    };
+  }
+
   function translateRawError(message, context = {}) {
     const locale = normalizeLocale(context);
     const text = String(message || '');
@@ -594,6 +720,10 @@
     // failure data alongside the human-readable text. The string text is kept
     // verbatim because it has mode-aware nuance (e.g. "No files were written"
     // vs "This run did not start") the catalog's fallback strings don't capture.
+    const providerError = translateProviderError(text, locale);
+    if (providerError) {
+      return providerError;
+    }
     if (/Mode must be "confirm" or "auto"/i.test(text)) {
       return {
         conclusion: textFor(locale, '这轮没有写入：当前是“只问不改”，但这个任务需要写入权限。', 'No files were written: this task needs write access, but the current mode is Ask.'),

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.0.0';
+  const BUILD_TARGET_VERSION = '2.1.0';
   const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
   const REQUIRED_CAPABILITIES = Object.freeze([
     'bridgePing',
@@ -24,7 +24,8 @@
     'codexModels',
     'historyClearPlugin',
     'localSkills',
-    'mirrorSensitiveScan'
+    'mirrorSensitiveScan',
+    'providerProfiles'
   ]);
   const UPDATE_AVAILABLE_CAPABILITIES = Object.freeze([
     'bridgePing',

package/extension/src/shared/failureReasons.js

@@ -288,6 +288,81 @@
       fallbackUserMessage: 'Local Codex returned no usable final report or operations.',
       fallbackNextAction: 'Open Technical Details and resolve the local Codex error.'
     },
+    provider_revision_conflict: {
+      stage: 'preflight', severity: 'blocked', defaultRetryable: true,
+      fallbackUserMessage: 'The active model provider changed after this tab loaded it.',
+      fallbackNextAction: 'Refresh the provider configuration and retry.'
+    },
+    provider_not_found: {
+      stage: 'preflight', severity: 'blocked', defaultRetryable: false,
+      fallbackUserMessage: 'The active model provider no longer exists.',
+      fallbackNextAction: 'Select Built-in Codex or another provider.'
+    },
+    provider_model_not_configured: {
+      stage: 'preflight', severity: 'blocked', defaultRetryable: false,
+      fallbackUserMessage: 'The selected model is not configured for the active provider.',
+      fallbackNextAction: 'Add or select a model in Model Providers.'
+    },
+    provider_protocol_unverified: {
+      stage: 'preflight', severity: 'blocked', defaultRetryable: true,
+      fallbackUserMessage: 'The provider API protocol has not been verified.',
+      fallbackNextAction: 'Run Test connection, save the provider, and retry.'
+    },
+    provider_auth_rejected: {
+      stage: 'codex', severity: 'blocked', defaultRetryable: false,
+      fallbackUserMessage: 'The provider rejected the configured API key.',
+      fallbackNextAction: 'Replace the API key and test the connection.'
+    },
+    provider_model_not_found: {
+      stage: 'codex', severity: 'blocked', defaultRetryable: false,
+      fallbackUserMessage: 'The provider could not find the configured model.',
+      fallbackNextAction: 'Correct the model ID and test the connection.'
+    },
+    provider_protocol_incompatible: {
+      stage: 'codex', severity: 'blocked', defaultRetryable: false,
+      fallbackUserMessage: 'The endpoint is incompatible with the selected API protocol.',
+      fallbackNextAction: 'Select another protocol or use Auto detection.'
+    },
+    provider_request_rejected: {
+      stage: 'codex', severity: 'blocked', defaultRetryable: false,
+      fallbackUserMessage: 'The provider rejected the protocol probe request.',
+      fallbackNextAction: 'Review the model ID, reasoning controls, tool support, and request overrides.'
+    },
+    provider_rate_limited: {
+      stage: 'codex', severity: 'error', defaultRetryable: true,
+      fallbackUserMessage: 'The provider rate limit was reached.',
+      fallbackNextAction: 'Wait for the rate-limit window to recover and retry.'
+    },
+    provider_connection_timeout: {
+      stage: 'codex', severity: 'error', defaultRetryable: true,
+      fallbackUserMessage: 'The provider connection timed out.',
+      fallbackNextAction: 'Check the endpoint and network, then retry.'
+    },
+    provider_dns_failed: {
+      stage: 'codex', severity: 'error', defaultRetryable: true,
+      fallbackUserMessage: 'The provider hostname could not be resolved.',
+      fallbackNextAction: 'Check the Base URL and DNS, then retry.'
+    },
+    provider_tls_failed: {
+      stage: 'codex', severity: 'error', defaultRetryable: true,
+      fallbackUserMessage: 'TLS verification failed for the provider endpoint.',
+      fallbackNextAction: 'Check the endpoint certificate and Base URL.'
+    },
+    provider_response_invalid: {
+      stage: 'codex', severity: 'error', defaultRetryable: true,
+      fallbackUserMessage: 'The provider returned an incompatible or invalid response.',
+      fallbackNextAction: 'Test the connection and verify protocol compatibility.'
+    },
+    provider_store_unavailable: {
+      stage: 'storage', severity: 'error', defaultRetryable: true,
+      fallbackUserMessage: 'The Native Host could not access provider configuration storage.',
+      fallbackNextAction: 'Check local permissions and Native Host status.'
+    },
+    provider_store_corrupt: {
+      stage: 'storage', severity: 'blocked', defaultRetryable: false,
+      fallbackUserMessage: 'The provider configuration store is corrupt or inconsistent.',
+      fallbackNextAction: 'Repair or rebuild the local provider configuration.'
+    },
     codex_project_locked: {
       stage: 'codex', severity: 'blocked', defaultRetryable: true,
       fallbackUserMessage: 'Another Codex task is already running for this Overleaf project.',

package/extension/src/shared/i18n.js

@@ -287,6 +287,11 @@
       softwareUpdatesTitle: 'Software updates',
       softwareUpdatesHelp: 'Automatically checks signed stable releases for the Extension and Native Host.',
       checkForUpdates: 'Check for updates',
+      providerSettingsTitle: 'Model providers',
+      providerSettingsExperimental: 'Third-party experimental',
+      providerSettingsHelp: 'Configure experimental third-party model APIs. Compatibility varies by provider and gateway.',
+      providerSettingsConfigure: 'Configure',
+      providerSettingsBuiltin: 'Built-in Codex is active',
       storageUsageLoading: 'Calculating usage\u2026',
       storageClearAll: 'Clear all history\u2026',
       storageClearAllHelp: 'Removes every stored session, run and audit record for all projects. Project settings and rules are kept.',
@@ -343,10 +348,16 @@
       refreshFileList: 'Refresh file list',
       contextStatus: 'Type @ to add files, or click ＋: files, attachments (PDF/images), @compile-log.',
       contextLoadingFiles: 'Reading available @files...',
+      contextSyncTreeLoading: 'Reading the project file tree.',
+      contextSyncExactLoading: 'Available files are ready. Completing the full ZIP file list.',
+      contextSyncExactReady: 'The complete project file list is ready.',
+      contextSyncPartial: 'Available files are shown. The complete ZIP file list is unavailable; refresh to retry.',
       contextReadFailed: 'Could not read files: {message}',
       contextNoFiles: 'No usable text files were read from this Overleaf project.',
       contextSelectedFiles: 'Added {count} @file items. Future tasks will focus on them first.',
       contextDefaultWholeProject: 'Default is the whole project. Add @file; @compile-log and @current-section are available as context options.',
+      preloadProjectContextTitle: 'Preload project context',
+      preloadProjectContextDescription: 'Fetch the exact project file list in the background after an Overleaf project becomes idle.',
       contextResourceTitle: '{path} (non-text resource, shown only as project structure for now)',
       contextWholeProjectChip: 'Default: whole project',
       clearFiles: 'Clear all @file context',
@@ -762,6 +773,11 @@
       softwareUpdatesTitle: '软件更新',
       softwareUpdatesHelp: '自动检查 Extension 与 Native Host 的签名稳定版本。',
       checkForUpdates: '检查更新',
+      providerSettingsTitle: '模型服务',
+      providerSettingsExperimental: '第三方实验性',
+      providerSettingsHelp: '配置实验性第三方模型 API；兼容性取决于具体模型服务与网关。',
+      providerSettingsConfigure: '配置',
+      providerSettingsBuiltin: '当前使用内置 Codex',
       storageUsageLoading: '正在计算占用…',
       storageClearAll: '清空全部历史…',
       storageClearAllHelp: '删除所有项目已存储的全部会话、运行与审计记录。项目设置与规则会保留。',
@@ -818,10 +834,16 @@
       refreshFileList: '刷新文件列表',
       contextStatus: '输入 @ 添加文件，或点 ＋：文件、附件（PDF/图片）、@compile-log。',
       contextLoadingFiles: '正在读取可添加的 @文件...',
+      contextSyncTreeLoading: '正在读取项目文件树。',
+      contextSyncExactLoading: '可用文件已经显示，正在补齐完整 ZIP 文件列表。',
+      contextSyncExactReady: '完整项目文件列表已经就绪。',
+      contextSyncPartial: '当前已显示可用文件，完整 ZIP 文件列表暂不可用；可刷新重试。',
       contextReadFailed: '读取文件失败：{message}',
       contextNoFiles: '没有从当前 Overleaf 项目读取到可用文本文件。',
       contextSelectedFiles: '已添加 {count} 个 @file；后续任务会优先围绕它们。',
       contextDefaultWholeProject: '默认使用整个项目。可添加 @file；@compile-log 和 @current-section 将作为后续上下文能力。',
+      preloadProjectContextTitle: '预加载项目上下文',
+      preloadProjectContextDescription: 'Overleaf 项目进入空闲状态后，在后台读取精确的项目文件列表。',
       contextResourceTitle: '{path}（非文本资源，当前只作为项目结构显示）',
       contextWholeProjectChip: '默认：整个项目',
       clearFiles: '清除全部 @file',

package/extension/src/shared/models.js

@@ -63,6 +63,7 @@
       id,
       label,
       reasoningEfforts: Array.isArray(model?.reasoningEfforts) ? model.reasoningEfforts.slice() : [],
+      reasoningPresentation: typeof model?.reasoningPresentation === 'string' ? model.reasoningPresentation : '',
       speedTiers: normalizeSpeedTiers(model?.speedTiers)
     };
 

package/extension/src/shared/providerProfiles.js

@@ -0,0 +1,283 @@
+(function initCodexOverleafProviderProfiles(root, factory) {
+  if (typeof module === 'object' && module.exports) {
+    module.exports = factory();
+  } else {
+    root.CodexOverleafProviderProfiles = factory();
+  }
+})(typeof globalThis !== 'undefined' ? globalThis : window, function providerProfilesFactory() {
+  'use strict';
+
+  const BUILTIN_PROVIDER_ID = 'builtin';
+
+  function normalizeCatalog(value = {}) {
+    const providers = Array.isArray(value.providers)
+      ? value.providers.map(normalizeProvider).filter(Boolean)
+      : [];
+    if (!providers.some(provider => provider.id === BUILTIN_PROVIDER_ID)) {
+      providers.unshift(buildBuiltinProvider());
+    }
+    const requestedActiveId = normalizeText(value.activeProviderId);
+    const activeProviderId = providers.some(provider => provider.id === requestedActiveId)
+      ? requestedActiveId
+      : BUILTIN_PROVIDER_ID;
+    return {
+      activeProviderId,
+      providers,
+      storeRevision: normalizeInteger(value.storeRevision)
+    };
+  }
+
+  function normalizeProvider(value) {
+    if (!value || typeof value !== 'object') {
+      return null;
+    }
+    const id = normalizeText(value.id);
+    if (!id) {
+      return null;
+    }
+    if (id === BUILTIN_PROVIDER_ID || value.kind === 'builtin') {
+      return buildBuiltinProvider();
+    }
+    const models = normalizeModels(value.models);
+    const defaultModelId = normalizeText(value.defaultModelId) || models[0]?.id || '';
+    return {
+      id,
+      kind: 'custom',
+      revision: normalizeInteger(value.revision),
+      name: normalizeText(value.name) || 'Custom provider',
+      baseUrl: normalizeText(value.baseUrl),
+      wireApiPreference: normalizeWireApi(value.wireApiPreference, true),
+      resolvedWireApi: normalizeWireApi(value.resolvedWireApi, false),
+      models,
+      defaultModelId,
+      requestTimeoutMs: normalizeInteger(value.requestTimeoutMs) || 30000,
+      reasoningAdapter: normalizeReasoningAdapter(value.reasoningAdapter),
+      reasoningCapability: normalizeReasoningCapability(value.reasoningCapability),
+      authMode: normalizeAuthMode(value.authMode),
+      apiKeyHeaderName: normalizeText(value.apiKeyHeaderName),
+      fullEndpoint: value.fullEndpoint === true,
+      customHeaders: normalizeRecord(value.customHeaders),
+      queryParams: normalizeRecord(value.queryParams),
+      bodyOverrides: normalizeRecord(value.bodyOverrides),
+      contextWindow: normalizeInteger(value.contextWindow) || 262144,
+      supportsParallelToolCalls: value.supportsParallelToolCalls === true,
+      supportsStreamOptions: value.supportsStreamOptions === true,
+      inputModalities: normalizeInputModalities(value.inputModalities),
+      anthropicVersion: normalizeText(value.anthropicVersion) || '2023-06-01',
+      anthropicBeta: normalizeText(value.anthropicBeta),
+      anthropicThinkingMode: normalizeAnthropicThinkingMode(value.anthropicThinkingMode),
+      anthropicPromptCaching: value.anthropicPromptCaching === true,
+      impersonateClaudeCode: value.impersonateClaudeCode === true,
+      maxOutputTokens: normalizeMaxOutputTokens(value.maxOutputTokens),
+      hasSecret: value.hasSecret === true,
+      secretUpdatedAt: normalizeInteger(value.secretUpdatedAt),
+      endpointDisclosureHost: normalizeText(value.endpointDisclosureHost),
+      endpointDisclosureBaseUrl: normalizeText(value.endpointDisclosureBaseUrl),
+      endpointDisclosureAcceptedAt: normalizeInteger(value.endpointDisclosureAcceptedAt),
+      modelDiagnostics: normalizeModelDiagnostics(value.modelDiagnostics),
+      lastVerified: value.lastVerified && typeof value.lastVerified === 'object'
+        ? {
+            revision: normalizeInteger(value.lastVerified.revision),
+            at: normalizeInteger(value.lastVerified.at),
+            modelId: normalizeText(value.lastVerified.modelId),
+            wireApi: normalizeWireApi(value.lastVerified.wireApi, false),
+            upstreamResponseMode: normalizeUpstreamResponseMode(value.lastVerified.upstreamResponseMode, false)
+          }
+        : null,
+      createdAt: normalizeInteger(value.createdAt),
+      updatedAt: normalizeInteger(value.updatedAt)
+    };
+  }
+
+  function normalizeModels(models) {
+    if (!Array.isArray(models)) {
+      return [];
+    }
+    const seen = new Set();
+    const result = [];
+    for (const value of models) {
+      const id = normalizeText(typeof value === 'string' ? value : value?.id);
+      if (!id || seen.has(id)) {
+        continue;
+      }
+      seen.add(id);
+      result.push({
+        id,
+        label: normalizeText(value?.label) || id,
+        reasoningEfforts: Array.isArray(value?.reasoningEfforts)
+          ? value.reasoningEfforts.map(normalizeText).filter(Boolean)
+          : [],
+        upstreamResponseMode: normalizeUpstreamResponseMode(value?.upstreamResponseMode, true),
+        resolvedUpstreamResponseMode: normalizeUpstreamResponseMode(value?.resolvedUpstreamResponseMode, false),
+        contextWindow: normalizeInteger(value?.contextWindow) || 262144,
+        supportsParallelToolCalls: value?.supportsParallelToolCalls === true,
+        inputModalities: normalizeInputModalities(value?.inputModalities),
+        baseInstructions: normalizeText(value?.baseInstructions)
+      });
+    }
+    return result;
+  }
+
+  function buildBuiltinProvider() {
+    return {
+      id: BUILTIN_PROVIDER_ID,
+      kind: 'builtin',
+      revision: 0,
+      name: 'Built-in Codex',
+      editable: false,
+      deletable: false,
+      models: []
+    };
+  }
+
+  function buildEmptyDraft() {
+    return {
+      id: '',
+      kind: 'custom',
+      revision: 0,
+      name: 'Custom provider',
+      baseUrl: '',
+      wireApiPreference: 'auto',
+      resolvedWireApi: '',
+      models: [],
+      defaultModelId: '',
+      requestTimeoutMs: 30000,
+      reasoningAdapter: 'auto',
+      reasoningCapability: 'auto',
+      authMode: 'bearer',
+      apiKeyHeaderName: '',
+      fullEndpoint: false,
+      customHeaders: {},
+      queryParams: {},
+      bodyOverrides: {},
+      contextWindow: 262144,
+      supportsParallelToolCalls: false,
+      supportsStreamOptions: false,
+      inputModalities: ['text'],
+      anthropicVersion: '2023-06-01',
+      anthropicBeta: '',
+      anthropicThinkingMode: 'budget',
+      anthropicPromptCaching: false,
+      impersonateClaudeCode: false,
+      maxOutputTokens: 32768,
+      hasSecret: false,
+      secretUpdatedAt: 0,
+      endpointDisclosureHost: '',
+      endpointDisclosureBaseUrl: '',
+      modelDiagnostics: {},
+      lastVerified: null
+    };
+  }
+
+  function getActiveProvider(catalog = {}) {
+    const normalized = normalizeCatalog(catalog);
+    return normalized.providers.find(provider => provider.id === normalized.activeProviderId)
+      || buildBuiltinProvider();
+  }
+
+  function buildRunSelection(catalog = {}) {
+    const active = getActiveProvider(catalog);
+    return {
+      providerId: active.id,
+      providerRevision: active.revision || 0
+    };
+  }
+
+  function normalizeWireApi(value, allowAuto) {
+    const normalized = normalizeText(value).toLowerCase();
+    if (normalized === 'responses' || normalized === 'chat' || normalized === 'anthropic') {
+      return normalized;
+    }
+    return allowAuto ? 'auto' : '';
+  }
+
+  function normalizeReasoningAdapter(value) {
+    const normalized = normalizeText(value).toLowerCase();
+    return ['auto', 'none', 'deepseek', 'anthropic', 'reasoning_effort', 'openrouter', 'enable_thinking', 'thinking', 'reasoning_split'].includes(normalized)
+      ? normalized
+      : 'auto';
+  }
+
+  function normalizeReasoningCapability(value) {
+    const normalized = normalizeText(value).toLowerCase();
+    return ['auto', 'none', 'toggle', 'effort'].includes(normalized) ? normalized : 'auto';
+  }
+
+  function normalizeUpstreamResponseMode(value, allowAuto) {
+    const normalized = normalizeText(value).toLowerCase();
+    if (normalized === 'streaming' || normalized === 'buffered' || (allowAuto && normalized === 'auto')) {
+      return normalized;
+    }
+    return allowAuto ? 'auto' : '';
+  }
+
+  function normalizeAuthMode(value) {
+    const normalized = normalizeText(value).toLowerCase();
+    return ['bearer', 'x-api-key', 'api-key', 'custom', 'none'].includes(normalized)
+      ? normalized
+      : 'bearer';
+  }
+
+  function normalizeRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? { ...value } : {};
+  }
+
+  function normalizeModelDiagnostics(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+      return {};
+    }
+    const result = {};
+    for (const [rawModelId, rawDiagnostic] of Object.entries(value).slice(0, 32)) {
+      const modelId = normalizeText(rawModelId);
+      if (!modelId || !rawDiagnostic || typeof rawDiagnostic !== 'object') {
+        continue;
+      }
+      const status = normalizeText(rawDiagnostic.status).toLowerCase();
+      result[modelId] = {
+        modelId,
+        status: status === 'failed' ? 'failed' : 'tested',
+        at: normalizeInteger(rawDiagnostic.at),
+        wireApi: normalizeWireApi(rawDiagnostic.wireApi, false),
+        upstreamResponseMode: normalizeUpstreamResponseMode(rawDiagnostic.upstreamResponseMode, false),
+        durationMs: normalizeInteger(rawDiagnostic.durationMs),
+        errorCode: normalizeText(rawDiagnostic.errorCode)
+      };
+    }
+    return result;
+  }
+
+  function normalizeInputModalities(value) {
+    const values = Array.isArray(value) ? value : ['text'];
+    const result = Array.from(new Set(values.map(normalizeText).filter(item => item === 'text' || item === 'image')));
+    return result.includes('text') ? result : ['text', ...result];
+  }
+
+  function normalizeAnthropicThinkingMode(value) {
+    const normalized = normalizeText(value).toLowerCase();
+    return ['budget', 'adaptive', 'none'].includes(normalized) ? normalized : 'budget';
+  }
+
+  function normalizeText(value) {
+    return typeof value === 'string' ? value.trim() : '';
+  }
+
+  function normalizeInteger(value) {
+    const number = Number(value);
+    return Number.isFinite(number) && number >= 0 ? Math.floor(number) : 0;
+  }
+
+  function normalizeMaxOutputTokens(value) {
+    const number = normalizeInteger(value);
+    return !number || number === 8192 ? 32768 : number;
+  }
+
+  return {
+    BUILTIN_PROVIDER_ID,
+    buildBuiltinProvider,
+    buildEmptyDraft,
+    buildRunSelection,
+    getActiveProvider,
+    normalizeCatalog,
+    normalizeProvider
+  };
+});

package/extension/src/shared/sessionState.js

@@ -19,6 +19,7 @@
     locale: 'en',
     requireReviewing: true,
     autoOpen: true,
+    preloadProjectContext: true,
     loadCodexLocalSkills: true,
     loadCodexOverleafSkills: true,
     codexOverleafSkillEnabled: {},
@@ -34,7 +35,12 @@
   };
 
   const VALID_MODES = new Set(['ask', 'confirm', 'auto']);
-  const VALID_REASONING = new Set(['low', 'medium', 'high', 'xhigh']);
+  // Keep the persisted/session-level contract aligned with the model picker
+  // and native provider bridge. Custom providers can explicitly disable
+  // reasoning (`none`) or expose the lightest Codex tier (`minimal`). Dropping
+  // either value here silently restores the global `high` default after the
+  // user has selected it in the composer.
+  const VALID_REASONING = new Set(['none', 'minimal', 'low', 'medium', 'high', 'xhigh']);
   const VALID_SPEED_TIERS = new Set(['standard', 'fast']);
   const VALID_LOCALES = new Set(['en', 'zh']);
   const VALID_EVENT_STATUSES = new Set(['info', 'running', 'completed', 'failed', 'warning', 'blocked', 'skipped', 'pending']);
@@ -63,7 +69,10 @@
     maxUndoRunsPerSession: 2,
     maxUndoBytesPerRun: 320 * 1024,
     targetBytes: 4 * 1024 * 1024,
-    titleChars: 6000,
+    // Stream events carry accumulated assistant/reasoning text in `title`.
+    // Keep one provider-sized response intact; the 4 MiB state target below
+    // remains the aggregate history guard and prunes older events when needed.
+    titleChars: 128 * 1024,
     detailChars: 3000,
     reportDetailChars: 64000,
     historyChars: 1800,
@@ -945,6 +954,7 @@
       locale: normalizeLocale(source.locale),
       requireReviewing: active ? active.requireReviewing !== false : source.requireReviewing !== false,
       autoOpen: source.autoOpen !== false,
+      preloadProjectContext: source.preloadProjectContext !== false,
       loadCodexLocalSkills: source.loadCodexLocalSkills !== false,
       loadCodexOverleafSkills: source.loadCodexOverleafSkills !== false,
       codexOverleafSkillEnabled: normalizeCodexOverleafSkillEnabled(source.codexOverleafSkillEnabled),

package/extension/src/shared/storageDb.js

@@ -26,7 +26,7 @@
     taskChars: 12000,
     historyTaskChars: 300,
     historyResultChars: 1800,
-    eventTitleChars: 6000,
+    eventTitleChars: 128 * 1024,
     statusTextChars: 800,
     detailChars: 3000,
     reportDetailChars: 64000,