@ai-matrx/agents 0.59.189 → 0.59.191

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 } from 'react';
+import { JSX, ReactNode } from 'react';
 
 /**
  * Agent Settings — Type Definitions
@@ -166,25 +166,16 @@ interface SettingsStore {
     cancelModelSwitch(agentId: string): void;
 }
 
-/** The enum value that means "off" when a control declares it. */
-declare const ENUM_OFF_VALUE = "none";
 interface SettingControlInputProps {
     /** Setting key (snake_case) — used for ids and response_format handling. */
     settingKey: string;
-    explicitState?: boolean;
     control: ControlDefinition;
     value: unknown;
     onChange: (value: unknown) => void;
     disabled?: boolean;
     id?: string;
-    /**
-     * "dense" (default) = the builder's in-row controls. "comfortable" = menu
-     * sizing for the composer's Model panel and the Chat Options window: 36px
-     * controls (44px on touch), text-sm, and a Switch for booleans.
-     */
-    size?: "dense" | "comfortable";
 }
-declare function SettingControlInput({ settingKey, explicitState, control, value, onChange, disabled, id, size, }: SettingControlInputProps): React.JSX.Element;
+declare function SettingControlInput({ settingKey, control, value, onChange, disabled, id, }: SettingControlInputProps): React.JSX.Element;
 
 /**
  * UI Gates — canonical model-gated UI flags.
@@ -229,26 +220,221 @@ declare const UI_GATE_EDITABLE_KEYS: readonly ["image_urls", "file_urls", "youtu
 type UiGateEditableKey = (typeof UI_GATE_EDITABLE_KEYS)[number];
 
 /**
- * THE input-capabilities editor (agent core B4): the per-agent / per-run UI gates (image URLs,
- * file URLs, YouTube). Controlled — the caller owns `values` and decides what a change means.
+ * 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;
-    overriddenKeys?: ReadonlySet<UiGateEditableKey>;
-    onReset?: (key: UiGateEditableKey) => 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;
+}
+/** 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.
+ */
+
+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;
+}
+
+/**
+ * THE SETTINGS WRITE TARGET — the one seam between THE model-settings panel
+ * (`./react/ModelSettingsPanel`) and whatever a change is written to.
+ *
+ * Owner ruling, 2026-10-21: one settings experience. The agent builder and the
+ * chat's "Model and overrides" render the SAME rows, controls, labels and
+ * order; they differ ONLY in where a change lands. The builder's target writes
+ * the agent; a conversation's (or a binding's, a mandate's, a shortcut's)
+ * target writes that record's overrides and adds a per-row reset back to what
+ * it inherits. The panel never knows which.
+ *
+ * Every method is the person's intent in the panel's words — never a store
+ * action. Optional methods are optional ACTIONS: a target that cannot bind a
+ * control to a run input simply has no `bind`, and the panel draws no button.
+ */
+
+/** What one row shows. Off is a `set` value the panel recognizes (setting-state). */
+type SettingRowView = 
+/** Key absent: the model's own default applies. */
+{
+    state: "unset";
+    modelDefault?: unknown;
+}
+/** A saved / effective value. */
+ | {
+    state: "set";
+    value: unknown;
+}
+/** The setting is a run input: its value comes from `{{variableName}}`. */
+ | {
+    state: "bound";
+    variableName: string;
+    value: unknown;
+};
+/** What the target knows about a row beyond its value. */
+interface SettingRowFacts {
+    /** True when THIS target changed the row (a conversation override). */
+    changedHere?: boolean;
+    /** Where the shown value comes from, in the host's words ("Agent", "Organization"). */
+    source?: string;
+    /** The row's first validation issue, when the target validates. */
+    issue?: {
+        message: string;
+        fixable: boolean;
+    };
+}
+type SettingRowRead = SettingRowView & SettingRowFacts;
+interface SettingsWriteTarget {
+    read(key: string, control: ControlDefinition | null): SettingRowRead;
+    /** The person edited the control. */
+    change(key: string, value: unknown, control: ControlDefinition | null): void;
+    /** The person ticked an unset row (store `startingValueFor`). */
+    turnOn(key: string, control: ControlDefinition): void;
+    /** The person cleared the row back to "not set". */
+    clear(key: string): void;
+    /** One-click repair of the row's issue. */
+    fix?(key: string): void;
+    /** May this row become a run input? (Builder only.) */
+    canBind?(key: string): boolean;
+    bind?(key: string, control: ControlDefinition): void;
+    unbind?(key: string, control: ControlDefinition | null): void;
+    /** Drop THIS target's change and show what it inherits again. */
+    resetToInherited?(key: string): void;
+    /** The reset button's words, in the host's noun. Default "Reset to agent". */
+    resetLabel?: string;
+}
+/** The frontend input capabilities (ui gates) shown under the settings groups. */
+interface CapabilitiesWriteTarget {
+    values: UiGates;
+    change(key: UiGateEditableKey, value: boolean): void;
+    /** Keys THIS target changed; each gets its own reset. */
+    changedKeys?: ReadonlySet<UiGateEditableKey>;
+    resetToInherited?(key: UiGateEditableKey): void;
+    /** Said under the rows when saving the capabilities failed. */
+    error?: string | null;
+}
+
+interface ExtraSettingRowProps {
+    rowKey: string;
+    label: string;
+    value: unknown;
     /**
-     * "settings" (default) = the agent builder's rows with a one-line
-     * description. "menu" = the composer/Chat Options sizing: label + switch
-     * only, 36px rows (44px on touch), text-sm, 28px Reset when overridden.
+     * `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.
      */
-    variant?: "settings" | "menu";
+    kind: "translated" | "unsupported";
+    onClear: () => void;
+    /** The conversation targets' reset (drop this target's change). */
+    onReset?: (() => void) | undefined;
+    resetLabel?: string | undefined;
+    disabled?: boolean | undefined;
 }
