@ai-matrx/agents 0.38.3 → 0.40.0

package/dist/context/react/index.js

@@ -1,6 +1,7 @@
 "use client";
 
 // context/react/ContextRulesTable.tsx
+import * as React2 from "react";
 import {
   Switch,
   Tooltip as Tooltip2,
@@ -11,6 +12,7 @@ import {
 } from "@ai-matrx/design-system";
 
 // context/index.ts
+import { IDENTIFIER_ACRONYMS, humanizeIdentifier } from "@ai-matrx/kit/text-case";
 var DEFAULT_INLINE_MAX_CHARS = 200;
 var DEFAULT_INLINE_CAP = 5e4;
 var CONTEXT_ROW_BLOCKS = {
@@ -96,24 +98,6 @@ function resolveContextRule(input) {
     clamped
   };
 }
-var CONTEXT_KEY_ACRONYMS = [
-  "ID",
-  "URL",
-  "PDF",
-  "HTML",
-  "JSON",
-  "API",
-  "AI",
-  "UI",
-  "CSV",
-  "SMS",
-  "SEO",
-  "LLM",
-  "MCP",
-  "UUID",
-  "ISO"
-];
-var ACRONYM_SET = new Set(CONTEXT_KEY_ACRONYMS.map((a) => a.toLowerCase()));
 function formatChars(n) {
   if (n === null || n === void 0 || !Number.isFinite(n)) return "\u2014";
   const abs = Math.abs(n);
@@ -193,6 +177,79 @@ var ArrowDownToLineIcon = icon(
   ] })
 );
 
+// context/react/hierarchy.ts
+var AI_MATRX_LEVEL = { id: "ai_matrx", path: ["AI Matrx"], order: 900 };
+var ATTACHED_LEVEL = { id: "attached", path: ["Attached"], order: 500 };
+var PAGE_LEVEL = { id: "page", path: ["Page"], order: 100 };
+var ORIGIN_LEVEL = {
+  page: PAGE_LEVEL,
+  attached: ATTACHED_LEVEL,
+  system: AI_MATRX_LEVEL
+};
+function placeByOrigin(row) {
+  return { level: ORIGIN_LEVEL[row.origin] };
+}
+function stableSort(list, ref) {
+  return list.map((item, i) => ({ item, i })).sort((a, b) => (ref(a.item).order ?? 0) - (ref(b.item).order ?? 0) || a.i - b.i).map(({ item }) => item);
+}
+function buildContextLevels(rows, hierarchy) {
+  const place = hierarchy?.place ?? placeByOrigin;
+  const levels = /* @__PURE__ */ new Map();
+  const levelFor = (ref) => {
+    let node = levels.get(ref.id);
+    if (!node) {
+      node = { ref, rows: [], groups: [], master: null };
+      levels.set(ref.id, node);
+    }
+    return node;
+  };
+  for (const master of hierarchy?.masters ?? []) levelFor(master.level).master = master;
+  for (const row of rows) {
+    const where = place(row);
+    const level = levelFor(where.level);
+    if (!where.group) {
+      level.rows.push(row);
+      continue;
+    }
+    let group = level.groups.find((g) => g.ref.id === where.group.id);
+    if (!group) {
+      group = { ref: where.group, rows: [] };
+      level.groups.push(group);
+    }
+    group.rows.push(row);
+  }
+  const out = [...levels.values()];
+  for (const level of out) level.groups = stableSort(level.groups, (g) => g.ref);
+  return stableSort(out, (level) => level.ref);
+}
+function levelRows(level) {
+  return [...level.rows, ...level.groups.flatMap((g) => g.rows)];
+}
+function inheritedInclude(row, cap) {
+  return resolveContextRule({
+    ...row.layers ?? {},
+    chars: row.chars,
+    cap,
+    user: null,
+    identity: isServerAuthoritativeKey(row.key)
+  }).include;
+}
+function includeChanges(rows, include, cap) {
+  const changes = [];
+  for (const row of rows) {
+    if (row.include === include) continue;
+    const next = { ...row.userRule ?? {} };
+    if (inheritedInclude(row, cap) === include) delete next.include;
+    else next.include = include;
+    changes.push({
+      key: row.key,
+      surfaceKey: row.surfaceKey,
+      rule: Object.keys(next).length === 0 ? null : next
+    });
+  }
+  return changes;
+}
+
 // context/react/InlineMaxInput.tsx
 import * as React from "react";
 import {
@@ -380,13 +437,24 @@ function InlineMaxInput({
   ] });
 }
 
