@etheaven/codex-mcp-server 1.3.0

package/dist/utils/chunkCache.d.ts

@@ -0,0 +1,22 @@
+import { EditChunk } from './changeModeChunker.js';
+/**
+ * Caches chunks from a changeMode response
+ * @param prompt The original prompt (used for hash generation)
+ * @param chunks The parsed and chunked edits
+ * @returns A short cache key for retrieval
+ */
+export declare function cacheChunks(prompt: string, chunks: EditChunk[]): string;
+/**
+ * Retrieves cached chunks if they exist and haven't expired
+ * @param cacheKey The cache key returned from cacheChunks
+ * @returns The cached chunks or null if expired/not found
+ */
+export declare function getChunks(cacheKey: string): EditChunk[] | null;
+export declare function getCacheStats(): {
+    size: number;
+    ttl: number;
+    maxSize: number;
+    cacheDir: string;
+};
+export declare function clearCache(): void;
+//# sourceMappingURL=chunkCache.d.ts.map

package/dist/utils/chunkCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkCache.d.ts","sourceRoot":"","sources":["../../src/utils/chunkCache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAsBnD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAwBvE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,IAAI,CA0B9D;AA+DD,wBAAgB,aAAa,IAAI;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAeA;AAED,wBAAgB,UAAU,IAAI,IAAI,CAgBjC"}

package/dist/utils/chunkCache.js

