@ai-matrx/agents 0.59.265 → 0.59.267

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-<!-- matrx-auto-git-docs-resolution-needed-delete-this-when-resolved — two versions follow: LOCAL first, then GITHUB. (LOCAL latest 2026-10-23 13:10; GITHUB latest 2026-10-23 13:07; LOCAL lacks 3 of GITHUB's 5 new lines; GITHUB lacks 26 of LOCAL's 26 new lines; recover: git show c3687a0589:'apps/shared/matrx-agents/CHANGELOG.md' / f84d7bf4e5:'apps/shared/matrx-agents/CHANGELOG.md') Delete these three marker lines when resolved. -->
+## 0.59.267
+### a kept value with no schema stays editable; a value's source reaches a phone
+
+- `ModelSettingsPanel`: a set value the model declares no control for ("Translated", "Not on this model") is edited again, through `SettingControlInput` with a control from the value's own shape (new export `controlForValue`); the target receives `change(key, value, null)`. A row's `source` ("Agent", "Binding") — the status glyph's hover text — is also a `[data-touch-hint]` line under the control where nothing can hover. Test: `settings/react/a-kept-value-with-no-schema-stays-editable.test.tsx`. Consumer action: none (a target's `change` already accepts a null control).
+
+## 0.59.266
+### model labels by id (FW-014 round 3)
+
+- `ModelRecords.loadIdentities(modelIds)`: the durable labels of several models in ONE
+  `ai.model_definition … in(id)` read, deduped with `loadIdentity` — what an open menu names without the
+  options list (`ai.model_offering` + `ai.model_public`). Consumer action: a custom `ModelRecords` fake
+  adds `loadIdentities`.
+
 
 ## 0.59.265
 ### tagged rows without the catalog (FW-014, composer)
@@ -38,7 +50,6 @@
   (`getAgent(id)`), which `ensureAgentRows` fills.
 
 ### no second star read after a catalog or search read (FW-014)
