Inspector
Visual debugging UI for exploring agent runs — timeline, decision tree, and run summary.
InspectorServer
import { InspectorServer } from '@ahzan-agentforge/core';
const inspector = new InspectorServer({
port: 4200,
});
await inspector.start();
// Visit http://localhost:4200InspectorConfig
interface InspectorConfig {
port?: number; // Default: 4200
host?: string; // Default: 'localhost'
}InspectorEvent
interface InspectorEvent {
// Events streamed to the inspector UI
}Visualization Utilities
buildTimeline
import { buildTimeline } from '@ahzan-agentforge/core';
const timeline = buildTimeline(runState);
// TimelineData with TimelineStep[]buildDecisionTree
import { buildDecisionTree } from '@ahzan-agentforge/core';
const tree = buildDecisionTree(runState);
// DecisionTree with TreeNode[] and TreeEdge[]buildRunSummary
import { buildRunSummary } from '@ahzan-agentforge/core';
const summary = buildRunSummary(runState);
// RunSummaryDataTypes
interface TimelineData { steps: TimelineStep[] }
interface TimelineStep { /* step visualization data */ }
interface DecisionTree { nodes: TreeNode[]; edges: TreeEdge[] }
interface TreeNode { id: string; label: string; type: string }
interface TreeEdge { from: string; to: string }
interface RunSummaryData { /* aggregated run data */ }CLI Access
agentforge inspector
# Starts the inspector serverNext Steps
- CLI Inspector — CLI command
- OpenTelemetry — metric export