squish-memory 0.7.0

package/dist/core/memory/hybrid-retrieval.js

@@ -0,0 +1,63 @@
+import { hybridScore } from './hybrid-scorer.js';
+import { getEmbedding } from '../embeddings.js';
+import { searchMemories } from './memories.js';
+import { filterByEntities } from './entity-resolver.js';
+/**
+ * Hybrid search with multi-factor re-ranking + entity filtering
+ *
+ * Algorithm:
+ * 1. Fetch N candidates using vector similarity
+ * 2. Filter/boost by entity relevance (Phase 3)
+ * 3. Re-rank using hybrid scoring (semantic + recency + coactivation + importance)
+ * 4. Return top M results
+ *
+ * This provides better relevance than pure vector search
+ */
+export async function hybridSearch(options) {
+    const candidateLimit = options.candidateLimit ?? 50;
+    const resultLimit = options.resultLimit ?? options.limit ?? 5;
+    // Get query embedding
+    const queryEmbedding = await getEmbedding(options.query);
+    // Step 1: Fetch candidates using vector search
+    // We fetch more than we need to allow re-ranking
+    const candidates = await searchMemories({
+        ...options,
+        limit: candidateLimit,
+    });
+    if (candidates.length === 0) {
+        return [];
+    }
+    // Step 2: Entity filtering/boosting (Phase 3)
+    const entityScored = filterByEntities(candidates, options.queryEntities || []);
+    // Apply entity boost to memory metadata for scoring
+    const boostedCandidates = entityScored.map(({ memory, entityBoost }) => ({
+        ...memory,
+        _entityBoost: entityBoost,
+    }));
+    // Step 3: Re-rank using hybrid scoring
+    const scored = await hybridScore(queryEmbedding, boostedCandidates, {
+        ...options.hybridOptions,
+        weights: {
+            semantic: 0.35, // Vector similarity
+            recency: 0.25, // Time decay (favor recent)
+            coactivation: 0.20, // Graph associations
+            importance: 0.20, // Confidence + tier
+            ...options.hybridOptions?.weights,
+        },
+        decayDays: 7, // Weekly decay for benchmark data
+    });
+    // Step 4: Take top N results
+    const topResults = scored.slice(0, resultLimit);
+    // Format results
+    return topResults.map((scoredItem, index) => ({
+        ...scoredItem.memory,
+        hybridScore: scoredItem.totalScore,
+        semanticScore: scoredItem.components.semantic,
+        recencyScore: scoredItem.components.recency,
+        coactivationScore: scoredItem.components.coactivation,
+        importanceScore: scoredItem.components.importance,
+        entityBoost: scoredItem.memory._entityBoost || 0.5,
+        rank: index + 1,
+    }));
+}
+//# sourceMappingURL=hybrid-retrieval.js.map

