ai-sdk-provider-codex-cli 0.5.2 → 0.7.0

package/dist/index.d.cts

@@ -46,9 +46,60 @@ type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
 type ReasoningSummary = 'auto' | 'detailed';
 type ReasoningSummaryFormat = 'none' | 'experimental';
 type ModelVerbosity = 'low' | 'medium' | 'high';
+interface McpServerBase {
+    /**
+     * Enable/disable this MCP server without removing its definition.
+     * Maps to: `mcp_servers.<name>.enabled`
+     */
+    enabled?: boolean;
+    /**
+     * Time allowed for the MCP server to start (in seconds).
+     * Maps to: `mcp_servers.<name>.startup_timeout_sec`
+     */
+    startupTimeoutSec?: number;
+    /**
+     * Max time a single MCP tool call may run (in seconds).
+     * Maps to: `mcp_servers.<name>.tool_timeout_sec`
+     */
+    toolTimeoutSec?: number;
+    /**
+     * Explicit allow/deny lists for tools exposed by the server.
+     * Maps to: `mcp_servers.<name>.enabled_tools` / `disabled_tools`
+     */
+    enabledTools?: string[];
+    disabledTools?: string[];
+}
+interface McpServerStdio extends McpServerBase {
+    /** Execute an MCP server over stdio */
+    transport: 'stdio';
+    /** Command to start the MCP server (e.g., `node`, `python`, or a binary path). */
+    command: string;
+    /** Arguments passed to the command. */
+    args?: string[];
+    /** Environment variables passed to the MCP process. */
+    env?: Record<string, string>;
+    /** Optional working directory for the MCP server process. */
+    cwd?: string;
+}
+interface McpServerHttp extends McpServerBase {
+    /** Use an HTTP-based MCP server (RMCP). */
+    transport: 'http';
+    /** Base URL for the MCP server. */
+    url: string;
+    /** Bearer token supplied inline (use env var variant to avoid embedding secrets). */
+    bearerToken?: string;
+    /** Name of env var that holds the bearer token. */
+    bearerTokenEnvVar?: string;
+    /** Static HTTP headers to send with each MCP request. */
+    httpHeaders?: Record<string, string>;
+    /** Names of env vars whose values should be sent as HTTP headers. */
+    envHttpHeaders?: Record<string, string>;
+}
+type McpServerConfig = McpServerStdio | McpServerHttp;
 interface CodexCliSettings {
     codexPath?: string;
     cwd?: string;
+    addDirs?: string[];
     approvalMode?: ApprovalMode;
     sandboxMode?: SandboxMode;
     fullAuto?: boolean;
@@ -97,6 +148,16 @@ interface CodexCliSettings {
      * Maps to: `-c model_verbosity=<value>`
      */
     modelVerbosity?: ModelVerbosity;
+    /**
+     * Configure MCP servers (stdio or HTTP/RMCP). Keys are server names.
+     * Each entry maps to the Codex CLI `mcp_servers.<name>` table.
+     */
+    mcpServers?: Record<string, McpServerConfig>;
+    /**
+     * Enable the RMCP client so HTTP-based MCP servers can be contacted.
+     * Maps to: `-c features.rmcp_client=true`
+     */
+    rmcpClient?: boolean;
     /**
      * Include experimental plan tool that the model can use to update its current plan.
      *
@@ -169,11 +230,25 @@ interface CodexCliProviderOptions {
      * Maps to Codex `model_verbosity`.
      */
     textVerbosity?: ModelVerbosity;
+    /**
+     * Per-call override for extra directories Codex can access.
+     * Maps to repeated `--add-dir` flags.
+     */
+    addDirs?: string[];
     /**
      * Per-call Codex CLI config overrides. These are merged with
      * constructor-level overrides with per-call values taking precedence.
      */
     configOverrides?: Record<string, string | number | boolean | object>;
+    /**
+     * Per-call MCP server definitions. Merged with constructor definitions
+     * (per-call servers and fields take precedence).
+     */
+    mcpServers?: Record<string, McpServerConfig>;
+    /**
+     * Per-call override for RMCP client enablement.
+     */
+    rmcpClient?: boolean;
 }
 
 interface CodexCliProvider extends ProviderV2 {
@@ -203,8 +278,12 @@ declare class CodexCliLanguageModel implements LanguageModelV2 {
     private sessionId?;
     constructor(options: CodexLanguageModelOptions);
     private mergeSettings;
+    private mergeMcpServers;
+    private mergeSingleMcpServer;
+    private mergeStringRecord;
     private getItemType;
     private buildArgs;
+    private applyMcpSettings;
     private addConfigOverride;
     /**
      * Serialize a config override value into a CLI-safe string.

package/dist/index.d.ts

@@ -46,9 +46,60 @@ type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
 type ReasoningSummary = 'auto' | 'detailed';
 type ReasoningSummaryFormat = 'none' | 'experimental';
 type ModelVerbosity = 'low' | 'medium' | 'high';
+interface McpServerBase {
+    /**
+     * Enable/disable this MCP server without removing its definition.
+     * Maps to: `mcp_servers.<name>.enabled`
+     */
+    enabled?: boolean;
+    /**
+     * Time allowed for the MCP server to start (in seconds).
+     * Maps to: `mcp_servers.<name>.startup_timeout_sec`
+     */
+    startupTimeoutSec?: number;
+    /**
+     * Max time a single MCP tool call may run (in seconds).
+     * Maps to: `mcp_servers.<name>.tool_timeout_sec`
+     */
+    toolTimeoutSec?: number;
+    /**
+     * Explicit allow/deny lists for tools exposed by the server.
+     * Maps to: `mcp_servers.<name>.enabled_tools` / `disabled_tools`
+     */
+    enabledTools?: string[];
+    disabledTools?: string[];
+}
+interface McpServerStdio extends McpServerBase {
+    /** Execute an MCP server over stdio */
+    transport: 'stdio';
+    /** Command to start the MCP server (e.g., `node`, `python`, or a binary path). */
+    command: string;
+    /** Arguments passed to the command. */
+    args?: string[];
+    /** Environment variables passed to the MCP process. */
+    env?: Record<string, string>;
+    /** Optional working directory for the MCP server process. */
+    cwd?: string;
+}
+interface McpServerHttp extends McpServerBase {
+    /** Use an HTTP-based MCP server (RMCP). */
+    transport: 'http';
+    /** Base URL for the MCP server. */
+    url: string;
+    /** Bearer token supplied inline (use env var variant to avoid embedding secrets). */
+    bearerToken?: string;
+    /** Name of env var that holds the bearer token. */
+    bearerTokenEnvVar?: string;
+    /** Static HTTP headers to send with each MCP request. */
+    httpHeaders?: Record<string, string>;
+    /** Names of env vars whose values should be sent as HTTP headers. */
+    envHttpHeaders?: Record<string, string>;
+}
+type McpServerConfig = McpServerStdio | McpServerHttp;
 interface CodexCliSettings {
     codexPath?: string;
     cwd?: string;
+    addDirs?: string[];
     approvalMode?: ApprovalMode;
     sandboxMode?: SandboxMode;
     fullAuto?: boolean;
@@ -97,6 +148,16 @@ interface CodexCliSettings {
      * Maps to: `-c model_verbosity=<value>`
      */
     modelVerbosity?: ModelVerbosity;
+    /**
+     * Configure MCP servers (stdio or HTTP/RMCP). Keys are server names.
+     * Each entry maps to the Codex CLI `mcp_servers.<name>` table.
+     */
+    mcpServers?: Record<string, McpServerConfig>;
+    /**
+     * Enable the RMCP client so HTTP-based MCP servers can be contacted.
+     * Maps to: `-c features.rmcp_client=true`
+     */
+    rmcpClient?: boolean;
     /**
      * Include experimental plan tool that the model can use to update its current plan.
      *
@@ -169,11 +230,25 @@ interface CodexCliProviderOptions {
      * Maps to Codex `model_verbosity`.
      */
     textVerbosity?: ModelVerbosity;
+    /**
+     * Per-call override for extra directories Codex can access.
+     * Maps to repeated `--add-dir` flags.
+     */
+    addDirs?: string[];
     /**
      * Per-call Codex CLI config overrides. These are merged with
      * constructor-level overrides with per-call values taking precedence.
      */
     configOverrides?: Record<string, string | number | boolean | object>;
+    /**
+     * Per-call MCP server definitions. Merged with constructor definitions
+     * (per-call servers and fields take precedence).
+     */
+    mcpServers?: Record<string, McpServerConfig>;
+    /**
+     * Per-call override for RMCP client enablement.
+     */
+    rmcpClient?: boolean;
 }
 
 interface CodexCliProvider extends ProviderV2 {
@@ -203,8 +278,12 @@ declare class CodexCliLanguageModel implements LanguageModelV2 {
     private sessionId?;
     constructor(options: CodexLanguageModelOptions);
     private mergeSettings;
+    private mergeMcpServers;
+    private mergeSingleMcpServer;
+    private mergeStringRecord;
     private getItemType;
     private buildArgs;
+    private applyMcpSettings;
     private addConfigOverride;
     /**
      * Serialize a config override value into a CLI-safe string.