@ai-matrx/agents 0.59.201 → 0.59.203

package/CHANGELOG.md

@@ -1,10 +1,15 @@
 # Changelog
 
-## 0.59.201
+## 0.59.203
 
 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.201
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff ea809490d8 6085e09f65 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.200
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 85ba8e9e58 ea809490d8 -- 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.201 — no longer declared in
+   * @deprecated retiring since 0.59.203 — 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.201 — no longer declared in
+   * @deprecated retiring since 0.59.203 — 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.201 — no longer declared in
+   * @deprecated retiring since 0.59.203 — 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.201 — no longer declared in
+   * @deprecated retiring since 0.59.203 — 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: "6085e09f65f8512280be0a8be5e3db2b4d1888c9",
+  aidreamRevision: "5a78bc1e32253c3f46527ed9d519c3562e446cf7",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.201",
+  packageVersion: "0.59.203",
   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.201 — no longer declared in
+   * @deprecated retiring since 0.59.203 — 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.201",
+  "coding_session.managed_translation_reference": "0.59.203",
   "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:   6085e09f65f8512280be0a8be5e3db2b4d1888c9
+ * aidream revision:   5a78bc1e32253c3f46527ed9d519c3562e446cf7
  * generator version:  1.0.0
- * package version:    0.59.201
+ * package version:    0.59.203
  * 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: "6085e09f65f8512280be0a8be5e3db2b4d1888c9";
+    readonly aidreamRevision: "5a78bc1e32253c3f46527ed9d519c3562e446cf7";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.201";
+    readonly packageVersion: "0.59.203";
     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.201 — no longer declared in
+     * @deprecated retiring since 0.59.203 — 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.201";
+    readonly "coding_session.managed_translation_reference": "0.59.203";
     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:   6085e09f65f8512280be0a8be5e3db2b4d1888c9
+ * aidream revision:   5a78bc1e32253c3f46527ed9d519c3562e446cf7
  * generator version:  1.0.0
- * package version:    0.59.201
+ * package version:    0.59.203
  * 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: "6085e09f65f8512280be0a8be5e3db2b4d1888c9";
+    readonly aidreamRevision: "5a78bc1e32253c3f46527ed9d519c3562e446cf7";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.201";
+    readonly packageVersion: "0.59.203";
     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.201 — no longer declared in
+     * @deprecated retiring since 0.59.203 — 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.201";
+    readonly "coding_session.managed_translation_reference": "0.59.203";
     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: "6085e09f65f8512280be0a8be5e3db2b4d1888c9",
+  aidreamRevision: "5a78bc1e32253c3f46527ed9d519c3562e446cf7",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.201",
+  packageVersion: "0.59.203",
   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.201 — no longer declared in
+   * @deprecated retiring since 0.59.203 — 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.201",
+  "coding_session.managed_translation_reference": "0.59.203",
   "pdf.content_cleaner": "0.59.0",
   "sms.owner_beta": "0.59.0",
   "voice.owner_beta": "0.59.0"

package/dist/models/index.cjs

