mindgraph-core 0.1.0

package/dist/query/graph-search.js

@@ -0,0 +1,315 @@
+import { NodeType, RelType } from '../schema/types.js';
+const DEFAULT_AGENT_ID = 'agent:self';
+/**
+ * Graph-based search for beliefs, contradictions, and temporal queries.
+ */
+export class GraphSearch {
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * "What do I believe about X?"
+     * Finds propositions and thoughts related to a topic.
+     */
+    async queryBeliefs(topic, limit = 20) {
+        // Find entities/concepts matching the topic
+        const relatedNodes = await this.findTopicNodes(topic);
+        if (relatedNodes.length === 0) {
+            // Fallback: search propositions by keyword
+            return this.searchBeliefsByKeyword(topic, limit);
+        }
+        const beliefs = [];
+        for (const topicNode of relatedNodes) {
+            // Find propositions/thoughts ABOUT this entity/concept
+            const aboutEdges = await this.storage.queryEdges({
+                targetId: topicNode.id,
+                relType: RelType.ABOUT,
+            });
+            for (const edge of aboutEdges) {
+                const belief = await this.buildBeliefEntry(edge.sourceId);
+                if (belief)
+                    beliefs.push(belief);
+            }
+            // Also find chunks that MENTION this entity and their derived propositions
+            const mentionEdges = await this.storage.queryEdges({
+                targetId: topicNode.id,
+                relType: RelType.MENTIONS,
+            });
+            for (const mentionEdge of mentionEdges) {
+                // Find propositions derived from this chunk
+                const derivedEdges = await this.storage.queryEdges({
+                    targetId: mentionEdge.sourceId,
+                    relType: RelType.DERIVED_FROM,
+                });
+                for (const derivedEdge of derivedEdges) {
+                    const node = await this.storage.getNode(derivedEdge.sourceId);
+                    if (node &&
+                        (node.nodeType === NodeType.Proposition || node.nodeType === NodeType.Thought)) {
+                        const belief = await this.buildBeliefEntry(node.id);
+                        if (belief && !beliefs.find((b) => b.propositionId === belief.propositionId)) {
+                            beliefs.push(belief);
+                        }
+                    }
+                }
+            }
+        }
+        // Sort by confidence descending, then by date
+        beliefs.sort((a, b) => b.confidence - a.confidence);
+        return beliefs.slice(0, limit);
+    }
+    /**
+     * "Show contradictions about X"
+     * Finds conflicting proposition pairs about a topic.
+     */
+    async queryContradictions(topic) {
+        const beliefs = await this.queryBeliefs(topic, 100);
+        const contradictions = [];
+        for (const belief of beliefs) {
+            // Check if this proposition has CONTRADICTS edges
+            const contradictEdges = await this.storage.queryEdges({
+                sourceId: belief.propositionId,
+                relType: RelType.CONTRADICTS,
+            });
+            for (const edge of contradictEdges) {
+                const otherBelief = await this.buildBeliefEntry(edge.targetId);
+                if (otherBelief) {
+                    // Avoid duplicates (A contradicts B = B contradicts A)
+                    const alreadyFound = contradictions.some((c) => (c.propositionA.propositionId === belief.propositionId &&
+                        c.propositionB.propositionId === otherBelief.propositionId) ||
+                        (c.propositionA.propositionId === otherBelief.propositionId &&
+                            c.propositionB.propositionId === belief.propositionId));
+                    if (!alreadyFound) {
+                        contradictions.push({
+                            propositionA: belief,
+                            propositionB: otherBelief,
+                            edgeId: edge.id,
+                        });
+                    }
+                }
+            }
+        }
+        return contradictions;
+    }
+    /**
+     * "How has my view changed about X?"
+     * Returns beliefs ordered by note date.
+     */
+    async queryBeliefTimeline(topic) {
+        const beliefs = await this.queryBeliefs(topic, 100);
+        // Sort by noteDate ascending for chronological view
+        beliefs.sort((a, b) => a.noteDate.localeCompare(b.noteDate));
+        return beliefs;
+    }
+    /**
+     * Get all extracted objects for a specific note.
+     */
+    async getExtractionsForNote(notePath) {
+        // Find all chunks for this note
+        const noteNodes = await this.storage.queryNodes({
+            nodeType: NodeType.Note,
+            where: { path: notePath },
+        });
+        if (noteNodes.length === 0) {
+            return { entities: [], concepts: [], propositions: [], thoughts: [] };
+        }
+        const noteId = noteNodes[0].id;
+        const chunkEdges = await this.storage.queryEdges({
+            sourceId: noteId,
+            relType: RelType.HAS_CHUNK,
+        });
+        const entities = new Map();
+        const concepts = new Map();
+        const propositions = new Map();
+        const thoughts = new Map();
+        for (const chunkEdge of chunkEdges) {
+            // Find entities/concepts mentioned in this chunk
+            const mentionEdges = await this.storage.queryEdges({
+                sourceId: chunkEdge.targetId,
+                relType: RelType.MENTIONS,
+            });
+            for (const e of mentionEdges) {
+                const node = await this.storage.getNode(e.targetId);
+                if (node) {
+                    if (node.nodeType === NodeType.Entity)
+                        entities.set(node.id, node);
+                    if (node.nodeType === NodeType.Concept)
+                        concepts.set(node.id, node);
+                }
+            }
+            // Find propositions/thoughts derived from this chunk
+            const derivedEdges = await this.storage.queryEdges({
+                targetId: chunkEdge.targetId,
+                relType: RelType.DERIVED_FROM,
+            });
+            for (const e of derivedEdges) {
+                const node = await this.storage.getNode(e.sourceId);
+                if (node) {
+                    if (node.nodeType === NodeType.Proposition)
+                        propositions.set(node.id, node);
+                    if (node.nodeType === NodeType.Thought)
+                        thoughts.set(node.id, node);
+                }
+            }
+        }
+        return {
+            entities: Array.from(entities.values()),
+            concepts: Array.from(concepts.values()),
+            propositions: Array.from(propositions.values()),
+            thoughts: Array.from(thoughts.values()),
+        };
+    }
+    /**
+     * Build a belief card aggregating beliefs about a topic.
+     * Returns confidence, date range, citations, contradiction count.
+     */
+    async queryBeliefCard(topic) {
+        const beliefs = await this.queryBeliefs(topic, 50);
+        const entries = [];
+        for (const belief of beliefs) {
+            // Get all dates for this proposition
+            const allDates = belief.citations
+                .map((c) => c.notePath)
+                .filter(Boolean);
+            // Count contradictions
+            const contradictEdges = await this.storage.queryEdges({
+                sourceId: belief.propositionId,
+                relType: RelType.CONTRADICTS,
+            });
+            const reverseContradictEdges = await this.storage.queryEdges({
+                targetId: belief.propositionId,
+                relType: RelType.CONTRADICTS,
+            });
+            const contradictionCount = contradictEdges.length + reverseContradictEdges.length;
+            // Get top 3 citations
+            const topCitations = belief.citations.slice(0, 3);
+            entries.push({
+                propositionId: belief.propositionId,
+                statement: belief.statement,
+                confidence: belief.confidence,
+                firstSeen: belief.noteDate,
+                lastSeen: belief.noteDate,
+                citations: topCitations,
+                contradictionCount,
+            });
+        }
+        // Sort by confidence descending, take top 10
+        entries.sort((a, b) => b.confidence - a.confidence);
+        const topEntries = entries.slice(0, 10);
+        const allDates = topEntries.map((e) => e.firstSeen).filter(Boolean);
+        const avgConfidence = topEntries.length > 0
+            ? topEntries.reduce((s, e) => s + e.confidence, 0) / topEntries.length
+            : 0;
+        return {
+            topic,
+            entries: topEntries,
+            totalPropositions: beliefs.length,
+            avgConfidence: Math.round(avgConfidence * 100) / 100,
+            dateRange: {
+                from: allDates.length > 0 ? allDates.sort()[0] : '',
+                to: allDates.length > 0 ? allDates.sort().pop() : '',
+            },
+        };
+    }
+    // ─── Private helpers ─────────────────────────────────────────────
+    async findTopicNodes(topic) {
+        const topicLower = topic.toLowerCase();
+        const results = [];
+        // Search entities
+        const entities = await this.storage.queryNodes({ nodeType: NodeType.Entity });
+        for (const entity of entities) {
+            const name = entity.data.name;
+            const aliases = entity.data.aliases ?? [];
+            if (name.toLowerCase().includes(topicLower) ||
+                aliases.some((a) => a.toLowerCase().includes(topicLower))) {
+                results.push(entity);
+            }
+        }
+        // Search concepts
+        const concepts = await this.storage.queryNodes({ nodeType: NodeType.Concept });
+        for (const concept of concepts) {
+            const name = concept.data.name;
+            if (name.toLowerCase().includes(topicLower)) {
+                results.push(concept);
+            }
+        }
+        return results;
+    }
+    async searchBeliefsByKeyword(keyword, limit) {
+        const keywordLower = keyword.toLowerCase();
+        const beliefs = [];
+        // Search propositions by statement text
+        const propositions = await this.storage.queryNodes({
+            nodeType: NodeType.Proposition,
+            limit: limit * 2,
+        });
+        for (const prop of propositions) {
+            const data = prop.data;
+            if (data.statement.toLowerCase().includes(keywordLower)) {
+                const belief = await this.buildBeliefEntry(prop.id);
+                if (belief)
+                    beliefs.push(belief);
+            }
+        }
+        // Search thoughts
+        const thoughts = await this.storage.queryNodes({
+            nodeType: NodeType.Thought,
+            limit: limit * 2,
+        });
+        for (const thought of thoughts) {
+            const data = thought.data;
+            if (data.statement.toLowerCase().includes(keywordLower)) {
+                const belief = await this.buildBeliefEntry(thought.id);
+                if (belief)
+                    beliefs.push(belief);
+            }
+        }
+        return beliefs.slice(0, limit);
+    }
+    async buildBeliefEntry(nodeId) {
+        const node = await this.storage.getNode(nodeId);
+        if (!node)
+            return null;
+        const isProp = node.nodeType === NodeType.Proposition;
+        const isThought = node.nodeType === NodeType.Thought;
+        if (!isProp && !isThought)
+            return null;
+        const data = node.data;
+        // Get BELIEVES (for Proposition) or ENDORSES (for Thought) edge
+        const edgeRelType = isProp ? RelType.BELIEVES : RelType.ENDORSES;
+        const believesEdges = await this.storage.queryEdges({
+            sourceId: DEFAULT_AGENT_ID,
+            targetId: nodeId,
+            relType: edgeRelType,
+        });
+        const believesData = believesEdges.length > 0
+            ? believesEdges[0].data
+            : null;
+        // Get DERIVED_FROM edges to find provenance/citations
+        const derivedEdges = await this.storage.queryEdges({
+            sourceId: nodeId,
+            relType: RelType.DERIVED_FROM,
+        });
+        const citations = [];
+        for (const edge of derivedEdges) {
+            const edgeData = edge.data;
+            if (edgeData.provenance) {
+                citations.push({
+                    notePath: edgeData.provenance.notePath,
+                    startOffset: edgeData.provenance.startOffset,
+                    endOffset: edgeData.provenance.endOffset,
+                    quoteText: edgeData.provenance.quoteText,
+                    chunkId: edgeData.provenance.chunkId,
+                });
+            }
+        }
+        return {
+            propositionId: nodeId,
+            statement: data.statement,
+            confidence: believesData?.confidence ?? data.confidence,
+            stance: isThought ? data.stance : 'for',
+            noteDate: believesData?.asOf ?? node.createdAt,
+            citations,
+        };
+    }
+}
+//# sourceMappingURL=graph-search.js.map