@@ -0,0 +1,163 @@
+import { createHash } from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { Logger } from './logger.js';
+const CACHE_DIR = path.join(os.tmpdir(), 'codex-mcp-chunks');
+const CACHE_TTL = 10 * 60 * 1000;
+const MAX_CACHE_FILES = 50;
+function ensureCacheDir() {
+    if (!fs.existsSync(CACHE_DIR)) {
+        fs.mkdirSync(CACHE_DIR, { recursive: true });
+    }
+}
+/**
+ * Caches chunks from a changeMode response
+ * @param prompt The original prompt (used for hash generation)
+ * @param chunks The parsed and chunked edits
+ * @returns A short cache key for retrieval
+ */
+export function cacheChunks(prompt, chunks) {
+    ensureCacheDir();
+    cleanExpiredFiles(); // Cleanup on each write
+    // Generate deterministic cache key from prompt
+    const promptHash = createHash('sha256').update(prompt).digest('hex');
+    const cacheKey = promptHash.slice(0, 8);
+    const filePath = path.join(CACHE_DIR, `${cacheKey}.json`);
+    // Store with metadata
+    const cacheData = {
+        chunks,
+        timestamp: Date.now(),
+        promptHash,
+    };
+    try {
+        fs.writeFileSync(filePath, JSON.stringify(cacheData));
+        Logger.debug(`Cached ${chunks.length} chunks to file: ${cacheKey}.json`);
+    }
+    catch (error) {
+        Logger.error(`Failed to cache chunks: ${error}`);
+    }
+    enforceFileLimits();
+    return cacheKey;
+}
+/**
+ * Retrieves cached chunks if they exist and haven't expired
+ * @param cacheKey The cache key returned from cacheChunks
+ * @returns The cached chunks or null if expired/not found
+ */
+export function getChunks(cacheKey) {
+    const filePath = path.join(CACHE_DIR, `${cacheKey}.json`);
+    try {
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        const fileContent = fs.readFileSync(filePath, 'utf-8');
+        const data = JSON.parse(fileContent);
+        if (Date.now() - data.timestamp > CACHE_TTL) {
+            fs.unlinkSync(filePath);
+            Logger.debug(`Cache expired for ${cacheKey}, deleted file`);
+            return null;
+        }
+        Logger.debug(`Cache hit for ${cacheKey}, returning ${data.chunks.length} chunks`);
+        return data.chunks;
+    }
+    catch (error) {
+        Logger.debug(`Cache read error for ${cacheKey}: ${error}`);
+        try {
+            fs.unlinkSync(filePath); // Clean up bad file
+        }
+        catch { }
+        return null;
+    }
+}
+function cleanExpiredFiles() {
+    try {
+        ensureCacheDir();
+        const files = fs.readdirSync(CACHE_DIR);
+        const now = Date.now();
+        let cleaned = 0;
+        for (const file of files) {
+            if (!file.endsWith('.json'))
+                continue;
+            const filePath = path.join(CACHE_DIR, file);
+            try {
+                const stats = fs.statSync(filePath);
+                if (now - stats.mtimeMs > CACHE_TTL) {
+                    fs.unlinkSync(filePath);
+                    cleaned++;
+                }
+            }
+            catch (error) {
+                // Individual file error - continue with others
+                Logger.debug(`Error checking file ${file}: ${error}`);
+            }
+        }
+        if (cleaned > 0) {
+            Logger.debug(`Cleaned ${cleaned} expired cache files`);
+        }
+    }
+    catch (error) {
+        // Non-critical, just log
+        Logger.debug(`Cache cleanup error: ${error}`);
+    }
+}
+// maximum file count limit (FIFO) --> LRU?
+function enforceFileLimits() {
+    try {
+        const files = fs
+            .readdirSync(CACHE_DIR)
+            .filter(f => f.endsWith('.json'))
+            .map(f => ({
+            name: f,
+            path: path.join(CACHE_DIR, f),
+            mtime: fs.statSync(path.join(CACHE_DIR, f)).mtimeMs,
+        }))
+            .sort((a, b) => a.mtime - b.mtime); // Oldest first
+        // Remove oldest files if over limit
+        if (files.length > MAX_CACHE_FILES) {
+            const toRemove = files.slice(0, files.length - MAX_CACHE_FILES);
+            for (const file of toRemove) {
+                try {
+                    fs.unlinkSync(file.path);
+                }
+                catch { }
+            }
+            Logger.debug(`Removed ${toRemove.length} old cache files to enforce limit`);
+        }
+    }
+    catch (error) {
+        Logger.debug(`Error enforcing file limits: ${error}`);
+    }
+}
+export function getCacheStats() {
+    ensureCacheDir();
+    let size = 0;
+    try {
+        const files = fs.readdirSync(CACHE_DIR);
+        size = files.filter(f => f.endsWith('.json')).length;
+    }
+    catch { }
+    return {
+        size,
+        ttl: CACHE_TTL,
+        maxSize: MAX_CACHE_FILES,
+        cacheDir: CACHE_DIR,
+    };
+}
+export function clearCache() {
+    // !
+    try {
+        ensureCacheDir();
+        const files = fs.readdirSync(CACHE_DIR);
+        for (const file of files) {
+            if (file.endsWith('.json')) {
+                fs.unlinkSync(path.join(CACHE_DIR, file));
+            }
+        }
+        Logger.debug('Cache emptied');
+    }
+    catch (error) {
+        Logger.error(`Failed to empty cache: ${error}`);
+    }
+}
+//# sourceMappingURL=chunkCache.js.map

package/dist/utils/chunkCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkCache.js","sourceRoot":"","sources":["../../src/utils/chunkCache.ts"],"names":[],"mappings":"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"}

package/dist/utils/codexExecutor.d.ts