@@ -20,7 +20,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // models/index.ts
 var models_exports = {};
 __export(models_exports, {
-  AGENT_AUTHORING_DEFAULT_MODEL_KNOB: () => AGENT_AUTHORING_DEFAULT_MODEL_KNOB,
   CHAT_DEFAULT_MODEL_KNOB: () => CHAT_DEFAULT_MODEL_KNOB,
   CONTENT_TYPES: () => CONTENT_TYPES,
   DEFAULT_CAPABILITIES: () => DEFAULT_CAPABILITIES,
@@ -36,6 +35,7 @@ __export(models_exports, {
   MAX_SUCCESSION_HOPS: () => MAX_SUCCESSION_HOPS,
   MODEL_CATALOG_KINDS: () => MODEL_CATALOG_KINDS,
   MODEL_FAVORITE_ENTITY_TYPE: () => MODEL_FAVORITE_ENTITY_TYPE,
+  NEW_AGENT_DEFAULT_MODEL_KNOB: () => NEW_AGENT_DEFAULT_MODEL_KNOB,
   OUTPUT_MODALITIES: () => OUTPUT_MODALITIES,
   SERVICE_LABEL: () => SERVICE_LABEL,
   SERVICE_LABEL_PLURAL: () => SERVICE_LABEL_PLURAL,
@@ -91,7 +91,6 @@ __export(models_exports, {
   modelClassName: () => modelClassName,
   modelClassPinOf: () => modelClassPinOf,
   modelsForSelectionPurpose: () => modelsForSelectionPurpose,
-  newAgentModelStandInCount: () => newAgentModelStandInCount,
   normalizeArch: () => normalizeArch,
   normalizeModel: () => normalizeModel,
   normalizeModels: () => normalizeModels,
@@ -117,6 +116,7 @@ __export(models_exports, {
   resolveNewAgentModelId: () => resolveNewAgentModelId,
   resolvePreferredModelChoice: () => resolvePreferredModelChoice,
   resolveSuccessor: () => resolveSuccessor,
+  runtimesOnEngine: () => runtimesOnEngine,
   seesImages: () => seesImages,
   selectActiveModels: () => selectActiveModels,
   selectActiveModelsReady: () => selectActiveModelsReady,
@@ -150,6 +150,7 @@ __export(models_exports, {
   takesInput: () => takesInput,
   toAuditRecord: () => toAuditRecord,
   validateModelSet: () => validateModelSet,
+  variantVerdict: () => variantVerdict,
   withModelClass: () => withModelClass
 });
 module.exports = __toCommonJS(models_exports);
@@ -1881,13 +1882,26 @@ function byOrder(a, b) {
 function asCandidate(j) {
   return j.candidate ?? { variant: j.variant, build: null, hardware_class: null, compat: "expected", fits: null };
 }
-function judgeAll(model, want, device, runtimes) {
+function judgeAll(model, want, device, runtimes, options = {}) {
   const checkFormat = runtimes.length > 0 || device !== null;
   const list = want.variant_policy === "exact" ? model.variants.filter((x) => x.key === want.variant_key) : model.variants;
-  return list.map((v) => judge(v, device, runtimes, checkFormat));
+  return list.map((v) => judge(v, device, options.onEngine && device ? runtimesOnEngine(runtimes, v, device) : runtimes, checkFormat));
 }
-function rankVariants(model, want, device, runtimes) {
-  const judged = judgeAll(model, want, device, runtimes);
+function ggufEngine(runtimes, device) {
+  const arch = normalizeArch(device.arch);
+  for (const r of runtimes)
+    for (const b of r.builds)
+      if (b.is_active && normalizeOs(b.os) === normalizeOs(device.os) && normalizeArch(b.arch) === arch && b.compat.some((c) => c.format === "gguf")) return b;
+  return null;
+}
+function runtimesOnEngine(runtimes, variant, device) {
+  const engine = ggufEngine(runtimes, device);
+  if (!engine || variant.format !== "gguf") return [...runtimes];
+  const rows3 = device.classes.map((hardware_class) => ({ hardware_class, format: variant.format, quant: variant.quant, architecture: variant.architecture, chat_template_kind: variant.chat_template_kind, status: "expected" }));
+  return runtimes.map((r) => ({ ...r, builds: r.builds.map((b) => b === engine ? { ...b, compat: [...b.compat, ...rows3] } : b) }));
+}
+function rankVariants(model, want, device, runtimes, options = {}) {
+  const judged = judgeAll(model, want, device, runtimes, options);
   const usable = judged.filter((j) => j.usable).sort((a, b) => byOrder(asCandidate(a), asCandidate(b)));
   const rest = judged.filter((j) => !j.usable);
   return [...usable, ...rest].map((j, i) => ({
@@ -1896,9 +1910,31 @@ function rankVariants(model, want, device, runtimes) {
     reasons: j.reasons,
     recommended: j.usable && i === 0,
     fits: j.candidate?.fits ?? null,
-    build: j.candidate?.build ?? null
+    build: j.candidate?.build ?? null,
+    compat: j.usable ? j.candidate?.compat ?? null : null,
+    engine: j.usable ? engineName(j, runtimes, device) : null
   }));
 }
+function engineName(j, runtimes, device) {
+  if (j.candidate?.compat === "app_runtime") return "Matrx\u2019s own engine";
+  const build = j.candidate?.build ?? (device ? null : runtimes.flatMap((r) => r.builds).find((b) => b.is_active && b.compat.some((c) => c.format === j.variant.format)) ?? null);
+  if (!build) return null;
+  return runtimes.find((r) => r.builds.some((b) => b.id === build.id))?.name ?? null;
+}
+var RUNS_ON = /^Runs on /;
+function variantVerdict(ranked, mode) {
+  const rt = ranked.variant.discovery?.runtime ?? null;
+  if (mode === "catalog") {
+    const runtime = rt ? rt.available ? `Runs on ${rt.name}` : rt.note || `Matrx 2 has no ${rt.name} runtime yet.` : null;
+    return { runs: null, badge: null, runtime, reason: null, lines: ranked.reasons.filter((l) => !RUNS_ON.test(l)) };
+  }
+  const lines = ranked.reasons.filter((l) => !RUNS_ON.test(l));
+  if (!ranked.usable) {
+    return { runs: false, badge: "Will not run", runtime: null, reason: lines[0] ?? "This version does not run on this computer.", lines: lines.slice(1) };
+  }
+  const name = ranked.engine ?? (rt?.available ? rt.name : null);
+  return { runs: true, badge: null, runtime: name ? `Runs on ${name}` : null, reason: null, lines };
+}
 function selectVariant(model, want, device, runtimes) {
   if (!model.variants.length) return { ok: false, code: "no_variant", reason: "This model has no downloadable form yet" };
   const judged = judgeAll(model, want, device, runtimes);
@@ -2288,13 +2324,6 @@ function pickProjector(quant, projectors) {
   }
   return null;
 }
-function ggufEngine(runtimes, device) {
-  const arch = normalizeArch(device.arch);
-  for (const r of runtimes)
-    for (const b of r.builds)
-      if (b.is_active && normalizeOs(b.os) === normalizeOs(device.os) && normalizeArch(b.arch) === arch && b.compat.some((c) => c.format === "gguf")) return b;
-  return null;
-}
 var extOf = (name) => {
   const i = name.lastIndexOf(".");
   return i > 0 ? name.slice(i).toLowerCase() : "";
@@ -2736,22 +2765,18 @@ function cheapestAdequateModel(catalog, need, options = {}) {
 }
 
 // models/default-model.ts
-var AGENT_AUTHORING_DEFAULT_MODEL_KNOB = "agents.model_prefs.agent_authoring_default_model";
-var PENDING_KNOB_ROW_MODEL_ID = "617abdcd-79e2-4a4b-be76-4a9960cdffa1";
-var standInCount = 0;
-var newAgentModelStandInCount = () => standInCount;
+var NEW_AGENT_DEFAULT_MODEL_KNOB = "agents.model_prefs.new_agent_default_model";
 async function resolveNewAgentModelId(resolveKnob) {
-  let why;
+  let value;
   try {
-    const value = await resolveKnob(AGENT_AUTHORING_DEFAULT_MODEL_KNOB);
-    if (typeof value === "string" && value.trim() !== "") return { modelId: value.trim(), standIn: false };
-    why = "has no value (its platform default row is pending)";
+    value = await resolveKnob(NEW_AGENT_DEFAULT_MODEL_KNOB);
   } catch (error) {
-    why = `could not be read (${error instanceof Error ? error.message : String(error)})`;
+    throw new Error(
+      `The model new agents start on (${NEW_AGENT_DEFAULT_MODEL_KNOB}) could not be read, so no agent was created: ${error instanceof Error ? error.message : String(error)}`
+    );
   }
-  standInCount += 1;
-  console.error(
-    `[newAgentModel] STAND-IN: ${AGENT_AUTHORING_DEFAULT_MODEL_KNOB} ${why} \u2014 this new agent starts on ${PENDING_KNOB_ROW_MODEL_ID} (today's model). Set the knob's default to remove this stand-in.`
+  if (typeof value === "string" && value.trim() !== "") return { modelId: value.trim() };
+  throw new Error(
+    `No model is set for new agents (${NEW_AGENT_DEFAULT_MODEL_KNOB} is empty for this organization), so no agent was created. Set it in Settings.`
   );
-  return { modelId: PENDING_KNOB_ROW_MODEL_ID, standIn: true };
 }

package/dist/models/index.d.cts

@@ -1188,12 +1188,28 @@ interface RankedVariant {
     fits: boolean | null;
     /** The runtime build it runs on here (null on the web or for an app-shipped runtime). */
     build: LocalRuntimeBuild | null;
+    /** How it runs here: tested, expected (not yet tested), Matrx's own engine; null when it does not run or on the web. */
+    compat: CompatStatus | "app_runtime" | null;
+    /** The name of the runtime it runs on ("llama.cpp", "Matrx’s own engine"); null when it does not run or is unknown. */
+    engine: string | null;
 }
 /** The parts of a sharded set that are missing ("part 2 of 3"), from the files' own shard numbers. */
 declare function missingShards(variant: LocalVariant): Array<{
     index: number;
     count: number;
 }>;
+/** The active llama-server build for this computer that runs GGUF, or null. */
+declare function ggufEngine(runtimes: readonly LocalRuntime[], device: SelectDevice): LocalRuntimeBuild | null;
+/**
+ * The runtimes a version NO catalog reviewed (the person's own model, a version found on Hugging Face) is
+ * judged against: our GGUF engine on this computer takes its signature as "expected" (not yet tested),
+ * so it is judged on what our runtime runs, never on the reviewed list. Without an engine, unchanged.
+ */
+declare function runtimesOnEngine(runtimes: readonly LocalRuntime[], variant: LocalVariant, device: SelectDevice): LocalRuntime[];
+interface RankOptions {
+    /** Judge every version on our engine for its format (`runtimesOnEngine`): a person's own or found model, never on a reviewed list. */
+    onEngine?: boolean;
+}
 /**
  * THE judge every screen shows (unified-models §1.4a): every variant of `model` with whether it can be
  * used here, its reasons in plain words (format our runtimes run, a complete file set, os/arch, and
@@ -1201,7 +1217,23 @@ declare function missingShards(variant: LocalVariant): Array<{
  * memory line says what it needs instead of yes/no. Ordered: the recommended first, then the other
  * usable ones in the selection order, then the rest. `selectVariant` is this judge's winner.
  */
-declare function rankVariants(model: LocalModel, want: Want, device: SelectDevice | null, runtimes: readonly LocalRuntime[]): RankedVariant[];
+declare function rankVariants(model: LocalModel, want: Want, device: SelectDevice | null, runtimes: readonly LocalRuntime[], options?: RankOptions): RankedVariant[];
+/**
+ * ONE verdict for a version on a screen (Find models, the Discovery page): every line a version row
+ * draws comes from this, so a row can never say "Will not run" beside "Runs on llama.cpp". `runs` false:
+ * `reason` is the first plain line (memory with both numbers, or the format) and there is NO runtime line.
+ * `runs` true: `runtime` names what it runs on ("Runs on llama.cpp") when known. `lines` are the rest.
+ * Catalog mode (admin) never gates: `runs` is null and the runtime line is the server's per-runtime word.
+ */
+interface VariantVerdict {
+    runs: boolean | null;
+    /** "Will not run" when it does not run here; null otherwise. */
+    badge: string | null;
+    runtime: string | null;
+    reason: string | null;
+    lines: string[];
+}
+declare function variantVerdict(ranked: RankedVariant, mode: "device" | "catalog"): VariantVerdict;
 /**
  * Choose the variant of `model` this device downloads and runs, and exactly the files to fetch — the
  * recommended entry of `rankVariants`. The choice is returned with `decided_by` (the order step that
@@ -1452,8 +1484,6 @@ declare const quantFromName: (name: string) => string | null;
 declare function splitSetProblems(names: readonly string[]): string[];
 /** huggingface.py pick_projector over names: the projector a variant of `quant` takes, or null. */
 declare function pickProjector(quant: string | null, projectors: readonly string[]): string | null;
-/** The active llama-server build for this computer that runs GGUF, or null. */
-declare function ggufEngine(runtimes: readonly LocalRuntime[], device: SelectDevice): LocalRuntime["builds"][number] | null;
 /**
  * Judge `primary` (the file the person chose) with the files beside it (`siblings`: the rest of its
  * folder or download; split parts and projectors are taken from here, anything else is ignored).
@@ -1740,28 +1770,20 @@ declare function cheapestAdequateModel<T extends PricedCatalogModel>(catalog: re
 
 /**
  * `@ai-matrx/agents/models` — THE model a new agent starts on comes from a knob, never a constant:
- * `agents.model_prefs.agent_authoring_default_model` (organization → person → device ladder, through the
- * host's knob port). Every "make me an agent" path (blank agent, quick agent, templates, the web's manual
- * create and system-agent create) asks `resolveNewAgentModelId`.
+ * `agents.model_prefs.new_agent_default_model` (organization → person → device ladder, through the host's knob
+ * port; platform default Claude Sonnet 5.5, migration 1512). Every "make me an agent" path (blank agent, quick
+ * agent, templates, the web's manual create, system-agent create and builder form) asks `resolveNewAgentModelId`.
+ *
+ * It is NOT `agent_authoring_default_model`: that knob is the agent FACTORY's own model.
  *
- * KNOB ROW PENDING (2026-10-21): the register row exists with `default_value = null`. Until its default is
- * set to today's model (the SQL is with the owner), an unset knob answers the stand-in below — LOUDLY, every
- * time, naming the knob — so creating an agent keeps working exactly as before. When the row lands the stand-in
- * never fires; delete it then. This file is the ONE place a model id literal may appear in shared runtime code
- * (guard: apps/shared/scripts/check-no-model-literals.mjs).
+ * No code fallback: an unset or unreadable knob refuses, naming the knob, so nothing is created on a model nobody
+ * chose (the knob's platform default makes "unset" an admin act, not a normal state).
  */
-declare const AGENT_AUTHORING_DEFAULT_MODEL_KNOB = "agents.model_prefs.agent_authoring_default_model";
+declare const NEW_AGENT_DEFAULT_MODEL_KNOB = "agents.model_prefs.new_agent_default_model";
 interface NewAgentModel {
     modelId: string;
-    /** True when the knob held no value and the pending-row stand-in answered (it screamed). */
-    standIn: boolean;
 }
-/** How many times the stand-in answered in this process (tests, diagnostics). */
-declare const newAgentModelStandInCount: () => number;
-/**
- * The model a new agent starts on. `resolveKnob(fullKey)` is the host's effective-knob read. A knob value
- * that is a non-empty string wins; an unset knob, or a knob read that fails, answers the stand-in and says so.
- */
+/** The model a new agent starts on. `resolveKnob(fullKey)` is the host's effective-knob read. Throws, naming the knob, when it answers nothing. */
 declare function resolveNewAgentModelId(resolveKnob: (fullKey: string) => Promise<unknown>): Promise<NewAgentModel>;
 
-export { AGENT_AUTHORING_DEFAULT_MODEL_KNOB, type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogKindInput, type CatalogModel, type CatalogTier, type CheapestAdequateOptions, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedRows, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, EXCLUDED_REVIEW_STATES, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, type FitCapabilities, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCatalogClient, type LocalCatalogQuery, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_CATALOG_KINDS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelNeed, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, type NewAgentModel, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type PricedCatalogModel, type RankedVariant, type ReadModelCatalogOptions, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type Want, acceptsTextInstructions, blendedPrice, buildModelClassIndex, buildSuccessionIndex, catalogFingerprint, catalogForApp, catalogKindOf, cheapestAdequateModel, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsNeed, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isChatModelCapability, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isListedVariant, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, newAgentModelStandInCount, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readCuratedRows, readGgufHeader, readModelCatalog, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolveNewAgentModelId, resolvePreferredModelChoice, resolveSuccessor, seesImages, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, takesInput, toAuditRecord, validateModelSet, withModelClass };
+export { type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogKindInput, type CatalogModel, type CatalogTier, type CheapestAdequateOptions, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedRows, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, EXCLUDED_REVIEW_STATES, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, type FitCapabilities, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCatalogClient, type LocalCatalogQuery, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_CATALOG_KINDS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelNeed, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, NEW_AGENT_DEFAULT_MODEL_KNOB, type NewAgentModel, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type PricedCatalogModel, type RankOptions, type RankedVariant, type ReadModelCatalogOptions, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type VariantVerdict, type Want, acceptsTextInstructions, blendedPrice, buildModelClassIndex, buildSuccessionIndex, catalogFingerprint, catalogForApp, catalogKindOf, cheapestAdequateModel, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsNeed, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isChatModelCapability, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isListedVariant, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readCuratedRows, readGgufHeader, readModelCatalog, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolveNewAgentModelId, resolvePreferredModelChoice, resolveSuccessor, runtimesOnEngine, seesImages, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, takesInput, toAuditRecord, validateModelSet, variantVerdict, withModelClass };

package/dist/models/index.d.ts

@@ -1188,12 +1188,28 @@ interface RankedVariant {
     fits: boolean | null;
     /** The runtime build it runs on here (null on the web or for an app-shipped runtime). */
     build: LocalRuntimeBuild | null;
+    /** How it runs here: tested, expected (not yet tested), Matrx's own engine; null when it does not run or on the web. */
+    compat: CompatStatus | "app_runtime" | null;
+    /** The name of the runtime it runs on ("llama.cpp", "Matrx’s own engine"); null when it does not run or is unknown. */
+    engine: string | null;
 }
 /** The parts of a sharded set that are missing ("part 2 of 3"), from the files' own shard numbers. */
 declare function missingShards(variant: LocalVariant): Array<{
     index: number;
     count: number;
 }>;
+/** The active llama-server build for this computer that runs GGUF, or null. */
+declare function ggufEngine(runtimes: readonly LocalRuntime[], device: SelectDevice): LocalRuntimeBuild | null;
+/**
+ * The runtimes a version NO catalog reviewed (the person's own model, a version found on Hugging Face) is
+ * judged against: our GGUF engine on this computer takes its signature as "expected" (not yet tested),
+ * so it is judged on what our runtime runs, never on the reviewed list. Without an engine, unchanged.
+ */
+declare function runtimesOnEngine(runtimes: readonly LocalRuntime[], variant: LocalVariant, device: SelectDevice): LocalRuntime[];
+interface RankOptions {
+    /** Judge every version on our engine for its format (`runtimesOnEngine`): a person's own or found model, never on a reviewed list. */
+    onEngine?: boolean;
+}
 /**
  * THE judge every screen shows (unified-models §1.4a): every variant of `model` with whether it can be
  * used here, its reasons in plain words (format our runtimes run, a complete file set, os/arch, and
@@ -1201,7 +1217,23 @@ declare function missingShards(variant: LocalVariant): Array<{
  * memory line says what it needs instead of yes/no. Ordered: the recommended first, then the other
  * usable ones in the selection order, then the rest. `selectVariant` is this judge's winner.
  */
-declare function rankVariants(model: LocalModel, want: Want, device: SelectDevice | null, runtimes: readonly LocalRuntime[]): RankedVariant[];
+declare function rankVariants(model: LocalModel, want: Want, device: SelectDevice | null, runtimes: readonly LocalRuntime[], options?: RankOptions): RankedVariant[];
+/**
+ * ONE verdict for a version on a screen (Find models, the Discovery page): every line a version row
+ * draws comes from this, so a row can never say "Will not run" beside "Runs on llama.cpp". `runs` false:
+ * `reason` is the first plain line (memory with both numbers, or the format) and there is NO runtime line.
+ * `runs` true: `runtime` names what it runs on ("Runs on llama.cpp") when known. `lines` are the rest.
+ * Catalog mode (admin) never gates: `runs` is null and the runtime line is the server's per-runtime word.
+ */
+interface VariantVerdict {
+    runs: boolean | null;
+    /** "Will not run" when it does not run here; null otherwise. */
+    badge: string | null;
+    runtime: string | null;
+    reason: string | null;
+    lines: string[];
+}
+declare function variantVerdict(ranked: RankedVariant, mode: "device" | "catalog"): VariantVerdict;
 /**
  * Choose the variant of `model` this device downloads and runs, and exactly the files to fetch — the
  * recommended entry of `rankVariants`. The choice is returned with `decided_by` (the order step that
@@ -1452,8 +1484,6 @@ declare const quantFromName: (name: string) => string | null;
 declare function splitSetProblems(names: readonly string[]): string[];
 /** huggingface.py pick_projector over names: the projector a variant of `quant` takes, or null. */
 declare function pickProjector(quant: string | null, projectors: readonly string[]): string | null;
-/** The active llama-server build for this computer that runs GGUF, or null. */
-declare function ggufEngine(runtimes: readonly LocalRuntime[], device: SelectDevice): LocalRuntime["builds"][number] | null;
 /**
  * Judge `primary` (the file the person chose) with the files beside it (`siblings`: the rest of its
  * folder or download; split parts and projectors are taken from here, anything else is ignored).
@@ -1740,28 +1770,20 @@ declare function cheapestAdequateModel<T extends PricedCatalogModel>(catalog: re
 
 /**
  * `@ai-matrx/agents/models` — THE model a new agent starts on comes from a knob, never a constant:
- * `agents.model_prefs.agent_authoring_default_model` (organization → person → device ladder, through the
- * host's knob port). Every "make me an agent" path (blank agent, quick agent, templates, the web's manual
- * create and system-agent create) asks `resolveNewAgentModelId`.
+ * `agents.model_prefs.new_agent_default_model` (organization → person → device ladder, through the host's knob
+ * port; platform default Claude Sonnet 5.5, migration 1512). Every "make me an agent" path (blank agent, quick
+ * agent, templates, the web's manual create, system-agent create and builder form) asks `resolveNewAgentModelId`.
+ *
+ * It is NOT `agent_authoring_default_model`: that knob is the agent FACTORY's own model.
  *
- * KNOB ROW PENDING (2026-10-21): the register row exists with `default_value = null`. Until its default is
- * set to today's model (the SQL is with the owner), an unset knob answers the stand-in below — LOUDLY, every
- * time, naming the knob — so creating an agent keeps working exactly as before. When the row lands the stand-in
- * never fires; delete it then. This file is the ONE place a model id literal may appear in shared runtime code
- * (guard: apps/shared/scripts/check-no-model-literals.mjs).
+ * No code fallback: an unset or unreadable knob refuses, naming the knob, so nothing is created on a model nobody
+ * chose (the knob's platform default makes "unset" an admin act, not a normal state).
  */
-declare const AGENT_AUTHORING_DEFAULT_MODEL_KNOB = "agents.model_prefs.agent_authoring_default_model";
+declare const NEW_AGENT_DEFAULT_MODEL_KNOB = "agents.model_prefs.new_agent_default_model";
 interface NewAgentModel {
     modelId: string;
-    /** True when the knob held no value and the pending-row stand-in answered (it screamed). */
-    standIn: boolean;
 }
-/** How many times the stand-in answered in this process (tests, diagnostics). */
-declare const newAgentModelStandInCount: () => number;
-/**
- * The model a new agent starts on. `resolveKnob(fullKey)` is the host's effective-knob read. A knob value
- * that is a non-empty string wins; an unset knob, or a knob read that fails, answers the stand-in and says so.
- */
+/** The model a new agent starts on. `resolveKnob(fullKey)` is the host's effective-knob read. Throws, naming the knob, when it answers nothing. */
 declare function resolveNewAgentModelId(resolveKnob: (fullKey: string) => Promise<unknown>): Promise<NewAgentModel>;
 
-export { AGENT_AUTHORING_DEFAULT_MODEL_KNOB, type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogKindInput, type CatalogModel, type CatalogTier, type CheapestAdequateOptions, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedRows, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, EXCLUDED_REVIEW_STATES, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, type FitCapabilities, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCatalogClient, type LocalCatalogQuery, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_CATALOG_KINDS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelNeed, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, type NewAgentModel, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type PricedCatalogModel, type RankedVariant, type ReadModelCatalogOptions, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type Want, acceptsTextInstructions, blendedPrice, buildModelClassIndex, buildSuccessionIndex, catalogFingerprint, catalogForApp, catalogKindOf, cheapestAdequateModel, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsNeed, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isChatModelCapability, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isListedVariant, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, newAgentModelStandInCount, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readCuratedRows, readGgufHeader, readModelCatalog, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolveNewAgentModelId, resolvePreferredModelChoice, resolveSuccessor, seesImages, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, takesInput, toAuditRecord, validateModelSet, withModelClass };
+export { type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogKindInput, type CatalogModel, type CatalogTier, type CheapestAdequateOptions, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedRows, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, EXCLUDED_REVIEW_STATES, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, type FitCapabilities, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCatalogClient, type LocalCatalogQuery, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_CATALOG_KINDS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelNeed, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, NEW_AGENT_DEFAULT_MODEL_KNOB, type NewAgentModel, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type PricedCatalogModel, type RankOptions, type RankedVariant, type ReadModelCatalogOptions, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type VariantVerdict, type Want, acceptsTextInstructions, blendedPrice, buildModelClassIndex, buildSuccessionIndex, catalogFingerprint, catalogForApp, catalogKindOf, cheapestAdequateModel, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsNeed, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isChatModelCapability, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isListedVariant, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readCuratedRows, readGgufHeader, readModelCatalog, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolveNewAgentModelId, resolvePreferredModelChoice, resolveSuccessor, runtimesOnEngine, seesImages, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, takesInput, toAuditRecord, validateModelSet, variantVerdict, withModelClass };

package/dist/models/index.js

@@ -1725,13 +1725,26 @@ function byOrder(a, b) {
 function asCandidate(j) {
   return j.candidate ?? { variant: j.variant, build: null, hardware_class: null, compat: "expected", fits: null };
 }
-function judgeAll(model, want, device, runtimes) {
+function judgeAll(model, want, device, runtimes, options = {}) {
   const checkFormat = runtimes.length > 0 || device !== null;
   const list = want.variant_policy === "exact" ? model.variants.filter((x) => x.key === want.variant_key) : model.variants;
-  return list.map((v) => judge(v, device, runtimes, checkFormat));
+  return list.map((v) => judge(v, device, options.onEngine && device ? runtimesOnEngine(runtimes, v, device) : runtimes, checkFormat));
 }
-function rankVariants(model, want, device, runtimes) {
-  const judged = judgeAll(model, want, device, runtimes);
+function ggufEngine(runtimes, device) {
+  const arch = normalizeArch(device.arch);
+  for (const r of runtimes)
+    for (const b of r.builds)
+      if (b.is_active && normalizeOs(b.os) === normalizeOs(device.os) && normalizeArch(b.arch) === arch && b.compat.some((c) => c.format === "gguf")) return b;
+  return null;
+}
+function runtimesOnEngine(runtimes, variant, device) {
+  const engine = ggufEngine(runtimes, device);
+  if (!engine || variant.format !== "gguf") return [...runtimes];
+  const rows3 = device.classes.map((hardware_class) => ({ hardware_class, format: variant.format, quant: variant.quant, architecture: variant.architecture, chat_template_kind: variant.chat_template_kind, status: "expected" }));
+  return runtimes.map((r) => ({ ...r, builds: r.builds.map((b) => b === engine ? { ...b, compat: [...b.compat, ...rows3] } : b) }));
+}
+function rankVariants(model, want, device, runtimes, options = {}) {
+  const judged = judgeAll(model, want, device, runtimes, options);
   const usable = judged.filter((j) => j.usable).sort((a, b) => byOrder(asCandidate(a), asCandidate(b)));
   const rest = judged.filter((j) => !j.usable);
   return [...usable, ...rest].map((j, i) => ({
@@ -1740,9 +1753,31 @@ function rankVariants(model, want, device, runtimes) {
     reasons: j.reasons,
     recommended: j.usable && i === 0,
     fits: j.candidate?.fits ?? null,
-    build: j.candidate?.build ?? null
+    build: j.candidate?.build ?? null,
+    compat: j.usable ? j.candidate?.compat ?? null : null,
+    engine: j.usable ? engineName(j, runtimes, device) : null
   }));
 }
+function engineName(j, runtimes, device) {
+  if (j.candidate?.compat === "app_runtime") return "Matrx\u2019s own engine";
+  const build = j.candidate?.build ?? (device ? null : runtimes.flatMap((r) => r.builds).find((b) => b.is_active && b.compat.some((c) => c.format === j.variant.format)) ?? null);
+  if (!build) return null;
+  return runtimes.find((r) => r.builds.some((b) => b.id === build.id))?.name ?? null;
+}
+var RUNS_ON = /^Runs on /;
+function variantVerdict(ranked, mode) {
+  const rt = ranked.variant.discovery?.runtime ?? null;
+  if (mode === "catalog") {
+    const runtime = rt ? rt.available ? `Runs on ${rt.name}` : rt.note || `Matrx 2 has no ${rt.name} runtime yet.` : null;
+    return { runs: null, badge: null, runtime, reason: null, lines: ranked.reasons.filter((l) => !RUNS_ON.test(l)) };
+  }
+  const lines = ranked.reasons.filter((l) => !RUNS_ON.test(l));
+  if (!ranked.usable) {
+    return { runs: false, badge: "Will not run", runtime: null, reason: lines[0] ?? "This version does not run on this computer.", lines: lines.slice(1) };
+  }
+  const name = ranked.engine ?? (rt?.available ? rt.name : null);
+  return { runs: true, badge: null, runtime: name ? `Runs on ${name}` : null, reason: null, lines };
+}
 function selectVariant(model, want, device, runtimes) {
   if (!model.variants.length) return { ok: false, code: "no_variant", reason: "This model has no downloadable form yet" };
   const judged = judgeAll(model, want, device, runtimes);
@@ -2132,13 +2167,6 @@ function pickProjector(quant, projectors) {
   }
   return null;
 }
-function ggufEngine(runtimes, device) {
-  const arch = normalizeArch(device.arch);
-  for (const r of runtimes)
-    for (const b of r.builds)
-      if (b.is_active && normalizeOs(b.os) === normalizeOs(device.os) && normalizeArch(b.arch) === arch && b.compat.some((c) => c.format === "gguf")) return b;
-  return null;
-}
 var extOf = (name) => {
   const i = name.lastIndexOf(".");
   return i > 0 ? name.slice(i).toLowerCase() : "";
@@ -2580,27 +2608,22 @@ function cheapestAdequateModel(catalog, need, options = {}) {
 }
 
 // models/default-model.ts
-var AGENT_AUTHORING_DEFAULT_MODEL_KNOB = "agents.model_prefs.agent_authoring_default_model";
-var PENDING_KNOB_ROW_MODEL_ID = "617abdcd-79e2-4a4b-be76-4a9960cdffa1";
-var standInCount = 0;
-var newAgentModelStandInCount = () => standInCount;
+var NEW_AGENT_DEFAULT_MODEL_KNOB = "agents.model_prefs.new_agent_default_model";
 async function resolveNewAgentModelId(resolveKnob) {
-  let why;
+  let value;
   try {
-    const value = await resolveKnob(AGENT_AUTHORING_DEFAULT_MODEL_KNOB);
-    if (typeof value === "string" && value.trim() !== "") return { modelId: value.trim(), standIn: false };
-    why = "has no value (its platform default row is pending)";
+    value = await resolveKnob(NEW_AGENT_DEFAULT_MODEL_KNOB);
   } catch (error) {
-    why = `could not be read (${error instanceof Error ? error.message : String(error)})`;
+    throw new Error(
+      `The model new agents start on (${NEW_AGENT_DEFAULT_MODEL_KNOB}) could not be read, so no agent was created: ${error instanceof Error ? error.message : String(error)}`
+    );
   }
-  standInCount += 1;
-  console.error(
-    `[newAgentModel] STAND-IN: ${AGENT_AUTHORING_DEFAULT_MODEL_KNOB} ${why} \u2014 this new agent starts on ${PENDING_KNOB_ROW_MODEL_ID} (today's model). Set the knob's default to remove this stand-in.`
+  if (typeof value === "string" && value.trim() !== "") return { modelId: value.trim() };
+  throw new Error(
+    `No model is set for new agents (${NEW_AGENT_DEFAULT_MODEL_KNOB} is empty for this organization), so no agent was created. Set it in Settings.`
   );
-  return { modelId: PENDING_KNOB_ROW_MODEL_ID, standIn: true };
 }
 export {
-  AGENT_AUTHORING_DEFAULT_MODEL_KNOB,
   CHAT_DEFAULT_MODEL_KNOB,
   CONTENT_TYPES,
   DEFAULT_CAPABILITIES,
@@ -2616,6 +2639,7 @@ export {
   MAX_SUCCESSION_HOPS,
   MODEL_CATALOG_KINDS,
   MODEL_FAVORITE_ENTITY_TYPE,
+  NEW_AGENT_DEFAULT_MODEL_KNOB,
   OUTPUT_MODALITIES,
   SERVICE_LABEL,
   SERVICE_LABEL_PLURAL,
@@ -2671,7 +2695,6 @@ export {
   modelClassName,
   modelClassPinOf,
   modelsForSelectionPurpose,
-  newAgentModelStandInCount,
   normalizeArch,
   normalizeModel,
   normalizeModels,
@@ -2697,6 +2720,7 @@ export {
   resolveNewAgentModelId,
   resolvePreferredModelChoice,
   resolveSuccessor,
+  runtimesOnEngine,
   seesImages,
   selectActiveModels,
   selectActiveModelsReady,
@@ -2730,5 +2754,6 @@ export {
   takesInput,
   toAuditRecord,
   validateModelSet,
+  variantVerdict,
   withModelClass
 };

package/dist/models/react/index.cjs

@@ -2378,13 +2378,26 @@ function byOrder(a, b) {
 function asCandidate(j) {
   return j.candidate ?? { variant: j.variant, build: null, hardware_class: null, compat: "expected", fits: null };
 }
-function judgeAll(model, want, device, runtimes) {
+function judgeAll(model, want, device, runtimes, options = {}) {
   const checkFormat = runtimes.length > 0 || device !== null;
   const list = want.variant_policy === "exact" ? model.variants.filter((x) => x.key === want.variant_key) : model.variants;
-  return list.map((v) => judge(v, device, runtimes, checkFormat));
+  return list.map((v) => judge(v, device, options.onEngine && device ? runtimesOnEngine(runtimes, v, device) : runtimes, checkFormat));
 }
-function rankVariants(model, want, device, runtimes) {
-  const judged = judgeAll(model, want, device, runtimes);
+function ggufEngine(runtimes, device) {
+  const arch = normalizeArch(device.arch);
+  for (const r of runtimes)
+    for (const b of r.builds)
+      if (b.is_active && normalizeOs(b.os) === normalizeOs(device.os) && normalizeArch(b.arch) === arch && b.compat.some((c) => c.format === "gguf")) return b;
+  return null;
+}
+function runtimesOnEngine(runtimes, variant, device) {
+  const engine = ggufEngine(runtimes, device);
+  if (!engine || variant.format !== "gguf") return [...runtimes];
+  const rows = device.classes.map((hardware_class) => ({ hardware_class, format: variant.format, quant: variant.quant, architecture: variant.architecture, chat_template_kind: variant.chat_template_kind, status: "expected" }));
+  return runtimes.map((r) => ({ ...r, builds: r.builds.map((b) => b === engine ? { ...b, compat: [...b.compat, ...rows] } : b) }));
+}
+function rankVariants(model, want, device, runtimes, options = {}) {
+  const judged = judgeAll(model, want, device, runtimes, options);
   const usable = judged.filter((j) => j.usable).sort((a, b) => byOrder(asCandidate(a), asCandidate(b)));
   const rest = judged.filter((j) => !j.usable);
   return [...usable, ...rest].map((j, i) => ({
@@ -2393,9 +2406,31 @@ function rankVariants(model, want, device, runtimes) {
     reasons: j.reasons,
     recommended: j.usable && i === 0,
     fits: j.candidate?.fits ?? null,
-    build: j.candidate?.build ?? null
+    build: j.candidate?.build ?? null,
+    compat: j.usable ? j.candidate?.compat ?? null : null,
+    engine: j.usable ? engineName(j, runtimes, device) : null
   }));
 }
+function engineName(j, runtimes, device) {
+  if (j.candidate?.compat === "app_runtime") return "Matrx\u2019s own engine";
+  const build = j.candidate?.build ?? (device ? null : runtimes.flatMap((r) => r.builds).find((b) => b.is_active && b.compat.some((c) => c.format === j.variant.format)) ?? null);
+  if (!build) return null;
+  return runtimes.find((r) => r.builds.some((b) => b.id === build.id))?.name ?? null;
+}
+var RUNS_ON = /^Runs on /;
+function variantVerdict(ranked, mode) {
+  const rt = ranked.variant.discovery?.runtime ?? null;
+  if (mode === "catalog") {
+    const runtime = rt ? rt.available ? `Runs on ${rt.name}` : rt.note || `Matrx 2 has no ${rt.name} runtime yet.` : null;
+    return { runs: null, badge: null, runtime, reason: null, lines: ranked.reasons.filter((l) => !RUNS_ON.test(l)) };
+  }
+  const lines = ranked.reasons.filter((l) => !RUNS_ON.test(l));
+  if (!ranked.usable) {
+    return { runs: false, badge: "Will not run", runtime: null, reason: lines[0] ?? "This version does not run on this computer.", lines: lines.slice(1) };
+  }
+  const name = ranked.engine ?? (rt?.available ? rt.name : null);
+  return { runs: true, badge: null, runtime: name ? `Runs on ${name}` : null, reason: null, lines };
+}
 var USES = ["core", "vision", "audio_in", "voices"];
 function fromDiscovery(result) {
   const ambiguities = result.ambiguities ?? [];
@@ -2652,7 +2687,7 @@ function SearchTab({ port, onPick }) {
 }
 function DiscoveryResultView({ result, device, runtimes, want = DEFAULT_WANT, chooseLabel = "Choose", mode = "device", onChoose, renderVariantActions, renderActions }) {
   const model = (0, import_react4.useMemo)(() => fromDiscovery(result), [result]);
-  const ranked = (0, import_react4.useMemo)(() => rankVariants(model, want, device, runtimes), [model, want, device, runtimes]);
+  const ranked = (0, import_react4.useMemo)(() => rankVariants(model, want, device, runtimes, { onEngine: mode === "device" }), [model, want, device, runtimes, mode]);
   const [choosing, setChoosing] = (0, import_react4.useState)(null);
   const [done, setDone] = (0, import_react4.useState)(null);
   const logo = (result.media ?? []).find((m) => m.kind === "maker_logo");
@@ -2703,27 +2738,26 @@ function DiscoveryResultView({ result, device, runtimes, want = DEFAULT_WANT, ch
 }
 function VariantRow({ ranked, mode, chooseLabel, busy, choosingThis, onChoose, extra }) {
   const v = ranked.variant;
-  const runtime = v.discovery?.runtime ?? null;
   const catalog = mode === "catalog";
-  const blocked = !catalog && !ranked.usable;
-  const why = blocked ? ranked.reasons[0] ?? "This version does not run on this computer." : null;
+  const verdict = variantVerdict(ranked, mode);
+  const blocked = !catalog && verdict.runs === false;
   const label = v.quant || v.key;
   const publisher = v.discovery?.publisher ?? null;
   const size = sizeOf(v.total_bytes);
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("li", { className: "flex flex-col gap-2 rounded-md border border-border p-3", "data-testid": "discovery-variant", "data-recommended": ranked.recommended ? "true" : void 0, children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("li", { className: "flex flex-col gap-2 rounded-md border border-border p-3", "data-testid": "discovery-variant", "data-runs": verdict.runs === null ? void 0 : String(verdict.runs), "data-recommended": ranked.recommended ? "true" : void 0, children: [
     /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "flex flex-wrap items-center gap-2", children: [
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "text-sm font-medium text-foreground", children: label }),
       ranked.recommended ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_controls2.Badge, { tone: "primary", children: "Recommended" }) : null,
-      ranked.usable || catalog ? null : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_controls2.Badge, { tone: "warning", children: "Will not run" }),
+      verdict.badge ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_controls2.Badge, { tone: "warning", children: verdict.badge }) : null,
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "text-xs text-muted-foreground", children: [v.format.toUpperCase(), size, publisher ? `by ${publisher}` : null].filter(Boolean).join(" \xB7 ") }),
       /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("span", { className: "ml-auto flex items-center gap-2", children: [
         extra,
-        why ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "text-xs text-muted-foreground", "data-testid": "choose-reason", children: why }) : null,
+        verdict.reason ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "text-xs text-muted-foreground", "data-testid": "choose-reason", children: verdict.reason }) : null,
         /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_controls2.Button, { variant: ranked.recommended ? "primary" : "outline", disabled: busy || blocked, onClick: onChoose, children: choosingThis ? "Working\u2026" : chooseLabel })
       ] })
     ] }),
-    runtime ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { className: runtime.available ? "text-xs text-muted-foreground" : "text-xs text-foreground", "data-testid": "variant-runtime", children: runtime.available ? `Runs on ${runtime.name}` : runtime.note || `Matrx 2 has no ${runtime.name} runtime yet.` }) : null,
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("ul", { className: "flex flex-col gap-0.5", children: ranked.reasons.map((line) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("li", { className: "text-xs text-muted-foreground", children: line }, line)) }),
+    verdict.runtime ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { className: "text-xs text-muted-foreground", "data-testid": "variant-runtime", children: verdict.runtime }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("ul", { className: "flex flex-col gap-0.5", children: verdict.lines.map((line) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("li", { className: "text-xs text-muted-foreground", children: line }, line)) }),
     v.artifacts.length ? /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_design_system2.Collapsible, { children: [
       /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_design_system2.CollapsibleTrigger, { className: "text-xs text-muted-foreground hover:text-foreground", children: [
         "Files in this version (",

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

@@ -770,6 +770,10 @@ interface RankedVariant {
     fits: boolean | null;
     /** The runtime build it runs on here (null on the web or for an app-shipped runtime). */
     build: LocalRuntimeBuild | null;
+    /** How it runs here: tested, expected (not yet tested), Matrx's own engine; null when it does not run or on the web. */
+    compat: CompatStatus | "app_runtime" | null;
+    /** The name of the runtime it runs on ("llama.cpp", "Matrx’s own engine"); null when it does not run or is unknown. */
+    engine: string | null;
 }
 /** One file of a discovered variant. Newer servers send `path`/`size`; older ones `path_in_repo`/`size_bytes`. */
 interface DiscoveryArtifact {

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

@@ -770,6 +770,10 @@ interface RankedVariant {
     fits: boolean | null;
     /** The runtime build it runs on here (null on the web or for an app-shipped runtime). */
     build: LocalRuntimeBuild | null;
+    /** How it runs here: tested, expected (not yet tested), Matrx's own engine; null when it does not run or on the web. */
+    compat: CompatStatus | "app_runtime" | null;
+    /** The name of the runtime it runs on ("llama.cpp", "Matrx’s own engine"); null when it does not run or is unknown. */
+    engine: string | null;
 }
 /** One file of a discovered variant. Newer servers send `path`/`size`; older ones `path_in_repo`/`size_bytes`. */
 interface DiscoveryArtifact {

package/dist/models/react/index.js

@@ -2360,13 +2360,26 @@ function byOrder(a, b) {
 function asCandidate(j) {
   return j.candidate ?? { variant: j.variant, build: null, hardware_class: null, compat: "expected", fits: null };
 }
-function judgeAll(model, want, device, runtimes) {
+function judgeAll(model, want, device, runtimes, options = {}) {
   const checkFormat = runtimes.length > 0 || device !== null;
   const list = want.variant_policy === "exact" ? model.variants.filter((x) => x.key === want.variant_key) : model.variants;
-  return list.map((v) => judge(v, device, runtimes, checkFormat));
+  return list.map((v) => judge(v, device, options.onEngine && device ? runtimesOnEngine(runtimes, v, device) : runtimes, checkFormat));
 }
-function rankVariants(model, want, device, runtimes) {
-  const judged = judgeAll(model, want, device, runtimes);
+function ggufEngine(runtimes, device) {
+  const arch = normalizeArch(device.arch);
+  for (const r of runtimes)
+    for (const b of r.builds)
+      if (b.is_active && normalizeOs(b.os) === normalizeOs(device.os) && normalizeArch(b.arch) === arch && b.compat.some((c) => c.format === "gguf")) return b;
+  return null;
+}
+function runtimesOnEngine(runtimes, variant, device) {
+  const engine = ggufEngine(runtimes, device);
+  if (!engine || variant.format !== "gguf") return [...runtimes];
+  const rows = device.classes.map((hardware_class) => ({ hardware_class, format: variant.format, quant: variant.quant, architecture: variant.architecture, chat_template_kind: variant.chat_template_kind, status: "expected" }));
+  return runtimes.map((r) => ({ ...r, builds: r.builds.map((b) => b === engine ? { ...b, compat: [...b.compat, ...rows] } : b) }));
+}
+function rankVariants(model, want, device, runtimes, options = {}) {
+  const judged = judgeAll(model, want, device, runtimes, options);
   const usable = judged.filter((j) => j.usable).sort((a, b) => byOrder(asCandidate(a), asCandidate(b)));
   const rest = judged.filter((j) => !j.usable);
   return [...usable, ...rest].map((j, i) => ({
@@ -2375,9 +2388,31 @@ function rankVariants(model, want, device, runtimes) {
     reasons: j.reasons,
     recommended: j.usable && i === 0,
     fits: j.candidate?.fits ?? null,
-    build: j.candidate?.build ?? null
+    build: j.candidate?.build ?? null,
+    compat: j.usable ? j.candidate?.compat ?? null : null,
+    engine: j.usable ? engineName(j, runtimes, device) : null
   }));
 }
+function engineName(j, runtimes, device) {
+  if (j.candidate?.compat === "app_runtime") return "Matrx\u2019s own engine";
+  const build = j.candidate?.build ?? (device ? null : runtimes.flatMap((r) => r.builds).find((b) => b.is_active && b.compat.some((c) => c.format === j.variant.format)) ?? null);
+  if (!build) return null;
+  return runtimes.find((r) => r.builds.some((b) => b.id === build.id))?.name ?? null;
+}
+var RUNS_ON = /^Runs on /;
+function variantVerdict(ranked, mode) {
+  const rt = ranked.variant.discovery?.runtime ?? null;
+  if (mode === "catalog") {
+    const runtime = rt ? rt.available ? `Runs on ${rt.name}` : rt.note || `Matrx 2 has no ${rt.name} runtime yet.` : null;
+    return { runs: null, badge: null, runtime, reason: null, lines: ranked.reasons.filter((l) => !RUNS_ON.test(l)) };
+  }
+  const lines = ranked.reasons.filter((l) => !RUNS_ON.test(l));
+  if (!ranked.usable) {
+    return { runs: false, badge: "Will not run", runtime: null, reason: lines[0] ?? "This version does not run on this computer.", lines: lines.slice(1) };
+  }
+  const name = ranked.engine ?? (rt?.available ? rt.name : null);
+  return { runs: true, badge: null, runtime: name ? `Runs on ${name}` : null, reason: null, lines };
+}
 var USES = ["core", "vision", "audio_in", "voices"];
 function fromDiscovery(result) {
   const ambiguities = result.ambiguities ?? [];
@@ -2634,7 +2669,7 @@ function SearchTab({ port, onPick }) {
 }
 function DiscoveryResultView({ result, device, runtimes, want = DEFAULT_WANT, chooseLabel = "Choose", mode = "device", onChoose, renderVariantActions, renderActions }) {
   const model = useMemo3(() => fromDiscovery(result), [result]);
-  const ranked = useMemo3(() => rankVariants(model, want, device, runtimes), [model, want, device, runtimes]);
+  const ranked = useMemo3(() => rankVariants(model, want, device, runtimes, { onEngine: mode === "device" }), [model, want, device, runtimes, mode]);
   const [choosing, setChoosing] = useState2(null);
   const [done, setDone] = useState2(null);
   const logo = (result.media ?? []).find((m) => m.kind === "maker_logo");
@@ -2685,27 +2720,26 @@ function DiscoveryResultView({ result, device, runtimes, want = DEFAULT_WANT, ch
 }
 function VariantRow({ ranked, mode, chooseLabel, busy, choosingThis, onChoose, extra }) {
   const v = ranked.variant;
-  const runtime = v.discovery?.runtime ?? null;
   const catalog = mode === "catalog";
-  const blocked = !catalog && !ranked.usable;
-  const why = blocked ? ranked.reasons[0] ?? "This version does not run on this computer." : null;
+  const verdict = variantVerdict(ranked, mode);
+  const blocked = !catalog && verdict.runs === false;
   const label = v.quant || v.key;
   const publisher = v.discovery?.publisher ?? null;
   const size = sizeOf(v.total_bytes);
-  return /* @__PURE__ */ jsxs4("li", { className: "flex flex-col gap-2 rounded-md border border-border p-3", "data-testid": "discovery-variant", "data-recommended": ranked.recommended ? "true" : void 0, children: [
+  return /* @__PURE__ */ jsxs4("li", { className: "flex flex-col gap-2 rounded-md border border-border p-3", "data-testid": "discovery-variant", "data-runs": verdict.runs === null ? void 0 : String(verdict.runs), "data-recommended": ranked.recommended ? "true" : void 0, children: [
     /* @__PURE__ */ jsxs4("div", { className: "flex flex-wrap items-center gap-2", children: [
       /* @__PURE__ */ jsx5("span", { className: "text-sm font-medium text-foreground", children: label }),
       ranked.recommended ? /* @__PURE__ */ jsx5(Badge, { tone: "primary", children: "Recommended" }) : null,
-      ranked.usable || catalog ? null : /* @__PURE__ */ jsx5(Badge, { tone: "warning", children: "Will not run" }),
+      verdict.badge ? /* @__PURE__ */ jsx5(Badge, { tone: "warning", children: verdict.badge }) : null,
       /* @__PURE__ */ jsx5("span", { className: "text-xs text-muted-foreground", children: [v.format.toUpperCase(), size, publisher ? `by ${publisher}` : null].filter(Boolean).join(" \xB7 ") }),
       /* @__PURE__ */ jsxs4("span", { className: "ml-auto flex items-center gap-2", children: [
         extra,
-        why ? /* @__PURE__ */ jsx5("span", { className: "text-xs text-muted-foreground", "data-testid": "choose-reason", children: why }) : null,
+        verdict.reason ? /* @__PURE__ */ jsx5("span", { className: "text-xs text-muted-foreground", "data-testid": "choose-reason", children: verdict.reason }) : null,
         /* @__PURE__ */ jsx5(Button, { variant: ranked.recommended ? "primary" : "outline", disabled: busy || blocked, onClick: onChoose, children: choosingThis ? "Working\u2026" : chooseLabel })
       ] })
     ] }),
-    runtime ? /* @__PURE__ */ jsx5("p", { className: runtime.available ? "text-xs text-muted-foreground" : "text-xs text-foreground", "data-testid": "variant-runtime", children: runtime.available ? `Runs on ${runtime.name}` : runtime.note || `Matrx 2 has no ${runtime.name} runtime yet.` }) : null,
-    /* @__PURE__ */ jsx5("ul", { className: "flex flex-col gap-0.5", children: ranked.reasons.map((line) => /* @__PURE__ */ jsx5("li", { className: "text-xs text-muted-foreground", children: line }, line)) }),
+    verdict.runtime ? /* @__PURE__ */ jsx5("p", { className: "text-xs text-muted-foreground", "data-testid": "variant-runtime", children: verdict.runtime }) : null,
+    /* @__PURE__ */ jsx5("ul", { className: "flex flex-col gap-0.5", children: verdict.lines.map((line) => /* @__PURE__ */ jsx5("li", { className: "text-xs text-muted-foreground", children: line }, line)) }),
     v.artifacts.length ? /* @__PURE__ */ jsxs4(Collapsible, { children: [
       /* @__PURE__ */ jsxs4(CollapsibleTrigger, { className: "text-xs text-muted-foreground hover:text-foreground", children: [
         "Files in this version (",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.201",
+  "version": "0.59.203",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -511,9 +511,9 @@
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
     "@ai-matrx/content-ir": "latest",
+    "@ai-matrx/api": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
-    "@ai-matrx/api": "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": "6085e09f65f8512280be0a8be5e3db2b4d1888c9"
+  "gitHead": "5a78bc1e32253c3f46527ed9d519c3562e446cf7"
 }