driftdetect-cortex 0.9.41

package/dist/causal/inference/entity.js

@@ -0,0 +1,185 @@
+/**
+ * Entity Overlap Inference Strategy
+ *
+ * Infers causal relationships based on shared entities
+ * (files, functions, patterns, constraints). Memories
+ * linked to the same code entities are likely related.
+ *
+ * @module causal/inference/entity
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    minOverlapRatio: 0.2,
+    fileWeight: 0.35,
+    functionWeight: 0.3,
+    patternWeight: 0.2,
+    constraintWeight: 0.15,
+};
+/**
+ * Entity overlap inference strategy
+ *
+ * Memories that reference the same code entities
+ * (files, functions, patterns) are likely causally related.
+ */
+export class EntityInferenceStrategy {
+    name = 'entity_overlap';
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Infer causal edges based on entity overlap
+     */
+    async infer(memory, candidates) {
+        const edges = [];
+        const memoryEntities = this.extractEntities(memory);
+        // Skip if memory has no linked entities
+        if (this.countEntities(memoryEntities) === 0) {
+            return edges;
+        }
+        for (const candidate of candidates) {
+            const candidateEntities = this.extractEntities(candidate);
+            // Skip if candidate has no linked entities
+            if (this.countEntities(candidateEntities) === 0) {
+                continue;
+            }
+            const overlap = this.calculateOverlap(memoryEntities, candidateEntities);
+            if (overlap.score < this.config.minOverlapRatio) {
+                continue;
+            }
+            const relation = this.determineRelation(memory, candidate, overlap);
+            edges.push({
+                sourceId: candidate.id,
+                targetId: memory.id,
+                relation,
+                confidence: overlap.score,
+                evidence: this.createEvidence(overlap),
+            });
+        }
+        return edges;
+    }
+    /**
+     * Extract all entities from a memory
+     */
+    extractEntities(memory) {
+        return {
+            files: new Set(memory.linkedFiles || []),
+            functions: new Set(memory.linkedFunctions || []),
+            patterns: new Set(memory.linkedPatterns || []),
+            constraints: new Set(memory.linkedConstraints || []),
+        };
+    }
+    /**
+     * Count total entities
+     */
+    countEntities(entities) {
+        return (entities.files.size +
+            entities.functions.size +
+            entities.patterns.size +
+            entities.constraints.size);
+    }
+    /**
+     * Calculate overlap between two entity sets
+     */
+    calculateOverlap(a, b) {
+        const fileOverlap = this.setOverlap(a.files, b.files);
+        const functionOverlap = this.setOverlap(a.functions, b.functions);
+        const patternOverlap = this.setOverlap(a.patterns, b.patterns);
+        const constraintOverlap = this.setOverlap(a.constraints, b.constraints);
+        // Weighted score
+        let totalWeight = 0;
+        let weightedScore = 0;
+        if (a.files.size > 0 || b.files.size > 0) {
+            weightedScore += fileOverlap.ratio * this.config.fileWeight;
+            totalWeight += this.config.fileWeight;
+        }
+        if (a.functions.size > 0 || b.functions.size > 0) {
+            weightedScore += functionOverlap.ratio * this.config.functionWeight;
+            totalWeight += this.config.functionWeight;
+        }
+        if (a.patterns.size > 0 || b.patterns.size > 0) {
+            weightedScore += patternOverlap.ratio * this.config.patternWeight;
+            totalWeight += this.config.patternWeight;
+        }
+        if (a.constraints.size > 0 || b.constraints.size > 0) {
+            weightedScore += constraintOverlap.ratio * this.config.constraintWeight;
+            totalWeight += this.config.constraintWeight;
+        }
+        const score = totalWeight > 0 ? weightedScore / totalWeight : 0;
+        return {
+            score,
+            files: fileOverlap,
+            functions: functionOverlap,
+            patterns: patternOverlap,
+            constraints: constraintOverlap,
+        };
+    }
+    /**
+     * Calculate overlap between two sets
+     */
+    setOverlap(a, b) {
+        if (a.size === 0 && b.size === 0) {
+            return { intersection: [], ratio: 0 };
+        }
+        const intersection = [...a].filter(x => b.has(x));
+        const union = new Set([...a, ...b]);
+        const ratio = intersection.length / union.size;
+        return { intersection, ratio };
+    }
+    /**
+     * Determine the causal relation type
+     */
+    determineRelation(_memory, candidate, overlap) {
+        // Strong file overlap suggests direct derivation
+        if (overlap.files.ratio > 0.5) {
+            return 'derived_from';
+        }
+        // Function overlap suggests code-level causation
+        if (overlap.functions.ratio > 0.5) {
+            return 'caused';
+        }
+        // Pattern overlap suggests enabling
+        if (overlap.patterns.ratio > 0.5) {
+            return 'enabled';
+        }
+        // Constraint overlap suggests support
+        if (overlap.constraints.ratio > 0.5) {
+            return 'supports';
+        }
+        // Default based on memory types
+        if (candidate.type === 'episodic') {
+            return 'triggered_by';
+        }
+        return 'supports';
+    }
+    /**
+     * Create evidence for the inference
+     */
+    createEvidence(overlap) {
+        const details = [];
+        if (overlap.files.intersection.length > 0) {
+            details.push(`${overlap.files.intersection.length} shared file(s)`);
+        }
+        if (overlap.functions.intersection.length > 0) {
+            details.push(`${overlap.functions.intersection.length} shared function(s)`);
+        }
+        if (overlap.patterns.intersection.length > 0) {
+            details.push(`${overlap.patterns.intersection.length} shared pattern(s)`);
+        }
+        if (overlap.constraints.intersection.length > 0) {
+            details.push(`${overlap.constraints.intersection.length} shared constraint(s)`);
+        }
+        const description = details.length > 0
+            ? `Entity overlap: ${details.join(', ')}`
+            : `Entity overlap score: ${Math.round(overlap.score * 100)}%`;
+        return {
+            type: 'entity',
+            description,
+            confidence: overlap.score,
+            gatheredAt: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=entity.js.map

package/dist/causal/inference/entity.js.map

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

package/dist/causal/inference/explicit.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Explicit Reference Inference Strategy
+ *
+ * Infers causal relationships based on explicit references
+ * in memory content. Looks for memory IDs, supersedes/supersededBy
+ * fields, and textual references.
+ *
+ * @module causal/inference/explicit
+ */
+import type { Memory } from '../../types/memory.js';
+import type { IInferenceStrategy, InferredEdge } from './engine.js';
+/**
+ * Explicit inference configuration
+ */
+export interface ExplicitInferenceConfig {
+    /** Confidence for supersedes relationships */
+    supersedesConfidence: number;
+    /** Confidence for ID references */
+    idReferenceConfidence: number;
+    /** Confidence for textual references */
+    textualReferenceConfidence: number;
+}
+/**
+ * Explicit reference inference strategy
+ *
+ * Finds causal relationships from explicit references
+ * in memory metadata and content.
+ */
+export declare class ExplicitInferenceStrategy implements IInferenceStrategy {
+    readonly name: "explicit_reference";
+    private config;
+    constructor(config?: Partial<ExplicitInferenceConfig>);
+    /**
+     * Infer causal edges based on explicit references
+     */
+    infer(memory: Memory, candidates: Memory[]): Promise<InferredEdge[]>;
+    /**
+     * Find memory ID references in content
+     */
+    private findMemoryIdReferences;
+    /**
+     * Find textual references to other memories
+     */
+    private findTextualReferences;
+    /**
+     * Get searchable content from a memory
+     */
+    private getSearchableContent;
+    /**
+     * Get searchable terms from a memory
+     */
+    private getSearchableTerms;
+    /**
+     * Calculate confidence based on term specificity
+     */
+    private calculateTermConfidence;
+    /**
+     * Create evidence for the inference
+     */
+    private createEvidence;
+}
+//# sourceMappingURL=explicit.d.ts.map

package/dist/causal/inference/explicit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explicit.d.ts","sourceRoot":"","sources":["../../../src/causal/inference/explicit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mCAAmC;IACnC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wCAAwC;IACxC,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAWD;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAU;IAC9C,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAIrD;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyD1E;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgC9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoC7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,cAAc;CAwCvB"}

package/dist/causal/inference/explicit.js

@@ -0,0 +1,244 @@
+/**
+ * Explicit Reference Inference Strategy
+ *
+ * Infers causal relationships based on explicit references
+ * in memory content. Looks for memory IDs, supersedes/supersededBy
+ * fields, and textual references.
+ *
+ * @module causal/inference/explicit
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    supersedesConfidence: 0.95,
+    idReferenceConfidence: 0.85,
+    textualReferenceConfidence: 0.6,
+};
+/**
+ * Explicit reference inference strategy
+ *
+ * Finds causal relationships from explicit references
+ * in memory metadata and content.
+ */
+export class ExplicitInferenceStrategy {
+    name = 'explicit_reference';
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Infer causal edges based on explicit references
+     */
+    async infer(memory, candidates) {
+        const edges = [];
+        const candidateMap = new Map(candidates.map(c => [c.id, c]));
+        // Check supersedes/supersededBy fields
+        if (memory.supersedes && candidateMap.has(memory.supersedes)) {
+            edges.push({
+                sourceId: memory.supersedes,
+                targetId: memory.id,
+                relation: 'supersedes',
+                confidence: this.config.supersedesConfidence,
+                evidence: this.createEvidence('supersedes', memory.supersedes),
+            });
+        }
+        if (memory.supersededBy && candidateMap.has(memory.supersededBy)) {
+            edges.push({
+                sourceId: memory.id,
+                targetId: memory.supersededBy,
+                relation: 'supersedes',
+                confidence: this.config.supersedesConfidence,
+                evidence: this.createEvidence('supersededBy', memory.supersededBy),
+            });
+        }
+        // Check for memory ID references in content
+        const contentRefs = this.findMemoryIdReferences(memory, candidateMap);
+        for (const ref of contentRefs) {
+            edges.push({
+                sourceId: ref.referencedId,
+                targetId: memory.id,
+                relation: 'derived_from',
+                confidence: this.config.idReferenceConfidence,
+                evidence: this.createEvidence('idReference', ref.referencedId, ref.context),
+            });
+        }
+        // Check for textual references (topic/name mentions)
+        const textualRefs = this.findTextualReferences(memory, candidates);
+        for (const ref of textualRefs) {
+            // Avoid duplicates
+            if (edges.some(e => e.sourceId === ref.candidateId)) {
+                continue;
+            }
+            edges.push({
+                sourceId: ref.candidateId,
+                targetId: memory.id,
+                relation: 'supports',
+                confidence: ref.confidence,
+                evidence: this.createEvidence('textualReference', ref.candidateId, ref.matchedText),
+            });
+        }
+        return edges;
+    }
+    /**
+     * Find memory ID references in content
+     */
+    findMemoryIdReferences(memory, candidateMap) {
+        const refs = [];
+        // Memory ID pattern: mem_<timestamp>_<random>
+        const idPattern = /mem_[a-z0-9]+_[a-f0-9]+/gi;
+        // Search in various content fields
+        const contentToSearch = this.getSearchableContent(memory);
+        for (const content of contentToSearch) {
+            const matches = content.match(idPattern);
+            if (matches) {
+                for (const match of matches) {
+                    if (candidateMap.has(match) && match !== memory.id) {
+                        // Extract context around the reference
+                        const index = content.indexOf(match);
+                        const start = Math.max(0, index - 30);
+                        const end = Math.min(content.length, index + match.length + 30);
+                        const context = content.slice(start, end);
+                        refs.push({ referencedId: match, context });
+                    }
+                }
+            }
+        }
+        return refs;
+    }
+    /**
+     * Find textual references to other memories
+     */
+    findTextualReferences(memory, candidates) {
+        const refs = [];
+        const contentToSearch = this.getSearchableContent(memory).join(' ').toLowerCase();
+        for (const candidate of candidates) {
+            // Get searchable terms from candidate
+            const terms = this.getSearchableTerms(candidate);
+            for (const term of terms) {
+                if (term.length < 4)
+                    continue; // Skip short terms
+                const termLower = term.toLowerCase();
+                // Check for exact match
+                if (contentToSearch.includes(termLower)) {
+                    // Calculate confidence based on term specificity
+                    const confidence = this.calculateTermConfidence(term, contentToSearch);
+                    if (confidence >= 0.3) {
+                        refs.push({
+                            candidateId: candidate.id,
+                            matchedText: term,
+                            confidence: Math.min(confidence, this.config.textualReferenceConfidence),
+                        });
+                        break; // One match per candidate is enough
+                    }
+                }
+            }
+        }
+        return refs;
+    }
+    /**
+     * Get searchable content from a memory
+     */
+    getSearchableContent(memory) {
+        const content = [memory.summary];
+        // Type-specific content
+        if ('knowledge' in memory && typeof memory.knowledge === 'string') {
+            content.push(memory.knowledge);
+        }
+        if ('rationale' in memory && typeof memory.rationale === 'string') {
+            content.push(memory.rationale);
+        }
+        if ('context' in memory && typeof memory.context === 'string') {
+            content.push(memory.context);
+        }
+        if ('description' in memory && typeof memory.description === 'string') {
+            content.push(memory.description);
+        }
+        if ('warnings' in memory && Array.isArray(memory.warnings)) {
+            content.push(...memory.warnings);
+        }
+        return content.filter(Boolean);
+    }
+    /**
+     * Get searchable terms from a memory
+     */
+    getSearchableTerms(memory) {
+        const terms = [];
+        // Add topic/name
+        if ('topic' in memory && typeof memory.topic === 'string') {
+            terms.push(memory.topic);
+        }
+        if ('name' in memory && typeof memory.name === 'string') {
+            terms.push(memory.name);
+        }
+        if ('patternName' in memory && typeof memory.patternName === 'string') {
+            terms.push(memory.patternName);
+        }
+        if ('constraintName' in memory && typeof memory.constraintName === 'string') {
+            terms.push(memory.constraintName);
+        }
+        // Add tags
+        if (memory.tags) {
+            terms.push(...memory.tags);
+        }
+        return terms.filter(t => t && t.length >= 4);
+    }
+    /**
+     * Calculate confidence based on term specificity
+     */
+    calculateTermConfidence(term, content) {
+        // Longer terms are more specific
+        const lengthFactor = Math.min(1, term.length / 20);
+        // Count occurrences
+        const regex = new RegExp(term.toLowerCase(), 'gi');
+        const matches = content.match(regex);
+        const occurrences = matches ? matches.length : 0;
+        // More occurrences = higher confidence (up to a point)
+        const occurrenceFactor = Math.min(1, occurrences / 3);
+        // Check if it's a common word
+        const commonWords = new Set([
+            'function', 'class', 'method', 'variable', 'const', 'type',
+            'error', 'warning', 'info', 'data', 'value', 'result',
+            'user', 'admin', 'system', 'config', 'settings',
+        ]);
+        const specificityFactor = commonWords.has(term.toLowerCase()) ? 0.3 : 1.0;
+        return lengthFactor * 0.3 + occurrenceFactor * 0.3 + specificityFactor * 0.4;
+    }
+    /**
+     * Create evidence for the inference
+     */
+    createEvidence(type, referencedId, context) {
+        let description;
+        switch (type) {
+            case 'supersedes':
+                description = `Explicitly supersedes memory ${referencedId}`;
+                break;
+            case 'supersededBy':
+                description = `Explicitly superseded by memory ${referencedId}`;
+                break;
+            case 'idReference':
+                description = context
+                    ? `References memory ID in content: "...${context}..."`
+                    : `References memory ID ${referencedId}`;
+                break;
+            case 'textualReference':
+                description = context
+                    ? `Textual reference to "${context}"`
+                    : `Textual reference found`;
+                break;
+        }
+        const confidence = type === 'supersedes' || type === 'supersededBy'
+            ? this.config.supersedesConfidence
+            : type === 'idReference'
+                ? this.config.idReferenceConfidence
+                : this.config.textualReferenceConfidence;
+        return {
+            type: 'explicit',
+            description,
+            confidence,
+            reference: referencedId,
+            gatheredAt: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=explicit.js.map

package/dist/causal/inference/explicit.js.map

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

package/dist/causal/inference/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Causal Inference Module
+ *
+ * Automatic inference of causal relationships between memories.
+ */
+export * from './engine.js';
+export * from './temporal.js';
+export * from './semantic.js';
+export * from './entity.js';
+export * from './explicit.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/causal/inference/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/causal/inference/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/causal/inference/index.js

@@ -0,0 +1,11 @@
+/**
+ * Causal Inference Module
+ *
+ * Automatic inference of causal relationships between memories.
+ */
+export * from './engine.js';
+export * from './temporal.js';
+export * from './semantic.js';
+export * from './entity.js';
+export * from './explicit.js';
+//# sourceMappingURL=index.js.map

package/dist/causal/inference/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/causal/inference/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/causal/inference/semantic.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Semantic Similarity Inference Strategy
+ *
+ * Infers causal relationships based on semantic similarity
+ * of memory content. Memories with similar topics, knowledge,
+ * or context are more likely to be related.
+ *
+ * @module causal/inference/semantic
+ */
+import type { Memory } from '../../types/memory.js';
+import type { IInferenceStrategy, InferredEdge } from './engine.js';
+/**
+ * Semantic inference configuration
+ */
+export interface SemanticInferenceConfig {
+    /** Minimum similarity score to consider */
+    minSimilarity: number;
+    /** Weight for topic similarity */
+    topicWeight: number;
+    /** Weight for tag overlap */
+    tagWeight: number;
+    /** Weight for linked entity overlap */
+    entityWeight: number;
+}
+/**
+ * Semantic similarity inference strategy
+ *
+ * Uses text similarity and shared attributes to infer
+ * causal relationships.
+ */
+export declare class SemanticInferenceStrategy implements IInferenceStrategy {
+    readonly name: "semantic_similarity";
+    private config;
+    constructor(config?: Partial<SemanticInferenceConfig>);
+    /**
+     * Infer causal edges based on semantic similarity
+     */
+    infer(memory: Memory, candidates: Memory[]): Promise<InferredEdge[]>;
+    /**
+     * Calculate semantic similarity between two memories
+     */
+    private calculateSimilarity;
+    /**
+     * Calculate topic similarity
+     */
+    private calculateTopicSimilarity;
+    /**
+     * Calculate tag similarity using Jaccard index
+     */
+    private calculateTagSimilarity;
+    /**
+     * Calculate linked entity similarity
+     */
+    private calculateEntitySimilarity;
+    /**
+     * Extract topic from memory
+     */
+    private extractTopic;
+    /**
+     * Extract all linked entities from a memory
+     */
+    private extractLinkedEntities;
+    /**
+     * Determine the causal relation type
+     */
+    private determineRelation;
+    /**
+     * Create evidence for the inference
+     */
+    private createEvidence;
+}
+//# sourceMappingURL=semantic.d.ts.map

package/dist/causal/inference/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../../src/causal/inference/semantic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAU;IAC/C,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAIrD;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwB1E;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAiChC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,cAAc;CAkCvB"}