ai-sdk-provider-codex-cli 0.3.0 → 0.4.0

package/README.md

@@ -179,6 +179,73 @@ When OpenAI adds streaming support, this provider will be updated to handle thos
 
 See [docs/ai-sdk-v5/configuration.md](docs/ai-sdk-v5/configuration.md) for the full list and examples.
 
+## Model Parameters & Advanced Options (v0.4.0+)
+
+Control reasoning effort, verbosity, and advanced Codex features at model creation time:
+
+```ts
+import { codexCli } from 'ai-sdk-provider-codex-cli';
+
+const model = codexCli('gpt-5-codex', {
+  allowNpx: true,
+  skipGitRepoCheck: true,
+
+  // Reasoning & verbosity
+  reasoningEffort: 'medium', // minimal | low | medium | high
+  reasoningSummary: 'auto', // auto | detailed (Note: 'concise' and 'none' are rejected by API)
+  reasoningSummaryFormat: 'none', // none | experimental
+  modelVerbosity: 'high', // low | medium | high
+
+  // Advanced features
+  includePlanTool: true, // adds --include-plan-tool
+  profile: 'production', // adds --profile production
+  oss: false, // adds --oss when true
+  webSearch: true, // maps to -c tools.web_search=true
+
+  // Generic overrides (maps to -c key=value)
+  configOverrides: {
+    experimental_resume: '/tmp/session.jsonl',
+    sandbox_workspace_write: { network_access: true },
+  },
+});
+```
+
+Nested override objects are flattened to dotted keys (e.g., the example above emits
+`-c sandbox_workspace_write.network_access=true`). Arrays are serialized to JSON strings.
+
+### Per-call overrides via `providerOptions` (v0.4.0+)
+
+Override these parameters for individual AI SDK calls using the `providerOptions` map. Per-call
+values take precedence over constructor defaults while leaving other settings intact.
+
+```ts
+import { generateText } from 'ai';
+import { codexCli } from 'ai-sdk-provider-codex-cli';
+
+const model = codexCli('gpt-5-codex', {
+  allowNpx: true,
+  reasoningEffort: 'medium',
+  modelVerbosity: 'medium',
+});
+
+const response = await generateText({
+  model,
+  prompt: 'Summarize the latest release notes.',
+  providerOptions: {
+    'codex-cli': {
+      reasoningEffort: 'high',
+      reasoningSummary: 'detailed',
+      textVerbosity: 'high', // AI SDK naming; maps to model_verbosity
+      configOverrides: {
+        experimental_resume: '/tmp/resume.jsonl',
+      },
+    },
+  },
+});
+```
+
+**Precedence:** `providerOptions['codex-cli']` > constructor `CodexCliSettings` > Codex CLI defaults.
+
 ## Zod Compatibility
 
 - Peer supports `zod@^3 || ^4`

package/dist/index.cjs

@@ -7,8 +7,8 @@ var module$1 = require('module');
 var fs = require('fs');
 var os = require('os');
 var path = require('path');
-var providerUtils = require('@ai-sdk/provider-utils');
 var zod = require('zod');
