@ai-matrx/agents 0.40.0 → 0.41.0

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)
   );
@@ -579,9 +582,18 @@ 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: [
+          /* @__PURE__ */ jsx3("span", { className: "flex min-w-0 items-center gap-1 overflow-hidden", 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 })
+            /* @__PURE__ */ jsx3(
+              "span",
+              {
+                className: cn2(
+                  "truncate",
+                  i < path.length - 1 ? "max-w-[45%] shrink-0 text-muted-foreground" : "min-w-0"
+                ),
+                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
         ] }),
@@ -611,7 +623,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 +678,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
             ]
           }
         ),