@railtownai/railtracks-visualizer 0.0.54 → 0.0.56

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

@@ -0,0 +1,33 @@
+/**
+ * Reusable comparison UI for two evaluations. Accepts Evaluation DTOs;
+ * DTO is auto-detected and transformed internally.
+ * Use in page view or drawer.
+ *
+ * @example
+ * ```tsx
+ *       <EvaluationsCompareView
+ *         evaluations={evaluations}
+ *         evaluationId1={id1}
+ *         evaluationId2={id2}
+ *         onEvaluationId1Change={setId1}
+ *         onEvaluationId2Change={setId2}
+ *       />
+ * ```
+ */
+import React from "react";
+import type { Evaluation } from "../pages/evaluations.types";
+import type { Evaluation as EvaluationDto } from "../../dto/Evaluation";
+export interface EvaluationsCompareViewProps {
+    /** Evaluation DTOs from your API. Pre-transformed data is also accepted. */
+    evaluations: (Evaluation | EvaluationDto)[];
+    evaluationId1: string | null;
+    evaluationId2: string | null;
+    onEvaluationId1Change: (id: string | null) => void;
+    onEvaluationId2Change: (id: string | null) => void;
+    loading?: boolean;
+    /** When true, evaluation dropdowns are visible. When false (default), read-only view with no dropdowns or change button. */
+    showEvaluationComparisonDropdowns?: boolean;
+    /** Optional href for back link. When provided, a "Back to Evaluations" link is shown. */
+    backHref?: string;
+}
+export declare const EvaluationsCompareView: React.FC<EvaluationsCompareViewProps>;

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

@@ -14,6 +14,13 @@
 import React from "react";
 import type { Evaluation } from "../pages/evaluations.types";
 import type { Evaluation as EvaluationDto } from "../../dto/Evaluation";