@@ -0,0 +1,47 @@
+import { RetryOptions } from './commandExecutor.js';
+export declare enum ApprovalPolicy {
+    Never = "never",
+    OnRequest = "on-request",
+    OnFailure = "on-failure",
+    Untrusted = "untrusted"
+}
+export declare enum SandboxMode {
+    ReadOnly = "read-only",
+    WorkspaceWrite = "workspace-write",
+    DangerFullAccess = "danger-full-access"
+}
+export interface CodexExecOptions {
+    readonly model?: string;
+    readonly reasoningEffort?: string;
+    readonly fullAuto?: boolean;
+    readonly approvalPolicy?: ApprovalPolicy;
+    readonly sandboxMode?: SandboxMode;
+    readonly approval?: string;
+    readonly yolo?: boolean;
+    readonly cd?: string;
+    readonly workingDir?: string;
+    readonly timeoutMs?: number;
+    readonly timeout?: number;
+    readonly maxOutputBytes?: number;
+    readonly retry?: RetryOptions;
+    readonly useStdinForLongPrompts?: boolean;
+    readonly image?: string | string[];
+    readonly config?: string | Record<string, any>;
+    readonly profile?: string;
+    readonly useExec?: boolean;
+    readonly search?: boolean;
+    readonly oss?: boolean;
+    readonly enableFeatures?: string[];
+    readonly disableFeatures?: string[];
+}
+/**
+ * Execute Codex CLI with enhanced error handling and memory efficiency
+ */
+export declare function executeCodexCLI(prompt: string, options?: CodexExecOptions, onProgress?: (newOutput: string) => void): Promise<string>;
+/**
+ * High-level executeCodex function with comprehensive options support
+ */
+export declare function executeCodex(prompt: string, options?: CodexExecOptions & {
+    [key: string]: any;
+}, onProgress?: (newOutput: string) => void): Promise<string>;
+//# sourceMappingURL=codexExecutor.d.ts.map

package/dist/utils/codexExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codexExecutor.d.ts","sourceRoot":"","sources":["../../src/utils/codexExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAU5F,oBAAY,cAAc;IACxB,KAAK,UAAU;IACf,SAAS,eAAe;IACxB,SAAS,eAAe;IACxB,SAAS,cAAc;CACxB;AAED,oBAAY,WAAW;IACrB,QAAQ,cAAc;IACtB,cAAc,oBAAoB;IAClC,gBAAgB,uBAAuB;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,gBAAgB,EAC1B,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACvC,OAAO,CAAC,MAAM,CAAC,CAqJjB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,gBAAgB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EACnD,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACvC,OAAO,CAAC,MAAM,CAAC,CA8JjB"}

package/dist/utils/codexExecutor.js

