@ai-matrx/agents 0.40.0 → 0.41.1

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

@@ -1,19 +1,5 @@
 import * as react from 'react';
 
-/**
- * @ai-matrx/agents/context — the context value rules, headless.
- *
- * Contract: common-docs/systems/scopes-context/context-delivery/RULES.md.
- * Parity corpus: ./rules-corpus.json (run here by rules.test.ts and by aidream's
- * pytest against the Python twin `resolve_context_rule`). Every function here
- * is pure, zero-React, and safe to import on a server.
- *
- * The one flow a client runs per turn:
- *   rows    = values.map(v => resolveContextRow(v, savedRows, cap))   // what the table shows
- *   context = buildContextWire(rows)                                   // what the request sends
- *   …on `context_receipt`: compareReceipt(rows, receipt)               // screen vs server
- */
-
 /** Which layer decided a field — lowest to highest. */
 type ContextLayer = "default" | "page" | "agent" | "you";
 type ContextDelivery = "inline" | "on_request" | "off";
@@ -128,7 +114,7 @@ type ContextViewLoader = (target: ContextViewTarget) => Promise<ContextViewedTex
 interface ContextReceiptBlock {
     /** Stable id: the per-turn slot it rode in, or the system-prompt addition's name. */
     id: string;
-    /** The id in words (`humanizeContextKey`). */
+    /** The id in words (`humanizeIdentifier`, `@ai-matrx/kit/text-case`). */
     label: string;
     /** Size and hash; the text comes from the viewer (`kind: "block"`). */
     delivered: ContextDeliveredRef;
@@ -301,13 +287,20 @@ interface ContextRulesTableProps {
      * switch still shows).
      */
     onSetInclude?: ((changes: ContextRuleChange[]) => void) | undefined;
+    /**
+     * Host slots inside a row's Item cell, never a second renderer: `renderRowLead`
+     * before the label (a status mark), `renderRowTrail` after it (an admin's
+     * machine name). Each renders inline and truncates with the label.
+     */
+    renderRowLead?: ((row: ResolvedContextRow) => react.ReactNode) | undefined;
+    renderRowTrail?: ((row: ResolvedContextRow) => react.ReactNode) | undefined;
     className?: string;
 }
 /**
  * The context rules table: Item | Include | Chars | Inline max. Presentational
  * and state-agnostic — every edit goes out through `onChange`.
  */
-declare function ContextRulesTable({ rows, cap, readOnly, mismatches, onChange, onOpenRow, density, selectedKey, hierarchy, onSetInclude, className, }: ContextRulesTableProps): react.JSX.Element;
+declare function ContextRulesTable({ rows, cap, readOnly, mismatches, onChange, onOpenRow, density, selectedKey, hierarchy, onSetInclude, renderRowLead, renderRowTrail, className, }: ContextRulesTableProps): react.JSX.Element;
 
 /**
  * The header's "N · chars" total. A row whose size is not known yet (an

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

@@ -1,19 +1,5 @@
 import * as react from 'react';
 
-/**
- * @ai-matrx/agents/context — the context value rules, headless.
- *
- * Contract: common-docs/systems/scopes-context/context-delivery/RULES.md.
- * Parity corpus: ./rules-corpus.json (run here by rules.test.ts and by aidream's
- * pytest against the Python twin `resolve_context_rule`). Every function here
- * is pure, zero-React, and safe to import on a server.
- *
- * The one flow a client runs per turn:
- *   rows    = values.map(v => resolveContextRow(v, savedRows, cap))   // what the table shows
- *   context = buildContextWire(rows)                                   // what the request sends
- *   …on `context_receipt`: compareReceipt(rows, receipt)               // screen vs server
- */
-
 /** Which layer decided a field — lowest to highest. */
 type ContextLayer = "default" | "page" | "agent" | "you";
 type ContextDelivery = "inline" | "on_request" | "off";
@@ -128,7 +114,7 @@ type ContextViewLoader = (target: ContextViewTarget) => Promise<ContextViewedTex
 interface ContextReceiptBlock {
     /** Stable id: the per-turn slot it rode in, or the system-prompt addition's name. */
     id: string;
-    /** The id in words (`humanizeContextKey`). */
+    /** The id in words (`humanizeIdentifier`, `@ai-matrx/kit/text-case`). */
     label: string;
     /** Size and hash; the text comes from the viewer (`kind: "block"`). */
     delivered: ContextDeliveredRef;
@@ -301,13 +287,20 @@ interface ContextRulesTableProps {
      * switch still shows).
      */
     onSetInclude?: ((changes: ContextRuleChange[]) => void) | undefined;
+    /**
+     * Host slots inside a row's Item cell, never a second renderer: `renderRowLead`
+     * before the label (a status mark), `renderRowTrail` after it (an admin's
+     * machine name). Each renders inline and truncates with the label.
+     */
+    renderRowLead?: ((row: ResolvedContextRow) => react.ReactNode) | undefined;
+    renderRowTrail?: ((row: ResolvedContextRow) => react.ReactNode) | undefined;
     className?: string;
 }
 /**
  * The context rules table: Item | Include | Chars | Inline max. Presentational
  * and state-agnostic — every edit goes out through `onChange`.
  */
