@ai-matrx/agents 0.59.204 → 0.59.205

package/CHANGELOG.md

@@ -1,10 +1,20 @@
 # Changelog
 
-## 0.59.204
+## 0.59.205
 
 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.204
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 5a78bc1e32 4d832f50ff -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
+## 0.59.203
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 87ac441108 5a78bc1e32 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.202
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 6085e09f65 87ac441108 -- apps/shared/matrx-agents/src`

package/dist/content-transfer/index.cjs

@@ -669,6 +669,8 @@ var MANDATE_KEYS = {
   vision_interview__sounding_board: "vision_interview.sounding_board",
   vision_interview__transcript_cleaner: "vision_interview.transcript_cleaner",
   vision_interview__vision_author: "vision_interview.vision_author",
+  visual_maps__diagram_repair: "visual_maps.diagram_repair",
+  visual_maps__diagram_review: "visual_maps.diagram_review",
   voice__communicator: "voice.communicator",
   voice__gemini_live: "voice.gemini_live",
   voice__intro: "voice.intro",
@@ -703,7 +705,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.204 — no longer declared in
+   * @deprecated retiring since 0.59.205 — 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

@@ -646,6 +646,8 @@ var MANDATE_KEYS = {
   vision_interview__sounding_board: "vision_interview.sounding_board",
   vision_interview__transcript_cleaner: "vision_interview.transcript_cleaner",
   vision_interview__vision_author: "vision_interview.vision_author",
+  visual_maps__diagram_repair: "visual_maps.diagram_repair",
+  visual_maps__diagram_review: "visual_maps.diagram_review",
   voice__communicator: "voice.communicator",
   voice__gemini_live: "voice.gemini_live",
   voice__intro: "voice.intro",
@@ -680,7 +682,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.204 — no longer declared in
+   * @deprecated retiring since 0.59.205 — 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

@@ -622,6 +622,8 @@ var MANDATE_KEYS = {
   vision_interview__sounding_board: "vision_interview.sounding_board",
   vision_interview__transcript_cleaner: "vision_interview.transcript_cleaner",
   vision_interview__vision_author: "vision_interview.vision_author",
+  visual_maps__diagram_repair: "visual_maps.diagram_repair",
+  visual_maps__diagram_review: "visual_maps.diagram_review",
   voice__communicator: "voice.communicator",
   voice__gemini_live: "voice.gemini_live",
   voice__intro: "voice.intro",
@@ -656,7 +658,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.204 — no longer declared in
+   * @deprecated retiring since 0.59.205 — 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

@@ -594,6 +594,8 @@ var MANDATE_KEYS = {
   vision_interview__sounding_board: "vision_interview.sounding_board",
   vision_interview__transcript_cleaner: "vision_interview.transcript_cleaner",
   vision_interview__vision_author: "vision_interview.vision_author",
+  visual_maps__diagram_repair: "visual_maps.diagram_repair",
+  visual_maps__diagram_review: "visual_maps.diagram_review",
   voice__communicator: "voice.communicator",
   voice__gemini_live: "voice.gemini_live",
   voice__intro: "voice.intro",
@@ -628,7 +630,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.204 — no longer declared in
+   * @deprecated retiring since 0.59.205 — 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: "4d832f50ff335ff7d2858da508739243d30fdcc7",
+  aidreamRevision: "e06d9852949d2176919d289c140ceb232bca7f09",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.204",
+  packageVersion: "0.59.205",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -632,6 +632,8 @@ var MANDATE_KEYS = {
   vision_interview__sounding_board: "vision_interview.sounding_board",
   vision_interview__transcript_cleaner: "vision_interview.transcript_cleaner",
   vision_interview__vision_author: "vision_interview.vision_author",
+  visual_maps__diagram_repair: "visual_maps.diagram_repair",
+  visual_maps__diagram_review: "visual_maps.diagram_review",
   voice__communicator: "voice.communicator",
   voice__gemini_live: "voice.gemini_live",
   voice__intro: "voice.intro",
@@ -666,7 +668,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.204 — no longer declared in
+   * @deprecated retiring since 0.59.205 — 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 +695,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.204",
+  "coding_session.managed_translation_reference": "0.59.205",
   "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,10 +6,10 @@
  * 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:   4d832f50ff335ff7d2858da508739243d30fdcc7
+ * aidream revision:   e06d9852949d2176919d289c140ceb232bca7f09
  * generator version:  1.0.0
- * package version:    0.59.204
- * active keys:        606
+ * package version:    0.59.205
+ * active keys:        608
  * retiring keys:      5
  *
  * THE IDENTIFIER RULE: every `.` in a key becomes `__`, any character outside
@@ -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: "4d832f50ff335ff7d2858da508739243d30fdcc7";
+    readonly aidreamRevision: "e06d9852949d2176919d289c140ceb232bca7f09";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.204";
+    readonly packageVersion: "0.59.205";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -605,6 +605,8 @@ declare const MANDATE_KEYS: {
     readonly vision_interview__sounding_board: "vision_interview.sounding_board";
     readonly vision_interview__transcript_cleaner: "vision_interview.transcript_cleaner";
     readonly vision_interview__vision_author: "vision_interview.vision_author";
+    readonly visual_maps__diagram_repair: "visual_maps.diagram_repair";
+    readonly visual_maps__diagram_review: "visual_maps.diagram_review";
     readonly voice__communicator: "voice.communicator";
     readonly voice__gemini_live: "voice.gemini_live";
     readonly voice__intro: "voice.intro";
@@ -639,7 +641,7 @@ declare const MANDATE_KEYS: {
      */
     readonly brand_discovery__offering_roles: "brand_discovery.offering_roles";
     /**
-     * @deprecated retiring since 0.59.204 — no longer declared in
+     * @deprecated retiring since 0.59.205 — 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 +672,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.204";
+    readonly "coding_session.managed_translation_reference": "0.59.205";
     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,10 +6,10 @@
  * 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:   4d832f50ff335ff7d2858da508739243d30fdcc7
+ * aidream revision:   e06d9852949d2176919d289c140ceb232bca7f09
  * generator version:  1.0.0
- * package version:    0.59.204
- * active keys:        606
+ * package version:    0.59.205
+ * active keys:        608
  * retiring keys:      5
  *
  * THE IDENTIFIER RULE: every `.` in a key becomes `__`, any character outside
@@ -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: "4d832f50ff335ff7d2858da508739243d30fdcc7";
+    readonly aidreamRevision: "e06d9852949d2176919d289c140ceb232bca7f09";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.204";
+    readonly packageVersion: "0.59.205";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -605,6 +605,8 @@ declare const MANDATE_KEYS: {
     readonly vision_interview__sounding_board: "vision_interview.sounding_board";
     readonly vision_interview__transcript_cleaner: "vision_interview.transcript_cleaner";
     readonly vision_interview__vision_author: "vision_interview.vision_author";
+    readonly visual_maps__diagram_repair: "visual_maps.diagram_repair";
+    readonly visual_maps__diagram_review: "visual_maps.diagram_review";
     readonly voice__communicator: "voice.communicator";
     readonly voice__gemini_live: "voice.gemini_live";
     readonly voice__intro: "voice.intro";
@@ -639,7 +641,7 @@ declare const MANDATE_KEYS: {
      */
     readonly brand_discovery__offering_roles: "brand_discovery.offering_roles";
     /**
-     * @deprecated retiring since 0.59.204 — no longer declared in
+     * @deprecated retiring since 0.59.205 — 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 +672,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.204";
+    readonly "coding_session.managed_translation_reference": "0.59.205";
     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: "4d832f50ff335ff7d2858da508739243d30fdcc7",
+  aidreamRevision: "e06d9852949d2176919d289c140ceb232bca7f09",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.204",
+  packageVersion: "0.59.205",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -585,6 +585,8 @@ var MANDATE_KEYS = {
   vision_interview__sounding_board: "vision_interview.sounding_board",
   vision_interview__transcript_cleaner: "vision_interview.transcript_cleaner",
   vision_interview__vision_author: "vision_interview.vision_author",
+  visual_maps__diagram_repair: "visual_maps.diagram_repair",
+  visual_maps__diagram_review: "visual_maps.diagram_review",
   voice__communicator: "voice.communicator",
   voice__gemini_live: "voice.gemini_live",
   voice__intro: "voice.intro",
@@ -619,7 +621,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.204 — no longer declared in
+   * @deprecated retiring since 0.59.205 — 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 +648,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.204",
+  "coding_session.managed_translation_reference": "0.59.205",
   "pdf.content_cleaner": "0.59.0",
   "sms.owner_beta": "0.59.0",
   "voice.owner_beta": "0.59.0"

package/dist/models/react/index.cjs

@@ -1479,16 +1479,19 @@ function ModelRow({
   );
 }
 function LocalModelRow({ model, selected, onSelect }) {
+  const unusable = model.unusable ?? null;
   const dim = model.needsMoreMemory === true;
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
     "div",
     {
       role: "button",
-      tabIndex: 0,
+      tabIndex: unusable ? -1 : 0,
+      "aria-disabled": unusable ? true : void 0,
       "data-local-model": model.id,
-      title: dim ? "Needs more memory than this computer has free" : void 0,
-      onClick: onSelect,
+      title: unusable ?? (dim ? "Needs more memory than this computer has free" : void 0),
+      onClick: unusable ? void 0 : onSelect,
       onKeyDown: (e) => {
+        if (unusable) return;
         if (e.key === "Enter" || e.key === " ") {
           e.preventDefault();
           onSelect();
@@ -1497,22 +1500,26 @@ function LocalModelRow({ model, selected, onSelect }) {
       className: (0, import_design_system.cn)(
         "grid w-full cursor-pointer grid-cols-[16px_20px_minmax(0,1fr)_2.75rem_3rem_2.75rem] items-center gap-2 rounded px-2 py-1 transition-colors hover:bg-muted/60 focus:bg-muted/60 focus:outline-none",
         dim && "opacity-60",
+        unusable && "cursor-default opacity-60 hover:bg-transparent focus:bg-transparent",
         selected && "bg-muted"
       ),
       children: [
         /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "w-4" }),
         /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "flex w-5 justify-center", title: model.maker ?? void 0, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_brand_glyphs.MakerBrandGlyph, { maker: model.maker ?? null, colored: true, className: "h-3.5 w-3.5" }) }),
-        /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("span", { className: "flex min-w-0 items-center gap-1.5", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "truncate text-xs font-medium text-foreground", children: model.name }),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-            "span",
-            {
-              className: "shrink-0 rounded border border-primary/40 bg-primary/10 px-1 text-[9px] font-medium text-foreground/80",
-              title: "Runs on this computer",
-              children: "local"
-            }
-          ),
-          dim && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "shrink-0 rounded bg-muted px-1 text-[9px] text-muted-foreground", title: "Needs more memory than this computer has free", children: "needs memory" })
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("span", { className: "flex min-w-0 flex-col", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("span", { className: "flex min-w-0 items-center gap-1.5", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "truncate text-xs font-medium text-foreground", children: model.name }),
+            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+              "span",
+              {
+                className: "shrink-0 rounded border border-primary/40 bg-primary/10 px-1 text-[9px] font-medium text-foreground/80",
+                title: "Runs on this computer",
+                children: "local"
+              }
+            ),
+            dim && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "shrink-0 rounded bg-muted px-1 text-[9px] text-muted-foreground", title: "Needs more memory than this computer has free", children: "needs memory" })
+          ] }),
+          unusable && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { "data-local-model-reason": true, className: "truncate text-[11px] text-muted-foreground", children: unusable })
         ] }),
         /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "w-11" }),
         /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "block w-12 whitespace-nowrap text-right font-mono text-[11px] tabular-nums text-foreground/80", children: model.contextWindow == null ? "\u2014" : fmtPointsCompact(model.contextWindow) }),
@@ -1623,6 +1630,8 @@ function ModelListDropdown({
     const q = query.trim().toLowerCase();
     return q ? localAll.filter((m) => [m.name, m.maker, "local"].some((f) => f?.toLowerCase().includes(q))) : localAll;
   }, [localEligible, tab, query, localAll]);
+  const localRunnable = (0, import_react2.useMemo)(() => localRows.filter((m) => !m.unusable), [localRows]);
+  const localUnusable = (0, import_react2.useMemo)(() => localRows.filter((m) => m.unusable), [localRows]);
   const shown = selected ?? (selectedLocal ? { name: selectedLocal.name, maker: selectedLocal.maker ?? null } : null);
   const makerOptions = (0, import_react2.useMemo)(
     () => [
@@ -2003,8 +2012,10 @@ function ModelListDropdown({
         }
       ),
       localRows.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_jsx_runtime4.Fragment, { children: [
-        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: GROUP_HEADING, children: localGroupLabel }),
-        localRows.map((l) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(LocalModelRow, { model: l, selected: l.id === value, onSelect: () => handleSelectLocal(l) }, l.id)),
+        localRunnable.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: GROUP_HEADING, children: localGroupLabel }),
+        localRunnable.map((l) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(LocalModelRow, { model: l, selected: l.id === value, onSelect: () => handleSelectLocal(l) }, l.id)),
+        localUnusable.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: GROUP_HEADING, children: "Cannot run here" }),
+        localUnusable.map((l) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(LocalModelRow, { model: l, selected: false, onSelect: () => void 0 }, l.id)),
         filtered.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: GROUP_HEADING, children: "Cloud" })
       ] }),
       filtered.length === 0 ? localRows.length > 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "p-4 text-center text-xs text-muted-foreground", children: "No models match your filters." }) : listRows.map(({ model: m, classTier }) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
@@ -2033,9 +2044,9 @@ function ModelListDropdown({
         "Models couldn't be loaded",
         ports.renderErrorAction?.(String(error))
       ] }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_jsx_runtime4.Fragment, { children: [
-        listRows.length + localRows.length,
+        listRows.length + localRunnable.length,
         " model",
-        listRows.length + localRows.length === 1 ? "" : "s",
+        listRows.length + localRunnable.length === 1 ? "" : "s",
         variant === "user" && (hiddenModelIds?.length ?? 0) > 0 ? /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_jsx_runtime4.Fragment, { children: [
           " \xB7 ",
           ports.settingsHref && LinkComponent ? /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(LinkComponent, { href: ports.settingsHref, className: "underline hover:text-foreground", children: [

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

@@ -423,6 +423,11 @@ interface LocalModelEntry {
     contextWindow?: number | null;
     /** The computer cannot hold it today: the row is dimmed and says why, but stays pickable. */
     needsMoreMemory?: boolean;
+    /**
+     * On the computer but it cannot run there, and why, in one line ("Part 2 of 3 is missing"). The
+     * picker lists it under "Cannot run here" with this reason, dimmed and never pickable.
+     */
+    unusable?: string;
 }
 /**
  * The host's local-model source (a store: `getModels` + `subscribe`, like the catalog). The picker

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

@@ -423,6 +423,11 @@ interface LocalModelEntry {
     contextWindow?: number | null;
     /** The computer cannot hold it today: the row is dimmed and says why, but stays pickable. */
     needsMoreMemory?: boolean;
+    /**
+     * On the computer but it cannot run there, and why, in one line ("Part 2 of 3 is missing"). The
+     * picker lists it under "Cannot run here" with this reason, dimmed and never pickable.
+     */
+    unusable?: string;
 }
 /**
  * The host's local-model source (a store: `getModels` + `subscribe`, like the catalog). The picker

package/dist/models/react/index.js

@@ -1461,16 +1461,19 @@ function ModelRow({
   );
 }
 function LocalModelRow({ model, selected, onSelect }) {
+  const unusable = model.unusable ?? null;
   const dim = model.needsMoreMemory === true;
   return /* @__PURE__ */ jsxs3(
     "div",
     {
       role: "button",
-      tabIndex: 0,
+      tabIndex: unusable ? -1 : 0,
+      "aria-disabled": unusable ? true : void 0,
       "data-local-model": model.id,
-      title: dim ? "Needs more memory than this computer has free" : void 0,
-      onClick: onSelect,
+      title: unusable ?? (dim ? "Needs more memory than this computer has free" : void 0),
+      onClick: unusable ? void 0 : onSelect,
       onKeyDown: (e) => {
+        if (unusable) return;
         if (e.key === "Enter" || e.key === " ") {
           e.preventDefault();
           onSelect();
@@ -1479,22 +1482,26 @@ function LocalModelRow({ model, selected, onSelect }) {
       className: cn(
         "grid w-full cursor-pointer grid-cols-[16px_20px_minmax(0,1fr)_2.75rem_3rem_2.75rem] items-center gap-2 rounded px-2 py-1 transition-colors hover:bg-muted/60 focus:bg-muted/60 focus:outline-none",
         dim && "opacity-60",
+        unusable && "cursor-default opacity-60 hover:bg-transparent focus:bg-transparent",
         selected && "bg-muted"
       ),
       children: [
         /* @__PURE__ */ jsx4("span", { className: "w-4" }),
         /* @__PURE__ */ jsx4("span", { className: "flex w-5 justify-center", title: model.maker ?? void 0, children: /* @__PURE__ */ jsx4(MakerBrandGlyph, { maker: model.maker ?? null, colored: true, className: "h-3.5 w-3.5" }) }),
-        /* @__PURE__ */ jsxs3("span", { className: "flex min-w-0 items-center gap-1.5", children: [
-          /* @__PURE__ */ jsx4("span", { className: "truncate text-xs font-medium text-foreground", children: model.name }),
-          /* @__PURE__ */ jsx4(
-            "span",
-            {
-              className: "shrink-0 rounded border border-primary/40 bg-primary/10 px-1 text-[9px] font-medium text-foreground/80",
-              title: "Runs on this computer",
-              children: "local"
-            }
-          ),
-          dim && /* @__PURE__ */ jsx4("span", { className: "shrink-0 rounded bg-muted px-1 text-[9px] text-muted-foreground", title: "Needs more memory than this computer has free", children: "needs memory" })
+        /* @__PURE__ */ jsxs3("span", { className: "flex min-w-0 flex-col", children: [
+          /* @__PURE__ */ jsxs3("span", { className: "flex min-w-0 items-center gap-1.5", children: [
+            /* @__PURE__ */ jsx4("span", { className: "truncate text-xs font-medium text-foreground", children: model.name }),
+            /* @__PURE__ */ jsx4(
+              "span",
+              {
+                className: "shrink-0 rounded border border-primary/40 bg-primary/10 px-1 text-[9px] font-medium text-foreground/80",
+                title: "Runs on this computer",
+                children: "local"
+              }
+            ),
+            dim && /* @__PURE__ */ jsx4("span", { className: "shrink-0 rounded bg-muted px-1 text-[9px] text-muted-foreground", title: "Needs more memory than this computer has free", children: "needs memory" })
+          ] }),
+          unusable && /* @__PURE__ */ jsx4("span", { "data-local-model-reason": true, className: "truncate text-[11px] text-muted-foreground", children: unusable })
         ] }),
         /* @__PURE__ */ jsx4("span", { className: "w-11" }),
         /* @__PURE__ */ jsx4("span", { className: "block w-12 whitespace-nowrap text-right font-mono text-[11px] tabular-nums text-foreground/80", children: model.contextWindow == null ? "\u2014" : fmtPointsCompact(model.contextWindow) }),
@@ -1605,6 +1612,8 @@ function ModelListDropdown({
     const q = query.trim().toLowerCase();
     return q ? localAll.filter((m) => [m.name, m.maker, "local"].some((f) => f?.toLowerCase().includes(q))) : localAll;
   }, [localEligible, tab, query, localAll]);
+  const localRunnable = useMemo2(() => localRows.filter((m) => !m.unusable), [localRows]);
+  const localUnusable = useMemo2(() => localRows.filter((m) => m.unusable), [localRows]);
   const shown = selected ?? (selectedLocal ? { name: selectedLocal.name, maker: selectedLocal.maker ?? null } : null);
   const makerOptions = useMemo2(
     () => [
@@ -1985,8 +1994,10 @@ function ModelListDropdown({
         }
       ),
       localRows.length > 0 && /* @__PURE__ */ jsxs3(Fragment2, { children: [
-        /* @__PURE__ */ jsx4("div", { className: GROUP_HEADING, children: localGroupLabel }),
-        localRows.map((l) => /* @__PURE__ */ jsx4(LocalModelRow, { model: l, selected: l.id === value, onSelect: () => handleSelectLocal(l) }, l.id)),
+        localRunnable.length > 0 && /* @__PURE__ */ jsx4("div", { className: GROUP_HEADING, children: localGroupLabel }),
+        localRunnable.map((l) => /* @__PURE__ */ jsx4(LocalModelRow, { model: l, selected: l.id === value, onSelect: () => handleSelectLocal(l) }, l.id)),
+        localUnusable.length > 0 && /* @__PURE__ */ jsx4("div", { className: GROUP_HEADING, children: "Cannot run here" }),
+        localUnusable.map((l) => /* @__PURE__ */ jsx4(LocalModelRow, { model: l, selected: false, onSelect: () => void 0 }, l.id)),
         filtered.length > 0 && /* @__PURE__ */ jsx4("div", { className: GROUP_HEADING, children: "Cloud" })
       ] }),
       filtered.length === 0 ? localRows.length > 0 ? null : /* @__PURE__ */ jsx4("div", { className: "p-4 text-center text-xs text-muted-foreground", children: "No models match your filters." }) : listRows.map(({ model: m, classTier }) => /* @__PURE__ */ jsx4(
@@ -2015,9 +2026,9 @@ function ModelListDropdown({
         "Models couldn't be loaded",
         ports.renderErrorAction?.(String(error))
       ] }) : /* @__PURE__ */ jsxs3(Fragment2, { children: [
-        listRows.length + localRows.length,
+        listRows.length + localRunnable.length,
         " model",
-        listRows.length + localRows.length === 1 ? "" : "s",
+        listRows.length + localRunnable.length === 1 ? "" : "s",
         variant === "user" && (hiddenModelIds?.length ?? 0) > 0 ? /* @__PURE__ */ jsxs3(Fragment2, { children: [
           " \xB7 ",
           ports.settingsHref && LinkComponent ? /* @__PURE__ */ jsxs3(LinkComponent, { href: ports.settingsHref, className: "underline hover:text-foreground", children: [

package/dist/settings/index.d.cts

@@ -561,6 +561,11 @@ interface LocalModelEntry {
     contextWindow?: number | null;
     /** The computer cannot hold it today: the row is dimmed and says why, but stays pickable. */
     needsMoreMemory?: boolean;
+    /**
+     * On the computer but it cannot run there, and why, in one line ("Part 2 of 3 is missing"). The
+     * picker lists it under "Cannot run here" with this reason, dimmed and never pickable.
+     */
+    unusable?: string;
 }
 /**
  * The host's local-model source (a store: `getModels` + `subscribe`, like the catalog). The picker

package/dist/settings/index.d.ts

@@ -561,6 +561,11 @@ interface LocalModelEntry {
     contextWindow?: number | null;
     /** The computer cannot hold it today: the row is dimmed and says why, but stays pickable. */
     needsMoreMemory?: boolean;
+    /**
+     * On the computer but it cannot run there, and why, in one line ("Part 2 of 3 is missing"). The
+     * picker lists it under "Cannot run here" with this reason, dimmed and never pickable.
+     */
+    unusable?: string;
 }
 /**
  * The host's local-model source (a store: `getModels` + `subscribe`, like the catalog). The picker

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.204",
+  "version": "0.59.205",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -510,10 +510,10 @@
   "dependencies": {
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/api": "latest",
-    "@ai-matrx/associations": "latest",
-    "@ai-matrx/design-system": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/content-ir": "latest",
+    "@ai-matrx/design-system": "latest",
+    "@ai-matrx/associations": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest"
@@ -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": "4d832f50ff335ff7d2858da508739243d30fdcc7"
+  "gitHead": "e06d9852949d2176919d289c140ceb232bca7f09"
 }