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

package/dist/narrative/example.js

@@ -0,0 +1,331 @@
+/**
+ * Example: Using the Narrative Template System
+ *
+ * This example demonstrates how to use the narrative renderer
+ * to transform OTEL events into human-readable narratives.
+ */
+import { renderNarrative } from './template-renderer';
+// Example 1: Simple Success Scenario
+function exampleSuccess() {
+    const template = {
+        version: '1.0.0',
+        canvas: 'example.otel.canvas',
+        name: 'Example Execution',
+        description: 'Simple execution narrative',
+        mode: 'span-tree',
+        scenarioSelection: 'first-match',
+        showLogsPerSpan: true,
+        scenarios: [
+            {
+                id: 'success',
+                priority: 1,
+                description: 'Successful execution',
+                condition: {
+                    requires: ['execution.complete'],
+                    assertions: { 'result.status': { $eq: 'success' } },
+                },
+                template: {
+                    introduction: '✅ Execution Successful\n{"━".repeat(50)}',
+                    span: '→ {span.name}',
+                    children: 'recurse',
+                    events: {
+                        'execution.started': '  🔄 Starting execution',
+                        'execution.complete': '  ✅ Completed in {duration.ms}ms with {result.count} items',
+                    },
+                    logs: {
+                        info: '    ℹ️  {log.body}',
+                        debug: '    🔍 {log.body}',
+                    },
+                    summary: '{"━".repeat(50)}\n\n✅ SUCCESS\n\nProcessed {result.count} items in {duration.ms}ms',
+                },
+            },
+        ],
+    };
+    const events = [
+        {
+            name: 'execution.started',
+            timestamp: 1000,
+            type: 'span',
+            spanId: 'span1',
+            traceId: 'trace1',
+        },
+        {
+            name: 'log.info',
+            timestamp: 1100,
+            type: 'log',
+            spanId: 'span1',
+            traceId: 'trace1',
+            severityText: 'INFO',
+            severityNumber: 9,
+            body: 'Processing items...',
+        },
+        {
+            name: 'execution.complete',
+            timestamp: 2000,
+            type: 'span',
+            spanId: 'span1',
+            traceId: 'trace1',
+            attributes: {
+                'result.status': 'success',
+                'result.count': 42,
+                'duration.ms': 1000,
+            },
+        },
+    ];
+    const result = renderNarrative(template, events);
+    console.log('=== Example 1: Success Scenario ===\n');
+    console.log(result.text);
+    console.log('\nMetadata:', result.metadata);
+    console.log('\n');
+}
+// Example 2: Multi-scenario with Violations
+function exampleWithViolations() {
+    const template = {
+        version: '1.0.0',
+        canvas: 'validation.otel.canvas',
+        name: 'Validation Execution',
+        description: 'Validation with multiple scenarios',
+        mode: 'span-tree',
+        scenarioSelection: 'first-match',
+        scenarios: [
+            {
+                id: 'errors',
+                priority: 1,
+                description: 'Has error-level violations',
+                condition: {
+                    requires: ['validation.complete'],
+                    assertions: { 'result.errors': { $gt: 0 } },
+                },
+                template: {
+                    introduction: '❌ Validation Failed\n{"━".repeat(50)}',
+                    span: '→ {span.name}',
+                    children: 'recurse',
+                    events: {
+                        'validation.started': '  🔍 Validating configuration',
+                        'validation.complete': '  ❌ Found {result.errors} errors and {result.warnings} warnings',
+                    },
+                    summary: '{"━".repeat(50)}\n\n❌ FAILED\n\nErrors: {result.errors}\nWarnings: {result.warnings}',
+                },
+            },
+            {
+                id: 'warnings',
+                priority: 2,
+                description: 'Has warnings only',
+                condition: {
+                    requires: ['validation.complete'],
+                    assertions: {
+                        'result.errors': { $eq: 0 },
+                        'result.warnings': { $gt: 0 },
+                    },
+                },
+                template: {
+                    introduction: '⚠️  Validation Passed with Warnings\n{"━".repeat(50)}',
+                    span: '→ {span.name}',
+                    children: 'recurse',
+                    events: {
+                        'validation.started': '  🔍 Validating configuration',
+                        'validation.complete': '  ⚠️  Found {result.warnings} warnings',
+                    },
+                    summary: '{"━".repeat(50)}\n\n⚠️  PASSED WITH WARNINGS\n\nWarnings: {result.warnings}',
+                },
+            },
+            {
+                id: 'success',
+                priority: 3,
+                description: 'All checks passed',
+                condition: {
+                    requires: ['validation.complete'],
+                    assertions: {
+                        'result.errors': { $eq: 0 },
+                        'result.warnings': { $eq: 0 },
+                    },
+                },
+                template: {
+                    introduction: '✅ Validation Passed\n{"━".repeat(50)}',
+                    span: '→ {span.name}',
+                    children: 'recurse',
+                    events: {
+                        'validation.started': '  🔍 Validating configuration',
+                        'validation.complete': '  ✅ All checks passed',
+                    },
+                    summary: '{"━".repeat(50)}\n\n✅ SUCCESS\n\nNo violations found.',
+                },
+            },
+        ],
+    };
+    // Scenario 1: Errors
+    const eventsWithErrors = [
+        {
+            name: 'validation.started',
+            timestamp: 1000,
+            type: 'span',
+            spanId: 'span1',
+            traceId: 'trace1',
+        },
+        {
+            name: 'validation.complete',
+            timestamp: 2000,
+            type: 'span',
+            spanId: 'span1',
+            traceId: 'trace1',
+            attributes: {
+                'result.errors': 3,
+                'result.warnings': 2,
+            },
+        },
+    ];
+    console.log('=== Example 2a: Validation with Errors ===\n');
+    const result1 = renderNarrative(template, eventsWithErrors);
+    console.log(result1.text);
+    console.log('\nSelected scenario:', result1.scenarioId);
+    console.log('\n');
+    // Scenario 2: Warnings only
+    const eventsWithWarnings = [
+        {
+            name: 'validation.started',
+            timestamp: 1000,
+            type: 'span',
+            spanId: 'span1',
+            traceId: 'trace1',
+        },
+        {
+            name: 'validation.complete',
+            timestamp: 2000,
+            type: 'span',
+            spanId: 'span1',
+            traceId: 'trace1',
+            attributes: {
+                'result.errors': 0,
+                'result.warnings': 5,
+            },
+        },
+    ];
+    console.log('=== Example 2b: Validation with Warnings ===\n');
+    const result2 = renderNarrative(template, eventsWithWarnings);
+    console.log(result2.text);
+    console.log('\nSelected scenario:', result2.scenarioId);
+    console.log('\n');
+    // Scenario 3: Success
+    const eventsSuccess = [
+        {
+            name: 'validation.started',
+            timestamp: 1000,
+            type: 'span',
+            spanId: 'span1',
+            traceId: 'trace1',
+        },
+        {
+            name: 'validation.complete',
+            timestamp: 2000,
+            type: 'span',
+            spanId: 'span1',
+            traceId: 'trace1',
+            attributes: {
+                'result.errors': 0,
+                'result.warnings': 0,
+            },
+        },
+    ];
+    console.log('=== Example 2c: Validation Success ===\n');
+    const result3 = renderNarrative(template, eventsSuccess);
+    console.log(result3.text);
+    console.log('\nSelected scenario:', result3.scenarioId);
+    console.log('\n');
+}
+// Example 3: Span Tree with Hierarchy
+function exampleSpanTree() {
+    const template = {
+        version: '1.0.0',
+        canvas: 'hierarchy.otel.canvas',
+        name: 'Hierarchical Execution',
+        description: 'Demonstrates span tree rendering',
+        mode: 'span-tree',
+        scenarioSelection: 'first-match',
+        showLogsPerSpan: true,
+        scenarios: [
+            {
+                id: 'default',
+                priority: 1,
+                description: 'Default',
+                condition: { default: true },
+                template: {
+                    introduction: '📋 Execution Trace\n{"━".repeat(50)}',
+                    span: '→ {span.name}',
+                    children: 'recurse',
+                    logs: {
+                        info: '  ℹ️  {log.body}',
+                        error: '  ❌ {log.body}',
+                    },
+                    summary: '{"━".repeat(50)}\nComplete',
+                },
+            },
+        ],
+    };
+    const events = [
+        {
+            name: 'root.operation',
+            timestamp: 1000,
+            type: 'span',
+            spanId: 'span1',
+            traceId: 'trace1',
+        },
+        {
+            name: 'log.info',
+            timestamp: 1100,
+            type: 'log',
+            spanId: 'span1',
+            traceId: 'trace1',
+            severityText: 'INFO',
+            severityNumber: 9,
+            body: 'Root operation started',
+        },
+        {
+            name: 'child.operation',
+            timestamp: 1200,
+            type: 'span',
+            spanId: 'span2',
+            parentSpanId: 'span1',
+            traceId: 'trace1',
+        },
+        {
+            name: 'log.info',
+            timestamp: 1300,
+            type: 'log',
+            spanId: 'span2',
+            traceId: 'trace1',
+            severityText: 'INFO',
+            severityNumber: 9,
+            body: 'Processing child task',
+        },
+        {
+            name: 'grandchild.operation',
+            timestamp: 1400,
+            type: 'span',
+            spanId: 'span3',
+            parentSpanId: 'span2',
+            traceId: 'trace1',
+        },
+        {
+            name: 'log.info',
+            timestamp: 1500,
+            type: 'log',
+            spanId: 'span3',
+            traceId: 'trace1',
+            severityText: 'INFO',
+            severityNumber: 9,
+            body: 'Executing grandchild task',
+        },
+    ];
+    console.log('=== Example 3: Span Tree Hierarchy ===\n');
+    const result = renderNarrative(template, events);
+    console.log(result.text);
+    console.log('\n');
+}
+// Run all examples
+if (import.meta.main) {
+    exampleSuccess();
+    exampleWithViolations();
+    exampleSpanTree();
+}
+export { exampleSuccess, exampleWithViolations, exampleSpanTree };
+//# sourceMappingURL=example.js.map

