@ai-matrx/agents 0.59.239 → 0.59.241

package/CHANGELOG.md

@@ -1,10 +1,15 @@
 # Changelog
 
-## 0.59.239
+## 0.59.241
 
 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/context/react/index.cjs

@@ -310,6 +310,10 @@ function onRequestReason(row) {
   if (row.max_inline_chars === 0) return "Never inline \u2014 the agent reads it on request";
   return "Over the limit \u2014 the agent reads it on request";
 }
+function offByDefaultReason(row) {
+  if (row.include || row.decided_by.include !== "page") return null;
+  return row.layers?.surface?.auto_context === false ? "Off by default on this page" : null;
+}
 
 // context/react/InlineMaxInput.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
@@ -666,7 +670,8 @@ function ContextRuleRow({
   trail
 }) {
   const selfChecked = row.blockedBy === "self_check";
-  const decided = selfChecked ? SELF_CHECK_TOOLTIP : row.serverResolved ? SERVER_RESOLVED_TOOLTIP : `Include: ${LAYER_LABEL[row.decided_by.include]} \xB7 Limit: ${LAYER_LABEL[row.decided_by.max_inline_chars]}`;
+  const decided = selfChecked ? SELF_CHECK_TOOLTIP : row.serverResolved ? SERVER_RESOLVED_TOOLTIP : offByDefaultReason(row) ?? `Include: ${LAYER_LABEL[row.decided_by.include]} \xB7 Limit: ${LAYER_LABEL[row.decided_by.max_inline_chars]}`;
+  const shownTrail = trail ?? offByDefaultReason(row);
   const labelNode = onOpenRow ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
     "button",
     {
@@ -710,7 +715,7 @@ function ContextRuleRow({
                   /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "font-normal text-muted-foreground", children: decided })
                 ] })
               ] }),
-              trail ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "min-w-0 max-w-[45%] shrink truncate text-muted-foreground", children: trail }) : null
+              shownTrail ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "min-w-0 max-w-[45%] shrink truncate text-muted-foreground", children: shownTrail }) : null
             ]
           }
         ),

package/dist/context/react/index.js

@@ -280,6 +280,10 @@ function onRequestReason(row) {
   if (row.max_inline_chars === 0) return "Never inline \u2014 the agent reads it on request";
   return "Over the limit \u2014 the agent reads it on request";
 }
+function offByDefaultReason(row) {
+  if (row.include || row.decided_by.include !== "page") return null;
+  return row.layers?.surface?.auto_context === false ? "Off by default on this page" : null;
+}
 
 // context/react/InlineMaxInput.tsx
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
@@ -636,7 +640,8 @@ function ContextRuleRow({
   trail
 }) {
   const selfChecked = row.blockedBy === "self_check";
-  const decided = selfChecked ? SELF_CHECK_TOOLTIP : row.serverResolved ? SERVER_RESOLVED_TOOLTIP : `Include: ${LAYER_LABEL[row.decided_by.include]} \xB7 Limit: ${LAYER_LABEL[row.decided_by.max_inline_chars]}`;
+  const decided = selfChecked ? SELF_CHECK_TOOLTIP : row.serverResolved ? SERVER_RESOLVED_TOOLTIP : offByDefaultReason(row) ?? `Include: ${LAYER_LABEL[row.decided_by.include]} \xB7 Limit: ${LAYER_LABEL[row.decided_by.max_inline_chars]}`;
+  const shownTrail = trail ?? offByDefaultReason(row);
   const labelNode = onOpenRow ? /* @__PURE__ */ jsx3(
     "button",
     {
@@ -680,7 +685,7 @@ function ContextRuleRow({
                   /* @__PURE__ */ jsx3("div", { className: "font-normal text-muted-foreground", children: decided })
                 ] })
               ] }),
-              trail ? /* @__PURE__ */ jsx3("span", { className: "min-w-0 max-w-[45%] shrink truncate text-muted-foreground", children: trail }) : null
+              shownTrail ? /* @__PURE__ */ jsx3("span", { className: "min-w-0 max-w-[45%] shrink truncate text-muted-foreground", children: shownTrail }) : null
             ]
           }
         ),

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

@@ -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

@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.239",
+  "version": "0.59.241",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -509,13 +509,13 @@
   "sideEffects": false,
   "dependencies": {
     "@ai-matrx/alchemy": "latest",
-    "@ai-matrx/associations": "latest",
     "@ai-matrx/api": "latest",
-    "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/data": "latest",
+    "@ai-matrx/associations": "latest",
     "@ai-matrx/design-system": "latest",
-    "@ai-matrx/diff": "latest",
+    "@ai-matrx/data": "latest",
+    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/icons": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/kit": "latest"
   },
   "peerDependencies": {
@@ -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": "6acfc6b938bd3174a9d71a2368c8f2f7c5ceb976"
+  "gitHead": "a53838052abf9a4a70364e27933ecdf4b05a0b40"
 }