@railtownai/railtracks-visualizer 0.0.58 → 0.0.60

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

@@ -13,11 +13,16 @@ export interface AggregateResultsTableProps {
     /** Agents (with agent_node_ids) for LLM inference tree Agent (root) labels. */
     agents?: {
         agent_name: string;
-        agent_node_ids?: string[];
+        agent_node_ids?: string[] | {
+            session_id: string;
+            agent_node_id: string;
+        }[];
     }[];
     /** Title shown above the table. */
     title?: string;
     /** Optional evaluator name hint (e.g. "ToolUseEvaluator") for default title. */
     evaluatorName?: string;
+    /** Called when an Agent/Tool Node row is clicked. sessionId may be undefined when evaluation uses legacy agent_node_ids format. */
+    onAgentNodeClick?: (sessionId: string | undefined, nodeId: string) => void;
 }
 export declare const AggregateResultsTable: React.FC<AggregateResultsTableProps>;

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

@@ -0,0 +1,11 @@
+/**
+ * Renders a Tool Output in a Tree component
+ *
+ */
+import React from "react";
+export interface JsonValueTreeProps {
+    data: unknown;
+    className?: string;
+    maxHeight?: number | string;
+}
+export declare const JsonValueTree: React.FC<JsonValueTreeProps>;

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

@@ -2,6 +2,8 @@ import React from "react";
 import type { AgentRun } from "../../dto/AgentRun";
 import type { AgentRunNode } from "../../dto/AgentRunNode";
 import type { SessionListItem } from "../hooks/useSessions";
