@trishchuk/codex-mcp-tool 1.0.6 → 1.3.0

package/README.md

@@ -1,4 +1,3 @@
-
 # Codex MCP Tool
 
 <div align="center">
@@ -11,7 +10,6 @@
 
 </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.
 
 - Ask Codex questions from your MCP client, or brainstorm ideas programmatically.
@@ -31,6 +29,11 @@ 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
 
+### Platform Support
+
+✅ **Windows, macOS, and Linux fully supported**
+
+**v1.2.4** introduced cross-platform compatibility improvements using `cross-spawn`, ensuring reliable command execution across all operating systems. Windows users no longer experience "spawn codex ENOENT" errors.
 
 ### One-Line Setup
 
@@ -49,6 +52,7 @@ Type `/mcp` inside Claude Code to verify the Codex MCP is active.
 If you already have it configured in Claude Desktop:
 
 1. Add to your Claude Desktop config:
+
 ```json
 "codex-cli": {
   "command": "npx",
@@ -57,6 +61,7 @@ If you already have it configured in Claude Desktop:
 ```
 
 2. Import to Claude Code:
+
 ```bash
 claude mcp add-from-claude-desktop
 ```
@@ -112,21 +117,29 @@ After updating the configuration, restart your terminal session.
 
 ### Model Selection
 
+Default: `gpt-5.1-codex-max` (v1.3.0+) with automatic fallback → `gpt-5-codex` → `gpt-5` when newer models are unavailable.
+
+**GPT-5.1 family with examples**
+
+- `gpt-5.1-codex-max` — default for complex, multi-file edits (`'use codex to refactor @src with model gpt-5.1-codex-max'`)
+- `gpt-5.1-codex-mini` — cost-efficient quick passes (`'use codex with model gpt-5.1-codex-mini to scan @utils'`)
+- `gpt-5.1`, `gpt-5.1-mini`, `gpt-5.1-nano` — general-purpose GPT-5.1 variants (`'ask codex using gpt-5.1-nano for a fast read on @README.md'`)
+
 ```javascript
-// Use the default gpt-5-codex model
-"explain the architecture of @src/"
+// Use the default gpt-5.1-codex-max model (falls back to gpt-5-codex → gpt-5)
+'explain the architecture of @src/';
 
 // Use gpt-5 for fast general purpose reasoning
-"use codex with model gpt-5 to analyze @config.json"
+'use codex with model gpt-5 to analyze @config.json';
 
 // Use o3 for deep reasoning tasks
-"use codex with model o3 to analyze complex algorithm in @algorithm.py"
+'use codex with model o3 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 codex with model o4-mini to add comments to @utils.js';
 
 // Use codex-1 for software engineering
-"use codex with model codex-1 to refactor @legacy-code.js"
+'use codex with model codex-1 to refactor @legacy-code.js';
 ```
 
 ### With File References (using @ syntax)
@@ -153,17 +166,23 @@ Codex supports approval/sandbox modes. This server uses `codex exec` and can opt
 - `use codex to create and run a Python script that processes data`
 - `ask codex to safely test @script.py and explain what it does`
 
+### Native Search
+
+- Enable search with `search:true` or the `--search` flag; defaults to `workspace-write` sandbox for network access
+- Dual-flag compatibility: sends native `--search` on Codex CLI v0.52.0+ and always enables the `web_search_request` feature flag for older versions
+- Works alongside `oss`/feature toggles without manual client changes
+
 ### Advanced Examples
 
 ```javascript
 // Using ask-codex with specific model
-"ask codex using gpt-5 to refactor @utils/database.js for better performance"
+'ask codex using gpt-5 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'"
+"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/"
+'use codex in change mode to update all console.log to use winston logger in @src/';
 ```
 
 ### Tools (for the AI)
@@ -174,22 +193,28 @@ These tools are designed to be used by the AI assistant.
 
 - **`ask-codex`**: Sends a prompt to Codex via `codex exec`.
   - Supports `@` file references for including file content
