@ai-matrx/agents 0.59.268 → 0.59.270

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

@@ -804,7 +804,15 @@ interface LocalModel {
     /** At least one variant is offered (Matrx 2 lists it). */
     offered?: boolean;
     /** The later of the model's and its presentation's updated_at: what an admin edit sends as expected_updated_at. */
-    updated_at?: string | null;
+    updated_at?: string | null; /**
+     * Set only when `readModelCatalog(client, { devices })` asked: the computers that hold every required file of
+     * one of this model's listed variants (models/device-models.ts `availableOnDevices`). Absent otherwise.
+     */
+    available_on?: Array<{
+        app_instance_id: string;
+        variant_id: string;
+        device_model_file_ids: string[];
+    }>;
 }
 interface LocalCompatRow {
     hardware_class: HardwareClass;

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

@@ -804,7 +804,15 @@ interface LocalModel {
     /** At least one variant is offered (Matrx 2 lists it). */
     offered?: boolean;
     /** The later of the model's and its presentation's updated_at: what an admin edit sends as expected_updated_at. */
-    updated_at?: string | null;
+    updated_at?: string | null; /**
+     * Set only when `readModelCatalog(client, { devices })` asked: the computers that hold every required file of
+     * one of this model's listed variants (models/device-models.ts `availableOnDevices`). Absent otherwise.
+     */
+    available_on?: Array<{
+        app_instance_id: string;
+        variant_id: string;
+        device_model_file_ids: string[];
+    }>;
 }
 interface LocalCompatRow {
     hardware_class: HardwareClass;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.268",
+  "version": "0.59.270",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -518,23 +518,5 @@
       "optional": true
     }
   },
-  "matrx": {
-    "charter": "The headless agent core and the server API contract.",
-    "owns": [
-      "transport",
-      "stream protocol",
-      "mandates",
-      "agent catalog and picker",
-      "models",
-      "skills",
-      "generated server types"
-    ],
-    "mustNotOwn": [
-      "chat UI",
-      "Redux",
-      "the agent builder"
-    ],
-    "layer": 5
-  },
-  "gitHead": "5b7c48a99c8d209284a96f989c5fdbc74187940c"
+  "gitHead": "8a4ed656ea91ae1934870745a5c95f91f24da863"
 }

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

@@ -8,7 +8,10 @@
  * Fails when a file outside apps/shared/matrx-agents/models/:
  *   R1  reads ai.model_definition / model_public / model_offering / model_config / model_variant /
  *       model_presentation (`.from("…")`) or the catalog RPCs (`admin_model_catalog`, `resolve_model_config`);
- *   R2  computes a model label by hand (`x.common_name || x.name`, `?? …name`) instead of `modelDisplayLabel`.
+ *   R2  computes a model label by hand (`x.common_name || x.name`, `?? …name`) instead of `modelDisplayLabel`;
+ *   R3  reads ai.device_model_file (`.from("device_model_file").select(`) to decide which computer holds a
+ *       model, instead of readModelCatalog({ devices }) / resolveDeviceModel. Writes (the computer publishing
+ *       its own files) are not reads and pass.
  * ALLOWED lists the few readers that keep their own read on purpose, each with why and how it follows the
  * event. Test files are fixtures and are not scanned.
  *
@@ -55,6 +58,7 @@ const SKIP_DIR = new Set(["node_modules", "dist", ".next", ".next-preview", ".tu
 const isTest = (p) => /\.(test|spec)\.[cm]?[jt]sx?$/.test(p) || /\.d\.ts$/.test(p) || /\.generated\./.test(p);
 
 const R1 = /\.from\(\s*["'`](model_definition|model_public|model_offering|model_config|model_variant|model_presentation)["'`]|\.rpc\(\s*["'`](admin_model_catalog|resolve_model_config)["'`]/g;
+const R3 = /\.from\(\s*["'`]device_model_file["'`]\s*\)\s*\.select\(/g;
 const R2 = /\bcommon_name\s*(\|\||\?\?)\s*[\w$?.]*\bname\b/g;
 
 function* walk(dir) {
@@ -85,6 +89,7 @@ function scan(roots) {
       for (const [rule, re, what] of [
         ["R1", R1, "reads the model catalog directly — use @ai-matrx/agents/models (records / chat's useModelLabel / readModelIdentities)"],
         ["R2", R2, "computes a model label by hand — use modelDisplayLabel(row) from @ai-matrx/agents/models"],
+        ["R3", R3, "reads device model placement directly — use readModelCatalog(client, { devices }) / resolveDeviceModel from @ai-matrx/agents/models"],
       ]) {
         re.lastIndex = 0;
         for (let m; (m = re.exec(src)); ) findings.push(`${rel}:${lineOf(src, m.index)}  ${rule} ${what}  [${m[0].replace(/\s+/g, " ")}]`);
@@ -98,15 +103,15 @@ if (args.includes("--self-test")) {
   // Falsifiability: a planted direct read and a hand-made label must each fail; the lawful form must pass.
   const dir = mkdtempSync(join(tmpdir(), "model-catalog-reads-"));
   try {
-    writeFileSync(join(dir, "bad.ts"), 'export const r = (db: any) => db.schema("ai").from("model_definition").select("id");\nexport const l = (m: any) =>\n  m?.common_name ??\n  m?.name;\n');
-    writeFileSync(join(dir, "good.ts"), 'import { modelDisplayLabel } from "@ai-matrx/agents/models";\nexport const l = (m: any) => modelDisplayLabel(m) ?? m.common_name ?? null;\n');
+    writeFileSync(join(dir, "bad.ts"), 'export const r = (db: any) => db.schema("ai").from("model_definition").select("id");\nexport const l = (m: any) =>\n  m?.common_name ??\n  m?.name;\nexport const d = (db: any) => db.schema("ai").from("device_model_file").select("*");\n');
+    writeFileSync(join(dir, "good.ts"), 'import { modelDisplayLabel } from "@ai-matrx/agents/models";\nexport const l = (m: any) => modelDisplayLabel(m) ?? m.common_name ?? null;\nexport const w = (db: any, rows: any[]) => db.schema("ai").from("device_model_file").upsert(rows);\n');
     const got = scan([dir]);
-    const ok = got.length === 2 && got.some((f) => f.includes("bad.ts:1  R1")) && got.some((f) => f.includes("bad.ts:3  R2"));
+    const ok = got.length === 3 && got.some((f) => f.includes("bad.ts:1  R1")) && got.some((f) => f.includes("bad.ts:3  R2")) && got.some((f) => f.includes("bad.ts:5  R3"));
     if (!ok) {
-      console.error(`check-model-catalog-reads --self-test: FAILED — expected R1+R2 on bad.ts only, got:\n  ${got.join("\n  ") || "(nothing)"}`);
+      console.error(`check-model-catalog-reads --self-test: FAILED — expected R1+R2+R3 on bad.ts only, got:\n  ${got.join("\n  ") || "(nothing)"}`);
       process.exit(1);
     }
-    console.log("check-model-catalog-reads --self-test: OK — a planted read and a hand-made label both go red; modelDisplayLabel passes.");
+    console.log("check-model-catalog-reads --self-test: OK — a planted catalog read, a hand-made label and a device placement read all go red; modelDisplayLabel and a device file write pass.");
     process.exit(0);
   } finally {
     rmSync(dir, { recursive: true, force: true });