@railtownai/railtracks-visualizer 0.0.65 → 0.0.67

package/dist/types/agenthub/components/GuardrailsPopover.d.ts

@@ -0,0 +1,18 @@
+import { type PopoverProps } from "antd";
+import React from "react";
+import type { LLMGuardrail } from "../../dto/AgentRunNode";
+export interface GuardrailsPopoverProps {
+    /** Guardrail decisions to list inside the popover */
+    guardrails: LLMGuardrail[];
+    /** Title on the outer card (default: "Guardrails") */
+    title?: string;
+    placement?: PopoverProps["placement"];
+    trigger?: PopoverProps["trigger"];
+    /** Shield icon size in px (width/height) */
+    shieldSize?: number;
+    /** Lucide stroke width (default 2.5; Lucide default is 2) */
+    shieldStrokeWidth?: number;
+    /** Accessible label for the shield control */
+    ariaLabel?: string;
+}
+export declare const GuardrailsPopover: React.FC<GuardrailsPopoverProps>;

package/dist/types/agenthub/components/JudgeAggregateView.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Judge (LLM-as-judge) evaluator view: one card per categorical metric, with
+ * collapsible accordions per category label listing the agent nodes that received
+ * that label. Each node shows a short id (click to open the run in the Session
+ * Details drawer) and an inline toggle to reveal the judge's reasoning when present.
+ */
+import React from "react";
+import type { JudgeMetric } from "../utils/judgeAggregateTree";
+export interface JudgeAggregateViewProps {
+    metrics: JudgeMetric[];
+    /** Opens the run for a judged node. sessionId may be undefined for legacy evaluations. */
+    onAgentNodeClick?: (sessionId: string | undefined, nodeId: string) => void;
+}
+export declare const JudgeAggregateView: React.FC<JudgeAggregateViewProps>;

package/dist/types/agenthub/utils/judgeAggregateTree.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Builds the Judge (categorical) evaluator view model from aggregate_results.
+ *
+ * Shape of the data (see sample.json -> JudgeEvaluator):
+ *  - aggregate_results.roots -> CategoricalAggregate nodes (one per metric) with
+ *    `categories`, `counts`, `most_common_label`, `least_common_label`, and `children`.
+ *  - Each child id resolves (in aggregate_results.nodes) to a Base leaf result whose
+ *    `result_name` is `JudgeResult/<metric>`, `value` is the category label string, and
+ *    `agent_data_id[0]` is the agent node id that was judged.
+ *  - Reasoning lives separately in metric_results as Base results named
+ *    `JudgeReasoning/<metric>`, paired to a node by `agent_data_id[0]` + metric name.
+ */
+import type { EvaluationResultItem, EvaluationAgent } from "../../dto/Evaluation";
+/** A single judged agent node under a category label. */
+export interface JudgeNodeRef {
+    nodeId: string;
+    /** Session that owns the node, when the evaluation carries session context. */
+    sessionId?: string;
+    /** Judge reasoning text for this node + metric, when available. */
+    reasoning?: string;
+}
+/** One category label within a metric, with the nodes that received it. */
+export interface JudgeLabel {
+    labelName: string;
+    count: number;
+    nodes: JudgeNodeRef[];
+}
+/** One categorical metric judged across all runs. */
+export interface JudgeMetric {
+    key: string;
+    metricName: string;
+    description?: string;
+    mostCommon?: string;
+    leastCommon?: string;
+    total: number;
+    labels: JudgeLabel[];
+}
+type NodeMap = Record<string, unknown>;
+type AgentLike = Pick<EvaluationAgent, "agent_name" | "agent_node_ids"> | {
+    agent_name: string;
+    agent_node_ids?: string[] | {
+        session_id: string;
+        agent_node_id: string;
+    }[];
+};
+export interface BuildJudgeMetricsInput {
+    roots: string[];
+    nodes: NodeMap;
+    agents?: AgentLike[];
+    /** Full evaluator results (metric_results + aggregates) used to resolve reasoning. */
+    rawResults?: EvaluationResultItem[];
+}
+/** Build the Judge view model: one entry per categorical metric. */
+export declare function buildJudgeMetricsFromAggregate(input: BuildJudgeMetricsInput): JudgeMetric[];
+export {};

package/dist/types/dto/AgentRunNode.d.ts

@@ -21,6 +21,21 @@ export interface LLMContent {
      * For LLM responses, it can be a string or a json object. */
     content: any;
 }