+/** Server-side pagination config. When provided, table uses server pagination instead of client. */
+export interface EvaluationsTablePagination {
+    total: number;
+    current: number;
+    pageSize: number;
+    onPageChange: (page: number, pageSize: number) => void;
+}
 export interface EvaluationsTableProps {
     /** Evaluation DTOs from your API. Pre-transformed data is also accepted. */
     evaluations: (Evaluation | EvaluationDto)[];
@@ -21,11 +28,21 @@ export interface EvaluationsTableProps {
     error?: string | null;
     onRefresh?: () => void;
     onRowClick?: (evaluation: Evaluation) => void;
-    onCompare?: (sourceId: string, targetId: string) => void;
+    onCompare?: (evaluationId1: string, evaluationId2: string) => void;
+    /** When provided, opens the compare drawer with these IDs (e.g. from URL compare param). */
+    compareIdsFromUrl?: [string, string] | null;
+    /** Called when compare selections change (e.g. to update URL). */
+    onCompareUrlChange?: (id1: string | null, id2: string | null) => void;
     showFilters?: boolean;
     showCompare?: boolean;
     emptyMessage?: React.ReactNode;
     /** Optional title rendered to the left of the toolbar (e.g. "Evaluations") */
     title?: React.ReactNode;
+    /** Server-side pagination. When provided, table uses server pagination instead of client. */
+    pagination?: EvaluationsTablePagination;
+    /** When server pagination, filter changes are passed up for platform to refetch. */
+    onFiltersChange?: (agents: string[], metricFilter: string | null) => void;
+    /** When server pagination, fetch evaluations by ID for compare drawer (e.g. from URL). */
+    onFetchEvaluationsByIds?: (ids: string[]) => Promise<(Evaluation | EvaluationDto)[]>;
 }
 export declare const EvaluationsTable: React.FC<EvaluationsTableProps>;

package/dist/types/agenthub/pages/evaluations-compare-drawer.d.ts

@@ -5,14 +5,14 @@
 import React from "react";
 import type { Evaluation } from "./evaluations.types";
 import type { Evaluation as EvaluationDto } from "../../dto/Evaluation";
-export interface EvaluationsCompareProps {
+export interface EvaluationsCompareDrawerProps {
     open: boolean;
     onClose: () => void;
-    sourceEvaluationId: string | null;
-    targetEvaluationId: string | null;
+    evaluationId1: string | null;
+    evaluationId2: string | null;
     /** Evaluation DTOs from your API. Pre-transformed data is also accepted. */
     evaluations: (Evaluation | EvaluationDto)[];
-    onSourceChange: (id: string | null) => void;
-    onTargetChange: (id: string | null) => void;
+    onEvaluationId1Change: (id: string | null) => void;
+    onEvaluationId2Change: (id: string | null) => void;
 }
-export declare const EvaluationsCompare: React.FC<EvaluationsCompareProps>;
+export declare const EvaluationsCompareDrawer: React.FC<EvaluationsCompareDrawerProps>;

package/dist/types/agenthub/pages/evaluations-compare.d.ts

@@ -1,2 +1,6 @@
 import React from "react";
-export declare const EvaluationsComparePage: React.FC;
+export interface EvaluationsComparePageProps {
+    /** Optional href for back link (e.g. "#/evaluations" for HashRouter). */
+    backHref?: string;
+}
+export declare const EvaluationsComparePage: React.FC<EvaluationsComparePageProps>;

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

@@ -0,0 +1,15 @@
+/**
+ * Helper to determine if two evaluations have the same metrics for comparison.
+ * Use before rendering EvaluationsCompareView so the Container app can decide
+ * whether to show the compare UI or display an error.
+ *
+ * Compares metric names across ALL evaluators (LLM, Tool, Judge, etc.).
+ * Supports both Evaluation (page format) and Evaluation DTO (API format).
+ */
+import type { Evaluation } from "../pages/evaluations.types";
+import type { Evaluation as EvaluationDto } from "../../dto/Evaluation";
+/**
+ * Returns true if both evaluations have the same set of metrics
+ * (evaluator_id + metric name) across all evaluators.
+ */
+export declare function evaluationsHaveSameMetrics(a: Evaluation | EvaluationDto | null | undefined, b: Evaluation | EvaluationDto | null | undefined): boolean;

package/dist/types/index.d.ts

@@ -2,13 +2,18 @@ export { default as AgenticFlowVisualizer } from "./components/AgenticFlowVisual
 export { default as Visualizer } from "./components/Visualizer";
 export { SessionDetails } from "./agenthub/pages/session-details";
 export { EvaluationsTable } from "./agenthub/components/EvaluationsTable";
-export { EvaluationsCompare } from "./agenthub/pages/evaluations-compare-drawer";
-export type { EvaluationsCompareProps } from "./agenthub/pages/evaluations-compare-drawer";
+export type { EvaluationsTableProps, EvaluationsTablePagination } from "./agenthub/components/EvaluationsTable";
+export { EvaluationsCompareView } from "./agenthub/components/EvaluationsCompareView";
+export type { EvaluationsCompareViewProps } from "./agenthub/components/EvaluationsCompareView";
+export { EvaluationsCompareDrawer } from "./agenthub/pages/evaluations-compare-drawer";
+export type { EvaluationsCompareDrawerProps } from "./agenthub/pages/evaluations-compare-drawer";
+export { EvaluationsComparePage } from "./agenthub/pages/evaluations-compare";
 export { EvaluationDetailsDrawer } from "./agenthub/pages/evaluation-details-drawer";
 export type { EvaluationDetailsDrawerProps } from "./agenthub/pages/evaluation-details-drawer";
 export { EvaluatorResult } from "./agenthub/pages/evaluator-result";
 export type { EvaluatorResultProps } from "./agenthub/pages/evaluator-result";
 export { transformEvaluation, isEvaluationDto } from "./agenthub/utils/transformEvaluation";
+export { evaluationsHaveSameMetrics } from "./agenthub/utils/evaluationsHaveSameMetrics";
 export type { Evaluation } from "./dto/Evaluation";
 export { Node } from "./components/Node";
 export { Edge } from "./components/Edge";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@railtownai/railtracks-visualizer",
-  "version": "0.0.54",
+  "version": "0.0.56",
   "license": "MIT",
   "author": "Railtown AI",
   "description": "A visualizer for Railtracks agentic flows",