@theoremjs/react 0.3.4-next.570.gfda95a3 → 0.3.4-next.586.ga59d695

package/client/trace-story.d.ts

@@ -92,6 +92,8 @@ export interface TraceGuardrailHit {
     severityLabel: string;
     /** The matched text, kept only when the profile records match previews. */
     match?: string;
+    /** How many places the rule matched with this text. */
+    count: number;
 }
 /** One guardrail check: what it checked, what it did and why, and how long it took when timed. */
 export interface TraceGuardrailCheck {

package/client/trace-story.js

@@ -232,24 +232,33 @@ function guardrailHits(value) {
     if (!Array.isArray(value))
         return [];
     const fields = traceEventAttributeMeta('theorem.guardrail', 'hits')?.fields;
-    return value.filter(isRecord).flatMap((hit) => {
+    // why: a rule hits once per place it matched; with the text stripped the places read the same, so they count as one row.
+    const rows = new Map();
+    for (const hit of value.filter(isRecord)) {
         if (typeof hit.rule !== 'string')
-            return [];
+            continue;
+        const match = typeof hit.match === 'string' ? hit.match : undefined;
+        const key = `${hit.rule}:${match ?? ''}`;
+        const seen = rows.get(key);
+        if (seen) {
+            seen.count += 1;
+            continue;
+        }
         const severity = typeof hit.severity === 'string' ? hit.severity : '';
         // why: A host names its own rules on the hit; Theorem's are named in the catalog.
         const rule = fields?.rule?.options?.[hit.rule];
         const ruleDoc = typeof hit.doc === 'string' ? hit.doc : rule?.doc;
-        return [
-            {
-                rule: hit.rule,
-                ruleLabel: typeof hit.label === 'string' ? hit.label : (rule?.label ?? hit.rule),
-                ...(ruleDoc && { ruleDoc }),
-                severity,
-                severityLabel: fields?.severity?.options?.[severity]?.label ?? severity,
-                ...(typeof hit.match === 'string' && { match: hit.match }),
-            },
-        ];
-    });
+        rows.set(key, {
+            rule: hit.rule,
+            ruleLabel: typeof hit.label === 'string' ? hit.label : (rule?.label ?? hit.rule),
+            ...(ruleDoc && { ruleDoc }),
+            severity,
+            severityLabel: fields?.severity?.options?.[severity]?.label ?? severity,
+            ...(match !== undefined && { match }),
+            count: 1,
+        });
+    }
+    return [...rows.values()];
 }
 function eventOption(key, value) {
     return traceEventAttributeMeta('theorem.guardrail', key)?.options?.[value];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theoremjs/react",
-  "version": "0.3.4-next.570.gfda95a3",
+  "version": "0.3.4-next.586.ga59d695",
   "description": "React bindings for Theorem: headless hooks + transport, an Astryx chat UI, and a Web-standard server handler.",
   "license": "MIT",
   "type": "module",
@@ -60,8 +60,8 @@
     "@stylexjs/stylex": "0.19.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@theoremjs/agents": "^0.3.4-next.570.gfda95a3",
-    "@theoremjs/web": "^0.3.4-next.570.gfda95a3"
+    "@theoremjs/agents": "^0.3.4-next.586.ga59d695",
+    "@theoremjs/web": "^0.3.4-next.586.ga59d695"
   },
   "peerDependenciesMeta": {
     "@astryxdesign/core": {

package/ui/TraceGuardrails.js

@@ -14,8 +14,16 @@ function checkName(check) {
     return check.checkLabel ?? check.stageLabel;
 }
 /** One rule a check matched: what it caught and how serious, why that matters, and the matched text when kept. The id is on hover, for finding the rule in code. */
-function HitWhy({ hit, separator }) {
-    return (_jsxs(VStack, { gap: 0, children: [_jsx(HoverTip, { content: hit.rule, children: _jsx(Text, { type: "supporting", weight: "medium", children: [hit.ruleLabel, hit.severityLabel].filter(Boolean).join(separator) }) }), hit.ruleDoc ? (_jsx(Text, { type: "supporting", color: "secondary", children: hit.ruleDoc })) : null, hit.match ? (_jsx(Text, { type: "supporting", color: "secondary", maxLines: 2, children: `“${hit.match}”` })) : null] }));
+function HitWhy({ hit, format }) {
+    const separator = format.t('@theorem.panel.trace.separator');
+    return (_jsxs(VStack, { gap: 0, children: [_jsx(HoverTip, { content: hit.rule, children: _jsx(Text, { type: "supporting", weight: "medium", children: [
+                        hit.ruleLabel,
+                        hit.severityLabel,
+                        hit.count > 1 &&
+                            format.t('@theorem.panel.trace.guardrails.places', { count: hit.count }),
+                    ]
+                        .filter(Boolean)
+                        .join(separator) }) }), hit.ruleDoc ? (_jsx(Text, { type: "supporting", color: "secondary", children: hit.ruleDoc })) : null, hit.match ? (_jsx(Text, { type: "supporting", color: "secondary", maxLines: 2, children: `“${hit.match}”` })) : null] }));
 }
 /** Why a check acted: which check it was and on what, each rule it matched, and the guardrail's own reason. */
 function CheckWhy({ check, format }) {
@@ -26,7 +34,7 @@ function CheckWhy({ check, format }) {
                     check.tool && format.t('@theorem.panel.trace.guardrails.from', { tool: check.tool }),
                 ]
                     .filter(Boolean)
-                    .join(separator) }), check.hits.map((hit) => (_jsx(HitWhy, { hit: hit, separator: separator }, `${hit.rule}:${hit.match ?? ''}`))), check.reason ? (_jsx(Text, { type: "supporting", color: "secondary", maxLines: 3, children: check.reason })) : null] }));
+                    .join(separator) }), check.hits.map((hit) => (_jsx(HitWhy, { hit: hit, format: format }, `${hit.rule}:${hit.match ?? ''}`))), check.reason ? (_jsx(Text, { type: "supporting", color: "secondary", maxLines: 3, children: check.reason })) : null] }));
 }
 /** What a check did, as a token. A report of a call made after a remote read says so in place of "flagged". */
 function ActionToken({ check, format }) {

package/ui/labels.d.ts

@@ -1115,6 +1115,11 @@ export declare const THEOREM_UI_CATALOG: {
         readonly description: "Under the guardrail checks that acted: the checks that let the text through, each with what it checked and its time.";
         readonly params: readonly ["checks"];
     };
+    readonly '@theorem.panel.trace.guardrails.places': {
+        readonly defaultMessage: "{count, plural, one {# place} other {# places}}";
+        readonly description: "A rule a guardrail check matched: how many places in the text it matched.";
+        readonly params: readonly ["count"];
+    };
     readonly '@theorem.panel.trace.guardrails.from': {
         readonly defaultMessage: "from {tool}";
         readonly description: "A guardrail check: the tool the checked text came from.";

package/ui/labels.js

@@ -1063,6 +1063,11 @@ export const THEOREM_UI_CATALOG = {
         description: 'Under the guardrail checks that acted: the checks that let the text through, each with what it checked and its time.',
         params: ['checks'],
     },
+    '@theorem.panel.trace.guardrails.places': {
+        defaultMessage: '{count, plural, one {# place} other {# places}}',
+        description: 'A rule a guardrail check matched: how many places in the text it matched.',
+        params: ['count'],
+    },
     '@theorem.panel.trace.guardrails.from': {
         defaultMessage: 'from {tool}',
         description: 'A guardrail check: the tool the checked text came from.',