-  - Optional `model` parameter - available models:
-    - `gpt-5-codex` (default, optimized for coding)
+  - Optional `model` parameter; default: `gpt-5.1-codex-max` with fallback chain `gpt-5.1-codex-max → gpt-5-codex → gpt-5` when a model is unavailable
+  - GPT-5.1 family stays enabled automatically on Codex CLI v0.56.0+; older CLI versions trigger the fallback chain
+  - Available models:
+    - `gpt-5.1-codex-max` (NEW DEFAULT v1.3.0, highest reliability)
+    - `gpt-5.1-codex-mini` (cost-efficient, quick tasks)
+    - `gpt-5.1`, `gpt-5.1-mini`, `gpt-5.1-nano` (GPT-5.1 family)
+    - `gpt-5-codex` (previous default, still supported)
     - `gpt-5` (general purpose, fast reasoning)
     - `o3` (smartest, deep reasoning)
     - `o4-mini` (fast & efficient)
     - `codex-1` (o3-based for software engineering)
     - `codex-mini-latest` (low-latency code Q&A)
-    - `gpt-4.1` (also available)
+    - `gpt-4.1` (legacy support)
+  - Native Search: uses dual flags (adds `--search` on v0.52.0+ and always enables `web_search_request`) for compatibility
   - `sandbox=true` enables `--full-auto` mode
   - `changeMode=true` returns structured OLD/NEW edits
-  - Supports approval policies and sandbox modes
+  - Supports approval policies, sandbox modes, and verbose control via `toolOutputTokenLimit`
 
 - **`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 as `ask-codex` (default: `gpt-5-codex`)
+  - Supports same models as `ask-codex` (default: `gpt-5.1-codex-max` with the same fallback chain)
   - 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"`
@@ -210,6 +235,26 @@ These tools are designed to be used by the AI assistant.
   - Runs for a specified duration in milliseconds
   - Useful for testing long-running operations
 
+## Advanced Features (v1.3.0+)
+
+### Version Detection & Compatibility
+
+- Automatically parses `codex --version` to toggle feature flags and pick the safest model available
+- GPT-5.1 family is auto-enabled on Codex CLI v0.56.0+; older versions gracefully fall back to `gpt-5-codex` → `gpt-5`
+- Native search, `--add-dir`, and token-limit flags are only sent when your installed CLI supports them
+
+### Multi-Directory Projects
+
+- Use `addDirs` to allow writes across multiple repositories or temp folders (requires Codex CLI v0.59.0+)
+- Example: `ask codex prompt:"upgrade shared configs" addDirs:["../shared-config","/tmp/sandbox"]`
+- The tool auto-skips unsupported flags on older CLI builds while logging a warning
+
+### Response Verbosity Control
+
+- Cap tool outputs with `toolOutputTokenLimit` (range: 100–10,000) to tame noisy commands
+- Example: `ask codex prompt:"summarize @logs" toolOutputTokenLimit:500`
+- Great for CI logs or quick scans where concise responses are needed
+
 ### Slash Commands (for the User)
 
 You can use these commands directly in Claude Code's interface (compatibility with other clients has not been tested).
@@ -222,6 +267,37 @@ You can use these commands directly in Claude Code's interface (compatibility wi
 - **/ping**: Tests the connection to the server.
   - **`message`** (optional): A message to echo back.
 
