@gajae-code/coding-agent 0.10.2 → 0.11.1

package/dist/types/config/model-profile-activation.d.ts

@@ -2,13 +2,18 @@ import { ThinkingLevel } from "@gajae-code/agent-core";
 import type { Api, Model } from "@gajae-code/ai";
 import type { AgentSession } from "../session/agent-session";
 import { type GjcModelAssignmentTargetId, type ModelRegistry } from "./model-registry";
+import { type ModelSelectorValue } from "./model-selector-value";
 import type { Settings } from "./settings";
-type ModelProfileActivationSession = Pick<AgentSession, "model" | "thinkingLevel" | "sessionId"> & {
+type ModelProfileActivationSession = Pick<AgentSession, "model" | "thinkingLevel" | "sessionId" | "getConfiguredModelChain" | "setConfiguredModelChain"> & {
     setModelTemporary?: AgentSession["setModelTemporary"];
     setActiveModelProfile?: (name: string | undefined) => void;
     getActiveModelProfile?: () => string | undefined;
     getSessionDefaultModelSelector?: () => string | undefined;
     recordResumeDefaultModel?: (selector: string) => void;
+    seedDefaultFallbackResolution?: (activeIndex: number, skips: Array<{
+        selector: string;
+        reason: string;
+    }>) => void;
 };
 export interface PrepareModelProfileActivationOptions {
     session: ModelProfileActivationSession;
@@ -25,15 +30,25 @@ export interface PreparedModelProfileActivation {
     session: ModelProfileActivationSession & {
         setModelTemporary: AgentSession["setModelTemporary"];
     };
-    settings: Pick<Settings, "clearOverride" | "get" | "getGlobal" | "override" | "set" | "flush">;
+    settings: Pick<Settings, "clearOverride" | "get" | "getGlobal" | "override" | "set" | "unset" | "flush">;
     previousModel: Model<Api> | undefined;
     previousThinkingLevel: ThinkingLevel | undefined;
-    previousAgentModelOverrides: Record<string, string>;
-    previousModelRoles: Record<string, string>;
+    previousAgentModelOverrides: Record<string, ModelSelectorValue>;
+    previousModelRoles: Record<string, ModelSelectorValue>;
+    previousDefaultChain: readonly string[] | undefined;
     defaultModel: Model<Api> | undefined;
     defaultThinkingLevel: ThinkingLevel | undefined;
-    modelRoles: Record<string, string>;
-    agentModelOverrides: Record<string, string>;
+    /** Full configured default fallback chain with resolvable entries clamped. */
+    defaultChain: readonly string[];
+    /** Index of the authenticated default-chain entry selected for activation. */
+    defaultActiveIndex: number | undefined;
+    /** Resolution-time skips that occurred before selecting the default entry. */
+    defaultResolutionSkips: Array<{
+        selector: string;
+        reason: string;
+    }>;
+    modelRoles: Record<string, ModelSelectorValue>;
+    agentModelOverrides: Record<string, ModelSelectorValue>;
     previousActiveModelProfile: string | undefined;
     /**
      * The session resume default ("provider/id") captured BEFORE activation —
@@ -45,33 +60,38 @@ export interface PreparedModelProfileActivation {
     previousSessionDefaultModel: string | undefined;
 }
 export interface MaterializeModelProfileAssignmentOptions {
-    session: Pick<ModelProfileActivationSession, "model" | "thinkingLevel" | "setActiveModelProfile" | "getActiveModelProfile">;
-    settings: Pick<Settings, "clearOverride" | "get" | "override" | "set">;
+    session: Pick<ModelProfileActivationSession, "model" | "thinkingLevel" | "getConfiguredModelChain" | "setActiveModelProfile" | "getActiveModelProfile">;
+    settings: Pick<Settings, "clearOverride" | "get" | "override" | "set" | "unset">;
     role: GjcModelAssignmentTargetId;
     selector: string;
 }
 export interface MaterializeModelProfileAssignmentsOptions {
-    session: Pick<ModelProfileActivationSession, "model" | "thinkingLevel" | "setActiveModelProfile" | "getActiveModelProfile">;
-    settings: Pick<Settings, "clearOverride" | "get" | "override" | "set">;
+    session: Pick<ModelProfileActivationSession, "model" | "thinkingLevel" | "getConfiguredModelChain" | "setActiveModelProfile" | "getActiveModelProfile">;
+    settings: Pick<Settings, "clearOverride" | "get" | "override" | "set" | "unset">;
     assignments: ReadonlyMap<GjcModelAssignmentTargetId, string> | Partial<Record<GjcModelAssignmentTargetId, string>>;
 }
 export declare function materializeActiveModelProfileAssignment(options: MaterializeModelProfileAssignmentOptions): boolean;
 export declare function materializeActiveModelProfileAssignments(options: MaterializeModelProfileAssignmentsOptions): boolean;
+export declare class ModelProfileCredentialError extends Error {
+    readonly profileLabel: string;
+    readonly providers: readonly string[];
+    constructor(profileLabel: string, providers: readonly string[]);
+}
 export declare function formatModelProfileCredentialError(profileLabel: string, providers: readonly string[]): string;
 export declare function resolveModelProfileName(profileName: string, profiles: ReadonlyMap<string, unknown>): string;
 export declare function prepareModelProfileActivation(options: PrepareModelProfileActivationOptions): Promise<PreparedModelProfileActivation>;
 export declare function applyPreparedModelProfileActivation(prepared: PreparedModelProfileActivation, options?: ApplyModelProfileActivationOptions): Promise<void>;
 export interface MaterializeModelProfileForDeletionResult {
-    modelRoles: Record<string, string>;
-    agentModelOverrides: Record<string, string>;
-    previousModelRoles: Record<string, string>;
-    previousAgentModelOverrides: Record<string, string>;
+    modelRoles: Record<string, ModelSelectorValue>;
+    agentModelOverrides: Record<string, ModelSelectorValue>;
+    previousModelRoles: Record<string, ModelSelectorValue>;
+    previousAgentModelOverrides: Record<string, ModelSelectorValue>;
     previousDefaultProfile: string | undefined;
     previousPersistedDefaultProfile: string | undefined;
     previousActiveModelProfile: string | undefined;
 }
 export declare function materializeModelProfileForDeletion(options: PrepareModelProfileActivationOptions & {
-    settings: Pick<Settings, "clearOverride" | "flush" | "get" | "getGlobal" | "override" | "set">;
+    settings: Pick<Settings, "clearOverride" | "flush" | "get" | "getGlobal" | "override" | "set" | "unset">;
 }): Promise<MaterializeModelProfileForDeletionResult>;
 export declare function restoreMaterializedModelProfileForDeletion(options: {
     settings: Pick<Settings, "flush" | "override" | "set">;

package/dist/types/config/model-profiles.d.ts

@@ -1,4 +1,5 @@
 import type { GjcModelAssignmentTargetId } from "./model-registry";
+import { type ModelSelectorValue } from "./model-selector-value";
 import type { ModelsConfig } from "./models-config-schema";
 export type ModelProfileRole = GjcModelAssignmentTargetId;
 export interface ModelProfileDefinition {
@@ -15,16 +16,21 @@ export interface ModelProfileDefinition {
      * means any single xiaomi credential satisfies the group.
      */
     alternativeProviderGroups?: readonly (readonly string[])[];
-    modelMapping: Partial<Record<ModelProfileRole, string>>;
+    modelMapping: Partial<Record<ModelProfileRole, ModelSelectorValue>>;
     source: "builtin" | "user";
 }
 export interface ResolvedProfileBinding {
-    defaultSelector?: string;
-    modelRoles: Record<string, string>;
-    agentModelOverrides: Partial<Record<Exclude<ModelProfileRole, "default">, string>>;
+    defaultSelector?: ModelSelectorValue;
+    modelRoles: Record<string, ModelSelectorValue>;
+    agentModelOverrides: Partial<Record<Exclude<ModelProfileRole, "default">, ModelSelectorValue>>;
 }
 export declare function deriveModelProfileMappedProviders(definition: Pick<ModelProfileDefinition, "modelMapping">): string[];
-export declare function aggregateModelProfileRequiredProviders(requiredProviders: readonly string[], definition: Pick<ModelProfileDefinition, "modelMapping">): string[];
+/**
+ * Return the providers explicitly declared as hard prerequisites.
+ * Model mappings may reference fallback providers, but those references are
+ * resolution-time candidates rather than activation requirements.
+ */
+export declare function aggregateModelProfileRequiredProviders(requiredProviders: readonly string[], _definition: Pick<ModelProfileDefinition, "modelMapping">): string[];
 export declare const BUILTIN_MODEL_PROFILES: readonly ModelProfileDefinition[];
 export interface ModelProfilePresentation {
     displayName: string;

package/dist/types/config/model-registry.d.ts

@@ -265,8 +265,8 @@ export declare const ModelsConfigFile: ConfigFile<{
         } | undefined;
     }> | undefined;
     modelBindings?: {
-        modelRoles?: Record<string, string> | undefined;
-        agentModelOverrides?: Record<string, string> | undefined;
+        modelRoles?: Record<string, string | string[]> | undefined;
+        agentModelOverrides?: Record<string, string | string[]> | undefined;
     } | undefined;
     equivalence?: {
         overrides?: Record<string, string> | undefined;
@@ -275,7 +275,7 @@ export declare const ModelsConfigFile: ConfigFile<{
     profiles?: Record<string, {
         required_providers: string[];
         display_name?: string | undefined;
-        model_mapping: Partial<Record<"architect" | "critic" | "default" | "executor" | "planner", string>>;
+        model_mapping: Partial<Record<"architect" | "critic" | "default" | "executor" | "planner", string | string[]>>;
     }> | undefined;
 }>;
 /** Provider override config (baseUrl, headers, apiKey, compat, transport) without custom models */

package/dist/types/config/model-resolver.d.ts

@@ -4,9 +4,16 @@
 import { ThinkingLevel } from "@gajae-code/agent-core";
 import { type Api, type KnownProvider, type Model } from "@gajae-code/ai";
 import { type ModelRegistry, type ModelRole } from "./model-registry";
+import { type ModelSelectorValue } from "./model-selector-value";
 import type { Settings } from "./settings";
 /** Default model IDs for each known provider */
 export declare const defaultModelPerProvider: Record<KnownProvider, string>;
+/**
+ * Cursor's current RPC transport executes its exec protocol while streaming and
+ * has no client-side tool-call mode. Managed fallback attempts must not enable
+ * that irreversible path.
+ */
+export declare function managedCursorFallbackUnavailableReason(model: Model<Api>, selector: string): string | undefined;
 export interface ScopedModelSelection {
     model: Model<Api>;
     thinkingLevel?: ThinkingLevel;
@@ -61,10 +68,10 @@ export declare function parseModelPattern(pattern: string, availableModels: Mode
  * Expand a role alias like "pi/default" to the configured model string.
  */
 export declare function expandRoleAlias(value: string, settings?: Settings): string;
-export declare function resolveConfiguredModelPatterns(value: string | string[] | undefined, settings?: Settings): string[];
+export declare function resolveConfiguredModelPatterns(value: ModelSelectorValue | undefined, settings?: Settings): string[];
 export interface AgentModelPatternResolutionOptions {
-    settingsOverride?: string | string[];
-    agentModel?: string | string[];
+    settingsOverride?: ModelSelectorValue;
+    agentModel?: ModelSelectorValue;
     settings?: Settings;
     activeModelPattern?: string;
     fallbackModelPattern?: string;
@@ -79,12 +86,12 @@ export interface ResolvedModelRoleValue {
     explicitThinkingLevel: boolean;
     warning: string | undefined;
 }
-export declare function resolveModelRoleValue(roleValue: string | undefined, availableModels: Model<Api>[], options?: {
+export declare function resolveModelRoleValue(roleValue: ModelSelectorValue | undefined, availableModels: Model<Api>[], options?: {
     settings?: Settings;
     matchPreferences?: ModelMatchPreferences;
     modelRegistry?: CanonicalModelRegistry;
 }): ResolvedModelRoleValue;
-export declare function extractExplicitThinkingSelector(value: string | undefined, settings?: Settings): ThinkingLevel | undefined;
+export declare function extractExplicitThinkingSelector(value: ModelSelectorValue | undefined, settings?: Settings): ThinkingLevel | undefined;
 /**
  * Resolve a model identifier or pattern to a Model instance.
  */
@@ -107,6 +114,26 @@ export declare function resolveModelOverride(modelPatterns: string[], modelRegis
     thinkingLevel?: ThinkingLevel;
     explicitThinkingLevel: boolean;
 };
+/**
+ * Resolve a configured fallback chain to its first callable entry without
+ * charging requests. For retryable chains, consumers MUST pass
+ * `{ managedFallback: true }` so unsuitable entries (including Cursor's
+ * provider-side tool mode) fail closed during resolution before any request
+ * is attempted. Single-entry chains remain non-managed selections.
+ */
+export interface ModelChainResolutionOptions {
+    managedFallback?: boolean;
+}
+export declare function resolveModelChainWithAuth(modelPatterns: readonly string[], modelRegistry: ModelLookupRegistry & Pick<ModelRegistry, "getApiKey">, settings?: Settings, sessionId?: string, options?: ModelChainResolutionOptions): Promise<{
+    model?: Model<Api>;
+    thinkingLevel?: ThinkingLevel;
+    explicitThinkingLevel: boolean;
+    activeIndex: number;
+    skips: Array<{
+        selector: string;
+        reason: string;
+    }>;
+}>;
 /**
  * Resolve a list of override patterns to the first matching model, with an
  * auth-aware fallback to the parent session's active model.
@@ -128,13 +155,19 @@ export declare function resolveModelOverride(modelPatterns: string[], modelRegis
  * primary resolution unchanged so the existing error path still surfaces
  * a meaningful failure downstream.
  */
-export declare function resolveModelOverrideWithAuthFallback(modelPatterns: string[], parentActiveModelPattern: string | undefined, modelRegistry: ModelLookupRegistry & Pick<ModelRegistry, "getApiKey">, settings?: Settings, sessionId?: string): Promise<{
+export declare function resolveModelOverrideWithAuthFallback(modelPatterns: string[], parentActiveModelPattern: string | undefined, modelRegistry: ModelLookupRegistry & Pick<ModelRegistry, "getApiKey">, settings?: Settings, sessionId?: string, options?: ModelChainResolutionOptions): Promise<{
     model?: Model<Api>;
     thinkingLevel?: ThinkingLevel;
     explicitThinkingLevel: boolean;
     authFallbackUsed: boolean;
     requestedModel?: Model<Api>;
     fallbackReason?: "auth_unavailable";
+    activeIndex?: number;
+    parentFallbackSelector?: string;
+    skips: Array<{
+        selector: string;
+        reason: string;
+    }>;
 }>;
 /**
  * Resolve a list of role patterns to the first matching model.

package/dist/types/config/model-selector-value.d.ts

@@ -0,0 +1,17 @@
+import * as z from "zod/v4";
+/** A model selector or an ordered fallback chain of selectors. */
+export type ModelSelectorValue = string | readonly string[];
+/**
+ * Accept one validated selector or a non-empty ordered chain of validated selectors.
+ * Element schemas own each configuration surface's selector grammar.
+ */
+export declare function stringOrNonEmptyArray<T extends z.ZodType<string>>(elementSchema: T): z.ZodUnion<readonly [T, z.ZodArray<T>]>;
+/** Return whether a value is a non-blank selector or a non-empty selector chain. */
+export declare function isModelSelectorValue(value: unknown): value is ModelSelectorValue;
+/**
+ * Preserve compatibility with comma-delimited selector strings while flattening
+ * configured chains in their declared order.
+ */
+export declare function normalizeModelSelectorValue(value: ModelSelectorValue | undefined): string[];
+/** Return the first configured selector for consumers that need one selector. */
+export declare function selectorHead(value: ModelSelectorValue | undefined): string | undefined;

package/dist/types/config/models-config-schema.d.ts

@@ -62,6 +62,10 @@ export declare const OpenAICompatSchema: z.ZodObject<{
         none: "none";
     }>>;
 }, z.core.$strip>;
+export declare const ModelBindingsSchema: z.ZodObject<{
+    modelRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+    agentModelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+}, z.core.$strip>;
 export declare const ProfileRoleSchema: z.ZodEnum<{
     architect: "architect";
     critic: "critic";
@@ -76,7 +80,7 @@ export declare const ProfileModelMappingSchema: z.ZodRecord<z.ZodEnum<{
     default: "default";
     executor: "executor";
     planner: "planner";
-}> & z.core.$partial, z.ZodString>;
+}> & z.core.$partial, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
 export declare const ProfileDefinitionSchema: z.ZodObject<{
     required_providers: z.ZodArray<z.ZodString>;
     display_name: z.ZodOptional<z.ZodString>;
@@ -86,7 +90,7 @@ export declare const ProfileDefinitionSchema: z.ZodObject<{
         default: "default";
         executor: "executor";
         planner: "planner";
-    }> & z.core.$partial, z.ZodString>;
+    }> & z.core.$partial, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strict>;
 export declare const ProfilesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     required_providers: z.ZodArray<z.ZodString>;
@@ -97,7 +101,7 @@ export declare const ProfilesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         default: "default";
         executor: "executor";
         planner: "planner";
-    }> & z.core.$partial, z.ZodString>;
+    }> & z.core.$partial, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strict>>;
 export declare const ModelOverrideSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
@@ -676,8 +680,8 @@ export declare const ModelsConfigSchema: z.ZodObject<{
         }, z.core.$strict>>;
     }, z.core.$strict>>>;
     modelBindings: z.ZodOptional<z.ZodObject<{
-        modelRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        agentModelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+        agentModelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
     }, z.core.$strip>>;
     equivalence: z.ZodOptional<z.ZodObject<{
         overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -692,7 +696,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
             default: "default";
             executor: "executor";
             planner: "planner";
-        }> & z.core.$partial, z.ZodString>;
+        }> & z.core.$partial, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
 export type ModelsConfig = z.infer<typeof ModelsConfigSchema>;

package/dist/types/config/settings-schema.d.ts

@@ -1,4 +1,5 @@
 import type { Effort } from "@gajae-code/ai/model-thinking";
+import type { ModelSelectorValue } from "./model-selector-value";
 import { type SkillDiscoverySettings } from "./skill-settings-defaults";
 /** Unified settings schema - single source of truth for all settings.
  *
@@ -10,7 +11,7 @@ import { type SkillDiscoverySettings } from "./skill-settings-defaults";
  *   settings.get("compaction.enabled")  // => boolean
  *   settings.set("theme.dark", "red-claw")  // sync, saves in background
  */
-export type SettingTab = "appearance" | "model" | "interaction" | "context" | "memory" | "editing" | "tools" | "tasks" | "providers";
+export type SettingTab = "appearance" | "model" | "interaction" | "context" | "memory" | "editing" | "tools" | "tasks" | "providers" | "notifications";
 /** Tab display metadata - icon is resolved via theme.symbol() */
 export type TabMetadata = {
     label: string;
@@ -37,6 +38,11 @@ interface UiBase {
     description: string;
     /** Condition function name - setting only shown when true */
     condition?: string;
+    /**
+     * Persistence owner for settings which must not use the generic immediate
+     * settings-list write path.
+     */
+    editing?: "notification-atomic";
 }
 interface UiBoolean extends UiBase {
 }
@@ -91,9 +97,13 @@ interface ArrayDef<T> {
     };
     ui?: UiBase;
 }
+interface RecordValueDef {
+    type: "model-selector-value";
+}
 interface RecordDef<T> {
     type: "record";
     default: Record<string, T>;
+    valueSchema?: RecordValueDef;
     ui?: UiBase;
 }
 type SettingDef = BooleanDef | StringDef | NumberDef | EnumDef<readonly string[]> | ArrayDef<unknown> | RecordDef<unknown>;
@@ -130,13 +140,29 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly "notifications.telegram.activation": {
+        readonly type: "record";
+        readonly default: Record<string, unknown>;
+    };
     readonly "notifications.telegram.rich.enabled": {
         readonly type: "boolean";
         readonly default: true;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Telegram Rich Messages";
+            readonly description: "Format Telegram notifications with rich message content.";
+            readonly editing: "notification-atomic";
+        };
     };
     readonly "notifications.telegram.richDraft.enabled": {
         readonly type: "boolean";
         readonly default: false;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Telegram Rich Drafts";
+            readonly description: "Include rich draft updates in Telegram notifications.";
+            readonly editing: "notification-atomic";
+        };
     };
     readonly "notifications.telegram.topics.nameTemplate": {
         readonly type: "string";
@@ -146,7 +172,15 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
-    readonly "notifications.discord.channelId": {
+    readonly "notifications.discord.applicationId": {
+        readonly type: "string";
+        readonly default: undefined;
+    };
+    readonly "notifications.discord.guildId": {
+        readonly type: "string";
+        readonly default: undefined;
+    };
+    readonly "notifications.discord.parentChannelId": {
         readonly type: "string";
         readonly default: undefined;
     };
@@ -154,23 +188,71 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly "notifications.slack.appToken": {
+        readonly type: "string";
+        readonly default: undefined;
+    };
+    readonly "notifications.slack.workspaceId": {
+        readonly type: "string";
+        readonly default: undefined;
+    };
     readonly "notifications.slack.channelId": {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly "notifications.slack.authorizedUserId": {
+        readonly type: "string";
+        readonly default: undefined;
+    };
     readonly "notifications.redact": {
         readonly type: "boolean";
         readonly default: false;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Redact Notification Content";
+            readonly description: "Redact sensitive content before notifications are delivered.";
+            readonly editing: "notification-atomic";
+        };
     };
     readonly "notifications.verbosity": {
         readonly type: "string";
         readonly default: "lean";
         readonly validate: (value: string) => value is "lean" | "verbose";
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Notification Verbosity";
+            readonly description: "Choose concise or detailed notification messages.";
+            readonly options: readonly [{
+                readonly value: "lean";
+                readonly label: "Lean";
+                readonly description: "Send concise notification messages";
+            }, {
+                readonly value: "verbose";
+                readonly label: "Verbose";
+                readonly description: "Send detailed notification messages";
+            }];
+            readonly editing: "notification-atomic";
+        };
     };
     readonly "notifications.sessionScope": {
         readonly type: "string";
         readonly default: "all";
         readonly validate: (value: string) => value is "all" | "primary";
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Notification Session Scope";
+            readonly description: "Send notifications from all sessions or only the primary session.";
+            readonly options: readonly [{
+                readonly value: "all";
+                readonly label: "All Sessions";
+                readonly description: "Allow eligible sessions";
+            }, {
+                readonly value: "primary";
+                readonly label: "Primary Session";
+                readonly description: "Limit automatic notifications to the primary session";
+            }];
+            readonly editing: "notification-atomic";
+        };
     };
     readonly "notifications.daemon.idleTimeoutMs": {
         readonly type: "number";
@@ -285,7 +367,10 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly modelRoles: {
         readonly type: "record";
-        readonly default: Record<string, string>;
+        readonly default: Record<string, ModelSelectorValue>;
+        readonly valueSchema: {
+            readonly type: "model-selector-value";
+        };
     };
     readonly "modelProfile.default": {
         readonly type: "string";
@@ -1240,6 +1325,11 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "fallback.maxAttempts": {
+        readonly type: "number";
+        readonly default: 3;
+        readonly validate: (value: number) => boolean;
+    };
     readonly "retry.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -2802,6 +2892,34 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Directory to save screenshots. If unset, screenshots go to a temp file. Supports ~. Examples: ~/Downloads, ~/Desktop, /sdcard/Download (Android)";
         };
     };
+    readonly "browser.profileReuse": {
+        readonly type: "string";
+        readonly default: "auto";
+        readonly validate: (value: string) => value is "auto" | "opt-in";
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Profile reuse posture";
+            readonly description: "'auto' (default): when a usable real Chrome profile is available, the browser tool uses an isolated copy of it (cookies/session/cache) for stronger stealth, warns, and falls back to synthetic. 'opt-in': stay synthetic unless a real profile is explicitly requested.";
+        };
+    };
+    readonly "browser.geo.timezone": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Geo timezone override";
+            readonly description: "Optional IANA timezone (e.g. 'America/New_York') for headless sessions. Default unset preserves the real timezone. Only set this to a value coherent with your egress (e.g. a proxy region); an incoherent timezone increases bot detection.";
+        };
+    };
+    readonly "browser.geo.locale": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Geo locale override";
+            readonly description: "Optional UI locale (e.g. 'en-US') for headless sessions. Default unset preserves the real locale. Only set this coherently with your egress region.";
+        };
+    };
     readonly "browser.gc.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -3337,7 +3455,10 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "task.agentModelOverrides": {
         readonly type: "record";
