@ai-matrx/agents 0.59.270 → 0.59.272

package/dist/settings/index.d.cts

@@ -516,14 +516,16 @@ declare function withSettingState<T extends Record<string, unknown>>(settings: T
  * included at all").
  *
  * For these keys the house "auto" posture IS the unset state on the server:
- *   - reasoning_effort — aidream `matrx_ai/catalog/canonicalize.py` normalizes
- *     "auto" to None before any rule or processor sees it (ai_041).
  *   - visualization — the Google research agent reads an unset value as "auto"
  *     (`providers/google/google_research_agent.py`).
  * So a control that offers "auto" for one of them must CLEAR the key, never
- * save the word: a saved "auto" and an absent key would be two stored states
- * with one meaning. Keys whose "auto" is a real provider value that goes on the
- * wire (render_quality, background, moderation, reasoning_summary) are NOT here.
+ * save the word.
+ *
+ * `reasoning_effort` is NOT here (owner ruling 2026-10-24): unset runs at the
+ * platform default ("low"), and "auto" is a PERSON's explicit choice that the
+ * server sends as the provider's own auto where it has one
+ * (`matrx_ai/catalog/controls.py::apply_reasoning_default`). So a person picking
+ * "auto" SAVES "auto"; it is never a starting value (`NEVER_IMPLICIT_AUTO_KEYS`).
  *
  * Every settings writer reads this one rule: the agent builder
  * (AgentSettingsCore), the conversation settings target (useConversationSettingsTarget), the
@@ -531,8 +533,12 @@ declare function withSettingState<T extends Record<string, unknown>>(settings: T
  */
 declare const AUTO_VALUE = "auto";
 declare const AUTO_MEANS_UNSET_KEYS: ReadonlySet<string>;
+/** Keys whose "auto" is a real choice that only a person makes — never a default. */
+declare const NEVER_IMPLICIT_AUTO_KEYS: ReadonlySet<string>;
 /** True when writing `value` to `key` means "not set" — the key is removed. */
 declare function isUnsetChoice(key: string, value: unknown): boolean;
+/** True when `value` may not be chosen FOR a person (a starting value / default). */
+declare function isNeverImplicitChoice(key: string, value: unknown): boolean;
 
 /**
  * THE starting value of a setting a person turns on (ticks its box). One rule
@@ -746,5 +752,5 @@ interface CapabilitiesWriteTarget {
     error?: string | null;
 }
 
-export { AUTO_MEANS_UNSET_KEYS, AUTO_VALUE, CATALOGUE_KEYS, EMPTY_UI_GATES, ENUM_OFF_VALUE, PARAM_ALIASES, SETTINGS_CATALOGUE, UI_GATE_EDITABLE_KEYS, UI_GATE_KEYS, 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, settingControl, settingLabel, settingStateOf, startingValueFor, withSettingState };
+export { AUTO_MEANS_UNSET_KEYS, AUTO_VALUE, CATALOGUE_KEYS, EMPTY_UI_GATES, ENUM_OFF_VALUE, NEVER_IMPLICIT_AUTO_KEYS, PARAM_ALIASES, SETTINGS_CATALOGUE, UI_GATE_EDITABLE_KEYS, UI_GATE_KEYS, buildApiPayload, buildSettingsRows, computeOverrideDiff, createSettingsStore, detectConflicts, effectiveOfferingPinOf, extraSettingKeys, extractModelDefaults, gateEnabled, getActionForMode, isNeverImplicitChoice, isOffValue, isUiGateKey, isUnsetChoice, mergeEffectiveSettings, mergeVariableValues, offValueFor, parseModelControls, parseUiGates, readApiPayload, readConflictActions, readConflictSummary, readEffectiveModelId, readEffectiveSettings, readEffectiveVariableValues, readPreviewedResolution, readSettingsEntry, resolveConflicts, sanitizeSettings, settingControl, settingLabel, settingStateOf, startingValueFor, withSettingState };
 export type { AgentContext, AgentSettings, AgentSettingsEntry, AgentSettingsState, AgentSource, AgentVariable, CapabilitiesWriteTarget, CatalogueEntry, CatalogueGroup, ConflictAction, ConflictItem, ConflictReason, ConflictSummary, ControlDefinition, ControlType, ExtraSettingKeys, InitializeSettingsInput, LLMParams, ModelRowTarget, ModelSettingRow, NormalizedControls, PendingModelSwitch, RenderGroup, ResolutionMode, SettingRowFacts, SettingRowRead, SettingRowView, SettingState, SettingsGroupId, SettingsModelInfo, SettingsStore, SettingsStoreConfig, SettingsWriteTarget, UiGateEditableKey, UiGateKey, UiGates, VariableCustomComponentRef };

package/dist/settings/index.d.ts

@@ -516,14 +516,16 @@ declare function withSettingState<T extends Record<string, unknown>>(settings: T
  * included at all").
  *
  * For these keys the house "auto" posture IS the unset state on the server:
- *   - reasoning_effort — aidream `matrx_ai/catalog/canonicalize.py` normalizes
- *     "auto" to None before any rule or processor sees it (ai_041).
  *   - visualization — the Google research agent reads an unset value as "auto"
  *     (`providers/google/google_research_agent.py`).
  * So a control that offers "auto" for one of them must CLEAR the key, never
- * save the word: a saved "auto" and an absent key would be two stored states
- * with one meaning. Keys whose "auto" is a real provider value that goes on the
- * wire (render_quality, background, moderation, reasoning_summary) are NOT here.
+ * save the word.
+ *
+ * `reasoning_effort` is NOT here (owner ruling 2026-10-24): unset runs at the
+ * platform default ("low"), and "auto" is a PERSON's explicit choice that the
+ * server sends as the provider's own auto where it has one
+ * (`matrx_ai/catalog/controls.py::apply_reasoning_default`). So a person picking
+ * "auto" SAVES "auto"; it is never a starting value (`NEVER_IMPLICIT_AUTO_KEYS`).
  *
  * Every settings writer reads this one rule: the agent builder
  * (AgentSettingsCore), the conversation settings target (useConversationSettingsTarget), the
@@ -531,8 +533,12 @@ declare function withSettingState<T extends Record<string, unknown>>(settings: T
  */
 declare const AUTO_VALUE = "auto";
 declare const AUTO_MEANS_UNSET_KEYS: ReadonlySet<string>;
+/** Keys whose "auto" is a real choice that only a person makes — never a default. */
+declare const NEVER_IMPLICIT_AUTO_KEYS: ReadonlySet<string>;
 /** True when writing `value` to `key` means "not set" — the key is removed. */
 declare function isUnsetChoice(key: string, value: unknown): boolean;
+/** True when `value` may not be chosen FOR a person (a starting value / default). */
+declare function isNeverImplicitChoice(key: string, value: unknown): boolean;
 
 /**
  * THE starting value of a setting a person turns on (ticks its box). One rule
@@ -746,5 +752,5 @@ interface CapabilitiesWriteTarget {
     error?: string | null;
 }
 
-export { AUTO_MEANS_UNSET_KEYS, AUTO_VALUE, CATALOGUE_KEYS, EMPTY_UI_GATES, ENUM_OFF_VALUE, PARAM_ALIASES, SETTINGS_CATALOGUE, UI_GATE_EDITABLE_KEYS, UI_GATE_KEYS, 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, settingControl, settingLabel, settingStateOf, startingValueFor, withSettingState };
+export { AUTO_MEANS_UNSET_KEYS, AUTO_VALUE, CATALOGUE_KEYS, EMPTY_UI_GATES, ENUM_OFF_VALUE, NEVER_IMPLICIT_AUTO_KEYS, PARAM_ALIASES, SETTINGS_CATALOGUE, UI_GATE_EDITABLE_KEYS, UI_GATE_KEYS, buildApiPayload, buildSettingsRows, computeOverrideDiff, createSettingsStore, detectConflicts, effectiveOfferingPinOf, extraSettingKeys, extractModelDefaults, gateEnabled, getActionForMode, isNeverImplicitChoice, isOffValue, isUiGateKey, isUnsetChoice, mergeEffectiveSettings, mergeVariableValues, offValueFor, parseModelControls, parseUiGates, readApiPayload, readConflictActions, readConflictSummary, readEffectiveModelId, readEffectiveSettings, readEffectiveVariableValues, readPreviewedResolution, readSettingsEntry, resolveConflicts, sanitizeSettings, settingControl, settingLabel, settingStateOf, startingValueFor, withSettingState };
 export type { AgentContext, AgentSettings, AgentSettingsEntry, AgentSettingsState, AgentSource, AgentVariable, CapabilitiesWriteTarget, CatalogueEntry, CatalogueGroup, ConflictAction, ConflictItem, ConflictReason, ConflictSummary, ControlDefinition, ControlType, ExtraSettingKeys, InitializeSettingsInput, LLMParams, ModelRowTarget, ModelSettingRow, NormalizedControls, PendingModelSwitch, RenderGroup, ResolutionMode, SettingRowFacts, SettingRowRead, SettingRowView, SettingState, SettingsGroupId, SettingsModelInfo, SettingsStore, SettingsStoreConfig, SettingsWriteTarget, UiGateEditableKey, UiGateKey, UiGates, VariableCustomComponentRef };

package/dist/settings/index.js

@@ -965,13 +965,19 @@ function withSettingState(settings, key, state, control, value) {
 // settings/auto-means-unset.ts
 var AUTO_VALUE = "auto";
 var AUTO_MEANS_UNSET_KEYS = /* @__PURE__ */ new Set([
-  "reasoning_effort",
   "visualization"
 ]);
+var NEVER_IMPLICIT_AUTO_KEYS = /* @__PURE__ */ new Set([
+  "reasoning_effort"
+]);
 function isUnsetChoice(key, value) {
   if (value === void 0 || value === null) return true;
   return value === AUTO_VALUE && AUTO_MEANS_UNSET_KEYS.has(key);
 }
+function isNeverImplicitChoice(key, value) {
+  if (isUnsetChoice(key, value)) return true;
+  return value === AUTO_VALUE && NEVER_IMPLICIT_AUTO_KEYS.has(key);
+}
 
 // settings/starting-value.ts
 function startingValueFor(key, control) {
@@ -989,8 +995,8 @@ function startingValueFor(key, control) {
       value = [];
     }
   }
-  if (isUnsetChoice(key, value) && control.type === "enum" && control.enum?.length) {
-    value = control.enum.find((choice) => !isUnsetChoice(key, choice));
+  if (isNeverImplicitChoice(key, value) && control.type === "enum" && control.enum?.length) {
+    value = control.enum.find((choice) => !isNeverImplicitChoice(key, choice));
   }
   if (key === "response_format" && typeof value === "string") {
     value = value === "" ? void 0 : { type: value };
@@ -1003,6 +1009,7 @@ export {
   CATALOGUE_KEYS,
   EMPTY_UI_GATES,
   ENUM_OFF_VALUE,
+  NEVER_IMPLICIT_AUTO_KEYS,
   PARAM_ALIASES,
   SETTINGS_CATALOGUE,
   UI_GATE_EDITABLE_KEYS,
@@ -1017,6 +1024,7 @@ export {
   extractModelDefaults,
   gateEnabled,
   getActionForMode,
+  isNeverImplicitChoice,
   isOffValue,
   isUiGateKey,
   isUnsetChoice,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.270",
+  "version": "0.59.272",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -25,6 +25,7 @@
   "files": [
     "dist",
     "scripts/check-model-catalog-reads.mjs",
+    "context/rules-corpus.json",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
@@ -171,6 +172,7 @@
         "default": "./dist/context/react/index.cjs"
       }
     },
+    "./context/rules-corpus.json": "./context/rules-corpus.json",
     "./react": {
       "import": {
         "types": "./dist/react/index.d.ts",
@@ -518,5 +520,5 @@
       "optional": true
     }
   },
-  "gitHead": "8a4ed656ea91ae1934870745a5c95f91f24da863"
+  "gitHead": "467bc8f11239e00d4bcd8d27c85861b0165cd0bd"
 }