+var providerUtils = require('@ai-sdk/provider-utils');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 // src/codex-cli-provider.ts
@@ -41,7 +41,29 @@ var settingsSchema = zod.z.object({
   allowNpx: zod.z.boolean().optional(),
   env: zod.z.record(zod.z.string(), zod.z.string()).optional(),
   verbose: zod.z.boolean().optional(),
-  logger: zod.z.any().optional()
+  logger: zod.z.any().optional(),
+  // NEW: Reasoning & Verbosity
+  reasoningEffort: zod.z.enum(["minimal", "low", "medium", "high"]).optional(),
+  // Note: API rejects 'concise' and 'none' despite error messages claiming they're valid
+  reasoningSummary: zod.z.enum(["auto", "detailed"]).optional(),
+  reasoningSummaryFormat: zod.z.enum(["none", "experimental"]).optional(),
+  modelVerbosity: zod.z.enum(["low", "medium", "high"]).optional(),
+  // NEW: Advanced features
+  includePlanTool: zod.z.boolean().optional(),
+  profile: zod.z.string().optional(),
+  oss: zod.z.boolean().optional(),
+  webSearch: zod.z.boolean().optional(),
+  // NEW: Generic overrides
+  configOverrides: zod.z.record(
+    zod.z.string(),
+    zod.z.union([
+      zod.z.string(),
+      zod.z.number(),
+      zod.z.boolean(),
+      zod.z.object({}).passthrough(),
+      zod.z.array(zod.z.any())
+    ])
+  ).optional()
 }).strict();
 function validateSettings(settings) {
   const warnings = [];
@@ -169,6 +191,22 @@ function isAuthenticationError(err) {
 }
 
 // src/codex-cli-language-model.ts
+var codexCliProviderOptionsSchema = zod.z.object({
+  reasoningEffort: zod.z.enum(["minimal", "low", "medium", "high"]).optional(),
+  reasoningSummary: zod.z.enum(["auto", "detailed"]).optional(),
+  reasoningSummaryFormat: zod.z.enum(["none", "experimental"]).optional(),
+  textVerbosity: zod.z.enum(["low", "medium", "high"]).optional(),
+  configOverrides: zod.z.record(
+    zod.z.string(),
+    zod.z.union([
+      zod.z.string(),
+      zod.z.number(),
+      zod.z.boolean(),
+      zod.z.object({}).passthrough(),
+      zod.z.array(zod.z.any())
+    ])
+  ).optional()
+}).strict();
 function resolveCodexPath(explicitPath, allowNpx) {
   if (explicitPath) return { cmd: "node", args: [explicitPath] };
   try {
@@ -202,6 +240,21 @@ var CodexCliLanguageModel = class {
     const warn = validateModelId(this.modelId);
     if (warn) this.logger.warn(`Codex CLI model: ${warn}`);
   }
+  mergeSettings(providerOptions) {
+    if (!providerOptions) return this.settings;
+    const mergedConfigOverrides = providerOptions.configOverrides || this.settings.configOverrides ? {
+      ...this.settings.configOverrides ?? {},
+      ...providerOptions.configOverrides ?? {}
+    } : void 0;
+    return {
+      ...this.settings,
+      reasoningEffort: providerOptions.reasoningEffort ?? this.settings.reasoningEffort,
+      reasoningSummary: providerOptions.reasoningSummary ?? this.settings.reasoningSummary,
+      reasoningSummaryFormat: providerOptions.reasoningSummaryFormat ?? this.settings.reasoningSummaryFormat,
+      modelVerbosity: providerOptions.textVerbosity ?? this.settings.modelVerbosity,
+      configOverrides: mergedConfigOverrides
+    };
+  }
   // Codex JSONL items use `type` for the item discriminator, but some
   // earlier fixtures (and defensive parsing) might still surface `item_type`.
   // This helper returns whichever is present.
@@ -212,28 +265,57 @@ var CodexCliLanguageModel = class {
     const current = typeof data.type === "string" ? data.type : void 0;
     return legacy ?? current;
   }
-  buildArgs(promptText, responseFormat) {
-    const base = resolveCodexPath(this.settings.codexPath, this.settings.allowNpx);
+  buildArgs(promptText, responseFormat, settings = this.settings) {
+    const base = resolveCodexPath(settings.codexPath, settings.allowNpx);
     const args = [...base.args, "exec", "--experimental-json"];
-    if (this.settings.fullAuto) {
+    if (settings.fullAuto) {
       args.push("--full-auto");
-    } else if (this.settings.dangerouslyBypassApprovalsAndSandbox) {
+    } else if (settings.dangerouslyBypassApprovalsAndSandbox) {
       args.push("--dangerously-bypass-approvals-and-sandbox");
     } else {
-      const approval = this.settings.approvalMode ?? "on-failure";
+      const approval = settings.approvalMode ?? "on-failure";
       args.push("-c", `approval_policy=${approval}`);
-      const sandbox = this.settings.sandboxMode ?? "workspace-write";
+      const sandbox = settings.sandboxMode ?? "workspace-write";
       args.push("-c", `sandbox_mode=${sandbox}`);
     }
-    if (this.settings.skipGitRepoCheck !== false) {
+    if (settings.skipGitRepoCheck !== false) {
       args.push("--skip-git-repo-check");
     }
-    if (this.settings.color) {
-      args.push("--color", this.settings.color);
+    if (settings.reasoningEffort) {
+      args.push("-c", `model_reasoning_effort=${settings.reasoningEffort}`);
+    }
+    if (settings.reasoningSummary) {
+      args.push("-c", `model_reasoning_summary=${settings.reasoningSummary}`);
+    }
+    if (settings.reasoningSummaryFormat) {
+      args.push("-c", `model_reasoning_summary_format=${settings.reasoningSummaryFormat}`);
+    }
+    if (settings.modelVerbosity) {
+      args.push("-c", `model_verbosity=${settings.modelVerbosity}`);
+    }
+    if (settings.includePlanTool) {
+      args.push("--include-plan-tool");
+    }
+    if (settings.profile) {
+      args.push("--profile", settings.profile);
+    }
+    if (settings.oss) {
+      args.push("--oss");
+    }
+    if (settings.webSearch) {
+      args.push("-c", "tools.web_search=true");
+    }
+    if (settings.color) {
+      args.push("--color", settings.color);
     }
     if (this.modelId) {
       args.push("-m", this.modelId);
     }
+    if (settings.configOverrides) {
+      for (const [key, value] of Object.entries(settings.configOverrides)) {
+        this.addConfigOverride(args, key, value);
+      }
+    }
     let schemaPath;
     if (responseFormat?.type === "json" && responseFormat.schema) {
       const schema = typeof responseFormat.schema === "object" ? responseFormat.schema : {};
@@ -253,16 +335,55 @@ var CodexCliLanguageModel = class {
     args.push(promptText);
     const env = {
       ...process.env,
-      ...this.settings.env || {},
+      ...settings.env || {},
       RUST_LOG: process.env.RUST_LOG || "error"
     };
-    let lastMessagePath = this.settings.outputLastMessageFile;
+    let lastMessagePath = settings.outputLastMessageFile;
     if (!lastMessagePath) {
       const dir = fs.mkdtempSync(path.join(os.tmpdir(), "codex-cli-"));
       lastMessagePath = path.join(dir, "last-message.txt");
     }
     args.push("--output-last-message", lastMessagePath);
-    return { cmd: base.cmd, args, env, cwd: this.settings.cwd, lastMessagePath, schemaPath };
+    return { cmd: base.cmd, args, env, cwd: settings.cwd, lastMessagePath, schemaPath };
+  }
+  addConfigOverride(args, key, value) {
+    if (this.isPlainObject(value)) {
+      for (const [childKey, childValue] of Object.entries(value)) {
+        this.addConfigOverride(
+          args,
+          `${key}.${childKey}`,
+          childValue
+        );
+      }
+      return;
+    }
+    const serialized = this.serializeConfigValue(value);
+    args.push("-c", `${key}=${serialized}`);
+  }
+  /**
+   * Serialize a config override value into a CLI-safe string.
+   */
+  serializeConfigValue(value) {
+    if (typeof value === "string") return value;
+    if (typeof value === "number" || typeof value === "boolean") return String(value);
+    if (Array.isArray(value)) {
+      try {
+        return JSON.stringify(value);
+      } catch {
+        return String(value);
+      }
+    }
+    if (value && typeof value === "object") {
+      try {
+        return JSON.stringify(value);
+      } catch {
+        return String(value);
+      }
+    }
+    return String(value);
+  }
+  isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
   }
   sanitizeJsonSchema(value) {
     if (typeof value !== "object" || value === null) {
@@ -510,10 +631,17 @@ var CodexCliLanguageModel = class {
       ...this.mapWarnings(options),
       ...mappingWarnings?.map((m) => ({ type: "other", message: m })) || []
     ];
+    const providerOptions = await providerUtils.parseProviderOptions({
+      provider: this.provider,
+      providerOptions: options.providerOptions,
+      schema: codexCliProviderOptionsSchema
+    });
+    const effectiveSettings = this.mergeSettings(providerOptions);
     const responseFormat = options.responseFormat?.type === "json" ? { type: "json", schema: options.responseFormat.schema } : void 0;
     const { cmd, args, env, cwd, lastMessagePath, schemaPath } = this.buildArgs(
       promptText,
-      responseFormat
+      responseFormat,
+      effectiveSettings
     );
     let text = "";
     const usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
@@ -635,10 +763,17 @@ var CodexCliLanguageModel = class {
       ...this.mapWarnings(options),
       ...mappingWarnings?.map((m) => ({ type: "other", message: m })) || []
     ];
+    const providerOptions = await providerUtils.parseProviderOptions({
+      provider: this.provider,
+      providerOptions: options.providerOptions,
+      schema: codexCliProviderOptionsSchema
+    });
+    const effectiveSettings = this.mergeSettings(providerOptions);
     const responseFormat = options.responseFormat?.type === "json" ? { type: "json", schema: options.responseFormat.schema } : void 0;
     const { cmd, args, env, cwd, lastMessagePath, schemaPath } = this.buildArgs(
       promptText,
-      responseFormat
+      responseFormat,
+      effectiveSettings
     );
     const stream = new ReadableStream({
       start: (controller) => {

package/dist/index.d.cts

@@ -6,6 +6,15 @@ interface Logger {
 }
 type ApprovalMode = 'untrusted' | 'on-failure' | 'on-request' | 'never';
 type SandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access';
+type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
+/**
+ * Reasoning summary detail level.
+ * Note: The API error messages claim 'concise' and 'none' are valid, but they are
+ * actually rejected with 400 errors. Only 'auto' and 'detailed' work in practice.
+ */
+type ReasoningSummary = 'auto' | 'detailed';
+type ReasoningSummaryFormat = 'none' | 'experimental';
+type ModelVerbosity = 'low' | 'medium' | 'high';
 interface CodexCliSettings {
     codexPath?: string;
     cwd?: string;
@@ -20,10 +29,116 @@ interface CodexCliSettings {
     env?: Record<string, string>;
     verbose?: boolean;
     logger?: Logger | false;
+    /**
+     * Controls reasoning effort for reasoning-capable models (o3, o4-mini, gpt-5, gpt-5-codex).
+     * Higher effort produces more thorough reasoning at the cost of latency.
+     *
+     * Maps to: `-c model_reasoning_effort=<value>`
+     * @see https://platform.openai.com/docs/guides/reasoning
+     */
+    reasoningEffort?: ReasoningEffort;
+    /**
+     * Controls reasoning summary detail level.
+     *
+     * Valid values: 'auto' | 'detailed'
+     * Note: Despite API error messages claiming 'concise' and 'none' are valid,
+     * they are rejected with 400 errors in practice.
+     *
+     * Maps to: `-c model_reasoning_summary=<value>`
+     * @see https://platform.openai.com/docs/guides/reasoning#reasoning-summaries
+     */
+    reasoningSummary?: ReasoningSummary;
+    /**
+     * Controls reasoning summary format (experimental).
+     *
+     * Maps to: `-c model_reasoning_summary_format=<value>`
+     */
+    reasoningSummaryFormat?: ReasoningSummaryFormat;
+    /**
+     * Controls output length/detail for GPT-5 family models.
+     * Only applies to models using the Responses API.
+     *
+     * Maps to: `-c model_verbosity=<value>`
+     */
+    modelVerbosity?: ModelVerbosity;
+    /**
+     * Include experimental plan tool that the model can use to update its current plan.
+     *
+     * Maps to: `--include-plan-tool`
+     */
+    includePlanTool?: boolean;
+    /**
+     * Configuration profile from config.toml to specify default options.
+     *
+     * Maps to: `--profile <name>`
+     */
+    profile?: string;
+    /**
+     * Use OSS provider (experimental).
+     *
+     * Maps to: `--oss`
+     */
+    oss?: boolean;
+    /**
+     * Enable web search tool for the model.
+     *
+     * Maps to: `-c tools.web_search=true`
+     */
+    webSearch?: boolean;
+    /**
+     * Generic Codex CLI config overrides. Allows setting any config value
+     * without updating the provider.
+     *
+     * Each entry maps to: `-c <key>=<value>`
+     *
+     * Examples:
+     * - `{ experimental_resume: '/tmp/session.jsonl' }`
+     * - `{ 'model_providers.custom.base_url': 'http://localhost:8000' }`
+     * - `{ 'sandbox_workspace_write': { network_access: true } }`
+     *
+     * Values are serialized:
+     * - string → raw string
+     * - number/boolean → String(value)
+     * - plain objects → flattened recursively to dotted keys
+     * - arrays → JSON.stringify(value)
+     * - other objects (Date, RegExp, Map, etc.) → JSON.stringify(value)
+     */
+    configOverrides?: Record<string, string | number | boolean | object>;
 }
 interface CodexCliProviderSettings {
     defaultSettings?: CodexCliSettings;
 }
+/**
+ * Per-call overrides supplied through AI SDK providerOptions.
+ * These values take precedence over constructor-level CodexCliSettings.
+ */
+interface CodexCliProviderOptions {
+    /**
+     * Per-call override for reasoning depth.
+     * Maps to `model_reasoning_effort`.
+     */
+    reasoningEffort?: ReasoningEffort;
+    /**
+     * Per-call override for reasoning summary detail level.
+     * Maps to `model_reasoning_summary`.
+     */
+    reasoningSummary?: ReasoningSummary;
+    /**
+     * Per-call override for reasoning summary format.
+     * Maps to `model_reasoning_summary_format`.
+     */
+    reasoningSummaryFormat?: ReasoningSummaryFormat;
+    /**
+     * AI SDK naming for per-call verbosity overrides.
+     * Maps to Codex `model_verbosity`.
+     */
+    textVerbosity?: ModelVerbosity;
+    /**
+     * 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>;
+}
 
 interface CodexCliProvider extends ProviderV2 {
     (modelId: string, settings?: CodexCliSettings): LanguageModelV2;
@@ -51,8 +166,15 @@ declare class CodexCliLanguageModel implements LanguageModelV2 {
     private logger;
     private sessionId?;
     constructor(options: CodexLanguageModelOptions);
+    private mergeSettings;
     private getItemType;
     private buildArgs;
+    private addConfigOverride;
+    /**
+     * Serialize a config override value into a CLI-safe string.
+     */
+    private serializeConfigValue;
+    private isPlainObject;
     private sanitizeJsonSchema;
     private mapWarnings;
     private parseExperimentalJsonEvent;
@@ -70,4 +192,4 @@ declare class CodexCliLanguageModel implements LanguageModelV2 {
 
 declare function isAuthenticationError(err: unknown): boolean;
 
-export { CodexCliLanguageModel, type CodexCliProvider, type CodexCliProviderSettings, type CodexCliSettings, type Logger, codexCli, createCodexCli, isAuthenticationError };
+export { CodexCliLanguageModel, type CodexCliProvider, type CodexCliProviderOptions, type CodexCliProviderSettings, type CodexCliSettings, type Logger, type ModelVerbosity, type ReasoningEffort, type ReasoningSummary, type ReasoningSummaryFormat, codexCli, createCodexCli, isAuthenticationError };

package/dist/index.d.ts

@@ -6,6 +6,15 @@ interface Logger {
 }
 type ApprovalMode = 'untrusted' | 'on-failure' | 'on-request' | 'never';
 type SandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access';
+type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
+/**
+ * Reasoning summary detail level.
+ * Note: The API error messages claim 'concise' and 'none' are valid, but they are
+ * actually rejected with 400 errors. Only 'auto' and 'detailed' work in practice.
+ */
+type ReasoningSummary = 'auto' | 'detailed';
+type ReasoningSummaryFormat = 'none' | 'experimental';
+type ModelVerbosity = 'low' | 'medium' | 'high';
 interface CodexCliSettings {
     codexPath?: string;
     cwd?: string;
@@ -20,10 +29,116 @@ interface CodexCliSettings {
     env?: Record<string, string>;
     verbose?: boolean;
     logger?: Logger | false;
+    /**
+     * Controls reasoning effort for reasoning-capable models (o3, o4-mini, gpt-5, gpt-5-codex).
+     * Higher effort produces more thorough reasoning at the cost of latency.
+     *
+     * Maps to: `-c model_reasoning_effort=<value>`
+     * @see https://platform.openai.com/docs/guides/reasoning
+     */
+    reasoningEffort?: ReasoningEffort;
+    /**
+     * Controls reasoning summary detail level.
+     *
+     * Valid values: 'auto' | 'detailed'
+     * Note: Despite API error messages claiming 'concise' and 'none' are valid,
+     * they are rejected with 400 errors in practice.
+     *
+     * Maps to: `-c model_reasoning_summary=<value>`
+     * @see https://platform.openai.com/docs/guides/reasoning#reasoning-summaries
+     */
+    reasoningSummary?: ReasoningSummary;
+    /**
+     * Controls reasoning summary format (experimental).
+     *
+     * Maps to: `-c model_reasoning_summary_format=<value>`
+     */
+    reasoningSummaryFormat?: ReasoningSummaryFormat;
+    /**
+     * Controls output length/detail for GPT-5 family models.
+     * Only applies to models using the Responses API.
+     *
+     * Maps to: `-c model_verbosity=<value>`
+     */
+    modelVerbosity?: ModelVerbosity;
+    /**
+     * Include experimental plan tool that the model can use to update its current plan.
+     *
+     * Maps to: `--include-plan-tool`
+     */
+    includePlanTool?: boolean;
+    /**
+     * Configuration profile from config.toml to specify default options.
+     *
+     * Maps to: `--profile <name>`
+     */
+    profile?: string;
+    /**
+     * Use OSS provider (experimental).
+     *
+     * Maps to: `--oss`
+     */
+    oss?: boolean;
+    /**
+     * Enable web search tool for the model.
+     *
+     * Maps to: `-c tools.web_search=true`
+     */
+    webSearch?: boolean;
+    /**
+     * Generic Codex CLI config overrides. Allows setting any config value
+     * without updating the provider.
+     *
+     * Each entry maps to: `-c <key>=<value>`
+     *
+     * Examples:
+     * - `{ experimental_resume: '/tmp/session.jsonl' }`
+     * - `{ 'model_providers.custom.base_url': 'http://localhost:8000' }`
+     * - `{ 'sandbox_workspace_write': { network_access: true } }`
+     *
+     * Values are serialized:
+     * - string → raw string
+     * - number/boolean → String(value)
+     * - plain objects → flattened recursively to dotted keys
+     * - arrays → JSON.stringify(value)
+     * - other objects (Date, RegExp, Map, etc.) → JSON.stringify(value)
+     */
+    configOverrides?: Record<string, string | number | boolean | object>;
 }
 interface CodexCliProviderSettings {
     defaultSettings?: CodexCliSettings;
 }
+/**
+ * Per-call overrides supplied through AI SDK providerOptions.
+ * These values take precedence over constructor-level CodexCliSettings.
+ */
+interface CodexCliProviderOptions {
+    /**
+     * Per-call override for reasoning depth.
+     * Maps to `model_reasoning_effort`.
+     */
+    reasoningEffort?: ReasoningEffort;
+    /**
+     * Per-call override for reasoning summary detail level.
+     * Maps to `model_reasoning_summary`.
+     */
+    reasoningSummary?: ReasoningSummary;
+    /**
+     * Per-call override for reasoning summary format.
+     * Maps to `model_reasoning_summary_format`.
+     */
+    reasoningSummaryFormat?: ReasoningSummaryFormat;
+    /**
+     * AI SDK naming for per-call verbosity overrides.
+     * Maps to Codex `model_verbosity`.
+     */
+    textVerbosity?: ModelVerbosity;
+    /**
+     * 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>;
+}
 
 interface CodexCliProvider extends ProviderV2 {
     (modelId: string, settings?: CodexCliSettings): LanguageModelV2;
@@ -51,8 +166,15 @@ declare class CodexCliLanguageModel implements LanguageModelV2 {
     private logger;
     private sessionId?;
     constructor(options: CodexLanguageModelOptions);
+    private mergeSettings;
     private getItemType;
     private buildArgs;
+    private addConfigOverride;
+    /**
+     * Serialize a config override value into a CLI-safe string.
+     */
+    private serializeConfigValue;
+    private isPlainObject;
     private sanitizeJsonSchema;
     private mapWarnings;
     private parseExperimentalJsonEvent;
@@ -70,4 +192,4 @@ declare class CodexCliLanguageModel implements LanguageModelV2 {
 
 declare function isAuthenticationError(err: unknown): boolean;
 
-export { CodexCliLanguageModel, type CodexCliProvider, type CodexCliProviderSettings, type CodexCliSettings, type Logger, codexCli, createCodexCli, isAuthenticationError };
+export { CodexCliLanguageModel, type CodexCliProvider, type CodexCliProviderOptions, type CodexCliProviderSettings, type CodexCliSettings, type Logger, type ModelVerbosity, type ReasoningEffort, type ReasoningSummary, type ReasoningSummaryFormat, codexCli, createCodexCli, isAuthenticationError };

package/dist/index.js

@@ -5,8 +5,8 @@ import { createRequire } from 'module';
 import { mkdtempSync, writeFileSync, rmSync, readFileSync } from 'fs';
 import { tmpdir } from 'os';
 import { join, dirname } from 'path';
-import { generateId } from '@ai-sdk/provider-utils';
 import { z } from 'zod';
+import { parseProviderOptions, generateId } from '@ai-sdk/provider-utils';
 
 // src/codex-cli-provider.ts
 
@@ -38,7 +38,29 @@ var settingsSchema = z.object({
   allowNpx: z.boolean().optional(),
   env: z.record(z.string(), z.string()).optional(),
   verbose: z.boolean().optional(),
-  logger: z.any().optional()
+  logger: z.any().optional(),
+  // NEW: Reasoning & Verbosity
+  reasoningEffort: z.enum(["minimal", "low", "medium", "high"]).optional(),
+  // Note: API rejects 'concise' and 'none' despite error messages claiming they're valid
+  reasoningSummary: z.enum(["auto", "detailed"]).optional(),
+  reasoningSummaryFormat: z.enum(["none", "experimental"]).optional(),
+  modelVerbosity: z.enum(["low", "medium", "high"]).optional(),
+  // NEW: Advanced features
+  includePlanTool: z.boolean().optional(),
+  profile: z.string().optional(),
+  oss: z.boolean().optional(),
+  webSearch: z.boolean().optional(),
+  // NEW: Generic overrides
+  configOverrides: z.record(
+    z.string(),
+    z.union([
+      z.string(),
+      z.number(),
+      z.boolean(),
+      z.object({}).passthrough(),
+      z.array(z.any())
+    ])
+  ).optional()
 }).strict();
 function validateSettings(settings) {
   const warnings = [];
@@ -166,6 +188,22 @@ function isAuthenticationError(err) {
 }
 
 // src/codex-cli-language-model.ts
+var codexCliProviderOptionsSchema = z.object({
+  reasoningEffort: z.enum(["minimal", "low", "medium", "high"]).optional(),
+  reasoningSummary: z.enum(["auto", "detailed"]).optional(),
+  reasoningSummaryFormat: z.enum(["none", "experimental"]).optional(),
+  textVerbosity: z.enum(["low", "medium", "high"]).optional(),
+  configOverrides: z.record(
+    z.string(),
+    z.union([
+      z.string(),
+      z.number(),
+      z.boolean(),
+      z.object({}).passthrough(),
+      z.array(z.any())
+    ])
+  ).optional()
+}).strict();
 function resolveCodexPath(explicitPath, allowNpx) {
   if (explicitPath) return { cmd: "node", args: [explicitPath] };
   try {
@@ -199,6 +237,21 @@ var CodexCliLanguageModel = class {
     const warn = validateModelId(this.modelId);
     if (warn) this.logger.warn(`Codex CLI model: ${warn}`);
   }
+  mergeSettings(providerOptions) {
+    if (!providerOptions) return this.settings;
+    const mergedConfigOverrides = providerOptions.configOverrides || this.settings.configOverrides ? {
+      ...this.settings.configOverrides ?? {},
+      ...providerOptions.configOverrides ?? {}
+    } : void 0;
+    return {
+      ...this.settings,
+      reasoningEffort: providerOptions.reasoningEffort ?? this.settings.reasoningEffort,
+      reasoningSummary: providerOptions.reasoningSummary ?? this.settings.reasoningSummary,
+      reasoningSummaryFormat: providerOptions.reasoningSummaryFormat ?? this.settings.reasoningSummaryFormat,
+      modelVerbosity: providerOptions.textVerbosity ?? this.settings.modelVerbosity,
+      configOverrides: mergedConfigOverrides
+    };
+  }
   // Codex JSONL items use `type` for the item discriminator, but some
   // earlier fixtures (and defensive parsing) might still surface `item_type`.
   // This helper returns whichever is present.
@@ -209,28 +262,57 @@ var CodexCliLanguageModel = class {
     const current = typeof data.type === "string" ? data.type : void 0;
     return legacy ?? current;
   }
-  buildArgs(promptText, responseFormat) {
-    const base = resolveCodexPath(this.settings.codexPath, this.settings.allowNpx);
+  buildArgs(promptText, responseFormat, settings = this.settings) {
+    const base = resolveCodexPath(settings.codexPath, settings.allowNpx);
     const args = [...base.args, "exec", "--experimental-json"];
-    if (this.settings.fullAuto) {
+    if (settings.fullAuto) {
       args.push("--full-auto");
-    } else if (this.settings.dangerouslyBypassApprovalsAndSandbox) {
+    } else if (settings.dangerouslyBypassApprovalsAndSandbox) {
       args.push("--dangerously-bypass-approvals-and-sandbox");
     } else {
-      const approval = this.settings.approvalMode ?? "on-failure";
+      const approval = settings.approvalMode ?? "on-failure";
       args.push("-c", `approval_policy=${approval}`);
-      const sandbox = this.settings.sandboxMode ?? "workspace-write";
+      const sandbox = settings.sandboxMode ?? "workspace-write";
       args.push("-c", `sandbox_mode=${sandbox}`);
     }
-    if (this.settings.skipGitRepoCheck !== false) {
+    if (settings.skipGitRepoCheck !== false) {
       args.push("--skip-git-repo-check");
     }
-    if (this.settings.color) {
-      args.push("--color", this.settings.color);
+    if (settings.reasoningEffort) {
+      args.push("-c", `model_reasoning_effort=${settings.reasoningEffort}`);
+    }
+    if (settings.reasoningSummary) {
+      args.push("-c", `model_reasoning_summary=${settings.reasoningSummary}`);
+    }
+    if (settings.reasoningSummaryFormat) {
+      args.push("-c", `model_reasoning_summary_format=${settings.reasoningSummaryFormat}`);
+    }
+    if (settings.modelVerbosity) {
+      args.push("-c", `model_verbosity=${settings.modelVerbosity}`);
+    }
+    if (settings.includePlanTool) {
+      args.push("--include-plan-tool");
+    }
+    if (settings.profile) {
+      args.push("--profile", settings.profile);
+    }
+    if (settings.oss) {
+      args.push("--oss");
+    }
+    if (settings.webSearch) {
+      args.push("-c", "tools.web_search=true");
+    }
+    if (settings.color) {
+      args.push("--color", settings.color);
     }
     if (this.modelId) {
       args.push("-m", this.modelId);
     }
+    if (settings.configOverrides) {
+      for (const [key, value] of Object.entries(settings.configOverrides)) {
+        this.addConfigOverride(args, key, value);
+      }
+    }
     let schemaPath;
     if (responseFormat?.type === "json" && responseFormat.schema) {
       const schema = typeof responseFormat.schema === "object" ? responseFormat.schema : {};
@@ -250,16 +332,55 @@ var CodexCliLanguageModel = class {
     args.push(promptText);
     const env = {
       ...process.env,
-      ...this.settings.env || {},
+      ...settings.env || {},
       RUST_LOG: process.env.RUST_LOG || "error"
     };
-    let lastMessagePath = this.settings.outputLastMessageFile;
+    let lastMessagePath = settings.outputLastMessageFile;
     if (!lastMessagePath) {
       const dir = mkdtempSync(join(tmpdir(), "codex-cli-"));
       lastMessagePath = join(dir, "last-message.txt");
     }
     args.push("--output-last-message", lastMessagePath);
-    return { cmd: base.cmd, args, env, cwd: this.settings.cwd, lastMessagePath, schemaPath };
+    return { cmd: base.cmd, args, env, cwd: settings.cwd, lastMessagePath, schemaPath };
+  }
+  addConfigOverride(args, key, value) {
+    if (this.isPlainObject(value)) {
+      for (const [childKey, childValue] of Object.entries(value)) {
+        this.addConfigOverride(
+          args,
+          `${key}.${childKey}`,
+          childValue
+        );
+      }
+      return;
+    }
+    const serialized = this.serializeConfigValue(value);
+    args.push("-c", `${key}=${serialized}`);
+  }
+  /**
+   * Serialize a config override value into a CLI-safe string.
+   */
+  serializeConfigValue(value) {
+    if (typeof value === "string") return value;
+    if (typeof value === "number" || typeof value === "boolean") return String(value);
+    if (Array.isArray(value)) {
+      try {
+        return JSON.stringify(value);
+      } catch {
+        return String(value);
+      }
+    }
+    if (value && typeof value === "object") {
+      try {
+        return JSON.stringify(value);
+      } catch {
+        return String(value);
+      }
+    }
+    return String(value);
+  }
+  isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
   }
   sanitizeJsonSchema(value) {
     if (typeof value !== "object" || value === null) {
@@ -507,10 +628,17 @@ var CodexCliLanguageModel = class {
       ...this.mapWarnings(options),
       ...mappingWarnings?.map((m) => ({ type: "other", message: m })) || []
     ];
+    const providerOptions = await parseProviderOptions({
+      provider: this.provider,
+      providerOptions: options.providerOptions,
+      schema: codexCliProviderOptionsSchema
+    });
+    const effectiveSettings = this.mergeSettings(providerOptions);
     const responseFormat = options.responseFormat?.type === "json" ? { type: "json", schema: options.responseFormat.schema } : void 0;
     const { cmd, args, env, cwd, lastMessagePath, schemaPath } = this.buildArgs(
       promptText,
-      responseFormat
+      responseFormat,
+      effectiveSettings
     );
     let text = "";
     const usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
@@ -632,10 +760,17 @@ var CodexCliLanguageModel = class {
       ...this.mapWarnings(options),
       ...mappingWarnings?.map((m) => ({ type: "other", message: m })) || []
     ];
+    const providerOptions = await parseProviderOptions({
+      provider: this.provider,
+      providerOptions: options.providerOptions,
+      schema: codexCliProviderOptionsSchema
+    });
+    const effectiveSettings = this.mergeSettings(providerOptions);
     const responseFormat = options.responseFormat?.type === "json" ? { type: "json", schema: options.responseFormat.schema } : void 0;
     const { cmd, args, env, cwd, lastMessagePath, schemaPath } = this.buildArgs(
       promptText,
-      responseFormat
+      responseFormat,
+      effectiveSettings
     );
     const stream = new ReadableStream({
       start: (controller) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sdk-provider-codex-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "AI SDK v5 provider for OpenAI Codex CLI with native JSON Schema support",
   "keywords": [
     "ai-sdk",