@ai-matrx/agents 0.59.238 → 0.59.240

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.59.240
+
+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.239
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 9df1465977 6acfc6b938 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.238
 
 - **The context views never warn the person (Arman, 2026-10-22).** `ContextRulesChip` loses `mismatchCount` / `mismatches` (no amber face, no warning glyph, no "N · M" count); `ContextRulesTable` and `ContextRulesPanelBody` lose `mismatches` (no row marker, no "expected X, got Y" banner); `describeMismatches` is deleted. `compareReceipt` is unchanged — the host still files the silent `context_truth_mismatch`. A self-check row keeps its tooltip from `row.blockedBy`. Guard: `context/react/a-context-view-never-warns-the-person.test.tsx`. Consumer action: stop passing `mismatchCount` / `mismatches`.

package/dist/models/index.cjs

@@ -1591,11 +1591,16 @@ function normalizeAdmin(row, offerings) {
   };
 }
 var rows = (data) => Array.isArray(data) ? data : [];
+function aiRpc(client, fn) {
+  const scope = client.schema("ai");
+  if (!scope.rpc) throw new Error(`The model catalog client's schema("ai") has no rpc(), so ${fn} cannot be called.`);
+  return scope.rpc(fn);
+}
 async function readCatalog(client, variant) {
   if (variant === "admin") {
     const [rpcRes, offeringsRes] = await Promise.all([
       client.rpc("admin_model_catalog"),
-      client.rpc("admin_model_offerings")
+      aiRpc(client, "admin_model_offerings")
     ]);
     if (rpcRes.error) throw rpcRes.error;
     if (offeringsRes.error) throw offeringsRes.error;

package/dist/models/index.d.cts

@@ -756,7 +756,7 @@ declare const selectModelIdentityLookupStatus: (s: ModelRecordsState, modelId: s
  *   - "user"  → `ai.model_public` (anon + authenticated; masked, points pricing), filtered to
  *               ROUTABLE models via `ai.model_offering`, which also supplies each model's serving
  *               TIERS (`served_via` — the endpoint's public Matrx brand, never the real vendor).
- *   - "admin" → `public.admin_model_catalog()` + `public.admin_model_offerings()` (SECURITY
+ *   - "admin" → `public.admin_model_catalog()` + `ai.admin_model_offerings()` (SECURITY
  *               DEFINER, gated by `is_super_admin()`): raw $ pricing, real vendors, every
  *               offering. NEVER read `ai.model_admin` / `ai.offering` directly from a client.
  *
@@ -787,6 +787,8 @@ interface ModelCatalogClient {
     rpc(fn: string, args?: Record<string, unknown>): PromiseLike<ModelCatalogPgResult>;
     schema(name: string): {
         from(table: string): ModelCatalogQuery;
+        /** Present on every supabase-js schema scope; optional only so read-only fixtures stay valid. */
+        rpc?(fn: string, args?: Record<string, unknown>): PromiseLike<ModelCatalogPgResult>;
     };
 }
 type ModelCatalogErrorSink = (event: {

package/dist/models/index.d.ts

@@ -756,7 +756,7 @@ declare const selectModelIdentityLookupStatus: (s: ModelRecordsState, modelId: s
  *   - "user"  → `ai.model_public` (anon + authenticated; masked, points pricing), filtered to
  *               ROUTABLE models via `ai.model_offering`, which also supplies each model's serving
  *               TIERS (`served_via` — the endpoint's public Matrx brand, never the real vendor).
- *   - "admin" → `public.admin_model_catalog()` + `public.admin_model_offerings()` (SECURITY
+ *   - "admin" → `public.admin_model_catalog()` + `ai.admin_model_offerings()` (SECURITY
  *               DEFINER, gated by `is_super_admin()`): raw $ pricing, real vendors, every
  *               offering. NEVER read `ai.model_admin` / `ai.offering` directly from a client.
  *
@@ -787,6 +787,8 @@ interface ModelCatalogClient {
     rpc(fn: string, args?: Record<string, unknown>): PromiseLike<ModelCatalogPgResult>;
     schema(name: string): {
         from(table: string): ModelCatalogQuery;
+        /** Present on every supabase-js schema scope; optional only so read-only fixtures stay valid. */
+        rpc?(fn: string, args?: Record<string, unknown>): PromiseLike<ModelCatalogPgResult>;
     };
 }
 type ModelCatalogErrorSink = (event: {

package/dist/models/index.js

@@ -1432,11 +1432,16 @@ function normalizeAdmin(row, offerings) {
   };
 }
 var rows = (data) => Array.isArray(data) ? data : [];
+function aiRpc(client, fn) {
+  const scope = client.schema("ai");
+  if (!scope.rpc) throw new Error(`The model catalog client's schema("ai") has no rpc(), so ${fn} cannot be called.`);
+  return scope.rpc(fn);
+}
 async function readCatalog(client, variant) {
   if (variant === "admin") {
     const [rpcRes, offeringsRes] = await Promise.all([
       client.rpc("admin_model_catalog"),
-      client.rpc("admin_model_offerings")
+      aiRpc(client, "admin_model_offerings")
     ]);
     if (rpcRes.error) throw rpcRes.error;
     if (offeringsRes.error) throw offeringsRes.error;

package/dist/models/react/index.cjs

@@ -107,7 +107,14 @@ function useLocalModels(override) {
     port ? port.getModels : () => NO_LOCAL_MODELS,
     port ? port.getModels : () => NO_LOCAL_MODELS
   );
-  return { models, groupLabel: port?.groupLabel ?? "On this computer", open: port?.open ? (id) => port.open?.(id) : void 0 };
+  return {
+    models,
+    groupLabel: port?.groupLabel ?? "On this computer",
+    open: port?.open ? (id) => port.open?.(id) : void 0,
+    start: port?.start ? (id) => port.start?.(id) : void 0,
+    stop: port?.stop ? (id) => port.stop?.(id) : void 0,
+    getMore: port?.getMore ? () => port.getMore?.() : void 0
+  };
 }
 var NO_ACCESS = {};
 function useModelAccess(override) {
@@ -1405,7 +1412,13 @@ function ModelRow({
     }
   );
 }
-function LocalModelRow({ model, selected, onSelect }) {
+function LocalModelRow({
+  model,
+  selected,
+  onSelect,
+  control,
+  failure
+}) {
   const unusable = model.unusable ?? null;
   const dim = model.needsMoreMemory === true;
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
@@ -1446,11 +1459,23 @@ function LocalModelRow({ model, selected, onSelect }) {
             ),
             dim && /* @__PURE__ */ (0, import_jsx_runtime3.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_runtime3.jsx)("span", { "data-local-model-reason": true, className: "truncate text-[11px] text-muted-foreground", children: unusable })
+          (unusable || failure) && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { "data-local-model-reason": true, className: (0, import_design_system.cn)("truncate text-[11px]", failure ? "text-destructive" : "text-muted-foreground"), title: failure ?? void 0, children: failure ?? unusable })
         ] }),
         /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "w-11" }),
         /* @__PURE__ */ (0, import_jsx_runtime3.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) }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "w-[2.75rem]" })
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "flex w-[2.75rem] justify-end", onClick: (e) => e.stopPropagation(), onKeyDown: (e) => e.stopPropagation(), children: control && !unusable ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+          import_design_system.IconButton,
+          {
+            icon: control.kind === "stop" ? import_icons5.StopIcon : import_icons5.PlayIcon,
+            tooltip: control.pending ? control.kind === "stop" ? "Stopping" : "Starting" : control.kind === "stop" ? "Stop" : "Start",
+            "aria-label": control.kind === "stop" ? `Stop ${model.name}` : `Start ${model.name}`,
+            "data-local-model-control": control.kind,
+            "data-pending": control.pending ? "" : void 0,
+            disabled: control.pending,
+            spinning: control.pending,
+            onClick: control.onPress
+          }
+        ) : null })
       ]
     }
   );
