shieldcortex 2.0.0

package/dist/tools/graph.js

@@ -0,0 +1,206 @@
+/**
+ * Knowledge Graph query tools
+ *
+ * Provides BFS traversal, entity listing, and path-finding
+ * over the entities/triples tables.
+ */
+import { getDatabase } from '../database/init.js';
+function mcpText(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+/**
+ * Traverse the knowledge graph from a starting entity using BFS.
+ */
+export function handleGraphQuery(args) {
+    const db = getDatabase();
+    const maxDepth = args.depth ?? 2;
+    const predicateFilter = args.predicates ?? null;
+    // Find entity
+    const entityRow = db.prepare('SELECT * FROM entities WHERE LOWER(name) = LOWER(?)').get(args.entity);
+    if (!entityRow) {
+        return mcpText({ error: `Entity "${args.entity}" not found in knowledge graph.` });
+    }
+    const rootEntity = {
+        id: entityRow.id,
+        name: entityRow.name,
+        type: entityRow.type,
+        memoryCount: entityRow.memory_count ?? 0,
+    };
+    // BFS
+    const connections = [];
+    const visited = new Set([entityRow.id]);
+    let frontier = [entityRow.id];
+    for (let d = 1; d <= maxDepth; d++) {
+        const nextFrontier = [];
+        for (const nodeId of frontier) {
+            // Outgoing
+            const outgoing = db.prepare('SELECT t.*, e.name, e.type FROM triples t JOIN entities e ON e.id = t.object_id WHERE t.subject_id = ?').all(nodeId);
+            for (const row of outgoing) {
+                if (predicateFilter && !predicateFilter.includes(row.predicate))
+                    continue;
+                connections.push({
+                    predicate: row.predicate,
+                    direction: 'outgoing',
+                    entity: { id: row.object_id, name: row.name, type: row.type },
+                    depth: d,
+                });
+                if (!visited.has(row.object_id)) {
+                    visited.add(row.object_id);
+                    nextFrontier.push(row.object_id);
+                }
+            }
+            // Incoming
+            const incoming = db.prepare('SELECT t.*, e.name, e.type FROM triples t JOIN entities e ON e.id = t.subject_id WHERE t.object_id = ?').all(nodeId);
+            for (const row of incoming) {
+                if (predicateFilter && !predicateFilter.includes(row.predicate))
+                    continue;
+                connections.push({
+                    predicate: row.predicate,
+                    direction: 'incoming',
+                    entity: { id: row.subject_id, name: row.name, type: row.type },
+                    depth: d,
+                });
+                if (!visited.has(row.subject_id)) {
+                    visited.add(row.subject_id);
+                    nextFrontier.push(row.subject_id);
+                }
+            }
+        }
+        frontier = nextFrontier;
+        if (frontier.length === 0)
+            break;
+    }
+    return mcpText({ entity: rootEntity, connections });
+}
+/**
+ * List entities in the knowledge graph.
+ */
+export function handleGraphEntities(args) {
+    const db = getDatabase();
+    const minMentions = args.minMentions ?? 1;
+    const limit = args.limit ?? 50;
+    let query = 'SELECT * FROM entities WHERE 1=1';
+    const params = [];
+    if (args.type) {
+        query += ' AND type = ?';
+        params.push(args.type);
+    }
+    query += ' AND memory_count >= ?';
+    params.push(minMentions);
+    query += ' ORDER BY memory_count DESC LIMIT ?';
+    params.push(limit);
+    const rows = db.prepare(query).all(...params);
+    const entities = rows.map((r) => {
+        let aliases = [];
+        try {
+            aliases = JSON.parse(r.aliases || '[]');
+        }
+        catch {
+            aliases = [];
+        }
+        return {
+            id: r.id,
+            name: r.name,
+            type: r.type,
+            memoryCount: r.memory_count ?? 0,
+            aliases,
+        };
+    });
+    return mcpText({ entities });
+}
+/**
+ * Find paths between two entities via BFS.
+ */
+export function handleGraphExplain(args) {
+    const db = getDatabase();
+    const maxDepth = args.maxDepth ?? 4;
+    // Resolve entities
+    const fromRow = db.prepare('SELECT * FROM entities WHERE LOWER(name) = LOWER(?)').get(args.from);
+    if (!fromRow) {
+        return mcpText({ error: `Source entity "${args.from}" not found.` });
+    }
+    const toRow = db.prepare('SELECT * FROM entities WHERE LOWER(name) = LOWER(?)').get(args.to);
+    if (!toRow) {
+        return mcpText({ error: `Target entity "${args.to}" not found.` });
+    }
+    if (fromRow.id === toRow.id) {
+        return mcpText({ paths: [{ hops: [{ entity: fromRow.name, predicate: '(self)' }] }], sourceMemories: [] });
+    }
+    const visited = new Map();
+    visited.set(fromRow.id, { id: fromRow.id, name: fromRow.name, parentId: null, predicate: '', sourceMemoryId: null });
+    let frontier = [fromRow.id];
+    let found = false;
+    for (let d = 0; d < maxDepth && !found; d++) {
+        const nextFrontier = [];
+        for (const nodeId of frontier) {
+            // Outgoing
+            const outgoing = db.prepare('SELECT t.object_id as next_id, t.predicate, t.source_memory_id, e.name FROM triples t JOIN entities e ON e.id = t.object_id WHERE t.subject_id = ?').all(nodeId);
+            for (const row of outgoing) {
+                if (!visited.has(row.next_id)) {
+                    visited.set(row.next_id, {
+                        id: row.next_id,
+                        name: row.name,
+                        parentId: nodeId,
+                        predicate: row.predicate,
+                        sourceMemoryId: row.source_memory_id,
+                    });
+                    nextFrontier.push(row.next_id);
+                    if (row.next_id === toRow.id) {
+                        found = true;
+                        break;
+                    }
+                }
+            }
+            if (found)
+                break;
+            // Incoming
+            const incoming = db.prepare('SELECT t.subject_id as next_id, t.predicate, t.source_memory_id, e.name FROM triples t JOIN entities e ON e.id = t.subject_id WHERE t.object_id = ?').all(nodeId);
+            for (const row of incoming) {
+                if (!visited.has(row.next_id)) {
+                    visited.set(row.next_id, {
+                        id: row.next_id,
+                        name: row.name,
+                        parentId: nodeId,
+                        predicate: `~${row.predicate}`,
+                        sourceMemoryId: row.source_memory_id,
+                    });
+                    nextFrontier.push(row.next_id);
+                    if (row.next_id === toRow.id) {
+                        found = true;
+                        break;
+                    }
+                }
+            }
+            if (found)
+                break;
+        }
+        frontier = nextFrontier;
+        if (frontier.length === 0)
+            break;
+    }
+    if (!found) {
+        return mcpText({ paths: [], sourceMemories: [], message: `No path found between "${args.from}" and "${args.to}" within ${maxDepth} hops.` });
+    }
+    // Reconstruct path
+    const hops = [];
+    const memoryIds = new Set();
+    let current = toRow.id;
+    while (current !== null) {
+        const node = visited.get(current);
+        hops.unshift({ entity: node.name, predicate: node.predicate });
+        if (node.sourceMemoryId)
+            memoryIds.add(node.sourceMemoryId);
+        current = node.parentId;
+        if (current === null || node.parentId === null)
+            break;
+    }
+    // Fetch source memories
+    let sourceMemories = [];
+    if (memoryIds.size > 0) {
+        const ids = Array.from(memoryIds);
+        const placeholders = ids.map(() => '?').join(',');
+        sourceMemories = db.prepare(`SELECT id, title FROM memories WHERE id IN (${placeholders})`).all(...ids);
+    }
+    return mcpText({ paths: [{ hops }], sourceMemories });
+}
+//# sourceMappingURL=graph.js.map

package/dist/tools/graph.js.map

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

package/dist/tools/recall.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Recall Tool
+ *
+ * Search and retrieve memories using semantic search and filters.
+ */
+import { z } from 'zod';
+import { Memory } from '../memory/types.js';
+export declare const recallSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodEnum<["architecture", "pattern", "preference", "error", "context", "learning", "todo", "note", "relationship", "custom"]>>;
+    type: z.ZodOptional<z.ZodEnum<["short_term", "long_term", "episodic"]>>;
+    project: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    includeDecayed: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeGlobal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["search", "recent", "important"]>>>;
+}, "strip", z.ZodTypeAny, {
+    mode: "search" | "important" | "recent";
+    limit: number;
+    includeDecayed: boolean;
+    includeGlobal: boolean;
+    project?: string | undefined;
+    type?: "short_term" | "long_term" | "episodic" | undefined;
+    category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
+    tags?: string[] | undefined;
+    query?: string | undefined;
+}, {
+    project?: string | undefined;
+    type?: "short_term" | "long_term" | "episodic" | undefined;
+    mode?: "search" | "important" | "recent" | undefined;
+    limit?: number | undefined;
+    category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
+    tags?: string[] | undefined;
+    query?: string | undefined;
+    includeDecayed?: boolean | undefined;
+    includeGlobal?: boolean | undefined;
+}>;
+export type RecallInput = z.infer<typeof recallSchema>;
+/**
+ * Execute the recall tool
+ */
+export declare function executeRecall(input: RecallInput): Promise<{
+    success: boolean;
+    memories?: Memory[];
+    contradictions?: Map<number, {
+        memoryId: number;
+        title: string;
+        score: number;
+    }[]>;
+    count?: number;
+    error?: string;
+}>;
+/**
+ * Format a single memory for display
+ */
+export declare function formatMemory(memory: Memory, verbose?: boolean): string;
+/**
+ * Format the recall result for MCP response
+ */
+export declare function formatRecallResult(result: Awaited<ReturnType<typeof executeRecall>>, verbose?: boolean): string;
+/**
+ * Get a single memory by ID
+ */
+export declare const getMemorySchema: z.ZodObject<{
+    id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+}, {
+    id: number;
+}>;
+export declare function executeGetMemory(input: {
+    id: number;
+}): {
+    success: boolean;
+    memory?: Memory;
+    error?: string;
+};
+//# sourceMappingURL=recall.d.ts.map

