@principal-ai/subsystems-core 0.29.0

package/dist/workflow/example.js

@@ -0,0 +1,310 @@
+"use strict";
+/**
+ * Example: Using the Workflow Template System
+ *
+ * This example demonstrates how to use the workflow renderer
+ * to transform OTEL events into human-readable workflows.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exampleSpanTree = exports.exampleWithViolations = exports.exampleSuccess = void 0;
+const template_renderer_1 = require("./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 workflow',
+        spanPattern: 'example.execution',
+        scenarioSelection: 'first-match',
+        showLogsPerSpan: true,
+        scenarios: [
+            {
+                id: 'success',
+                priority: 1,
+                description: 'Successful execution',
+                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 = (0, template_renderer_1.renderWorkflow)(template, events);
+    console.log('=== Example 1: Success Scenario ===\n');
+    console.log(result.text);
+    console.log('\nMetadata:', result.metadata);
+    console.log('\n');
+}
+exports.exampleSuccess = exampleSuccess;
+// 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',
+        spanPattern: 'validation.run',
+        scenarioSelection: 'first-match',
+        scenarios: [
+            {
+                id: 'errors',
+                priority: 1,
+                description: 'Has error-level violations',
+                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',
+                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',
+                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 = (0, template_renderer_1.renderWorkflow)(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 = (0, template_renderer_1.renderWorkflow)(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 = (0, template_renderer_1.renderWorkflow)(template, eventsSuccess);
+    console.log(result3.text);
+    console.log('\nSelected scenario:', result3.scenarioId);
+    console.log('\n');
+}
+exports.exampleWithViolations = exampleWithViolations;
+// 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',
+        spanPattern: 'root.operation',
+        scenarioSelection: 'first-match',
+        showLogsPerSpan: true,
+        scenarios: [
+            {
+                id: 'default',
+                priority: 1,
+                description: 'Default',
+                template: {
+                    introduction: '📋 Execution Trace\n{"━".repeat(50)}',
+                    span: '→ {span.name}',
+                    children: 'recurse',
+                    events: {
+                        'root.operation': '  🔄 Operation started',
+                    },
+                    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 = (0, template_renderer_1.renderWorkflow)(template, events);
+    console.log(result.text);
+    console.log('\n');
+}
+exports.exampleSpanTree = exampleSpanTree;
+//# sourceMappingURL=example.js.map

package/dist/workflow/example.js.map

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

package/dist/workflow/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Workflow Template System
+ *
+ * Transform OpenTelemetry event streams into human-readable execution workflows.
+ *
+ * @module workflow
+ */
+export type { WorkflowTemplate, WorkflowScenario, ScenarioOutcomeType, ScenarioTemplate, EventTemplate, LogTemplates, FormattingOptions, OtelEvent, OtelSignal, WorkflowContext, WorkflowResult, ScenarioMatchResult, ScenarioMatchDetail, EnhancedScenarioMatchResult, WorkflowMatch, SpanTreeNode, } from './types';
+export { isEventTemplate, getEventTemplateString, getEventSpan, getWorkflowRootSpan, } from './types';
+export { selectScenario, getRequiredEvents, hasEventMatching, computeAggregates, getNestedValue, setNestedValue } from './scenario-matcher';
+export { parseTemplate, ParsedTemplate } from './template-parser';
+export type { TemplateSegment, TemplateContext, TemplateValue, TemplateData } from './template-parser';
+export { renderWorkflow, renderEventTemplate } from './template-renderer';
+export type { WorkflowValidationContext, WorkflowViolation, WorkflowValidationResult, } from './validator';
+export { WorkflowValidator, createWorkflowValidator } from './validator';
+export type { DerivedEdge, WorkflowEdgeDerivationResult, EdgeDerivationResult, } from './edge-derivation';
+export { extractEventSpans, deriveEdgesFromSequence, deriveWorkflowEdges, deriveEdgesFromWorkflows, groupEdgesBySources, } from './edge-derivation';
+export type { SpanNodeInfo, CanvasEdgeInfo, EdgeValidationResult, ValidatedEdge, MissingEdge, UnusedEdge, UnmatchedSpan, } from './edge-validation';
+export { extractSpanNodes, extractCanvasEdges, matchSpanToPattern, findMatchingNode, validateEdges, formatValidationResult, } from './edge-validation';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,aAAa,EACb,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG5I,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGvG,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1E,YAAY,EACV,yBAAyB,EACzB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGzE,YAAY,EACV,WAAW,EACX,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,sBAAsB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/workflow/index.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Workflow Template System
+ *
+ * Transform OpenTelemetry event streams into human-readable execution workflows.
+ *
+ * @module workflow
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatValidationResult = exports.validateEdges = exports.findMatchingNode = exports.matchSpanToPattern = exports.extractCanvasEdges = exports.extractSpanNodes = exports.groupEdgesBySources = exports.deriveEdgesFromWorkflows = exports.deriveWorkflowEdges = exports.deriveEdgesFromSequence = exports.extractEventSpans = exports.createWorkflowValidator = exports.WorkflowValidator = exports.renderEventTemplate = exports.renderWorkflow = exports.ParsedTemplate = exports.parseTemplate = exports.setNestedValue = exports.getNestedValue = exports.computeAggregates = exports.hasEventMatching = exports.getRequiredEvents = exports.selectScenario = exports.getWorkflowRootSpan = exports.getEventSpan = exports.getEventTemplateString = exports.isEventTemplate = void 0;
+// Type helpers
+var types_1 = require("./types");
+Object.defineProperty(exports, "isEventTemplate", { enumerable: true, get: function () { return types_1.isEventTemplate; } });
+Object.defineProperty(exports, "getEventTemplateString", { enumerable: true, get: function () { return types_1.getEventTemplateString; } });
+Object.defineProperty(exports, "getEventSpan", { enumerable: true, get: function () { return types_1.getEventSpan; } });
+Object.defineProperty(exports, "getWorkflowRootSpan", { enumerable: true, get: function () { return types_1.getWorkflowRootSpan; } });
+// Scenario Matching
+var scenario_matcher_1 = require("./scenario-matcher");
+Object.defineProperty(exports, "selectScenario", { enumerable: true, get: function () { return scenario_matcher_1.selectScenario; } });
+Object.defineProperty(exports, "getRequiredEvents", { enumerable: true, get: function () { return scenario_matcher_1.getRequiredEvents; } });
+Object.defineProperty(exports, "hasEventMatching", { enumerable: true, get: function () { return scenario_matcher_1.hasEventMatching; } });
+Object.defineProperty(exports, "computeAggregates", { enumerable: true, get: function () { return scenario_matcher_1.computeAggregates; } });
+Object.defineProperty(exports, "getNestedValue", { enumerable: true, get: function () { return scenario_matcher_1.getNestedValue; } });
+Object.defineProperty(exports, "setNestedValue", { enumerable: true, get: function () { return scenario_matcher_1.setNestedValue; } });
+// Template Parsing
+var template_parser_1 = require("./template-parser");
+Object.defineProperty(exports, "parseTemplate", { enumerable: true, get: function () { return template_parser_1.parseTemplate; } });
+Object.defineProperty(exports, "ParsedTemplate", { enumerable: true, get: function () { return template_parser_1.ParsedTemplate; } });
+// Template Rendering
+var template_renderer_1 = require("./template-renderer");
+Object.defineProperty(exports, "renderWorkflow", { enumerable: true, get: function () { return template_renderer_1.renderWorkflow; } });
+Object.defineProperty(exports, "renderEventTemplate", { enumerable: true, get: function () { return template_renderer_1.renderEventTemplate; } });
+var validator_1 = require("./validator");
+Object.defineProperty(exports, "WorkflowValidator", { enumerable: true, get: function () { return validator_1.WorkflowValidator; } });
+Object.defineProperty(exports, "createWorkflowValidator", { enumerable: true, get: function () { return validator_1.createWorkflowValidator; } });
+var edge_derivation_1 = require("./edge-derivation");
+Object.defineProperty(exports, "extractEventSpans", { enumerable: true, get: function () { return edge_derivation_1.extractEventSpans; } });
+Object.defineProperty(exports, "deriveEdgesFromSequence", { enumerable: true, get: function () { return edge_derivation_1.deriveEdgesFromSequence; } });
+Object.defineProperty(exports, "deriveWorkflowEdges", { enumerable: true, get: function () { return edge_derivation_1.deriveWorkflowEdges; } });
+Object.defineProperty(exports, "deriveEdgesFromWorkflows", { enumerable: true, get: function () { return edge_derivation_1.deriveEdgesFromWorkflows; } });
+Object.defineProperty(exports, "groupEdgesBySources", { enumerable: true, get: function () { return edge_derivation_1.groupEdgesBySources; } });
+var edge_validation_1 = require("./edge-validation");
+Object.defineProperty(exports, "extractSpanNodes", { enumerable: true, get: function () { return edge_validation_1.extractSpanNodes; } });
+Object.defineProperty(exports, "extractCanvasEdges", { enumerable: true, get: function () { return edge_validation_1.extractCanvasEdges; } });
+Object.defineProperty(exports, "matchSpanToPattern", { enumerable: true, get: function () { return edge_validation_1.matchSpanToPattern; } });
+Object.defineProperty(exports, "findMatchingNode", { enumerable: true, get: function () { return edge_validation_1.findMatchingNode; } });
+Object.defineProperty(exports, "validateEdges", { enumerable: true, get: function () { return edge_validation_1.validateEdges; } });
+Object.defineProperty(exports, "formatValidationResult", { enumerable: true, get: function () { return edge_validation_1.formatValidationResult; } });
+//# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAsBH,eAAe;AACf,iCAKiB;AAJf,wGAAA,eAAe,OAAA;AACf,+GAAA,sBAAsB,OAAA;AACtB,qGAAA,YAAY,OAAA;AACZ,4GAAA,mBAAmB,OAAA;AAGrB,oBAAoB;AACpB,uDAA4I;AAAnI,kHAAA,cAAc,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAAE,oHAAA,gBAAgB,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAAE,kHAAA,cAAc,OAAA;AAAE,kHAAA,cAAc,OAAA;AAE/G,mBAAmB;AACnB,qDAAkE;AAAzD,gHAAA,aAAa,OAAA;AAAE,iHAAA,cAAc,OAAA;AAGtC,qBAAqB;AACrB,yDAA0E;AAAjE,mHAAA,cAAc,OAAA;AAAE,wHAAA,mBAAmB,OAAA;AAQ5C,yCAAyE;AAAhE,8GAAA,iBAAiB,OAAA;AAAE,oHAAA,uBAAuB,OAAA;AAQnD,qDAM2B;AALzB,oHAAA,iBAAiB,OAAA;AACjB,0HAAA,uBAAuB,OAAA;AACvB,sHAAA,mBAAmB,OAAA;AACnB,2HAAA,wBAAwB,OAAA;AACxB,sHAAA,mBAAmB,OAAA;AAarB,qDAO2B;AANzB,mHAAA,gBAAgB,OAAA;AAChB,qHAAA,kBAAkB,OAAA;AAClB,qHAAA,kBAAkB,OAAA;AAClB,mHAAA,gBAAgB,OAAA;AAChB,gHAAA,aAAa,OAAA;AACb,yHAAA,sBAAsB,OAAA"}

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