package/dist/narrative/example.js.map

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

package/dist/narrative/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Narrative Template System
+ *
+ * Transform OpenTelemetry event streams into human-readable execution narratives.
+ *
+ * @module narrative
+ */
+export type { NarrativeTemplate, NarrativeScenario, NarrativeMode, ScenarioCondition, ScenarioTemplate, Assertion, FlowDirective, LogTemplates, FormattingOptions, OtelEvent, OtelSignal, NarrativeContext, NarrativeResult, ScenarioMatchResult, SpanTreeNode, } from './types';
+export { selectScenario, matchesCondition, hasEventMatching, computeAggregates, evaluateAssertion, getNestedValue, setNestedValue } from './scenario-matcher';
+export { parseTemplate, evaluateExpression } from './template-parser';
+export { renderNarrative } from './template-renderer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/narrative/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG9J,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGtE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/narrative/index.js

@@ -0,0 +1,14 @@
+/**
+ * Narrative Template System
+ *
+ * Transform OpenTelemetry event streams into human-readable execution narratives.
+ *
+ * @module narrative
+ */
+// Scenario Matching
+export { selectScenario, matchesCondition, hasEventMatching, computeAggregates, evaluateAssertion, getNestedValue, setNestedValue } from './scenario-matcher';
+// Template Parsing
+export { parseTemplate, evaluateExpression } from './template-parser';
+// Template Rendering
+export { renderNarrative } from './template-renderer';
+//# sourceMappingURL=index.js.map

