@ai-matrx/agents 0.59.259 → 0.59.261

package/CHANGELOG.md

@@ -1,9 +1,14 @@
 # Changelog
 
-## 0.59.259
-
-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.261
+### the pinned read asks the server for those agents only (FW-015)
+
+- `ensureFavoriteRows()` / `readFavoriteAgentRows` now read the starred agents through
+  `agent.agx_get_by_ids(p_ids)` (same columns and access words as `agx_get_list_full`) instead of
+  `agx_get_list_full` filtered by id, which made the server build the caller's whole catalog first.
+  Measured on live: ordinary account 161 → 41 ms, admin 390 → 53 ms, identical rows.
+- The narrow read needs a client with `schema()` (supabase-js has it); without one the store falls back to the
+  whole catalog and reports `pinned_read_unsupported`, as before. Consumer action: none.
 
 ## 0.59.257
 

package/dist/catalog/index.cjs

@@ -398,6 +398,9 @@ async function readFavoriteAgentRows(client, favorites) {
   if (typeof favorites.list !== "function") {
     throw new AgentPinnedReadUnsupported("the favorites port has no list()");
   }
+  if (typeof client.schema !== "function") {
+    throw new AgentPinnedReadUnsupported("the client has no schema()");
+  }
   const listed = await favorites.list("favorite");
   if (!listed.ok) {
     throw new AgentCatalogReadError(
@@ -416,13 +419,9 @@ async function readFavoriteAgentRows(client, favorites) {
   const rows = [];
   for (let at = 0; at < ids.length; at += PINNED_ID_CHUNK) {
     const chunk = ids.slice(at, at + PINNED_ID_CHUNK);
-    const call = client.rpc("agx_get_list_full", {});
-    if (typeof call.in !== "function") {
-      throw new AgentPinnedReadUnsupported("the client's rpc builder has no in()");
-    }
-    const { data, error } = await call.in("id", chunk);
+    const { data, error } = await client.schema("agent").rpc("agx_get_by_ids", { p_ids: chunk });
     if (error) {
-      throw new AgentCatalogReadError("agx_get_list_full (pinned)", pgDetail(error));
+      throw new AgentCatalogReadError("agent.agx_get_by_ids (pinned)", pgDetail(error));
     }
     for (const item of Array.isArray(data) ? data : []) {
       const summary = toAgentSummary(item);

package/dist/catalog/index.d.cts

@@ -814,10 +814,11 @@ declare function getRegisteredAgentCatalog(catalogId?: string): AgentCatalog | u
  *      set this module returns to the store.
  *   5. ONE write: the caller's star, `ues_set` through the same port. The
  *      retired `agent.definition.is_favorite` column is never read or written.
- *   6. THE PINNED READ (2026-10-09): the caller's starred ids (`ues_list`
- *      through the favorites port), then `agx_get_list_full` filtered to
- *      exactly those ids (`?id=in.(…)`). A sidebar's Pinned section shows a
- *      handful of rows; it never pays for the whole catalog to find them.
+ *   6. THE PINNED READ (2026-10-09; by-ids 2026-10-23): the caller's starred
+ *      ids (`ues_list` through the favorites port), then
+ *      `agent.agx_get_by_ids(p_ids)` for exactly those ids. A sidebar's Pinned
+ *      section shows a handful of rows; it never pays for the whole catalog,
+ *      in the browser or on the server, to find them.
  *
  * 🚨 THE LIST READ IS COMPLETE OR IT THROWS. PostgREST caps every response at
  * `db-max-rows` (1000 on Matrx Main) and reports success — matrx-frontend's

package/dist/catalog/index.d.ts

@@ -814,10 +814,11 @@ declare function getRegisteredAgentCatalog(catalogId?: string): AgentCatalog | u
  *      set this module returns to the store.
  *   5. ONE write: the caller's star, `ues_set` through the same port. The
  *      retired `agent.definition.is_favorite` column is never read or written.
- *   6. THE PINNED READ (2026-10-09): the caller's starred ids (`ues_list`
- *      through the favorites port), then `agx_get_list_full` filtered to
- *      exactly those ids (`?id=in.(…)`). A sidebar's Pinned section shows a
- *      handful of rows; it never pays for the whole catalog to find them.
+ *   6. THE PINNED READ (2026-10-09; by-ids 2026-10-23): the caller's starred
+ *      ids (`ues_list` through the favorites port), then
+ *      `agent.agx_get_by_ids(p_ids)` for exactly those ids. A sidebar's Pinned
+ *      section shows a handful of rows; it never pays for the whole catalog,
+ *      in the browser or on the server, to find them.
  *
  * 🚨 THE LIST READ IS COMPLETE OR IT THROWS. PostgREST caps every response at
  * `db-max-rows` (1000 on Matrx Main) and reports success — matrx-frontend's

package/dist/catalog/index.js

@@ -292,6 +292,9 @@ async function readFavoriteAgentRows(client, favorites) {
   if (typeof favorites.list !== "function") {
     throw new AgentPinnedReadUnsupported("the favorites port has no list()");
   }
+  if (typeof client.schema !== "function") {
+    throw new AgentPinnedReadUnsupported("the client has no schema()");
+  }
   const listed = await favorites.list("favorite");
   if (!listed.ok) {
     throw new AgentCatalogReadError(
@@ -310,13 +313,9 @@ async function readFavoriteAgentRows(client, favorites) {
   const rows = [];
   for (let at = 0; at < ids.length; at += PINNED_ID_CHUNK) {
     const chunk = ids.slice(at, at + PINNED_ID_CHUNK);
-    const call = client.rpc("agx_get_list_full", {});
-    if (typeof call.in !== "function") {
-      throw new AgentPinnedReadUnsupported("the client's rpc builder has no in()");
-    }
-    const { data, error } = await call.in("id", chunk);
+    const { data, error } = await client.schema("agent").rpc("agx_get_by_ids", { p_ids: chunk });
     if (error) {
-      throw new AgentCatalogReadError("agx_get_list_full (pinned)", pgDetail(error));
+      throw new AgentCatalogReadError("agent.agx_get_by_ids (pinned)", pgDetail(error));
     }
     for (const item of Array.isArray(data) ? data : []) {
       const summary = toAgentSummary(item);

package/dist/context/react/index.cjs

@@ -43,11 +43,13 @@ __export(react_exports, {
   InlineMaxInput: () => InlineMaxInput,
   PAGE_LEVEL: () => PAGE_LEVEL,
   buildContextLevels: () => buildContextLevels,
+  buildContextTree: () => buildContextTree,
   includeChanges: () => includeChanges,
   inheritedInclude: () => inheritedInclude,
   levelRows: () => levelRows,
   placeByOrigin: () => placeByOrigin,
-  summarizeContextRows: () => summarizeContextRows
+  summarizeContextRows: () => summarizeContextRows,
+  treeLevels: () => treeLevels
 });
 module.exports = __toCommonJS(react_exports);
 
@@ -203,6 +205,41 @@ function buildContextLevels(rows, hierarchy) {
   for (const level of out) level.groups = stableSort(level.groups, (g) => g.ref);
   return stableSort(out, (level) => level.ref);
 }
+function buildContextTree(levels) {
+  const roots = [];
+  const byId = /* @__PURE__ */ new Map();
+  const rank = /* @__PURE__ */ new Map();
+  for (const level of levels) {
+    const labels = level.ref.path.length > 0 ? level.ref.path : [""];
+    let siblings = roots;
+    let last = null;
+    const ids = [];
+    for (let i = 0; i < labels.length; i++) {
+      ids.push(labels[i].trim().toLowerCase());
+      const id = ids.join("
");
+      let hit = byId.get(id);
+      if (!hit) {
+        hit = { id, label: labels[i], path: labels.slice(0, i + 1), level: null, children: [] };
+        byId.set(id, hit);
+        siblings.push(hit);
+      }
+      const order = level.ref.order ?? 0;
+      rank.set(hit, Math.min(rank.get(hit) ?? order, order));
+      last = hit;
+      siblings = hit.children;
+    }
+    if (last) last.level = level;
+  }
+  const sort = (list) => {
+    const sorted = stableSort(list, (n) => ({ order: rank.get(n) ?? 0 }));
+    for (const n of sorted) n.children = sort(n.children);
+    return sorted;
+  };
+  return sort(roots);
+}
+function treeLevels(node) {
+  return [...node.level ? [node.level] : [], ...node.children.flatMap(treeLevels)];
+}
 function levelRows(level) {
   return [...level.rows, ...level.groups.flatMap((g) => g.rows)];
 }
@@ -463,16 +500,6 @@ function useNarrow(ref) {
 }
 var INDENT = ["", "pl-2", "pl-4", "pl-6"];
 var indent = (depth) => INDENT[Math.min(depth, INDENT.length - 1)];
-function sectionsOf(levels) {
-  const out = [];
-  for (const level of levels) {
-    const label = level.ref.path.length > 1 ? level.ref.path[0] : null;
-    const last = out[out.length - 1];
-    if (label !== null && last && last.label === label) last.levels.push(level);
-    else out.push({ id: label === null ? `level:${level.ref.id}` : `section:${label}`, label, levels: [level] });
-  }
-  return out;
-}
 function ContextRulesTable({
   rows,
   cap,
@@ -517,14 +544,13 @@ function ContextRulesTable({
     rowId(row)
   );
   const heading = (props) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Heading, { ...props, grid, narrow, comfortable, readOnly }, props.id);
-  const renderLevel = (level, depth) => {
+  const renderLevelBody = (level, depth, label) => {
     const all = levelRows(level);
-    const name = level.ref.path[level.ref.path.length - 1] ?? "";
-    return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { role: "rowgroup", "aria-label": headed ? level.ref.path.join(" \u203A ") : void 0, "data-level": level.ref.id, children: [
+    return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
       headed ? heading({
         id: `h:${level.ref.id}`,
         kind: "level",
-        label: name,
+        label,
         switchName: level.ref.path.join(" \u203A "),
         depth,
         rows: all,
@@ -544,7 +570,51 @@ function ContextRulesTable({
         }),
         group.rows.map((row) => renderRow(row, depth + 2))
       ] }, group.ref.id))
-    ] }, level.ref.id);
+    ] });
+  };
+  const renderNode = (node, depth) => {
+    const { level } = node;
+    const below = node.children.map((child) => renderNode(child, depth + 1));
+    if (level) {
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+        "div",
+        {
+          role: "rowgroup",
+          "aria-label": headed ? level.ref.path.join(" \u203A ") : void 0,
+          "data-level": level.ref.id,
+          children: [
+            renderLevelBody(level, depth, node.label),
+            below
+          ]
+        },
+        level.ref.id
+      );
+    }
+    const covered = treeLevels(node);
+    const all = covered.flatMap(levelRows);
+    const several = covered.length > 1;
+    const toggleSection = several && !readOnly ? (next) => {
+      const changes = [];
+      for (const lv of covered) {
+        if (lv.master) lv.master.onToggle?.(next);
+        else changes.push(...bulkChanges(levelRows(lv), next));
+      }
+      if (changes.length > 0) onSetInclude?.(changes);
+    } : void 0;
+    return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { role: "rowgroup", "aria-label": node.label, "data-section": node.label, children: [
+      heading({
+        id: `h:section:${node.id}`,
+        kind: "section",
+        label: node.label,
+        switchName: node.path.join(" \u203A "),
+        depth,
+        rows: all,
+        checked: covered.some((l) => l.master ? l.master.on : levelRows(l).some((r) => r.include)),
+        onToggle: toggleSection,
+        noSwitch: !several
+      }),
+      below
+    ] }, `section:${node.id}`);
   };
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_design_system3.TooltipProvider, { delayDuration: 300, titleTooltips: false, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
     "div",
@@ -569,33 +639,7 @@ function ContextRulesTable({
             ]
           }
         ),
-        levels.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "px-2 py-3 text-center text-muted-foreground", children: "None" }) : sectionsOf(levels).map((section) => {
-          if (section.label === null || !headed) return renderLevel(section.levels[0], 0);
-          const all = section.levels.flatMap(levelRows);
-          const several = section.levels.length > 1;
-          const toggleSection = several && !readOnly ? (next) => {
-            const changes = [];
-            for (const level of section.levels) {
-              if (level.master) level.master.onToggle?.(next);
-              else changes.push(...bulkChanges(levelRows(level), next));
-            }
-            if (changes.length > 0) onSetInclude?.(changes);
-          } : void 0;
-          return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { role: "rowgroup", "aria-label": section.label, "data-section": section.label, children: [
-            heading({
-              id: `h:${section.id}`,
-              kind: "section",
-              label: section.label,
-              switchName: section.label,
-              depth: 0,
-              rows: all,
-              checked: section.levels.some((l) => l.master ? l.master.on : levelRows(l).some((r) => r.include)),
-              onToggle: toggleSection,
-              noSwitch: !several
-            }),
-            section.levels.map((level) => renderLevel(level, 1))
-          ] }, section.id);
-        })
+        levels.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "px-2 py-3 text-center text-muted-foreground", children: "None" }) : headed ? buildContextTree(levels).map((node) => renderNode(node, 0)) : levels.map((level) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "rowgroup", "data-level": level.ref.id, children: renderLevelBody(level, 0, level.ref.path[level.ref.path.length - 1] ?? "") }, level.ref.id))
       ]
     }
   ) });

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

