fix: fix schema for codex and codex mcp

Author: kevinwang5658

package.json

@@ -1,6 +1,6 @@
 {
   "name": "default",
-  "version": "1.12.0",
+  "version": "1.13.0-beta.3",
   "description": "Default plugin for Codify - provides 50+ declarative resources for managing development tools and system configuration across macOS and Linux",
   "main": "dist/index.js",
   "scripts": {

src/resources/codex/codex.ts

@@ -16,10 +16,66 @@ import { CodexConfigParameter } from './config-parameter.js';
 import { codexMcpServerSchema } from './mcp-server-schema.js';
 import { CodexMcpServersParameter } from './mcp-servers-parameter.js';
 
+const codexConfigSchema = z
+  .object({
+    model: z.string().optional().describe('Model name to use (e.g. "o4-mini", "gpt-4.1").'),
+    model_provider: z.string().optional().describe('Provider for the model (e.g. "openai", "anthropic", "gemini").'),
+    model_reasoning_effort: z
+      .enum(['minimal', 'low', 'medium', 'high', 'xhigh'])
+      .optional()
+      .describe('Reasoning effort level for supported models.'),
+    model_reasoning_summary: z
+      .enum(['auto', 'concise', 'detailed', 'none'])
+      .optional()
+      .describe('How much detail to include in reasoning summaries.'),
+    approval_policy: z
+      .enum(['untrusted', 'on-request', 'never'])
+      .optional()
+      .describe(
+        'When Codex asks for approval before running commands. ' +
+        '"untrusted" auto-approves known-safe read-only commands; "on-request" lets the model decide; "never" auto-approves everything.',
+      ),
+    sandbox_mode: z
+      .enum(['read-only', 'workspace-write', 'danger-full-access'])
+      .optional()
+      .describe('Sandbox policy controlling what filesystem writes are allowed.'),
+    sandbox_workspace_write: z
+      .boolean()
+      .optional()
+      .describe('Allow writes within the workspace directory when sandbox_mode is active.'),
+    web_search: z
+      .enum(['disabled', 'cached', 'live'])
+      .optional()
+      .describe(
+        'Web search access for the agent. "cached" uses an OpenAI-maintained index (default); ' +
+        '"live" fetches the most recent data; "disabled" removes the tool.',
+      ),
+    shell_environment_policy: z
+      .object({
+        inherit: z.enum(['all', 'core', 'none']).optional(),
+      })
+      .optional()
+      .describe(
+        'Which shell environment variables to inherit. "all" passes everything through; ' +
+        '"core" keeps PATH and a minimal set; "none" starts with an empty environment.',
+      ),
+    history: z
+      .object({
+        persistence: z.enum(['save-all', 'none']).optional(),
+      })
+      .optional()
+      .describe('Session history settings. Set persistence to "save-all" to keep history or "none" to disable it.'),
+    file_opener: z
+      .enum(['vscode', 'vscode-insiders', 'windsurf', 'cursor', 'none'])
+      .optional()
+      .describe('Editor used when Codex opens a file.'),
+  })
+  .catchall(z.unknown())
+  .describe('Typed Codex config keys. Unknown keys are passed through as-is.');
+
 const schema = z
   .object({
-    config: z
-      .record(z.string(), z.unknown())
+    config: codexConfigSchema
       .optional()
       .describe(
         'Settings to merge into ~/.codex/config.toml. Supports model, model_provider, approval_policy, ' +
@@ -47,26 +103,27 @@ const exampleSettings: ExampleConfig = {
     {
       type: 'codex',
       config: {
-        model: 'gpt-5.1-codex',
-        approval_policy: 'on-request',
+        model: 'o4-mini',
+        approval_policy: 'untrusted',
         sandbox_mode: 'workspace-write',
+        web_search: 'cached',
       },
     },
   ],
 };
 
 const exampleWithMcp: ExampleConfig = {
   title: 'Codex with an MCP server',
-  description: 'Install the Codex CLI and register a filesystem MCP server available to every project.',
+  description: 'Install the Codex CLI and register a custom MCP server available to every project.',
   configs: [
     {
       type: 'codex',
       mcpServers: [
         {
-          name: 'filesystem',
+          name: 'my-mcp-server',
           type: 'stdio',
           command: 'npx',
-          args: ['-y', '@modelcontextprotocol/server-filesystem', '/tmp'],
+          args: ['-y', 'my-mcp-package'],
         },
       ],
     },

src/resources/codex/mcp-server-schema.ts

@@ -4,7 +4,7 @@ const codexMcpStdioServerSchema = z.object({
   name: z.string().describe('Unique name for this MCP server'),
   type: z.literal('stdio'),
   command: z.string().describe('Executable or command used to launch the MCP server process'),
-  args: z.array(z.string()).optional().describe('Arguments passed to the command'),
+  args: z.array(z.string()).optional().describe('Arguments passed to the command. Shell variable expansion (e.g. $HOME) does not occur — use absolute paths instead.'),
   env: z.record(z.string(), z.string()).optional().describe('Static environment variables passed to the server process'),
   envVars: z.array(z.string()).optional().describe('Names of environment variables forwarded from the Codex process environment'),
   cwd: z.string().optional().describe('Working directory for the server process'),