@ai-matrx/agents 0.59.194 → 0.59.196

package/dist/settings/react/index.d.cts

@@ -1,6 +1,6 @@
 import { components } from '@ai-matrx/api/types';
 import * as React from 'react';
-import { JSX, ReactNode } from 'react';
+import { ReactNode } from 'react';
 
 /**
  * Agent Settings — Type Definitions
@@ -166,16 +166,48 @@ interface SettingsStore {
     cancelModelSwitch(agentId: string): void;
 }
 
-interface SettingControlInputProps {
-    /** Setting key (snake_case) — used for ids and response_format handling. */
-    settingKey: string;
-    control: ControlDefinition;
-    value: unknown;
-    onChange: (value: unknown) => void;
-    disabled?: boolean;
-    id?: string;
+/**
+ * Model Settings Catalog — the single source of truth for the STANDARD
+ * settings list, and the one chokepoint that decides which keys it contains.
+ *
+ * ── The model (two distinct surfaces) ────────────────────────────────────────
+ *   1. STANDARD list  — ONLY the keys the selected model explicitly declares in
+ *      its `controls` config (i.e. the parameters this model actually supports).
+ *      `buildSettingsRows()` returns exactly these, grouped + ordered. Catalog
+ *      keys the model does not declare are NOT shown here.
+ *   2. CAUTION surface — settings the agent has SET that the model does NOT
+ *      support. These are never hidden: they are flagged as "not valid for this
+ *      model" and made repairable by the validation layer (the IssueTable, fed
+ *      by the `unsupported_by_model` rule). They do NOT belong in the standard
+ *      list — that is exactly the "showing all possible keys" bug.
+ *
+ * The catalog exists so the standard list's labels, grouping and order live
+ * in ONE place (previously copy-pasted as `textModelSettings` /
+ * `booleanSettings` / ... into three components, each filtering by
+ * `getControl(key)` inline — which drifted and regressed). Components map over
+ * `buildSettingsRows()`; they must not filter by model themselves (ESLint
+ * enforces). The original recurring bug — set values silently dropped when a
+ * model didn't support them — is fixed by the CAUTION surface, not by dumping
+ * every key into the standard list.
+ *
+ * Guardrail: `settings-catalogue.test.ts` asserts the standard list contains
+ * ONLY supported keys (never the full catalog), and `unsupported-by-model.
+ * test.ts` asserts set-but-unsupported keys surface in the caution layer.
+ */
+
+type SettingsGroupId = "text" | "featureFlags" | "imageVideo" | "audio" | "other";
+interface SettingsRow {
+    key: string;
+    label: string;
+    group: SettingsGroupId;
+    /** The model's control definition for this key. Standard rows are always
+     *  supported, so this is present; typed nullable for consumer convenience. */
+    control: ControlDefinition | null;
+    /** Always true for rows returned by buildSettingsRows (standard = supported). */
+    supported: boolean;
+    /** True when the current settings hold a non-null value for this key. */
+    hasValue: boolean;
 }