package/dist/core/memory/hybrid-retrieval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-retrieval.js","sourceRoot":"","sources":["../../../core/memory/hybrid-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAuB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAA6B,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAmBxD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA4B;IAE5B,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAE9D,sBAAsB;IACtB,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAEzD,+CAA+C;IAC/C,iDAAiD;IACjD,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC;QACtC,GAAG,OAAO;QACV,KAAK,EAAE,cAAc;KACtB,CAAC,CAAC;IAEH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,8CAA8C;IAC9C,MAAM,YAAY,GAAG,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IAE/E,oDAAoD;IACpD,MAAM,iBAAiB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,GAAG,MAAM;QACT,YAAY,EAAE,WAAW;KAC1B,CAAC,CAAC,CAAC;IAEJ,uCAAuC;IACvC,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,cAAc,EACd,iBAAiB,EACjB;QACE,GAAG,OAAO,CAAC,aAAa;QACxB,OAAO,EAAE;YACP,QAAQ,EAAE,IAAI,EAAK,oBAAoB;YACvC,OAAO,EAAE,IAAI,EAAM,4BAA4B;YAC/C,YAAY,EAAE,IAAI,EAAE,qBAAqB;YACzC,UAAU,EAAE,IAAI,EAAG,oBAAoB;YACvC,GAAG,OAAO,CAAC,aAAa,EAAE,OAAO;SAClC;QACD,SAAS,EAAE,CAAC,EAAE,kCAAkC;KACjD,CACF,CAAC;IAEF,6BAA6B;IAC7B,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAEhD,iBAAiB;IACjB,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5C,GAAG,UAAU,CAAC,MAAM;QACpB,WAAW,EAAE,UAAU,CAAC,UAAU;QAClC,aAAa,EAAE,UAAU,CAAC,UAAU,CAAC,QAAQ;QAC7C,YAAY,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO;QAC3C,iBAAiB,EAAE,UAAU,CAAC,UAAU,CAAC,YAAY;QACrD,eAAe,EAAE,UAAU,CAAC,UAAU,CAAC,UAAU;QACjD,WAAW,EAAG,UAAU,CAAC,MAAc,CAAC,YAAY,IAAI,GAAG;QAC3D,IAAI,EAAE,KAAK,GAAG,CAAC;KAChB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/core/memory/hybrid-scorer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Hybrid Scorer
+ * Multi-factor relevance scoring combining semantic similarity, recency, co-activation, and importance
+ * Provides normalized scores (0-100) for memory ranking
+ */
+export interface ScoredMemory {
+    memoryId: string;
+    memory: any;
+    totalScore: number;
+    components: {
+        semantic: number;
+        recency: number;
+        coactivation: number;
+        importance: number;
+    };
+    rank: number;
+    explanation: string;
+}
+export interface HybridScorerOptions {
+    weights?: {
+        semantic?: number;
+        recency?: number;
+        coactivation?: number;
+        importance?: number;
+    };
+    decayDays?: number;
+    minSemanticScore?: number;
+    includeExplanation?: boolean;
+}
+/**
+ * Calculate hybrid relevance score for memories
+ * Combines: semantic similarity, recency, co-activation, and importance
+ */
+export declare function hybridScore(queryEmbedding: number[] | null, memories: any[], options?: HybridScorerOptions): Promise<ScoredMemory[]>;
+/**
+ * Score and rank memories by relevance
+ * Convenience function combining scoring and ranking
+ */
+export declare function scoreAndRankMemories(queryEmbedding: number[] | null, memories: any[], topK?: number, options?: HybridScorerOptions): Promise<ScoredMemory[]>;
+/**
+ * Get score distribution for diagnostics
+ */
+export declare function getScoreDistribution(scored: ScoredMemory[]): {
+    min: number;
+    max: number;
+    avg: number;
+    median: number;
+    p95: number;
+    p99: number;
+};
+//# sourceMappingURL=hybrid-scorer.d.ts.map

package/dist/core/memory/hybrid-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-scorer.d.ts","sourceRoot":"","sources":["../../../core/memory/hybrid-scorer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,EAC/B,QAAQ,EAAE,GAAG,EAAE,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,EAAE,CAAC,CA+DzB;AAsLD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,EAC/B,QAAQ,EAAE,GAAG,EAAE,EACf,IAAI,GAAE,MAAW,EACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,EAAE,CAAC,CAazB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EAAE,GACrB;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb,CAeA"}

package/dist/core/memory/hybrid-scorer.js

