@etheaven/codex-mcp-server 1.3.0

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,UAAU,gBAAgB,CAAC;AAGxC,eAAO,MAAM,cAAc;;;;;;;;CASjB,CAAC;AAGX,eAAO,MAAM,eAAe;;;;;;;CAQlB,CAAC;AAIX,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;CA4BT,CAAC;AAGX,eAAO,MAAM,qBAAqB;;;;;;;;CAQxB,CAAC;AAGX,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAGzF,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAGX,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAGX,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAuBX,CAAC;AAGX,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCN,CAAC;AAGX,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAE3B,cAAc,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAG3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;CACvF"}

package/dist/constants.js

@@ -0,0 +1,154 @@
+// Logging
+export const LOG_PREFIX = '[CODEX-MCP]';
+// Error messages
+export const ERROR_MESSAGES = {
+    TOOL_NOT_FOUND: 'not found in registry',
+    NO_PROMPT_PROVIDED: "Please provide a prompt for analysis. Use @ syntax to include files (e.g., '@largefile.js explain what this does') or ask general questions",
+    QUOTA_EXCEEDED: 'Rate limit exceeded',
+    AUTHENTICATION_FAILED: 'Authentication failed - please check your OpenAI API key or login status',
+    CODEX_NOT_FOUND: "Codex CLI not found - please install with 'npm install -g @openai/codex'",
+    SANDBOX_VIOLATION: 'Operation blocked by sandbox policy',
+    UNSAFE_COMMAND: 'Command requires approval or elevated permissions',
+};
+// Status messages
+export const STATUS_MESSAGES = {
+    SANDBOX_EXECUTING: '🔒 Executing CLI command in sandbox/auto mode...',
+    CODEX_RESPONSE: 'Codex response:',
+    AUTHENTICATION_SUCCESS: '✅ Authentication successful',
+    // Timeout prevention messages
+    PROCESSING_START: '🔍 Starting analysis (may take 5-15 minutes for large codebases)',
+    PROCESSING_CONTINUE: '⏳ Still processing...',
+    PROCESSING_COMPLETE: '✅ Analysis completed successfully',
+};
+// Models — kept in sync with https://developers.openai.com/codex/models/
+// and https://developers.openai.com/api/docs/models  (March 2026)
+export const MODELS = {
+    // GPT-5.x flagship / reasoning
+    GPT_5_4: 'gpt-5.4',
+    GPT_5_4_PRO: 'gpt-5.4-pro',
+    GPT_5_3_CODEX: 'gpt-5.3-codex',
+    GPT_5_3_CODEX_SPARK: 'gpt-5.3-codex-spark',
+    GPT_5_2_CODEX: 'gpt-5.2-codex',
+    GPT_5_2: 'gpt-5.2',
+    GPT_5_1_CODEX_MAX: 'gpt-5.1-codex-max',
+    GPT_5_1_CODEX: 'gpt-5.1-codex',
+    GPT_5_1: 'gpt-5.1',
+    GPT_5: 'gpt-5',
+    GPT_5_PRO: 'gpt-5-pro',
+    GPT_5_CODEX: 'gpt-5-codex',
+    GPT_5_CODEX_MINI: 'gpt-5-codex-mini',
+    GPT_5_MINI: 'gpt-5-mini',
+    GPT_5_NANO: 'gpt-5-nano',
+    // O-series reasoning
+    O3: 'o3',
+    O3_PRO: 'o3-pro',
+    O4_MINI: 'o4-mini',
+    // GPT-4.1 (non-reasoning, 1M context)
+    GPT_4_1: 'gpt-4.1',
+    GPT_4_1_MINI: 'gpt-4.1-mini',
+    GPT_4_1_NANO: 'gpt-4.1-nano',
+    // GPT-4o (legacy multimodal)
+    GPT_4O: 'gpt-4o',
+    GPT_4O_MINI: 'gpt-4o-mini',
+};
+// Recommended models for different use cases (used in tool descriptions)
+export const MODEL_RECOMMENDATIONS = {
+    DEFAULT: 'gpt-5.4',
+    CODING: 'gpt-5.3-codex',
+    FAST_CODING: 'gpt-5.3-codex-spark',
+    DEEP_REASONING: 'o3',
+    FAST_REASONING: 'o4-mini',
+    COST_EFFECTIVE: 'gpt-5-mini',
+    LARGE_CONTEXT: 'gpt-4.1',
+};
+// Reasoning effort levels — per-model support varies
+export const REASONING_EFFORTS = {
+    NONE: 'none',
+    MINIMAL: 'minimal',
+    LOW: 'low',
+    MEDIUM: 'medium',
+    HIGH: 'high',
+    XHIGH: 'xhigh',
+};
+// Sandbox modes
+export const SANDBOX_MODES = {
+    READ_ONLY: 'read-only',
+    WORKSPACE_WRITE: 'workspace-write',
+    DANGER_FULL_ACCESS: 'danger-full-access',
+};
+// Approval policies
+export const APPROVAL_POLICIES = {
+    UNTRUSTED: 'untrusted',
+    ON_FAILURE: 'on-failure',
+    ON_REQUEST: 'on-request',
+    NEVER: 'never',
+};
+// MCP Protocol Constants
+export const PROTOCOL = {
+    // Message roles
+    ROLES: {
+        USER: 'user',
+        ASSISTANT: 'assistant',
+    },
+    // Content types
+    CONTENT_TYPES: {
+        TEXT: 'text',
+    },
+    // Status codes
+    STATUS: {
+        SUCCESS: 'success',
+        ERROR: 'error',
+        FAILED: 'failed',
+        REPORT: 'report',
+    },
+    // Notification methods
+    NOTIFICATIONS: {
+        PROGRESS: 'notifications/progress',
+    },
+    // Timeout prevention
+    KEEPALIVE_INTERVAL: 25000, // 25 seconds
+};
+// CLI Constants
+export const CLI = {
+    // Command names
+    COMMANDS: {
+        CODEX: 'codex',
+        CODEX_EXEC: 'codex exec',
+        ECHO: 'echo',
+    },
+    // Command flags
+    FLAGS: {
+        MODEL: '-m',
+        SANDBOX: '-s', // legacy flag. For Codex prefer FULL_AUTO or SANDBOX/APPROVAL flags.
+        FULL_AUTO: '--full-auto',
+        ASK_FOR_APPROVAL: '--ask-for-approval',
+        SANDBOX_MODE: '--sandbox',
+        APPROVAL: '-a',
+        YOLO: '--dangerously-bypass-approvals-and-sandbox',
+        SKIP_GIT_REPO_CHECK: '--skip-git-repo-check',
+        CD: '--cd',
+        PROMPT: '-p',
+        HELP: '-help',
+        IMAGE: '-i',
+        PROFILE: '--profile',
+        CONFIG: '-c',
+        VERSION: '--version',
+        WORKING_DIR: '-C',
+        OSS: '--oss',
+        ENABLE: '--enable',
+        DISABLE: '--disable',
+    },
+    // Default values
+    DEFAULTS: {
+        MODEL: 'default', // Fallback model used when no specific model is provided
+        BOOLEAN_TRUE: 'true',
+        BOOLEAN_FALSE: 'false',
+    },
+    // Environment variables for working directory resolution
+    ENV_VARS: {
+        CODEX_MCP_CWD: 'CODEX_MCP_CWD', // Primary: Set in MCP client configuration
+        PWD: 'PWD', // Secondary: Standard Unix variable
+        INIT_CWD: 'INIT_CWD', // Tertiary: Node.js initial directory
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, SetLevelRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { Logger } from './utils/logger.js';
+import { PROTOCOL } from './constants.js';
+import { getToolDefinitions, getPromptDefinitions, executeTool, toolExists, getPromptMessage, } from './tools/index.js';
+const server = new Server({
+    name: 'codex-cli-mcp',
+    version: '1.3.0',
+}, {
+    capabilities: {
+        tools: {},
+        prompts: {},
+        notifications: {},
+        logging: {},
+    },
+});
+// Removed global state - using per-request state instead
+/**
+ * @param progressToken The progress token provided by the client
+ * @param progress The current progress value
+ * @param total Optional total value
+ * @param message Optional status message
+ */
+async function sendProgressNotification(progressToken, progress, total, message) {
+    if (!progressToken)
+        return; // Only send if client requested progress
+    try {
+        const params = {
+            progressToken,
+            progress,
+        };
+        if (total !== undefined)
+            params.total = total; // future cache progress
+        if (message)
+            params.message = message;
+        await server.notification({
+            method: PROTOCOL.NOTIFICATIONS.PROGRESS,
+            params,
+        });
+    }
+    catch (error) {
+        Logger.error('Failed to send progress notification:', error);
+    }
+}
+function startProgressUpdates(operationName, progressToken) {
+    // Per-request state
+    const state = {
+        isProcessing: true,
+        currentOperationName: operationName,
+        latestOutput: '',
+    };
+    const progressMessages = [
+        `🧠 ${operationName} - Codex is analyzing your request...`,
+        `📊 ${operationName} - Processing files and generating insights...`,
+        `✨ ${operationName} - Creating structured response for your review...`,
+        `⏱️ ${operationName} - Large analysis in progress (this is normal for big requests)...`,
+        `🔍 ${operationName} - Still working... hang tight for quality results...`,
+    ];
+    let messageIndex = 0;
+    let progress = 0;
+    // Send immediate acknowledgment if progress requested
+    if (progressToken) {
+        sendProgressNotification(progressToken, 0, undefined, // No total - indeterminate progress
+        `🔍 Starting ${operationName}`);
+    }
+    // Keep client alive with periodic updates
+    const progressInterval = setInterval(async () => {
+        if (state.isProcessing && progressToken) {
+            // Simply increment progress value
+            progress += 1;
+            // Include latest output if available
+            const baseMessage = progressMessages[messageIndex % progressMessages.length];
+            const outputPreview = state.latestOutput.slice(-150).trim(); // Last 150 chars
+            const message = outputPreview
+                ? `${baseMessage}\n📝 Output: ...${outputPreview}`
+                : baseMessage;
+            await sendProgressNotification(progressToken, progress, undefined, // No total - indeterminate progress
+            message);
+            messageIndex++;
+        }
+        else if (!state.isProcessing) {
+            clearInterval(progressInterval);
+        }
+    }, PROTOCOL.KEEPALIVE_INTERVAL); // Every 25 seconds
+    return { interval: progressInterval, progressToken, state };
+}
+function stopProgressUpdates(progressData, success = true) {
+    const operationName = progressData.state?.currentOperationName || ''; // Get from state
+    if (progressData.state) {
+        progressData.state.isProcessing = false;
+    }
+    clearInterval(progressData.interval);
+    // Send final progress notification if client requested progress
+    if (progressData.progressToken) {
+        sendProgressNotification(progressData.progressToken, 100, 100, success ? `✅ ${operationName} completed successfully` : `❌ ${operationName} failed`);
+    }
+}
+// logging/setLevel
+server.setRequestHandler(SetLevelRequestSchema, async (request) => {
+    Logger.setLevel(request.params.level);
+    Logger.debug(`Log level updated to '${request.params.level}' via client request.`);
+    return {};
+});
+// tools/list
+server.setRequestHandler(ListToolsRequestSchema, async (request) => {
+    return { tools: getToolDefinitions() };
+});
+// tools/get
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const toolName = request.params.name;
+    if (toolExists(toolName)) {
+        // Check if client requested progress updates
+        const progressToken = request.params._meta?.progressToken;
+        // Start progress updates if client requested them
+        const progressData = startProgressUpdates(toolName, progressToken);
+        try {
+            // Get prompt and other parameters from arguments with proper typing
+            const args = request.params.arguments || {};
+            Logger.toolInvocation(toolName, request.params.arguments);
+            // Execute the tool using the unified registry with progress callback
+            const result = await executeTool(toolName, args, newOutput => {
+                if (progressData.state) {
+                    progressData.state.latestOutput = newOutput;
+                }
+            });
+            // Stop progress updates
+            stopProgressUpdates(progressData, true);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: result,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        catch (error) {
+            // Stop progress updates on error
+            stopProgressUpdates(progressData, false);
+            Logger.error(`Error in tool '${toolName}':`, error);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error executing ${toolName}: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    else {
+        throw new Error(`Unknown tool: ${request.params.name}`);
+    }
+});
+// prompts/list
+server.setRequestHandler(ListPromptsRequestSchema, async (request) => {
+    return { prompts: getPromptDefinitions() };
+});
+// prompts/get
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const promptName = request.params.name;
+    const args = request.params.arguments || {};
+    const promptMessage = getPromptMessage(promptName, args);
+    if (!promptMessage) {
+        throw new Error(`Unknown prompt: ${promptName}`);
+    }
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: promptMessage,
+                },
+            },
+        ],
+    };
+});
+// Start the server
+async function main() {
+    Logger.debug('init codex-mcp-server');
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    Logger.debug('codex-mcp-server listening on stdio');
+}
+main().catch(error => {
+    Logger.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/ask-codex.tool.d.ts

@@ -0,0 +1,3 @@
+import { UnifiedTool } from './registry.js';
+export declare const askCodexTool: UnifiedTool;
+//# sourceMappingURL=ask-codex.tool.d.ts.map

package/dist/tools/ask-codex.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-codex.tool.d.ts","sourceRoot":"","sources":["../../src/tools/ask-codex.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAgH5C,eAAO,MAAM,YAAY,EAAE,WA2M1B,CAAC"}

package/dist/tools/ask-codex.tool.js

@@ -0,0 +1,263 @@
+import { z } from 'zod';
+import { executeCodex } from '../utils/codexExecutor.js';
+import { processChangeModeOutput } from '../utils/changeModeRunner.js';
+import { formatCodexResponseForMCP } from '../utils/outputParser.js';
+import { APPROVAL_POLICIES, ERROR_MESSAGES } from '../constants.js';
+// Model description for AI clients — MUST list exact valid model IDs
+const MODEL_DESCRIPTION = [
+    'Model ID to use. IMPORTANT: Use exact IDs listed below, do NOT invent or modify model names.',
+    'Flagship: gpt-5.4 (recommended default), gpt-5.4-pro (high reasoning only).',
+    'Codex (coding): gpt-5.3-codex (best coding), gpt-5.3-codex-spark (instant, Pro only),',
+    '  gpt-5.2-codex, gpt-5.1-codex-max, gpt-5.1-codex, gpt-5-codex, gpt-5-codex-mini.',
+    'General: gpt-5.2, gpt-5.1, gpt-5, gpt-5-pro, gpt-5-mini, gpt-5-nano.',
+    'Reasoning: o3, o3-pro, o4-mini.',
+    'Non-reasoning (1M ctx): gpt-4.1, gpt-4.1-mini, gpt-4.1-nano.',
+    'Legacy: gpt-4o, gpt-4o-mini.',
+].join(' ');
+const REASONING_DESCRIPTION = [
+    'Reasoning effort level. Controls depth of internal reasoning.',
+    'Values: none, minimal, low, medium (default), high, xhigh.',
+    'Higher = deeper analysis but slower and more expensive.',
+    'Not all models support all levels.',
+    'gpt-5.4 supports: none/low/medium/high/xhigh.',
+    'gpt-5.3-codex supports: low/medium/high/xhigh.',
+    'o3/o4-mini support: low/medium/high.',
+].join(' ');
+const askCodexArgsSchema = z.object({
+    prompt: z
+        .string()
+        .min(1)
+        .describe("Task or question. Use @ to include files (e.g., '@largefile.ts explain')."),
+    model: z.string().optional().describe(MODEL_DESCRIPTION),
+    reasoningEffort: z
+        .enum(['none', 'minimal', 'low', 'medium', 'high', 'xhigh'])
+        .optional()
+        .describe(REASONING_DESCRIPTION),
+    sandbox: z
+        .boolean()
+        .default(false)
+        .describe('Quick automation mode: enables workspace-write + on-failure approval. Alias for fullAuto.'),
+    fullAuto: z.boolean().optional().describe('Full automation mode'),
+    approvalPolicy: z
+        .enum(['never', 'on-request', 'on-failure', 'untrusted'])
+        .optional()
+        .describe('Approval: never, on-request, on-failure, untrusted'),
+    approval: z
+        .string()
+        .optional()
+        .describe(`Approval policy: ${Object.values(APPROVAL_POLICIES).join(', ')}`),
+    sandboxMode: z
+        .enum(['read-only', 'workspace-write', 'danger-full-access'])
+        .optional()
+        .describe('Access: read-only, workspace-write, danger-full-access'),
+    yolo: z.boolean().optional().describe('⚠️ Bypass all safety (dangerous)'),
+    cd: z.string().optional().describe('Working directory'),
+    workingDir: z.string().optional().describe('Working directory for execution'),
+    changeMode: z
+        .boolean()
+        .default(false)
+        .describe('Return structured OLD/NEW edits for refactoring'),
+    chunkIndex: z
+        .preprocess(val => {
+        if (typeof val === 'number')
+            return val;
+        if (typeof val === 'string') {
+            const parsed = parseInt(val, 10);
+            return isNaN(parsed) ? undefined : parsed;
+        }
+        return undefined;
+    }, z.number().min(1).optional())
+        .describe('Chunk index (1-based)'),
+    chunkCacheKey: z.string().optional().describe('Cache key for continuation'),
+    image: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe('Optional image file path(s) to include with the prompt'),
+    config: z
+        .union([z.string(), z.record(z.any())])
+        .optional()
+        .describe("Configuration overrides as 'key=value' string or object"),
+    profile: z.string().optional().describe('Configuration profile to use from ~/.codex/config.toml'),
+    timeout: z.number().optional().describe('Maximum execution time in milliseconds (optional)'),
+    includeThinking: z
+        .boolean()
+        .default(true)
+        .describe('Include reasoning/thinking section in response'),
+    includeMetadata: z.boolean().default(true).describe('Include configuration metadata in response'),
+    search: z
+        .boolean()
+        .optional()
+        .describe('Enable web search by activating web_search_request feature flag. Requires network access - automatically sets sandbox to workspace-write if not specified.'),
+    oss: z
+        .boolean()
+        .optional()
+        .describe('Use local Ollama server (convenience for -c model_provider=oss). Requires Ollama running locally. Automatically sets sandbox to workspace-write if not specified.'),
+    enableFeatures: z
+        .array(z.string())
+        .optional()
+        .describe('Enable feature flags (repeatable). Equivalent to -c features.<name>=true'),
+    disableFeatures: z
+        .array(z.string())
+        .optional()
+        .describe('Disable feature flags (repeatable). Equivalent to -c features.<name>=false'),
+});
+export const askCodexTool = {
+    name: 'ask-codex',
+    description: 'Execute Codex CLI with file analysis (@syntax), model selection, and safety controls. Supports changeMode.',
+    zodSchema: askCodexArgsSchema,
+    prompt: {
+        description: 'Execute Codex CLI with optional changeMode',
+    },
+    category: 'utility',
+    execute: async (args, onProgress) => {
+        const { prompt, model, reasoningEffort, sandbox, fullAuto, approvalPolicy, approval, sandboxMode, yolo, cd, workingDir, changeMode, chunkIndex, chunkCacheKey, image, config, profile, timeout, includeThinking, includeMetadata, search, oss, enableFeatures, disableFeatures, } = args;
+        if (!prompt?.trim()) {
+            throw new Error(ERROR_MESSAGES.NO_PROMPT_PROVIDED);
+        }
+        if (changeMode && chunkIndex && chunkCacheKey) {
+            return processChangeModeOutput('', {
+                chunkIndex: chunkIndex,
+                cacheKey: chunkCacheKey,
+                prompt: prompt,
+            });
+        }
+        try {
+            // Use enhanced executeCodex for better feature support
+            const result = await executeCodex(prompt, {
+                model: model,
+                reasoningEffort: reasoningEffort,
+                fullAuto: Boolean(fullAuto ?? sandbox),
+                approvalPolicy: approvalPolicy,
+                approval: approval,
+                sandboxMode: sandboxMode,
+                yolo: Boolean(yolo),
+                cd: cd,
+                workingDir: workingDir,
+                image,
+                config,
+                profile: profile,
+                timeout: timeout,
+                search: search,
+                oss: oss,
+                enableFeatures: enableFeatures,
+                disableFeatures: disableFeatures,
+            }, onProgress);
+            if (changeMode) {
+                return processChangeModeOutput(result, {
+                    chunkIndex: args.chunkIndex,
+                    prompt: prompt,
+                });
+            }
+            // Format response with enhanced output parsing
+            return formatCodexResponseForMCP(result, includeThinking, includeMetadata);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Enhanced error handling with helpful context
+            if (errorMessage.includes('not found') || errorMessage.includes('command not found')) {
+                return `❌ **Codex CLI Not Found**: ${ERROR_MESSAGES.CODEX_NOT_FOUND}
+
+**Quick Fix:**
+\`\`\`bash
+npm install -g @openai/codex
+\`\`\`
+
+**Verification:** Run \`codex --version\` to confirm installation.`;
+            }
+            if (errorMessage.includes('authentication') || errorMessage.includes('unauthorized')) {
+                return `❌ **Authentication Failed**: ${ERROR_MESSAGES.AUTHENTICATION_FAILED}
+
+**Setup Options:**
+1. **API Key:** \`export OPENAI_API_KEY=your-key\`
+2. **Login:** \`codex login\` (requires ChatGPT subscription)
+
+**Troubleshooting:** Verify key has Codex access in OpenAI dashboard.`;
+            }
+            if (errorMessage.includes('quota') || errorMessage.includes('rate limit')) {
+                return `❌ **Usage Limit Reached**: ${ERROR_MESSAGES.QUOTA_EXCEEDED}
+
+**Solutions:**
+1. Wait and retry - rate limits reset periodically
+2. Check quota in OpenAI dashboard`;
+            }
+            if (errorMessage.includes('timeout')) {
+                return `❌ **Request Timeout**: Operation took longer than expected
+
+**Solutions:**
+1. Increase timeout: Add \`timeout: 300000\` (5 minutes)
+2. Simplify request: Break complex queries into smaller parts`;
+            }
+            if (errorMessage.includes('sandbox') || errorMessage.includes('permission')) {
+                // Enhanced debugging information
+                const debugInfo = [
+                    `**Current Configuration:**`,
+                    `- yolo: ${yolo}`,
+                    `- fullAuto: ${fullAuto}`,
+                    `- sandbox: ${sandbox}`,
+                    `- sandboxMode: ${sandboxMode}`,
+                    `- approvalPolicy: ${approvalPolicy}`,
+                    `- search: ${search}`,
+                    `- oss: ${oss}`,
+                ].join('\n');
+                return `❌ **Permission Error**: ${ERROR_MESSAGES.SANDBOX_VIOLATION}
+
+${debugInfo}
+
+**Root Cause:**
+This error typically occurs when:
+1. \`approvalPolicy\` is set without \`sandboxMode\` (now auto-fixed in v1.2+)
+2. Explicit \`sandboxMode: "read-only"\` blocks file modifications
+3. Codex CLI defaults to restrictive permissions
+4. **YOLO mode not working**: If yolo is true but still blocked, there may be a configuration conflict
+
+**Solutions:**
+
+**Option A - Explicit Control (Recommended):**
+\`\`\`json
+{
+  "approvalPolicy": "on-failure",
+  "sandboxMode": "workspace-write",
+  "model": "gpt-5.4",
+  "prompt": "your task..."
+}
+\`\`\`
+
+**Option B - Automated Mode:**
+\`\`\`json
+{
+  "sandbox": true,  // Enables fullAuto (workspace-write + on-failure)
+  "model": "gpt-5.4",
+  "prompt": "your task..."
+}
+\`\`\`
+
+**Option C - Full Bypass (⚠️ Use with caution):**
+\`\`\`json
+{
+  "yolo": true,
+  "model": "gpt-5.4",
+  "prompt": "your task..."
+}
+\`\`\`
+
+**Debug Steps:**
+1. Check if yolo mode is being overridden by other settings
+2. Verify Codex CLI version supports yolo flag
+3. Try using only yolo without other conflicting parameters
+
+**Sandbox Modes:**
+- \`read-only\`: Analysis only, no modifications
+- \`workspace-write\`: Can edit files in workspace (safe for most tasks)
+- \`danger-full-access\`: Full system access (use with caution)`;
+            }
+            // Generic error with context
+            return `❌ **Codex Execution Error**: ${errorMessage}
+
+**Debug Steps:**
+1. Verify Codex CLI: \`codex --version\`
+2. Check authentication: \`codex login\`
+3. Try simpler query first`;
+        }
+    },
+};
+//# sourceMappingURL=ask-codex.tool.js.map

package/dist/tools/ask-codex.tool.js.map

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