package/dist/query/graph-search.js.map

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

package/dist/query/query-engine.d.ts

@@ -0,0 +1,41 @@
+import type { StorageAdapter } from '../storage/storage-interface.js';
+import type { EmbeddingProvider } from '../embeddings/embedder-interface.js';
+import type { QueryResult } from '../schema/types.js';
+export type QueryMode = 'search' | 'beliefs' | 'contradictions' | 'timeline' | 'beliefCard' | 'openLoops';
+export interface QueryOptions {
+    mode?: QueryMode;
+    topK?: number;
+    threshold?: number;
+}
+/**
+ * Hybrid retrieval orchestrator.
+ * Routes queries to the appropriate engine and builds cited results.
+ */
+export declare class QueryEngine {
+    private storage;
+    private semanticSearch;
+    private graphSearch;
+    private citationBuilder;
+    private answerBuilder;
+    private openLoopDetector;
+    constructor(storage: StorageAdapter, embedder: EmbeddingProvider | null);
+    query(queryText: string, options?: QueryOptions): Promise<QueryResult>;
+    /**
+     * Get all extractions for a specific note.
+     */
+    getExtractionsForNote(notePath: string): Promise<{
+        entities: import("../index.js").GraphNode[];
+        concepts: import("../index.js").GraphNode[];
+        propositions: import("../index.js").GraphNode[];
+        thoughts: import("../index.js").GraphNode[];
+    }>;
+    private querySearch;
+    private queryBeliefs;
+    private queryContradictions;
+    private queryTimeline;
+    private queryBeliefCard;
+    private queryOpenLoops;
+    private detectMode;
+    private extractTopic;
+}
+//# sourceMappingURL=query-engine.d.ts.map