@@ -1553,7 +1578,41 @@ function ModelListDropdown({
   const priorityModelSet = priorityModelIds ? new Set(priorityModelIds) : null;
   const eligibleModels = allowedModelSet ? models.filter((model) => allowedModelSet.has(model.id)) : models;
   const selected = models.find((m) => m.id === value) ?? null;
-  const { models: localAll, groupLabel: localGroupLabel, open: openLocal } = useLocalModels(localModelsProp);
+  const { models: localAll, groupLabel: localGroupLabel, open: openLocal, start: startLocal, stop: stopLocal, getMore: getMoreLocal } = useLocalModels(localModelsProp);
+  const [localPending, setLocalPending] = (0, import_react2.useState)(() => /* @__PURE__ */ new Set());
+  const [localFailure, setLocalFailure] = (0, import_react2.useState)(() => /* @__PURE__ */ new Map());
+  const runLocal = (id2, action, verb) => {
+    setLocalFailure((cur) => {
+      if (!cur.has(id2)) return cur;
+      const next = new Map(cur);
+      next.delete(id2);
+      return next;
+    });
+    setLocalPending((cur) => new Set(cur).add(id2));
+    let result;
+    try {
+      result = action(id2);
+    } catch (error2) {
+      result = Promise.reject(error2);
+    }
+    void Promise.resolve(result).catch((error2) => {
+      console.error(`[model-picker] could not ${verb} ${id2}:`, error2);
+      const why = error2 instanceof Error && error2.message ? error2.message : `Could not ${verb}`;
+      setLocalFailure((cur) => new Map(cur).set(id2, why));
+    }).finally(
+      () => setLocalPending((cur) => {
+        const next = new Set(cur);
+        next.delete(id2);
+        return next;
+      })
+    );
+  };
+  const localControl = (m) => {
+    const pending = localPending.has(m.id) || m.starting === true;
+    if (m.running === true && stopLocal) return { kind: "stop", pending, onPress: () => runLocal(m.id, stopLocal, "stop") };
+    if (m.running !== true && startLocal) return { kind: "start", pending, onPress: () => runLocal(m.id, startLocal, "start") };
+    return null;
+  };
   const selectedLocal = localAll.find((m) => m.id === value) ?? null;
   const localEligible = !modelOnly && variant === "user" && !allowedModelSet && (effectiveSelectionPurpose === "chat" || effectiveSelectionPurpose === "agent");
   const localRows = (0, import_react2.useMemo)(() => {
@@ -1954,11 +2013,36 @@ function ModelListDropdown({
           children: emptyOptionLabel
         }
       ),
-      localRows.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
-        localRunnable.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: GROUP_HEADING, children: localGroupLabel }),
-        localRunnable.map((l) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(LocalModelRow, { model: l, selected: l.id === value, onSelect: () => handleSelectLocal(l) }, l.id)),
+      (localRows.length > 0 || localEligible && tab === "all" && !query.trim() && getMoreLocal) && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
+        (localRunnable.length > 0 || localRows.length === 0 && getMoreLocal) && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: GROUP_HEADING, children: localGroupLabel }),
+        localRunnable.map((l) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(LocalModelRow, { model: l, selected: l.id === value, onSelect: () => handleSelectLocal(l), control: localControl(l), failure: localFailure.get(l.id) ?? null }, l.id)),
+        getMoreLocal && localEligible && tab === "all" && !query.trim() && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+          "div",
+          {
+            role: "button",
+            tabIndex: 0,
+            "data-local-get-more": "",
+            onClick: () => {
+              getMoreLocal();
+              handleOpen(false);
+            },
+            onKeyDown: (e) => {
+              if (e.key === "Enter" || e.key === " ") {
+                e.preventDefault();
+                getMoreLocal();
+                handleOpen(false);
+              }
+            },
+            className: "grid w-full cursor-pointer grid-cols-[16px_20px_minmax(0,1fr)] items-center gap-2 rounded px-2 py-1 text-xs text-muted-foreground transition-colors hover:bg-muted/60 hover:text-foreground focus:bg-muted/60 focus:outline-none",
+            children: [
+              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "w-4" }),
+              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "flex w-5 justify-center", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_icons5.PlusIcon, { className: "h-3.5 w-3.5" }) }),
+              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "truncate", children: "Get More Models..." })
+            ]
+          }
+        ),
         localUnusable.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: GROUP_HEADING, children: "Cannot run here" }),
