@ai-matrx/agents 0.38.3 → 0.40.0

package/dist/context/react/index.cjs

@@ -31,6 +31,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // context/react/index.ts
 var react_exports = {};
 __export(react_exports, {
+  AI_MATRX_LEVEL: () => AI_MATRX_LEVEL,
+  ATTACHED_LEVEL: () => ATTACHED_LEVEL,
   ContextDeliveredValue: () => ContextDeliveredValue,
   ContextReceiptBlockDetail: () => ContextReceiptBlockDetail,
   ContextReceiptBlocks: () => ContextReceiptBlocks,
@@ -39,14 +41,22 @@ __export(react_exports, {
   ContextRulesTable: () => ContextRulesTable,
   DeliveredSection: () => DeliveredSection,
   InlineMaxInput: () => InlineMaxInput,
+  PAGE_LEVEL: () => PAGE_LEVEL,
+  buildContextLevels: () => buildContextLevels,
+  includeChanges: () => includeChanges,
+  inheritedInclude: () => inheritedInclude,
+  levelRows: () => levelRows,
+  placeByOrigin: () => placeByOrigin,
   summarizeContextRows: () => summarizeContextRows
 });
 module.exports = __toCommonJS(react_exports);
 
 // context/react/ContextRulesTable.tsx
+var React2 = __toESM(require("react"), 1);
 var import_design_system2 = require("@ai-matrx/design-system");
 
 // context/index.ts
+var import_text_case = require("@ai-matrx/kit/text-case");
 var DEFAULT_INLINE_MAX_CHARS = 200;
 var DEFAULT_INLINE_CAP = 5e4;
 var CONTEXT_ROW_BLOCKS = {
@@ -132,24 +142,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);
@@ -229,6 +221,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
 var React = __toESM(require("react"), 1);
 var import_design_system = require("@ai-matrx/design-system");
@@ -410,13 +475,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
 var import_jsx_runtime3 = require("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
@@ -432,11 +508,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__ */ (0, import_jsx_runtime3.jsx)(
+    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__ */ (0, import_jsx_runtime3.jsx)(import_design_system2.TooltipProvider, { delayDuration: 300, titleTooltips: false, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { role: "table", "aria-label": "Values", "data-density": density, className: (0, import_design_system2.cn)("text-xs", className), children: [
     /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
       "div",
@@ -454,37 +552,98 @@ function ContextRulesTable({
         ]
       }
     ),
-    rows.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "px-2 py-3 text-center text-muted-foreground", children: "None" }) : present.map((g) => /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { role: "rowgroup", "aria-label": grouped ? g.label : void 0, children: [
-      grouped ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-        "div",
-        {
-          role: "row",
-          className: "flex h-6 items-center bg-muted/40 px-2 font-medium text-muted-foreground",
-          children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { role: "cell", children: g.label })
-        }
-      ) : null,
-      rows.filter((r) => r.origin === g.origin).map((row) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-        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__ */ (0, import_jsx_runtime3.jsx)("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__ */ (0, import_jsx_runtime3.jsxs)("div", { role: "rowgroup", "aria-label": headed ? name : void 0, "data-level": level.ref.id, children: [
+        headed ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+          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__ */ (0, import_jsx_runtime3.jsxs)("div", { role: "rowgroup", "aria-label": group.ref.label, "data-group": group.ref.id, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+            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__ */ (0, import_jsx_runtime3.jsxs)(
+    "div",
+    {
+      role: "row",
+      "data-heading": kind,
+      className: (0, import_design_system2.cn)(
+        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__ */ (0, import_jsx_runtime3.jsxs)("div", { role: "cell", className: (0, import_design_system2.cn)("flex min-w-0 items-center gap-1", kind === "group" && "pl-2"), children: [
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "flex min-w-0 items-center gap-1 truncate", title: name, children: path.map((part, i) => /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(React2.Fragment, { children: [
+            i > 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "shrink-0 text-muted-foreground", children: "\u203A" }) : null,
+            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: (0, import_design_system2.cn)("truncate", i < path.length - 1 && "text-muted-foreground"), children: part })
+          ] }, `${i}:${part}`)) }),
+          total > 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "shrink-0 font-normal tabular-nums text-muted-foreground", children: count === total ? total : `${count}/${total}` }) : null
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "cell", className: "flex justify-center", children: showSwitch ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+          import_design_system2.Switch,
+          {
+            size: "sm",
+            "aria-label": `Include ${name}`,
+            checked,
+            disabled: readOnly || !onToggle,
+            onCheckedChange: (next) => onToggle?.(next)
+          }
+        ) : null }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "cell", className: "text-right font-normal tabular-nums text-muted-foreground", children: total > 0 ? charsLabel : null }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "cell" })
+      ]
+    }
+  );
+}
 function ContextRuleRow({
   row,
   cap,
   density,
+  depth,
   comfortable,
   readOnly,
   selected,
@@ -520,27 +679,39 @@ function ContextRuleRow({
         selected && "bg-accent"
       ),
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { role: "cell", className: (0, import_design_system2.cn)("flex min-w-0 items-center gap-1.5", !row.include && "opacity-50"), children: [
-          mismatches.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_design_system2.Tooltip, { children: [
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_design_system2.TooltipTrigger, { asChild: true, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-              "span",
-              {
-                role: "img",
-                "aria-label": "Mismatch",
-                className: "inline-flex shrink-0 text-warning",
-                children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(TriangleAlertIcon, { className: "h-3.5 w-3.5" })
-              }
-            ) }),
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_design_system2.TooltipContent, { children: describeMismatches(mismatches) })
-          ] }) : null,
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_design_system2.Tooltip, { children: [
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_design_system2.TooltipTrigger, { asChild: true, children: labelNode }),
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_design_system2.TooltipContent, { children: [
-              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { children: row.label }),
-              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "font-normal text-muted-foreground", children: decided })
-            ] })
-          ] })
-        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+          "div",
+          {
+            role: "cell",
+            className: (0, import_design_system2.cn)(
+              "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__ */ (0, import_jsx_runtime3.jsxs)(import_design_system2.Tooltip, { children: [
+                /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_design_system2.TooltipTrigger, { asChild: true, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+                  "span",
+                  {
+                    role: "img",
+                    "aria-label": "Mismatch",
+                    className: "inline-flex shrink-0 text-warning",
+                    children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(TriangleAlertIcon, { className: "h-3.5 w-3.5" })
+                  }
+                ) }),
+                /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_design_system2.TooltipContent, { children: describeMismatches(mismatches) })
+              ] }) : null,
+              /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_design_system2.Tooltip, { children: [
+                /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_design_system2.TooltipTrigger, { asChild: true, children: labelNode }),
+                /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_design_system2.TooltipContent, { children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { children: row.label }),
+                  /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "font-normal text-muted-foreground", children: decided })
+                ] })
+              ] })
+            ]
+          }
+        ),
         /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "cell", className: "flex justify-center", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
           import_design_system2.Switch,
           {
@@ -584,25 +755,11 @@ function ContextRuleRow({
 }
 
 // context/react/ContextRulesChip.tsx
-var React2 = __toESM(require("react"), 1);
+var React3 = __toESM(require("react"), 1);
 var import_design_system3 = require("@ai-matrx/design-system");
 var import_jsx_runtime4 = require("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,
@@ -632,6 +789,8 @@ function ContextRulesChip({
   cap,
   on,
   onToggleAll,
+  hierarchy,
+  onSetInclude,
   onChange,
   onResetAll,
   onOpenFullView,
@@ -645,7 +804,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);
@@ -658,7 +817,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__ */ (0, import_jsx_runtime4.jsxs)(
     "button",
@@ -702,7 +862,7 @@ function ContextRulesChip({
         ),
         children: [
           eyeOpen ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(EyeIcon, { className: "h-4 w-4 shrink-0 text-muted-foreground" }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(EyeOffIcon, { className: "h-4 w-4 shrink-0 text-muted-foreground" }),
-          name ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "min-w-0 truncate text-sm font-medium", children: name }) : null,
+          headerName ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "min-w-0 truncate text-sm font-medium", children: headerName }) : null,
           /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "shrink-0 text-xs tabular-nums text-muted-foreground", children: `${count} \xB7 ${charsLabel} chars` }),
           /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "ml-auto flex shrink-0 items-center gap-0.5", children: [
             blind ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "mr-1 text-xs text-muted-foreground", children: BLIND_LABEL }) : null,
@@ -742,6 +902,8 @@ function ContextRulesChip({
         readOnly,
         density: comfortable ? "comfortable" : "compact",
         onChange,
+        hierarchy,
+        onSetInclude,
         ...mismatches ? { mismatches } : {},
         ...onOpenRow ? { onOpenRow } : {}
       }
@@ -767,11 +929,11 @@ function ContextRulesChip({
 }
 
 // context/react/ContextRulesPanelBody.tsx
-var React4 = __toESM(require("react"), 1);
+var React5 = __toESM(require("react"), 1);
 var import_design_system6 = require("@ai-matrx/design-system");
 
 // context/react/ContextDeliveredValue.tsx
-var React3 = __toESM(require("react"), 1);
+var React4 = __toESM(require("react"), 1);
 var import_design_system4 = require("@ai-matrx/design-system");
 var import_jsx_runtime5 = require("react/jsx-runtime");
 function ContextDeliveredValue({
@@ -832,10 +994,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" });
@@ -1106,15 +1268,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);
@@ -1159,6 +1323,8 @@ function ContextRulesPanelBody({
         density: comfortable ? "comfortable" : "compact",
         selectedKey,
         onChange,
+        hierarchy,
+        onSetInclude,
         onOpenRow: (key) => select(key),
         ...mismatches ? { mismatches } : {}
       }