-<!-- matrx-auto-git-docs-resolution-needed-delete-this-when-resolved — GITHUB version below -->
 ## 0.59.264
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 6201da503d aa81498da0 -- apps/shared/matrx-agents/src`
@@ -51,7 +62,6 @@ has no shipped-source changes outside tests, fixtures and docs). No consumer act
 
 ## 0.59.262
 ### no second star read after a catalog or search read (FW-014)
-<!-- matrx-auto-git-docs-resolution-needed-delete-this-when-resolved — end of both versions -->
 
 - `ensureLoaded()` and `searchServer()` no longer follow each read with `ues_get_bulk('agent', every id)`.
   Every catalog read (`agx_get_list_full`, `agx_search`, `agent.agx_get_by_ids`) already returns

package/dist/catalog/react/index.cjs

@@ -202,7 +202,7 @@ function useAgentSummary(catalog, agentId) {
   (0, import_react3.useEffect)(() => {
     if (!catalog || !agentId || present) return;
     let cancelled = false;
-    void catalog.ensureAgentRows([agentId]).catch(() => catalog.ensureLoaded()).then(() => {
+    void catalog.ensureAgentRows([agentId]).catch(() => void 0).then(() => {
       const held = catalog.getState().byId[agentId];
       if (cancelled || held && !held.isThin) return;
       if (held) return;

package/dist/catalog/react/index.js

@@ -143,7 +143,7 @@ function useAgentSummary(catalog, agentId) {
   useEffect(() => {
     if (!catalog || !agentId || present) return;
     let cancelled = false;
-    void catalog.ensureAgentRows([agentId]).catch(() => catalog.ensureLoaded()).then(() => {
+    void catalog.ensureAgentRows([agentId]).catch(() => void 0).then(() => {
       const held = catalog.getState().byId[agentId];
       if (cancelled || held && !held.isThin) return;
       if (held) return;

package/dist/settings/react/index.cjs

@@ -991,6 +991,15 @@ function StatusGlyph({ issue, source }) {
     }
   );
 }
+function SourceTouchLine({ source }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { "data-touch-hint": "", "data-setting-source": "", className: "hidden pt-1 type-meta text-muted-foreground [@media(hover:none)]:block", children: `Source: ${source}` });
+}
+function controlForValue(value) {
+  if (typeof value === "boolean") return { type: "boolean" };
+  if (typeof value === "number") return { type: Number.isInteger(value) ? "integer" : "number" };
+  if (Array.isArray(value)) return value.every((item) => typeof item === "string") ? { type: "string_array" } : { type: "array" };
+  return { type: "string" };
+}
 function changeTogether(target, changes, controls) {
   if (target.changeMany) target.changeMany(changes);
   else for (const [key, value] of Object.entries(changes)) target.change(key, value, controls[key] ?? null);
@@ -1121,12 +1130,13 @@ function ModelSettingRow({ row, control, target, idPrefix, disabled, multiSpeake
             id: `${idPrefix}-control-${row.key}`
           }
         ),
-        read.issue ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { className: "pt-1 type-meta text-warning-ink", children: read.issue.message }) : null
+        read.issue ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { className: "pt-1 type-meta text-warning-ink", children: read.issue.message }) : null,
+        !read.issue && read.source ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(SourceTouchLine, { source: read.source }) : null
       ] }) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(RowText, { children: read.modelDefault !== void 0 && read.modelDefault !== null ? `Not set \xB7 Model default: ${formatSettingValue(read.modelDefault)}` : "Not set" })
     }
   );
 }
-function ExtraSettingRow({ rowKey, label, value, kind, onClear, onReset, resetLabel = "Reset to agent", disabled = false }) {
+function ExtraSettingRow({ rowKey, label, value, kind, onClear, onChange, onReset, resetLabel = "Reset to agent", disabled = false, idPrefix = "settings" }) {
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
     SettingRowFrame,
     {
@@ -1137,7 +1147,17 @@ function ExtraSettingRow({ rowKey, label, value, kind, onClear, onReset, resetLa
         kind === "translated" ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_controls4.Chip, { tone: "sky", label: "Translated", title: "Kept as set and sent as this model's closest equivalent" }) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_controls4.Chip, { tone: "warning", label: "Not on this model", title: "This model has no such setting" }),
         onReset ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_controls4.Button, { variant: "quiet", icon: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(RotateCcwGlyph, {}), onClick: onReset, disabled, "aria-label": `${resetLabel}: ${label}`, title: resetLabel, "data-setting-reset": rowKey }) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_controls4.Button, { variant: "quiet", removes: true, icon: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Trash2Glyph, {}), onClick: onClear, disabled, "aria-label": `Clear ${label}`, title: "Clear to not set", "data-setting-clear": rowKey })
       ] }),
-      children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(RowText, { mono: value !== void 0 && value !== null, children: value === void 0 || value === null ? "Not set" : isOffValue(value, null) ? "Off" : formatSettingValue(value) })
+      children: onChange && value !== void 0 && value !== null ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        SettingControlInput,
+        {
+          settingKey: rowKey,
+          control: controlForValue(value),
+          value,
+          onChange,
+          disabled,
+          id: `${idPrefix}-extra-${rowKey}`
+        }
+      ) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(RowText, { mono: value !== void 0 && value !== null, children: value === void 0 || value === null ? "Not set" : isOffValue(value, null) ? "Off" : formatSettingValue(value) })
     }
   );
 }
@@ -1219,6 +1239,8 @@ function ModelSettingsPanel({
       value: values?.[key],
       kind,
       onClear: () => target.clear(key),
+      onChange: (next) => target.change(key, next, null),
+      idPrefix,
       onReset: target.resetToInherited && target.read(key, null).changedHere ? () => target.resetToInherited?.(key) : void 0,
       resetLabel,
       disabled

package/dist/settings/react/index.js

@@ -991,6 +991,15 @@ function StatusGlyph({ issue, source }) {
     }
   );
 }
+function SourceTouchLine({ source }) {
+  return /* @__PURE__ */ jsx5("p", { "data-touch-hint": "", "data-setting-source": "", className: "hidden pt-1 type-meta text-muted-foreground [@media(hover:none)]:block", children: `Source: ${source}` });
+}
+function controlForValue(value) {
+  if (typeof value === "boolean") return { type: "boolean" };
+  if (typeof value === "number") return { type: Number.isInteger(value) ? "integer" : "number" };
+  if (Array.isArray(value)) return value.every((item) => typeof item === "string") ? { type: "string_array" } : { type: "array" };
+  return { type: "string" };
+}
 function changeTogether(target, changes, controls) {
   if (target.changeMany) target.changeMany(changes);
   else for (const [key, value] of Object.entries(changes)) target.change(key, value, controls[key] ?? null);
@@ -1121,12 +1130,13 @@ function ModelSettingRow({ row, control, target, idPrefix, disabled, multiSpeake
             id: `${idPrefix}-control-${row.key}`
           }
         ),
-        read.issue ? /* @__PURE__ */ jsx5("p", { className: "pt-1 type-meta text-warning-ink", children: read.issue.message }) : null
+        read.issue ? /* @__PURE__ */ jsx5("p", { className: "pt-1 type-meta text-warning-ink", children: read.issue.message }) : null,
+        !read.issue && read.source ? /* @__PURE__ */ jsx5(SourceTouchLine, { source: read.source }) : null
       ] }) : /* @__PURE__ */ jsx5(RowText, { children: read.modelDefault !== void 0 && read.modelDefault !== null ? `Not set \xB7 Model default: ${formatSettingValue(read.modelDefault)}` : "Not set" })
     }
   );
 }
-function ExtraSettingRow({ rowKey, label, value, kind, onClear, onReset, resetLabel = "Reset to agent", disabled = false }) {
+function ExtraSettingRow({ rowKey, label, value, kind, onClear, onChange, onReset, resetLabel = "Reset to agent", disabled = false, idPrefix = "settings" }) {
   return /* @__PURE__ */ jsx5(
     SettingRowFrame,
     {
@@ -1137,7 +1147,17 @@ function ExtraSettingRow({ rowKey, label, value, kind, onClear, onReset, resetLa
         kind === "translated" ? /* @__PURE__ */ jsx5(Chip, { tone: "sky", label: "Translated", title: "Kept as set and sent as this model's closest equivalent" }) : /* @__PURE__ */ jsx5(Chip, { tone: "warning", label: "Not on this model", title: "This model has no such setting" }),
         onReset ? /* @__PURE__ */ jsx5(Button3, { variant: "quiet", icon: /* @__PURE__ */ jsx5(RotateCcwGlyph, {}), onClick: onReset, disabled, "aria-label": `${resetLabel}: ${label}`, title: resetLabel, "data-setting-reset": rowKey }) : /* @__PURE__ */ jsx5(Button3, { variant: "quiet", removes: true, icon: /* @__PURE__ */ jsx5(Trash2Glyph, {}), onClick: onClear, disabled, "aria-label": `Clear ${label}`, title: "Clear to not set", "data-setting-clear": rowKey })
       ] }),
-      children: /* @__PURE__ */ jsx5(RowText, { mono: value !== void 0 && value !== null, children: value === void 0 || value === null ? "Not set" : isOffValue(value, null) ? "Off" : formatSettingValue(value) })
+      children: onChange && value !== void 0 && value !== null ? /* @__PURE__ */ jsx5(
+        SettingControlInput,
+        {
+          settingKey: rowKey,
+          control: controlForValue(value),
+          value,
+          onChange,
+          disabled,
+          id: `${idPrefix}-extra-${rowKey}`
+        }
+      ) : /* @__PURE__ */ jsx5(RowText, { mono: value !== void 0 && value !== null, children: value === void 0 || value === null ? "Not set" : isOffValue(value, null) ? "Off" : formatSettingValue(value) })
     }
   );
 }
@@ -1219,6 +1239,8 @@ function ModelSettingsPanel({
       value: values?.[key],
       kind,
       onClear: () => target.clear(key),
+      onChange: (next) => target.change(key, next, null),
+      idPrefix,
       onReset: target.resetToInherited && target.read(key, null).changedHere ? () => target.resetToInherited?.(key) : void 0,
       resetLabel,
       disabled

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.265",
+  "version": "0.59.267",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -536,5 +536,5 @@
     ],
     "layer": 5
   },
-  "gitHead": "e9d7fb471faed968ff24ed0cf3d2aef2a5cdd3b6"
+  "gitHead": "06a190b44e4a1374047a5922da7e8b77a48555f8"
 }

package/scripts/check-model-catalog-reads.mjs

@@ -51,7 +51,7 @@ export const ALLOWED = {
   "apps/matrx-frontend/scripts/check-rls-on.ts": "RLS probe, not a reader",
 };
 
-const SKIP_DIR = new Set(["node_modules", "dist", ".next", ".turbo", "coverage", "generated", "__tests__", "__fixtures__"]);
+const SKIP_DIR = new Set(["node_modules", "dist", ".next", ".next-preview", ".turbo", "coverage", "generated", "__tests__", "__fixtures__"]);
 const isTest = (p) => /\.(test|spec)\.[cm]?[jt]sx?$/.test(p) || /\.d\.ts$/.test(p) || /\.generated\./.test(p);
 
 const R1 = /\.from\(\s*["'`](model_definition|model_public|model_offering|model_config|model_variant|model_presentation)["'`]|\.rpc\(\s*["'`](admin_model_catalog|resolve_model_config)["'`]/g;