@@ -238,6 +238,31 @@ declare const PAGE_LEVEL: ContextLevelRef;
 declare function placeByOrigin(row: ResolvedContextRow): ContextRowPlace;
 /** Rows → levels → groups, in the host's order (stable within equal orders). */
 declare function buildContextLevels(rows: readonly ResolvedContextRow[], hierarchy?: ContextHierarchy | null): ContextLevelNode[];
+/**
+ * A heading of the table: one label of a level's path. A node with a `level`
+ * IS that level (its rows, groups, switch); a node without one is a section
+ * that only names the labels above deeper levels.
+ */
+interface ContextTreeNode {
+    /** The path up to and including this label, lower-cased: one node per distinct path. */
+    id: string;
+    /** This node's own label (the last one of its path). */
+    label: string;
+    /** The full heading path to this node, root first. */
+    path: readonly string[];
+    level: ContextLevelNode | null;
+    children: ContextTreeNode[];
+}
+/**
+ * Levels → ONE tree by path (Arman, 2026-10-21: "UNIFY and eliminate" — one
+ * AI Matrx root, whatever the levels' paths): `["AI Matrx"]`,
+ * `["AI Matrx", "Marketing"]` and `["AI Matrx", "Marketing", "Brands"]` nest as
+ * AI Matrx → Marketing → Brands; a root named by two levels is still one root.
+ * Order: a node sorts by the lowest `order` found in it or below it.
+ */
+declare function buildContextTree(levels: readonly ContextLevelNode[]): ContextTreeNode[];
+/** Every level at or below a node. */
+declare function treeLevels(node: ContextTreeNode): ContextLevelNode[];
 /** Every row of a level, groups included. */
 declare function levelRows(level: ContextLevelNode): ResolvedContextRow[];
 /** What the row's include would be with no rule of the person's. */
