@ai-matrx/agents 0.59.194 → 0.59.196

package/CHANGELOG.md

@@ -1,10 +1,15 @@
 # Changelog
 
-## 0.59.194
+## 0.59.196
 
 UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
 Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/matrx-agents/src`.
 
+## 0.59.194
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 3165453310 87a717ae91 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.193
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 7829f4d91a 3165453310 -- apps/shared/matrx-agents/src`

package/dist/content-transfer/index.cjs

@@ -703,7 +703,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.194 — no longer declared in
+   * @deprecated retiring since 0.59.196 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/content-transfer/index.js

@@ -680,7 +680,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.194 — no longer declared in
+   * @deprecated retiring since 0.59.196 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/content-transfer/react/index.cjs

@@ -656,7 +656,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.194 — no longer declared in
+   * @deprecated retiring since 0.59.196 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/content-transfer/react/index.js

@@ -628,7 +628,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.194 — no longer declared in
+   * @deprecated retiring since 0.59.196 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/mandates/index.cjs

@@ -47,9 +47,9 @@ module.exports = __toCommonJS(mandates_exports);
 
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "87a717ae91835903eb5181b979e7adb555fb6e10",
+  aidreamRevision: "565b77216165498cb70a34094db8dae6e63fc134",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.194",
+  packageVersion: "0.59.196",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -666,7 +666,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.194 — no longer declared in
+   * @deprecated retiring since 0.59.196 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */
@@ -693,7 +693,7 @@ var MANDATE_KEYS = {
 var ALL_MANDATE_KEYS = Object.values(MANDATE_KEYS);
 var RETIRING_MANDATE_KEYS = {
   "brand_discovery.offering_roles": "0.59.0",
-  "coding_session.managed_translation_reference": "0.59.194",
+  "coding_session.managed_translation_reference": "0.59.196",
   "pdf.content_cleaner": "0.59.0",
   "sms.owner_beta": "0.59.0",
   "voice.owner_beta": "0.59.0"

package/dist/mandates/index.d.cts

@@ -6,9 +6,9 @@
  * from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
  * boot sync writes to the database from. There is no hand list anywhere.
  *
- * aidream revision:   87a717ae91835903eb5181b979e7adb555fb6e10
+ * aidream revision:   565b77216165498cb70a34094db8dae6e63fc134
  * generator version:  1.0.0
- * package version:    0.59.194
+ * package version:    0.59.196
  * active keys:        606
  * retiring keys:      5
  *
@@ -19,9 +19,9 @@
  */
 /** Where this module came from — surfaced so a report can name the exact build. */
 declare const MANDATE_KEYS_META: {
-    readonly aidreamRevision: "87a717ae91835903eb5181b979e7adb555fb6e10";
+    readonly aidreamRevision: "565b77216165498cb70a34094db8dae6e63fc134";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.194";
+    readonly packageVersion: "0.59.196";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -639,7 +639,7 @@ declare const MANDATE_KEYS: {
      */
     readonly brand_discovery__offering_roles: "brand_discovery.offering_roles";
     /**
-     * @deprecated retiring since 0.59.194 — no longer declared in
+     * @deprecated retiring since 0.59.196 — no longer declared in
      * aidream. It leaves this union once no snapshot within the last
      * 3 published versions still carries it as active.
      */
@@ -670,7 +670,7 @@ declare const ALL_MANDATE_KEYS: readonly MandateKey[];
 /** Keys still in the union but no longer declared (two-phase retire, phase 1). */
 declare const RETIRING_MANDATE_KEYS: {
     readonly "brand_discovery.offering_roles": "0.59.0";
-    readonly "coding_session.managed_translation_reference": "0.59.194";
+    readonly "coding_session.managed_translation_reference": "0.59.196";
     readonly "pdf.content_cleaner": "0.59.0";
     readonly "sms.owner_beta": "0.59.0";
     readonly "voice.owner_beta": "0.59.0";

package/dist/mandates/index.d.ts

@@ -6,9 +6,9 @@
  * from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
  * boot sync writes to the database from. There is no hand list anywhere.
  *
- * aidream revision:   87a717ae91835903eb5181b979e7adb555fb6e10
+ * aidream revision:   565b77216165498cb70a34094db8dae6e63fc134
  * generator version:  1.0.0
- * package version:    0.59.194
+ * package version:    0.59.196
  * active keys:        606
  * retiring keys:      5
  *
@@ -19,9 +19,9 @@
  */
 /** Where this module came from — surfaced so a report can name the exact build. */
 declare const MANDATE_KEYS_META: {
-    readonly aidreamRevision: "87a717ae91835903eb5181b979e7adb555fb6e10";
+    readonly aidreamRevision: "565b77216165498cb70a34094db8dae6e63fc134";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.194";
+    readonly packageVersion: "0.59.196";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -639,7 +639,7 @@ declare const MANDATE_KEYS: {
      */
     readonly brand_discovery__offering_roles: "brand_discovery.offering_roles";
     /**
-     * @deprecated retiring since 0.59.194 — no longer declared in
+     * @deprecated retiring since 0.59.196 — no longer declared in
      * aidream. It leaves this union once no snapshot within the last
      * 3 published versions still carries it as active.
      */
@@ -670,7 +670,7 @@ declare const ALL_MANDATE_KEYS: readonly MandateKey[];
 /** Keys still in the union but no longer declared (two-phase retire, phase 1). */
 declare const RETIRING_MANDATE_KEYS: {
     readonly "brand_discovery.offering_roles": "0.59.0";
-    readonly "coding_session.managed_translation_reference": "0.59.194";
+    readonly "coding_session.managed_translation_reference": "0.59.196";
     readonly "pdf.content_cleaner": "0.59.0";
     readonly "sms.owner_beta": "0.59.0";
     readonly "voice.owner_beta": "0.59.0";

package/dist/mandates/index.js

@@ -1,8 +1,8 @@
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "87a717ae91835903eb5181b979e7adb555fb6e10",
+  aidreamRevision: "565b77216165498cb70a34094db8dae6e63fc134",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.194",
+  packageVersion: "0.59.196",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -619,7 +619,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.194 — no longer declared in
+   * @deprecated retiring since 0.59.196 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */
@@ -646,7 +646,7 @@ var MANDATE_KEYS = {
 var ALL_MANDATE_KEYS = Object.values(MANDATE_KEYS);
 var RETIRING_MANDATE_KEYS = {
   "brand_discovery.offering_roles": "0.59.0",
-  "coding_session.managed_translation_reference": "0.59.194",
+  "coding_session.managed_translation_reference": "0.59.196",
   "pdf.content_cleaner": "0.59.0",
   "sms.owner_beta": "0.59.0",
   "voice.owner_beta": "0.59.0"

package/dist/settings/index.cjs

@@ -35,6 +35,7 @@ __export(settings_exports, {
   createSettingsStore: () => createSettingsStore,
   detectConflicts: () => detectConflicts,
   effectiveOfferingPinOf: () => effectiveOfferingPinOf,
+  extraSettingKeys: () => extraSettingKeys,
   extractModelDefaults: () => extractModelDefaults,
   gateEnabled: () => gateEnabled,
   getActionForMode: () => getActionForMode,
@@ -56,6 +57,7 @@ __export(settings_exports, {
   readSettingsEntry: () => readSettingsEntry,
   resolveConflicts: () => resolveConflicts,
   sanitizeSettings: () => sanitizeSettings,
+  settingLabel: () => settingLabel,
   settingStateOf: () => settingStateOf,
   startingValueFor: () => startingValueFor,
   withSettingState: () => withSettingState
@@ -97,6 +99,83 @@ function gateEnabled(gates, key) {
   return gates?.[key] === true;
 }
 
+// generated/llm-enums.ts
+var LLM_PARAMS_KEYS = [
+  "model",
+  "offering_id",
+  "max_output_tokens",
+  "temperature",
+  "top_p",
+  "top_k",
+  "tool_choice",
+  "parallel_tool_calls",
+  "reasoning_effort",
+  "reasoning_summary",
+  "visualization",
+  "thinking_level",
+  "include_thoughts",
+  "thinking_budget",
+  "clear_thinking",
+  "disable_reasoning",
+  "response_format",
+  "stop_sequences",
+  "stream",
+  "store",
+  "extended_prompt_cache",
+  "previous_interaction_id",
+  "task",
+  "verbosity",
+  "internal_web_search",
+  "internal_url_context",
+  "internal_x_search",
+  "aspect_ratio",
+  "width",
+  "height",
+  "count",
+  "render_quality",
+  "background",
+  "output_compression",
+  "moderation",
+  "input_fidelity",
+  "partial_images",
+  "style",
+  "reference_strength",
+  "tts_voice",
+  "audio_format",
+  "performance_direction",
+  "speech_speed",
+  "turn_pause_ms",
+  "language_code",
+  "duration_seconds",
+  "resolution",
+  "fps",
+  "steps",
+  "seed",
+  "guidance_scale",
+  "encode_quality",
+  "negative_prompt",
+  "output_format",
+  "frame_images",
+  "reference_images",
+  "image_loras",
+  "disable_safety_checker",
+  "generate_audio",
+  "enhance_prompt",
+  "camera_control",
+  "image_input",
+  "image_inputs",
+  "mask",
+  "last_frame_image",
+  "video_input",
+  "video_action",
+  "custom_tools",
+  "mcp_servers",
+  "compaction_settings",
+  "detected_contexts",
+  "dictionary",
+  "tts_quality"
+];
+
 // settings/settings-catalogue.ts
 var import_text_case = require("@ai-matrx/kit/text-case");
 var CONTROL_TYPES = [
@@ -268,83 +347,33 @@ function buildSettingsRows(controls, settings) {
   }
   return groups;
 }
-
-// generated/llm-enums.ts
-var LLM_PARAMS_KEYS = [
-  "model",
+var CATALOGUE_LABELS = new Map(
+  SETTINGS_CATALOGUE.flatMap((g) => g.entries.map((e) => [e.key, e.label]))
+);
+function settingLabel(key) {
+  return CATALOGUE_LABELS.get(key) ?? (0, import_text_case.humanizeIdentifier)(key);
+}
+var RECOGNIZED_PARAMS = new Set(LLM_PARAMS_KEYS);
+var EXTRA_EXCLUDED = /* @__PURE__ */ new Set([
+  ...CATCHALL_EXCLUDED,
   "offering_id",
-  "max_output_tokens",
-  "temperature",
-  "top_p",
-  "top_k",
-  "tool_choice",
-  "parallel_tool_calls",
-  "reasoning_effort",
-  "reasoning_summary",
-  "visualization",
-  "thinking_level",
-  "include_thoughts",
-  "thinking_budget",
-  "clear_thinking",
-  "disable_reasoning",
-  "response_format",
-  "stop_sequences",
-  "stream",
-  "store",
-  "extended_prompt_cache",
-  "previous_interaction_id",
-  "task",
-  "verbosity",
-  "internal_web_search",
-  "internal_url_context",
-  "internal_x_search",
-  "aspect_ratio",
-  "width",
-  "height",
-  "count",
-  "render_quality",
-  "background",
-  "output_compression",
-  "moderation",
-  "input_fidelity",
-  "partial_images",
-  "style",
-  "reference_strength",
-  "tts_voice",
-  "audio_format",
-  "performance_direction",
-  "speech_speed",
-  "turn_pause_ms",
-  "language_code",
-  "duration_seconds",
-  "resolution",
-  "fps",
-  "steps",
-  "seed",
-  "guidance_scale",
-  "encode_quality",
-  "negative_prompt",
+  "max_tokens",
   "output_format",
-  "frame_images",
-  "reference_images",
-  "image_loras",
-  "disable_safety_checker",
-  "generate_audio",
-  "enhance_prompt",
-  "camera_control",
-  "image_input",
-  "image_inputs",
-  "mask",
-  "last_frame_image",
-  "video_input",
-  "video_action",
-  "custom_tools",
-  "mcp_servers",
-  "compaction_settings",
-  "detected_contexts",
-  "dictionary",
-  "tts_quality"
-];
+  "n"
+]);
+function extraSettingKeys(controls, settings, alsoKeys = []) {
+  const out = { translated: [], unsupported: [] };
+  if (!controls) return out;
+  const declaresAny = Object.keys(controls).some((key) => lookupControl(controls, key) !== null);
+  if (!declaresAny) return out;
+  const keys = new Set(Object.keys(settings ?? {}).filter((key) => hasMeaningfulValue(settings, key)));
+  for (const key of alsoKeys) keys.add(key);
+  for (const key of keys) {
+    if (EXTRA_EXCLUDED.has(key) || lookupControl(controls, key)) continue;
+    (RECOGNIZED_PARAMS.has(key) ? out.translated : out.unsupported).push(key);
+  }
+  return out;
+}
 
 // models/model-normalizer.ts
 var TEXT_RESPONSE_FORMATS = /* @__PURE__ */ new Set(["text", "json_object", "json_schema"]);

package/dist/settings/index.d.cts

@@ -242,6 +242,26 @@ type ControlsLike = Record<string, unknown> | null | undefined;
  * without a code change. Empty groups are returned (consumers skip them).
  */
 declare function buildSettingsRows(controls: ControlsLike, settings: Record<string, unknown> | null | undefined): RenderGroup[];
+/** A setting's label: the catalog's own words, else the key humanized (the catch-all rule). */
+declare function settingLabel(key: string): string;
+interface ExtraSettingKeys {
+    /**
+     * Set, a real model parameter, not declared by this model: KEPT and sent as the model's
+     * closest equivalent — the server translates it (settings-translation K7, the platform rule).
+     * THE panel draws these under "Translated for this model", never as a warning.
+     */
+    translated: string[];
+    /** Set, but no model parameter at all (a typo, a retired key): "Not on this model". */
+    unsupported: string[];
+}
+/**
+ * The set values THE model-settings panel draws beside the model's own rows — one rule for the
+ * builder and every override screen (owner, 2026-10-21). `alsoKeys` are keys a target changed
+ * that hold no value now (an override that removes the agent's value): they stay listed so
+ * their reset stays reachable. Empty until the model declares at least one control: a model
+ * with no declared controls is a catalog gap, not an incompatibility.
+ */
+declare function extraSettingKeys(controls: ControlsLike, settings: Record<string, unknown> | null | undefined, alsoKeys?: readonly string[]): ExtraSettingKeys;
 
 /**
  * Agent Settings — Internal Utilities
@@ -531,6 +551,37 @@ declare function isUnsetChoice(key: string, value: unknown): boolean;
 
 declare function startingValueFor(key: string, control: ControlDefinition): unknown;
 
+/** 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;
+}
+/**
+ * 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.
+ */
+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;
+}
+
 /**
  * THE SETTINGS WRITE TARGET — the one seam between THE model-settings panel
  * (`./react/ModelSettingsPanel`) and whatever a change is written to.
@@ -594,9 +645,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;
@@ -608,4 +698,4 @@ interface CapabilitiesWriteTarget {
     error?: string | null;
 }
 
-export { AUTO_MEANS_UNSET_KEYS, AUTO_VALUE, type AgentContext, type AgentSettings, type AgentSettingsEntry, type AgentSettingsState, type AgentSource, type AgentVariable, CATALOGUE_KEYS, type CapabilitiesWriteTarget, type CatalogueEntry, type CatalogueGroup, type ConflictAction, type ConflictItem, type ConflictReason, type ConflictSummary, type ControlDefinition, type ControlType, EMPTY_UI_GATES, ENUM_OFF_VALUE, type InitializeSettingsInput, type LLMParams, type NormalizedControls, PARAM_ALIASES, type PendingModelSwitch, type RenderGroup, type ResolutionMode, SETTINGS_CATALOGUE, type SettingRowFacts, type SettingRowRead, type SettingRowView, type SettingState, type SettingsGroupId, type SettingsModelInfo, type SettingsRow, type SettingsStore, type SettingsStoreConfig, type SettingsWriteTarget, UI_GATE_EDITABLE_KEYS, UI_GATE_KEYS, type UiGateEditableKey, type UiGateKey, type UiGates, type VariableCustomComponentRef, buildApiPayload, buildSettingsRows, computeOverrideDiff, createSettingsStore, detectConflicts, effectiveOfferingPinOf, extractModelDefaults, gateEnabled, getActionForMode, isOffValue, isUiGateKey, isUnsetChoice, mergeEffectiveSettings, mergeVariableValues, offValueFor, parseModelControls, parseUiGates, readApiPayload, readConflictActions, readConflictSummary, readEffectiveModelId, readEffectiveSettings, readEffectiveVariableValues, readPreviewedResolution, readSettingsEntry, resolveConflicts, sanitizeSettings, settingStateOf, startingValueFor, withSettingState };
+export { AUTO_MEANS_UNSET_KEYS, AUTO_VALUE, type AgentContext, type AgentSettings, type AgentSettingsEntry, type AgentSettingsState, type AgentSource, type AgentVariable, CATALOGUE_KEYS, type CapabilitiesWriteTarget, type CatalogueEntry, type CatalogueGroup, type ConflictAction, type ConflictItem, type ConflictReason, type ConflictSummary, type ControlDefinition, type ControlType, EMPTY_UI_GATES, ENUM_OFF_VALUE, type ExtraSettingKeys, type InitializeSettingsInput, type LLMParams, type ModelRowTarget, type NormalizedControls, PARAM_ALIASES, type PendingModelSwitch, type RenderGroup, type ResolutionMode, SETTINGS_CATALOGUE, type SettingRowFacts, type SettingRowRead, type SettingRowView, type SettingState, type SettingsGroupId, type SettingsModelInfo, type SettingsRow, type SettingsStore, type SettingsStoreConfig, type SettingsWriteTarget, UI_GATE_EDITABLE_KEYS, UI_GATE_KEYS, type UiGateEditableKey, type UiGateKey, type UiGates, type VariableCustomComponentRef, buildApiPayload, buildSettingsRows, computeOverrideDiff, createSettingsStore, detectConflicts, effectiveOfferingPinOf, extraSettingKeys, extractModelDefaults, gateEnabled, getActionForMode, isOffValue, isUiGateKey, isUnsetChoice, mergeEffectiveSettings, mergeVariableValues, offValueFor, parseModelControls, parseUiGates, readApiPayload, readConflictActions, readConflictSummary, readEffectiveModelId, readEffectiveSettings, readEffectiveVariableValues, readPreviewedResolution, readSettingsEntry, resolveConflicts, sanitizeSettings, settingLabel, settingStateOf, startingValueFor, withSettingState };

package/dist/settings/index.d.ts

@@ -242,6 +242,26 @@ type ControlsLike = Record<string, unknown> | null | undefined;
  * without a code change. Empty groups are returned (consumers skip them).
  */
 declare function buildSettingsRows(controls: ControlsLike, settings: Record<string, unknown> | null | undefined): RenderGroup[];
+/** A setting's label: the catalog's own words, else the key humanized (the catch-all rule). */
+declare function settingLabel(key: string): string;
+interface ExtraSettingKeys {
+    /**
+     * Set, a real model parameter, not declared by this model: KEPT and sent as the model's
+     * closest equivalent — the server translates it (settings-translation K7, the platform rule).
+     * THE panel draws these under "Translated for this model", never as a warning.
+     */
+    translated: string[];
+    /** Set, but no model parameter at all (a typo, a retired key): "Not on this model". */
+    unsupported: string[];
+}
+/**
+ * The set values THE model-settings panel draws beside the model's own rows — one rule for the
+ * builder and every override screen (owner, 2026-10-21). `alsoKeys` are keys a target changed
+ * that hold no value now (an override that removes the agent's value): they stay listed so
+ * their reset stays reachable. Empty until the model declares at least one control: a model
+ * with no declared controls is a catalog gap, not an incompatibility.
+ */
+declare function extraSettingKeys(controls: ControlsLike, settings: Record<string, unknown> | null | undefined, alsoKeys?: readonly string[]): ExtraSettingKeys;
 
 /**
  * Agent Settings — Internal Utilities
@@ -531,6 +551,37 @@ declare function isUnsetChoice(key: string, value: unknown): boolean;
 
 declare function startingValueFor(key: string, control: ControlDefinition): unknown;
 
+/** 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;
+}
+/**
+ * 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.
+ */
+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;
+}
+
 /**
  * THE SETTINGS WRITE TARGET — the one seam between THE model-settings panel
  * (`./react/ModelSettingsPanel`) and whatever a change is written to.
@@ -594,9 +645,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;
@@ -608,4 +698,4 @@ interface CapabilitiesWriteTarget {
     error?: string | null;
 }
 
-export { AUTO_MEANS_UNSET_KEYS, AUTO_VALUE, type AgentContext, type AgentSettings, type AgentSettingsEntry, type AgentSettingsState, type AgentSource, type AgentVariable, CATALOGUE_KEYS, type CapabilitiesWriteTarget, type CatalogueEntry, type CatalogueGroup, type ConflictAction, type ConflictItem, type ConflictReason, type ConflictSummary, type ControlDefinition, type ControlType, EMPTY_UI_GATES, ENUM_OFF_VALUE, type InitializeSettingsInput, type LLMParams, type NormalizedControls, PARAM_ALIASES, type PendingModelSwitch, type RenderGroup, type ResolutionMode, SETTINGS_CATALOGUE, type SettingRowFacts, type SettingRowRead, type SettingRowView, type SettingState, type SettingsGroupId, type SettingsModelInfo, type SettingsRow, type SettingsStore, type SettingsStoreConfig, type SettingsWriteTarget, UI_GATE_EDITABLE_KEYS, UI_GATE_KEYS, type UiGateEditableKey, type UiGateKey, type UiGates, type VariableCustomComponentRef, buildApiPayload, buildSettingsRows, computeOverrideDiff, createSettingsStore, detectConflicts, effectiveOfferingPinOf, extractModelDefaults, gateEnabled, getActionForMode, isOffValue, isUiGateKey, isUnsetChoice, mergeEffectiveSettings, mergeVariableValues, offValueFor, parseModelControls, parseUiGates, readApiPayload, readConflictActions, readConflictSummary, readEffectiveModelId, readEffectiveSettings, readEffectiveVariableValues, readPreviewedResolution, readSettingsEntry, resolveConflicts, sanitizeSettings, settingStateOf, startingValueFor, withSettingState };
+export { AUTO_MEANS_UNSET_KEYS, AUTO_VALUE, type AgentContext, type AgentSettings, type AgentSettingsEntry, type AgentSettingsState, type AgentSource, type AgentVariable, CATALOGUE_KEYS, type CapabilitiesWriteTarget, type CatalogueEntry, type CatalogueGroup, type ConflictAction, type ConflictItem, type ConflictReason, type ConflictSummary, type ControlDefinition, type ControlType, EMPTY_UI_GATES, ENUM_OFF_VALUE, type ExtraSettingKeys, type InitializeSettingsInput, type LLMParams, type ModelRowTarget, type NormalizedControls, PARAM_ALIASES, type PendingModelSwitch, type RenderGroup, type ResolutionMode, SETTINGS_CATALOGUE, type SettingRowFacts, type SettingRowRead, type SettingRowView, type SettingState, type SettingsGroupId, type SettingsModelInfo, type SettingsRow, type SettingsStore, type SettingsStoreConfig, type SettingsWriteTarget, UI_GATE_EDITABLE_KEYS, UI_GATE_KEYS, type UiGateEditableKey, type UiGateKey, type UiGates, type VariableCustomComponentRef, buildApiPayload, buildSettingsRows, computeOverrideDiff, createSettingsStore, detectConflicts, effectiveOfferingPinOf, extraSettingKeys, extractModelDefaults, gateEnabled, getActionForMode, isOffValue, isUiGateKey, isUnsetChoice, mergeEffectiveSettings, mergeVariableValues, offValueFor, parseModelControls, parseUiGates, readApiPayload, readConflictActions, readConflictSummary, readEffectiveModelId, readEffectiveSettings, readEffectiveVariableValues, readPreviewedResolution, readSettingsEntry, resolveConflicts, sanitizeSettings, settingLabel, settingStateOf, startingValueFor, withSettingState };