-/** Shared builder/runtime editor for frontend-only run capabilities. */
-declare function InputCapabilitiesEditor({ values, onChange, overriddenKeys, onReset, idPrefix, title, variant, }: InputCapabilitiesEditorProps): JSX.Element;
+/** 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). */
+    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. */
+    notices?: ReactNode;
+    /** A row the host draws itself (the multi-speaker voice editor); `undefined` = the standard row. */
+    renderRow?: (row: SettingsRow) => ReactNode | undefined;
+    /** The input capabilities group, under the settings groups. */
+    capabilities?: CapabilitiesWriteTarget | undefined;
+    /** Said where the rows would be when the model declares none (or no model is chosen). */
+    emptyNote?: ReactNode;
+    disabled?: boolean;
+}
+declare function ModelSettingsPanel({ controls, values, target, idPrefix, model, notices, renderRow, capabilities, emptyNote, disabled, }: ModelSettingsPanelProps): React.JSX.Element;
+
+/** A catalog value as the person reads it ("On", "auto", "1024"). */
+declare function formatSettingValue(value: unknown): string;
+interface SettingRowFrameProps {
+    /** `data-setting-row` — the setting key (or a host row name such as "model"). */
+    rowKey: string;
+    /** `data-setting-state` — unset | set | off | bound | translated | … */
+    state?: string;
+    /** The 16px leading column: the row's checkbox, or an icon. */
+    leading?: ReactNode;
+    label: ReactNode;
+    /** The control, or the row's value text. */
+    children?: ReactNode;
+    /** Fixed-width icons on the right: status, then actions. */
+    actions?: ReactNode;
+}
+/**
+ * The one row geometry every line of the panel uses — setting rows, the model row, the
+ * translated rows, the voice row and the input capabilities — so their edges line up.
+ */
+declare function SettingRowFrame({ rowKey, state, leading, label, children, actions }: SettingRowFrameProps): React.JSX.Element;
+declare function RowLabel({ htmlFor, muted, children }: {
+    htmlFor?: string;
+    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;
@@ -257,4 +443,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 { ENUM_OFF_VALUE, InputCapabilitiesEditor, type InputCapabilitiesEditorProps, SettingControlInput, type SettingControlInputProps, useEffectiveSettings, useSettingsEntry, useSettingsSelector };
+export { ExtraSettingRow, type ExtraSettingRowProps, InputCapabilitiesEditor, type InputCapabilitiesEditorProps, ModelSettingsPanel, type ModelSettingsPanelProps, SettingControlInput, type SettingControlInputProps, SettingRowFrame, type SettingRowFrameProps, RowLabel as SettingRowLabel, SettingsGroupSection, 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 } from 'react';
+import { JSX, ReactNode } from 'react';
 
 /**
  * Agent Settings — Type Definitions
@@ -166,25 +166,16 @@ interface SettingsStore {
     cancelModelSwitch(agentId: string): void;
 }
 
-/** The enum value that means "off" when a control declares it. */
-declare const ENUM_OFF_VALUE = "none";
 interface SettingControlInputProps {
     /** Setting key (snake_case) — used for ids and response_format handling. */
     settingKey: string;
-    explicitState?: boolean;
     control: ControlDefinition;
     value: unknown;
     onChange: (value: unknown) => void;
     disabled?: boolean;
     id?: string;
-    /**
-     * "dense" (default) = the builder's in-row controls. "comfortable" = menu
-     * sizing for the composer's Model panel and the Chat Options window: 36px
-     * controls (44px on touch), text-sm, and a Switch for booleans.
-     */
-    size?: "dense" | "comfortable";
 }
-declare function SettingControlInput({ settingKey, explicitState, control, value, onChange, disabled, id, size, }: SettingControlInputProps): React.JSX.Element;
+declare function SettingControlInput({ settingKey, control, value, onChange, disabled, id, }: SettingControlInputProps): React.JSX.Element;
 
 /**
  * UI Gates — canonical model-gated UI flags.
@@ -229,26 +220,221 @@ declare const UI_GATE_EDITABLE_KEYS: readonly ["image_urls", "file_urls", "youtu
 type UiGateEditableKey = (typeof UI_GATE_EDITABLE_KEYS)[number];
 
 /**
- * THE input-capabilities editor (agent core B4): the per-agent / per-run UI gates (image URLs,
- * file URLs, YouTube). Controlled — the caller owns `values` and decides what a change means.
+ * 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;
-    overriddenKeys?: ReadonlySet<UiGateEditableKey>;
-    onReset?: (key: UiGateEditableKey) => 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;
+}
+/** 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.
+ */
+
+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;
+}
+
+/**
+ * THE SETTINGS WRITE TARGET — the one seam between THE model-settings panel
+ * (`./react/ModelSettingsPanel`) and whatever a change is written to.
+ *
+ * Owner ruling, 2026-10-21: one settings experience. The agent builder and the
+ * chat's "Model and overrides" render the SAME rows, controls, labels and
+ * order; they differ ONLY in where a change lands. The builder's target writes
+ * the agent; a conversation's (or a binding's, a mandate's, a shortcut's)
+ * target writes that record's overrides and adds a per-row reset back to what
+ * it inherits. The panel never knows which.
+ *
+ * Every method is the person's intent in the panel's words — never a store
+ * action. Optional methods are optional ACTIONS: a target that cannot bind a
+ * control to a run input simply has no `bind`, and the panel draws no button.
+ */
+
+/** What one row shows. Off is a `set` value the panel recognizes (setting-state). */
+type SettingRowView = 
+/** Key absent: the model's own default applies. */
+{
+    state: "unset";
+    modelDefault?: unknown;
+}
+/** A saved / effective value. */
+ | {
+    state: "set";
+    value: unknown;
+}
+/** The setting is a run input: its value comes from `{{variableName}}`. */
+ | {
+    state: "bound";
+    variableName: string;
+    value: unknown;
+};
+/** What the target knows about a row beyond its value. */
+interface SettingRowFacts {
+    /** True when THIS target changed the row (a conversation override). */
+    changedHere?: boolean;
+    /** Where the shown value comes from, in the host's words ("Agent", "Organization"). */
+    source?: string;
+    /** The row's first validation issue, when the target validates. */
+    issue?: {
+        message: string;
+        fixable: boolean;
+    };
+}
+type SettingRowRead = SettingRowView & SettingRowFacts;
+interface SettingsWriteTarget {
+    read(key: string, control: ControlDefinition | null): SettingRowRead;
+    /** The person edited the control. */
+    change(key: string, value: unknown, control: ControlDefinition | null): void;
+    /** The person ticked an unset row (store `startingValueFor`). */
+    turnOn(key: string, control: ControlDefinition): void;
+    /** The person cleared the row back to "not set". */
+    clear(key: string): void;
+    /** One-click repair of the row's issue. */
+    fix?(key: string): void;
+    /** May this row become a run input? (Builder only.) */
+    canBind?(key: string): boolean;
+    bind?(key: string, control: ControlDefinition): void;
+    unbind?(key: string, control: ControlDefinition | null): void;
+    /** Drop THIS target's change and show what it inherits again. */
+    resetToInherited?(key: string): void;
+    /** The reset button's words, in the host's noun. Default "Reset to agent". */
+    resetLabel?: string;
+}
+/** The frontend input capabilities (ui gates) shown under the settings groups. */
+interface CapabilitiesWriteTarget {
+    values: UiGates;
+    change(key: UiGateEditableKey, value: boolean): void;
+    /** Keys THIS target changed; each gets its own reset. */
+    changedKeys?: ReadonlySet<UiGateEditableKey>;
+    resetToInherited?(key: UiGateEditableKey): void;
+    /** Said under the rows when saving the capabilities failed. */
+    error?: string | null;
+}
+
+interface ExtraSettingRowProps {
+    rowKey: string;
+    label: string;
+    value: unknown;
     /**
-     * "settings" (default) = the agent builder's rows with a one-line
-     * description. "menu" = the composer/Chat Options sizing: label + switch
-     * only, 36px rows (44px on touch), text-sm, 28px Reset when overridden.
+     * `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.
      */
-    variant?: "settings" | "menu";
+    kind: "translated" | "unsupported";
+    onClear: () => void;
+    /** The conversation targets' reset (drop this target's change). */
+    onReset?: (() => void) | undefined;
+    resetLabel?: string | undefined;
+    disabled?: boolean | undefined;
 }
-/** Shared builder/runtime editor for frontend-only run capabilities. */
-declare function InputCapabilitiesEditor({ values, onChange, overriddenKeys, onReset, idPrefix, title, variant, }: InputCapabilitiesEditorProps): JSX.Element;
+/** 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). */
+    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. */
+    notices?: ReactNode;
+    /** A row the host draws itself (the multi-speaker voice editor); `undefined` = the standard row. */
+    renderRow?: (row: SettingsRow) => ReactNode | undefined;
+    /** The input capabilities group, under the settings groups. */
+    capabilities?: CapabilitiesWriteTarget | undefined;
+    /** Said where the rows would be when the model declares none (or no model is chosen). */
+    emptyNote?: ReactNode;
+    disabled?: boolean;
+}
+declare function ModelSettingsPanel({ controls, values, target, idPrefix, model, notices, renderRow, capabilities, emptyNote, disabled, }: ModelSettingsPanelProps): React.JSX.Element;
+
+/** A catalog value as the person reads it ("On", "auto", "1024"). */
+declare function formatSettingValue(value: unknown): string;
+interface SettingRowFrameProps {
+    /** `data-setting-row` — the setting key (or a host row name such as "model"). */
+    rowKey: string;
+    /** `data-setting-state` — unset | set | off | bound | translated | … */
+    state?: string;
+    /** The 16px leading column: the row's checkbox, or an icon. */
+    leading?: ReactNode;
+    label: ReactNode;
+    /** The control, or the row's value text. */
+    children?: ReactNode;
+    /** Fixed-width icons on the right: status, then actions. */
+    actions?: ReactNode;
+}
+/**
+ * The one row geometry every line of the panel uses — setting rows, the model row, the
+ * translated rows, the voice row and the input capabilities — so their edges line up.
+ */
+declare function SettingRowFrame({ rowKey, state, leading, label, children, actions }: SettingRowFrameProps): React.JSX.Element;
+declare function RowLabel({ htmlFor, muted, children }: {
+    htmlFor?: string;
+    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;
@@ -257,4 +443,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 { ENUM_OFF_VALUE, InputCapabilitiesEditor, type InputCapabilitiesEditorProps, SettingControlInput, type SettingControlInputProps, useEffectiveSettings, useSettingsEntry, useSettingsSelector };
+export { ExtraSettingRow, type ExtraSettingRowProps, InputCapabilitiesEditor, type InputCapabilitiesEditorProps, ModelSettingsPanel, type ModelSettingsPanelProps, SettingControlInput, type SettingControlInputProps, SettingRowFrame, type SettingRowFrameProps, RowLabel as SettingRowLabel, SettingsGroupSection, formatSettingValue, useEffectiveSettings, useSettingsEntry, useSettingsSelector };