+// context/react/summary.ts
+function summarizeContextRows(rows) {
+  let count = 0;
+  let chars = 0;
+  let known = 0;
+  for (const r of rows) {
+    if (!r.include) continue;
+    count += 1;
+    if (r.chars === null || r.chars === void 0) continue;
+    chars += r.chars;
+    known += 1;
+  }
+  const charsLabel = count > 0 && known === 0 ? "\u2014" : known < count ? `${formatChars(chars)}+` : formatChars(chars);
+  return { count, chars, charsLabel };
+}
+
 // context/react/ContextRulesTable.tsx
 import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
-var GROUPS = [
-  { origin: "page", label: "Page" },
-  { origin: "attached", label: "Attached" },
-  { origin: "system", label: "System" }
-];
 var CONTEXT_RULES_GRID = {
   compact: "grid grid-cols-[minmax(0,1fr)_2.75rem_4rem_6.5rem] items-center gap-x-2 px-2",
   // Phone widths (375px): the fixed columns stay compact so Item always keeps
@@ -402,11 +470,33 @@ function ContextRulesTable({
   onOpenRow,
   density = "compact",
   selectedKey,
+  hierarchy,
+  onSetInclude,
   className
 }) {
   const comfortable = density === "comfortable";
-  const present = GROUPS.filter((g) => rows.some((r) => r.origin === g.origin));
-  const grouped = present.length > 1;
+  const levels = buildContextLevels(rows, hierarchy);
+  const headed = Boolean(hierarchy) || levels.length > 1;
+  const renderRow = (row, depth) => /* @__PURE__ */ jsx3(
+    ContextRuleRow,
+    {
+      row,
+      cap,
+      density,
+      depth: headed ? depth : 0,
+      readOnly,
+      selected: selectedKey === row.key,
+      mismatches: mismatches?.filter((m) => m.key === row.key) ?? [],
+      onChange,
+      onOpenRow,
+      comfortable
+    },
+    rowId(row)
+  );
+  const bulk = (list) => onSetInclude && !readOnly ? (next) => {
+    const changes = includeChanges(list, next, cap);
+    if (changes.length > 0) onSetInclude(changes);
+  } : void 0;
   return /* @__PURE__ */ jsx3(TooltipProvider, { delayDuration: 300, titleTooltips: false, children: /* @__PURE__ */ jsxs3("div", { role: "table", "aria-label": "Values", "data-density": density, className: cn2("text-xs", className), children: [
     /* @__PURE__ */ jsxs3(
       "div",
@@ -424,37 +514,98 @@ function ContextRulesTable({
         ]
       }
     ),
-    rows.length === 0 ? /* @__PURE__ */ jsx3("div", { className: "px-2 py-3 text-center text-muted-foreground", children: "None" }) : present.map((g) => /* @__PURE__ */ jsxs3("div", { role: "rowgroup", "aria-label": grouped ? g.label : void 0, children: [
-      grouped ? /* @__PURE__ */ jsx3(
-        "div",
-        {
-          role: "row",
-          className: "flex h-6 items-center bg-muted/40 px-2 font-medium text-muted-foreground",
-          children: /* @__PURE__ */ jsx3("span", { role: "cell", children: g.label })
-        }
-      ) : null,
-      rows.filter((r) => r.origin === g.origin).map((row) => /* @__PURE__ */ jsx3(
-        ContextRuleRow,
-        {
-          row,
-          cap,
-          density,
-          readOnly,
-          selected: selectedKey === row.key,
-          mismatches: mismatches?.filter((m) => m.key === row.key) ?? [],
-          onChange,
-          onOpenRow,
-          comfortable
-        },
-        rowId(row)
-      ))
-    ] }, g.origin))
+    levels.length === 0 ? /* @__PURE__ */ jsx3("div", { className: "px-2 py-3 text-center text-muted-foreground", children: "None" }) : levels.map((level) => {
+      const all = levelRows(level);
+      const name = level.ref.path.join(" \u203A ");
+      return /* @__PURE__ */ jsxs3("div", { role: "rowgroup", "aria-label": headed ? name : void 0, "data-level": level.ref.id, children: [
+        headed ? /* @__PURE__ */ jsx3(
+          LevelHeading,
+          {
+            kind: "level",
+            path: level.ref.path,
+            rows: all,
+            density,
+            readOnly,
+            ...levelSwitch(level, bulk(all))
+          }
+        ) : null,
+        level.rows.map((row) => renderRow(row, 1)),
+        level.groups.map((group) => /* @__PURE__ */ jsxs3("div", { role: "rowgroup", "aria-label": group.ref.label, "data-group": group.ref.id, children: [
+          /* @__PURE__ */ jsx3(
+            LevelHeading,
+            {
+              kind: "group",
+              path: [group.ref.label],
+              rows: group.rows,
+              density,
+              readOnly,
+              onToggle: bulk(group.rows),
+              checked: group.rows.some((r) => r.include)
+            }
+          ),
+          group.rows.map((row) => renderRow(row, 2))
+        ] }, group.ref.id))
+      ] }, level.ref.id);
+    })
   ] }) });
 }
+function levelSwitch(level, bulk) {
+  if (level.master) return { checked: level.master.on, onToggle: level.master.onToggle };
+  return { checked: levelRows(level).some((r) => r.include), onToggle: bulk };
+}
+function LevelHeading({
+  kind,
+  path,
+  rows,
+  density,
+  readOnly,
+  checked,
+  onToggle
+}) {
+  const name = path.join(" \u203A ");
+  const { count, charsLabel } = summarizeContextRows(rows);
+  const total = rows.length;
+  const showSwitch = Boolean(onToggle) || readOnly && total > 0;
+  return /* @__PURE__ */ jsxs3(
+    "div",
+    {
+      role: "row",
+      "data-heading": kind,
+      className: cn2(
+        CONTEXT_RULES_GRID[density],
+        "border-b border-border/50 font-medium",
+        density === "comfortable" ? "min-h-11" : "h-7",
+        kind === "level" ? "bg-muted/60 text-foreground" : "bg-muted/25 text-muted-foreground"
+      ),
+      children: [
+        /* @__PURE__ */ jsxs3("div", { role: "cell", className: cn2("flex min-w-0 items-center gap-1", kind === "group" && "pl-2"), children: [
+          /* @__PURE__ */ jsx3("span", { className: "flex min-w-0 items-center gap-1 truncate", title: name, children: path.map((part, i) => /* @__PURE__ */ jsxs3(React2.Fragment, { children: [
+            i > 0 ? /* @__PURE__ */ jsx3("span", { className: "shrink-0 text-muted-foreground", children: "\u203A" }) : null,
+            /* @__PURE__ */ jsx3("span", { className: cn2("truncate", i < path.length - 1 && "text-muted-foreground"), children: part })
+          ] }, `${i}:${part}`)) }),
+          total > 0 ? /* @__PURE__ */ jsx3("span", { className: "shrink-0 font-normal tabular-nums text-muted-foreground", children: count === total ? total : `${count}/${total}` }) : null
+        ] }),
+        /* @__PURE__ */ jsx3("div", { role: "cell", className: "flex justify-center", children: showSwitch ? /* @__PURE__ */ jsx3(
+          Switch,
+          {
+            size: "sm",
+            "aria-label": `Include ${name}`,
+            checked,
+            disabled: readOnly || !onToggle,
+            onCheckedChange: (next) => onToggle?.(next)
+          }
+        ) : null }),
+        /* @__PURE__ */ jsx3("div", { role: "cell", className: "text-right font-normal tabular-nums text-muted-foreground", children: total > 0 ? charsLabel : null }),
+        /* @__PURE__ */ jsx3("div", { role: "cell" })
+      ]
+    }
+  );
+}
 function ContextRuleRow({
   row,
   cap,
   density,
+  depth,
   comfortable,
   readOnly,
   selected,
@@ -490,27 +641,39 @@ function ContextRuleRow({
         selected && "bg-accent"
       ),
       children: [
-        /* @__PURE__ */ jsxs3("div", { role: "cell", className: cn2("flex min-w-0 items-center gap-1.5", !row.include && "opacity-50"), children: [
-          mismatches.length > 0 ? /* @__PURE__ */ jsxs3(Tooltip2, { children: [
-            /* @__PURE__ */ jsx3(TooltipTrigger2, { asChild: true, children: /* @__PURE__ */ jsx3(
-              "span",
-              {
-                role: "img",
-                "aria-label": "Mismatch",
-                className: "inline-flex shrink-0 text-warning",
-                children: /* @__PURE__ */ jsx3(TriangleAlertIcon, { className: "h-3.5 w-3.5" })
-              }
-            ) }),
-            /* @__PURE__ */ jsx3(TooltipContent2, { children: describeMismatches(mismatches) })
-          ] }) : null,
-          /* @__PURE__ */ jsxs3(Tooltip2, { children: [
-            /* @__PURE__ */ jsx3(TooltipTrigger2, { asChild: true, children: labelNode }),
-            /* @__PURE__ */ jsxs3(TooltipContent2, { children: [
-              /* @__PURE__ */ jsx3("div", { children: row.label }),
-              /* @__PURE__ */ jsx3("div", { className: "font-normal text-muted-foreground", children: decided })
-            ] })
-          ] })
-        ] }),
+        /* @__PURE__ */ jsxs3(
+          "div",
+          {
+            role: "cell",
+            className: cn2(
+              "flex min-w-0 items-center gap-1.5",
+              depth === 1 && "pl-2",
+              depth === 2 && "pl-4",
+              !row.include && "opacity-50"
+            ),
+            children: [
+              mismatches.length > 0 ? /* @__PURE__ */ jsxs3(Tooltip2, { children: [
+                /* @__PURE__ */ jsx3(TooltipTrigger2, { asChild: true, children: /* @__PURE__ */ jsx3(
+                  "span",
+                  {
+                    role: "img",
+                    "aria-label": "Mismatch",
+                    className: "inline-flex shrink-0 text-warning",
+                    children: /* @__PURE__ */ jsx3(TriangleAlertIcon, { className: "h-3.5 w-3.5" })
+                  }
+                ) }),
+                /* @__PURE__ */ jsx3(TooltipContent2, { children: describeMismatches(mismatches) })
+              ] }) : null,
+              /* @__PURE__ */ jsxs3(Tooltip2, { children: [
+                /* @__PURE__ */ jsx3(TooltipTrigger2, { asChild: true, children: labelNode }),
+                /* @__PURE__ */ jsxs3(TooltipContent2, { children: [
+                  /* @__PURE__ */ jsx3("div", { children: row.label }),
+                  /* @__PURE__ */ jsx3("div", { className: "font-normal text-muted-foreground", children: decided })
+                ] })
+              ] })
+            ]
+          }
+        ),
         /* @__PURE__ */ jsx3("div", { role: "cell", className: "flex justify-center", children: /* @__PURE__ */ jsx3(
           Switch,
           {
@@ -554,7 +717,7 @@ function ContextRuleRow({
 }
 
 // context/react/ContextRulesChip.tsx
-import * as React2 from "react";
+import * as React3 from "react";
 import {
   BottomSheet,
   Popover,
@@ -570,20 +733,6 @@ import {
 import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 var BLIND_TOOLTIP = "This model can't read these values";
 var BLIND_LABEL = "Not read";
-function summarizeContextRows(rows) {
-  let count = 0;
-  let chars = 0;
-  let known = 0;
-  for (const r of rows) {
-    if (!r.include) continue;
-    count += 1;
-    if (r.chars === null || r.chars === void 0) continue;
-    chars += r.chars;
-    known += 1;
-  }
-  const charsLabel = count > 0 && known === 0 ? "\u2014" : known < count ? `${formatChars(chars)}+` : formatChars(chars);
-  return { count, chars, charsLabel };
-}
 function IconButton({
   label,
   onClick,
@@ -613,6 +762,8 @@ function ContextRulesChip({
   cap,
   on,
   onToggleAll,
+  hierarchy,
+  onSetInclude,
   onChange,
   onResetAll,
   onOpenFullView,
@@ -626,7 +777,7 @@ function ContextRulesChip({
   onOpenChange,
   className
 }) {
-  const [openState, setOpenState] = React2.useState(false);
+  const [openState, setOpenState] = React3.useState(false);
   const open = openProp ?? openState;
   const setOpen = (next) => {
     if (openProp === void 0) setOpenState(next);
@@ -639,7 +790,8 @@ function ContextRulesChip({
   const blind = !modelReadsContext;
   const warn = mismatchCount > 0 && !blind;
   const comfortable = !!isMobile;
-  const hasPage = on !== void 0;
+  const hasPage = on !== void 0 && !hierarchy;
+  const headerName = hierarchy ? "" : name;
   const eyeOpen = !blind && on !== false;
   const faceButton = /* @__PURE__ */ jsxs4(
     "button",
@@ -683,7 +835,7 @@ function ContextRulesChip({
         ),
         children: [
           eyeOpen ? /* @__PURE__ */ jsx4(EyeIcon, { className: "h-4 w-4 shrink-0 text-muted-foreground" }) : /* @__PURE__ */ jsx4(EyeOffIcon, { className: "h-4 w-4 shrink-0 text-muted-foreground" }),
-          name ? /* @__PURE__ */ jsx4("span", { className: "min-w-0 truncate text-sm font-medium", children: name }) : null,
+          headerName ? /* @__PURE__ */ jsx4("span", { className: "min-w-0 truncate text-sm font-medium", children: headerName }) : null,
           /* @__PURE__ */ jsx4("span", { className: "shrink-0 text-xs tabular-nums text-muted-foreground", children: `${count} \xB7 ${charsLabel} chars` }),
           /* @__PURE__ */ jsxs4("div", { className: "ml-auto flex shrink-0 items-center gap-0.5", children: [
             blind ? /* @__PURE__ */ jsx4("span", { className: "mr-1 text-xs text-muted-foreground", children: BLIND_LABEL }) : null,
@@ -723,6 +875,8 @@ function ContextRulesChip({
         readOnly,
         density: comfortable ? "comfortable" : "compact",
         onChange,
+        hierarchy,
+        onSetInclude,
         ...mismatches ? { mismatches } : {},
         ...onOpenRow ? { onOpenRow } : {}
       }
@@ -748,7 +902,7 @@ function ContextRulesChip({
 }
 
 // context/react/ContextRulesPanelBody.tsx
-import * as React4 from "react";
+import * as React5 from "react";
 import {
   Input as Input2,
   Switch as Switch3,
@@ -757,7 +911,7 @@ import {
 } from "@ai-matrx/design-system";
 
 // context/react/ContextDeliveredValue.tsx
-import * as React3 from "react";
+import * as React4 from "react";
 import { ErrorBox, Skeleton, cn as cn4 } from "@ai-matrx/design-system";
 import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 function ContextDeliveredValue({
@@ -818,10 +972,10 @@ function DeliveredSection({
   ref_,
   load
 }) {
-  const [loaded, setLoaded] = React3.useState({ state: "loading" });
-  const [attempt, setAttempt] = React3.useState(0);
+  const [loaded, setLoaded] = React4.useState({ state: "loading" });
+  const [attempt, setAttempt] = React4.useState(0);
   const { kind, key } = target;
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     if (!load) return;
     let live = true;
     setLoaded({ state: "loading" });
@@ -970,7 +1124,7 @@ function ContextReceiptBlockDetail({
 }
 
 // context/react/ContextRulesPanelBody.tsx
-import { Fragment as Fragment2, jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
 function layerCells(row) {
   const { surface, agent, default_max } = row.layers ?? {};
   const declared = agent?.declared === true;
@@ -1092,15 +1246,17 @@ function ContextRulesPanelBody({
   loadView,
   readOnly,
   onChange,
+  hierarchy,
+  onSetInclude,
   renderDetail,
   isMobile,
   selectedKey: selectedProp,
   onSelectedKeyChange,
   className
 }) {
-  const [selectedState, setSelectedState] = React4.useState(null);
-  const [query, setQuery] = React4.useState("");
-  const [openBlockId, setOpenBlockId] = React4.useState(null);
+  const [selectedState, setSelectedState] = React5.useState(null);
+  const [query, setQuery] = React5.useState("");
+  const [openBlockId, setOpenBlockId] = React5.useState(null);
   const selectedKey = selectedProp !== void 0 ? selectedProp : selectedState;
   const select = (key) => {
     setOpenBlockId(null);
@@ -1145,6 +1301,8 @@ function ContextRulesPanelBody({
         density: comfortable ? "comfortable" : "compact",
         selectedKey,
         onChange,
+        hierarchy,
+        onSetInclude,
         onOpenRow: (key) => select(key),
         ...mismatches ? { mismatches } : {}
       }
@@ -1173,7 +1331,7 @@ function ContextRulesPanelBody({
     }
   ) : null;
   if (isMobile) {
-    return /* @__PURE__ */ jsx7(TooltipProvider3, { delayDuration: 300, titleTooltips: false, children: /* @__PURE__ */ jsx7("div", { className: cn6("flex h-full min-h-0 flex-col", className), children: detail ? /* @__PURE__ */ jsxs7(Fragment2, { children: [
+    return /* @__PURE__ */ jsx7(TooltipProvider3, { delayDuration: 300, titleTooltips: false, children: /* @__PURE__ */ jsx7("div", { className: cn6("flex h-full min-h-0 flex-col", className), children: detail ? /* @__PURE__ */ jsxs7(Fragment3, { children: [
       /* @__PURE__ */ jsx7("div", { className: "flex h-12 shrink-0 items-center border-b border-border px-1", children: /* @__PURE__ */ jsxs7(
         "button",
         {
@@ -1187,7 +1345,7 @@ function ContextRulesPanelBody({
         }
       ) }),
       /* @__PURE__ */ jsx7("div", { className: "min-h-0 flex-1 overflow-y-auto", children: detail })
-    ] }) : /* @__PURE__ */ jsxs7(Fragment2, { children: [
+    ] }) : /* @__PURE__ */ jsxs7(Fragment3, { children: [
       search,
       table
     ] }) }) });
@@ -1201,6 +1359,8 @@ function ContextRulesPanelBody({
   ] }) });
 }
 export {
+  AI_MATRX_LEVEL,
+  ATTACHED_LEVEL,
   ContextDeliveredValue,
   ContextReceiptBlockDetail,
   ContextReceiptBlocks,
@@ -1209,6 +1369,12 @@ export {
   ContextRulesTable,
   DeliveredSection,
   InlineMaxInput,
+  PAGE_LEVEL,
+  buildContextLevels,
+  includeChanges,
+  inheritedInclude,
+  levelRows,
+  placeByOrigin,
   summarizeContextRows
 };
 //# sourceMappingURL=index.js.map