@@ -0,0 +1,63 @@
+/**
+ * Scenario Matching Logic
+ *
+ * Selects the appropriate workflow scenario based on which events occurred
+ * during execution. Uses priority-based, first-match-wins algorithm.
+ */
+import type { WorkflowScenario, WorkflowTemplate, OtelEvent, EnhancedScenarioMatchResult } from './types';
+/**
+ * Get required events for a scenario (derived from template.events)
+ *
+ * @param scenario - Scenario to extract events from
+ * @returns Array of event names required for this scenario to match
+ */
+export declare function getRequiredEvents(scenario: WorkflowScenario): string[];
+/**
+ * Select matching scenarios from a workflow template
+ *
+ * Returns ALL scenarios with 100% match (sorted by priority),
+ * or partial matches (sorted by % then priority) if no full matches.
+ *
+ * @param template - Workflow template with scenarios
+ * @param events - Collected OTEL events
+ * @returns Enhanced match result (never throws)
+ */
+export declare function selectScenario(template: WorkflowTemplate, events: OtelEvent[]): EnhancedScenarioMatchResult;
+/**
+ * Check if any event matches the given event name (exact match)
+ *
+ * @param events - Events to search
+ * @param eventName - Event name to match (exact string match)
+ * @returns True if any event matches the name
+ */
+export declare function hasEventMatching(events: OtelEvent[], eventName: string): boolean;
+/**
+ * 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/workflow/scenario-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-matcher.d.ts","sourceRoot":"","sources":["../../src/workflow/scenario-matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EAET,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAEtE;AA0DD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,SAAS,EAAE,GAClB,2BAA2B,CAuC7B;AAGD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEhF;AAGD;;;;;;;;;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,CAuC9E"}