@principal-ai/principal-view-core 0.6.4 → 0.7.0

package/dist/narrative/template-renderer.js

@@ -0,0 +1,367 @@
+/**
+ * Template Renderer
+ *
+ * Renders narrative templates into human-readable text using
+ * OTEL events, selected scenarios, and template expressions.
+ */
+import { parseTemplate } from './template-parser';
+import { selectScenario, computeAggregates } from './scenario-matcher';
+/**
+ * Render a narrative from a template and events
+ *
+ * Main entry point for narrative generation.
+ *
+ * @param template - Narrative template
+ * @param events - Collected OTEL events
+ * @returns Rendered narrative
+ */
+export function renderNarrative(template, events) {
+    // Compute aggregates for scenario matching and templates
+    const aggregates = computeAggregates(events);
+    // Select scenario
+    const matchResult = selectScenario(template, events, aggregates);
+    // Build context
+    const context = {
+        template,
+        scenario: matchResult.scenario,
+        events,
+        aggregates,
+        formatting: {
+            indentPerLevel: '  ',
+            timestampFormat: 'HH:mm:ss.SSS',
+            showTimestamps: false,
+            showDuration: true,
+            showSpanIds: false,
+            showAttributes: 'matched',
+            ...template.formatting,
+        },
+    };
+    // Build span tree if needed
+    if (template.mode === 'span-tree') {
+        context.spanTree = buildSpanTree(events, template.showLogsPerSpan);
+    }
+    // Render narrative
+    const text = renderScenario(context);
+    // Build metadata
+    const spans = events.filter((e) => e.type === 'span');
+    const logs = events.filter((e) => e.type === 'log');
+    const timestamps = events.map((e) => normalizeTimestamp(e.timestamp)).filter((t) => !isNaN(t));
+    return {
+        text,
+        scenarioId: matchResult.scenario.id,
+        metadata: {
+            eventCount: events.length,
+            spanCount: spans.length,
+            logCount: logs.length,
+            timeRange: timestamps.length > 0
+                ? {
+                    start: Math.min(...timestamps),
+                    end: Math.max(...timestamps),
+                }
+                : undefined,
+        },
+    };
+}
+/**
+ * Render a scenario template
+ *
+ * @param context - Narrative context
+ * @returns Rendered text
+ */
+function renderScenario(context) {
+    const { scenario, template, events, aggregates, formatting } = context;
+    const parts = [];
+    // Create template evaluation context (merge aggregates and events)
+    const evalContext = {
+        ...aggregates,
+        events,
+        totalEvents: events.length,
+    };
+    // Introduction
+    if (scenario.template.introduction) {
+        parts.push(parseTemplate(scenario.template.introduction, evalContext));
+        parts.push(''); // Blank line
+    }
+    // Main content based on mode
+    switch (template.mode) {
+        case 'span-tree':
+            if (context.spanTree) {
+                parts.push(renderSpanTree(context.spanTree, scenario, evalContext, formatting));
+            }
+            break;
+        case 'timeline':
+            parts.push(renderTimeline(events, scenario, evalContext, formatting));
+            break;
+        case 'summary-only':
+            // Only introduction and summary, no event details
+            break;
+    }
+    // Flow directives
+    if (scenario.template.flow) {
+        parts.push(renderFlow(scenario.template.flow, evalContext));
+    }
+    // Summary
+    if (scenario.template.summary) {
+        if (parts.length > 0) {
+            parts.push(''); // Blank line before summary
+        }
+        parts.push(parseTemplate(scenario.template.summary, evalContext));
+    }
+    return parts.join('\n');
+}
+/**
+ * Render span tree (hierarchical view)
+ *
+ * @param tree - Span tree nodes
+ * @param scenario - Scenario being rendered
+ * @param context - Evaluation context
+ * @param formatting - Formatting options
+ * @returns Rendered tree text
+ */
+function renderSpanTree(tree, scenario, context, formatting) {
+    const parts = [];
+    for (const node of tree) {
+        const indent = (formatting.indentPerLevel || '  ').repeat(node.depth);
+        const eventContext = { ...context, ...node.span.attributes, span: node.span };
+        // Render span
+        if (scenario.template.span) {
+            const spanText = parseTemplate(scenario.template.span, eventContext);
+            parts.push(indent + spanText);
+        }
+        else if (scenario.template.events?.[node.span.name]) {
+            const eventTemplate = scenario.template.events[node.span.name];
+            const eventText = parseTemplate(eventTemplate, eventContext);
+            parts.push(indent + eventText);
+        }
+        else {
+            // Default span rendering
+            parts.push(indent + `→ ${node.span.name}`);
+        }
+        // Render associated logs
+        if (node.logs && node.logs.length > 0) {
+            for (const log of node.logs) {
+                const logContext = { ...context, log };
+                const logText = renderLog(log, scenario, logContext, formatting);
+                if (logText) {
+                    parts.push(indent + (formatting.indentPerLevel || '  ') + logText);
+                }
+            }
+        }
+        // Render children
+        if (node.children.length > 0 && scenario.template.children !== 'ignore') {
+            parts.push(renderSpanTree(node.children, scenario, context, formatting));
+        }
+    }
+    return parts.join('\n');
+}
+/**
+ * Render timeline (chronological view)
+ *
+ * @param events - Events in chronological order
+ * @param scenario - Scenario being rendered
+ * @param context - Evaluation context
+ * @param formatting - Formatting options
+ * @returns Rendered timeline text
+ */
+function renderTimeline(events, scenario, context, formatting) {
+    const parts = [];
+    // Sort events by timestamp
+    const sorted = [...events].sort((a, b) => {
+        const aTime = normalizeTimestamp(a.timestamp);
+        const bTime = normalizeTimestamp(b.timestamp);
+        return aTime - bTime;
+    });
+    for (const event of sorted) {
+        const eventContext = { ...context, ...event.attributes };
+        let eventText;
+        if (event.type === 'log') {
+            eventText = renderLog(event, scenario, { ...eventContext, log: event }, formatting);
+        }
+        else if (scenario.template.events?.[event.name]) {
+            eventText = parseTemplate(scenario.template.events[event.name], eventContext);
+        }
+        if (eventText) {
+            if (formatting.showTimestamps) {
+                const timestamp = formatTimestamp(event.timestamp, formatting.timestampFormat || 'HH:mm:ss.SSS');
+                parts.push(`[${timestamp}] ${eventText}`);
+            }
+            else {
+                parts.push(eventText);
+            }
+        }
+    }
+    return parts.join('\n');
+}
+/**
+ * Render a log event
+ *
+ * @param log - Log event
+ * @param scenario - Scenario being rendered
+ * @param context - Evaluation context
+ * @param formatting - Formatting options
+ * @returns Rendered log text
+ */
+function renderLog(log, scenario, context, formatting) {
+    // Check for severity-specific template
+    if (scenario.template.logs) {
+        const severity = getSeverityLevel(log.severityNumber);
+        const logTemplate = scenario.template.logs[severity] || scenario.template.logs.default;
+        if (logTemplate) {
+            return parseTemplate(logTemplate, context);
+        }
+    }
+    // Check for event-specific template
+    if (scenario.template.events?.[`log.${log.severityText?.toLowerCase()}`]) {
+        return parseTemplate(scenario.template.events[`log.${log.severityText?.toLowerCase()}`], context);
+    }
+    // Default log rendering
+    return `[${log.severityText || 'LOG'}] ${log.body}`;
+}
+/**
+ * Get severity level name from severity number
+ *
+ * @param severityNumber - OTEL severity number (1-24)
+ * @returns Severity level name
+ */
+function getSeverityLevel(severityNumber) {
+    if (!severityNumber)
+        return 'info';
+    if (severityNumber >= 21)
+        return 'fatal';
+    if (severityNumber >= 17)
+        return 'error';
+    if (severityNumber >= 13)
+        return 'warn';
+    if (severityNumber >= 9)
+        return 'info';
+    if (severityNumber >= 5)
+        return 'debug';
+    return 'trace';
+}
+/**
+ * Render flow directives
+ *
+ * @param flow - Flow directives
+ * @param context - Evaluation context
+ * @returns Rendered flow text
+ */
+function renderFlow(flow, context) {
+    const parts = [];
+    for (const item of flow) {
+        if (typeof item === 'string') {
+            // Simple string template
+            parts.push(parseTemplate(item, context));
+        }
+        else {
+            // Flow directive
+            if (item.forEach && item.template) {
+                // Iteration
+                const collection = context[item.forEach];
+                if (Array.isArray(collection)) {
+                    for (let i = 0; i < collection.length; i++) {
+                        const collectionItem = collection[i];
+                        const itemContext = {
+                            ...context,
+                            ...(typeof collectionItem === 'object' && collectionItem !== null ? collectionItem : {}),
+                            index: i,
+                        };
+                        parts.push(parseTemplate(item.template, itemContext));
+                    }
+                }
+            }
+            else if (item.if) {
+                // Conditional
+                const condition = parseTemplate(item.if, context);
+                if (condition === 'true' || condition === '1') {
+                    if (item.then) {
+                        parts.push(parseTemplate(item.then, context));
+                    }
+                }
+                else {
+                    if (item.else) {
+                        parts.push(parseTemplate(item.else, context));
+                    }
+                }
+            }
+        }
+    }
+    return parts.join('\n');
+}
+/**
+ * Build span tree from events
+ *
+ * @param events - All events
+ * @param includeLogsPerSpan - Whether to attach logs to spans
+ * @returns Span tree
+ */
+function buildSpanTree(events, includeLogsPerSpan = false) {
+    const spans = events.filter((e) => e.type === 'span');
+    const logs = includeLogsPerSpan ? events.filter((e) => e.type === 'log') : [];
+    // Build map of spans by ID
+    const spanMap = new Map();
+    for (const span of spans) {
+        if (span.spanId) {
+            spanMap.set(span.spanId, {
+                span,
+                children: [],
+                logs: [],
+                depth: 0,
+            });
+        }
+    }
+    // Attach logs to spans
+    if (includeLogsPerSpan) {
+        for (const log of logs) {
+            if (log.spanId && spanMap.has(log.spanId)) {
+                spanMap.get(log.spanId).logs.push(log);
+            }
+        }
+    }
+    // Build tree structure
+    const roots = [];
+    for (const node of spanMap.values()) {
+        if (node.span.parentSpanId && spanMap.has(node.span.parentSpanId)) {
+            const parent = spanMap.get(node.span.parentSpanId);
+            parent.children.push(node);
+            node.depth = parent.depth + 1;
+        }
+        else {
+            roots.push(node);
+        }
+    }
+    return roots;
+}
+/**
+ * Normalize timestamp to milliseconds
+ *
+ * @param timestamp - Timestamp (number or ISO string)
+ * @returns Milliseconds since epoch
+ */
+function normalizeTimestamp(timestamp) {
+    if (typeof timestamp === 'number') {
+        // Assume milliseconds if < 10^12, otherwise nanoseconds
+        return timestamp < 1e12 ? timestamp : timestamp / 1e6;
+    }
+    return new Date(timestamp).getTime();
+}
+/**
+ * Format timestamp
+ *
+ * @param timestamp - Timestamp to format
+ * @param format - Format string (simplified, only supports HH:mm:ss.SSS)
+ * @returns Formatted timestamp
+ */
+function formatTimestamp(timestamp, format) {
+    const ms = normalizeTimestamp(timestamp);
+    const date = new Date(ms);
+    if (format === 'HH:mm:ss.SSS') {
+        const hours = String(date.getHours()).padStart(2, '0');
+        const minutes = String(date.getMinutes()).padStart(2, '0');
+        const seconds = String(date.getSeconds()).padStart(2, '0');
+        const milliseconds = String(date.getMilliseconds()).padStart(3, '0');
+        return `${hours}:${minutes}:${seconds}.${milliseconds}`;
+    }
+    // Fallback to ISO string
+    return date.toISOString();
+}
+//# sourceMappingURL=template-renderer.js.map