package/dist/tools/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/tools/recall.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,MAAM,EAAgB,MAAM,oBAAoB,CAAC;AAK1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBvB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAwDD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe,GAAG,MAAM,CAqB7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,EACjD,OAAO,GAAE,OAAe,GACvB,MAAM,CAoBR;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;EAE1B,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAiBA"}

package/dist/tools/recall.js

@@ -0,0 +1,156 @@
+/**
+ * Recall Tool
+ *
+ * Search and retrieve memories using semantic search and filters.
+ */
+import { z } from 'zod';
+import { searchMemories, accessMemory, getRecentMemories, getHighPriorityMemories } from '../memory/store.js';
+import { formatTimeSinceAccess } from '../memory/decay.js';
+import { MemoryNotFoundError, formatErrorForMcp } from '../errors.js';
+import { resolveProject } from '../context/project-context.js';
+// Input schema for the recall tool
+export const recallSchema = z.object({
+    query: z.string().optional().describe('Search query (semantic search)'),
+    category: z.enum([
+        'architecture', 'pattern', 'preference', 'error',
+        'context', 'learning', 'todo', 'note', 'relationship', 'custom'
+    ]).optional().describe('Filter by category'),
+    type: z.enum(['short_term', 'long_term', 'episodic']).optional()
+        .describe('Filter by memory type'),
+    project: z.string().optional().describe('Filter by project'),
+    tags: z.array(z.string()).optional().describe('Filter by tags'),
+    limit: z.number().min(1).max(50).optional().default(10)
+        .describe('Maximum number of results'),
+    includeDecayed: z.boolean().optional().default(false)
+        .describe('Include memories that have decayed below threshold'),
+    includeGlobal: z.boolean().optional().default(true)
+        .describe('Include global memories in search results (default: true)'),
+    mode: z.enum(['search', 'recent', 'important']).optional().default('search')
+        .describe('Recall mode: search (query-based), recent (by time), important (by salience)'),
+});
+/**
+ * Execute the recall tool
+ */
+export async function executeRecall(input) {
+    try {
+        // Resolve project (auto-detect if not provided)
+        const resolvedProject = resolveProject(input.project);
+        const projectFilter = resolvedProject ?? undefined;
+        let memories = [];
+        let contradictions;
+        switch (input.mode) {
+            case 'recent':
+                memories = getRecentMemories(input.limit, projectFilter);
+                break;
+            case 'important':
+                memories = getHighPriorityMemories(input.limit, projectFilter);
+                break;
+            case 'search':
+            default:
+                const results = await searchMemories({
+                    query: input.query || '',
+                    category: input.category,
+                    type: input.type,
+                    project: projectFilter,
+                    tags: input.tags,
+                    limit: input.limit,
+                    includeDecayed: input.includeDecayed,
+                    includeGlobal: input.includeGlobal,
+                });
+                memories = results.map(r => r.memory);
+                // Extract contradictions from search results
+                const contradictionEntries = results
+                    .filter(r => r.contradictions && r.contradictions.length > 0)
+                    .map(r => [r.memory.id, r.contradictions]);
+                if (contradictionEntries.length > 0) {
+                    contradictions = new Map(contradictionEntries);
+                }
+                break;
+        }
+        // Access each memory to reinforce it
+        memories = memories.map(m => accessMemory(m.id) || m);
+        return {
+            success: true,
+            memories,
+            contradictions,
+            count: memories.length,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: formatErrorForMcp(error),
+        };
+    }
+}
+/**
+ * Format a single memory for display
+ */
+export function formatMemory(memory, verbose = false) {
+    const lines = [
+        `[${memory.id}] **${memory.title}**`,
+        `    ${memory.content.slice(0, 200)}${memory.content.length > 200 ? '...' : ''}`,
+    ];
+    if (verbose) {
+        lines.push(`    Type: ${memory.type} | Category: ${memory.category}`);
+        lines.push(`    Salience: ${(memory.salience * 100).toFixed(0)}% | Accessed: ${memory.accessCount}x`);
+        lines.push(`    Last access: ${formatTimeSinceAccess(memory)}`);
+        if (memory.tags.length > 0) {
+            lines.push(`    Tags: ${memory.tags.join(', ')}`);
+        }
+        if (memory.project) {
+            lines.push(`    Project: ${memory.project}`);
+        }
+    }
+    else {
+        lines.push(`    (${memory.type}, ${memory.category}, ${formatTimeSinceAccess(memory)})`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format the recall result for MCP response
+ */
+export function formatRecallResult(result, verbose = false) {
+    if (!result.success) {
+        return `Failed to recall: ${result.error}`;
+    }
+    if (!result.memories || result.memories.length === 0) {
+        return 'No memories found matching your query.';
+    }
+    const header = `Found ${result.count} ${result.count === 1 ? 'memory' : 'memories'}:\n`;
+    const formattedMemories = result.memories.map(m => {
+        let output = formatMemory(m, verbose);
+        const contradictions = result.contradictions?.get(m.id);
+        if (contradictions && contradictions.length > 0) {
+            output += `\n  ⚠️ CONTRADICTS: ${contradictions.map(c => `"${c.title}" (ID ${c.memoryId})`).join(', ')}`;
+        }
+        return output;
+    }).join('\n\n');
+    return header + formattedMemories;
+}
+/**
+ * Get a single memory by ID
+ */
+export const getMemorySchema = z.object({
+    id: z.number().describe('Memory ID to retrieve'),
+});
+export function executeGetMemory(input) {
+    try {
+        const memory = accessMemory(input.id);
+        if (!memory) {
+            const error = new MemoryNotFoundError(input.id);
+            return {
+                success: false,
+                error: error.toUserMessage(),
+            };
+        }
+        return { success: true, memory };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: formatErrorForMcp(error),
+        };
+    }
+}
+//# sourceMappingURL=recall.js.map

package/dist/tools/recall.js.map

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

package/dist/tools/remember.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Remember Tool
+ *
+ * Store memories with automatic salience detection and categorization.
+ */
+import { z } from 'zod';
+import { MemoryCategory, MemoryType } from '../memory/types.js';
+export declare const rememberSchema: z.ZodObject<{
+    title: z.ZodString;
+    content: z.ZodString;
+    category: z.ZodOptional<z.ZodEnum<["architecture", "pattern", "preference", "error", "context", "learning", "todo", "note", "relationship", "custom"]>>;
+    type: z.ZodOptional<z.ZodEnum<["short_term", "long_term", "episodic"]>>;
+    project: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    importance: z.ZodOptional<z.ZodEnum<["low", "normal", "high", "critical"]>>;
+    scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
+    transferable: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["user", "email", "web", "agent", "file", "api"]>;
+        identifier: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "api" | "file" | "user" | "email" | "web" | "agent";
+        identifier: string;
+    }, {
+        type: "api" | "file" | "user" | "email" | "web" | "agent";
+        identifier: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    title: string;
+    scope?: "project" | "global" | undefined;
+    transferable?: boolean | undefined;
+    source?: {
+        type: "api" | "file" | "user" | "email" | "web" | "agent";
+        identifier: string;
+    } | undefined;
+    project?: string | undefined;
+    type?: "short_term" | "long_term" | "episodic" | undefined;
+    category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
+    tags?: string[] | undefined;
+    importance?: "critical" | "low" | "high" | "normal" | undefined;
+}, {
+    content: string;
+    title: string;
+    scope?: "project" | "global" | undefined;
+    transferable?: boolean | undefined;
+    source?: {
+        type: "api" | "file" | "user" | "email" | "web" | "agent";
+        identifier: string;
+    } | undefined;
+    project?: string | undefined;
+    type?: "short_term" | "long_term" | "episodic" | undefined;
+    category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
+    tags?: string[] | undefined;
+    importance?: "critical" | "low" | "high" | "normal" | undefined;
+}>;
+export type RememberInput = z.infer<typeof rememberSchema>;
+/**
+ * Execute the remember tool
+ */
+export declare function executeRemember(input: RememberInput): Promise<{
+    success: boolean;
+    memory?: {
+        id: number;
+        title: string;
+        salience: number;
+        type: MemoryType;
+        category: MemoryCategory;
+        reason: string;
+        linksCreated?: number;
+        truncated?: {
+            wasTruncated: boolean;
+            originalLength: number;
+            truncatedLength: number;
+        };
+    };
+    error?: string;
+}>;
+/**
+ * Format the remember result for MCP response
+ */
+export declare function formatRememberResult(result: Awaited<ReturnType<typeof executeRemember>>): string;
+//# sourceMappingURL=remember.d.ts.map

package/dist/tools/remember.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.d.ts","sourceRoot":"","sources":["../../src/tools/remember.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKhE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE,cAAc,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE;YACV,YAAY,EAAE,OAAO,CAAC;YACtB,cAAc,EAAE,MAAM,CAAC;YACvB,eAAe,EAAE,MAAM,CAAC;SACzB,CAAC;KACH,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA2FD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,GAAG,MAAM,CAwBhG"}