+## Codex CLI Compatibility
+
+| Codex CLI version | What you get                                               | Model behavior                                                                     |
+| ----------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| v0.59.0+          | `--add-dir`, `tool_output_token_limit`, Windows agent mode | Full GPT-5.1 support with fallback chain `gpt-5.1-codex-max → gpt-5-codex → gpt-5` |
+| v0.56.0+          | GPT-5.1 family unlocked                                    | Uses GPT-5.1 models directly; still falls back if a model is missing               |
+| v0.52.0+          | Native `--search` flag                                     | Dual-flag search (`--search` + `web_search_request`) for reliability               |
+| earlier           | Legacy-only flags                                          | Forces fallback to `gpt-5-codex`/`gpt-5`, skips unsupported flags with warnings    |
+
+## Troubleshooting (legacy versions)
+
+- Run `codex --version` to confirm your CLI build; upgrade to v0.59.0+ for full v1.3.0 features
+- If GPT-5.1 models error on older CLIs, explicitly set `model:"gpt-5-codex"` (the fallback will apply automatically otherwise)
+- Remove `addDirs` or `toolOutputTokenLimit` if you see unsupported flag warnings; they require v0.59.0+
+- Web search issues on pre-v0.52.0 builds: rely on the `web_search_request` feature flag only, or upgrade for the `--search` flag
+
+## FAQ
+
+- **What model is used by default?** `gpt-5.1-codex-max` with fallback to `gpt-5-codex` then `gpt-5`.
+- **How do I switch to a cheaper model?** Set `model:"gpt-5.1-codex-mini"` (or `gpt-5.1-nano` for fastest scans) in your tool call.
+- **Can I limit output verbosity?** Yes—use `toolOutputTokenLimit` between 100 and 10,000 to cap tool responses.
+- **How do I let Codex touch multiple repos?** Pass `addDirs:["../shared","/tmp/work"]` (CLI v0.59.0+); older versions will warn and skip the flag.
+- **How is native search handled?** The tool sends both `--search` (when available) and the `web_search_request` feature flag to stay compatible.
+
+## Migration: v1.2.x → v1.3.0
+
+- Default model switches to `gpt-5.1-codex-max`; fallback chain now formalized (`gpt-5.1-codex-max → gpt-5-codex → gpt-5`)
+- New features: `addDirs` for multi-directory writes and `toolOutputTokenLimit` for output control (both require Codex CLI v0.59.0+)
+- Native search now uses the dual-flag approach automatically; no config changes needed
+- Recommendation: update Codex CLI to v0.59.0+ and refresh your MCP config (no schema changes—existing `/mcp` entries still work)
+
 ## 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.

package/dist/constants.d.ts