package/dist/narrative/template-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-renderer.js","sourceRoot":"","sources":["../../src/narrative/template-renderer.ts"],"names":[],"mappings":"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"}

package/dist/narrative/types.d.ts

@@ -0,0 +1,268 @@
+/**
+ * Narrative Template System Types
+ *
+ * Types for transforming OpenTelemetry event streams into human-readable
+ * execution narratives based on OTEL canvas definitions.
+ *
+ * @see docs/NARRATIVE_TEMPLATES_DESIGN.md
+ */
+import type { OtelLog, OtelSpan } from '../types/otel';
+/**
+ * Combined OTEL signal type for narrative processing
+ */
+export type OtelSignal = OtelSpan | OtelLog | OtelEvent;
+/**
+ * Generic OTEL event (spans can also be treated as events)
+ */
+export interface OtelEvent {
+    /** Event name (e.g., "conversion.started", "log.error") */
+    name: string;
+    /** Event timestamp */
+    timestamp: string | number;
+    /** Event type (span, log, metric) */
+    type?: 'span' | 'log' | 'metric';
+    /** Event attributes */
+    attributes?: Record<string, string | number | boolean>;
+    /** Trace correlation */
+    traceId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+    /** For logs: severity information */
+    severityText?: string;
+    severityNumber?: number;
+    /** For logs: message body */
+    body?: string | Record<string, unknown>;
+    /** For spans: duration */
+    duration?: number;
+}
+/**
+ * Narrative template definition
+ *
+ * References an .otel.canvas file and defines how to render
+ * execution events into human-readable narratives.
+ */
+export interface NarrativeTemplate {
+    /** Schema version (e.g., "1.0.0") */
+    version: string;
+    /** Reference to .otel.canvas file */
+    canvas: string;
+    /** Human-readable template name */
+    name: string;
+    /** Purpose of this narrative view */
+    description: string;
+    /** How to structure the narrative */
+    mode: NarrativeMode;
+    /** Scenario selection strategy */
+    scenarioSelection: 'first-match' | 'manual';
+    /** Show logs associated with each span (span-tree mode) */
+    showLogsPerSpan?: boolean;
+    /** Mix spans/logs by timestamp (timeline mode) */
+    interleaveSignals?: boolean;
+    /** Mutually exclusive narrative scenarios */
+    scenarios: NarrativeScenario[];
+    /** Display formatting preferences */
+    formatting?: FormattingOptions;
+}
+/**
+ * Narrative rendering mode
+ */
+export type NarrativeMode = 'span-tree' | 'timeline' | 'summary-only';
+/**
+ * Narrative scenario definition
+ *
+ * Scenarios are mutually exclusive narrative templates selected
+ * based on which events occurred during execution.
+ */
+export interface NarrativeScenario {
+    /** Unique scenario identifier (kebab-case) */
+    id: string;
+    /** Selection priority (lower = higher priority, 1 = highest) */
+    priority: number;
+    /** What this scenario represents */
+    description: string;
+    /** Conditions that must be met for this scenario to match */
+    condition: ScenarioCondition;
+    /** Narrative template content */
+    template: ScenarioTemplate;
+}
+/**
+ * Scenario matching conditions
+ */
+export interface ScenarioCondition {
+    /** Must have these events (supports glob patterns like "*.error") */
+    requires?: string[];
+    /** Must NOT have these events (supports glob patterns) */
+    excludes?: string[];
+    /** Assertions on event attributes */
+    assertions?: Record<string, Assertion>;
+    /** Always matches (use as fallback) */
+    default?: boolean;
+    /** Match if ANY requires condition met (instead of ALL) */
+    any?: boolean;
+}
+/**
+ * Attribute assertion operators
+ */
+export interface Assertion {
+    /** Greater than */
+    $gt?: number;
+    /** Greater than or equal */
+    $gte?: number;
+    /** Less than */
+    $lt?: number;
+    /** Less than or equal */
+    $lte?: number;
+    /** Equal to */
+    $eq?: string | number | boolean;
+    /** Not equal to */
+    $ne?: string | number | boolean;
+    /** Attribute exists/doesn't exist */
+    $exists?: boolean;
+    /** Value in array */
+    $in?: (string | number | boolean)[];
+    /** Value not in array */
+    $nin?: (string | number | boolean)[];
+}
+/**
+ * Scenario template content
+ */
+export interface ScenarioTemplate {
+    /** Opening text */
+    introduction?: string;
+    /** Event/log name -> template mapping */
+    events?: Record<string, string>;
+    /** Optional: separate log templates by severity */
+    logs?: LogTemplates;
+    /** Narrative flow steps */
+    flow?: Array<string | FlowDirective>;
+    /** Closing text */
+    summary?: string;
+    /** For span-tree mode: span rendering template */
+    span?: string;
+    /** For span-tree mode: how to recurse into children */
+    children?: 'recurse' | 'ignore';
+}
+/**
+ * Log templates by severity level
+ */
+export interface LogTemplates {
+    /** Template for TRACE logs (severity 1-4) */
+    trace?: string;
+    /** Template for DEBUG logs (severity 5-8) */
+    debug?: string;
+    /** Template for INFO logs (severity 9-12) */
+    info?: string;
+    /** Template for WARN logs (severity 13-16) */
+    warn?: string;
+    /** Template for ERROR logs (severity 17-20) */
+    error?: string;
+    /** Template for FATAL logs (severity 21-24) */
+    fatal?: string;
+    /** Fallback for any log */
+    default?: string;
+}
+/**
+ * Flow directive for narrative generation
+ */
+export interface FlowDirective {
+    /** Iterate over collection (e.g., "violations", "logs.filter(l => l.severityNumber >= 17)") */
+    forEach?: string;
+    /** Template for each item in iteration */
+    template?: string;
+    /** Conditional expression */
+    if?: string;
+    /** Template if condition true */
+    then?: string;
+    /** Template if condition false */
+    else?: string;
+}
+/**
+ * Formatting options for narrative rendering
+ */
+export interface FormattingOptions {
+    /** Indentation per hierarchy level (default: "  ") */
+    indentPerLevel?: string;
+    /** Timestamp format (default: "HH:mm:ss.SSS") */
+    timestampFormat?: string;
+    /** Show timestamps in output (default: false) */
+    showTimestamps?: boolean;
+    /** Show duration information (default: true) */
+    showDuration?: boolean;
+    /** Show span IDs (useful for debugging) (default: false) */
+    showSpanIds?: boolean;
+    /** Which attributes to show: none, matched (from template), or all (default: 'matched') */
+    showAttributes?: 'none' | 'matched' | 'all';
+}
+/**
+ * Narrative rendering context
+ *
+ * Contains all data needed to render a narrative from events.
+ */
+export interface NarrativeContext {
+    /** The narrative template being used */
+    template: NarrativeTemplate;
+    /** Selected scenario */
+    scenario: NarrativeScenario;
+    /** All collected events */
+    events: OtelEvent[];
+    /** Span tree (for span-tree mode) */
+    spanTree?: SpanTreeNode[];
+    /** Computed aggregate values */
+    aggregates?: Record<string, unknown>;
+    /** Formatting options */
+    formatting: FormattingOptions;
+}
+/**
+ * Span tree node for hierarchical rendering
+ */
+export interface SpanTreeNode {
+    /** The span event */
+    span: OtelEvent;
+    /** Child spans */
+    children: SpanTreeNode[];
+    /** Associated logs (if showLogsPerSpan is true) */
+    logs?: OtelEvent[];
+    /** Depth in tree (for indentation) */
+    depth: number;
+}
+/**
+ * Narrative rendering result
+ */
+export interface NarrativeResult {
+    /** Rendered narrative text */
+    text: string;
+    /** Scenario that was selected */
+    scenarioId: string;
+    /** Metadata about the rendering */
+    metadata: {
+        /** Number of events processed */
+        eventCount: number;
+        /** Number of spans */
+        spanCount: number;
+        /** Number of logs */
+        logCount: number;
+        /** Time range of events */
+        timeRange?: {
+            start: string | number;
+            end: string | number;
+        };
+        /** Any errors encountered during rendering */
+        errors?: string[];
+        /** Any warnings encountered during rendering */
+        warnings?: string[];
+    };
+}
+/**
+ * Scenario matching result
+ */
+export interface ScenarioMatchResult {
+    /** The matched scenario */
+    scenario: NarrativeScenario;
+    /** Whether this was the default/fallback scenario */
+    isDefault: boolean;
+    /** All applicable scenarios (for manual selection UI) */
+    applicableScenarios: NarrativeScenario[];
+    /** Reasons why other scenarios didn't match */
+    matchReasons?: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/narrative/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/narrative/types.ts"],"names":[],"mappings":"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"}

package/dist/narrative/types.js

@@ -0,0 +1,10 @@
+/**
+ * Narrative Template System Types
+ *
+ * Types for transforming OpenTelemetry event streams into human-readable
+ * execution narratives based on OTEL canvas definitions.
+ *
+ * @see docs/NARRATIVE_TEMPLATES_DESIGN.md
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/narrative/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/narrative/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}