@ai-matrx/agents 0.59.215 → 0.59.217

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## 0.59.215
+## 0.59.217
 
 - **Glyph path data removed; the same exports now alias the one glyph home (one-canonical, glyph lane, 2026-10-21).** `context, models, settings and versions icon files` defines no SVG any more: each export is `@ai-matrx/design-system/icons`'s glyph with this package's historical size and stroke. Names, props and sizes are unchanged; catalog `FolderIcon`, `TagIcon` and `RotateCcwIcon` are re-exports of the glyph home, and the settings rows join classes with `cn` from `@ai-matrx/design-system/cn`. Consumer action: none.
 

package/dist/context/index.cjs

@@ -160,7 +160,11 @@ function resolveContextRule(input) {
     include = false;
     includeBy = "agent";
   }
-  if (user && typeof user.include === "boolean") {
+  const ownLocked = !identity && surface?.own === true;
+  if (ownLocked) {
+    include = false;
+    includeBy = "page";
+  } else if (user && typeof user.include === "boolean") {
     include = user.include;
     includeBy = "you";
   }

package/dist/context/index.d.cts

@@ -113,6 +113,12 @@ interface ContextSurfaceLayer {
     auto_context?: boolean | null;
     /** `inlineUpTo` / envelope `max_inline_chars` / DB column. */
     max_inline_chars?: number | null;
+    /**
+     * The value is withheld because this conversation IS the page (`page_context` mode `own`):
+     * nothing re-opens it — not the agent's Context Policy, not the person's rule. A page's own
+     * chat never receives itself (Arman, 2026-10-01 / 2026-10-21).
+     */
+    own?: boolean;
 }
 /** The non-person layers for one value — what the table's layer breakdown shows. */
 interface ContextRuleLayers {

package/dist/context/index.d.ts

@@ -113,6 +113,12 @@ interface ContextSurfaceLayer {
     auto_context?: boolean | null;
     /** `inlineUpTo` / envelope `max_inline_chars` / DB column. */
     max_inline_chars?: number | null;
+    /**
+     * The value is withheld because this conversation IS the page (`page_context` mode `own`):
+     * nothing re-opens it — not the agent's Context Policy, not the person's rule. A page's own
+     * chat never receives itself (Arman, 2026-10-01 / 2026-10-21).
+     */
+    own?: boolean;
 }
 /** The non-person layers for one value — what the table's layer breakdown shows. */
 interface ContextRuleLayers {

package/dist/context/index.js

@@ -97,7 +97,11 @@ function resolveContextRule(input) {
     include = false;
     includeBy = "agent";
   }
-  if (user && typeof user.include === "boolean") {
+  const ownLocked = !identity && surface?.own === true;
+  if (ownLocked) {
+    include = false;
+    includeBy = "page";
+  } else if (user && typeof user.include === "boolean") {
     include = user.include;
     includeBy = "you";
   }

package/dist/context/react/index.cjs

@@ -103,7 +103,11 @@ function resolveContextRule(input) {
     include = false;
     includeBy = "agent";
   }
-  if (user && typeof user.include === "boolean") {
+  const ownLocked = !identity && surface?.own === true;
+  if (ownLocked) {
+    include = false;
+    includeBy = "page";
+  } else if (user && typeof user.include === "boolean") {
     include = user.include;
     includeBy = "you";
   }
@@ -218,6 +222,7 @@ function includeChanges(rows, include, cap) {
   const changes = [];
   for (const row of rows) {
     if (row.include === include) continue;
+    if (row.layers?.surface?.own === true) continue;
     const next = { ...row.userRule ?? {} };
     if (inheritedInclude(row, cap) === include) delete next.include;
     else next.include = include;
@@ -763,6 +768,7 @@ function ContextRuleRow({
             size: "sm",
             "aria-label": `Include ${row.label}`,
             checked: row.include,
+            disabled: row.layers?.surface?.own === true,
             onCheckedChange: (next) => onChange(row.key, row.surfaceKey, withInclude(row, next))
           }
         ) }),

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

@@ -31,6 +31,12 @@ interface ContextSurfaceLayer {
     auto_context?: boolean | null;
     /** `inlineUpTo` / envelope `max_inline_chars` / DB column. */
     max_inline_chars?: number | null;
+    /**
+     * The value is withheld because this conversation IS the page (`page_context` mode `own`):
+     * nothing re-opens it — not the agent's Context Policy, not the person's rule. A page's own
+     * chat never receives itself (Arman, 2026-10-01 / 2026-10-21).
+     */
+    own?: boolean;
 }
 /** The non-person layers for one value — what the table's layer breakdown shows. */
 interface ContextRuleLayers {

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

@@ -31,6 +31,12 @@ interface ContextSurfaceLayer {
     auto_context?: boolean | null;
     /** `inlineUpTo` / envelope `max_inline_chars` / DB column. */
     max_inline_chars?: number | null;
+    /**
+     * The value is withheld because this conversation IS the page (`page_context` mode `own`):
+     * nothing re-opens it — not the agent's Context Policy, not the person's rule. A page's own
+     * chat never receives itself (Arman, 2026-10-01 / 2026-10-21).
+     */
+    own?: boolean;
 }
 /** The non-person layers for one value — what the table's layer breakdown shows. */
 interface ContextRuleLayers {

package/dist/context/react/index.js

@@ -62,7 +62,11 @@ function resolveContextRule(input) {
     include = false;
     includeBy = "agent";
   }
-  if (user && typeof user.include === "boolean") {
+  const ownLocked = !identity && surface?.own === true;
+  if (ownLocked) {
+    include = false;
+    includeBy = "page";
+  } else if (user && typeof user.include === "boolean") {
     include = user.include;
     includeBy = "you";
   }
@@ -182,6 +186,7 @@ function includeChanges(rows, include, cap) {
   const changes = [];
   for (const row of rows) {
     if (row.include === include) continue;
+    if (row.layers?.surface?.own === true) continue;
     const next = { ...row.userRule ?? {} };
     if (inheritedInclude(row, cap) === include) delete next.include;
     else next.include = include;
@@ -733,6 +738,7 @@ function ContextRuleRow({
             size: "sm",
             "aria-label": `Include ${row.label}`,
             checked: row.include,
+            disabled: row.layers?.surface?.own === true,
             onCheckedChange: (next) => onChange(row.key, row.surfaceKey, withInclude(row, next))
           }
         ) }),

package/dist/mandates/index.cjs

@@ -47,9 +47,9 @@ module.exports = __toCommonJS(mandates_exports);
 
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "1e5f26b1bb6d67f1553566c6c38b25e570e2a765",
+  aidreamRevision: "268d0c2f1f0b2ea129ee132098cb3e7b9184a2ab",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.215",
+  packageVersion: "0.59.217",
   retireWindow: 3
 };
 var MANDATE_KEYS = {

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:   1e5f26b1bb6d67f1553566c6c38b25e570e2a765
+ * aidream revision:   268d0c2f1f0b2ea129ee132098cb3e7b9184a2ab
  * generator version:  1.0.0
- * package version:    0.59.215
+ * package version:    0.59.217
  * active keys:        612
  * 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: "1e5f26b1bb6d67f1553566c6c38b25e570e2a765";
+    readonly aidreamRevision: "268d0c2f1f0b2ea129ee132098cb3e7b9184a2ab";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.215";
+    readonly packageVersion: "0.59.217";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */

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:   1e5f26b1bb6d67f1553566c6c38b25e570e2a765
+ * aidream revision:   268d0c2f1f0b2ea129ee132098cb3e7b9184a2ab
  * generator version:  1.0.0
- * package version:    0.59.215
+ * package version:    0.59.217
  * active keys:        612
  * 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: "1e5f26b1bb6d67f1553566c6c38b25e570e2a765";
+    readonly aidreamRevision: "268d0c2f1f0b2ea129ee132098cb3e7b9184a2ab";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.215";
+    readonly packageVersion: "0.59.217";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */

package/dist/mandates/index.js

@@ -1,8 +1,8 @@
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "1e5f26b1bb6d67f1553566c6c38b25e570e2a765",
+  aidreamRevision: "268d0c2f1f0b2ea129ee132098cb3e7b9184a2ab",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.215",
+  packageVersion: "0.59.217",
   retireWindow: 3
 };
 var MANDATE_KEYS = {

package/dist/models/index.cjs

@@ -1005,6 +1005,117 @@ function createModelRecords(config) {
     inFlight.set(key, p);
     return p;
   };
+  async function readFullModel(modelId) {
+    const relation = await isSignedIn() ? "model_config" : "model_public";
+    const { data, error } = await ai().from(relation).select(MODEL_CONFIG_COLUMNS).eq("id", modelId).maybeSingle();
+    if (error) throw error;
+    const row = data;
+    if (!row) throw new Error(`AI model ${modelId} is not available (ai.${relation} has no such row)`);
+    if (!row.id || !row.name) throw new Error(`ai.${relation} returned a row without id/name for model ${modelId}`);
+    const read = {
+      ...row,
+      id: row.id,
+      name: row.name,
+      controls: row.controls ?? null,
+      capabilities: requireCanonicalCapabilities(row.capabilities, { modelId: row.id, modelName: row.name })
+    };
+    return normalizeModel(read);
+  }
+  async function readOfferings(modelId) {
+    const q = ai().from("model_offering").select("model_id, offering_id, served_via, served_via_endpoint_id, priority");
+    const { data, error } = await (modelId ? q.eq("model_id", modelId) : q);
+    if (error) throw error;
+    return data ?? [];
+  }
+  async function rereadKnown() {
+    const known = state2;
+    const jobs = [];
+    const fail = (code, message, context) => errorSink({ code, message: `Catalog refresh: ${message}`, ...context ? { context } : {} });
+    if (known.fetchScope === "active" || known.fetchScope === "all") {
+      jobs.push(
+        readOptions().then(
+          (rows3) => update((s3) => {
+            const entities = { ...s3.entities };
+            for (const row of rows3) {
+              const existing = entities[row.id];
+              entities[row.id] = { ...emptyRecord(), ...existing, ...row, _fetchType: existing?._fetchType === "full" ? "full" : "options" };
+            }
+            return withIdLists({ ...s3, entities, lastFetched: Date.now(), error: null });
+          }),
+          (err) => fail("model-records-refresh-options-failed", messageOf(err))
+        )
+      );
+    }
+    for (const [id, record] of Object.entries(known.entities)) {
+      if (record._fetchType !== "full") continue;
+      jobs.push(
+        readFullModel(id).then(
+          (fresh) => update((s3) => {
+            const existing = s3.entities[fresh.id];
+            return withIdLists({ ...s3, entities: { ...s3.entities, [fresh.id]: { ...emptyRecord(), ...existing, ...fresh, maker: fresh.maker ?? existing?.maker ?? null, _fetchType: "full" } } });
+          }),
+          (err) => fail("model-records-refresh-model-failed", `${id}: ${messageOf(err)}`, { modelId: id })
+        )
+      );
+    }
+    for (const id of Object.keys(known.identityById)) {
+      jobs.push(
+        Promise.resolve(ai().from("model_definition").select("id, name, common_name, is_deprecated").eq("id", id).maybeSingle()).then(
+          ({ data, error }) => {
+            if (error) throw error;
+            if (data) update((s3) => ({ ...s3, identityById: { ...s3.identityById, [id]: data } }));
+          }
+        ).catch((err) => fail("model-records-refresh-identity-failed", `${id}: ${messageOf(err)}`, { modelId: id }))
+      );
+    }
+    if (known.modelClassStatus === "succeeded") {
+      jobs.push(
+        readOfferings().then(
+          (rows3) => update((s3) => ({ ...s3, modelClassIndex: buildModelClassIndex(rows3) })),
+          (err) => fail("model-records-refresh-classes-failed", messageOf(err))
+        )
+      );
+    } else {
+      for (const id of classesReadFor) {
+        jobs.push(
+          readOfferings(id).then(
+            (rows3) => update((s3) => {
+              if (s3.modelClassStatus === "succeeded") return s3;
+              const slice = buildModelClassIndex(rows3);
+              const base = s3.modelClassIndex ?? { classesByModelId: {}, classOfOffering: {} };
+              return { ...s3, modelClassIndex: { classesByModelId: { ...base.classesByModelId, ...slice.classesByModelId }, classOfOffering: { ...base.classOfOffering, ...slice.classOfOffering } } };
+            }),
+            (err) => fail("model-records-refresh-classes-failed", `${id}: ${messageOf(err)}`, { modelId: id })
+          )
+        );
+      }
+    }
+    for (const [key, cfg] of Object.entries(known.classConfigByOffering)) {
+      const offeringId = key.slice(cfg.modelId.length + 1);
+      jobs.push(
+        Promise.resolve(ai().rpc("resolve_model_config", { p_model_id: cfg.modelId, p_offering_id: offeringId })).then(
+          ({ data, error }) => {
+            if (error) throw error;
+            const next = data && typeof data === "object" && !Array.isArray(data) ? data : null;
+            update((s3) => ({ ...s3, classConfigByOffering: { ...s3.classConfigByOffering, [key]: { modelId: cfg.modelId, controls: next?.controls ?? null, constraints: next?.constraints ?? null } } }));
+          }
+        ).catch((err) => fail("model-records-refresh-class-config-failed", `${key}: ${messageOf(err)}`))
+      );
+    }
+    await Promise.all(jobs);
+  }
+  let refreshing = null;
+  let refreshAgain = null;
+  function refreshAll() {
+    if (refreshing) return refreshAgain ??= refreshing.then(() => {
+      refreshAgain = null;
+      return refreshAll();
+    });
+    refreshing = rereadKnown().finally(() => {
+      refreshing = null;
+    });
+    return refreshing;
+  }
   async function readOptions() {
     const { data: offeringRows, error: offeringError } = await ai().from("model_offering").select("model_id");
     if (offeringError) throw offeringError;
@@ -1070,20 +1181,7 @@ function createModelRecords(config) {
           return { ...s3, detailStatusById: { ...s3.detailStatusById, [modelId]: "loading" }, detailErrorById };
         });
         try {
-          const relation = await isSignedIn() ? "model_config" : "model_public";
-          const { data, error } = await ai().from(relation).select(MODEL_CONFIG_COLUMNS).eq("id", modelId).maybeSingle();
-          if (error) throw error;
-          const row = data;
-          if (!row) throw new Error(`AI model ${modelId} is not available (ai.${relation} has no such row)`);
-          if (!row.id || !row.name) throw new Error(`ai.${relation} returned a row without id/name for model ${modelId}`);
-          const read = {
-            ...row,
-            id: row.id,
-            name: row.name,
-            controls: row.controls ?? null,
-            capabilities: requireCanonicalCapabilities(row.capabilities, { modelId: row.id, modelName: row.name })
-          };
-          const record = normalizeModel(read);
+          const record = await readFullModel(modelId);
           update((s3) => {
             const existing = s3.entities[record.id];
             const detailErrorById = { ...s3.detailErrorById };
@@ -1207,6 +1305,7 @@ function createModelRecords(config) {
         }
       });
     },
+    refresh: () => refreshAll(),
     seedModel({ modelId, config: config2, offerings }) {
       if (!modelId) return;
       if (!classesReadFor.has(modelId) && state2.modelClassStatus !== "succeeded") {

package/dist/models/index.d.cts

@@ -671,6 +671,14 @@ interface ModelRecords {
     loadModelClasses(modelId: string): Promise<void>;
     /** The durable label of a model outside the options list. Never throws. */
     loadIdentity(modelId: string): Promise<void>;
+    /**
+     * The catalog changed upstream (a `catalog_changed` notice: an admin renamed, offered or retired a model):
+     * re-read everything this instance already read — the options list, every full record, every identity,
+     * the class index and slices, every pinned class's controls — and swap each in when it answers. The old
+     * rows stay on screen until then (no blank pill, no flicker); a failed re-read keeps them and reports
+     * through the error sink. Reads nothing that was never read. Never throws.
+     */
+    refresh(): Promise<void>;
     /**
      * Answer `loadModel` + `loadModelClasses` for one model from rows a batched
      * route read already returned (`chat.route_seed`): its `ai.model_config` row

package/dist/models/index.d.ts

@@ -671,6 +671,14 @@ interface ModelRecords {
     loadModelClasses(modelId: string): Promise<void>;
     /** The durable label of a model outside the options list. Never throws. */
     loadIdentity(modelId: string): Promise<void>;
+    /**
+     * The catalog changed upstream (a `catalog_changed` notice: an admin renamed, offered or retired a model):
+     * re-read everything this instance already read — the options list, every full record, every identity,
+     * the class index and slices, every pinned class's controls — and swap each in when it answers. The old
+     * rows stay on screen until then (no blank pill, no flicker); a failed re-read keeps them and reports
+     * through the error sink. Reads nothing that was never read. Never throws.
+     */
+    refresh(): Promise<void>;
     /**
      * Answer `loadModel` + `loadModelClasses` for one model from rows a batched
      * route read already returned (`chat.route_seed`): its `ai.model_config` row

package/dist/models/index.js

@@ -847,6 +847,117 @@ function createModelRecords(config) {
     inFlight.set(key, p);
     return p;
   };
+  async function readFullModel(modelId) {
+    const relation = await isSignedIn() ? "model_config" : "model_public";
+    const { data, error } = await ai().from(relation).select(MODEL_CONFIG_COLUMNS).eq("id", modelId).maybeSingle();
+    if (error) throw error;
+    const row = data;
+    if (!row) throw new Error(`AI model ${modelId} is not available (ai.${relation} has no such row)`);
+    if (!row.id || !row.name) throw new Error(`ai.${relation} returned a row without id/name for model ${modelId}`);
+    const read = {
+      ...row,
+      id: row.id,
+      name: row.name,
+      controls: row.controls ?? null,
+      capabilities: requireCanonicalCapabilities(row.capabilities, { modelId: row.id, modelName: row.name })
+    };
+    return normalizeModel(read);
+  }
+  async function readOfferings(modelId) {
+    const q = ai().from("model_offering").select("model_id, offering_id, served_via, served_via_endpoint_id, priority");
+    const { data, error } = await (modelId ? q.eq("model_id", modelId) : q);
+    if (error) throw error;
+    return data ?? [];
+  }
+  async function rereadKnown() {
+    const known = state2;
+    const jobs = [];
+    const fail = (code, message, context) => errorSink({ code, message: `Catalog refresh: ${message}`, ...context ? { context } : {} });
+    if (known.fetchScope === "active" || known.fetchScope === "all") {
+      jobs.push(
+        readOptions().then(
+          (rows3) => update((s3) => {
+            const entities = { ...s3.entities };
+            for (const row of rows3) {
+              const existing = entities[row.id];
+              entities[row.id] = { ...emptyRecord(), ...existing, ...row, _fetchType: existing?._fetchType === "full" ? "full" : "options" };
+            }
+            return withIdLists({ ...s3, entities, lastFetched: Date.now(), error: null });
+          }),
+          (err) => fail("model-records-refresh-options-failed", messageOf(err))
+        )
+      );
+    }
+    for (const [id, record] of Object.entries(known.entities)) {
+      if (record._fetchType !== "full") continue;
+      jobs.push(
+        readFullModel(id).then(
+          (fresh) => update((s3) => {
+            const existing = s3.entities[fresh.id];
+            return withIdLists({ ...s3, entities: { ...s3.entities, [fresh.id]: { ...emptyRecord(), ...existing, ...fresh, maker: fresh.maker ?? existing?.maker ?? null, _fetchType: "full" } } });
+          }),
+          (err) => fail("model-records-refresh-model-failed", `${id}: ${messageOf(err)}`, { modelId: id })
+        )
+      );
+    }
+    for (const id of Object.keys(known.identityById)) {
+      jobs.push(
+        Promise.resolve(ai().from("model_definition").select("id, name, common_name, is_deprecated").eq("id", id).maybeSingle()).then(
+          ({ data, error }) => {
+            if (error) throw error;
+            if (data) update((s3) => ({ ...s3, identityById: { ...s3.identityById, [id]: data } }));
+          }
+        ).catch((err) => fail("model-records-refresh-identity-failed", `${id}: ${messageOf(err)}`, { modelId: id }))
+      );
+    }
+    if (known.modelClassStatus === "succeeded") {
+      jobs.push(
+        readOfferings().then(
+          (rows3) => update((s3) => ({ ...s3, modelClassIndex: buildModelClassIndex(rows3) })),
+          (err) => fail("model-records-refresh-classes-failed", messageOf(err))
+        )
+      );
+    } else {
+      for (const id of classesReadFor) {
+        jobs.push(
+          readOfferings(id).then(
+            (rows3) => update((s3) => {
+              if (s3.modelClassStatus === "succeeded") return s3;
+              const slice = buildModelClassIndex(rows3);
+              const base = s3.modelClassIndex ?? { classesByModelId: {}, classOfOffering: {} };
+              return { ...s3, modelClassIndex: { classesByModelId: { ...base.classesByModelId, ...slice.classesByModelId }, classOfOffering: { ...base.classOfOffering, ...slice.classOfOffering } } };
+            }),
+            (err) => fail("model-records-refresh-classes-failed", `${id}: ${messageOf(err)}`, { modelId: id })
+          )
+        );
+      }
+    }
+    for (const [key, cfg] of Object.entries(known.classConfigByOffering)) {
+      const offeringId = key.slice(cfg.modelId.length + 1);
+      jobs.push(
+        Promise.resolve(ai().rpc("resolve_model_config", { p_model_id: cfg.modelId, p_offering_id: offeringId })).then(
+          ({ data, error }) => {
+            if (error) throw error;
+            const next = data && typeof data === "object" && !Array.isArray(data) ? data : null;
+            update((s3) => ({ ...s3, classConfigByOffering: { ...s3.classConfigByOffering, [key]: { modelId: cfg.modelId, controls: next?.controls ?? null, constraints: next?.constraints ?? null } } }));
+          }
+        ).catch((err) => fail("model-records-refresh-class-config-failed", `${key}: ${messageOf(err)}`))
+      );
+    }
+    await Promise.all(jobs);
+  }
+  let refreshing = null;
+  let refreshAgain = null;
+  function refreshAll() {
+    if (refreshing) return refreshAgain ??= refreshing.then(() => {
+      refreshAgain = null;
+      return refreshAll();
+    });
+    refreshing = rereadKnown().finally(() => {
+      refreshing = null;
+    });
+    return refreshing;
+  }
   async function readOptions() {
     const { data: offeringRows, error: offeringError } = await ai().from("model_offering").select("model_id");
     if (offeringError) throw offeringError;
@@ -912,20 +1023,7 @@ function createModelRecords(config) {
           return { ...s3, detailStatusById: { ...s3.detailStatusById, [modelId]: "loading" }, detailErrorById };
         });
         try {
-          const relation = await isSignedIn() ? "model_config" : "model_public";
-          const { data, error } = await ai().from(relation).select(MODEL_CONFIG_COLUMNS).eq("id", modelId).maybeSingle();
-          if (error) throw error;
-          const row = data;
-          if (!row) throw new Error(`AI model ${modelId} is not available (ai.${relation} has no such row)`);
-          if (!row.id || !row.name) throw new Error(`ai.${relation} returned a row without id/name for model ${modelId}`);
-          const read = {
-            ...row,
-            id: row.id,
-            name: row.name,
-            controls: row.controls ?? null,
-            capabilities: requireCanonicalCapabilities(row.capabilities, { modelId: row.id, modelName: row.name })
-          };
-          const record = normalizeModel(read);
+          const record = await readFullModel(modelId);
           update((s3) => {
             const existing = s3.entities[record.id];
             const detailErrorById = { ...s3.detailErrorById };
@@ -1049,6 +1147,7 @@ function createModelRecords(config) {
         }
       });
     },
+    refresh: () => refreshAll(),
     seedModel({ modelId, config: config2, offerings }) {
       if (!modelId) return;
       if (!classesReadFor.has(modelId) && state2.modelClassStatus !== "succeeded") {

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

@@ -331,6 +331,14 @@ interface ModelRecords {
     loadModelClasses(modelId: string): Promise<void>;
     /** The durable label of a model outside the options list. Never throws. */
     loadIdentity(modelId: string): Promise<void>;
+    /**
+     * The catalog changed upstream (a `catalog_changed` notice: an admin renamed, offered or retired a model):
+     * re-read everything this instance already read — the options list, every full record, every identity,
+     * the class index and slices, every pinned class's controls — and swap each in when it answers. The old
+     * rows stay on screen until then (no blank pill, no flicker); a failed re-read keeps them and reports
+     * through the error sink. Reads nothing that was never read. Never throws.
+     */
+    refresh(): Promise<void>;
     /**
      * Answer `loadModel` + `loadModelClasses` for one model from rows a batched
      * route read already returned (`chat.route_seed`): its `ai.model_config` row

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

@@ -331,6 +331,14 @@ interface ModelRecords {
     loadModelClasses(modelId: string): Promise<void>;
     /** The durable label of a model outside the options list. Never throws. */
     loadIdentity(modelId: string): Promise<void>;
+    /**
+     * The catalog changed upstream (a `catalog_changed` notice: an admin renamed, offered or retired a model):
+     * re-read everything this instance already read — the options list, every full record, every identity,
+     * the class index and slices, every pinned class's controls — and swap each in when it answers. The old
+     * rows stay on screen until then (no blank pill, no flicker); a failed re-read keeps them and reports
+     * through the error sink. Reads nothing that was never read. Never throws.
+     */
+    refresh(): Promise<void>;
     /**
      * Answer `loadModel` + `loadModelClasses` for one model from rows a batched
      * route read already returned (`chat.route_seed`): its `ai.model_config` row

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.215",
+  "version": "0.59.217",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -510,13 +510,13 @@
   "dependencies": {
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/api": "latest",
-    "@ai-matrx/associations": "latest",
     "@ai-matrx/content-ir": "latest",
+    "@ai-matrx/associations": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
-    "@ai-matrx/icons": "latest",
-    "@ai-matrx/kit": "latest"
+    "@ai-matrx/kit": "latest",
+    "@ai-matrx/icons": "latest"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -561,5 +561,5 @@
     "verify:tarball": "node ./scripts/verify-tarball.mjs",
     "typegen:self-test": "node scripts/typegen/drop-guard.self-test.mjs && node scripts/typegen/check-api-types-fresh.mjs --self-test"
   },
-  "gitHead": "1e5f26b1bb6d67f1553566c6c38b25e570e2a765"
+  "gitHead": "268d0c2f1f0b2ea129ee132098cb3e7b9184a2ab"
 }