-declare function SettingControlInput({ settingKey, control, value, onChange, disabled, id, }: SettingControlInputProps): React.JSX.Element;
 
 /**
  * UI Gates — canonical model-gated UI flags.
@@ -219,72 +251,35 @@ interface UiGates {
 declare const UI_GATE_EDITABLE_KEYS: readonly ["image_urls", "file_urls", "youtube_videos"];
 type UiGateEditableKey = (typeof UI_GATE_EDITABLE_KEYS)[number];
 
-/**
- * THE input-capabilities group (agent core B4): the per-agent / per-run UI gates (image URLs,
- * file URLs, YouTube), drawn on THE model-settings panel's row frame so it lines up with the
- * settings above it — in the builder and in every override screen alike. Controlled: the
- * caller owns `values` and decides what a change means (the builder writes the agent's
- * ui_gates; a conversation writes its own capability overrides, each with a reset).
- */
-
-interface InputCapabilitiesEditorProps {
-    values: UiGates;
-    onChange: (key: UiGateEditableKey, value: boolean) => void;
-    /** Keys the caller changed itself; each gets a reset to what it inherits. */
-    changedKeys?: ReadonlySet<UiGateEditableKey> | undefined;
-    onReset?: ((key: UiGateEditableKey) => void) | undefined;
-    /** The reset button's words. Default "Reset to agent". */
-    resetLabel?: string | undefined;
-    /** Said under the rows when saving failed. */
-    error?: string | null | undefined;
-    idPrefix: string;
-    title?: string;
-    disabled?: boolean;
+/** One model a host runs on the person's own computer. */
+interface LocalModelEntry {
+    /** The value `onValueChange` receives (the conversation's model override). */
+    id: string;
+    name: string;
+    /** Brand glyph key (e.g. "Meta"); absent draws the neutral glyph. */
+    maker?: string | null;
+    contextWindow?: number | null;
+    /** The computer cannot hold it today: the row is dimmed and says why, but stays pickable. */
+    needsMoreMemory?: boolean;
 }
-/** Shared builder/runtime editor for frontend-only run capabilities. */
-declare function InputCapabilitiesEditor({ values, onChange, changedKeys, onReset, resetLabel, error, idPrefix, title, disabled, }: InputCapabilitiesEditorProps): JSX.Element;
-
 /**
- * Model Settings Catalog — the single source of truth for the STANDARD
- * settings list, and the one chokepoint that decides which keys it contains.
- *
- * ── The model (two distinct surfaces) ────────────────────────────────────────
- *   1. STANDARD list  — ONLY the keys the selected model explicitly declares in
- *      its `controls` config (i.e. the parameters this model actually supports).
- *      `buildSettingsRows()` returns exactly these, grouped + ordered. Catalog
- *      keys the model does not declare are NOT shown here.
- *   2. CAUTION surface — settings the agent has SET that the model does NOT
- *      support. These are never hidden: they are flagged as "not valid for this
- *      model" and made repairable by the validation layer (the IssueTable, fed
- *      by the `unsupported_by_model` rule). They do NOT belong in the standard
- *      list — that is exactly the "showing all possible keys" bug.
- *
- * The catalog exists so the standard list's labels, grouping and order live
- * in ONE place (previously copy-pasted as `textModelSettings` /
- * `booleanSettings` / ... into three components, each filtering by
- * `getControl(key)` inline — which drifted and regressed). Components map over
- * `buildSettingsRows()`; they must not filter by model themselves (ESLint
- * enforces). The original recurring bug — set values silently dropped when a
- * model didn't support them — is fixed by the CAUTION surface, not by dumping
- * every key into the standard list.
- *
- * Guardrail: `settings-catalogue.test.ts` asserts the standard list contains
- * ONLY supported keys (never the full catalog), and `unsupported-by-model.
- * test.ts` asserts set-but-unsupported keys surface in the caution layer.
+ * The host's local-model source (a store: `getModels` + `subscribe`, like the catalog). The picker
+ * draws its models as one "On this computer" group marked local. Start/Stop and getting more
+ * models stay the host's own screens.
  */
-
-type SettingsGroupId = "text" | "featureFlags" | "imageVideo" | "audio" | "other";
-interface SettingsRow {
-    key: string;
-    label: string;
-    group: SettingsGroupId;
-    /** The model's control definition for this key. Standard rows are always
-     *  supported, so this is present; typed nullable for consumer convenience. */
-    control: ControlDefinition | null;
-    /** Always true for rows returned by buildSettingsRows (standard = supported). */
-    supported: boolean;
-    /** True when the current settings hold a non-null value for this key. */
-    hasValue: boolean;
+interface LocalModelsPort {
+    /** Must return the SAME array until the list changes (it is a store snapshot). */
+    getModels(): readonly LocalModelEntry[];
+    subscribe(listener: () => void): () => void;
+    /** Group heading. Default "On this computer". */
+    groupLabel?: string;
+    /**
+     * Open the local model in its own private conversation (the host's Confidential Chat), instead
+     * of switching this conversation to it. Present = a local pick calls ONLY this: the cloud value
+     * and the class pin stay untouched, and no draft or context is carried. Absent = the pick reports
+     * the id through `onValueChange` (the override path).
+     */
+    open?(id: string): void;
 }
 
 /**
@@ -350,9 +345,48 @@ interface SettingsWriteTarget {
     unbind?(key: string, control: ControlDefinition | null): void;
     /** Drop THIS target's change and show what it inherits again. */
     resetToInherited?(key: string): void;
+    /**
+     * The keys THIS target changed. The panel keeps a changed key it has no row for (the model
+     * does not declare it, and the change removed its value) on screen, so its reset stays
+     * reachable.
+     */
+    changedKeys?: readonly string[];
     /** The reset button's words, in the host's noun. Default "Reset to agent". */
     resetLabel?: string;
 }
+/**
+ * THE model row — the panel's first line, drawn by the panel with THE model picker
+ * (`ModelListDropdown`) in every host. Where a pick lands is the host's; the options below are
+ * capabilities a target has or lacks, exactly like `bind` / `resetToInherited` on the rows.
+ */
+interface ModelRowTarget {
+    /** The model shown (the effective one; a one-message pick while that is on). */
+    value: string | null;
+    change(modelId: string): void;
+    /** The pinned class (offering) of the shown model. */
+    pinnedOfferingId: string | null | undefined;
+    /** A class pick (the picker reports the class before the model). */
+    changePin(offeringId: string | undefined): void;
+    /** True when THIS target changed the model or its class. */
+    changedHere?: boolean;
+    /** Drop this target's model choice (model and class together). */
+    resetToInherited?(): void;
+    /** An explicit "no override" choice at the top of the list, in the host's words. */
+    emptyChoice?: {
+        label: string;
+        choose(): void;
+    };
+    /** The person's local models (a chat host's port). */
+    localModels?: LocalModelsPort | undefined;
+    disabled?: boolean;
+    /** Said on the read-only picker when `disabled`. */
+    disabledTitle?: string;
+    /** "This message only": while on, a pick applies to the next message, then goes back. */
+    oneMessage?: {
+        on: boolean;
+        change(next: boolean): void;
+    };
+}
 /** The frontend input capabilities (ui gates) shown under the settings groups. */
 interface CapabilitiesWriteTarget {
     values: UiGates;
@@ -364,35 +398,18 @@ interface CapabilitiesWriteTarget {
     error?: string | null;
 }
 
-interface ExtraSettingRowProps {
-    rowKey: string;
-    label: string;
-    value: unknown;
-    /**
-     * `translated`: kept as set and sent as this model's closest equivalent (the server
-     * converts it — never a warning). `unsupported`: this model has no such setting.
-     */
-    kind: "translated" | "unsupported";
-    onClear: () => void;
-    /** The conversation targets' reset (drop this target's change). */
-    onReset?: (() => void) | undefined;
-    resetLabel?: string | undefined;
-    disabled?: boolean | undefined;
-}
-/** A set value outside the model's own rows — the builder's "Translated" line, shared. */
-declare function ExtraSettingRow({ rowKey, label, value, kind, onClear, onReset, resetLabel, disabled }: ExtraSettingRowProps): React.JSX.Element;
 interface ModelSettingsPanelProps {
     /** The effective model's normalized controls (`null` until a model's controls are known). */
     controls: Record<string, unknown> | null;
-    /** The effective settings (marks `hasValue` on each catalog row). */
+    /** The effective settings (marks `hasValue` on each catalog row; the extra rows read them). */
     values: Record<string, unknown> | null;
     /** Where every change lands. */
     target: SettingsWriteTarget;
     /** Unique per mount (ids for labels and controls). */
     idPrefix: string;
-    /** The model picker, drawn as the panel's first row. */
-    model?: ReactNode;
-    /** Drawn between the model row and the groups: notices, the issue list, extra rows. */
+    /** THE model row, drawn as the panel's first line. */
+    model?: ModelRowTarget | undefined;
+    /** Drawn between the model row and the groups: notices, the issue list. */
     notices?: ReactNode;
     /** A row the host draws itself (the multi-speaker voice editor); `undefined` = the standard row. */
     renderRow?: (row: SettingsRow) => ReactNode | undefined;
@@ -429,12 +446,6 @@ declare function RowLabel({ htmlFor, muted, children }: {
     muted?: boolean;
     children: ReactNode;
 }): React.JSX.Element;
-/** One titled group of rows, drawn the same way for catalog groups and host groups. */
-declare function SettingsGroupSection({ id, title, children }: {
-    id: string;
-    title?: string | undefined;
-    children: ReactNode;
-}): React.JSX.Element;
 
 /** Subscribe to a slice of a settings store. `select` must return a stable value for unchanged state. */
 declare function useSettingsSelector<T>(store: SettingsStore, select: (state: AgentSettingsState) => T): T;
@@ -443,4 +454,4 @@ declare function useSettingsEntry(store: SettingsStore, agentId: string | null |
 /** Defaults merged with overrides for one agent; recomputed only when the entry changes. */
 declare function useEffectiveSettings(store: SettingsStore, agentId: string | null | undefined): Partial<AgentSettings>;
 
-export { ExtraSettingRow, type ExtraSettingRowProps, InputCapabilitiesEditor, type InputCapabilitiesEditorProps, ModelSettingsPanel, type ModelSettingsPanelProps, SettingControlInput, type SettingControlInputProps, SettingRowFrame, type SettingRowFrameProps, RowLabel as SettingRowLabel, SettingsGroupSection, formatSettingValue, useEffectiveSettings, useSettingsEntry, useSettingsSelector };
+export { ModelSettingsPanel, type ModelSettingsPanelProps, SettingRowFrame, type SettingRowFrameProps, RowLabel as SettingRowLabel, formatSettingValue, useEffectiveSettings, useSettingsEntry, useSettingsSelector };

package/dist/settings/react/index.d.ts

@@ -1,6 +1,6 @@
 import { components } from '@ai-matrx/api/types';
 import * as React from 'react';
-import { JSX, ReactNode } from 'react';
+import { ReactNode } from 'react';
 
 /**
  * Agent Settings — Type Definitions
@@ -166,16 +166,48 @@ interface SettingsStore {
     cancelModelSwitch(agentId: string): void;
 }
 
-interface SettingControlInputProps {
-    /** Setting key (snake_case) — used for ids and response_format handling. */
-    settingKey: string;
-    control: ControlDefinition;
-    value: unknown;
-    onChange: (value: unknown) => void;
-    disabled?: boolean;
-    id?: string;
+/**
+ * Model Settings Catalog — the single source of truth for the STANDARD
+ * settings list, and the one chokepoint that decides which keys it contains.
+ *
+ * ── The model (two distinct surfaces) ────────────────────────────────────────
+ *   1. STANDARD list  — ONLY the keys the selected model explicitly declares in
+ *      its `controls` config (i.e. the parameters this model actually supports).
+ *      `buildSettingsRows()` returns exactly these, grouped + ordered. Catalog
+ *      keys the model does not declare are NOT shown here.
+ *   2. CAUTION surface — settings the agent has SET that the model does NOT
+ *      support. These are never hidden: they are flagged as "not valid for this
+ *      model" and made repairable by the validation layer (the IssueTable, fed
+ *      by the `unsupported_by_model` rule). They do NOT belong in the standard
+ *      list — that is exactly the "showing all possible keys" bug.
+ *
+ * The catalog exists so the standard list's labels, grouping and order live
+ * in ONE place (previously copy-pasted as `textModelSettings` /
+ * `booleanSettings` / ... into three components, each filtering by
+ * `getControl(key)` inline — which drifted and regressed). Components map over
+ * `buildSettingsRows()`; they must not filter by model themselves (ESLint
+ * enforces). The original recurring bug — set values silently dropped when a
+ * model didn't support them — is fixed by the CAUTION surface, not by dumping
+ * every key into the standard list.
+ *
+ * Guardrail: `settings-catalogue.test.ts` asserts the standard list contains
+ * ONLY supported keys (never the full catalog), and `unsupported-by-model.
+ * test.ts` asserts set-but-unsupported keys surface in the caution layer.
+ */
+
+type SettingsGroupId = "text" | "featureFlags" | "imageVideo" | "audio" | "other";
+interface SettingsRow {
+    key: string;
+    label: string;
+    group: SettingsGroupId;
+    /** The model's control definition for this key. Standard rows are always
+     *  supported, so this is present; typed nullable for consumer convenience. */
+    control: ControlDefinition | null;
+    /** Always true for rows returned by buildSettingsRows (standard = supported). */
+    supported: boolean;
+    /** True when the current settings hold a non-null value for this key. */
+    hasValue: boolean;
 }
-declare function SettingControlInput({ settingKey, control, value, onChange, disabled, id, }: SettingControlInputProps): React.JSX.Element;
 
 /**
  * UI Gates — canonical model-gated UI flags.
@@ -219,72 +251,35 @@ interface UiGates {
 declare const UI_GATE_EDITABLE_KEYS: readonly ["image_urls", "file_urls", "youtube_videos"];
 type UiGateEditableKey = (typeof UI_GATE_EDITABLE_KEYS)[number];
 
-/**
- * THE input-capabilities group (agent core B4): the per-agent / per-run UI gates (image URLs,
- * file URLs, YouTube), drawn on THE model-settings panel's row frame so it lines up with the
- * settings above it — in the builder and in every override screen alike. Controlled: the
- * caller owns `values` and decides what a change means (the builder writes the agent's
- * ui_gates; a conversation writes its own capability overrides, each with a reset).
- */
-
-interface InputCapabilitiesEditorProps {
-    values: UiGates;
-    onChange: (key: UiGateEditableKey, value: boolean) => void;
-    /** Keys the caller changed itself; each gets a reset to what it inherits. */
-    changedKeys?: ReadonlySet<UiGateEditableKey> | undefined;
-    onReset?: ((key: UiGateEditableKey) => void) | undefined;
-    /** The reset button's words. Default "Reset to agent". */
-    resetLabel?: string | undefined;
-    /** Said under the rows when saving failed. */
-    error?: string | null | undefined;
-    idPrefix: string;
-    title?: string;
-    disabled?: boolean;
+/** One model a host runs on the person's own computer. */
+interface LocalModelEntry {
+    /** The value `onValueChange` receives (the conversation's model override). */
+    id: string;
+    name: string;
+    /** Brand glyph key (e.g. "Meta"); absent draws the neutral glyph. */
+    maker?: string | null;
+    contextWindow?: number | null;
+    /** The computer cannot hold it today: the row is dimmed and says why, but stays pickable. */
+    needsMoreMemory?: boolean;
 }
-/** Shared builder/runtime editor for frontend-only run capabilities. */
-declare function InputCapabilitiesEditor({ values, onChange, changedKeys, onReset, resetLabel, error, idPrefix, title, disabled, }: InputCapabilitiesEditorProps): JSX.Element;
-
 /**
- * Model Settings Catalog — the single source of truth for the STANDARD
- * settings list, and the one chokepoint that decides which keys it contains.
- *
- * ── The model (two distinct surfaces) ────────────────────────────────────────
- *   1. STANDARD list  — ONLY the keys the selected model explicitly declares in
- *      its `controls` config (i.e. the parameters this model actually supports).
- *      `buildSettingsRows()` returns exactly these, grouped + ordered. Catalog
- *      keys the model does not declare are NOT shown here.
- *   2. CAUTION surface — settings the agent has SET that the model does NOT
- *      support. These are never hidden: they are flagged as "not valid for this
- *      model" and made repairable by the validation layer (the IssueTable, fed
- *      by the `unsupported_by_model` rule). They do NOT belong in the standard
- *      list — that is exactly the "showing all possible keys" bug.
- *
- * The catalog exists so the standard list's labels, grouping and order live
- * in ONE place (previously copy-pasted as `textModelSettings` /
- * `booleanSettings` / ... into three components, each filtering by
- * `getControl(key)` inline — which drifted and regressed). Components map over
- * `buildSettingsRows()`; they must not filter by model themselves (ESLint
- * enforces). The original recurring bug — set values silently dropped when a
- * model didn't support them — is fixed by the CAUTION surface, not by dumping
- * every key into the standard list.
- *
- * Guardrail: `settings-catalogue.test.ts` asserts the standard list contains
- * ONLY supported keys (never the full catalog), and `unsupported-by-model.
- * test.ts` asserts set-but-unsupported keys surface in the caution layer.
+ * The host's local-model source (a store: `getModels` + `subscribe`, like the catalog). The picker
+ * draws its models as one "On this computer" group marked local. Start/Stop and getting more
+ * models stay the host's own screens.
  */
-
-type SettingsGroupId = "text" | "featureFlags" | "imageVideo" | "audio" | "other";
-interface SettingsRow {
-    key: string;
-    label: string;
-    group: SettingsGroupId;
-    /** The model's control definition for this key. Standard rows are always
-     *  supported, so this is present; typed nullable for consumer convenience. */
-    control: ControlDefinition | null;
-    /** Always true for rows returned by buildSettingsRows (standard = supported). */
-    supported: boolean;
-    /** True when the current settings hold a non-null value for this key. */
-    hasValue: boolean;
+interface LocalModelsPort {
+    /** Must return the SAME array until the list changes (it is a store snapshot). */
+    getModels(): readonly LocalModelEntry[];
+    subscribe(listener: () => void): () => void;
+    /** Group heading. Default "On this computer". */
+    groupLabel?: string;
+    /**
+     * Open the local model in its own private conversation (the host's Confidential Chat), instead
+     * of switching this conversation to it. Present = a local pick calls ONLY this: the cloud value
+     * and the class pin stay untouched, and no draft or context is carried. Absent = the pick reports
+     * the id through `onValueChange` (the override path).
+     */
+    open?(id: string): void;
 }
 
 /**
@@ -350,9 +345,48 @@ interface SettingsWriteTarget {
     unbind?(key: string, control: ControlDefinition | null): void;
     /** Drop THIS target's change and show what it inherits again. */
     resetToInherited?(key: string): void;
+    /**
+     * The keys THIS target changed. The panel keeps a changed key it has no row for (the model
+     * does not declare it, and the change removed its value) on screen, so its reset stays
+     * reachable.
+     */
+    changedKeys?: readonly string[];
     /** The reset button's words, in the host's noun. Default "Reset to agent". */
     resetLabel?: string;
 }
+/**
+ * THE model row — the panel's first line, drawn by the panel with THE model picker
+ * (`ModelListDropdown`) in every host. Where a pick lands is the host's; the options below are
+ * capabilities a target has or lacks, exactly like `bind` / `resetToInherited` on the rows.
+ */
+interface ModelRowTarget {
+    /** The model shown (the effective one; a one-message pick while that is on). */
+    value: string | null;
+    change(modelId: string): void;
+    /** The pinned class (offering) of the shown model. */
+    pinnedOfferingId: string | null | undefined;
+    /** A class pick (the picker reports the class before the model). */
+    changePin(offeringId: string | undefined): void;
+    /** True when THIS target changed the model or its class. */
+    changedHere?: boolean;
+    /** Drop this target's model choice (model and class together). */
+    resetToInherited?(): void;
+    /** An explicit "no override" choice at the top of the list, in the host's words. */
+    emptyChoice?: {
+        label: string;
+        choose(): void;
+    };
+    /** The person's local models (a chat host's port). */
+    localModels?: LocalModelsPort | undefined;
+    disabled?: boolean;
+    /** Said on the read-only picker when `disabled`. */
+    disabledTitle?: string;
+    /** "This message only": while on, a pick applies to the next message, then goes back. */
+    oneMessage?: {
+        on: boolean;
+        change(next: boolean): void;
+    };
+}
 /** The frontend input capabilities (ui gates) shown under the settings groups. */
 interface CapabilitiesWriteTarget {
     values: UiGates;
@@ -364,35 +398,18 @@ interface CapabilitiesWriteTarget {
     error?: string | null;
 }
 
-interface ExtraSettingRowProps {
-    rowKey: string;
-    label: string;
-    value: unknown;
-    /**
-     * `translated`: kept as set and sent as this model's closest equivalent (the server
-     * converts it — never a warning). `unsupported`: this model has no such setting.
-     */
-    kind: "translated" | "unsupported";
-    onClear: () => void;
-    /** The conversation targets' reset (drop this target's change). */
-    onReset?: (() => void) | undefined;
-    resetLabel?: string | undefined;
-    disabled?: boolean | undefined;
-}
-/** A set value outside the model's own rows — the builder's "Translated" line, shared. */
-declare function ExtraSettingRow({ rowKey, label, value, kind, onClear, onReset, resetLabel, disabled }: ExtraSettingRowProps): React.JSX.Element;
 interface ModelSettingsPanelProps {
     /** The effective model's normalized controls (`null` until a model's controls are known). */
     controls: Record<string, unknown> | null;
-    /** The effective settings (marks `hasValue` on each catalog row). */
+    /** The effective settings (marks `hasValue` on each catalog row; the extra rows read them). */
     values: Record<string, unknown> | null;
     /** Where every change lands. */
     target: SettingsWriteTarget;
     /** Unique per mount (ids for labels and controls). */
     idPrefix: string;
-    /** The model picker, drawn as the panel's first row. */
-    model?: ReactNode;
-    /** Drawn between the model row and the groups: notices, the issue list, extra rows. */
+    /** THE model row, drawn as the panel's first line. */
+    model?: ModelRowTarget | undefined;
+    /** Drawn between the model row and the groups: notices, the issue list. */
     notices?: ReactNode;
     /** A row the host draws itself (the multi-speaker voice editor); `undefined` = the standard row. */
     renderRow?: (row: SettingsRow) => ReactNode | undefined;
@@ -429,12 +446,6 @@ declare function RowLabel({ htmlFor, muted, children }: {
     muted?: boolean;
     children: ReactNode;
 }): React.JSX.Element;
-/** One titled group of rows, drawn the same way for catalog groups and host groups. */
-declare function SettingsGroupSection({ id, title, children }: {
-    id: string;
-    title?: string | undefined;
-    children: ReactNode;
-}): React.JSX.Element;
 
 /** Subscribe to a slice of a settings store. `select` must return a stable value for unchanged state. */
 declare function useSettingsSelector<T>(store: SettingsStore, select: (state: AgentSettingsState) => T): T;
@@ -443,4 +454,4 @@ declare function useSettingsEntry(store: SettingsStore, agentId: string | null |
 /** Defaults merged with overrides for one agent; recomputed only when the entry changes. */
 declare function useEffectiveSettings(store: SettingsStore, agentId: string | null | undefined): Partial<AgentSettings>;
 
-export { ExtraSettingRow, type ExtraSettingRowProps, InputCapabilitiesEditor, type InputCapabilitiesEditorProps, ModelSettingsPanel, type ModelSettingsPanelProps, SettingControlInput, type SettingControlInputProps, SettingRowFrame, type SettingRowFrameProps, RowLabel as SettingRowLabel, SettingsGroupSection, formatSettingValue, useEffectiveSettings, useSettingsEntry, useSettingsSelector };
+export { ModelSettingsPanel, type ModelSettingsPanelProps, SettingRowFrame, type SettingRowFrameProps, RowLabel as SettingRowLabel, formatSettingValue, useEffectiveSettings, useSettingsEntry, useSettingsSelector };