+/** Tool/agent failure is carried on the incoming edge's details.status (e.g. Failed), same as flow edges and session I/O. */
+export declare function isNodeFailureFromIncomingEdge(run: AgentRun, nodeId: string): boolean;
 export interface SelectedNodeInfo {
     nodeId: string;
     runId: string;

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

@@ -56,7 +56,10 @@ export interface Evaluation {
     /** Agents in the evaluation (name and node IDs for LLM inference tree) */
     agents: {
         agent_name: string;
-        agent_node_ids?: string[];
+        agent_node_ids?: string[] | {
+            session_id: string;
+            agent_node_id: string;
+        }[];
     }[];
     /** Number of agents in the evaluation */
     agents_count: number;

package/dist/types/agenthub/pages/evaluator-result-page.d.ts

@@ -2,10 +2,15 @@ import React from "react";
 export interface EvaluatorResultPageProps {
     /** Optional href for back link. Pass from the host app (e.g. "#/evaluations" for HashRouter). */
     backHref?: string;
+    /**
+     * Optional handler for Agent/Tool node clicks. sessionId may be undefined when evaluation uses
+     * legacy agent_node_ids format. Default opens a SessionDetails drawer on this page.
+     */
+    onAgentNodeClick?: (sessionId: string | undefined, nodeId: string) => void;
 }
 /**
  * Page that resolves evaluationId and evaluatorId from the route,
  * fetches evaluation data, and renders EvaluatorResult.
- * backHref should be passed from the outer/host app for portability.
+ * backHref and onAgentNodeClick should be passed from the outer/host app for portability.
  */
 export declare const EvaluatorResultPage: React.FC<EvaluatorResultPageProps>;

package/dist/types/agenthub/pages/evaluator-result.d.ts

@@ -11,5 +11,10 @@ export interface EvaluatorResultProps {
     evaluatorId: string;
     /** Optional href for back link. When provided, a "Back to Evaluations" control is shown. */
     backHref?: string;
+    /**
+     * Optional handler for Agent/Tool node clicks. sessionId may be undefined when evaluation
+     * uses legacy agent_node_ids format. When not provided, nodes use default (drawer).
+     */
+    onAgentNodeClick?: (sessionId: string | undefined, nodeId: string) => void;
 }
 export declare const EvaluatorResult: React.FC<EvaluatorResultProps>;

package/dist/types/agenthub/pages/session-details.d.ts

@@ -5,6 +5,12 @@ interface SessionDetailsProps {
     session: SessionListItem | null;
     open: boolean;
     onClose: () => void;
+    /** Optional initial node to select when opening (e.g. from evaluation link). */
+    initialNodeId?: string;
+    /** Optional run containing the node. When omitted, the run is found by searching session.runs. */
+    initialRunId?: string;
+    /** When true, show loading state instead of "No session data available". */
+    loading?: boolean;
 }
 export declare const InputsOutputsComponent: React.FC<{
     run: AgentRun;

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

@@ -33,5 +33,5 @@ export interface EvaluatorResultDerived {
 export declare function deriveEvaluatorResultData(evaluation: Evaluation, evaluatorId: string): EvaluatorResultDerived | null;
 /** Derive agent display name from DTO. */
 export declare function deriveAgentName(evaluation: Evaluation): string;
-/** Derive runs count from DTO (agent_node_ids). */
+/** Derive runs count from DTO (agent_node_ids). Supports both string[] and { session_id, agent_node_id }[]. */
 export declare function deriveRunsCount(evaluation: Evaluation): number;

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

@@ -2,13 +2,17 @@
  * Transforms LLMInferenceEvaluator aggregate_results (roots + nodes) into a tree
  * structure for table rendering. Builds hierarchy: Agent (root) -> llm call -> agent node id.
  */
+type AgentNodeIdEntry = string | {
+    session_id: string;
+    agent_node_id: string;
+};
 export type LLMAggregateResultsInput = {
     roots: string[];
     nodes: Record<string, unknown>;
-    /** Optional agents for Agent (root) labels; agent_node_ids map agent_data_id to agent */
+    /** Optional agents for Agent (root) labels; agent_node_ids can be string[] or { session_id, agent_node_id }[] */
     agents?: {
         agent_name: string;
-        agent_node_ids?: string[];
+        agent_node_ids?: AgentNodeIdEntry[];
     }[];
 };
 export interface LLMInferenceTreeRow {
@@ -26,6 +30,8 @@ export interface LLMInferenceTreeRow {
     value?: number;
     /** Leaf agent node id */
     agentNodeId?: string;
+    /** Session id for linking to session-details (when agent_node_ids use new format) */
+    sessionId?: string;
     children?: LLMInferenceTreeRow[];
 }
 /**
@@ -34,3 +40,4 @@ export interface LLMInferenceTreeRow {
  * Each row has metric values (InputTokens, OutputTokens, TotalCost, Latency) as columns.
  */
 export declare function buildLLMInferenceTreeFromAggregateResults(agg: LLMAggregateResultsInput): LLMInferenceTreeRow[];
+export {};

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

@@ -3,9 +3,18 @@
  * into a tree structure for table rendering. Builds hierarchy: tool → agent → invocation.
  */
 import type { EvaluationResultItem } from "../../dto/Evaluation";
+type AgentNodeIdEntry = string | {
+    session_id: string;
+    agent_node_id: string;
+};
 export type ToolUseAggregateResultsInput = {
     roots: string[];
     nodes: Record<string, unknown>;
+    /** Optional agents for session deep-linking; agent_node_ids can be string[] or { session_id, agent_node_id }[] */
+    agents?: {
+        agent_name: string;
+        agent_node_ids?: AgentNodeIdEntry[];
+    }[];
 };
 export interface ToolUseTreeRow {
     key: string;
@@ -14,6 +23,10 @@ export interface ToolUseTreeRow {
     runtimeMs?: number;
     failureRate?: string | "Success" | "Failed";
     level: 1 | 2 | 3;
+    /** Session id for deep-linking to session drawer (level 2–3) */
+    sessionId?: string;
+    /** Node id to select in SessionTree (agent_node_id for level 2, tool_node_id for level 3) */
+    nodeId?: string;
     children?: ToolUseTreeRow[];
 }
 /**
@@ -25,4 +38,8 @@ export declare function buildToolUseTreeFromAggregate(agg: ToolUseAggregateResul
  * Builds a tree from raw ToolUseEvaluator results (legacy flat format).
  * Structure: tool (level 1) → agent (level 2) → invocation (level 3).
  */
-export declare function buildToolUseTreeFromRawResults(rawResults: EvaluationResultItem[]): ToolUseTreeRow[];
+export declare function buildToolUseTreeFromRawResults(rawResults: EvaluationResultItem[], agents?: {
+    agent_name: string;
+    agent_node_ids?: AgentNodeIdEntry[];
+}[]): ToolUseTreeRow[];
+export {};

package/dist/types/components/Edge.d.ts

@@ -8,6 +8,8 @@ interface EdgeProps {
     targetY: number;
     sourcePosition: any;
     targetPosition: any;
+    /** React Flow sets this for animated edges; used for active-step stroke color without rebuilding edge data on theme change */
+    animated?: boolean;
     style?: React.CSSProperties;
     markerEnd?: string;
     bidirectional?: boolean;

package/dist/types/components/Node.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-type NodeType = "Tool" | "Agent" | "Coordinator";
+type NodeType = "Tool" | "Agent";
 interface NodeData {
     label: string;
     nodeType?: NodeType;

package/dist/types/components/nodes/AgentNode.d.ts

@@ -2,7 +2,7 @@ import React from "react";
 import { LLMDetails, NodeDetails } from "../../dto/AgentRunNode";
 interface NodeData {
     label: string;
-    nodeType?: "Tool" | "Agent" | "Coordinator";
+    nodeType?: "Tool" | "Agent";
     details?: NodeDetails;
     id?: string;
     edges?: any[];
@@ -21,7 +21,7 @@ interface AgentNodeProps {
     defaultDrawerOpen?: boolean;
 }
 export interface GetNodeIconOptions {
-    nodeType?: "tool" | "coordinator" | "agent";
+    nodeType?: "tool" | "agent";
     modelProvider?: string;
     modelName?: string;
     size?: number;

package/dist/types/components/nodes/NodeDetailsDrawer.d.ts

@@ -1,7 +1,7 @@
 import React from "react";
 interface NodeData {
     label: string;
-    nodeType?: "Tool" | "Agent" | "Coordinator";
+    nodeType?: "Tool" | "Agent";
     details?: any;
     id?: string;
     edges?: any[];
@@ -18,5 +18,7 @@ interface NodeDetailsDrawerProps {
     onClose: () => void;
     nodeData: NodeData;
 }
+/** Merged tool internals + first edge detail (same shape ToolNode used on-canvas). */
+export declare function buildToolDrawerPayload(nodeData: NodeData): Record<string, unknown> | null;
 export declare const NodeDetailsDrawer: React.FC<NodeDetailsDrawerProps>;
 export {};

package/dist/types/components/nodes/ToolNode.d.ts

@@ -5,7 +5,7 @@ interface Edge {
 }
 interface NodeData {
     label: string;
-    nodeType?: "Tool" | "Agent" | "Coordinator";
+    nodeType?: "Tool" | "Agent";
     details?: any;
     id?: string;
     edges?: Edge[];

package/dist/types/components/nodes/constants.d.ts

@@ -1 +1,7 @@
+/** Max width for rich content (drawer output blocks, etc.) */
 export declare const NODE_MAX_WIDTH = 500;
+/** Compact xyflow node card width range */
+export declare const FLOW_NODE_MIN_WIDTH = 176;
+export declare const FLOW_NODE_MAX_WIDTH = 250;
+/** Used by auto-layout horizontal spacing (~typical card width between min and max) */
+export declare const LAYOUT_NODE_WIDTH: number;

package/dist/types/components/nodes/index.d.ts

@@ -1,5 +1,4 @@
 export { AgentNode } from "./AgentNode";
-export { CoordinatorNode } from "./CoordinatorNode";
 export { ToolNode } from "./ToolNode";
 export { NodeDetailsDrawer } from "./NodeDetailsDrawer";
 export { ExpandableTextarea } from "./ExpandableTextarea";

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

@@ -80,7 +80,7 @@ export interface NodeDetails {
 export interface AgentRunNode {
     /** Unique identifier for this node */
     identifier: string;
-    /** Type of node (e.g., "Tool", "Agent", "Coordinator") */
+    /** Type of node (e.g., "Tool", "Agent") */
     node_type: string;
     /** Optional human-readable name for this node */
     name?: string;

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

@@ -141,10 +141,16 @@ export type EvaluationEvaluatorResult = {
     /** Aggregate tree (roots + nodes with ToolAggregate, LLMInferenceAggregate, CategoricalAggregate) */
     aggregate_results?: EvaluationAggregateResults;
 };
+/** New format: agent node with session context */
+export type EvaluationAgentNodeEntry = {
+    session_id: string;
+    agent_node_id: string;
+};
 /** Agent entry in the evaluation (each has name and associated node IDs) */
 export type EvaluationAgent = {
     agent_name: string;
-    agent_node_ids: string[];
+    /** Legacy: flat list of node IDs. New: list of { session_id, agent_node_id } */
+    agent_node_ids: string[] | EvaluationAgentNodeEntry[];
 };
 /** Root evaluation document */
 export type Evaluation = {

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

@@ -51,6 +51,18 @@ export declare function formatDateFriendly(iso: string): string;
  * @returns The truncated text
  */
 export declare function truncateText(text: string, maxLength: number): string;
+/**
+ * True for plain object literals (own enumerable keys, not arrays, Date, etc.).
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Escapes `\` and `.` in a segment so dot-delimited path keys stay unambiguous (e.g. JSON tree UIs).
+ */
+export declare function escapeDotPathSegment(segment: string): string;
+/**
+ * Compact JSON-like string for tree / debug views: strings use JSON quoting; null and undefined as words.
+ */
+export declare function formatJsonTreePrimitive(value: unknown): string;
 /**
  * Styled-components utility for conditional styling
  * @param condition - The condition to check

package/package.json

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

package/dist/types/components/nodes/CoordinatorNode.d.ts

@@ -1,22 +0,0 @@
-import React from "react";
-interface NodeData {
-    label: string;
-    nodeType?: "Tool" | "Agent" | "Coordinator";
-    details?: any;
-    id?: string;
-    edges?: any[];
-    edgeDetails?: {
-        input_args?: any[];
-        input_kwargs?: any;
-        output?: any;
-        state?: string;
-        status?: string;
-    }[];
-}
-interface CoordinatorNodeProps {
-    data: NodeData;
-    id: string;
-    onInspect?: (nodeData: NodeData) => void;
-}
-export declare const CoordinatorNode: React.FC<CoordinatorNodeProps>;
-export {};