@@ -455,4 +480,4 @@ declare function ContextReceiptBlockDetail({ block, load, className, }: {
     className?: string;
 }): React.JSX.Element;
 
-export { AI_MATRX_LEVEL, ATTACHED_LEVEL, ContextDeliveredValue, type ContextGroupNode, type ContextGroupRef, type ContextHierarchy, type ContextLevelMaster, type ContextLevelNode, type ContextLevelRef, ContextReceiptBlockDetail, ContextReceiptBlocks, type ContextReceiptBlocksProps, type ContextRowPlace, type ContextRuleChange, ContextRulesChip, type ContextRulesChipProps, type ContextRulesDensity, ContextRulesPanelBody, type ContextRulesPanelBodyProps, ContextRulesTable, type ContextRulesTableProps, DeliveredSection, InlineMaxInput, type InlineMaxInputProps, PAGE_LEVEL, buildContextLevels, includeChanges, inheritedInclude, levelRows, placeByOrigin, summarizeContextRows };
+export { AI_MATRX_LEVEL, ATTACHED_LEVEL, ContextDeliveredValue, type ContextGroupNode, type ContextGroupRef, type ContextHierarchy, type ContextLevelMaster, type ContextLevelNode, type ContextLevelRef, ContextReceiptBlockDetail, ContextReceiptBlocks, type ContextReceiptBlocksProps, type ContextRowPlace, type ContextRuleChange, ContextRulesChip, type ContextRulesChipProps, type ContextRulesDensity, ContextRulesPanelBody, type ContextRulesPanelBodyProps, ContextRulesTable, type ContextRulesTableProps, type ContextTreeNode, DeliveredSection, InlineMaxInput, type InlineMaxInputProps, PAGE_LEVEL, buildContextLevels, buildContextTree, includeChanges, inheritedInclude, levelRows, placeByOrigin, summarizeContextRows, treeLevels };

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

