fix(codex): preserve context defaults from the client model API

src/i18n/ja.ts

@@ -76,9 +76,8 @@ export const jaOverrides = {
   'agents.catalog.displayName': '表示名',
   'agents.catalog.description': 'モデルの説明',
   'agents.catalog.context': 'コンテキストウィンドウ（トークン）',
-  'agents.catalog.contextSource.definition': 'コンテキストの取得元：CPA コア API のモデル定義。',
+  'agents.catalog.contextSource.client': 'コンテキストの取得元：CPA コアの Codex クライアントモデル一覧 API。',
   'agents.catalog.contextSource.configuration': 'コンテキストの取得元：CPA コアでこのモデルに設定された max-context-length。',
-  'agents.catalog.contextSource.compatibility': 'CPA にこのモデル固有のコンテキスト定義がありません。現在の値は互換カタログの値であり、汎用テンプレートの既定値である可能性があります。',
   'agents.catalog.contextSource.template': 'コアに有効なコンテキスト情報がありません。ソフトウェアのテンプレートの代替値を使用しています。',
   'agents.catalog.contextSource.customized': 'コンテキストの取得元：このモデルのカスタム設定。',
   'agents.catalog.maximum': '最大コンテキストウィンドウ（トークン）',
@@ -810,6 +809,28 @@ export const jaOverrides = {
   'agents.status.invalid': '設定が無効',
   'agents.status.applied': '適用済み',
   'agents.status.unconfigured': '未設定',
+  "agents.history.button": "設定履歴を復元",
+  "agents.history.description": "ソフトウェア管理の項目のみ復元し、他の設定を保持します。復元前に現在の設定を保存し、フォームを更新します。",
+  "agents.history.versions": "履歴",
+  "agents.history.empty": "履歴はありません。設定更新時に自動保存されます。",
+  "agents.history.files": "{count} ファイル",
+  "agents.history.preview": "復元プレビュー",
+  "agents.history.loading": "読み込み中…",
+  "agents.history.select": "履歴を選択して復元する項目を確認してください。",
+  "agents.history.unchanged": "設定は最新です。",
+  "agents.history.updated": "設定を更新し、履歴を保存しました。",
+  "agents.history.restored": "設定を復元しました。他の設定は保持されています。",
+  "agents.history.field": "項目",
+  "agents.history.current": "現在",
+  "agents.history.target": "履歴値",
+  "agents.history.restore": "この履歴を復元",
+  "agents.history.before": "{source}前のバックアップ",
+  "agents.history.source.update": "設定更新",
+  "agents.history.source.default": "既定設定",
+  "agents.history.source.clear": "設定消去",
+  "agents.history.source.restore": "復元",
+  "agents.history.source.sync": "自動同期",
+  "agents.history.source.legacy": "旧バージョンのバックアップ",
   'agents.title': 'エージェント設定',
   'agents.embedded.title': 'クライアントとモデルを選んで起動',
   'agents.embedded.subtitle': 'ない場合は先にインストールしてください',
@@ -937,10 +958,10 @@ export const jaOverrides = {
   'agents.pi.uninstall': 'Pi プラグインをアンインストール',
   'agents.pi.uninstalling': 'プラグインをアンインストール中',
   'agents.default.title': 'デフォルト設定にリセット',
-  'agents.default.description': '選択中のモデルを使って {name} の関連設定ファイルをすべて書き直し、その他のユーザー内容を削除します。バックアップは作成されず、元に戻せません。',
+  'agents.default.description': '選択中のモデルを使って {name} の関連設定ファイルをすべて書き直し、その他のユーザー内容を削除します。操作前に履歴を保存します。履歴から復元できるのは管理対象フィールドのみで、削除された独自設定は復元されません。',
   'agents.default.confirm': 'デフォルト設定を書き込む',
   'agents.clear.title': 'Codex 設定を消去',
-  'agents.clear.description': 'Codex 設定ディレクトリの auth.json と config.toml を完全に削除し、このアプリが記録した適用状態をリセットします。バックアップは作成されず、元に戻せません。',
+  'agents.clear.description': 'Codex 設定ディレクトリの auth.json と config.toml を完全に削除します。操作前に履歴を保存します。履歴から復元できるのは管理対象フィールドのみで、削除された独自設定は復元されません。',
   'agents.clear.confirm': '設定を消去',
   'agents.clear.success': 'Codex 設定を消去しました。',
   'apiAccess.compatibleName': 'OpenAI 互換 {number}',

src/i18n/locales/en.ts

@@ -26,9 +26,8 @@ export const en: Record<MessageKey, string> = {
   'agents.catalog.displayName': 'Display name',
   'agents.catalog.description': 'Description',
   'agents.catalog.context': 'Context window (tokens)',
-  'agents.catalog.contextSource.definition': 'Context source: model definitions from the CPA core API.',
+  'agents.catalog.contextSource.client': 'Context source: the CPA core Codex client model catalog API.',
   'agents.catalog.contextSource.configuration': 'Context source: max-context-length configured for this model in the CPA core.',
-  'agents.catalog.contextSource.compatibility': 'CPA provides no independent context definition for this model. The current value comes from its compatibility catalog and may be a generic template default.',
   'agents.catalog.contextSource.template': 'The core provides no valid context data. The current value is a fallback from the application template.',
   'agents.catalog.contextSource.customized': 'Context source: your custom settings for this model.',
   'agents.catalog.maximum': 'Maximum context window (tokens)',
@@ -810,6 +809,28 @@ export const en: Record<MessageKey, string> = {
   'agents.status.invalid': 'Invalid Configuration',
   'agents.status.applied': 'Applied',
   'agents.status.unconfigured': 'Not Configured',
+  "agents.history.button": "Restore configuration history",
+  "agents.history.description": "Restore only software-managed fields and preserve other settings. Current configuration is backed up first; form drafts refresh after restoring.",
+  "agents.history.versions": "Versions",
+  "agents.history.empty": "No history yet. Updating configuration saves versions automatically.",
+  "agents.history.files": "{count} files",
+  "agents.history.preview": "Restore preview",
+  "agents.history.loading": "Loading…",
+  "agents.history.select": "Select a version to preview the fields to restore.",
+  "agents.history.unchanged": "Configuration is already up to date.",
+  "agents.history.updated": "Configuration updated and history saved.",
+  "agents.history.restored": "Configuration restored. Other custom settings were preserved.",
+  "agents.history.field": "Field",
+  "agents.history.current": "Current",
+  "agents.history.target": "Historical",
+  "agents.history.restore": "Restore this version",
+  "agents.history.before": "Before {source}",
+  "agents.history.source.update": "Update",
+  "agents.history.source.default": "Default configuration",
+  "agents.history.source.clear": "Clear configuration",
+  "agents.history.source.restore": "Restore",
+  "agents.history.source.sync": "Automatic sync",
+  "agents.history.source.legacy": "Legacy backup",
   'agents.title': 'Agent Configuration',
   'agents.embedded.title': 'Select a client and model, then start',
   'agents.embedded.subtitle': 'Install it first if it is not available',
@@ -937,10 +958,10 @@ export const en: Record<MessageKey, string> = {
   'agents.pi.uninstall': 'Uninstall Pi Plugin',
   'agents.pi.uninstalling': 'Uninstalling plugin',
   'agents.default.title': 'Reset to Default Configuration',
-  'agents.default.description': 'This rewrites every related {name} configuration file using the selected model and deletes all other user content in those files. No backup is created and the operation cannot be undone.',
+  'agents.default.description': 'This rewrites every related {name} configuration file using the selected model and deletes all other user content in those files. A history snapshot is saved first. History recovery restores only managed fields, not deleted custom settings.',
   'agents.default.confirm': 'Write Default Configuration',
   'agents.clear.title': 'Clear Codex Configuration',
-  'agents.clear.description': 'This permanently deletes auth.json and config.toml from the Codex configuration directory and resets the application state tracked by this app. No backup is created and the operation cannot be undone.',
+  'agents.clear.description': 'This permanently deletes auth.json and config.toml from the Codex configuration directory. A history snapshot is saved first. History recovery restores only managed fields, not deleted custom settings.',
   'agents.clear.confirm': 'Clear Configuration',
   'agents.clear.success': 'The Codex configuration has been cleared.',
   'apiAccess.compatibleName': 'OpenAI Compatible {number}',

src/i18n/locales/zh-CN.ts

@@ -25,9 +25,8 @@ export const zhCN = {
   'agents.catalog.displayName': '显示名称',
   'agents.catalog.description': '模型说明',
   'agents.catalog.context': '上下文窗口（tokens）',
-  'agents.catalog.contextSource.definition': '上下文来源：CPA 内核的模型定义 API。',
+  'agents.catalog.contextSource.client': '上下文来源：CPA 内核的 Codex 客户端模型列表 API。',
   'agents.catalog.contextSource.configuration': '上下文来源：CPA 内核中为此模型配置的 max-context-length。',
-  'agents.catalog.contextSource.compatibility': 'CPA 未提供此模型的独立上下文定义，当前值来自兼容目录，可能是通用模板默认值。',
   'agents.catalog.contextSource.template': '内核未提供有效的上下文数据，当前使用软件模板的后备值。',
   'agents.catalog.contextSource.customized': '上下文来源：你为此模型保存或编辑的自定义配置。',
   'agents.catalog.maximum': '最大上下文窗口（tokens）',
@@ -809,6 +808,28 @@ export const zhCN = {
   'agents.status.invalid': '配置无效',
   'agents.status.applied': '已应用',
   'agents.status.unconfigured': '尚未配置',
+  "agents.history.button": "恢复历史配置",
+  "agents.history.description": "仅恢复软件管理的配置字段，保留其他自定义设置。恢复前会自动备份当前配置；当前表单草稿将按恢复结果刷新。",
+  "agents.history.versions": "历史版本",
+  "agents.history.empty": "暂无配置历史。更新配置后会自动保留版本。",
+  "agents.history.files": "{count} 个文件",
+  "agents.history.preview": "恢复变更预览",
+  "agents.history.loading": "正在读取…",
+  "agents.history.select": "选择一个历史版本，查看将恢复的字段。",
+  "agents.history.unchanged": "配置已是最新，无需更新。",
+  "agents.history.updated": "配置已更新，历史备份已保存。",
+  "agents.history.restored": "已恢复历史配置，其他自定义设置已保留。",
+  "agents.history.field": "配置字段",
+  "agents.history.current": "当前值",
+  "agents.history.target": "历史值",
+  "agents.history.restore": "恢复此版本",
+  "agents.history.before": "{source}前备份",
+  "agents.history.source.update": "更新配置",
+  "agents.history.source.default": "默认配置",
+  "agents.history.source.clear": "清空配置",
+  "agents.history.source.restore": "恢复配置",
+  "agents.history.source.sync": "自动同步",
+  "agents.history.source.legacy": "旧版备份",
   'agents.title': '智能体配置',
   'agents.embedded.title': '选择客户端和模型后启动',
   'agents.embedded.subtitle': '如果没有客户端请自行安装',
@@ -936,10 +957,10 @@ export const zhCN = {
   'agents.pi.uninstall': '卸载 Pi 插件',
   'agents.pi.uninstalling': '正在卸载插件',
   'agents.default.title': '重置为默认配置',
-  'agents.default.description': '这会使用当前选中模型重写 {name} 的全部相关配置文件，并删除其中其他用户内容。该操作没有备份且无法恢复。',
+  'agents.default.description': '这会使用当前选中模型重写 {name} 的全部相关配置文件，并删除其中其他用户内容。操作前会保存历史备份；历史恢复仅恢复软件管理的字段，不能恢复被清除的其他自定义内容。',
   'agents.default.confirm': '确认写入默认配置',
   'agents.clear.title': '清空 Codex 配置',
-  'agents.clear.description': '这会永久删除 Codex 配置目录中的 auth.json 和 config.toml，并重置软件记录的应用状态。该操作没有备份且无法恢复。',
+  'agents.clear.description': '这会永久删除 Codex 配置目录中的 auth.json 和 config.toml。操作前会保存历史备份；历史恢复仅恢复软件管理的字段，不能恢复被清除的其他自定义内容。',
   'agents.clear.confirm': '确认清空配置',
   'agents.clear.success': 'Codex 配置已清空。',
   'apiAccess.compatibleName': 'OpenAI 兼容 {number}',

src/services/codexModelCatalog.ts

@@ -25,7 +25,7 @@ export type CodexModelConfiguration = {
 export type CodexCatalogEditorModel = {
   slug: string;
   hasOfficialTemplate: boolean;
-  contextSource: "definition" | "configuration" | "compatibility" | "template";
+  contextSource: "client" | "configuration" | "template";
   customized: boolean;
   configuration: CodexModelConfiguration;
   defaults: CodexModelConfiguration;