tide-commander 0.84.3 → 0.85.0

package/dist/assets/{web-B0x9suno.js → web-C9K1Th3w.js}

@@ -1 +1 @@
-import{W as s}from"./main-Cl7abmzo.js";import"./modulepreload-polyfill-B5Qt9EMX.js";import"./vendor-react-uS-d4TUT.js";import"./vendor-three-DJ4p3FLF.js";class f extends s{constructor(){super(...arguments),this.pending=[],this.deliveredNotifications=[],this.hasNotificationSupport=()=>{if(!("Notification"in window)||!Notification.requestPermission)return!1;if(Notification.permission!=="granted")try{new Notification("")}catch(i){if(i instanceof Error&&i.name==="TypeError")return!1}return!0}}async getDeliveredNotifications(){const i=[];for(const t of this.deliveredNotifications){const e={title:t.title,id:parseInt(t.tag),body:t.body};i.push(e)}return{notifications:i}}async removeDeliveredNotifications(i){for(const t of i.notifications){const e=this.deliveredNotifications.find(n=>n.tag===String(t.id));e==null||e.close(),this.deliveredNotifications=this.deliveredNotifications.filter(()=>!e)}}async removeAllDeliveredNotifications(){for(const i of this.deliveredNotifications)i.close();this.deliveredNotifications=[]}async createChannel(){throw this.unimplemented("Not implemented on web.")}async deleteChannel(){throw this.unimplemented("Not implemented on web.")}async listChannels(){throw this.unimplemented("Not implemented on web.")}async schedule(i){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");for(const t of i.notifications)this.sendNotification(t);return{notifications:i.notifications.map(t=>({id:t.id}))}}async getPending(){return{notifications:this.pending}}async registerActionTypes(){throw this.unimplemented("Not implemented on web.")}async cancel(i){this.pending=this.pending.filter(t=>!i.notifications.find(e=>e.id===t.id))}async areEnabled(){const{display:i}=await this.checkPermissions();return{value:i==="granted"}}async changeExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async checkExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async requestPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(await Notification.requestPermission())}}async checkPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(Notification.permission)}}transformNotificationPermission(i){switch(i){case"granted":return"granted";case"denied":return"denied";default:return"prompt"}}sendPending(){var i;const t=[],e=new Date().getTime();for(const n of this.pending)!((i=n.schedule)===null||i===void 0)&&i.at&&n.schedule.at.getTime()<=e&&(this.buildNotification(n),t.push(n));this.pending=this.pending.filter(n=>!t.find(o=>o===n))}sendNotification(i){var t;if(!((t=i.schedule)===null||t===void 0)&&t.at){const e=i.schedule.at.getTime()-new Date().getTime();this.pending.push(i),setTimeout(()=>{this.sendPending()},e);return}this.buildNotification(i)}buildNotification(i){const t=new Notification(i.title,{body:i.body,tag:String(i.id)});return t.addEventListener("click",this.onClick.bind(this,i),!1),t.addEventListener("show",this.onShow.bind(this,i),!1),t.addEventListener("close",()=>{this.deliveredNotifications=this.deliveredNotifications.filter(()=>!this)},!1),this.deliveredNotifications.push(t),t}onClick(i){const t={actionId:"tap",notification:i};this.notifyListeners("localNotificationActionPerformed",t)}onShow(i){this.notifyListeners("localNotificationReceived",i)}}export{f as LocalNotificationsWeb};
+import{W as s}from"./main-hADDQllW.js";import"./modulepreload-polyfill-B5Qt9EMX.js";import"./vendor-react-uS-d4TUT.js";import"./vendor-three-DJ4p3FLF.js";class f extends s{constructor(){super(...arguments),this.pending=[],this.deliveredNotifications=[],this.hasNotificationSupport=()=>{if(!("Notification"in window)||!Notification.requestPermission)return!1;if(Notification.permission!=="granted")try{new Notification("")}catch(i){if(i instanceof Error&&i.name==="TypeError")return!1}return!0}}async getDeliveredNotifications(){const i=[];for(const t of this.deliveredNotifications){const e={title:t.title,id:parseInt(t.tag),body:t.body};i.push(e)}return{notifications:i}}async removeDeliveredNotifications(i){for(const t of i.notifications){const e=this.deliveredNotifications.find(n=>n.tag===String(t.id));e==null||e.close(),this.deliveredNotifications=this.deliveredNotifications.filter(()=>!e)}}async removeAllDeliveredNotifications(){for(const i of this.deliveredNotifications)i.close();this.deliveredNotifications=[]}async createChannel(){throw this.unimplemented("Not implemented on web.")}async deleteChannel(){throw this.unimplemented("Not implemented on web.")}async listChannels(){throw this.unimplemented("Not implemented on web.")}async schedule(i){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");for(const t of i.notifications)this.sendNotification(t);return{notifications:i.notifications.map(t=>({id:t.id}))}}async getPending(){return{notifications:this.pending}}async registerActionTypes(){throw this.unimplemented("Not implemented on web.")}async cancel(i){this.pending=this.pending.filter(t=>!i.notifications.find(e=>e.id===t.id))}async areEnabled(){const{display:i}=await this.checkPermissions();return{value:i==="granted"}}async changeExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async checkExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async requestPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(await Notification.requestPermission())}}async checkPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(Notification.permission)}}transformNotificationPermission(i){switch(i){case"granted":return"granted";case"denied":return"denied";default:return"prompt"}}sendPending(){var i;const t=[],e=new Date().getTime();for(const n of this.pending)!((i=n.schedule)===null||i===void 0)&&i.at&&n.schedule.at.getTime()<=e&&(this.buildNotification(n),t.push(n));this.pending=this.pending.filter(n=>!t.find(o=>o===n))}sendNotification(i){var t;if(!((t=i.schedule)===null||t===void 0)&&t.at){const e=i.schedule.at.getTime()-new Date().getTime();this.pending.push(i),setTimeout(()=>{this.sendPending()},e);return}this.buildNotification(i)}buildNotification(i){const t=new Notification(i.title,{body:i.body,tag:String(i.id)});return t.addEventListener("click",this.onClick.bind(this,i),!1),t.addEventListener("show",this.onShow.bind(this,i),!1),t.addEventListener("close",()=>{this.deliveredNotifications=this.deliveredNotifications.filter(()=>!this)},!1),this.deliveredNotifications.push(t),t}onClick(i){const t={actionId:"tap",notification:i};this.notifyListeners("localNotificationActionPerformed",t)}onShow(i){this.notifyListeners("localNotificationReceived",i)}}export{f as LocalNotificationsWeb};

package/dist/index.html

@@ -22,11 +22,11 @@
     <link rel="icon" type="image/png" sizes="16x16" href="/assets/icons/favicon-16x16.png" />
     <link rel="apple-touch-icon" sizes="180x180" href="/assets/icons/apple-touch-icon.png" />
     <title>Tide Commander</title>
-    <script type="module" crossorigin src="/assets/main-Cl7abmzo.js"></script>
+    <script type="module" crossorigin src="/assets/main-hADDQllW.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/modulepreload-polyfill-B5Qt9EMX.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-uS-d4TUT.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-three-DJ4p3FLF.js">
-    <link rel="stylesheet" crossorigin href="/assets/main-C6IAMrFB.css">
+    <link rel="stylesheet" crossorigin href="/assets/main-BB4dFHqm.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/locales/de/config.json

@@ -53,7 +53,10 @@
     "tokenRequired": "Erforderlich wenn der Server AUTH_TOKEN gesetzt hat",
     "saveAndReconnect": "Speichern und neu verbinden",
     "showToken": "Token anzeigen",
-    "hideToken": "Token ausblenden"
+    "hideToken": "Token ausblenden",
+    "codexBinaryPath": "Codex-Binärpfad",
+    "codexBinaryPathPlaceholder": "Leer lassen für automatische Erkennung",
+    "codexBinaryPathHint": "Pfad zur nativen Codex-Binärdatei. Umgeht den Node.js-Wrapper für bessere Sitzungspersistenz."
   },
   "scene": {
     "characterSize": "Charaktergröße",

package/dist/locales/en/config.json

@@ -53,7 +53,10 @@
     "tokenRequired": "Required if server has AUTH_TOKEN set",
     "saveAndReconnect": "Save and reconnect",
     "showToken": "Show token",
-    "hideToken": "Hide token"
+    "hideToken": "Hide token",
+    "codexBinaryPath": "Codex Binary Path",
+    "codexBinaryPathPlaceholder": "Leave empty for auto-detect",
+    "codexBinaryPathHint": "Path to the native Codex binary. Bypasses the Node.js wrapper for better session persistence."
   },
   "scene": {
     "characterSize": "Character Size",

package/dist/locales/es/config.json

@@ -53,7 +53,10 @@
     "tokenRequired": "Requerido si el servidor tiene AUTH_TOKEN configurado",
     "saveAndReconnect": "Guardar y reconectar",
     "showToken": "Mostrar token",
-    "hideToken": "Ocultar token"
+    "hideToken": "Ocultar token",
+    "codexBinaryPath": "Ruta del binario Codex",
+    "codexBinaryPathPlaceholder": "Dejar vacío para detección automática",
+    "codexBinaryPathHint": "Ruta al binario nativo de Codex. Omite el wrapper de Node.js para mejor persistencia de sesión."
   },
   "scene": {
     "characterSize": "Tamano del personaje",

package/dist/locales/fr/config.json

@@ -53,7 +53,10 @@
     "tokenRequired": "Requis si le serveur a AUTH_TOKEN défini",
     "saveAndReconnect": "Enregistrer et reconnecter",
     "showToken": "Afficher le jeton",
-    "hideToken": "Masquer le jeton"
+    "hideToken": "Masquer le jeton",
+    "codexBinaryPath": "Chemin du binaire Codex",
+    "codexBinaryPathPlaceholder": "Laisser vide pour la détection automatique",
+    "codexBinaryPathHint": "Chemin vers le binaire natif Codex. Contourne le wrapper Node.js pour une meilleure persistance de session."
   },
   "scene": {
     "characterSize": "Taille du personnage",

package/dist/locales/hi/config.json

@@ -53,7 +53,10 @@
     "tokenRequired": "यदि सर्वर पर AUTH_TOKEN सेट है तो आवश्यक",
     "saveAndReconnect": "सहेजें और पुनः कनेक्ट करें",
     "showToken": "टोकन दिखाएं",
-    "hideToken": "टोकन छुपाएं"
+    "hideToken": "टोकन छुपाएं",
+    "codexBinaryPath": "Codex बाइनरी पथ",
+    "codexBinaryPathPlaceholder": "स्वतः पहचान के लिए खाली छोड़ें",
+    "codexBinaryPathHint": "नेटिव Codex बाइनरी का पथ। बेहतर सत्र स्थिरता के लिए Node.js रैपर को बायपास करता है।"
   },
   "scene": {
     "characterSize": "कैरेक्टर आकार",

package/dist/locales/it/config.json

@@ -53,7 +53,10 @@
     "tokenRequired": "Richiesto se il server ha AUTH_TOKEN impostato",
     "saveAndReconnect": "Salva e riconnetti",
     "showToken": "Mostra token",
-    "hideToken": "Nascondi token"
+    "hideToken": "Nascondi token",
+    "codexBinaryPath": "Percorso binario Codex",
+    "codexBinaryPathPlaceholder": "Lasciare vuoto per il rilevamento automatico",
+    "codexBinaryPathHint": "Percorso al binario nativo Codex. Bypassa il wrapper Node.js per una migliore persistenza della sessione."
   },
   "scene": {
     "characterSize": "Dimensione personaggio",

package/dist/locales/ja/config.json

@@ -53,7 +53,10 @@
     "tokenRequired": "サーバーにAUTH_TOKENが設定されている場合は必須",
     "saveAndReconnect": "保存して再接続",
     "showToken": "トークンを表示",
-    "hideToken": "トークンを非表示"
+    "hideToken": "トークンを非表示",
+    "codexBinaryPath": "Codexバイナリパス",
+    "codexBinaryPathPlaceholder": "空欄で自動検出",
+    "codexBinaryPathHint": "ネイティブCodexバイナリへのパス。Node.jsラッパーをバイパスしてセッションの永続性を向上させます。"
   },
   "scene": {
     "characterSize": "キャラクターサイズ",

package/dist/locales/pt/config.json

@@ -53,7 +53,10 @@
     "tokenRequired": "Obrigatorio se o servidor tiver AUTH_TOKEN definido",
     "saveAndReconnect": "Salvar e reconectar",
     "showToken": "Mostrar token",
-    "hideToken": "Ocultar token"
+    "hideToken": "Ocultar token",
+    "codexBinaryPath": "Caminho do binário Codex",
+    "codexBinaryPathPlaceholder": "Deixe vazio para detecção automática",
+    "codexBinaryPathHint": "Caminho para o binário nativo do Codex. Ignora o wrapper Node.js para melhor persistência de sessão."
   },
   "scene": {
     "characterSize": "Tamanho do Personagem",

package/dist/locales/ru/config.json

@@ -53,7 +53,10 @@
     "tokenRequired": "Требуется, если на сервере установлен AUTH_TOKEN",
     "saveAndReconnect": "Сохранить и переподключиться",
     "showToken": "Показать токен",
-    "hideToken": "Скрыть токен"
+    "hideToken": "Скрыть токен",
+    "codexBinaryPath": "Путь к бинарному файлу Codex",
+    "codexBinaryPathPlaceholder": "Оставьте пустым для автоопределения",
+    "codexBinaryPathHint": "Путь к нативному бинарному файлу Codex. Обходит обёртку Node.js для лучшей сохранности сессий."
   },
   "scene": {
     "characterSize": "Размер персонажа",

package/dist/locales/zh-CN/config.json

@@ -53,7 +53,10 @@
     "tokenRequired": "如果服务器设置了 AUTH_TOKEN 则必填",
     "saveAndReconnect": "保存并重新连接",
     "showToken": "显示令牌",
-    "hideToken": "隐藏令牌"
+    "hideToken": "隐藏令牌",
+    "codexBinaryPath": "Codex 二进制路径",
+    "codexBinaryPathPlaceholder": "留空以自动检测",
+    "codexBinaryPathHint": "原生 Codex 二进制文件的路径。绕过 Node.js 包装器以获得更好的会话持久性。"
   },
   "scene": {
     "characterSize": "角色大小",

package/dist/src/packages/server/claude/runner/process-lifecycle.js

@@ -42,6 +42,7 @@ export class RunnerProcessLifecycle {
         const executable = this.backend.getExecutablePath();
         log.log(`🚀 Spawning: ${executable} ${args.join(' ')}`);
         const isWindows = process.platform === 'win32';
+        const extraEnv = this.backend.getExtraEnv?.() ?? {};
         const childProcess = spawn(executable, args, {
             cwd: workingDir,
             env: {
@@ -49,6 +50,7 @@ export class RunnerProcessLifecycle {
                 LANG: 'en_US.UTF-8',
                 LC_ALL: 'en_US.UTF-8',
                 TIDE_SERVER: `http://localhost:${process.env.TIDE_PORT || process.env.PORT || 5174}`,
+                ...extraEnv,
             },
             shell: isWindows ? true : false,
             detached: isWindows ? false : true,

package/dist/src/packages/server/claude/session-loader.js

@@ -155,6 +155,34 @@ function normalizeCodexFunctionToolCall(rawToolName, rawToolInput) {
         toolInput: rawToolInput,
     };
 }
+function normalizeCodexWebSearchToolInput(payload) {
+    const action = isObject(payload.action) ? payload.action : {};
+    const actionQueriesRaw = action.queries;
+    const actionQueries = Array.isArray(actionQueriesRaw) && actionQueriesRaw.every((q) => typeof q === 'string')
+        ? actionQueriesRaw
+        : undefined;
+    return {
+        actionType: typeof action.type === 'string' ? action.type : undefined,
+        actionQuery: typeof action.query === 'string' ? action.query : undefined,
+        actionQueries,
+        actionUrl: typeof action.url === 'string' ? action.url : undefined,
+        status: typeof payload.status === 'string' ? payload.status : undefined,
+    };
+}
+function normalizeCodexEventFallbackText(eventType, payload) {
+    let serialized = '';
+    try {
+        serialized = JSON.stringify(payload, null, 2);
+    }
+    catch {
+        serialized = String(payload);
+    }
+    const MAX_LEN = 4000;
+    if (serialized.length > MAX_LEN) {
+        serialized = `${serialized.slice(0, MAX_LEN)}...`;
+    }
+    return `[codex-event] ${eventType}\n${serialized}`;
+}
 function findCodexSessionFile(sessionId) {
     const cached = codexSessionFileById.get(sessionId);
     if (cached && fs.existsSync(cached)) {
@@ -445,6 +473,37 @@ function parseCodexEntryMessages(entry, messages, toolUseIdToName) {
             });
             return;
         }
+        // token_count: Skip in history (token accounting shown via turn.completed)
+        if (payload.type === 'token_count') {
+            return;
+        }
+        // agent_reasoning: Skip in history (consistent with Claude thinking behavior)
+        if (payload.type === 'agent_reasoning') {
+            return;
+        }
+        // turn_aborted: Skip in history (interruption is visible from agent stopping)
+        if (payload.type === 'turn_aborted') {
+            return;
+        }
+        // task_complete: Show the final agent message as formatted text
+        if (payload.type === 'task_complete' && typeof payload.last_agent_message === 'string') {
+            messages.push({
+                type: 'assistant',
+                content: payload.last_agent_message,
+                timestamp: entry.timestamp,
+                uuid: `${entry.timestamp}-assistant-task-complete`,
+            });
+            return;
+        }
+        // Unknown event_msg types: keep fallback
+        const payloadType = typeof payload.type === 'string' ? payload.type : 'unknown';
+        messages.push({
+            type: 'assistant',
+            content: normalizeCodexEventFallbackText(`event_msg.${payloadType}`, payload),
+            timestamp: entry.timestamp,
+            uuid: `${entry.timestamp}-assistant-codex-event`,
+        });
+        return;
     }
     if (entry.type !== 'response_item' || !isObject(entry.payload)) {
         return;
@@ -494,6 +553,32 @@ function parseCodexEntryMessages(entry, messages, toolUseIdToName) {
         });
         return;
     }
+    if (payloadType === 'web_search_call') {
+        const toolName = 'web_search';
+        const toolInput = normalizeCodexWebSearchToolInput(payload);
+        const status = typeof payload.status === 'string' ? payload.status : undefined;
+        const toolUseId = typeof payload.call_id === 'string' ? payload.call_id : `${entry.timestamp}-web-search`;
+        messages.push({
+            type: 'tool_use',
+            content: JSON.stringify(toolInput, null, 2),
+            timestamp: entry.timestamp,
+            uuid: `${entry.timestamp}-tool-use-web-search`,
+            toolName,
+            toolInput,
+            toolUseId,
+        });
+        if (status === 'completed') {
+            messages.push({
+                type: 'tool_result',
+                content: JSON.stringify(toolInput, null, 2),
+                timestamp: entry.timestamp,
+                uuid: `${entry.timestamp}-tool-result-web-search`,
+                toolName,
+                toolUseId,
+            });
+        }
+        return;
+    }
     if (payloadType === 'function_call_output') {
         const toolUseId = typeof payload.call_id === 'string' ? payload.call_id : undefined;
         const toolName = toolUseId ? (toolUseIdToName.get(toolUseId) || 'unknown') : 'unknown';
@@ -506,7 +591,80 @@ function parseCodexEntryMessages(entry, messages, toolUseIdToName) {
             toolName,
             toolUseId,
         });
+        return;
+    }
+    // reasoning: Skip in history (consistent with Claude thinking behavior)
+    if (payloadType === 'reasoning') {
+        return;
+    }
+    // custom_tool_call: Map to tool_use (normalize apply_patch -> Edit)
+    if (payloadType === 'custom_tool_call') {
+        const rawToolName = typeof payload.name === 'string' ? payload.name : 'unknown';
+        const callId = typeof payload.call_id === 'string' ? payload.call_id : undefined;
+        const rawInput = typeof payload.input === 'string' ? payload.input : '';
+        // Normalize: apply_patch -> Edit for consistent UI rendering
+        const toolName = rawToolName === 'apply_patch' ? 'Edit' : rawToolName;
+        const toolInput = {};
+        if (rawToolName === 'apply_patch' && rawInput) {
+            // Extract file path from patch for clickable display
+            const fileMatch = rawInput.match(/\*\*\* (?:Update|Add|Delete) File: (.+)/);
+            if (fileMatch) {
+                toolInput.file_path = fileMatch[1].trim();
+            }
+            toolInput.old_string = '';
+            toolInput.new_string = rawInput;
+        }
+        else {
+            toolInput.input = rawInput;
+        }
+        if (callId) {
+            toolUseIdToName.set(callId, toolName);
+        }
+        messages.push({
+            type: 'tool_use',
+            content: JSON.stringify(toolInput, null, 2),
+            timestamp: entry.timestamp,
+            uuid: `${entry.timestamp}-tool-use-custom`,
+            toolName,
+            toolInput,
+            toolUseId: callId,
+        });
+        return;
+    }
+    // custom_tool_call_output: Map to tool_result
+    if (payloadType === 'custom_tool_call_output') {
+        const callId = typeof payload.call_id === 'string' ? payload.call_id : undefined;
+        const toolName = callId ? (toolUseIdToName.get(callId) || 'unknown') : 'unknown';
+        let content = normalizeTextContent(payload.output);
+        // Parse apply_patch JSON output wrapper to extract meaningful text
+        if (content) {
+            try {
+                const parsed = JSON.parse(content);
+                if (isObject(parsed) && typeof parsed.output === 'string') {
+                    content = parsed.output;
+                }
+            }
+            catch {
+                // Use raw content as-is
+            }
+        }
+        messages.push({
+            type: 'tool_result',
+            content,
+            timestamp: entry.timestamp,
+            uuid: `${entry.timestamp}-tool-result-custom`,
+            toolName,
+            toolUseId: callId,
+        });
+        return;
     }
+    const unknownPayloadType = typeof payloadType === 'string' ? payloadType : 'unknown';
+    messages.push({
+        type: 'assistant',
+        content: normalizeCodexEventFallbackText(`response_item.${unknownPayloadType}`, payload),
+        timestamp: entry.timestamp,
+        uuid: `${entry.timestamp}-assistant-codex-response-item`,
+    });
 }
 async function parseSessionMessages(resolved) {
     const messages = [];

package/dist/src/packages/server/codex/backend.js

@@ -3,7 +3,7 @@ import * as os from 'os';
 import * as path from 'path';
 import { CodexJsonEventParser } from './json-event-parser.js';
 import { TIDE_COMMANDER_APPENDED_PROMPT } from '../prompts/tide-commander.js';
-import { isEchoPromptEnabled } from '../services/system-prompt-service.js';
+import { isEchoPromptEnabled, getCodexBinaryPath } from '../services/system-prompt-service.js';
 function shouldPassCodexModel(model) {
     if (!model)
         return false;
@@ -44,7 +44,7 @@ export class CodexBackend {
     buildArgs(config) {
         this.parser.setWorkingDirectory(config.workingDir);
         const prompt = buildCodexPrompt(config);
-        const args = ['exec', '--json'];
+        const args = ['exec', '--experimental-json'];
         const codexConfig = config.codexConfig;
         const fullAuto = codexConfig?.fullAuto !== false;
         if (fullAuto) {
@@ -94,6 +94,15 @@ export class CodexBackend {
         return null;
     }
     getExecutablePath() {
+        // Priority: 1) CODEX_BINARY env var  2) Settings UI  3) auto-detect
+        const envBinary = process.env.CODEX_BINARY;
+        if (envBinary && fs.existsSync(envBinary)) {
+            return envBinary;
+        }
+        const settingsBinary = getCodexBinaryPath();
+        if (settingsBinary && fs.existsSync(settingsBinary)) {
+            return settingsBinary;
+        }
         return this.detectInstallation() || 'codex';
     }
     detectInstallation() {
@@ -116,6 +125,21 @@ export class CodexBackend {
         }
         return null;
     }
+    getExtraEnv() {
+        // When using the native binary directly, we need to add
+        // the vendor path directory to PATH so codex can find bundled tools like rg.
+        const envBinary = process.env.CODEX_BINARY || getCodexBinaryPath();
+        if (!envBinary)
+            return {};
+        const codexDir = path.dirname(envBinary); // .../codex/
+        const archRoot = path.dirname(codexDir); // .../x86_64-unknown-linux-musl/
+        const pathDir = path.join(archRoot, 'path');
+        if (fs.existsSync(pathDir)) {
+            const sep = process.platform === 'win32' ? ';' : ':';
+            return { PATH: pathDir + sep + (process.env.PATH || '') };
+        }
+        return {};
+    }
     requiresStdinInput() {
         return false;
     }