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

package/dist/narrative/scenario-matcher.js

@@ -0,0 +1,269 @@
+/**
+ * Scenario Matching Logic
+ *
+ * Selects the appropriate narrative scenario based on which events occurred
+ * during execution. Uses priority-based, first-match-wins algorithm.
+ */
+/**
+ * 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 function selectScenario(template, events, attributes = {}) {
+    // Sort scenarios by priority (should already be sorted in template)
+    const sorted = [...template.scenarios].sort((a, b) => a.priority - b.priority);
+    const applicableScenarios = [];
+    const matchReasons = {};
+    // Find first matching scenario
+    for (const scenario of sorted) {
+        const matchResult = matchesCondition(scenario.condition, events, attributes);
+        if (matchResult.matches) {
+            // Check if there are other applicable scenarios (for UI)
+            for (const other of sorted) {
+                if (other.id !== scenario.id && matchesCondition(other.condition, events, attributes).matches) {
+                    applicableScenarios.push(other);
+                }
+            }
+            return {
+                scenario,
+                isDefault: Boolean(scenario.condition.default),
+                applicableScenarios: [scenario, ...applicableScenarios],
+                matchReasons,
+            };
+        }
+        matchReasons[scenario.id] = matchResult.reason || 'Unknown';
+    }
+    throw new Error(`No scenario matched for template "${template.name}". ` +
+        `Ensure there is a default scenario with { default: true } condition. ` +
+        `Events: ${events.map((e) => e.name).join(', ')}`);
+}
+/**
+ * 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 function matchesCondition(condition, events, attributes) {
+    // 1. Check default condition (always matches)
+    if (condition.default) {
+        return { matches: true };
+    }
+    // 2. Check required events
+    if (condition.requires) {
+        const matchMode = condition.any ? 'some' : 'every';
+        const hasRequired = condition.requires[matchMode]((pattern) => hasEventMatching(events, pattern));
+        if (!hasRequired) {
+            const missing = condition.requires.filter((pattern) => !hasEventMatching(events, pattern));
+            return {
+                matches: false,
+                reason: `Missing required event(s): ${missing.join(', ')}`,
+            };
+        }
+    }
+    // 3. Check excluded events
+    if (condition.excludes) {
+        const excluded = condition.excludes.find((pattern) => hasEventMatching(events, pattern));
+        if (excluded) {
+            return {
+                matches: false,
+                reason: `Found excluded event: ${excluded}`,
+            };
+        }
+    }
+    // 4. Check attribute assertions
+    if (condition.assertions) {
+        for (const [key, assertion] of Object.entries(condition.assertions)) {
+            const value = getNestedValue(attributes, key);
+            const assertionResult = evaluateAssertion(value, assertion);
+            if (!assertionResult.matches) {
+                return {
+                    matches: false,
+                    reason: `Assertion failed for "${key}": ${assertionResult.reason}`,
+                };
+            }
+        }
+    }
+    // All checks passed
+    return { matches: true };
+}
+/**
+ * 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 function hasEventMatching(events, pattern) {
+    // Convert glob pattern to regex
+    const regexPattern = pattern
+        .replace(/\./g, '\\.') // Escape dots
+        .replace(/\*/g, '.*'); // Convert * to .*
+    const regex = new RegExp(`^${regexPattern}$`);
+    return events.some((event) => regex.test(event.name));
+}
+/**
+ * Evaluate an assertion against a value
+ *
+ * @param value - Value to test
+ * @param assertion - Assertion operators
+ * @returns Match result with reason if not matched
+ */
+export function evaluateAssertion(value, assertion) {
+    // $exists check
+    if (assertion.$exists !== undefined) {
+        const exists = value !== undefined && value !== null;
+        if (exists !== assertion.$exists) {
+            return {
+                matches: false,
+                reason: assertion.$exists ? 'Value does not exist' : 'Value exists but should not',
+            };
+        }
+        // If only checking existence, we're done
+        if (Object.keys(assertion).length === 1) {
+            return { matches: true };
+        }
+    }
+    // If value doesn't exist and we're checking other operators, fail
+    if (value === undefined || value === null) {
+        return { matches: false, reason: 'Value is undefined or null' };
+    }
+    // Numeric comparisons
+    if (typeof value === 'number') {
+        if (assertion.$gt !== undefined && !(value > assertion.$gt)) {
+            return { matches: false, reason: `${value} is not > ${assertion.$gt}` };
+        }
+        if (assertion.$gte !== undefined && !(value >= assertion.$gte)) {
+            return { matches: false, reason: `${value} is not >= ${assertion.$gte}` };
+        }
+        if (assertion.$lt !== undefined && !(value < assertion.$lt)) {
+            return { matches: false, reason: `${value} is not < ${assertion.$lt}` };
+        }
+        if (assertion.$lte !== undefined && !(value <= assertion.$lte)) {
+            return { matches: false, reason: `${value} is not <= ${assertion.$lte}` };
+        }
+    }
+    // Equality checks
+    if (assertion.$eq !== undefined && value !== assertion.$eq) {
+        return { matches: false, reason: `${value} !== ${assertion.$eq}` };
+    }
+    if (assertion.$ne !== undefined && value === assertion.$ne) {
+        return { matches: false, reason: `${value} === ${assertion.$ne} (should not equal)` };
+    }
+    // Array membership
+    if (assertion.$in !== undefined) {
+        if (!assertion.$in.includes(value)) {
+            return { matches: false, reason: `${value} not in [${assertion.$in.join(', ')}]` };
+        }
+    }
+    if (assertion.$nin !== undefined) {
+        if (assertion.$nin.includes(value)) {
+            return { matches: false, reason: `${value} found in excluded list [${assertion.$nin.join(', ')}]` };
+        }
+    }
+    return { matches: true };
+}
+/**
+ * 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 function getNestedValue(obj, path) {
+    // First try as a flat key (handles attributes like 'result.violations.total')
+    if (path in obj) {
+        return obj[path];
+    }
+    // Then try as nested path
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        if (typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * 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 function setNestedValue(obj, path, value) {
+    const keys = path.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        if (current[key] === undefined || typeof current[key] !== 'object') {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    const lastKey = keys[keys.length - 1];
+    current[lastKey] = value;
+}
+/**
+ * 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 function computeAggregates(events) {
+    const aggregates = {
+        // Event counts
+        'events.length': events.length,
+        'events.count': events.length,
+        // Spans
+        'spans.count': events.filter((e) => e.type === 'span').length,
+        // Logs
+        'logs.count': events.filter((e) => e.type === 'log').length,
+        'errorLogs.count': events.filter((e) => e.type === 'log' && (e.severityNumber ?? 0) >= 17).length,
+        'warnLogs.count': events.filter((e) => e.type === 'log' && (e.severityNumber ?? 0) >= 13 && (e.severityNumber ?? 0) <= 16).length,
+        'debugLogs.count': events.filter((e) => e.type === 'log' && (e.severityNumber ?? 0) >= 5 && (e.severityNumber ?? 0) <= 8).length,
+    };
+    // Extract common attributes from events (for easy access in conditions)
+    for (const event of events) {
+        if (event.attributes) {
+            for (const [key, value] of Object.entries(event.attributes)) {
+                // Store first occurrence using nested value setter
+                // This handles both flat keys and dot-notation keys (e.g., "result.violations.total")
+                if (getNestedValue(aggregates, key) === undefined) {
+                    // Store both as nested structure (for getNestedValue) and flat key (for direct access)
+                    setNestedValue(aggregates, key, value);
+                    if (key.includes('.')) {
+                        aggregates[key] = value; // Also store flat version
+                    }
+                }
+            }
+        }
+    }
+    return aggregates;
+}
+//# sourceMappingURL=scenario-matcher.js.map

package/dist/narrative/scenario-matcher.js.map

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

package/dist/narrative/template-parser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Template Expression Parser
+ *
+ * Parses and evaluates template expressions like:
+ * - Simple: "{config.nodeTypes}"
+ * - Conditional: "{result.violations.total > 0 ? '❌ FAILED' : '✅ PASSED'}"
+ * - Function calls: "{'━'.repeat(50)}"
+ */
+/**
+ * Parse and evaluate a template string with embedded expressions
+ *
+ * Expressions are enclosed in curly braces: {expression}
+ *
+ * Supported syntax:
+ * - Property access: {config.nodeTypes}
+ * - Ternary: {count > 0 ? 'yes' : 'no'}
+ * - String methods: {'━'.repeat(50)}
+ * - Arithmetic: {duration.ms / 1000}
+ *
+ * @param template - Template string with {expressions}
+ * @param context - Data context for variable lookup
+ * @returns Evaluated string
+ */
+export declare function parseTemplate(template: string, context: Record<string, unknown>): string;
+/**
+ * Evaluate a single expression in the given context
+ *
+ * @param expression - Expression to evaluate
+ * @param context - Data context
+ * @returns Evaluated value
+ */
+export declare function evaluateExpression(expression: string, context: Record<string, unknown>): unknown;
+//# sourceMappingURL=template-parser.d.ts.map