package/dist/query/query-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-engine.d.ts","sourceRoot":"","sources":["../../src/query/query-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAwD,MAAM,oBAAoB,CAAC;AAO5G,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1G,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,WAAW;IAQpB,OAAO,CAAC,OAAO;IAPjB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,gBAAgB,CAAmB;gBAGjC,OAAO,EAAE,cAAc,EAC/B,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAS9B,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAoBhF;;OAEG;IACG,qBAAqB,CAAC,QAAQ,EAAE,MAAM;;;;;;YAM9B,WAAW;YAYX,YAAY;YAQZ,mBAAmB;YA4BnB,aAAa;YAyBb,eAAe;YAyBf,cAAc;IAyB5B,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,YAAY;CAcrB"}

package/dist/query/query-engine.js

@@ -0,0 +1,178 @@
+import { SemanticSearch } from './semantic-search.js';
+import { GraphSearch } from './graph-search.js';
+import { CitationBuilder } from './citation-builder.js';
+import { AnswerBuilder } from './answer-builder.js';
+import { OpenLoopDetector } from '../extraction/open-loop-detector.js';
+/**
+ * Hybrid retrieval orchestrator.
+ * Routes queries to the appropriate engine and builds cited results.
+ */
+export class QueryEngine {
+    constructor(storage, embedder) {
+        this.storage = storage;
+        this.semanticSearch = new SemanticSearch(storage, embedder);
+        this.graphSearch = new GraphSearch(storage);
+        this.citationBuilder = new CitationBuilder(storage);
+        this.answerBuilder = new AnswerBuilder();
+        this.openLoopDetector = new OpenLoopDetector(storage);
+    }
+    async query(queryText, options = {}) {
+        const mode = options.mode ?? this.detectMode(queryText);
+        switch (mode) {
+            case 'beliefs':
+                return this.queryBeliefs(queryText, options);
+            case 'contradictions':
+                return this.queryContradictions(queryText);
+            case 'timeline':
+                return this.queryTimeline(queryText);
+            case 'beliefCard':
+                return this.queryBeliefCard(queryText);
+            case 'openLoops':
+                return this.queryOpenLoops(options);
+            case 'search':
+            default:
+                return this.querySearch(queryText, options);
+        }
+    }
+    /**
+     * Get all extractions for a specific note.
+     */
+    async getExtractionsForNote(notePath) {
+        return this.graphSearch.getExtractionsForNote(notePath);
+    }
+    // ─── Private query modes ─────────────────────────────────────────
+    async querySearch(queryText, options) {
+        const results = await this.semanticSearch.search(queryText, {
+            topK: options.topK ?? 10,
+            threshold: options.threshold ?? 0.3,
+        });
+        const chunkIds = results.map((r) => r.chunkId);
+        const citations = await this.citationBuilder.getCitationsForChunks(chunkIds);
+        return this.answerBuilder.buildFromSearchResults(queryText, results, citations);
+    }
+    async queryBeliefs(queryText, options) {
+        // Extract the topic from the query
+        const topic = this.extractTopic(queryText);
+        const beliefs = await this.graphSearch.queryBeliefs(topic, options.topK ?? 20);
+        return this.answerBuilder.buildFromBeliefs(topic, beliefs);
+    }
+    async queryContradictions(queryText) {
+        const topic = this.extractTopic(queryText);
+        const contradictions = await this.graphSearch.queryContradictions(topic);
+        if (contradictions.length === 0) {
+            return {
+                answer: `No contradictions found about: "${topic}"`,
+                citations: [],
+                contradictions: [],
+            };
+        }
+        const lines = contradictions.map((c, i) => {
+            return `[${i + 1}] "${c.propositionA.statement}" vs "${c.propositionB.statement}"`;
+        });
+        const allCitations = contradictions.flatMap((c) => [
+            ...c.propositionA.citations,
+            ...c.propositionB.citations,
+        ]);
+        return {
+            answer: `Found ${contradictions.length} contradiction(s) about "${topic}":\n\n${lines.join('\n\n')}`,
+            citations: allCitations,
+            contradictions,
+        };
+    }
+    async queryTimeline(queryText) {
+        const topic = this.extractTopic(queryText);
+        const timeline = await this.graphSearch.queryBeliefTimeline(topic);
+        if (timeline.length === 0) {
+            return {
+                answer: `No belief history found about: "${topic}"`,
+                citations: [],
+                beliefs: [],
+            };
+        }
+        const lines = timeline.map((b, i) => {
+            const date = b.noteDate.split('T')[0];
+            const stance = b.stance === 'for' ? '+' : b.stance === 'against' ? '-' : '~';
+            return `[${date}] (${stance}) ${b.statement}`;
+        });
+        return {
+            answer: `Belief timeline for "${topic}":\n\n${lines.join('\n')}`,
+            citations: timeline.flatMap((b) => b.citations),
+            beliefs: timeline,
+        };
+    }
+    async queryBeliefCard(queryText) {
+        const topic = this.extractTopic(queryText);
+        const beliefCard = await this.graphSearch.queryBeliefCard(topic);
+        if (beliefCard.entries.length === 0) {
+            return {
+                answer: `No beliefs found about: "${topic}"`,
+                citations: [],
+                beliefCard,
+            };
+        }
+        const lines = beliefCard.entries.map((e, i) => {
+            const conf = Math.round(e.confidence * 100);
+            const contradictions = e.contradictionCount > 0 ? ` [${e.contradictionCount} contradiction(s)]` : '';
+            return `[${i + 1}] (${conf}%) ${e.statement}${contradictions}`;
+        });
+        return {
+            answer: `Belief card for "${topic}" (${beliefCard.totalPropositions} beliefs, avg ${Math.round(beliefCard.avgConfidence * 100)}% confidence):\n\n${lines.join('\n')}`,
+            citations: beliefCard.entries.flatMap((e) => e.citations),
+            beliefCard,
+        };
+    }
+    async queryOpenLoops(options) {
+        const openLoops = await this.openLoopDetector.findOpenLoops(options.topK ?? 20);
+        if (openLoops.length === 0) {
+            return {
+                answer: 'No open loops found.',
+                citations: [],
+                openLoops: [],
+            };
+        }
+        const lines = openLoops.map((l, i) => {
+            const topic = l.topic ? ` [${l.topic}]` : '';
+            return `[${i + 1}] (${l.status}) ${l.statement}${topic}`;
+        });
+        return {
+            answer: `Found ${openLoops.length} open loop(s):\n\n${lines.join('\n')}`,
+            citations: openLoops.flatMap((l) => l.citations),
+            openLoops,
+        };
+    }
+    // ─── Helpers ─────────────────────────────────────────────────────
+    detectMode(query) {
+        const lower = query.toLowerCase();
+        if (lower.includes('belief card') || lower.includes('summarize beliefs')) {
+            return 'beliefCard';
+        }
+        if (lower.includes('open loop') || lower.includes('unresolved') || lower.includes('todo') || lower.includes('i wonder')) {
+            return 'openLoops';
+        }
+        if (lower.startsWith('what do i believe') || lower.includes('my beliefs about')) {
+            return 'beliefs';
+        }
+        if (lower.includes('contradict') || lower.includes('conflicting')) {
+            return 'contradictions';
+        }
+        if (lower.includes('how has my view') || lower.includes('timeline') || lower.includes('over time')) {
+            return 'timeline';
+        }
+        return 'search';
+    }
+    extractTopic(query) {
+        // Strip common query prefixes to get the topic
+        return query
+            .replace(/^what do i believe about\s*/i, '')
+            .replace(/^show contradictions about\s*/i, '')
+            .replace(/^how has my view changed about\s*/i, '')
+            .replace(/^my beliefs about\s*/i, '')
+            .replace(/^contradictions? (about|in)\s*/i, '')
+            .replace(/^timeline (for|of)\s*/i, '')
+            .replace(/^belief card (for|about)\s*/i, '')
+            .replace(/^summarize beliefs (about|for)\s*/i, '')
+            .replace(/\?$/, '')
+            .trim();
+    }
+}
+//# sourceMappingURL=query-engine.js.map

