@etheaven/codex-mcp-server 1.3.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,26 @@
+{
+  "name": "codex-mcp-server",
+  "owner": {
+    "name": "Taras Trishchuk"
+  },
+  "metadata": {
+    "description": "Codex CLI MCP server for Claude Code"
+  },
+  "plugins": [
+    {
+      "name": "codex-mcp-server",
+      "source": {
+        "source": "github",
+        "repo": "etheaven/codex-mcp-server"
+      },
+      "description": "MCP server for Codex CLI — use OpenAI Codex (gpt-5.4, gpt-5.3-codex, o3, etc.) directly from Claude Code with model selection, reasoning effort control, and file analysis",
+      "version": "1.3.0",
+      "author": {
+        "name": "Taras Trishchuk"
+      },
+      "homepage": "https://github.com/etheaven/codex-mcp-server",
+      "license": "MIT",
+      "keywords": ["mcp", "codex", "openai", "cli", "gpt-5"]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "codex-mcp-server",
+  "version": "1.3.0",
+  "description": "MCP server for Codex CLI — use OpenAI Codex (gpt-5.4, gpt-5.3-codex, o3, etc.) directly from Claude Code with model selection, reasoning effort control, and file analysis",
+  "author": {
+    "name": "Taras Trishchuk"
+  },
+  "homepage": "https://github.com/etheaven/codex-mcp-server",
+  "repository": "https://github.com/etheaven/codex-mcp-server",
+  "license": "MIT",
+  "keywords": ["mcp", "codex", "openai", "cli", "code-generation", "ai", "gpt-5"],
+  "mcpServers": "../.mcp.json"
+}

package/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "codex": {
+      "command": "npx",
+      "args": ["-y", "@etheaven/codex-mcp-server"]
+    }
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Taras Trishchuk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,450 @@
+# Codex MCP Tool
+
+<div align="center">
+
+[![GitHub Release](https://img.shields.io/github/v/release/etheaven/codex-mcp-server?logo=github&label=GitHub)](https://github.com/etheaven/codex-mcp-server/releases)
+[![npm version](https://img.shields.io/npm/v/@etheaven/codex-mcp-server)](https://www.npmjs.com/package/@etheaven/codex-mcp-server)
+[![npm downloads](https://img.shields.io/npm/dt/@etheaven/codex-mcp-server)](https://www.npmjs.com/package/@etheaven/codex-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Open Source](https://img.shields.io/badge/Open%20Source-❤️-red.svg)](https://github.com/etheaven/codex-mcp-server)
+
+</div>
+
+Codex MCP Tool is an open‑source Model Context Protocol (MCP) server that connects your IDE or AI assistant (Claude, Cursor, etc.) to the Codex CLI. It enables non‑interactive automation with `codex exec`, safe sandboxed edits with approvals, and large‑scale code analysis via `@` file references. Built for reliability and speed, it streams progress updates, supports structured change mode (OLD/NEW patch output), and integrates cleanly with standard MCP clients for code review, refactoring, documentation, and CI automation.
+
+> **Latest Release (v1.3.0)**: Updated model support — all GPT-5.x series (gpt-5.4, gpt-5.3-codex, etc.), reasoning effort control, and accurate model descriptions for AI clients. [See changelog](#recent-updates)
+
+- Ask Codex questions from your MCP client, or brainstorm ideas programmatically.
+
+<a href="https://glama.ai/mcp/servers/@etheaven/codex-mcp-server">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@etheaven/codex-mcp-server/badge" alt="Codex Tool MCP server" />
+</a>
+
+## TLDR: [![Claude](https://img.shields.io/badge/Claude-D97757?logo=claude&logoColor=fff)](#) + Codex CLI
+
+Goal: Use Codex directly from your MCP-enabled editor to analyze and edit code efficiently.
+
+## Prerequisites
+
+Before using this tool, ensure you have:
+
+1. **[Node.js](https://nodejs.org/)** (v18.0.0 or higher)
+2. **[Codex CLI](https://github.com/openai/codex)** installed and authenticated
+
+> **✅ Cross-Platform Support**: Fully tested and working on Windows, macOS, and Linux (v1.2.4+)
+
+### Install via Claude Code Marketplace (Recommended)
+
+In Claude Code, run:
+
+```
+/plugin marketplace add etheaven/codex-mcp-server
+/plugin install codex-mcp-server@codex-mcp-server
+```
+
+### Alternative: CLI Setup
+
+```bash
+claude mcp add codex-cli -- npx -y @etheaven/codex-mcp-server
+```
+
+### Verify Installation
+
+Type `/mcp` inside Claude Code to verify the Codex MCP is active.
+
+---
+
+## Configuration
+
+### Claude Desktop
+
+Add to your Claude Desktop config file:
+
+```json
+{
+  "mcpServers": {
+    "codex-cli": {
+      "command": "npx",
+      "args": ["-y", "@etheaven/codex-mcp-server"]
+    }
+  }
+}
+```
+
+**Config file locations:**
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux**: `~/.config/claude/claude_desktop_config.json`
+
+### Global Installation
+
+```bash
+npm install -g @etheaven/codex-mcp-server
+```
+
+Then use `"command": "codex-mcp"` instead of the npx approach.
+
+After updating configuration, restart your terminal session.
+
+## Example Workflow
+
+- Natural language: "use codex to explain index.html", "understand this repo with @src", "look for vulnerabilities and suggest fixes"
+- Claude Code: Type `/codex-cli` to access the MCP server tools.
+
+## Usage Examples
+
+### Model Selection
+
+```javascript
+// Use the default model (gpt-5.4)
+'explain the architecture of @src/';
+
+// Use gpt-5.3-codex for complex coding tasks
+'use codex with model gpt-5.3-codex to refactor @legacy-code.js';
+
+// Use gpt-5.4 with high reasoning for deep analysis
+'use codex with model gpt-5.4 and reasoning high to analyze complex algorithm in @algorithm.py';
+
+// Use o4-mini for quick tasks
+'use codex with model o4-mini to add comments to @utils.js';
+
+// Use o3 for deep reasoning
+'use codex with model o3 to design microservices architecture for @requirements.md';
+
+// Use gpt-5-mini for cost-effective tasks
+'use codex with model gpt-5-mini to summarize @README.md';
+```
+
+### With File References (using @ syntax)
+
+- `ask codex to analyze @src/main.ts and explain what it does`
+- `use codex to summarize @. the current directory`
+- `analyze @package.json and list dependencies`
+
+### General Questions (without files)
+
+- `ask codex to explain div centering`
+- `ask codex about best practices for React development related to @src/components/Button.tsx`
+
+### Brainstorming & Ideation
+
+- `brainstorm ways to optimize our CI/CD pipeline using SCAMPER method`
+- `use codex to brainstorm 10 innovative features for our app with feasibility analysis`
+- `ask codex to generate product ideas for the healthcare domain with design-thinking approach`
+
+### Codex Approvals & Sandbox
+
+Codex CLI supports fine-grained control over permissions and approvals through sandbox modes and approval policies.
+
+#### Understanding Parameters
+
+**The `sandbox` Parameter (Convenience Flag):**
+
+- `sandbox: true` → Enables **fullAuto** mode (equivalent to `fullAuto: true`)
+- `sandbox: false` (default) → Does **NOT** disable sandboxing, just doesn't enable auto mode
+- **Important:** The `sandbox` parameter is a convenience flag, not a security control
+
+**Granular Control Parameters:**
+
+- `sandboxMode`: Controls file system access level
+- `approvalPolicy`: Controls when user approval is required
+- `fullAuto`: Shorthand for `sandboxMode: "workspace-write"` + `approvalPolicy: "on-failure"`
+- `yolo`: ⚠️ Bypasses all safety checks (dangerous, not recommended)
+
+#### Sandbox Modes
+
+| Mode                  | Description                          | Use Case                                          |
+| --------------------- | ------------------------------------ | ------------------------------------------------- |
+| `read-only`           | Analysis only, no file modifications | Code review, exploration, documentation reading   |
+| `workspace-write`     | Can modify files in workspace        | Most development tasks, refactoring, bug fixes    |
+| `danger-full-access`  | Full system access including network | Advanced automation, CI/CD pipelines              |
+
+#### Approval Policies
+
+| Policy        | Description                      | When to Use                         |
+| ------------- | -------------------------------- | ----------------------------------- |
+| `never`       | No approvals required            | Fully trusted automation            |
+| `on-request`  | Ask before every action          | Maximum control, manual review      |
+| `on-failure`  | Only ask when operations fail    | Balanced automation (recommended)   |
+| `untrusted`   | Maximum paranoia mode            | Untrusted code or high-risk changes |
+
+#### Configuration Examples
+
+**Example 1: Balanced Automation (Recommended)**
+
+```javascript
+{
+  "approvalPolicy": "on-failure",
+  "sandboxMode": "workspace-write",  // Auto-set if omitted in v1.2+
+  "model": "gpt-5.4",
+  "prompt": "refactor @src/utils for better performance"
+}
+```
+
+**Example 2: Quick Automation (Convenience Mode)**
+
+```javascript
+{
+  "sandbox": true,  // Equivalent to fullAuto: true
+  "model": "gpt-5.4",
+  "prompt": "fix type errors in @src/"
+}
+```
+
+**Example 3: Read-Only Analysis**
+
+```javascript
+{
+  "sandboxMode": "read-only",
+  "model": "gpt-5.4",
+  "prompt": "analyze @src/ and explain the architecture"
+}
+```
+
+#### Smart Defaults (v1.2+)
+
+Starting from version 1.2.0, the server automatically applies intelligent defaults to prevent permission errors:
+
+- ✅ If `approvalPolicy` is set but `sandboxMode` is not → auto-sets `sandboxMode: "workspace-write"`
+- ✅ If `search: true` or `oss: true` → auto-sets `sandboxMode: "workspace-write"` (for network access)
+- ✅ All commands include `--skip-git-repo-check` to prevent errors in non-git environments
+
+#### Troubleshooting Permission Errors
+
+If you encounter `❌ Permission Error: Operation blocked by sandbox policy`:
+
+**Check 1: Verify sandboxMode**
+
+```bash
+# Ensure you're not using read-only mode for write operations
+{
+  "sandboxMode": "workspace-write",  // Not "read-only"
+  "approvalPolicy": "on-failure"
+}
+```
+
+**Check 2: Use convenience flags**
+
+```bash
+# Let the server handle defaults
+{
+  "sandbox": true,  // Simple automation
+  "prompt": "your task"
+}
+```
+
+**Check 3: Update to latest version**
+
+```bash
+# v1.2+ includes smart defaults to prevent permission errors
+npm install -g @etheaven/codex-mcp-server@latest
+```
+
+#### Common Issues
+
+**Issue 1: MCP Tool Timeout Error**
+
+If you encounter timeout errors when using Codex MCP tools:
+
+```bash
+# Set the MCP tool timeout environment variable (in milliseconds)
+export MCP_TOOL_TIMEOUT=36000000  # 10 hours
+
+# For Windows (PowerShell):
+$env:MCP_TOOL_TIMEOUT=36000000
+
+# For Windows (CMD):
+set MCP_TOOL_TIMEOUT=36000000
+```
+
+Add this to your shell profile (`~/.bashrc`, `~/.zshrc`, or PowerShell profile) to make it permanent.
+
+**Issue 2: Codex Cannot Write Files**
+
+If Codex responds with permission errors like "Operation blocked by sandbox policy" or "rejected by user approval settings", configure your Codex CLI settings:
+
+Create or edit `~/.codex/config.toml`:
+
+```toml
+# Dynamically generated Codex configuration
+model = "gpt-5.4"
+model_reasoning_effort = "high"
+model_reasoning_summary = "detailed"
+approval_policy = "never"
+sandbox_mode = "danger-full-access"
+disable_response_storage = true
+network_access = true
+```
+
+**⚠️ Security Warning**: The `danger-full-access` mode grants Codex full file system access. Only use this configuration in trusted environments and for tasks you fully understand.
+
+**Configuration File Locations:**
+- **macOS/Linux**: `~/.codex/config.toml`
+- **Windows**: `%USERPROFILE%\.codex\config.toml`
+
+After updating the configuration, restart your MCP client (Claude Desktop, Claude Code, etc.).
+
+#### Basic Examples
+
+- `use codex to create and run a Python script that processes data`
+- `ask codex to safely test @script.py and explain what it does`
+
+**Default Behavior:**
+
+- All `codex exec` commands automatically include `--skip-git-repo-check` to avoid unnecessary git repository checks, as not all execution environments are git repositories.
+- This prevents permission errors when running Codex in non-git directories or when git checks would interfere with automation.
+
+### Advanced Examples
+
+```javascript
+// Using ask-codex with specific model and reasoning effort
+'ask codex using gpt-5.3-codex with reasoning high to refactor @utils/database.js for better performance';
+
+// Brainstorming with constraints
+"brainstorm solutions for reducing API latency with constraints: 'must use existing infrastructure, budget under $5k'";
+
+// Change mode for structured edits
+'use codex in change mode to update all console.log to use winston logger in @src/';
+```
+
+### Tools (for the AI)
+
+These tools are designed to be used by the AI assistant.
+
+#### Core Tools
+
+- **`ask-codex`**: Sends a prompt to Codex via `codex exec`.
+  - Supports `@` file references for including file content
+  - Optional `model` parameter — recommended models:
+    - `gpt-5.4` (default, latest flagship)
+    - `gpt-5.3-codex` (best for complex coding)
+    - `gpt-5.3-codex-spark` (instant coding, Pro only)
+    - `o3` (deep reasoning)
+    - `o4-mini` (fast & efficient)
+    - `gpt-5-mini` (cost-effective)
+    - `gpt-4.1` (1M context, no reasoning)
+    - See [full model list](docs/concepts/models.md)
+  - Optional `reasoningEffort` parameter: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`
+  - `sandbox=true` enables `--full-auto` mode
+  - `changeMode=true` returns structured OLD/NEW edits
+  - Supports approval policies and sandbox modes
+  - **Automatically includes `--skip-git-repo-check`** to prevent permission errors in non-git environments
+
+- **`brainstorm`**: Generate novel ideas with structured methodologies.
+  - Multiple frameworks: divergent, convergent, SCAMPER, design-thinking, lateral
+  - Domain-specific context (software, business, creative, research, product, marketing)
+  - Supports same models and `reasoningEffort` as `ask-codex`
+  - Configurable idea count and analysis depth
+  - Includes feasibility, impact, and innovation scoring
+  - Example: `brainstorm prompt:"ways to improve code review process" domain:"software" methodology:"scamper"`
+
+- **`ping`**: A simple test tool that echoes back a message.
+  - Use to verify MCP connection is working
+  - Example: `/codex-cli:ping (MCP) "Hello from Codex MCP!"`
+
+- **`help`**: Shows the Codex CLI help text and available commands.
+
+#### Advanced Tools
+
+- **`fetch-chunk`**: Retrieves cached chunks from changeMode responses.
+  - Used for paginating large structured edit responses
+  - Requires `cacheKey` and `chunkIndex` parameters
+
+- **`timeout-test`**: Test tool for timeout prevention.
+  - Runs for a specified duration in milliseconds
+  - Useful for testing long-running operations
+
+### Slash Commands (for the User)
+
+You can use these commands directly in Claude Code's interface (compatibility with other clients has not been tested).
+
+- **/analyze**: Analyzes files or directories using Codex, or asks general questions.
+  - **`prompt`** (required): The analysis prompt. Use `@` syntax to include files (e.g., `/analyze prompt:@src/ summarize this directory`) or ask general questions (e.g., `/analyze prompt:Please use a web search to find the latest news stories`).
+- **/sandbox**: Safely tests code or scripts with Codex approval modes.
+  - **`prompt`** (required): Code testing request (e.g., `/sandbox prompt:Create and run a Python script that processes CSV data` or `/sandbox prompt:@script.py Test this script safely`).
+- **/help**: Displays the Codex CLI help information.
+- **/ping**: Tests the connection to the server.
+  - **`message`** (optional): A message to echo back.
+
+## Recent Updates
+
+### v1.3.0 (2026-03-15)
+
+**Model Support Overhaul:**
+- **Updated model list** to March 2026: added gpt-5.4, gpt-5.4-pro, gpt-5.3-codex, gpt-5.3-codex-spark, gpt-5.2-codex, gpt-5.2, gpt-5.1-codex-max, gpt-5.1-codex, gpt-5.1, gpt-5-pro, gpt-5-mini, gpt-5-nano, o3-pro, gpt-4.1-mini, gpt-4.1-nano
+- **Removed deprecated models**: `codex-1` and `codex-mini-latest` (never existed in OpenAI API)
+- **New `reasoningEffort` parameter** for ask-codex, brainstorm, and batch-codex tools — supports `none`, `minimal`, `low`, `medium`, `high`, `xhigh`
+- **Improved tool schema descriptions** with exact valid model IDs to prevent AI clients from inventing model names
+- **Updated default model** recommendation from `gpt-5-codex` to `gpt-5.4`
+- **Comprehensive model documentation** rewrite with per-model reasoning effort support tables
+
+### v1.2.4 (2025-10-27)
+
+**🔧 Major Improvement:**
+- **Windows Compatibility Enhancement**: Replaced Node.js native `spawn()` with industry-standard `cross-spawn` package
+  - Root cause: Previous `shell: true` fix still failed on some Windows configurations
+  - Solution: Use `cross-spawn` (50M+ weekly downloads, used by Webpack/Jest) for automatic Windows `.cmd` handling
+  - Benefits:
+    - Zero configuration required for Windows users
+    - Automatic handling of `.cmd`, `.ps1`, and `.exe` extensions
+    - Compatible with both CMD and PowerShell environments
+    - <5ms performance overhead
+  - Dependencies: Added `cross-spawn@^7.0.6` and `@types/cross-spawn`
+
+**🐛 Bug Fixes:**
+- Enhanced ENOENT error diagnostics with Windows-specific 4-step troubleshooting guide
+- Added optional chaining for `stdout`/`stderr` to handle null values in TypeScript strict mode
+
+**📝 Documentation:**
+- Added comprehensive Windows troubleshooting section in docs
+- Documented `spawn codex ENOENT` error resolution steps
+
+### v1.2.3 (2025-10-27)
+
+**🐛 Bug Fixes:**
+- **Windows Compatibility**: Fixed Codex CLI detection failing on Windows despite proper installation
+  - Root cause: `spawn()` with `shell: false` couldn't resolve `.cmd` extensions on Windows
+  - Solution: Enabled shell mode for cross-platform command execution
+  - Impact: Zero performance impact (~10ms overhead), maintains security with array-form arguments
+  - Platforms verified: Windows, macOS, Linux via GitHub Actions CI
+
+**📝 Documentation:**
+- Updated all package references from `@trishchuk/codex-mcp-tool` to `@etheaven/codex-mcp-server` (now hosted at etheaven/codex-mcp-server)
+- Enhanced cross-platform setup instructions
+
+**🔍 Testing:**
+- CI/CD now validates on Ubuntu, macOS, and Windows across Node.js 18.x, 20.x, and 22.x
+
+### v1.2.2 & Earlier
+
+- Smart sandbox mode defaults to prevent permission errors
+- Enhanced debug information for troubleshooting
+- Automatic `--skip-git-repo-check` flag for non-git environments
+- Web search integration with feature flags
+- Structured change mode with pagination support
+
+## Platform Support
+
+| Platform | Status | Notes |
+|----------|--------|-------|
+| **Windows** | ✅ Fully Supported | Enhanced in v1.2.4 with cross-spawn |
+| **macOS** | ✅ Fully Supported | Tested on Darwin 23.5.0+ |
+| **Linux** | ✅ Fully Supported | Tested on Ubuntu Latest |
+
+**Minimum Requirements:**
+- Node.js v18.0.0 or higher
+- Codex CLI installed and authenticated (`npm install -g @openai/codex`)
+
+## Acknowledgments
+
+This project was inspired by the excellent work from [jamubc/gemini-mcp-tool](https://github.com/jamubc/gemini-mcp-tool). Special thanks to [@jamubc](https://github.com/jamubc) for the original MCP server architecture and implementation patterns.
+
+## Contributing
+
+Contributions are welcome! Please submit pull requests or report issues through GitHub.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+**Disclaimer:** This is an unofficial, third-party tool and is not affiliated with, endorsed, or sponsored by OpenAI.

package/dist/constants.d.ts

@@ -0,0 +1,165 @@
+export declare const LOG_PREFIX = "[CODEX-MCP]";
+export declare const ERROR_MESSAGES: {
+    readonly TOOL_NOT_FOUND: "not found in registry";
+    readonly 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";
+    readonly QUOTA_EXCEEDED: "Rate limit exceeded";
+    readonly AUTHENTICATION_FAILED: "Authentication failed - please check your OpenAI API key or login status";
+    readonly CODEX_NOT_FOUND: "Codex CLI not found - please install with 'npm install -g @openai/codex'";
+    readonly SANDBOX_VIOLATION: "Operation blocked by sandbox policy";
+    readonly UNSAFE_COMMAND: "Command requires approval or elevated permissions";
+};
+export declare const STATUS_MESSAGES: {
+    readonly SANDBOX_EXECUTING: "🔒 Executing CLI command in sandbox/auto mode...";
+    readonly CODEX_RESPONSE: "Codex response:";
+    readonly AUTHENTICATION_SUCCESS: "✅ Authentication successful";
+    readonly PROCESSING_START: "🔍 Starting analysis (may take 5-15 minutes for large codebases)";
+    readonly PROCESSING_CONTINUE: "⏳ Still processing...";
+    readonly PROCESSING_COMPLETE: "✅ Analysis completed successfully";
+};
+export declare const MODELS: {
+    readonly GPT_5_4: "gpt-5.4";
+    readonly GPT_5_4_PRO: "gpt-5.4-pro";
+    readonly GPT_5_3_CODEX: "gpt-5.3-codex";
+    readonly GPT_5_3_CODEX_SPARK: "gpt-5.3-codex-spark";
+    readonly GPT_5_2_CODEX: "gpt-5.2-codex";
+    readonly GPT_5_2: "gpt-5.2";
+    readonly GPT_5_1_CODEX_MAX: "gpt-5.1-codex-max";
+    readonly GPT_5_1_CODEX: "gpt-5.1-codex";
+    readonly GPT_5_1: "gpt-5.1";
+    readonly GPT_5: "gpt-5";
+    readonly GPT_5_PRO: "gpt-5-pro";
+    readonly GPT_5_CODEX: "gpt-5-codex";
+    readonly GPT_5_CODEX_MINI: "gpt-5-codex-mini";
+    readonly GPT_5_MINI: "gpt-5-mini";
+    readonly GPT_5_NANO: "gpt-5-nano";
+    readonly O3: "o3";
+    readonly O3_PRO: "o3-pro";
+    readonly O4_MINI: "o4-mini";
+    readonly GPT_4_1: "gpt-4.1";
+    readonly GPT_4_1_MINI: "gpt-4.1-mini";
+    readonly GPT_4_1_NANO: "gpt-4.1-nano";
+    readonly GPT_4O: "gpt-4o";
+    readonly GPT_4O_MINI: "gpt-4o-mini";
+};
+export declare const MODEL_RECOMMENDATIONS: {
+    readonly DEFAULT: "gpt-5.4";
+    readonly CODING: "gpt-5.3-codex";
+    readonly FAST_CODING: "gpt-5.3-codex-spark";
+    readonly DEEP_REASONING: "o3";
+    readonly FAST_REASONING: "o4-mini";
+    readonly COST_EFFECTIVE: "gpt-5-mini";
+    readonly LARGE_CONTEXT: "gpt-4.1";
+};
+export declare const REASONING_EFFORTS: {
+    readonly NONE: "none";
+    readonly MINIMAL: "minimal";
+    readonly LOW: "low";
+    readonly MEDIUM: "medium";
+    readonly HIGH: "high";
+    readonly XHIGH: "xhigh";
+};
+export type ReasoningEffort = (typeof REASONING_EFFORTS)[keyof typeof REASONING_EFFORTS];
+export declare const SANDBOX_MODES: {
+    readonly READ_ONLY: "read-only";
+    readonly WORKSPACE_WRITE: "workspace-write";
+    readonly DANGER_FULL_ACCESS: "danger-full-access";
+};
+export declare const APPROVAL_POLICIES: {
+    readonly UNTRUSTED: "untrusted";
+    readonly ON_FAILURE: "on-failure";
+    readonly ON_REQUEST: "on-request";
+    readonly NEVER: "never";
+};
+export declare const PROTOCOL: {
+    readonly ROLES: {
+        readonly USER: "user";
+        readonly ASSISTANT: "assistant";
+    };
+    readonly CONTENT_TYPES: {
+        readonly TEXT: "text";
+    };
+    readonly STATUS: {
+        readonly SUCCESS: "success";
+        readonly ERROR: "error";
+        readonly FAILED: "failed";
+        readonly REPORT: "report";
+    };
+    readonly NOTIFICATIONS: {
+        readonly PROGRESS: "notifications/progress";
+    };
+    readonly KEEPALIVE_INTERVAL: 25000;
+};
+export declare const CLI: {
+    readonly COMMANDS: {
+        readonly CODEX: "codex";
+        readonly CODEX_EXEC: "codex exec";
+        readonly ECHO: "echo";
+    };
+    readonly FLAGS: {
+        readonly MODEL: "-m";
+        readonly SANDBOX: "-s";
+        readonly FULL_AUTO: "--full-auto";
+        readonly ASK_FOR_APPROVAL: "--ask-for-approval";
+        readonly SANDBOX_MODE: "--sandbox";
+        readonly APPROVAL: "-a";
+        readonly YOLO: "--dangerously-bypass-approvals-and-sandbox";
+        readonly SKIP_GIT_REPO_CHECK: "--skip-git-repo-check";
+        readonly CD: "--cd";
+        readonly PROMPT: "-p";
+        readonly HELP: "-help";
+        readonly IMAGE: "-i";
+        readonly PROFILE: "--profile";
+        readonly CONFIG: "-c";
+        readonly VERSION: "--version";
+        readonly WORKING_DIR: "-C";
+        readonly OSS: "--oss";
+        readonly ENABLE: "--enable";
+        readonly DISABLE: "--disable";
+    };
+    readonly DEFAULTS: {
+        readonly MODEL: "default";
+        readonly BOOLEAN_TRUE: "true";
+        readonly BOOLEAN_FALSE: "false";
+    };
+    readonly ENV_VARS: {
+        readonly CODEX_MCP_CWD: "CODEX_MCP_CWD";
+        readonly PWD: "PWD";
+        readonly INIT_CWD: "INIT_CWD";
+    };
+};
+export interface ToolArguments {
+    prompt?: string;
+    model?: string;
+    sandbox?: boolean | string;
+    approvalPolicy?: 'never' | 'on-request' | 'on-failure' | 'untrusted';
+    approval?: string;
+    sandboxMode?: 'read-only' | 'workspace-write' | 'danger-full-access';
+    fullAuto?: boolean | string;
+    yolo?: boolean | string;
+    cd?: string;
+    workingDir?: string;
+    changeMode?: boolean | string;
+    chunkIndex?: number | string;
+    chunkCacheKey?: string;
+    message?: string;
+    reasoningEffort?: string;
+    image?: string | string[];
+    config?: string | Record<string, any>;
+    profile?: string;
+    timeout?: number;
+    useExec?: boolean;
+    includeThinking?: boolean;
+    includeMetadata?: boolean;
+    search?: boolean;
+    oss?: boolean;
+    enableFeatures?: string[];
+    disableFeatures?: string[];
+    methodology?: string;
+    domain?: string;
+    constraints?: string;
+    existingContext?: string;
+    ideaCount?: number;
+    includeAnalysis?: boolean;
+    [key: string]: string | boolean | number | string[] | Record<string, any> | undefined;
+}
+//# sourceMappingURL=constants.d.ts.map