AgentForge

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:4200

InspectorConfig

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);
// RunSummaryData

Types

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 server

Next Steps