@@ -238,6 +238,31 @@ declare const PAGE_LEVEL: ContextLevelRef;
 declare function placeByOrigin(row: ResolvedContextRow): ContextRowPlace;
 /** Rows → levels → groups, in the host's order (stable within equal orders). */
 declare function buildContextLevels(rows: readonly ResolvedContextRow[], hierarchy?: ContextHierarchy | null): ContextLevelNode[];
+/**
+ * A heading of the table: one label of a level's path. A node with a `level`
+ * IS that level (its rows, groups, switch); a node without one is a section
+ * that only names the labels above deeper levels.
+ */
+interface ContextTreeNode {
+    /** The path up to and including this label, lower-cased: one node per distinct path. */
+    id: string;
+    /** This node's own label (the last one of its path). */
+    label: string;
+    /** The full heading path to this node, root first. */
+    path: readonly string[];
+    level: ContextLevelNode | null;
+    children: ContextTreeNode[];
+}
+/**
+ * Levels → ONE tree by path (Arman, 2026-10-21: "UNIFY and eliminate" — one
+ * AI Matrx root, whatever the levels' paths): `["AI Matrx"]`,
+ * `["AI Matrx", "Marketing"]` and `["AI Matrx", "Marketing", "Brands"]` nest as
+ * AI Matrx → Marketing → Brands; a root named by two levels is still one root.
+ * Order: a node sorts by the lowest `order` found in it or below it.
+ */
+declare function buildContextTree(levels: readonly ContextLevelNode[]): ContextTreeNode[];
+/** Every level at or below a node. */
+declare function treeLevels(node: ContextTreeNode): ContextLevelNode[];
 /** Every row of a level, groups included. */
 declare function levelRows(level: ContextLevelNode): ResolvedContextRow[];
 /** What the row's include would be with no rule of the person's. */