-        localUnusable.map((l) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(LocalModelRow, { model: l, selected: false, onSelect: () => void 0 }, l.id)),
+        localUnusable.map((l) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(LocalModelRow, { model: l, selected: false, onSelect: () => void 0, failure: localFailure.get(l.id) ?? null }, l.id)),
         filtered.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: GROUP_HEADING, children: "Cloud" })
       ] }),
       filtered.length === 0 ? localRows.length > 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.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_runtime3.jsx)(

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

@@ -372,7 +372,7 @@ interface ModelRecords {
  *   - "user"  → `ai.model_public` (anon + authenticated; masked, points pricing), filtered to
  *               ROUTABLE models via `ai.model_offering`, which also supplies each model's serving
  *               TIERS (`served_via` — the endpoint's public Matrx brand, never the real vendor).
- *   - "admin" → `public.admin_model_catalog()` + `public.admin_model_offerings()` (SECURITY
+ *   - "admin" → `public.admin_model_catalog()` + `ai.admin_model_offerings()` (SECURITY
  *               DEFINER, gated by `is_super_admin()`): raw $ pricing, real vendors, every
  *               offering. NEVER read `ai.model_admin` / `ai.offering` directly from a client.
  *
@@ -436,11 +436,20 @@ interface LocalModelEntry {
      * picker lists it under "Cannot run here" with this reason, dimmed and never pickable.
      */
     unusable?: string;
+    /**
+     * The model is loaded and answering now. With a port `stop`, the row draws Stop; with `start`
+     * and not running, Start. Absent = the host does not say (no control is drawn).
+     */
+    running?: boolean;
+    /** The host is loading it right now: the row's control shows its pending state. */
+    starting?: boolean;
 }
 /**
  * The host's local-model source (a store: `getModels` + `subscribe`, like the catalog). The picker
- * draws its models as one "On this computer" group marked local. Start/Stop and getting more
- * models stay the host's own screens.
+ * draws its models as one "On this computer" group marked local. Starting and stopping a model and
+ * getting more of them are capabilities by presence: a host that supplies `start` / `stop` / `getMore`
+ * gets a compact Start/Stop control per row and one "Get More Models..." row; a host that leaves them
+ * out gets neither (its own screens stay the only way).
  */
 interface LocalModelsPort {
     /** Must return the SAME array until the list changes (it is a store snapshot). */
@@ -455,6 +464,15 @@ interface LocalModelsPort {
      * the id through `onValueChange` (the override path).
      */
     open?(id: string): void;
+    /**
+     * Start the model (load it so it can answer). Present = a row that is not running draws Start. The
+     * row shows a pending state until the returned promise settles; a rejection says why on the row.
+     */
+    start?(id: string): void | Promise<unknown>;
+    /** Stop the running model. Present = a running row draws Stop (same pending state and failure line). */
+    stop?(id: string): void | Promise<unknown>;
+    /** Open the host's place to find and install more models. Present = one "Get More Models..." row ends the group. */
+    getMore?(): void;
 }
 /**
  * How the person may reach a cloud model in THIS place (a chat composer passes it to its own picker,
@@ -514,6 +532,9 @@ declare function useLocalModels(override?: LocalModelsPort): {
     models: readonly LocalModelEntry[];
     groupLabel: string;
     open: ((id: string) => void) | undefined;
+    start: ((id: string) => void | Promise<unknown>) | undefined;
+    stop: ((id: string) => void | Promise<unknown>) | undefined;
+    getMore: (() => void) | undefined;
 };
 /** The cloud-access rules for this picker; a port passed straight to the picker beats the provider's. */
 declare function useModelAccess(override?: ModelAccessPort): ModelAccessPort;

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

@@ -372,7 +372,7 @@ interface ModelRecords {
  *   - "user"  → `ai.model_public` (anon + authenticated; masked, points pricing), filtered to
  *               ROUTABLE models via `ai.model_offering`, which also supplies each model's serving
  *               TIERS (`served_via` — the endpoint's public Matrx brand, never the real vendor).
- *   - "admin" → `public.admin_model_catalog()` + `public.admin_model_offerings()` (SECURITY
+ *   - "admin" → `public.admin_model_catalog()` + `ai.admin_model_offerings()` (SECURITY
  *               DEFINER, gated by `is_super_admin()`): raw $ pricing, real vendors, every
  *               offering. NEVER read `ai.model_admin` / `ai.offering` directly from a client.
  *
@@ -436,11 +436,20 @@ interface LocalModelEntry {
      * picker lists it under "Cannot run here" with this reason, dimmed and never pickable.
      */
     unusable?: string;
+    /**
+     * The model is loaded and answering now. With a port `stop`, the row draws Stop; with `start`
+     * and not running, Start. Absent = the host does not say (no control is drawn).
+     */
+    running?: boolean;
+    /** The host is loading it right now: the row's control shows its pending state. */
+    starting?: boolean;
 }
 /**
  * The host's local-model source (a store: `getModels` + `subscribe`, like the catalog). The picker
- * draws its models as one "On this computer" group marked local. Start/Stop and getting more
- * models stay the host's own screens.
+ * draws its models as one "On this computer" group marked local. Starting and stopping a model and
+ * getting more of them are capabilities by presence: a host that supplies `start` / `stop` / `getMore`
+ * gets a compact Start/Stop control per row and one "Get More Models..." row; a host that leaves them
+ * out gets neither (its own screens stay the only way).
  */
 interface LocalModelsPort {
     /** Must return the SAME array until the list changes (it is a store snapshot). */
@@ -455,6 +464,15 @@ interface LocalModelsPort {
      * the id through `onValueChange` (the override path).
      */
     open?(id: string): void;
+    /**
+     * Start the model (load it so it can answer). Present = a row that is not running draws Start. The
+     * row shows a pending state until the returned promise settles; a rejection says why on the row.
+     */
+    start?(id: string): void | Promise<unknown>;
+    /** Stop the running model. Present = a running row draws Stop (same pending state and failure line). */
+    stop?(id: string): void | Promise<unknown>;
+    /** Open the host's place to find and install more models. Present = one "Get More Models..." row ends the group. */
+    getMore?(): void;
 }
 /**
  * How the person may reach a cloud model in THIS place (a chat composer passes it to its own picker,
@@ -514,6 +532,9 @@ declare function useLocalModels(override?: LocalModelsPort): {
     models: readonly LocalModelEntry[];
     groupLabel: string;
     open: ((id: string) => void) | undefined;
+    start: ((id: string) => void | Promise<unknown>) | undefined;
+    stop: ((id: string) => void | Promise<unknown>) | undefined;
+    getMore: (() => void) | undefined;
 };
 /** The cloud-access rules for this picker; a port passed straight to the picker beats the provider's. */
 declare function useModelAccess(override?: ModelAccessPort): ModelAccessPort;

package/dist/models/react/index.js

@@ -71,7 +71,14 @@ function useLocalModels(override) {
     port ? port.getModels : () => NO_LOCAL_MODELS,
     port ? port.getModels : () => NO_LOCAL_MODELS
   );
-  return { models, groupLabel: port?.groupLabel ?? "On this computer", open: port?.open ? (id) => port.open?.(id) : void 0 };
+  return {
+    models,
+    groupLabel: port?.groupLabel ?? "On this computer",
+    open: port?.open ? (id) => port.open?.(id) : void 0,
+    start: port?.start ? (id) => port.start?.(id) : void 0,
+    stop: port?.stop ? (id) => port.stop?.(id) : void 0,
+    getMore: port?.getMore ? () => port.getMore?.() : void 0
+  };
 }
 var NO_ACCESS = {};
 function useModelAccess(override) {
@@ -88,6 +95,7 @@ import {
   Popover,
   PopoverTrigger,
   PopoverContent,
+  IconButton,
   Tooltip,
   TooltipContent,
   TooltipProvider,
@@ -302,7 +310,7 @@ var ScaleIcon = sized(GScaleIcon);
 var LanguagesIcon = sized(GLanguagesIcon);
 
 // models/react/ModelListDropdown.tsx
-import { ChevronDownIcon, ChevronRightIcon, SearchIcon, StarIcon, VideoIcon } from "@ai-matrx/design-system/icons";
+import { ChevronDownIcon, ChevronRightIcon, PlayIcon, PlusIcon, SearchIcon, StarIcon, StopIcon, VideoIcon } from "@ai-matrx/design-system/icons";
 
 // models/succession.ts
 var MAX_SUCCESSION_HOPS = 8;
@@ -1396,7 +1404,13 @@ function ModelRow({
     }
   );
 }
-function LocalModelRow({ model, selected, onSelect }) {
+function LocalModelRow({
+  model,
+  selected,
+  onSelect,
+  control,
+  failure
+}) {
   const unusable = model.unusable ?? null;
   const dim = model.needsMoreMemory === true;
   return /* @__PURE__ */ jsxs2(
@@ -1437,11 +1451,23 @@ function LocalModelRow({ model, selected, onSelect }) {
             ),
             dim && /* @__PURE__ */ jsx3("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__ */ jsx3("span", { "data-local-model-reason": true, className: "truncate text-[11px] text-muted-foreground", children: unusable })
+          (unusable || failure) && /* @__PURE__ */ jsx3("span", { "data-local-model-reason": true, className: cn("truncate text-[11px]", failure ? "text-destructive" : "text-muted-foreground"), title: failure ?? void 0, children: failure ?? unusable })
         ] }),
         /* @__PURE__ */ jsx3("span", { className: "w-11" }),
         /* @__PURE__ */ jsx3("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) }),
-        /* @__PURE__ */ jsx3("span", { className: "w-[2.75rem]" })
+        /* @__PURE__ */ jsx3("span", { className: "flex w-[2.75rem] justify-end", onClick: (e) => e.stopPropagation(), onKeyDown: (e) => e.stopPropagation(), children: control && !unusable ? /* @__PURE__ */ jsx3(
+          IconButton,
+          {
+            icon: control.kind === "stop" ? StopIcon : PlayIcon,
+            tooltip: control.pending ? control.kind === "stop" ? "Stopping" : "Starting" : control.kind === "stop" ? "Stop" : "Start",
+            "aria-label": control.kind === "stop" ? `Stop ${model.name}` : `Start ${model.name}`,
+            "data-local-model-control": control.kind,
+            "data-pending": control.pending ? "" : void 0,
+            disabled: control.pending,
+            spinning: control.pending,
+            onClick: control.onPress
+          }
+        ) : null })
       ]
     }
   );
@@ -1544,7 +1570,41 @@ function ModelListDropdown({
   const priorityModelSet = priorityModelIds ? new Set(priorityModelIds) : null;
   const eligibleModels = allowedModelSet ? models.filter((model) => allowedModelSet.has(model.id)) : models;
   const selected = models.find((m) => m.id === value) ?? null;
-  const { models: localAll, groupLabel: localGroupLabel, open: openLocal } = useLocalModels(localModelsProp);
+  const { models: localAll, groupLabel: localGroupLabel, open: openLocal, start: startLocal, stop: stopLocal, getMore: getMoreLocal } = useLocalModels(localModelsProp);
+  const [localPending, setLocalPending] = useState(() => /* @__PURE__ */ new Set());
+  const [localFailure, setLocalFailure] = useState(() => /* @__PURE__ */ new Map());
+  const runLocal = (id2, action, verb) => {
+    setLocalFailure((cur) => {
+      if (!cur.has(id2)) return cur;
+      const next = new Map(cur);
+      next.delete(id2);
+      return next;
+    });
+    setLocalPending((cur) => new Set(cur).add(id2));
+    let result;
+    try {
+      result = action(id2);
+    } catch (error2) {
+      result = Promise.reject(error2);
+    }
+    void Promise.resolve(result).catch((error2) => {
+      console.error(`[model-picker] could not ${verb} ${id2}:`, error2);
+      const why = error2 instanceof Error && error2.message ? error2.message : `Could not ${verb}`;
+      setLocalFailure((cur) => new Map(cur).set(id2, why));
+    }).finally(
+      () => setLocalPending((cur) => {
+        const next = new Set(cur);
+        next.delete(id2);
+        return next;
+      })
+    );
+  };
+  const localControl = (m) => {
+    const pending = localPending.has(m.id) || m.starting === true;
+    if (m.running === true && stopLocal) return { kind: "stop", pending, onPress: () => runLocal(m.id, stopLocal, "stop") };
+    if (m.running !== true && startLocal) return { kind: "start", pending, onPress: () => runLocal(m.id, startLocal, "start") };
+    return null;
+  };
   const selectedLocal = localAll.find((m) => m.id === value) ?? null;
   const localEligible = !modelOnly && variant === "user" && !allowedModelSet && (effectiveSelectionPurpose === "chat" || effectiveSelectionPurpose === "agent");
   const localRows = useMemo2(() => {
@@ -1945,11 +2005,36 @@ function ModelListDropdown({
           children: emptyOptionLabel
         }
       ),
-      localRows.length > 0 && /* @__PURE__ */ jsxs2(Fragment2, { children: [
-        localRunnable.length > 0 && /* @__PURE__ */ jsx3("div", { className: GROUP_HEADING, children: localGroupLabel }),
-        localRunnable.map((l) => /* @__PURE__ */ jsx3(LocalModelRow, { model: l, selected: l.id === value, onSelect: () => handleSelectLocal(l) }, l.id)),
+      (localRows.length > 0 || localEligible && tab === "all" && !query.trim() && getMoreLocal) && /* @__PURE__ */ jsxs2(Fragment2, { children: [
+        (localRunnable.length > 0 || localRows.length === 0 && getMoreLocal) && /* @__PURE__ */ jsx3("div", { className: GROUP_HEADING, children: localGroupLabel }),
+        localRunnable.map((l) => /* @__PURE__ */ jsx3(LocalModelRow, { model: l, selected: l.id === value, onSelect: () => handleSelectLocal(l), control: localControl(l), failure: localFailure.get(l.id) ?? null }, l.id)),
+        getMoreLocal && localEligible && tab === "all" && !query.trim() && /* @__PURE__ */ jsxs2(
+          "div",
+          {
+            role: "button",
+            tabIndex: 0,
+            "data-local-get-more": "",
+            onClick: () => {
+              getMoreLocal();
+              handleOpen(false);
+            },
+            onKeyDown: (e) => {
+              if (e.key === "Enter" || e.key === " ") {
+                e.preventDefault();
+                getMoreLocal();
+                handleOpen(false);
+              }
+            },
+            className: "grid w-full cursor-pointer grid-cols-[16px_20px_minmax(0,1fr)] items-center gap-2 rounded px-2 py-1 text-xs text-muted-foreground transition-colors hover:bg-muted/60 hover:text-foreground focus:bg-muted/60 focus:outline-none",
+            children: [
+              /* @__PURE__ */ jsx3("span", { className: "w-4" }),
+              /* @__PURE__ */ jsx3("span", { className: "flex w-5 justify-center", children: /* @__PURE__ */ jsx3(PlusIcon, { className: "h-3.5 w-3.5" }) }),
+              /* @__PURE__ */ jsx3("span", { className: "truncate", children: "Get More Models..." })
+            ]
+          }
+        ),
         localUnusable.length > 0 && /* @__PURE__ */ jsx3("div", { className: GROUP_HEADING, children: "Cannot run here" }),
-        localUnusable.map((l) => /* @__PURE__ */ jsx3(LocalModelRow, { model: l, selected: false, onSelect: () => void 0 }, l.id)),
+        localUnusable.map((l) => /* @__PURE__ */ jsx3(LocalModelRow, { model: l, selected: false, onSelect: () => void 0, failure: localFailure.get(l.id) ?? null }, l.id)),
         filtered.length > 0 && /* @__PURE__ */ jsx3("div", { className: GROUP_HEADING, children: "Cloud" })
       ] }),
       filtered.length === 0 ? localRows.length > 0 ? null : /* @__PURE__ */ jsx3("div", { className: "p-4 text-center text-xs text-muted-foreground", children: "No models match your filters." }) : listRows.map(({ model: m, classTier }) => /* @__PURE__ */ jsx3(

package/dist/settings/index.d.cts

@@ -568,11 +568,20 @@ interface LocalModelEntry {
      * picker lists it under "Cannot run here" with this reason, dimmed and never pickable.
      */
     unusable?: string;
+    /**
+     * The model is loaded and answering now. With a port `stop`, the row draws Stop; with `start`
+     * and not running, Start. Absent = the host does not say (no control is drawn).
+     */
+    running?: boolean;
+    /** The host is loading it right now: the row's control shows its pending state. */
+    starting?: boolean;
 }
 /**
  * The host's local-model source (a store: `getModels` + `subscribe`, like the catalog). The picker
- * draws its models as one "On this computer" group marked local. Start/Stop and getting more
- * models stay the host's own screens.
+ * draws its models as one "On this computer" group marked local. Starting and stopping a model and
+ * getting more of them are capabilities by presence: a host that supplies `start` / `stop` / `getMore`
+ * gets a compact Start/Stop control per row and one "Get More Models..." row; a host that leaves them
+ * out gets neither (its own screens stay the only way).
  */
 interface LocalModelsPort {
     /** Must return the SAME array until the list changes (it is a store snapshot). */
@@ -587,6 +596,15 @@ interface LocalModelsPort {
      * the id through `onValueChange` (the override path).
      */
     open?(id: string): void;
+    /**
+     * Start the model (load it so it can answer). Present = a row that is not running draws Start. The
+     * row shows a pending state until the returned promise settles; a rejection says why on the row.
+     */
+    start?(id: string): void | Promise<unknown>;
+    /** Stop the running model. Present = a running row draws Stop (same pending state and failure line). */
+    stop?(id: string): void | Promise<unknown>;
+    /** Open the host's place to find and install more models. Present = one "Get More Models..." row ends the group. */
+    getMore?(): void;
 }
 /**
  * How the person may reach a cloud model in THIS place (a chat composer passes it to its own picker,

package/dist/settings/index.d.ts

@@ -568,11 +568,20 @@ interface LocalModelEntry {
      * picker lists it under "Cannot run here" with this reason, dimmed and never pickable.
      */
     unusable?: string;
+    /**
+     * The model is loaded and answering now. With a port `stop`, the row draws Stop; with `start`
+     * and not running, Start. Absent = the host does not say (no control is drawn).
+     */
+    running?: boolean;
+    /** The host is loading it right now: the row's control shows its pending state. */
+    starting?: boolean;
 }
 /**
  * The host's local-model source (a store: `getModels` + `subscribe`, like the catalog). The picker
- * draws its models as one "On this computer" group marked local. Start/Stop and getting more
- * models stay the host's own screens.
+ * draws its models as one "On this computer" group marked local. Starting and stopping a model and
+ * getting more of them are capabilities by presence: a host that supplies `start` / `stop` / `getMore`
+ * gets a compact Start/Stop control per row and one "Get More Models..." row; a host that leaves them
+ * out gets neither (its own screens stay the only way).
  */
 interface LocalModelsPort {
     /** Must return the SAME array until the list changes (it is a store snapshot). */
@@ -587,6 +596,15 @@ interface LocalModelsPort {
      * the id through `onValueChange` (the override path).
      */
     open?(id: string): void;
+    /**
+     * Start the model (load it so it can answer). Present = a row that is not running draws Start. The
+     * row shows a pending state until the returned promise settles; a rejection says why on the row.
+     */
+    start?(id: string): void | Promise<unknown>;
+    /** Stop the running model. Present = a running row draws Stop (same pending state and failure line). */
+    stop?(id: string): void | Promise<unknown>;
+    /** Open the host's place to find and install more models. Present = one "Get More Models..." row ends the group. */
+    getMore?(): void;
 }
 /**
  * How the person may reach a cloud model in THIS place (a chat composer passes it to its own picker,

package/dist/versions/index.cjs

@@ -244,7 +244,7 @@ async function readAgentCurrentVersion(client, agentId) {
   return typeof v === "number" && Number.isInteger(v) ? v : null;
 }
 async function declareContractBreak(client, query) {
-  const { error } = await client.rpc("agx_declare_contract_break", {
+  const { error } = await client.schema("agent").rpc("agx_declare_contract_break", {
     p_agent_id: query.agentId,
     p_version_number: query.version,
     p_kind: query.kind ?? void 0

package/dist/versions/index.d.cts

@@ -135,6 +135,7 @@ type Answer = PromiseLike<{
 interface VersionsClient {
     rpc(fn: string, args: Record<string, unknown>): Answer;
     schema(name: "agent"): {
+        rpc(fn: string, args: Record<string, unknown>): Answer;
         from(table: "definition_version" | "definition"): {
             select(columns: string): {
                 eq(column: string, value: string): {

package/dist/versions/index.d.ts

@@ -135,6 +135,7 @@ type Answer = PromiseLike<{
 interface VersionsClient {
     rpc(fn: string, args: Record<string, unknown>): Answer;
     schema(name: "agent"): {
+        rpc(fn: string, args: Record<string, unknown>): Answer;
         from(table: "definition_version" | "definition"): {
             select(columns: string): {
                 eq(column: string, value: string): {

package/dist/versions/index.js

@@ -201,7 +201,7 @@ async function readAgentCurrentVersion(client, agentId) {
   return typeof v === "number" && Number.isInteger(v) ? v : null;
 }
 async function declareContractBreak(client, query) {
-  const { error } = await client.rpc("agx_declare_contract_break", {
+  const { error } = await client.schema("agent").rpc("agx_declare_contract_break", {
     p_agent_id: query.agentId,
     p_version_number: query.version,
     p_kind: query.kind ?? void 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.238",
+  "version": "0.59.240",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -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": "9df14659778c1a3b93c2c09bddcdc93b145ca736"
+  "gitHead": "c3acf23378ea3cfd81a456efb31c6db0b65e89ef"
 }