-declare function ContextRulesTable({ rows, cap, readOnly, mismatches, onChange, onOpenRow, density, selectedKey, hierarchy, onSetInclude, className, }: ContextRulesTableProps): react.JSX.Element;
+declare function ContextRulesTable({ rows, cap, readOnly, mismatches, onChange, onOpenRow, density, selectedKey, hierarchy, onSetInclude, renderRowLead, renderRowTrail, className, }: ContextRulesTableProps): react.JSX.Element;
 
 /**
  * The header's "N · chars" total. A row whose size is not known yet (an

package/dist/context/react/index.js

@@ -12,7 +12,6 @@ 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 = {
@@ -472,6 +471,8 @@ function ContextRulesTable({
   selectedKey,
   hierarchy,
   onSetInclude,
+  renderRowLead,
+  renderRowTrail,
   className
 }) {
   const comfortable = density === "comfortable";
@@ -489,7 +490,9 @@ function ContextRulesTable({
       mismatches: mismatches?.filter((m) => m.key === row.key) ?? [],
       onChange,
       onOpenRow,
-      comfortable
+      comfortable,
+      lead: renderRowLead?.(row),
+      trail: renderRowTrail?.(row)
     },
     rowId(row)
   );
@@ -553,6 +556,60 @@ 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 };
 }
+var useIsoLayoutEffect = typeof window === "undefined" ? React2.useEffect : React2.useLayoutEffect;
+function HeadingPath({ path, name }) {
+  const boxRef = React2.useRef(null);
+  const fullRef = React2.useRef(null);
+  const [compact, setCompact] = React2.useState(false);
+  const multi = path.length > 1;
+  useIsoLayoutEffect(() => {
+    const box = boxRef.current;
+    const full = fullRef.current;
+    if (!multi || !box || !full) return void 0;
+    const fit = () => setCompact(full.scrollWidth > box.clientWidth);
+    fit();
+    if (typeof ResizeObserver === "undefined") return void 0;
+    const observer = new ResizeObserver(fit);
+    observer.observe(box);
+    return () => observer.disconnect();
+  }, [multi, name]);
+  const shown = multi && compact ? path.slice(-1) : path;
+  return /* @__PURE__ */ jsxs3(
+    "span",
+    {
+      ref: boxRef,
+      "data-compact": multi && compact ? "true" : void 0,
+      className: "relative flex min-w-0 flex-1 items-center gap-1 overflow-hidden",
+      title: name,
+      children: [
+        multi ? /* @__PURE__ */ jsx3(
+          "span",
+          {
+            ref: fullRef,
+            "aria-hidden": true,
+            className: "pointer-events-none invisible absolute left-0 top-0 flex items-center gap-1 whitespace-nowrap",
+            children: path.map((part, i) => /* @__PURE__ */ jsxs3(React2.Fragment, { children: [
+              i > 0 ? /* @__PURE__ */ jsx3("span", { children: "\u203A" }) : null,
+              /* @__PURE__ */ jsx3("span", { children: part })
+            ] }, `${i}:${part}`))
+          }
+        ) : null,
+        shown.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(
+                i < shown.length - 1 ? "shrink-0 whitespace-nowrap text-muted-foreground" : "min-w-0 truncate"
+              ),
+              children: part
+            }
+          )
+        ] }, `${i}:${part}`))
+      ]
+    }
+  );
+}
 function LevelHeading({
   kind,
   path,
@@ -579,10 +636,7 @@ function LevelHeading({
       ),
       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}`)) }),
+          /* @__PURE__ */ jsx3(HeadingPath, { path, name }),
           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(
@@ -611,7 +665,9 @@ function ContextRuleRow({
   selected,
   mismatches,
   onChange,
-  onOpenRow
+  onOpenRow,
+  lead,
+  trail
 }) {
   const selfChecked = row.blockedBy === "self_check" || mismatches.some((m) => m.reason === "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]}`;
@@ -664,13 +720,15 @@ function ContextRuleRow({
                 ) }),
                 /* @__PURE__ */ jsx3(TooltipContent2, { children: describeMismatches(mismatches) })
               ] }) : null,
+              lead ? /* @__PURE__ */ jsx3("span", { className: "inline-flex shrink-0 items-center", children: lead }) : 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 })
                 ] })
-              ] })
+              ] }),
+              trail ? /* @__PURE__ */ jsx3("span", { className: "min-w-0 max-w-[45%] shrink truncate text-muted-foreground", children: trail }) : null
             ]
           }
         ),