@@ -0,0 +1,248 @@
+/**
+ * Hybrid Scorer
+ * Multi-factor relevance scoring combining semantic similarity, recency, co-activation, and importance
+ * Provides normalized scores (0-100) for memory ranking
+ */
+import { logger } from '../../core/logger.js';
+/**
+ * Calculate hybrid relevance score for memories
+ * Combines: semantic similarity, recency, co-activation, and importance
+ */
+export async function hybridScore(queryEmbedding, memories, options = {}) {
+    // Default weights (0.4, 0.2, 0.2, 0.2 = 1.0 total)
+    const weights = {
+        semantic: options.weights?.semantic ?? 0.4,
+        recency: options.weights?.recency ?? 0.2,
+        coactivation: options.weights?.coactivation ?? 0.2,
+        importance: options.weights?.importance ?? 0.2,
+    };
+    const decayDays = options.decayDays ?? 30;
+    const minSemanticScore = options.minSemanticScore ?? 0.0;
+    const scored = [];
+    const now = new Date();
+    for (const memory of memories) {
+        // Skip if embedding-only filtering is requested and score is below threshold
+        if (queryEmbedding && weights.semantic > 0) {
+            const semanticScore = calculateSemanticScore(queryEmbedding, memory);
+            if (semanticScore < minSemanticScore)
+                continue;
+        }
+        // Calculate component scores
+        const components = {
+            semantic: queryEmbedding ? calculateSemanticScore(queryEmbedding, memory) : 50,
+            recency: calculateRecencyScore(memory, now, decayDays),
+            coactivation: calculateCoactivationScore(memory),
+            importance: calculateImportanceScore(memory),
+        };
+        // Calculate weighted total
+        const totalScore = Math.min(100, components.semantic * weights.semantic +
+            components.recency * weights.recency +
+            components.coactivation * weights.coactivation +
+            components.importance * weights.importance);
+        scored.push({
+            memoryId: memory.id,
+            memory,
+            totalScore: Math.round(totalScore * 100) / 100,
+            components: {
+                semantic: Math.round(components.semantic * 100) / 100,
+                recency: Math.round(components.recency * 100) / 100,
+                coactivation: Math.round(components.coactivation * 100) / 100,
+                importance: Math.round(components.importance * 100) / 100,
+            },
+            rank: 0,
+            explanation: options.includeExplanation
+                ? generateScoreExplanation(components, weights, memory)
+                : '',
+        });
+    }
+    // Sort by total score descending and assign ranks
+    scored.sort((a, b) => b.totalScore - a.totalScore);
+    for (let i = 0; i < scored.length; i++) {
+        scored[i].rank = i + 1;
+    }
+    return scored;
+}
+/**
+ * Calculate semantic similarity score (0-100)
+ * Uses cosine similarity between query and memory embeddings
+ */
+function calculateSemanticScore(queryEmbedding, memory) {
+    if (!memory.embedding || queryEmbedding.length === 0) {
+        return 50; // Default to neutral score
+    }
+    try {
+        let memoryEmbedding = null;
+        if (Array.isArray(memory.embedding)) {
+            memoryEmbedding = memory.embedding;
+        }
+        else if (typeof memory.embedding === 'string') {
+            memoryEmbedding = JSON.parse(memory.embedding);
+        }
+        if (!memoryEmbedding || memoryEmbedding.length === 0) {
+            return 50;
+        }
+        // Cosine similarity
+        const cosineSimilarity = calculateCosineSimilarity(queryEmbedding, memoryEmbedding);
+        // Convert -1...1 range to 0...100 range
+        // Cosine similarity is typically 0...1 for normalized vectors
+        return Math.max(0, Math.min(100, (cosineSimilarity + 1) * 50));
+    }
+    catch (error) {
+        logger.error('Error calculating semantic score', error);
+        return 50;
+    }
+}
+/**
+ * Calculate recency score (0-100)
+ * Uses exponential decay based on days since creation
+ * Half-life is configurable (default 30 days)
+ */
+function calculateRecencyScore(memory, now, decayDays) {
+    if (!memory.createdAt)
+        return 50;
+    const createdDate = new Date(memory.createdAt);
+    const daysSinceCreation = (now.getTime() - createdDate.getTime()) / (24 * 60 * 60 * 1000);
+    // Exponential decay: score = 100 * (0.5 ^ (days / halfLife))
+    const score = 100 * Math.pow(0.5, daysSinceCreation / decayDays);
+    return Math.max(0, Math.min(100, score));
+}
+/**
+ * Calculate co-activation score (0-100)
+ * Based on how often this memory appears with others
+ */
+function calculateCoactivationScore(memory) {
+    if (!memory.coactivationScore || memory.coactivationScore === 0) {
+        return 10; // Default low score
+    }
+    // Normalize co-activation score to 0-100 range
+    // Assuming co-activation scores are typically 0-20+
+    const normalized = Math.min(100, memory.coactivationScore * 5);
+    return normalized;
+}
+/**
+ * Calculate importance score (0-100)
+ * Based on relevance score, tier classification, and protection status
+ */
+function calculateImportanceScore(memory) {
+    let score = 50; // Base score
+    // Add points for tier
+    if (memory.tier === 'hot') {
+        score += 30;
+    }
+    else if (memory.tier === 'warm') {
+        score += 15;
+    }
+    else if (memory.tier === 'cold') {
+        score += 0;
+    }
+    // Add points for relevance score (0-100)
+    if (memory.relevanceScore) {
+        score += memory.relevanceScore * 0.2; // Max +20 points
+    }
+    // Add points for pinned/protected status
+    if (memory.isPinned)
+        score += 10;
+    if (memory.isProtected)
+        score += 10;
+    // Subtract points for being marked for merging
+    if (memory.isMergeable || memory.isMerged)
+        score -= 10;
+    return Math.max(0, Math.min(100, score));
+}
+/**
+ * Calculate cosine similarity between two vectors
+ */
+function calculateCosineSimilarity(vecA, vecB) {
+    if (vecA.length !== vecB.length) {
+        return 0;
+    }
+    let dotProduct = 0;
+    let magnitudeA = 0;
+    let magnitudeB = 0;
+    for (let i = 0; i < vecA.length; i++) {
+        dotProduct += vecA[i] * vecB[i];
+        magnitudeA += vecA[i] * vecA[i];
+        magnitudeB += vecB[i] * vecB[i];
+    }
+    magnitudeA = Math.sqrt(magnitudeA);
+    magnitudeB = Math.sqrt(magnitudeB);
+    if (magnitudeA === 0 || magnitudeB === 0) {
+        return 0;
+    }
+    return dotProduct / (magnitudeA * magnitudeB);
+}
+/**
+ * Generate human-readable explanation for score
+ */
+function generateScoreExplanation(components, weights, memory) {
+    const parts = [];
+    // Semantic similarity
+    if (components.semantic > 70) {
+        parts.push(`highly relevant (${components.semantic.toFixed(0)})`);
+    }
+    else if (components.semantic > 50) {
+        parts.push(`somewhat relevant (${components.semantic.toFixed(0)})`);
+    }
+    else {
+        parts.push(`low relevance (${components.semantic.toFixed(0)})`);
+    }
+    // Recency
+    if (components.recency > 70) {
+        parts.push(`recent`);
+    }
+    else if (components.recency > 30) {
+        parts.push(`moderately recent`);
+    }
+    else {
+        parts.push(`older`);
+    }
+    // Tier
+    if (memory.tier === 'hot') {
+        parts.push(`active memory`);
+    }
+    else if (memory.tier === 'warm') {
+        parts.push(`accessible memory`);
+    }
+    else {
+        parts.push(`archived memory`);
+    }
+    // Frequently co-activated
+    if (components.coactivation > 60) {
+        parts.push(`frequently associated`);
+    }
+    return parts.join(', ');
+}
+/**
+ * Score and rank memories by relevance
+ * Convenience function combining scoring and ranking
+ */
+export async function scoreAndRankMemories(queryEmbedding, memories, topK = 10, options = {}) {
+    const scored = await hybridScore(queryEmbedding, memories, options);
+    logger.debug('Scored and ranked memories', {
+        total: scored.length,
+        topK,
+        topScores: scored.slice(0, topK).map((s) => ({
+            id: s.memoryId,
+            score: s.totalScore,
+        })),
+    });
+    return scored.slice(0, topK);
+}
+/**
+ * Get score distribution for diagnostics
+ */
+export function getScoreDistribution(scored) {
+    if (scored.length === 0) {
+        return { min: 0, max: 0, avg: 0, median: 0, p95: 0, p99: 0 };
+    }
+    const scores = scored.map((s) => s.totalScore).sort((a, b) => a - b);
+    return {
+        min: scores[0],
+        max: scores[scores.length - 1],
+        avg: scores.reduce((a, b) => a + b, 0) / scores.length,
+        median: scores[Math.floor(scores.length / 2)],
+        p95: scores[Math.floor((95 / 100) * scores.length)],
+        p99: scores[Math.floor((99 / 100) * scores.length)],
+    };
+}
+//# sourceMappingURL=hybrid-scorer.js.map