package/dist/query/query-engine.js.map

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

package/dist/query/semantic-search.d.ts

@@ -0,0 +1,26 @@
+import type { StorageAdapter } from '../storage/storage-interface.js';
+import type { EmbeddingProvider } from '../embeddings/embedder-interface.js';
+import { type SearchResult } from '../schema/types.js';
+export interface SemanticSearchOptions {
+    topK?: number;
+    threshold?: number;
+    hybridWeight?: number;
+}
+/**
+ * Hybrid semantic + full-text search.
+ * Combines vector similarity with FTS5 for best results.
+ */
+export declare class SemanticSearch {
+    private storage;
+    private embedder;
+    constructor(storage: StorageAdapter, embedder: EmbeddingProvider | null);
+    search(query: string, options?: SemanticSearchOptions): Promise<SearchResult[]>;
+    /**
+     * TypeScript-side ranking heuristics for "smart search" without FTS5.
+     */
+    private applyRankingHeuristics;
+    private vectorSearch;
+    private ftsSearch;
+    private mergeResults;
+}
+//# sourceMappingURL=semantic-search.d.ts.map

package/dist/query/semantic-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search.d.ts","sourceRoot":"","sources":["../../src/query/semantic-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkC,MAAM,iCAAiC,CAAC;AACtG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;gBADR,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAGtC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAuBzF;;OAEG;YACW,sBAAsB;YA0DtB,YAAY;YAeZ,SAAS;IAavB,OAAO,CAAC,YAAY;CA2CrB"}