The Explanation Agent translates validated anomalies into clear, neutral, user-facing explanations. It uses only observational language, references underlying data, and includes visual references for charts, timelines, and comparisons. No psychological interpretation or moral judgment.
Neutral language enforcement
Observational phrasing only
Data-backed statements
Visual reference generation
Confidence level inclusion
Message range references
Bar charts (message counts, response times)
Line charts (activity trends, intensity)
Timelines (message distribution, gaps)
Comparisons (before/after changes)
Metrics (ratios, durations, counts)
Tables (detailed breakdowns)
const ExplanationAgent = require('./explanation-agent.js');
// Initialize with validated anomalies
const explainer = new ExplanationAgent(validatedAnomalies);
// Generate explanations
const insights = explainer.generateExplanations();
// Output format
{
"insights": [
{
"summary": "Messages from Alice show increased frequency from day 5 onward, with an average of 8.5 messages per day compared to 4.2 messages per day in the initial period.",
"related_message_range": "45-120",
"confidence_level": 0.88,
"visual_references": [
{
"type": "line_chart",
"title": "Message Frequency Over Time"
}
]
}
]
}Endpoint
/api/generate-explanations
Test Coverage
14/14 tests passing (100%)
Package Size
11 KB
Processing Speed
Instant generation