package/dist/core/memory/hybrid-scorer.js.map

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

package/dist/core/memory/index.d.ts

@@ -0,0 +1,8 @@
+export * from './memories.js';
+export * from './memory-manager.js';
+export * from './serialization.js';
+export * from './temporal-parser.js';
+export * from './entity-extractor.js';
+export * from './hybrid-scorer.js';
+export * from './bridge-discovery.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/memory/index.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/dist/core/memory/index.js

@@ -0,0 +1,10 @@
+// Memory feature - Store and manage memories
+export * from './memories.js';
+export * from './memory-manager.js';
+export * from './serialization.js';
+// Advanced memory features
+export * from './temporal-parser.js';
+export * from './entity-extractor.js';
+export * from './hybrid-scorer.js';
+export * from './bridge-discovery.js';
+//# sourceMappingURL=index.js.map

package/dist/core/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/memory/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC,2BAA2B;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/dist/core/memory/memories.d.ts

@@ -0,0 +1,35 @@
+export type MemoryType = 'observation' | 'fact' | 'decision' | 'context' | 'preference';
+export interface RememberInput {
+    content: string;
+    type?: MemoryType;
+    tags?: string[];
+    project?: string;
+    metadata?: Record<string, unknown>;
+    source?: string;
+}
+export interface SearchInput {
+    query: string;
+    type?: MemoryType;
+    tags?: string[];
+    limit?: number;
+    project?: string;
+}
+export interface MemoryRecord {
+    id: string;
+    projectId?: string | null;
+    type: MemoryType;
+    content: string;
+    summary?: string | null;
+    tags: string[];
+    metadata?: Record<string, unknown> | null;
+    createdAt?: string | null;
+    similarity?: number;
+}
+export interface SearchResult extends MemoryRecord {
+    similarity: number;
+}
+export declare function rememberMemory(input: RememberInput): Promise<MemoryRecord>;
+export declare function getMemoryById(id: string): Promise<MemoryRecord | null>;
+export declare function getRecentMemories(projectPath: string, limit: number): Promise<MemoryRecord[]>;
+export declare function searchMemories(input: SearchInput): Promise<SearchResult[]>;
+//# sourceMappingURL=memories.d.ts.map

package/dist/core/memory/memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../../core/memory/memories.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAExF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAkEhF;AAED,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAc5E;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAmBnG;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAShF"}