@railtownai/railtracks-visualizer 0.0.66 → 0.0.68

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/hooks/useApi.d.ts

@@ -1,5 +1,6 @@
 import { AgentSession } from "../dto/AgentSession";
-export declare const API_BASE = "/api";
+import { API_BASE } from "../lib/apiBase";
+export { API_BASE };
 export interface JsonFile {
     name: string;
     size?: number;

package/dist/types/lib/ThemeProvider.d.ts

@@ -1,9 +1,20 @@
 import React, { ReactNode } from "react";
 import { Theme } from "./theme";
+export type ThemeMode = "light" | "dark" | "liquidGlassLight" | "liquidGlassDark";
+export declare function themeForMode(mode: ThemeMode): Theme;
+export declare function themeToMode(theme: Theme): ThemeMode;
 interface ThemeContextType {
     theme: Theme;
+    themeMode: ThemeMode;
     setTheme: (theme: Theme) => void;
+    setThemeMode: (mode: ThemeMode) => void;
+    /** True for classic dark or dark liquid glass (graphs, muted text). */
     isDarkMode: boolean;
+    /** True only for solid classic dark — heavy Ant Design chrome overrides. */
+    isClassicDarkTheme: boolean;
+    isLiquidGlass: boolean;
+    isLiquidGlassLight: boolean;
+    isLiquidGlassDark: boolean;
 }
 interface ThemeProviderProps {
     children: ReactNode;

package/dist/types/lib/apiBase.d.ts

@@ -0,0 +1 @@
+export declare const API_BASE: string;

package/dist/types/lib/theme.d.ts

@@ -92,5 +92,9 @@ export interface Theme {
     };
 }
 export declare const lightTheme: Theme;
+/** Light “Liquid Glass”–inspired palette (web approximation). */
+export declare const liquidGlassLightTheme: Theme;
+/** Dark “Liquid Glass”–inspired palette — translucent panels on a deep mesh-like base. */
+export declare const liquidGlassDarkTheme: Theme;
 export declare const darkTheme: Theme;
 export declare const defaultTheme: Theme;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@railtownai/railtracks-visualizer",
-  "version": "0.0.66",
+  "version": "0.0.68",
   "license": "MIT",
   "author": "Railtown AI",
   "description": "A visualizer for Railtracks agentic flows",
@@ -71,7 +71,10 @@
     "storybook:preview": "npx http-server ./storybook-static",
     "test:ui": "vitest --ui",
     "test": "vitest run --silent",
-    "up": "ncu -u -x react -x react-dom -x @types/react -x @types/react-dom -x react-hotkeys-hook"
+    "up": "ncu -u -x react -x react-dom -x @types/react -x @types/react-dom -x react-hotkeys-hook",
+    "electron": "npm run electron:start",
+    "electron:dev": "cross-env ELECTRON_DEV=1 VITE_API_ORIGIN=http://localhost:3030 concurrently -k \"vite\" \"wait-on http://127.0.0.1:3001 && electron electron/main.js\"",
+    "electron:start": "cross-env VITE_API_ORIGIN=http://localhost:3030 npm run build:spa && electron electron/main.js"
   },
   "devDependencies": {
     "@chromatic-com/storybook": "5.1.2",
@@ -92,7 +95,9 @@
     "@types/react-dom": "18.3.7",
     "@vitejs/plugin-react-swc": "4.3.0",
     "clsx": "2.1.1",
+    "concurrently": "9.2.1",
     "cross-env": "10.1.0",
+    "electron": "34.5.8",
     "gh-pages": "6.3.0",
     "jsdom": "29.0.2",
     "license-checker": "25.0.1",
@@ -104,7 +109,8 @@
     "typescript": "6.0.3",
     "uuid": "13.0.0",
     "vite": "8.0.8",
-    "vitest": "4.1.4"
+    "vitest": "4.1.4",
+    "wait-on": "8.0.5"
   },
   "prettier": {
     "singleQuote": false,