@@ -0,0 +1,296 @@
+import { executeCommandDetailed } from './commandExecutor.js';
+import { Logger } from './logger.js';
+import { CLI } from '../constants.js';
+import { writeFileSync, unlinkSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { randomBytes } from 'crypto';
+import { resolveWorkingDirectory } from './workingDirResolver.js';
+// Type-safe enums
+export var ApprovalPolicy;
+(function (ApprovalPolicy) {
+    ApprovalPolicy["Never"] = "never";
+    ApprovalPolicy["OnRequest"] = "on-request";
+    ApprovalPolicy["OnFailure"] = "on-failure";
+    ApprovalPolicy["Untrusted"] = "untrusted";
+})(ApprovalPolicy || (ApprovalPolicy = {}));
+export var SandboxMode;
+(function (SandboxMode) {
+    SandboxMode["ReadOnly"] = "read-only";
+    SandboxMode["WorkspaceWrite"] = "workspace-write";
+    SandboxMode["DangerFullAccess"] = "danger-full-access";
+})(SandboxMode || (SandboxMode = {}));
+/**
+ * Execute Codex CLI with enhanced error handling and memory efficiency
+ */
+export async function executeCodexCLI(prompt, options, onProgress) {
+    const args = [];
+    // Validate options
+    if (options?.approvalPolicy && options?.yolo) {
+        throw new Error('Cannot use both yolo and approvalPolicy');
+    }
+    if (options?.sandboxMode && options?.yolo) {
+        throw new Error('Cannot use both yolo and sandboxMode');
+    }
+    // Build command arguments
+    if (options?.yolo) {
+        args.push(CLI.FLAGS.YOLO);
+    }
+    else if (options?.fullAuto) {
+        args.push(CLI.FLAGS.FULL_AUTO);
+    }
+    else {
+        if (options?.approvalPolicy) {
+            args.push(CLI.FLAGS.ASK_FOR_APPROVAL, options.approvalPolicy);
+        }
+        // Note: --search requires network access, so if search is enabled and no explicit sandbox mode
+        // is set, we need to ensure network is not blocked
+        if (options?.sandboxMode) {
+            args.push(CLI.FLAGS.SANDBOX_MODE, options.sandboxMode);
+        }
+        else if (options?.search || options?.oss) {
+            // Auto-enable workspace-write for search/oss if no sandbox specified
+            Logger.debug('Search/OSS enabled: auto-setting sandbox to workspace-write for network access');
+            args.push(CLI.FLAGS.SANDBOX_MODE, 'workspace-write');
+        }
+        else if (options?.approvalPolicy) {
+            // Smart default: if approvalPolicy is set but no sandboxMode specified,
+            // auto-enable workspace-write to prevent read-only permission errors
+            Logger.debug('Approval policy set without sandbox mode: auto-setting sandbox to workspace-write');
+            args.push(CLI.FLAGS.SANDBOX_MODE, 'workspace-write');
+        }
+    }
+    if (options?.model) {
+        args.push(CLI.FLAGS.MODEL, options.model);
+    }
+    // Reasoning effort (passed as config override)
+    if (options?.reasoningEffort) {
+        args.push(CLI.FLAGS.CONFIG, `model_reasoning_effort="${options.reasoningEffort}"`);
+        Logger.debug(`Setting reasoning effort: ${options.reasoningEffort}`);
+    }
+    // Resolve working directory using intelligent fallback chain
+    const resolvedWorkingDir = resolveWorkingDirectory({
+        workingDir: options?.cd,
+        prompt: prompt,
+    });
+    if (resolvedWorkingDir) {
+        args.push(CLI.FLAGS.CD, resolvedWorkingDir);
+        Logger.debug(`Resolved working directory: ${resolvedWorkingDir}`);
+    }
+    // OSS (Ollama) mode
+    if (options?.oss) {
+        args.push(CLI.FLAGS.OSS);
+    }
+    // Enable features (including web search)
+    const enableFeatures = [...(options?.enableFeatures || [])];
+    // Add web_search_request feature if search is requested
+    if (options?.search && !enableFeatures.includes('web_search_request')) {
+        enableFeatures.push('web_search_request');
+    }
+    // Add all features to args
+    for (const feature of enableFeatures) {
+        args.push(CLI.FLAGS.ENABLE, feature);
+    }
+    // Disable features
+    if (options?.disableFeatures && Array.isArray(options.disableFeatures)) {
+        for (const feature of options.disableFeatures) {
+            args.push(CLI.FLAGS.DISABLE, feature);
+        }
+    }
+    // Non-interactive run
+    args.push('exec');
+    // Skip git repo check (not all environments are git repos)
+    args.push(CLI.FLAGS.SKIP_GIT_REPO_CHECK);
+    // Add conciseness instruction
+    const concisePrompt = `Please provide a focused, concise response without unnecessary elaboration. ${prompt}`;
+    // Check if prompt is too long for command line (OS dependent, ~100KB is safe)
+    const promptSizeBytes = Buffer.byteLength(concisePrompt, 'utf8');
+    const useStdin = options?.useStdinForLongPrompts !== false && promptSizeBytes > 100 * 1024;
+    let tempFile;
+    try {
+        if (useStdin) {
+            // Write prompt to temp file and pass via stdin redirect
+            tempFile = join(tmpdir(), `codex-prompt-${randomBytes(8).toString('hex')}.txt`);
+            writeFileSync(tempFile, concisePrompt, 'utf8');
+            args.push(`< ${tempFile}`);
+            Logger.debug(`Using temp file for large prompt (${promptSizeBytes} bytes)`);
+        }
+        else {
+            args.push(concisePrompt);
+        }
+        // Use detailed execution for better error handling
+        const result = await executeCommandDetailed(CLI.COMMANDS.CODEX, args, {
+            onProgress,
+            timeoutMs: options?.timeoutMs,
+            maxOutputBytes: options?.maxOutputBytes,
+            retry: options?.retry,
+        });
+        if (!result.ok) {
+            // Try to salvage partial output if available
+            if (result.partialStdout && result.partialStdout.length > 1000) {
+                Logger.warn('Command failed but partial output available, attempting to use it');
+                return result.partialStdout;
+            }
+            const errorMessage = result.stderr || 'Unknown error';
+            throw new Error(result.timedOut
+                ? `Codex CLI timed out after ${options?.timeoutMs || 600000}ms`
+                : `Codex CLI failed with exit code ${result.code}: ${errorMessage}`);
+        }
+        return result.stdout;
+    }
+    catch (error) {
+        Logger.error('Codex CLI execution failed:', error);
+        throw error;
+    }
+    finally {
+        // Clean up temp file
+        if (tempFile) {
+            try {
+                unlinkSync(tempFile);
+            }
+            catch (e) {
+                Logger.debug('Failed to delete temp file:', e);
+            }
+        }
+    }
+}
+/**
+ * High-level executeCodex function with comprehensive options support
+ */
+export async function executeCodex(prompt, options, onProgress) {
+    const args = [];
+    // Model selection
+    if (options?.model) {
+        args.push(CLI.FLAGS.MODEL, options.model);
+    }
+    // Reasoning effort (passed as config override to Codex CLI)
+    if (options?.reasoningEffort) {
+        args.push(CLI.FLAGS.CONFIG, `model_reasoning_effort="${options.reasoningEffort}"`);
+        Logger.debug(`Setting reasoning effort: ${options.reasoningEffort}`);
+    }
+    // Safety controls
+    if (options?.yolo) {
+        args.push(CLI.FLAGS.YOLO);
+    }
+    else if (options?.fullAuto) {
+        args.push(CLI.FLAGS.FULL_AUTO);
+    }
+    else {
+        // Approval policy
+        if (options?.approval || options?.approvalPolicy) {
+            const approvalValue = options.approval || options.approvalPolicy;
+            if (approvalValue) {
+                args.push(CLI.FLAGS.ASK_FOR_APPROVAL, approvalValue);
+            }
+        }
+        // Sandbox mode
+        if (options?.sandboxMode) {
+            args.push(CLI.FLAGS.SANDBOX_MODE, options.sandboxMode);
+        }
+        else if (options?.search || options?.oss) {
+            // Auto-enable workspace-write for search/oss if no sandbox specified
+            Logger.debug('Search/OSS enabled: auto-setting sandbox to workspace-write for network access');
+            args.push(CLI.FLAGS.SANDBOX_MODE, 'workspace-write');
+        }
+        else if (options?.approval || options?.approvalPolicy) {
+            // Smart default: if approval is set but no sandboxMode specified,
+            // auto-enable workspace-write to prevent read-only permission errors
+            Logger.debug('Approval set without sandbox mode: auto-setting sandbox to workspace-write');
+            args.push(CLI.FLAGS.SANDBOX_MODE, 'workspace-write');
+        }
+    }
+    // Resolve working directory using intelligent fallback chain
+    const resolvedWorkingDir = resolveWorkingDirectory({
+        workingDir: options?.workingDir || options?.cd,
+        prompt: prompt,
+    });
+    if (resolvedWorkingDir) {
+        args.push(CLI.FLAGS.WORKING_DIR, resolvedWorkingDir);
+        Logger.debug(`Resolved working directory for executeCodex: ${resolvedWorkingDir}`);
+    }
+    // Configuration
+    if (options?.config) {
+        if (typeof options.config === 'string') {
+            args.push(CLI.FLAGS.CONFIG, options.config);
+        }
+        else {
+            // Convert object to key=value pairs
+            const configStr = Object.entries(options.config)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(',');
+            args.push(CLI.FLAGS.CONFIG, configStr);
+        }
+    }
+    // Profile
+    if (options?.profile) {
+        args.push(CLI.FLAGS.PROFILE, options.profile);
+    }
+    // Images
+    if (options?.image) {
+        const images = Array.isArray(options.image) ? options.image : [options.image];
+        for (const img of images) {
+            args.push(CLI.FLAGS.IMAGE, img);
+        }
+    }
+    // OSS (Ollama) mode
+    if (options?.oss) {
+        args.push(CLI.FLAGS.OSS);
+    }
+    // Enable features (including web search)
+    const enableFeatures = [...(options?.enableFeatures || [])];
+    // Add web_search_request feature if search is requested
+    if (options?.search && !enableFeatures.includes('web_search_request')) {
+        enableFeatures.push('web_search_request');
+    }
+    // Add all features to args
+    for (const feature of enableFeatures) {
+        args.push(CLI.FLAGS.ENABLE, feature);
+    }
+    // Disable features
+    if (options?.disableFeatures && Array.isArray(options.disableFeatures)) {
+        for (const feature of options.disableFeatures) {
+            args.push(CLI.FLAGS.DISABLE, feature);
+        }
+    }
+    // Use exec mode for non-interactive execution
+    if (options?.useExec !== false) {
+        // Default to true for non-interactive execution
+        args.push('exec');
+    }
+    // Skip git repo check (not all environments are git repos)
+    args.push(CLI.FLAGS.SKIP_GIT_REPO_CHECK);
+    // Add the prompt
+    args.push(prompt);
+    try {
+        const timeoutMs = options?.timeout || options?.timeoutMs || 600000; // 10 minutes default
+        const result = await executeCommandDetailed(CLI.COMMANDS.CODEX, args, {
+            onProgress,
+            timeoutMs,
+            maxOutputBytes: options?.maxOutputBytes,
+            retry: options?.retry,
+        });
+        if (!result.ok) {
+            // Enhanced error handling with specific messages
+            const errorMessage = result.stderr || 'Unknown error';
+            if (errorMessage.includes('command not found') || errorMessage.includes('not found')) {
+                throw new Error('Codex CLI not found. Install with: npm install -g @openai/codex');
+            }
+            if (errorMessage.includes('authentication') || errorMessage.includes('unauthorized')) {
+                throw new Error('Authentication failed. Run "codex login" or set OPENAI_API_KEY');
+            }
+            if (errorMessage.includes('quota') || errorMessage.includes('rate limit')) {
+                throw new Error('Rate limit exceeded. Please wait and try again');
+            }
+            if (errorMessage.includes('permission') || errorMessage.includes('sandbox')) {
+                throw new Error(`Permission denied. Try adjusting sandbox mode or approval policy: ${errorMessage}`);
+            }
+            throw new Error(`Codex CLI failed: ${errorMessage}`);
+        }
+        return result.stdout;
+    }
+    catch (error) {
+        Logger.error('Codex execution failed:', error);
+        throw error;
+    }
+}
+//# sourceMappingURL=codexExecutor.js.map

package/dist/utils/codexExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codexExecutor.js","sourceRoot":"","sources":["../../src/utils/codexExecutor.ts"],"names":[],"mappings":"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"}

package/dist/utils/commandExecutor.d.ts

@@ -0,0 +1,29 @@
+export interface CommandResult {
+    ok: boolean;
+    code: number | null;
+    signal?: NodeJS.Signals;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    partialStdout?: string;
+}
+export interface RetryOptions {
+    attempts: number;
+    backoffMs: number;
+    retryOn: ('timeout' | 'exit_nonzero' | 'spawn_error')[];
+}
+export interface ExecuteOptions {
+    onProgress?: (newOutput: string) => void;
+    timeoutMs?: number;
+    maxOutputBytes?: number;
+    retry?: RetryOptions;
+}
+/**
+ * Execute a command with streaming output and structured error handling
+ */
+export declare function executeCommandDetailed(command: string, args: string[], options?: ExecuteOptions): Promise<CommandResult>;
+/**
+ * Backward compatible wrapper that returns stdout string
+ */
+export declare function executeCommand(command: string, args: string[], onProgress?: (newOutput: string) => void, timeoutMs?: number): Promise<string>;
+//# sourceMappingURL=commandExecutor.d.ts.map

package/dist/utils/commandExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandExecutor.d.ts","sourceRoot":"","sources":["../../src/utils/commandExecutor.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,SAAS,GAAG,cAAc,GAAG,aAAa,CAAC,EAAE,CAAC;CACzD;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAyCxB;AA6HD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,EACxC,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC,MAAM,CAAC,CAgBjB"}