@@ -455,4 +480,4 @@ declare function ContextReceiptBlockDetail({ block, load, className, }: {
     className?: string;
 }): React.JSX.Element;
 
-export { AI_MATRX_LEVEL, ATTACHED_LEVEL, ContextDeliveredValue, type ContextGroupNode, type ContextGroupRef, type ContextHierarchy, type ContextLevelMaster, type ContextLevelNode, type ContextLevelRef, ContextReceiptBlockDetail, ContextReceiptBlocks, type ContextReceiptBlocksProps, type ContextRowPlace, type ContextRuleChange, ContextRulesChip, type ContextRulesChipProps, type ContextRulesDensity, ContextRulesPanelBody, type ContextRulesPanelBodyProps, ContextRulesTable, type ContextRulesTableProps, DeliveredSection, InlineMaxInput, type InlineMaxInputProps, PAGE_LEVEL, buildContextLevels, includeChanges, inheritedInclude, levelRows, placeByOrigin, summarizeContextRows };
+export { AI_MATRX_LEVEL, ATTACHED_LEVEL, ContextDeliveredValue, type ContextGroupNode, type ContextGroupRef, type ContextHierarchy, type ContextLevelMaster, type ContextLevelNode, type ContextLevelRef, ContextReceiptBlockDetail, ContextReceiptBlocks, type ContextReceiptBlocksProps, type ContextRowPlace, type ContextRuleChange, ContextRulesChip, type ContextRulesChipProps, type ContextRulesDensity, ContextRulesPanelBody, type ContextRulesPanelBodyProps, ContextRulesTable, type ContextRulesTableProps, type ContextTreeNode, DeliveredSection, InlineMaxInput, type InlineMaxInputProps, PAGE_LEVEL, buildContextLevels, buildContextTree, includeChanges, inheritedInclude, levelRows, placeByOrigin, summarizeContextRows, treeLevels };