+/**
+ * Represents a single guardrail decision for an LLM interaction
+ */
+export interface LLMGuardrail {
+    /** Name of the guardrail that produced this decision */
+    rail_name: string;
+    /** Phase of the LLM lifecycle where the guardrail ran */
+    phase: string;
+    /** Decision taken by the guardrail */
+    action: string;
+    /** Human-readable reason for the decision */
+    reason: string | null;
+    /** Optional additional metadata emitted by the guardrail */
+    meta: Record<string, any> | null;
+}
 /**
  * Represents detailed information about an LLM interaction
  */
@@ -57,6 +72,8 @@ export interface NodeLatency {
  * Represents internal execution details for a node
  */
 export interface NodeInternals {
+    /** Optional array of LLM Guardrails */
+    guard_details?: LLMGuardrail[];
     /** Optional array of LLM interaction details */
     llm_details?: LLMDetails[];
     /** Optional latency information for the node execution */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@railtownai/railtracks-visualizer",
-  "version": "0.0.65",
+  "version": "0.0.67",
   "license": "MIT",
   "author": "Railtown AI",
   "description": "A visualizer for Railtracks agentic flows",
@@ -44,13 +44,13 @@
     "@emotion/styled": "11.14.1",
     "@radix-ui/react-dialog": "1.1.15",
     "@railtownai/railtracks-timeline": "0.0.23",
-    "@xyflow/react": "12.10.1",
-    "antd": "6.3.1",
-    "lucide-react": "0.575.0",
+    "@xyflow/react": "12.10.2",
+    "antd": "6.3.6",
+    "lucide-react": "1.8.0",
     "moment": "2.30.1",
     "react-countup": "6.5.3",
     "react-hotkeys-hook": "^4.6.2",
-    "react-router-dom": "7.13.1",
+    "react-router-dom": "7.14.1",
     "react-textarea-autosize": "8.5.9",
     "vaul": "1.1.2"
   },
@@ -74,37 +74,37 @@
     "up": "ncu -u -x react -x react-dom -x @types/react -x @types/react-dom -x react-hotkeys-hook"
   },
   "devDependencies": {
-    "@chromatic-com/storybook": "5.0.1",
-    "@rollup/plugin-commonjs": "29.0.0",
+    "@chromatic-com/storybook": "5.1.2",
+    "@rollup/plugin-commonjs": "29.0.2",
     "@rollup/plugin-json": "6.1.0",
     "@rollup/plugin-node-resolve": "16.0.3",
     "@rollup/plugin-swc": "0.4.0",
-    "@rollup/plugin-terser": "0.4.4",
-    "@storybook/addon-a11y": "10.2.13",
-    "@storybook/addon-docs": "10.2.13",
-    "@storybook/addon-onboarding": "10.2.13",
-    "@storybook/react-vite": "10.2.13",
+    "@rollup/plugin-terser": "1.0.0",
+    "@storybook/addon-a11y": "10.3.5",
+    "@storybook/addon-docs": "10.3.5",
+    "@storybook/addon-onboarding": "10.3.5",
+    "@storybook/react-vite": "10.3.5",
     "@testing-library/jest-dom": "6.9.1",
     "@testing-library/react": "16.3.2",
     "@testing-library/user-event": "14.6.1",
-    "@types/node": "25.3.2",
+    "@types/node": "25.6.0",
     "@types/react": "18.3.27",
     "@types/react-dom": "18.3.7",
-    "@vitejs/plugin-react-swc": "4.2.3",
+    "@vitejs/plugin-react-swc": "4.3.0",
     "clsx": "2.1.1",
     "cross-env": "10.1.0",
     "gh-pages": "6.3.0",
-    "jsdom": "28.1.0",
+    "jsdom": "29.0.2",
     "license-checker": "25.0.1",
-    "npm-check-updates": "19.6.2",
-    "prettier": "3.8.1",
-    "rollup": "4.59.0",
+    "npm-check-updates": "21.0.2",
+    "prettier": "3.8.3",
+    "rollup": "4.60.1",
     "rollup-plugin-postcss": "4.0.2",
-    "storybook": "10.2.13",
-    "typescript": "5.9.3",
+    "storybook": "10.3.5",
+    "typescript": "6.0.3",
     "uuid": "13.0.0",
-    "vite": "7.3.1",
-    "vitest": "4.0.18"
+    "vite": "8.0.8",
+    "vitest": "4.1.4"
   },
   "prettier": {
     "singleQuote": false,

package/dist/types/components/ui/tooltip.d.ts

@@ -1,9 +0,0 @@
-import * as React from "react";
-interface TooltipProps {
-    children: React.ReactNode;
-    content: React.ReactNode;
-    placement?: "top" | "bottom" | "left" | "right" | "topLeft" | "topRight" | "bottomLeft" | "bottomRight" | "leftTop" | "leftBottom" | "rightTop" | "rightBottom";
-    delay?: number;
-}
-export declare const Tooltip: React.FC<TooltipProps>;
-export {};