package/dist/narrative/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/narrative/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9J,mBAAmB;AACnB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/narrative/scenario-matcher.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Scenario Matching Logic
+ *
+ * Selects the appropriate narrative scenario based on which events occurred
+ * during execution. Uses priority-based, first-match-wins algorithm.
+ */
+import type { NarrativeTemplate, ScenarioCondition, Assertion, OtelEvent, ScenarioMatchResult } from './types';
+/**
+ * Select the first matching scenario from a narrative template
+ *
+ * Scenarios are evaluated in priority order (lowest priority number first).
+ * Returns the first scenario whose conditions are met.
+ *
+ * @param template - Narrative template with scenarios
+ * @param events - Collected OTEL events
+ * @param attributes - Aggregated attributes (computed from events)
+ * @returns Matched scenario and metadata
+ * @throws Error if no scenario matches (template should have default fallback)
+ */
+export declare function selectScenario(template: NarrativeTemplate, events: OtelEvent[], attributes?: Record<string, unknown>): ScenarioMatchResult;
+/**
+ * Check if a scenario condition matches the given events and attributes
+ *
+ * @param condition - Scenario condition to evaluate
+ * @param events - Collected OTEL events
+ * @param attributes - Aggregated attributes
+ * @returns Match result with reason if not matched
+ */
+export declare function matchesCondition(condition: ScenarioCondition, events: OtelEvent[], attributes: Record<string, unknown>): {
+    matches: boolean;
+    reason?: string;
+};
+/**
+ * Check if any event matches the given pattern (supports glob-style wildcards)
+ *
+ * Patterns:
+ * - Exact: "conversion.started" matches only that event
+ * - Wildcard suffix: "conversion.*" matches "conversion.started", "conversion.complete", etc.
+ * - Wildcard prefix: "*.error" matches "conversion.error", "rule.error", etc.
+ * - Wildcard middle: "log.*" matches any event starting with "log."
+ *
+ * @param events - Events to search
+ * @param pattern - Pattern to match (supports * wildcard)
+ * @returns True if any event matches the pattern
+ */
+export declare function hasEventMatching(events: OtelEvent[], pattern: string): boolean;
+/**
+ * Evaluate an assertion against a value
+ *
+ * @param value - Value to test
+ * @param assertion - Assertion operators
+ * @returns Match result with reason if not matched
+ */
+export declare function evaluateAssertion(value: unknown, assertion: Assertion): {
+    matches: boolean;
+    reason?: string;
+};
+/**
+ * Get nested value from object using dot notation
+ *
+ * Supports both nested objects and flat keys with dots in them.
+ * First tries the path as a flat key, then tries nested lookup.
+ *
+ * @param obj - Object to search
+ * @param path - Dot-separated path (e.g., "result.violations.total")
+ * @returns Value at path, or undefined if not found
+ */
+export declare function getNestedValue(obj: Record<string, unknown>, path: string): unknown;
+/**
+ * Set nested value in object using dot notation
+ *
+ * @param obj - Object to modify
+ * @param path - Dot-separated path (e.g., "result.violations.total")
+ * @param value - Value to set
+ */
+export declare function setNestedValue(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Compute aggregate values from events
+ *
+ * Provides common aggregations like counts, totals, averages, etc.
+ * that can be used in scenario conditions and templates.
+ *
+ * @param events - Collected OTEL events
+ * @returns Aggregate values
+ */
+export declare function computeAggregates(events: OtelEvent[]): Record<string, unknown>;
+//# sourceMappingURL=scenario-matcher.d.ts.map

package/dist/narrative/scenario-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-matcher.d.ts","sourceRoot":"","sources":["../../src/narrative/scenario-matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,SAAS,EAAE,EACnB,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACvC,mBAAmB,CAmCrB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,SAAS,EAAE,EACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAkDvC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAS9E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,SAAS,GACnB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CA0DvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAqBlF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAc/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsC9E"}