package/dist/narrative/template-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-parser.d.ts","sourceRoot":"","sources":["../../src/narrative/template-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA6DxF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA4HhG"}

package/dist/narrative/template-parser.js

@@ -0,0 +1,288 @@
+/**
+ * Template Expression Parser
+ *
+ * Parses and evaluates template expressions like:
+ * - Simple: "{config.nodeTypes}"
+ * - Conditional: "{result.violations.total > 0 ? '❌ FAILED' : '✅ PASSED'}"
+ * - Function calls: "{'━'.repeat(50)}"
+ */
+import { getNestedValue } from './scenario-matcher';
+/**
+ * Parse and evaluate a template string with embedded expressions
+ *
+ * Expressions are enclosed in curly braces: {expression}
+ *
+ * Supported syntax:
+ * - Property access: {config.nodeTypes}
+ * - Ternary: {count > 0 ? 'yes' : 'no'}
+ * - String methods: {'━'.repeat(50)}
+ * - Arithmetic: {duration.ms / 1000}
+ *
+ * @param template - Template string with {expressions}
+ * @param context - Data context for variable lookup
+ * @returns Evaluated string
+ */
+export function parseTemplate(template, context) {
+    // Find all {expression} patterns, handling nested braces
+    let result = '';
+    let i = 0;
+    while (i < template.length) {
+        const start = template.indexOf('{', i);
+        if (start === -1) {
+            // No more expressions
+            result += template.substring(i);
+            break;
+        }
+        // Add text before the expression
+        result += template.substring(i, start);
+        // Find matching closing brace
+        let depth = 1;
+        let end = start + 1;
+        while (end < template.length && depth > 0) {
+            if (template[end] === '{')
+                depth++;
+            if (template[end] === '}')
+                depth--;
+            end++;
+        }
+        if (depth === 0) {
+            // Found matching brace
+            const expression = template.substring(start + 1, end - 1);
+            try {
+                const value = evaluateExpression(expression.trim(), context);
+                // Check if evaluation failed (returned undefined when it shouldn't)
+                if (value === undefined && !expression.trim().includes('undefined')) {
+                    // If the expression doesn't contain 'undefined' but returned undefined,
+                    // it likely failed to parse/evaluate
+                    const isValidExpression = expression.trim() in context || // Simple variable
+                        /^[\w.]+$/.test(expression.trim()) || // Property path
+                        expression.includes('?') || // Ternary
+                        /[+\-*/<>=!]/.test(expression); // Operations
+                    if (!isValidExpression && expression.includes('(')) {
+                        result += `{ERROR: Unable to evaluate '${expression}'}`;
+                    }
+                    else {
+                        result += formatValue(value);
+                    }
+                }
+                else {
+                    result += formatValue(value);
+                }
+            }
+            catch (error) {
+                // Return error placeholder instead of throwing
+                result += `{ERROR: ${error instanceof Error ? error.message : 'unknown'}}`;
+            }
+            i = end;
+        }
+        else {
+            // Unmatched brace
+            result += '{';
+            i = start + 1;
+        }
+    }
+    return result;
+}
+/**
+ * Evaluate a single expression in the given context
+ *
+ * @param expression - Expression to evaluate
+ * @param context - Data context
+ * @returns Evaluated value
+ */
+export function evaluateExpression(expression, context) {
+    // Handle literals FIRST (before operators to avoid false matches)
+    // Handle string literals
+    if ((expression.startsWith("'") && expression.endsWith("'")) || (expression.startsWith('"') && expression.endsWith('"'))) {
+        return expression.slice(1, -1);
+    }
+    // Handle number literals (including negative numbers)
+    if (/^-?\d+(\.\d+)?$/.test(expression)) {
+        return Number(expression);
+    }
+    // Handle boolean literals
+    if (expression === 'true')
+        return true;
+    if (expression === 'false')
+        return false;
+    if (expression === 'null')
+        return null;
+    if (expression === 'undefined')
+        return undefined;
+    // Handle ternary operator: condition ? true : false
+    const ternaryMatch = expression.match(/^(.+?)\s*\?\s*(.+?)\s*:\s*(.+)$/);
+    if (ternaryMatch) {
+        const [, condition, trueValue, falseValue] = ternaryMatch;
+        const conditionResult = evaluateExpression(condition, context);
+        const result = isTruthy(conditionResult)
+            ? evaluateExpression(trueValue, context)
+            : evaluateExpression(falseValue, context);
+        // If the result is a string containing {expressions}, recursively parse it
+        if (typeof result === 'string' && result.includes('{') && result.includes('}')) {
+            return parseTemplate(result, context);
+        }
+        return result;
+    }
+    // Handle comparison operators
+    if (expression.includes('>=')) {
+        const [left, right] = expression.split('>=').map((s) => s.trim());
+        return Number(evaluateExpression(left, context)) >= Number(evaluateExpression(right, context));
+    }
+    if (expression.includes('<=')) {
+        const [left, right] = expression.split('<=').map((s) => s.trim());
+        return Number(evaluateExpression(left, context)) <= Number(evaluateExpression(right, context));
+    }
+    if (expression.includes('>')) {
+        const [left, right] = expression.split('>').map((s) => s.trim());
+        return Number(evaluateExpression(left, context)) > Number(evaluateExpression(right, context));
+    }
+    if (expression.includes('<')) {
+        const [left, right] = expression.split('<').map((s) => s.trim());
+        return Number(evaluateExpression(left, context)) < Number(evaluateExpression(right, context));
+    }
+    if (expression.includes('===')) {
+        const [left, right] = expression.split('===').map((s) => s.trim());
+        return evaluateExpression(left, context) === evaluateExpression(right, context);
+    }
+    if (expression.includes('!==')) {
+        const [left, right] = expression.split('!==').map((s) => s.trim());
+        return evaluateExpression(left, context) !== evaluateExpression(right, context);
+    }
+    if (expression.includes('==')) {
+        const [left, right] = expression.split('==').map((s) => s.trim());
+        // eslint-disable-next-line eqeqeq
+        return evaluateExpression(left, context) == evaluateExpression(right, context);
+    }
+    if (expression.includes('!=')) {
+        const [left, right] = expression.split('!=').map((s) => s.trim());
+        // eslint-disable-next-line eqeqeq
+        return evaluateExpression(left, context) != evaluateExpression(right, context);
+    }
+    // Handle arithmetic operators (check for operators not at start to avoid matching negative numbers)
+    if (expression.includes('+') && !expression.includes("'") && !expression.includes('"')) {
+        const parts = expression.split('+');
+        if (parts.length > 1) {
+            const [left, right] = parts.map((s) => s.trim());
+            return Number(evaluateExpression(left, context)) + Number(evaluateExpression(right, context));
+        }
+    }
+    if (expression.includes('-') && !expression.includes("'") && !expression.includes('"')) {
+        // Only treat as subtraction if there's content before the minus (to avoid matching negative numbers)
+        const minusIndex = expression.indexOf('-');
+        if (minusIndex > 0) {
+            const beforeMinus = expression.substring(0, minusIndex).trim();
+            if (beforeMinus.length > 0) {
+                const [left, right] = expression.split('-').map((s) => s.trim());
+                return Number(evaluateExpression(left, context)) - Number(evaluateExpression(right, context));
+            }
+        }
+    }
+    if (expression.includes('*') && !expression.includes("'") && !expression.includes('"')) {
+        const [left, right] = expression.split('*').map((s) => s.trim());
+        return Number(evaluateExpression(left, context)) * Number(evaluateExpression(right, context));
+    }
+    if (expression.includes('/') && !expression.includes("'") && !expression.includes('"')) {
+        const [left, right] = expression.split('/').map((s) => s.trim());
+        return Number(evaluateExpression(left, context)) / Number(evaluateExpression(right, context));
+    }
+    // Handle method calls (limited to safe string methods)
+    if (expression.includes('.')) {
+        // Support both single and double quotes
+        const methodMatch = expression.match(/^(['"])(.+)\1\.(\w+)\(([^)]*)\)$/);
+        if (methodMatch) {
+            const [, , str, method, argsStr] = methodMatch;
+            return callStringMethod(str, method, argsStr);
+        }
+        // Property access with method call
+        const propMethodMatch = expression.match(/^([\w.[\]']+)\.(\w+)\(([^)]*)\)$/);
+        if (propMethodMatch) {
+            const [, propPath, method, argsStr] = propMethodMatch;
+            const value = evaluateExpression(propPath, context);
+            if (typeof value === 'string') {
+                return callStringMethod(value, method, argsStr);
+            }
+        }
+        // Simple property access
+        return getNestedValue(context, expression);
+    }
+    // Simple variable lookup
+    return context[expression];
+}
+/**
+ * Call a safe string method
+ *
+ * Only allows specific string methods to prevent code injection.
+ *
+ * @param str - String to operate on
+ * @param method - Method name
+ * @param argsStr - Arguments string
+ * @returns Result of method call
+ */
+function callStringMethod(str, method, argsStr) {
+    const args = argsStr.split(',').map((s) => s.trim());
+    switch (method) {
+        case 'repeat': {
+            const count = Number(args[0]);
+            return str.repeat(count);
+        }
+        case 'substring': {
+            const start = Number(args[0]);
+            const end = args[1] !== undefined ? Number(args[1]) : undefined;
+            return str.substring(start, end);
+        }
+        case 'slice': {
+            const start = Number(args[0]);
+            const end = args[1] !== undefined ? Number(args[1]) : undefined;
+            return str.slice(start, end);
+        }
+        case 'toUpperCase':
+            return str.toUpperCase();
+        case 'toLowerCase':
+            return str.toLowerCase();
+        case 'trim':
+            return str.trim();
+        case 'replace': {
+            const search = args[0].replace(/^['"]|['"]$/g, '');
+            const replace = args[1].replace(/^['"]|['"]$/g, '');
+            return str.replace(search, replace);
+        }
+        default:
+            throw new Error(`Method ${method} is not allowed in templates`);
+    }
+}
+/**
+ * Check if a value is truthy
+ *
+ * @param value - Value to check
+ * @returns True if value is truthy
+ */
+function isTruthy(value) {
+    if (value === null || value === undefined)
+        return false;
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return value !== 0;
+    if (typeof value === 'string')
+        return value.length > 0;
+    return true;
+}
+/**
+ * Format a value for output
+ *
+ * @param value - Value to format
+ * @returns Formatted string
+ */
+function formatValue(value) {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    if (typeof value === 'boolean') {
+        return value ? 'true' : 'false';
+    }
+    if (typeof value === 'object') {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+//# sourceMappingURL=template-parser.js.map

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

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

package/dist/narrative/template-renderer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Template Renderer
+ *
+ * Renders narrative templates into human-readable text using
+ * OTEL events, selected scenarios, and template expressions.
+ */
+import type { NarrativeTemplate, OtelEvent, NarrativeResult } from './types';
+/**
+ * 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 declare function renderNarrative(template: NarrativeTemplate, events: OtelEvent[]): NarrativeResult;
+//# sourceMappingURL=template-renderer.d.ts.map

package/dist/narrative/template-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-renderer.d.ts","sourceRoot":"","sources":["../../src/narrative/template-renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAEjB,SAAS,EACT,eAAe,EAKhB,MAAM,SAAS,CAAC;AAIjB;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,CAqDjG"}