-        readonly default: Record<string, string>;
+        readonly default: Record<string, ModelSelectorValue>;
+        readonly valueSchema: {
+            readonly type: "model-selector-value";
+        };
     };
     readonly "tasks.todoClearDelay": {
         readonly type: "number";
@@ -3909,13 +4030,19 @@ export interface NotificationsSettings {
     };
     discord: {
         botToken: string | undefined;
-        channelId: string | undefined;
+        applicationId: string | undefined;
+        guildId: string | undefined;
+        parentChannelId: string | undefined;
     };
     slack: {
         botToken: string | undefined;
+        appToken: string | undefined;
+        workspaceId: string | undefined;
         channelId: string | undefined;
     };
     redact: boolean;
+    verbosity: "lean" | "verbose";
+    sessionScope: "all" | "primary";
     daemon: {
         idleTimeoutMs: number;
     };
@@ -3934,7 +4061,7 @@ export interface GroupTypeMap {
     statusLine: StatusLineSettings;
     thinkingBudgets: ThinkingBudgetsSettings;
     stt: SttSettings;
-    modelRoles: Record<string, string>;
+    modelRoles: Record<string, ModelSelectorValue>;
     modelTags: ModelTagsSettings;
     cycleOrder: string[];
     shellMinimizer: ShellMinimizerSettings;