@@ -2,14 +2,45 @@ 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 GPT5_1_CODEX_MAX: "gpt-5.1-codex-max";
+    readonly GPT5_1_CODEX_MINI: "gpt-5.1-codex-mini";
+    readonly GPT5_1: "gpt-5.1";
+    readonly GPT5_1_MINI: "gpt-5.1-mini";
+    readonly GPT5_1_NANO: "gpt-5.1-nano";
+    readonly GPT5_CODEX: "gpt-5-codex";
+    readonly GPT5: "gpt-5";
+    readonly O3: "o3";
+    readonly O4_MINI: "o4-mini";
+    readonly CODEX_1: "codex-1";
+    readonly CODEX_MINI_LATEST: "codex-mini-latest";
+    readonly GPT_4_1: "gpt-4.1";
+};
+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";
@@ -32,6 +63,7 @@ export declare const PROTOCOL: {
 export declare const CLI: {
     readonly COMMANDS: {
         readonly CODEX: "codex";
+        readonly CODEX_EXEC: "codex exec";
         readonly ECHO: "echo";
     };
     readonly FLAGS: {
@@ -40,37 +72,67 @@ export declare const CLI: {
         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 CD: "--cd";
-        readonly SKIP_GIT_REPO_CHECK: "--skip-git-repo-check";
         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 SEARCH: "--search";
+        readonly ADD_DIR: "--add-dir";
     };
     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;
+    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[];
+    addDirs?: string[];
+    toolOutputTokenLimit?: number;
     methodology?: string;
     domain?: string;
     constraints?: string;
     existingContext?: string;
     ideaCount?: number;
     includeAnalysis?: boolean;
-    [key: string]: string | boolean | number | undefined;
+    [key: string]: string | boolean | number | string[] | Record<string, any> | undefined;
 }
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,gBAAgB,CAAC;AAGxC,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAGX,eAAO,MAAM,eAAe;;;;;;CAOlB,CAAC;AAKX,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAuBX,CAAC;AAIX,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;CAyBN,CAAC;AAIX,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,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,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,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,SAAS,CAAC;CACtD"}
+{"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;AAGX,eAAO,MAAM,MAAM;;;;;;;;;;;;;CAgBT,CAAC;AAGX,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAGX,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAGX,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAuBX,CAAC;AAGX,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CN,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,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;IAE3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAG9B,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

@@ -1,41 +1,77 @@
 // Logging
-export const LOG_PREFIX = "[CODEX-MCP]";
+export const LOG_PREFIX = '[CODEX-MCP]';
 // Error messages
 export const ERROR_MESSAGES = {
-    TOOL_NOT_FOUND: "not found in registry",
+    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:",
+    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",
+    PROCESSING_START: '🔍 Starting analysis (may take 5-15 minutes for large codebases)',
+    PROCESSING_CONTINUE: '⏳ Still processing...',
+    PROCESSING_COMPLETE: '✅ Analysis completed successfully',
+};
+// Models
+export const MODELS = {
+    // GPT-5.1 Series (Latest - 2025)
+    GPT5_1_CODEX_MAX: 'gpt-5.1-codex-max', // Default (v1.3.0+): Frontier agentic coding with highest reliability
+    GPT5_1_CODEX_MINI: 'gpt-5.1-codex-mini', // Cost-efficient compact model
+    GPT5_1: 'gpt-5.1', // General purpose GPT-5.1
+    GPT5_1_MINI: 'gpt-5.1-mini', // Balanced performance
+    GPT5_1_NANO: 'gpt-5.1-nano', // Fastest for simple queries
+    // GPT-5 Series (Legacy)
+    GPT5_CODEX: 'gpt-5-codex', // Previous default
+    GPT5: 'gpt-5',
+    // Other Models
+    O3: 'o3',
+    O4_MINI: 'o4-mini',
+    CODEX_1: 'codex-1',
+    CODEX_MINI_LATEST: 'codex-mini-latest',
+    GPT_4_1: 'gpt-4.1',
+};
+// 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',
 };
-// Models: pass-through via Codex CLI
 // MCP Protocol Constants
 export const PROTOCOL = {
     // Message roles
     ROLES: {
-        USER: "user",
-        ASSISTANT: "assistant",
+        USER: 'user',
+        ASSISTANT: 'assistant',
     },
     // Content types
     CONTENT_TYPES: {
-        TEXT: "text",
+        TEXT: 'text',
     },
     // Status codes
     STATUS: {
-        SUCCESS: "success",
-        ERROR: "error",
-        FAILED: "failed",
-        REPORT: "report",
+        SUCCESS: 'success',
+        ERROR: 'error',
+        FAILED: 'failed',
+        REPORT: 'report',
     },
     // Notification methods
     NOTIFICATIONS: {
-        PROGRESS: "notifications/progress",
+        PROGRESS: 'notifications/progress',
     },
     // Timeout prevention
     KEEPALIVE_INTERVAL: 25000, // 25 seconds
@@ -44,27 +80,45 @@ export const PROTOCOL = {
 export const CLI = {
     // Command names
     COMMANDS: {
-        CODEX: "codex",
-        ECHO: "echo",
+        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",
-        YOLO: "--dangerously-bypass-approvals-and-sandbox",
-        CD: "--cd",
-        SKIP_GIT_REPO_CHECK: "--skip-git-repo-check",
-        PROMPT: "-p",
-        HELP: "-help",
+        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',
+        CD: '--cd',
+        PROMPT: '-p',
+        HELP: '-help',
+        IMAGE: '-i',
+        PROFILE: '--profile',
+        CONFIG: '-c',
+        VERSION: '--version',
+        WORKING_DIR: '-C',
+        OSS: '--oss',
+        ENABLE: '--enable',
+        DISABLE: '--disable',
+        // New flags (v1.3.0+)
+        SEARCH: '--search', // Native web search flag (Codex CLI v0.52.0+)
+        ADD_DIR: '--add-dir', // Additional writable directories (Codex CLI v0.59.0+)
     },
     // Default values
     DEFAULTS: {
-        MODEL: "default", // Fallback model used when no specific model is provided
-        BOOLEAN_TRUE: "true",
-        BOOLEAN_FALSE: "false",
+        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

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,UAAU;AACV,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AAExC,iBAAiB;AACjB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc,EAAE,uBAAuB;IACvC,kBAAkB,EAAE,6IAA6I;CACzJ,CAAC;AAEX,kBAAkB;AAClB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,iBAAiB,EAAE,kDAAkD;IACrE,cAAc,EAAE,iBAAiB;IACjC,8BAA8B;IAC9B,gBAAgB,EAAE,kEAAkE;IACpF,mBAAmB,EAAE,uBAAuB;IAC5C,mBAAmB,EAAE,mCAAmC;CAChD,CAAC;AAEX,qCAAqC;AAErC,yBAAyB;AACzB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,gBAAgB;IAChB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,WAAW;KACvB;IACD,gBAAgB;IAChB,aAAa,EAAE;QACb,IAAI,EAAE,MAAM;KACb;IACD,eAAe;IACf,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,QAAQ;KACjB;IACD,uBAAuB;IACvB,aAAa,EAAE;QACb,QAAQ,EAAE,wBAAwB;KACnC;IACD,qBAAqB;IACrB,kBAAkB,EAAE,KAAK,EAAE,aAAa;CAChC,CAAC;AAGX,gBAAgB;AAChB,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,gBAAgB;IAChB,QAAQ,EAAE;QACR,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,MAAM;KACb;IACD,gBAAgB;IAChB,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI,EAAE,qEAAqE;QACpF,SAAS,EAAE,aAAa;QACxB,gBAAgB,EAAE,oBAAoB;QACtC,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,4CAA4C;QAClD,EAAE,EAAE,MAAM;QACV,mBAAmB,EAAE,uBAAuB;QAC5C,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,OAAO;KACd;IACD,iBAAiB;IACjB,QAAQ,EAAE;QACR,KAAK,EAAE,SAAS,EAAE,yDAAyD;QAC3E,YAAY,EAAE,MAAM;QACpB,aAAa,EAAE,OAAO;KACvB;CACO,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,13 +1,13 @@
 #!/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";
+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.0.6",
+    name: 'codex-cli-mcp',
+    version: '1.3.0',
 }, {
     capabilities: {
         tools: {},
@@ -29,7 +29,7 @@ async function sendProgressNotification(progressToken, progress, total, message)
     try {
         const params = {
             progressToken,
-            progress
+            progress,
         };
         if (total !== undefined)
             params.total = total; // future cache progress
@@ -37,11 +37,11 @@ async function sendProgressNotification(progressToken, progress, total, message)
             params.message = message;
         await server.notification({
             method: PROTOCOL.NOTIFICATIONS.PROGRESS,
-            params
+            params,
         });
     }
     catch (error) {
-        Logger.error("Failed to send progress notification:", error);
+        Logger.error('Failed to send progress notification:', error);
     }
 }
 function startProgressUpdates(operationName, progressToken) {
@@ -49,7 +49,7 @@ function startProgressUpdates(operationName, progressToken) {
     const state = {
         isProcessing: true,
         currentOperationName: operationName,
-        latestOutput: ""
+        latestOutput: '',
     };
     const progressMessages = [
         `🧠 ${operationName} - Codex is analyzing your request...`,
@@ -87,7 +87,7 @@ function startProgressUpdates(operationName, progressToken) {
     return { interval: progressInterval, progressToken, state };
 }
 function stopProgressUpdates(progressData, success = true) {
-    const operationName = progressData.state?.currentOperationName || ""; // Get from state
+    const operationName = progressData.state?.currentOperationName || ''; // Get from state
     if (progressData.state) {
         progressData.state.isProcessing = false;
     }
@@ -120,7 +120,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             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) => {
+            const result = await executeTool(toolName, args, newOutput => {
                 if (progressData.state) {
                     progressData.state.latestOutput = newOutput;
                 }
@@ -130,7 +130,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             return {
                 content: [
                     {
-                        type: "text",
+                        type: 'text',
                         text: result,
                     },
                 ],
@@ -145,7 +145,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             return {
                 content: [
                     {
-                        type: "text",
+                        type: 'text',
                         text: `Error executing ${toolName}: ${errorMessage}`,
                     },
                 ],
@@ -170,24 +170,26 @@ server.setRequestHandler(GetPromptRequestSchema, async (request) => {
         throw new Error(`Unknown prompt: ${promptName}`);
     }
     return {
-        messages: [{
-                role: "user",
+        messages: [
+            {
+                role: 'user',
                 content: {
-                    type: "text",
-                    text: promptMessage
-                }
-            }]
+                    type: 'text',
+                    text: promptMessage,
+                },
+            },
+        ],
     };
 });
 // Start the server
 async function main() {
-    Logger.debug("init codex-mcp-tool");
+    Logger.debug('init codex-mcp-tool');
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    Logger.debug("codex-mcp-tool listening on stdio");
+    Logger.debug('codex-mcp-tool listening on stdio');
 }
-main().catch((error) => {
-    Logger.error("Fatal error:", error);
+main().catch(error => {
+    Logger.error('Fatal error:', error);
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map