package/dist/context/react/index.js

@@ -167,6 +167,41 @@ function buildContextLevels(rows, hierarchy) {
   for (const level of out) level.groups = stableSort(level.groups, (g) => g.ref);
   return stableSort(out, (level) => level.ref);
 }
+function buildContextTree(levels) {
+  const roots = [];
+  const byId = /* @__PURE__ */ new Map();
+  const rank = /* @__PURE__ */ new Map();
+  for (const level of levels) {
+    const labels = level.ref.path.length > 0 ? level.ref.path : [""];
+    let siblings = roots;
+    let last = null;
+    const ids = [];
+    for (let i = 0; i < labels.length; i++) {
+      ids.push(labels[i].trim().toLowerCase());
+      const id = ids.join("
");
+      let hit = byId.get(id);
+      if (!hit) {
+        hit = { id, label: labels[i], path: labels.slice(0, i + 1), level: null, children: [] };
+        byId.set(id, hit);
+        siblings.push(hit);
+      }
+      const order = level.ref.order ?? 0;
+      rank.set(hit, Math.min(rank.get(hit) ?? order, order));
+      last = hit;
+      siblings = hit.children;
+    }
+    if (last) last.level = level;
+  }
+  const sort = (list) => {
+    const sorted = stableSort(list, (n) => ({ order: rank.get(n) ?? 0 }));
+    for (const n of sorted) n.children = sort(n.children);
+    return sorted;
+  };
+  return sort(roots);
+}
+function treeLevels(node) {
+  return [...node.level ? [node.level] : [], ...node.children.flatMap(treeLevels)];
+}
 function levelRows(level) {
   return [...level.rows, ...level.groups.flatMap((g) => g.rows)];
 }
@@ -403,7 +438,7 @@ function summarizeContextRows(rows) {
 }
 
 // context/react/ContextRulesTable.tsx
-import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
 var CONTEXT_RULES_GRID = {
   compact: "grid grid-cols-[minmax(0,1fr)_2.75rem_4rem_6.5rem] items-center gap-x-2 px-2",
   comfortable: "grid grid-cols-[minmax(0,1fr)_2.75rem_3.5rem_6.75rem] items-center gap-x-1.5 px-3"
@@ -433,16 +468,6 @@ function useNarrow(ref) {
 }
 var INDENT = ["", "pl-2", "pl-4", "pl-6"];
 var indent = (depth) => INDENT[Math.min(depth, INDENT.length - 1)];
-function sectionsOf(levels) {
-  const out = [];
-  for (const level of levels) {
-    const label = level.ref.path.length > 1 ? level.ref.path[0] : null;
-    const last = out[out.length - 1];
-    if (label !== null && last && last.label === label) last.levels.push(level);
-    else out.push({ id: label === null ? `level:${level.ref.id}` : `section:${label}`, label, levels: [level] });
-  }
-  return out;
-}
 function ContextRulesTable({
   rows,
   cap,
@@ -487,14 +512,13 @@ function ContextRulesTable({
     rowId(row)
   );
   const heading = (props) => /* @__PURE__ */ jsx3(Heading, { ...props, grid, narrow, comfortable, readOnly }, props.id);
-  const renderLevel = (level, depth) => {
+  const renderLevelBody = (level, depth, label) => {
     const all = levelRows(level);
-    const name = level.ref.path[level.ref.path.length - 1] ?? "";
-    return /* @__PURE__ */ jsxs3("div", { role: "rowgroup", "aria-label": headed ? level.ref.path.join(" \u203A ") : void 0, "data-level": level.ref.id, children: [
+    return /* @__PURE__ */ jsxs3(Fragment, { children: [
       headed ? heading({
         id: `h:${level.ref.id}`,
         kind: "level",
-        label: name,
+        label,
         switchName: level.ref.path.join(" \u203A "),
         depth,
         rows: all,
@@ -514,7 +538,51 @@ function ContextRulesTable({
         }),
         group.rows.map((row) => renderRow(row, depth + 2))
       ] }, group.ref.id))
-    ] }, level.ref.id);
+    ] });
+  };
+  const renderNode = (node, depth) => {
+    const { level } = node;
+    const below = node.children.map((child) => renderNode(child, depth + 1));
+    if (level) {
+      return /* @__PURE__ */ jsxs3(
+        "div",
+        {
+          role: "rowgroup",
+          "aria-label": headed ? level.ref.path.join(" \u203A ") : void 0,
+          "data-level": level.ref.id,
+          children: [
+            renderLevelBody(level, depth, node.label),
+            below
+          ]
+        },
+        level.ref.id
+      );
+    }
+    const covered = treeLevels(node);
+    const all = covered.flatMap(levelRows);
+    const several = covered.length > 1;
+    const toggleSection = several && !readOnly ? (next) => {
+      const changes = [];
+      for (const lv of covered) {
+        if (lv.master) lv.master.onToggle?.(next);
+        else changes.push(...bulkChanges(levelRows(lv), next));
+      }
+      if (changes.length > 0) onSetInclude?.(changes);
+    } : void 0;
+    return /* @__PURE__ */ jsxs3("div", { role: "rowgroup", "aria-label": node.label, "data-section": node.label, children: [
+      heading({
+        id: `h:section:${node.id}`,
+        kind: "section",
+        label: node.label,
+        switchName: node.path.join(" \u203A "),
+        depth,
+        rows: all,
+        checked: covered.some((l) => l.master ? l.master.on : levelRows(l).some((r) => r.include)),
+        onToggle: toggleSection,
+        noSwitch: !several
+      }),
+      below
+    ] }, `section:${node.id}`);
   };
   return /* @__PURE__ */ jsx3(TooltipProvider2, { delayDuration: 300, titleTooltips: false, children: /* @__PURE__ */ jsxs3(
     "div",
@@ -539,33 +607,7 @@ function ContextRulesTable({
             ]
           }
         ),
-        levels.length === 0 ? /* @__PURE__ */ jsx3("div", { className: "px-2 py-3 text-center text-muted-foreground", children: "None" }) : sectionsOf(levels).map((section) => {
-          if (section.label === null || !headed) return renderLevel(section.levels[0], 0);
-          const all = section.levels.flatMap(levelRows);
-          const several = section.levels.length > 1;
-          const toggleSection = several && !readOnly ? (next) => {
-            const changes = [];
-            for (const level of section.levels) {
-              if (level.master) level.master.onToggle?.(next);
-              else changes.push(...bulkChanges(levelRows(level), next));
-            }
-            if (changes.length > 0) onSetInclude?.(changes);
-          } : void 0;
-          return /* @__PURE__ */ jsxs3("div", { role: "rowgroup", "aria-label": section.label, "data-section": section.label, children: [
-            heading({
-              id: `h:${section.id}`,
-              kind: "section",
-              label: section.label,
-              switchName: section.label,
-              depth: 0,
-              rows: all,
-              checked: section.levels.some((l) => l.master ? l.master.on : levelRows(l).some((r) => r.include)),
-              onToggle: toggleSection,
-              noSwitch: !several
-            }),
-            section.levels.map((level) => renderLevel(level, 1))
-          ] }, section.id);
-        })
+        levels.length === 0 ? /* @__PURE__ */ jsx3("div", { className: "px-2 py-3 text-center text-muted-foreground", children: "None" }) : headed ? buildContextTree(levels).map((node) => renderNode(node, 0)) : levels.map((level) => /* @__PURE__ */ jsx3("div", { role: "rowgroup", "data-level": level.ref.id, children: renderLevelBody(level, 0, level.ref.path[level.ref.path.length - 1] ?? "") }, level.ref.id))
       ]
     }
   ) });
@@ -1438,9 +1480,11 @@ export {
   InlineMaxInput,
   PAGE_LEVEL,
   buildContextLevels,
+  buildContextTree,
   includeChanges,
   inheritedInclude,
   levelRows,
   placeByOrigin,
-  summarizeContextRows
+  summarizeContextRows,
+  treeLevels
 };

package/package.json

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