@cjhyy/code-shell-core 0.5.0-rc.1 → 0.5.0-rc.2

package/dist/settings/schema.d.ts

@@ -2,6 +2,38 @@
  * Settings schema with Zod validation.
  */
 import { z } from "zod";
+/**
+ * Tri-state project capability overlay. Lives in PROJECT settings only and
+ * layers over the global baseline (disabledSkills / disabledPlugins /
+ * mcpServers.<name>.enabled / disabledAgents). NOT a second denylist:
+ *   - "on"      → force enabled (even if globally disabled)
+ *   - "off"     → force disabled (even if globally enabled)
+ *   - "inherit" → take the global baseline. We don't persist "inherit"; an
+ *                 absent key means inherit. See the project-scoped
+ *                 capabilities design (spec §4).
+ */
+export declare const CapabilityOverrideSchema: z.ZodEnum<["inherit", "on", "off"]>;
+export type CapabilityOverride = z.infer<typeof CapabilityOverrideSchema>;
+export declare const CapabilityOverridesSchema: z.ZodOptional<z.ZodObject<{
+    skills: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+    plugins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+    agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+    mcp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+    builtin: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+}, "strip", z.ZodTypeAny, {
+    builtin?: Record<string, "off" | "on" | "inherit"> | undefined;
+    mcp?: Record<string, "off" | "on" | "inherit"> | undefined;
+    skills?: Record<string, "off" | "on" | "inherit"> | undefined;
+    plugins?: Record<string, "off" | "on" | "inherit"> | undefined;
+    agents?: Record<string, "off" | "on" | "inherit"> | undefined;
+}, {
+    builtin?: Record<string, "off" | "on" | "inherit"> | undefined;
+    mcp?: Record<string, "off" | "on" | "inherit"> | undefined;
+    skills?: Record<string, "off" | "on" | "inherit"> | undefined;
+    plugins?: Record<string, "off" | "on" | "inherit"> | undefined;
+    agents?: Record<string, "off" | "on" | "inherit"> | undefined;
+}>>;
+export type CapabilityOverrides = z.infer<typeof CapabilityOverridesSchema>;
 export declare const SettingsSchema: z.ZodObject<{
     agent: z.ZodDefault<z.ZodObject<{
         preset: z.ZodDefault<z.ZodString>;
@@ -9,18 +41,42 @@ export declare const SettingsSchema: z.ZodObject<{
         disabledBuiltinTools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         customSystemPrompt: z.ZodOptional<z.ZodString>;
         appendSystemPrompt: z.ZodOptional<z.ZodString>;
+        responseLanguage: z.ZodOptional<z.ZodString>;
+        userProfile: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodObject<{
+            compatClaude: z.ZodDefault<z.ZodBoolean>;
+            compatCodex: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            compatClaude: boolean;
+            compatCodex: boolean;
+        }, {
+            compatClaude?: boolean | undefined;
+            compatCodex?: boolean | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         preset: string;
         enabledBuiltinTools: string[];
         disabledBuiltinTools: string[];
         customSystemPrompt?: string | undefined;
         appendSystemPrompt?: string | undefined;
+        responseLanguage?: string | undefined;
+        userProfile?: string | undefined;
+        instructions?: {
+            compatClaude: boolean;
+            compatCodex: boolean;
+        } | undefined;
     }, {
         preset?: string | undefined;
         enabledBuiltinTools?: string[] | undefined;
         disabledBuiltinTools?: string[] | undefined;
         customSystemPrompt?: string | undefined;
         appendSystemPrompt?: string | undefined;
+        responseLanguage?: string | undefined;
+        userProfile?: string | undefined;
+        instructions?: {
+            compatClaude?: boolean | undefined;
+            compatCodex?: boolean | undefined;
+        } | undefined;
     }>>;
     /**
      * Primary source of truth for the active model is settings.activeKey
@@ -30,6 +86,15 @@ export declare const SettingsSchema: z.ZodObject<{
      * both — appendOnboardingResult does this in one shot.
      */
     activeKey: z.ZodOptional<z.ZodString>;
+    /**
+     * Auxiliary-task model — points at a models[].key. Background, non-user-
+     * facing LLM calls (memory extraction, the auto-dream loop) use this model
+     * instead of the active one, so per-turn book-keeping doesn't burn the
+     * expensive primary model. Pick something fast/cheap (e.g. a Haiku or
+     * DeepSeek key). When unset, those calls fall back to the active model
+     * (legacy behavior). An invalid/missing key also falls back to active.
+     */
+    auxModelKey: z.ZodOptional<z.ZodString>;
     /**
      * Toggle background auto-update. When true (default), code-shell checks
      * npm for newer versions and — if the npm global prefix is writable —
@@ -46,16 +111,16 @@ export declare const SettingsSchema: z.ZodObject<{
         temperature: z.ZodDefault<z.ZodNumber>;
         maxTokens: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        provider: string;
-        name: string;
         temperature: number;
+        name: string;
+        provider: string;
         baseUrl: string;
         maxTokens: number;
         apiKey?: string | undefined;
     }, {
-        provider?: string | undefined;
-        name?: string | undefined;
         temperature?: number | undefined;
+        name?: string | undefined;
+        provider?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         maxTokens?: number | undefined;
@@ -69,26 +134,75 @@ export declare const SettingsSchema: z.ZodObject<{
         protocol: z.ZodOptional<z.ZodEnum<["openai-compat", "anthropic-style"]>>;
         modelsPath: z.ZodOptional<z.ZodString>;
         /**
-         * DeepSeek V4 thinking-mode default for this provider. "enabled"
-         * matches endpoint default; "disabled" makes V4 calls run in
-         * non-thinking mode (faster, cheaper). Ignored by every provider
-         * other than DeepSeek V4. Per-call overrides still win.
+         * Default reasoning/thinking setting for this provider's models.
+         * Rich shape: {mode:"off"|"on"} | {mode:"effort",effort} |
+         * {mode:"budget",budgetTokens}. Per-model `reasoning` wins.
          */
-        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
+        reasoning: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"off">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "off";
+        }, {
+            mode: "off";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"on">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "on";
+        }, {
+            mode: "on";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"effort">;
+            effort: z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"budget">;
+            budgetTokens: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mode: "budget";
+            budgetTokens: number;
+        }, {
+            mode: "budget";
+            budgetTokens: number;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         key: string;
-        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
+        kind: "openai" | "anthropic" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         baseUrl: string;
-        thinking?: "enabled" | "disabled" | undefined;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
         modelsPath?: string | undefined;
     }, {
         key: string;
-        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
+        kind: "openai" | "anthropic" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         baseUrl: string;
-        thinking?: "enabled" | "disabled" | undefined;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
@@ -112,59 +226,129 @@ export declare const SettingsSchema: z.ZodObject<{
         baseUrl: z.ZodOptional<z.ZodString>;
         apiKey: z.ZodOptional<z.ZodString>;
         /**
-         * Per-model thinking override. Wins over the provider-level
-         * setting (settings.providers[].thinking). Use this when
-         * different models under the same provider need different
-         * defaults — e.g. DeepSeek V4 Pro off (faster) but V4 Flash on.
+         * Per-model reasoning override. Wins over the provider-level
+         * `reasoning` setting (settings.providers[].reasoning). Use this
+         * when different models under the same provider need different
+         * defaults — e.g. one model off (faster) and another on.
          */
-        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
+        reasoning: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"off">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "off";
+        }, {
+            mode: "off";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"on">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "on";
+        }, {
+            mode: "on";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"effort">;
+            effort: z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"budget">;
+            budgetTokens: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mode: "budget";
+            budgetTokens: number;
+        }, {
+            mode: "budget";
+            budgetTokens: number;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
-        model: string;
         key: string;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         provider?: string | undefined;
-        thinking?: "enabled" | "disabled" | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         protocol?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }, {
-        model: string;
         key: string;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         provider?: string | undefined;
-        thinking?: "enabled" | "disabled" | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         protocol?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }>, {
         protocol: string | undefined;
         provider: string | undefined;
-        model: string;
         key: string;
-        thinking?: "enabled" | "disabled" | undefined;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }, {
-        model: string;
         key: string;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         provider?: string | undefined;
-        thinking?: "enabled" | "disabled" | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         protocol?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }>, "many">>;
     permissions: z.ZodDefault<z.ZodObject<{
@@ -186,7 +370,7 @@ export declare const SettingsSchema: z.ZodObject<{
             argsPattern?: Record<string, string> | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        defaultMode: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan";
+        defaultMode: "auto" | "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "plan";
         rules: {
             tool: string;
             decision: "allow" | "deny" | "ask";
@@ -194,7 +378,7 @@ export declare const SettingsSchema: z.ZodObject<{
             argsPattern?: Record<string, string> | undefined;
         }[];
     }, {
-        defaultMode?: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan" | undefined;
+        defaultMode?: "auto" | "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "plan" | undefined;
         rules?: {
             tool: string;
             decision: "allow" | "deny" | "ask";
@@ -233,20 +417,23 @@ export declare const SettingsSchema: z.ZodObject<{
         url: z.ZodOptional<z.ZodString>;
         transport: z.ZodOptional<z.ZodEnum<["stdio", "sse", "streamable-http", "inprocess"]>>;
         headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         name: string;
+        enabled?: boolean | undefined;
         url?: string | undefined;
         args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         transport?: "stdio" | "sse" | "streamable-http" | "inprocess" | undefined;
         headers?: Record<string, string> | undefined;
     }, {
         name: string;
+        enabled?: boolean | undefined;
         url?: string | undefined;
         args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         transport?: "stdio" | "sse" | "streamable-http" | "inprocess" | undefined;
         headers?: Record<string, string> | undefined;
     }>>>;
@@ -264,6 +451,38 @@ export declare const SettingsSchema: z.ZodObject<{
      * names (no colon suffix). See scanSkills(opts.disabledPlugins).
      */
     disabledPlugins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Sub-agent role names (the `name` in .code-shell/agents/*.md) to
+     * hide from the registry. A disabled role is filtered out at load
+     * so it never appears in registry.list()/get() — the Agent tool's
+     * agent_type list won't show it and the LLM can't pick it. Mirrors
+     * disabledSkills / disabledPlugins.
+     */
+    disabledAgents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Project-scoped tri-state capability overlay. Only meaningful in
+     * ${cwd}/.code-shell/settings.json; layered over the global baseline at
+     * capability-assembly time. Optional — absence === everything inherits.
+     */
+    capabilityOverrides: z.ZodOptional<z.ZodObject<{
+        skills: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        plugins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        mcp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        builtin: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        builtin?: Record<string, "off" | "on" | "inherit"> | undefined;
+        mcp?: Record<string, "off" | "on" | "inherit"> | undefined;
+        skills?: Record<string, "off" | "on" | "inherit"> | undefined;
+        plugins?: Record<string, "off" | "on" | "inherit"> | undefined;
+        agents?: Record<string, "off" | "on" | "inherit"> | undefined;
+    }, {
+        builtin?: Record<string, "off" | "on" | "inherit"> | undefined;
+        mcp?: Record<string, "off" | "on" | "inherit"> | undefined;
+        skills?: Record<string, "off" | "on" | "inherit"> | undefined;
+        plugins?: Record<string, "off" | "on" | "inherit"> | undefined;
+        agents?: Record<string, "off" | "on" | "inherit"> | undefined;
+    }>>;
     instructions: z.ZodDefault<z.ZodObject<{
         fileName: z.ZodDefault<z.ZodString>;
         scanDirs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -288,30 +507,30 @@ export declare const SettingsSchema: z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
             baseUrl: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
         }, {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
         }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         participants: (string | {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
         })[];
     }, {
         participants?: (string | {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
@@ -331,12 +550,45 @@ export declare const SettingsSchema: z.ZodObject<{
         providers: z.ZodOptional<z.ZodRecord<z.ZodEnum<["serper", "tavily", "searxng"]>, z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
             baseUrl: z.ZodOptional<z.ZodString>;
+            lastProbe: z.ZodOptional<z.ZodObject<{
+                status: z.ZodEnum<["ok", "error", "unconfigured"]>;
+                sampleTitles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                errorMessage: z.ZodOptional<z.ZodString>;
+                errorDetail: z.ZodOptional<z.ZodString>;
+                lastProbedAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            }, {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }, {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }>>>;
     }, "strip", z.ZodTypeAny, {
         provider: "serper" | "tavily" | "searxng";
@@ -345,6 +597,13 @@ export declare const SettingsSchema: z.ZodObject<{
         providers?: Partial<Record<"serper" | "tavily" | "searxng", {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }>> | undefined;
     }, {
         provider?: "serper" | "tavily" | "searxng" | undefined;
@@ -353,6 +612,13 @@ export declare const SettingsSchema: z.ZodObject<{
         providers?: Partial<Record<"serper" | "tavily" | "searxng", {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }>> | undefined;
     }>>;
     output: z.ZodDefault<z.ZodObject<{
@@ -362,6 +628,28 @@ export declare const SettingsSchema: z.ZodObject<{
     }, {
         format?: "text" | "json" | "jsonl" | "stream-json" | undefined;
     }>>;
+    /**
+     * Image attachment handling. Sub-fields:
+     *   - detail: OpenAI-style fidelity hint applied to every user-
+     *     attached image. "low" = 85 tokens/image fixed (cheap
+     *     thumbnail), "high" = ~768 px tiles (default), "original" =
+     *     keep client-side dimensions (most expensive). Anthropic
+     *     ignores this field today; that's fine — it just gets
+     *     dropped on the Claude path.
+     *   - mcpImageTokenBudget: per-turn cap on token cost of images
+     *     returned by MCP tools. Codex doesn't enforce this; CC uses
+     *     25 000. Set to 0 to disable.
+     */
+    images: z.ZodOptional<z.ZodObject<{
+        detail: z.ZodOptional<z.ZodEnum<["low", "high", "original"]>>;
+        mcpImageTokenBudget: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        detail?: "low" | "high" | "original" | undefined;
+        mcpImageTokenBudget?: number | undefined;
+    }, {
+        detail?: "low" | "high" | "original" | undefined;
+        mcpImageTokenBudget?: number | undefined;
+    }>>;
     /**
      * OS-level sandbox for shell-tool execution. "auto" picks per platform:
      * Seatbelt on macOS, bubblewrap on Linux when installed, otherwise off.
@@ -374,16 +662,88 @@ export declare const SettingsSchema: z.ZodObject<{
         deniedReads: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         network: z.ZodOptional<z.ZodEnum<["allow", "deny"]>>;
     }, "strip", z.ZodTypeAny, {
-        mode?: "auto" | "seatbelt" | "bwrap" | "off" | undefined;
+        mode?: "auto" | "off" | "seatbelt" | "bwrap" | undefined;
         writableRoots?: string[] | undefined;
         deniedReads?: string[] | undefined;
         network?: "allow" | "deny" | undefined;
     }, {
-        mode?: "auto" | "seatbelt" | "bwrap" | "off" | undefined;
+        mode?: "auto" | "off" | "seatbelt" | "bwrap" | undefined;
         writableRoots?: string[] | undefined;
         deniedReads?: string[] | undefined;
         network?: "allow" | "deny" | undefined;
     }>>;
+    /**
+     * Project-local environment profile. Mirrors Codex's local-environment
+     * shape at the settings layer: setup/cleanup scripts can be customized per
+     * platform, and env values are stored as KEY=VALUE pairs. Runtime wiring is
+     * intentionally separate from the MCP server env model above.
+     */
+    localEnvironment: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        setupScripts: z.ZodOptional<z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            macos: z.ZodOptional<z.ZodString>;
+            linux: z.ZodOptional<z.ZodString>;
+            windows: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }>>;
+        cleanupScripts: z.ZodOptional<z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            macos: z.ZodOptional<z.ZodString>;
+            linux: z.ZodOptional<z.ZodString>;
+            windows: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        env?: Record<string, string> | undefined;
+        setupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+        cleanupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+    }, {
+        name?: string | undefined;
+        env?: Record<string, string> | undefined;
+        setupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+        cleanupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+    }>>;
     /**
      * Shell-hook configuration. Each entry binds a HookEventName to a
      * shell command; the command receives ctx JSON on stdin and returns
@@ -403,15 +763,15 @@ export declare const SettingsSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         command: string;
         event: string;
-        cwd?: string | undefined;
         matcher?: string | undefined;
         timeout_ms?: number | undefined;
+        cwd?: string | undefined;
     }, {
         command: string;
         event: string;
-        cwd?: string | undefined;
         matcher?: string | undefined;
         timeout_ms?: number | undefined;
+        cwd?: string | undefined;
     }>, "many">>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     agent: z.ZodDefault<z.ZodObject<{
@@ -420,18 +780,42 @@ export declare const SettingsSchema: z.ZodObject<{
         disabledBuiltinTools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         customSystemPrompt: z.ZodOptional<z.ZodString>;
         appendSystemPrompt: z.ZodOptional<z.ZodString>;
+        responseLanguage: z.ZodOptional<z.ZodString>;
+        userProfile: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodObject<{
+            compatClaude: z.ZodDefault<z.ZodBoolean>;
+            compatCodex: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            compatClaude: boolean;
+            compatCodex: boolean;
+        }, {
+            compatClaude?: boolean | undefined;
+            compatCodex?: boolean | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         preset: string;
         enabledBuiltinTools: string[];
         disabledBuiltinTools: string[];
         customSystemPrompt?: string | undefined;
         appendSystemPrompt?: string | undefined;
+        responseLanguage?: string | undefined;
+        userProfile?: string | undefined;
+        instructions?: {
+            compatClaude: boolean;
+            compatCodex: boolean;
+        } | undefined;
     }, {
         preset?: string | undefined;
         enabledBuiltinTools?: string[] | undefined;
         disabledBuiltinTools?: string[] | undefined;
         customSystemPrompt?: string | undefined;
         appendSystemPrompt?: string | undefined;
+        responseLanguage?: string | undefined;
+        userProfile?: string | undefined;
+        instructions?: {
+            compatClaude?: boolean | undefined;
+            compatCodex?: boolean | undefined;
+        } | undefined;
     }>>;
     /**
      * Primary source of truth for the active model is settings.activeKey
@@ -441,6 +825,15 @@ export declare const SettingsSchema: z.ZodObject<{
      * both — appendOnboardingResult does this in one shot.
      */
     activeKey: z.ZodOptional<z.ZodString>;
+    /**
+     * Auxiliary-task model — points at a models[].key. Background, non-user-
+     * facing LLM calls (memory extraction, the auto-dream loop) use this model
+     * instead of the active one, so per-turn book-keeping doesn't burn the
+     * expensive primary model. Pick something fast/cheap (e.g. a Haiku or
+     * DeepSeek key). When unset, those calls fall back to the active model
+     * (legacy behavior). An invalid/missing key also falls back to active.
+     */
+    auxModelKey: z.ZodOptional<z.ZodString>;
     /**
      * Toggle background auto-update. When true (default), code-shell checks
      * npm for newer versions and — if the npm global prefix is writable —
@@ -457,16 +850,16 @@ export declare const SettingsSchema: z.ZodObject<{
         temperature: z.ZodDefault<z.ZodNumber>;
         maxTokens: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        provider: string;
-        name: string;
         temperature: number;
+        name: string;
+        provider: string;
         baseUrl: string;
         maxTokens: number;
         apiKey?: string | undefined;
     }, {
-        provider?: string | undefined;
-        name?: string | undefined;
         temperature?: number | undefined;
+        name?: string | undefined;
+        provider?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         maxTokens?: number | undefined;
@@ -480,26 +873,75 @@ export declare const SettingsSchema: z.ZodObject<{
         protocol: z.ZodOptional<z.ZodEnum<["openai-compat", "anthropic-style"]>>;
         modelsPath: z.ZodOptional<z.ZodString>;
         /**
-         * DeepSeek V4 thinking-mode default for this provider. "enabled"
-         * matches endpoint default; "disabled" makes V4 calls run in
-         * non-thinking mode (faster, cheaper). Ignored by every provider
-         * other than DeepSeek V4. Per-call overrides still win.
+         * Default reasoning/thinking setting for this provider's models.
+         * Rich shape: {mode:"off"|"on"} | {mode:"effort",effort} |
+         * {mode:"budget",budgetTokens}. Per-model `reasoning` wins.
          */
-        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
+        reasoning: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"off">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "off";
+        }, {
+            mode: "off";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"on">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "on";
+        }, {
+            mode: "on";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"effort">;
+            effort: z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"budget">;
+            budgetTokens: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mode: "budget";
+            budgetTokens: number;
+        }, {
+            mode: "budget";
+            budgetTokens: number;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         key: string;
-        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
+        kind: "openai" | "anthropic" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         baseUrl: string;
-        thinking?: "enabled" | "disabled" | undefined;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
         modelsPath?: string | undefined;
     }, {
         key: string;
-        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
+        kind: "openai" | "anthropic" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         baseUrl: string;
-        thinking?: "enabled" | "disabled" | undefined;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
@@ -523,59 +965,129 @@ export declare const SettingsSchema: z.ZodObject<{
         baseUrl: z.ZodOptional<z.ZodString>;
         apiKey: z.ZodOptional<z.ZodString>;
         /**
-         * Per-model thinking override. Wins over the provider-level
-         * setting (settings.providers[].thinking). Use this when
-         * different models under the same provider need different
-         * defaults — e.g. DeepSeek V4 Pro off (faster) but V4 Flash on.
+         * Per-model reasoning override. Wins over the provider-level
+         * `reasoning` setting (settings.providers[].reasoning). Use this
+         * when different models under the same provider need different
+         * defaults — e.g. one model off (faster) and another on.
          */
-        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
+        reasoning: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"off">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "off";
+        }, {
+            mode: "off";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"on">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "on";
+        }, {
+            mode: "on";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"effort">;
+            effort: z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"budget">;
+            budgetTokens: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mode: "budget";
+            budgetTokens: number;
+        }, {
+            mode: "budget";
+            budgetTokens: number;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
-        model: string;
         key: string;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         provider?: string | undefined;
-        thinking?: "enabled" | "disabled" | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         protocol?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }, {
-        model: string;
         key: string;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         provider?: string | undefined;
-        thinking?: "enabled" | "disabled" | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         protocol?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }>, {
         protocol: string | undefined;
         provider: string | undefined;
-        model: string;
         key: string;
-        thinking?: "enabled" | "disabled" | undefined;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }, {
-        model: string;
         key: string;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         provider?: string | undefined;
-        thinking?: "enabled" | "disabled" | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         protocol?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }>, "many">>;
     permissions: z.ZodDefault<z.ZodObject<{
@@ -597,7 +1109,7 @@ export declare const SettingsSchema: z.ZodObject<{
             argsPattern?: Record<string, string> | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        defaultMode: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan";
+        defaultMode: "auto" | "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "plan";
         rules: {
             tool: string;
             decision: "allow" | "deny" | "ask";
@@ -605,7 +1117,7 @@ export declare const SettingsSchema: z.ZodObject<{
             argsPattern?: Record<string, string> | undefined;
         }[];
     }, {
-        defaultMode?: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan" | undefined;
+        defaultMode?: "auto" | "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "plan" | undefined;
         rules?: {
             tool: string;
             decision: "allow" | "deny" | "ask";
@@ -644,20 +1156,23 @@ export declare const SettingsSchema: z.ZodObject<{
         url: z.ZodOptional<z.ZodString>;
         transport: z.ZodOptional<z.ZodEnum<["stdio", "sse", "streamable-http", "inprocess"]>>;
         headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         name: string;
+        enabled?: boolean | undefined;
         url?: string | undefined;
         args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         transport?: "stdio" | "sse" | "streamable-http" | "inprocess" | undefined;
         headers?: Record<string, string> | undefined;
     }, {
         name: string;
+        enabled?: boolean | undefined;
         url?: string | undefined;
         args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         transport?: "stdio" | "sse" | "streamable-http" | "inprocess" | undefined;
         headers?: Record<string, string> | undefined;
     }>>>;
@@ -675,6 +1190,38 @@ export declare const SettingsSchema: z.ZodObject<{
      * names (no colon suffix). See scanSkills(opts.disabledPlugins).
      */
     disabledPlugins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Sub-agent role names (the `name` in .code-shell/agents/*.md) to
+     * hide from the registry. A disabled role is filtered out at load
+     * so it never appears in registry.list()/get() — the Agent tool's
+     * agent_type list won't show it and the LLM can't pick it. Mirrors
+     * disabledSkills / disabledPlugins.
+     */
+    disabledAgents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Project-scoped tri-state capability overlay. Only meaningful in
+     * ${cwd}/.code-shell/settings.json; layered over the global baseline at
+     * capability-assembly time. Optional — absence === everything inherits.
+     */
+    capabilityOverrides: z.ZodOptional<z.ZodObject<{
+        skills: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        plugins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        mcp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        builtin: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        builtin?: Record<string, "off" | "on" | "inherit"> | undefined;
+        mcp?: Record<string, "off" | "on" | "inherit"> | undefined;
+        skills?: Record<string, "off" | "on" | "inherit"> | undefined;
+        plugins?: Record<string, "off" | "on" | "inherit"> | undefined;
+        agents?: Record<string, "off" | "on" | "inherit"> | undefined;
+    }, {
+        builtin?: Record<string, "off" | "on" | "inherit"> | undefined;
+        mcp?: Record<string, "off" | "on" | "inherit"> | undefined;
+        skills?: Record<string, "off" | "on" | "inherit"> | undefined;
+        plugins?: Record<string, "off" | "on" | "inherit"> | undefined;
+        agents?: Record<string, "off" | "on" | "inherit"> | undefined;
+    }>>;
     instructions: z.ZodDefault<z.ZodObject<{
         fileName: z.ZodDefault<z.ZodString>;
         scanDirs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -699,30 +1246,30 @@ export declare const SettingsSchema: z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
             baseUrl: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
         }, {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
         }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         participants: (string | {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
         })[];
     }, {
         participants?: (string | {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
@@ -742,12 +1289,45 @@ export declare const SettingsSchema: z.ZodObject<{
         providers: z.ZodOptional<z.ZodRecord<z.ZodEnum<["serper", "tavily", "searxng"]>, z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
             baseUrl: z.ZodOptional<z.ZodString>;
+            lastProbe: z.ZodOptional<z.ZodObject<{
+                status: z.ZodEnum<["ok", "error", "unconfigured"]>;
+                sampleTitles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                errorMessage: z.ZodOptional<z.ZodString>;
+                errorDetail: z.ZodOptional<z.ZodString>;
+                lastProbedAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            }, {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }, {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }>>>;
     }, "strip", z.ZodTypeAny, {
         provider: "serper" | "tavily" | "searxng";
@@ -756,6 +1336,13 @@ export declare const SettingsSchema: z.ZodObject<{
         providers?: Partial<Record<"serper" | "tavily" | "searxng", {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }>> | undefined;
     }, {
         provider?: "serper" | "tavily" | "searxng" | undefined;
@@ -764,6 +1351,13 @@ export declare const SettingsSchema: z.ZodObject<{
         providers?: Partial<Record<"serper" | "tavily" | "searxng", {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }>> | undefined;
     }>>;
     output: z.ZodDefault<z.ZodObject<{
@@ -773,6 +1367,28 @@ export declare const SettingsSchema: z.ZodObject<{
     }, {
         format?: "text" | "json" | "jsonl" | "stream-json" | undefined;
     }>>;
+    /**
+     * Image attachment handling. Sub-fields:
+     *   - detail: OpenAI-style fidelity hint applied to every user-
+     *     attached image. "low" = 85 tokens/image fixed (cheap
+     *     thumbnail), "high" = ~768 px tiles (default), "original" =
+     *     keep client-side dimensions (most expensive). Anthropic
+     *     ignores this field today; that's fine — it just gets
+     *     dropped on the Claude path.
+     *   - mcpImageTokenBudget: per-turn cap on token cost of images
+     *     returned by MCP tools. Codex doesn't enforce this; CC uses
+     *     25 000. Set to 0 to disable.
+     */
+    images: z.ZodOptional<z.ZodObject<{
+        detail: z.ZodOptional<z.ZodEnum<["low", "high", "original"]>>;
+        mcpImageTokenBudget: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        detail?: "low" | "high" | "original" | undefined;
+        mcpImageTokenBudget?: number | undefined;
+    }, {
+        detail?: "low" | "high" | "original" | undefined;
+        mcpImageTokenBudget?: number | undefined;
+    }>>;
     /**
      * OS-level sandbox for shell-tool execution. "auto" picks per platform:
      * Seatbelt on macOS, bubblewrap on Linux when installed, otherwise off.
@@ -785,16 +1401,88 @@ export declare const SettingsSchema: z.ZodObject<{
         deniedReads: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         network: z.ZodOptional<z.ZodEnum<["allow", "deny"]>>;
     }, "strip", z.ZodTypeAny, {
-        mode?: "auto" | "seatbelt" | "bwrap" | "off" | undefined;
+        mode?: "auto" | "off" | "seatbelt" | "bwrap" | undefined;
         writableRoots?: string[] | undefined;
         deniedReads?: string[] | undefined;
         network?: "allow" | "deny" | undefined;
     }, {
-        mode?: "auto" | "seatbelt" | "bwrap" | "off" | undefined;
+        mode?: "auto" | "off" | "seatbelt" | "bwrap" | undefined;
         writableRoots?: string[] | undefined;
         deniedReads?: string[] | undefined;
         network?: "allow" | "deny" | undefined;
     }>>;
+    /**
+     * Project-local environment profile. Mirrors Codex's local-environment
+     * shape at the settings layer: setup/cleanup scripts can be customized per
+     * platform, and env values are stored as KEY=VALUE pairs. Runtime wiring is
+     * intentionally separate from the MCP server env model above.
+     */
+    localEnvironment: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        setupScripts: z.ZodOptional<z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            macos: z.ZodOptional<z.ZodString>;
+            linux: z.ZodOptional<z.ZodString>;
+            windows: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }>>;
+        cleanupScripts: z.ZodOptional<z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            macos: z.ZodOptional<z.ZodString>;
+            linux: z.ZodOptional<z.ZodString>;
+            windows: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        env?: Record<string, string> | undefined;
+        setupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+        cleanupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+    }, {
+        name?: string | undefined;
+        env?: Record<string, string> | undefined;
+        setupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+        cleanupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+    }>>;
     /**
      * Shell-hook configuration. Each entry binds a HookEventName to a
      * shell command; the command receives ctx JSON on stdin and returns
@@ -814,15 +1502,15 @@ export declare const SettingsSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         command: string;
         event: string;
-        cwd?: string | undefined;
         matcher?: string | undefined;
         timeout_ms?: number | undefined;
+        cwd?: string | undefined;
     }, {
         command: string;
         event: string;
-        cwd?: string | undefined;
         matcher?: string | undefined;
         timeout_ms?: number | undefined;
+        cwd?: string | undefined;
     }>, "many">>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     agent: z.ZodDefault<z.ZodObject<{
@@ -831,18 +1519,42 @@ export declare const SettingsSchema: z.ZodObject<{
         disabledBuiltinTools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         customSystemPrompt: z.ZodOptional<z.ZodString>;
         appendSystemPrompt: z.ZodOptional<z.ZodString>;
+        responseLanguage: z.ZodOptional<z.ZodString>;
+        userProfile: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodObject<{
+            compatClaude: z.ZodDefault<z.ZodBoolean>;
+            compatCodex: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            compatClaude: boolean;
+            compatCodex: boolean;
+        }, {
+            compatClaude?: boolean | undefined;
+            compatCodex?: boolean | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         preset: string;
         enabledBuiltinTools: string[];
         disabledBuiltinTools: string[];
         customSystemPrompt?: string | undefined;
         appendSystemPrompt?: string | undefined;
+        responseLanguage?: string | undefined;
+        userProfile?: string | undefined;
+        instructions?: {
+            compatClaude: boolean;
+            compatCodex: boolean;
+        } | undefined;
     }, {
         preset?: string | undefined;
         enabledBuiltinTools?: string[] | undefined;
         disabledBuiltinTools?: string[] | undefined;
         customSystemPrompt?: string | undefined;
         appendSystemPrompt?: string | undefined;
+        responseLanguage?: string | undefined;
+        userProfile?: string | undefined;
+        instructions?: {
+            compatClaude?: boolean | undefined;
+            compatCodex?: boolean | undefined;
+        } | undefined;
     }>>;
     /**
      * Primary source of truth for the active model is settings.activeKey
@@ -852,6 +1564,15 @@ export declare const SettingsSchema: z.ZodObject<{
      * both — appendOnboardingResult does this in one shot.
      */
     activeKey: z.ZodOptional<z.ZodString>;
+    /**
+     * Auxiliary-task model — points at a models[].key. Background, non-user-
+     * facing LLM calls (memory extraction, the auto-dream loop) use this model
+     * instead of the active one, so per-turn book-keeping doesn't burn the
+     * expensive primary model. Pick something fast/cheap (e.g. a Haiku or
+     * DeepSeek key). When unset, those calls fall back to the active model
+     * (legacy behavior). An invalid/missing key also falls back to active.
+     */
+    auxModelKey: z.ZodOptional<z.ZodString>;
     /**
      * Toggle background auto-update. When true (default), code-shell checks
      * npm for newer versions and — if the npm global prefix is writable —
@@ -868,16 +1589,16 @@ export declare const SettingsSchema: z.ZodObject<{
         temperature: z.ZodDefault<z.ZodNumber>;
         maxTokens: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        provider: string;
-        name: string;
         temperature: number;
+        name: string;
+        provider: string;
         baseUrl: string;
         maxTokens: number;
         apiKey?: string | undefined;
     }, {
-        provider?: string | undefined;
-        name?: string | undefined;
         temperature?: number | undefined;
+        name?: string | undefined;
+        provider?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         maxTokens?: number | undefined;
@@ -891,26 +1612,75 @@ export declare const SettingsSchema: z.ZodObject<{
         protocol: z.ZodOptional<z.ZodEnum<["openai-compat", "anthropic-style"]>>;
         modelsPath: z.ZodOptional<z.ZodString>;
         /**
-         * DeepSeek V4 thinking-mode default for this provider. "enabled"
-         * matches endpoint default; "disabled" makes V4 calls run in
-         * non-thinking mode (faster, cheaper). Ignored by every provider
-         * other than DeepSeek V4. Per-call overrides still win.
+         * Default reasoning/thinking setting for this provider's models.
+         * Rich shape: {mode:"off"|"on"} | {mode:"effort",effort} |
+         * {mode:"budget",budgetTokens}. Per-model `reasoning` wins.
          */
-        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
+        reasoning: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"off">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "off";
+        }, {
+            mode: "off";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"on">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "on";
+        }, {
+            mode: "on";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"effort">;
+            effort: z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"budget">;
+            budgetTokens: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mode: "budget";
+            budgetTokens: number;
+        }, {
+            mode: "budget";
+            budgetTokens: number;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         key: string;
-        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
+        kind: "openai" | "anthropic" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         baseUrl: string;
-        thinking?: "enabled" | "disabled" | undefined;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
         modelsPath?: string | undefined;
     }, {
         key: string;
-        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
+        kind: "openai" | "anthropic" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         baseUrl: string;
-        thinking?: "enabled" | "disabled" | undefined;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
@@ -934,59 +1704,129 @@ export declare const SettingsSchema: z.ZodObject<{
         baseUrl: z.ZodOptional<z.ZodString>;
         apiKey: z.ZodOptional<z.ZodString>;
         /**
-         * Per-model thinking override. Wins over the provider-level
-         * setting (settings.providers[].thinking). Use this when
-         * different models under the same provider need different
-         * defaults — e.g. DeepSeek V4 Pro off (faster) but V4 Flash on.
+         * Per-model reasoning override. Wins over the provider-level
+         * `reasoning` setting (settings.providers[].reasoning). Use this
+         * when different models under the same provider need different
+         * defaults — e.g. one model off (faster) and another on.
          */
-        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
+        reasoning: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"off">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "off";
+        }, {
+            mode: "off";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"on">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "on";
+        }, {
+            mode: "on";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"effort">;
+            effort: z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }, {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"budget">;
+            budgetTokens: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mode: "budget";
+            budgetTokens: number;
+        }, {
+            mode: "budget";
+            budgetTokens: number;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
-        model: string;
         key: string;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         provider?: string | undefined;
-        thinking?: "enabled" | "disabled" | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         protocol?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }, {
-        model: string;
         key: string;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         provider?: string | undefined;
-        thinking?: "enabled" | "disabled" | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         protocol?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }>, {
         protocol: string | undefined;
         provider: string | undefined;
-        model: string;
         key: string;
-        thinking?: "enabled" | "disabled" | undefined;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }, {
-        model: string;
         key: string;
+        model: string;
+        reasoning?: {
+            mode: "off";
+        } | {
+            mode: "on";
+        } | {
+            mode: "effort";
+            effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        } | {
+            mode: "budget";
+            budgetTokens: number;
+        } | undefined;
         provider?: string | undefined;
-        thinking?: "enabled" | "disabled" | undefined;
+        maxOutputTokens?: number | undefined;
         label?: string | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
         protocol?: string | undefined;
         providerKey?: string | undefined;
-        maxOutputTokens?: number | undefined;
         maxContextTokens?: number | undefined;
     }>, "many">>;
     permissions: z.ZodDefault<z.ZodObject<{
@@ -1008,7 +1848,7 @@ export declare const SettingsSchema: z.ZodObject<{
             argsPattern?: Record<string, string> | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        defaultMode: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan";
+        defaultMode: "auto" | "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "plan";
         rules: {
             tool: string;
             decision: "allow" | "deny" | "ask";
@@ -1016,7 +1856,7 @@ export declare const SettingsSchema: z.ZodObject<{
             argsPattern?: Record<string, string> | undefined;
         }[];
     }, {
-        defaultMode?: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan" | undefined;
+        defaultMode?: "auto" | "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "plan" | undefined;
         rules?: {
             tool: string;
             decision: "allow" | "deny" | "ask";
@@ -1055,20 +1895,23 @@ export declare const SettingsSchema: z.ZodObject<{
         url: z.ZodOptional<z.ZodString>;
         transport: z.ZodOptional<z.ZodEnum<["stdio", "sse", "streamable-http", "inprocess"]>>;
         headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         name: string;
+        enabled?: boolean | undefined;
         url?: string | undefined;
         args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         transport?: "stdio" | "sse" | "streamable-http" | "inprocess" | undefined;
         headers?: Record<string, string> | undefined;
     }, {
         name: string;
+        enabled?: boolean | undefined;
         url?: string | undefined;
         args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         transport?: "stdio" | "sse" | "streamable-http" | "inprocess" | undefined;
         headers?: Record<string, string> | undefined;
     }>>>;
@@ -1086,6 +1929,38 @@ export declare const SettingsSchema: z.ZodObject<{
      * names (no colon suffix). See scanSkills(opts.disabledPlugins).
      */
     disabledPlugins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Sub-agent role names (the `name` in .code-shell/agents/*.md) to
+     * hide from the registry. A disabled role is filtered out at load
+     * so it never appears in registry.list()/get() — the Agent tool's
+     * agent_type list won't show it and the LLM can't pick it. Mirrors
+     * disabledSkills / disabledPlugins.
+     */
+    disabledAgents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Project-scoped tri-state capability overlay. Only meaningful in
+     * ${cwd}/.code-shell/settings.json; layered over the global baseline at
+     * capability-assembly time. Optional — absence === everything inherits.
+     */
+    capabilityOverrides: z.ZodOptional<z.ZodObject<{
+        skills: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        plugins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        mcp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+        builtin: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["inherit", "on", "off"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        builtin?: Record<string, "off" | "on" | "inherit"> | undefined;
+        mcp?: Record<string, "off" | "on" | "inherit"> | undefined;
+        skills?: Record<string, "off" | "on" | "inherit"> | undefined;
+        plugins?: Record<string, "off" | "on" | "inherit"> | undefined;
+        agents?: Record<string, "off" | "on" | "inherit"> | undefined;
+    }, {
+        builtin?: Record<string, "off" | "on" | "inherit"> | undefined;
+        mcp?: Record<string, "off" | "on" | "inherit"> | undefined;
+        skills?: Record<string, "off" | "on" | "inherit"> | undefined;
+        plugins?: Record<string, "off" | "on" | "inherit"> | undefined;
+        agents?: Record<string, "off" | "on" | "inherit"> | undefined;
+    }>>;
     instructions: z.ZodDefault<z.ZodObject<{
         fileName: z.ZodDefault<z.ZodString>;
         scanDirs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -1110,30 +1985,30 @@ export declare const SettingsSchema: z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
             baseUrl: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
         }, {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
         }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         participants: (string | {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
         })[];
     }, {
         participants?: (string | {
-            model: string;
             name: string;
+            model: string;
             provider?: string | undefined;
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
@@ -1153,12 +2028,45 @@ export declare const SettingsSchema: z.ZodObject<{
         providers: z.ZodOptional<z.ZodRecord<z.ZodEnum<["serper", "tavily", "searxng"]>, z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
             baseUrl: z.ZodOptional<z.ZodString>;
+            lastProbe: z.ZodOptional<z.ZodObject<{
+                status: z.ZodEnum<["ok", "error", "unconfigured"]>;
+                sampleTitles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                errorMessage: z.ZodOptional<z.ZodString>;
+                errorDetail: z.ZodOptional<z.ZodString>;
+                lastProbedAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            }, {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }, {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }>>>;
     }, "strip", z.ZodTypeAny, {
         provider: "serper" | "tavily" | "searxng";
@@ -1167,6 +2075,13 @@ export declare const SettingsSchema: z.ZodObject<{
         providers?: Partial<Record<"serper" | "tavily" | "searxng", {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }>> | undefined;
     }, {
         provider?: "serper" | "tavily" | "searxng" | undefined;
@@ -1175,6 +2090,13 @@ export declare const SettingsSchema: z.ZodObject<{
         providers?: Partial<Record<"serper" | "tavily" | "searxng", {
             baseUrl?: string | undefined;
             apiKey?: string | undefined;
+            lastProbe?: {
+                status: "error" | "ok" | "unconfigured";
+                lastProbedAt: string;
+                sampleTitles?: string[] | undefined;
+                errorMessage?: string | undefined;
+                errorDetail?: string | undefined;
+            } | undefined;
         }>> | undefined;
     }>>;
     output: z.ZodDefault<z.ZodObject<{
@@ -1184,6 +2106,28 @@ export declare const SettingsSchema: z.ZodObject<{
     }, {
         format?: "text" | "json" | "jsonl" | "stream-json" | undefined;
     }>>;
+    /**
+     * Image attachment handling. Sub-fields:
+     *   - detail: OpenAI-style fidelity hint applied to every user-
+     *     attached image. "low" = 85 tokens/image fixed (cheap
+     *     thumbnail), "high" = ~768 px tiles (default), "original" =
+     *     keep client-side dimensions (most expensive). Anthropic
+     *     ignores this field today; that's fine — it just gets
+     *     dropped on the Claude path.
+     *   - mcpImageTokenBudget: per-turn cap on token cost of images
+     *     returned by MCP tools. Codex doesn't enforce this; CC uses
+     *     25 000. Set to 0 to disable.
+     */
+    images: z.ZodOptional<z.ZodObject<{
+        detail: z.ZodOptional<z.ZodEnum<["low", "high", "original"]>>;
+        mcpImageTokenBudget: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        detail?: "low" | "high" | "original" | undefined;
+        mcpImageTokenBudget?: number | undefined;
+    }, {
+        detail?: "low" | "high" | "original" | undefined;
+        mcpImageTokenBudget?: number | undefined;
+    }>>;
     /**
      * OS-level sandbox for shell-tool execution. "auto" picks per platform:
      * Seatbelt on macOS, bubblewrap on Linux when installed, otherwise off.
@@ -1196,16 +2140,88 @@ export declare const SettingsSchema: z.ZodObject<{
         deniedReads: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         network: z.ZodOptional<z.ZodEnum<["allow", "deny"]>>;
     }, "strip", z.ZodTypeAny, {
-        mode?: "auto" | "seatbelt" | "bwrap" | "off" | undefined;
+        mode?: "auto" | "off" | "seatbelt" | "bwrap" | undefined;
         writableRoots?: string[] | undefined;
         deniedReads?: string[] | undefined;
         network?: "allow" | "deny" | undefined;
     }, {
-        mode?: "auto" | "seatbelt" | "bwrap" | "off" | undefined;
+        mode?: "auto" | "off" | "seatbelt" | "bwrap" | undefined;
         writableRoots?: string[] | undefined;
         deniedReads?: string[] | undefined;
         network?: "allow" | "deny" | undefined;
     }>>;
+    /**
+     * Project-local environment profile. Mirrors Codex's local-environment
+     * shape at the settings layer: setup/cleanup scripts can be customized per
+     * platform, and env values are stored as KEY=VALUE pairs. Runtime wiring is
+     * intentionally separate from the MCP server env model above.
+     */
+    localEnvironment: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        setupScripts: z.ZodOptional<z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            macos: z.ZodOptional<z.ZodString>;
+            linux: z.ZodOptional<z.ZodString>;
+            windows: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }>>;
+        cleanupScripts: z.ZodOptional<z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            macos: z.ZodOptional<z.ZodString>;
+            linux: z.ZodOptional<z.ZodString>;
+            windows: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }, {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        env?: Record<string, string> | undefined;
+        setupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+        cleanupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+    }, {
+        name?: string | undefined;
+        env?: Record<string, string> | undefined;
+        setupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+        cleanupScripts?: {
+            default?: string | undefined;
+            linux?: string | undefined;
+            macos?: string | undefined;
+            windows?: string | undefined;
+        } | undefined;
+    }>>;
     /**
      * Shell-hook configuration. Each entry binds a HookEventName to a
      * shell command; the command receives ctx JSON on stdin and returns
@@ -1225,15 +2241,15 @@ export declare const SettingsSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         command: string;
         event: string;
-        cwd?: string | undefined;
         matcher?: string | undefined;
         timeout_ms?: number | undefined;
+        cwd?: string | undefined;
     }, {
         command: string;
         event: string;
-        cwd?: string | undefined;
         matcher?: string | undefined;
         timeout_ms?: number | undefined;
+        cwd?: string | undefined;
     }>, "many">>;
 }, z.ZodTypeAny, "passthrough">>;
 export type ValidatedSettings = z.infer<typeof SettingsSchema>;