memorylink 1.0.0

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * MemoryLink - Main Entry Point
+ * Universal memory layer for AI coding assistants
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryLink = void 0;
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./utils.js"), exports);
+__exportStar(require("./commands/index.js"), exports);
+// Default export for programmatic usage
+var memorylink_js_1 = require("./memorylink.js");
+Object.defineProperty(exports, "MemoryLink", { enumerable: true, get: function () { return __importDefault(memorylink_js_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,6CAA2B;AAC3B,sDAAoC;AAEpC,wCAAwC;AACxC,iDAAwD;AAA/C,4HAAA,OAAO,OAAc"}

package/dist/memorylink.d.ts

@@ -0,0 +1,91 @@
+/**
+ * MemoryLink - Programmatic API
+ * Use MemoryLink from your own code
+ *
+ * v1.0 UPDATE: Now uses JSONL format with file locking
+ */
+import type { LearningStatus, StatusReport, MemoryEntry, ChangeEntry, LearningEntry, MemoryType } from './types.js';
+/**
+ * MemoryLink class for programmatic usage
+ */
+declare class MemoryLink {
+    private root;
+    private defaultAgent;
+    constructor(projectPath?: string, agent?: string);
+    /**
+     * Check if MemoryLink is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the project root
+     */
+    getRoot(): string | null;
+    /**
+     * Get status report
+     */
+    getStatus(): StatusReport | null;
+    /**
+     * Check if a file is protected
+     */
+    isProtected(filePath: string): boolean;
+    /**
+     * Add a memory entry (JSONL format with locking)
+     */
+    addMemory(details: string, options?: {
+        tags?: string[];
+        type?: MemoryType;
+        agent?: string;
+        force?: boolean;
+    }): Promise<MemoryEntry>;
+    /**
+     * Log a file change (JSONL format with locking)
+     */
+    logChange(file: string, reason: string, options?: {
+        agent?: string;
+        action?: 'created' | 'edited' | 'deleted' | 'renamed';
+        force?: boolean;
+    }): Promise<ChangeEntry>;
+    /**
+     * Add a learning (JSONL format with locking)
+     */
+    addLearning(problem: string, solution: string, outcome: LearningStatus, options?: {
+        tags?: string[];
+        reason?: string;
+        agent?: string;
+        force?: boolean;
+    }): Promise<LearningEntry>;
+    /**
+     * Get all memory entries (JSONL format)
+     */
+    getMemories(): MemoryEntry[];
+    /**
+     * Get all change entries (JSONL format)
+     */
+    getChanges(): ChangeEntry[];
+    /**
+     * Get all learning entries (JSONL format)
+     */
+    getLearnings(): LearningEntry[];
+    /**
+     * Get successful learnings only
+     */
+    getSuccessfulLearnings(): LearningEntry[];
+    /**
+     * Get failed learnings only
+     */
+    getFailedLearnings(): LearningEntry[];
+    /**
+     * Get protected files list
+     */
+    getProtectedFiles(): string[];
+    /**
+     * Search across all logs by keyword
+     */
+    search(keyword: string): {
+        memories: MemoryEntry[];
+        learnings: LearningEntry[];
+        changes: ChangeEntry[];
+    };
+}
+export default MemoryLink;
+//# sourceMappingURL=memorylink.d.ts.map

package/dist/memorylink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorylink.d.ts","sourceRoot":"","sources":["../src/memorylink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,cAAM,UAAU;IACd,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,YAAY,CAAS;gBAEjB,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAc;IAKvD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACH,SAAS,IAAI,YAAY,GAAG,IAAI;IAIhC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ,GACL,OAAO,CAAC,WAAW,CAAC;IA4BvB;;OAEG;IACG,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;QACtD,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ,GACL,OAAO,CAAC,WAAW,CAAC;IA4BvB;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ,GACL,OAAO,CAAC,aAAa,CAAC;IA+BzB;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAiB5B;;OAEG;IACH,UAAU,IAAI,WAAW,EAAE;IAe3B;;OAEG;IACH,YAAY,IAAI,aAAa,EAAE;IAgB/B;;OAEG;IACH,sBAAsB,IAAI,aAAa,EAAE;IAIzC;;OAEG;IACH,kBAAkB,IAAI,aAAa,EAAE;IAIrC;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAW7B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG;QACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,SAAS,EAAE,aAAa,EAAE,CAAC;QAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;KACxB;CAqBF;AAED,eAAe,UAAU,CAAC"}

package/dist/memorylink.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * MemoryLink - Programmatic API
+ * Use MemoryLink from your own code
+ *
+ * v1.0 UPDATE: Now uses JSONL format with file locking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_js_1 = require("./utils.js");
+const protect_js_1 = require("./commands/protect.js");
+const status_js_1 = require("./commands/status.js");
+/**
+ * MemoryLink class for programmatic usage
+ */
+class MemoryLink {
+    root;
+    defaultAgent;
+    constructor(projectPath, agent = 'sdk') {
+        this.root = projectPath || (0, utils_js_1.findRoot)();
+        this.defaultAgent = agent;
+    }
+    /**
+     * Check if MemoryLink is initialized
+     */
+    isInitialized() {
+        return this.root !== null && (0, utils_js_1.isInitialized)(this.root);
+    }
+    /**
+     * Get the project root
+     */
+    getRoot() {
+        return this.root;
+    }
+    /**
+     * Get status report
+     */
+    getStatus() {
+        return (0, status_js_1.getStatusReport)(this.root || undefined);
+    }
+    /**
+     * Check if a file is protected
+     */
+    isProtected(filePath) {
+        return (0, protect_js_1.isFileProtected)(filePath, this.root || undefined);
+    }
+    /**
+     * Add a memory entry (JSONL format with locking)
+     */
+    async addMemory(details, options = {}) {
+        if (!this.root || !(0, utils_js_1.isInitialized)(this.root)) {
+            throw new Error('MemoryLink is not initialized');
+        }
+        const { tags = [], type = 'note', agent = this.defaultAgent, force = false } = options;
+        // Secret detection
+        if (!force && !(0, utils_js_1.checkSecretsBeforeWrite)(details, force)) {
+            throw new Error('Secret detected in content. Use force=true to override.');
+        }
+        const entry = {
+            id: (0, utils_js_1.generateId)(),
+            ts: (0, utils_js_1.getTimestamp)(),
+            agent,
+            type,
+            details,
+            tags,
+            status: 'ACTIVE',
+        };
+        const memoryPath = (0, utils_js_1.getFilePath)('MEMORY', this.root);
+        await (0, utils_js_1.appendJsonlEntry)(memoryPath, entry);
+        return entry;
+    }
+    /**
+     * Log a file change (JSONL format with locking)
+     */
+    async logChange(file, reason, options = {}) {
+        if (!this.root || !(0, utils_js_1.isInitialized)(this.root)) {
+            throw new Error('MemoryLink is not initialized');
+        }
+        const { agent = this.defaultAgent, action = 'edited', force = false } = options;
+        // Secret detection
+        if (!force && !(0, utils_js_1.checkSecretsBeforeWrite)(reason, force)) {
+            throw new Error('Secret detected in content. Use force=true to override.');
+        }
+        const entry = {
+            id: (0, utils_js_1.generateId)(),
+            ts: (0, utils_js_1.getTimestamp)(),
+            agent,
+            file,
+            action,
+            reason,
+            status: 'ACTIVE',
+        };
+        const changesPath = (0, utils_js_1.getFilePath)('CHANGES', this.root);
+        await (0, utils_js_1.appendJsonlEntry)(changesPath, entry);
+        return entry;
+    }
+    /**
+     * Add a learning (JSONL format with locking)
+     */
+    async addLearning(problem, solution, outcome, options = {}) {
+        if (!this.root || !(0, utils_js_1.isInitialized)(this.root)) {
+            throw new Error('MemoryLink is not initialized');
+        }
+        const { tags = [], reason, agent = this.defaultAgent, force = false } = options;
+        // Secret detection
+        const content = `${problem} ${solution} ${reason || ''}`;
+        if (!force && !(0, utils_js_1.checkSecretsBeforeWrite)(content, force)) {
+            throw new Error('Secret detected in content. Use force=true to override.');
+        }
+        const entry = {
+            id: (0, utils_js_1.generateId)(),
+            ts: (0, utils_js_1.getTimestamp)(),
+            agent,
+            problem,
+            solution,
+            outcome,
+            reason,
+            tags,
+            status: 'ACTIVE',
+        };
+        const learningsPath = (0, utils_js_1.getFilePath)('LEARNINGS', this.root);
+        await (0, utils_js_1.appendJsonlEntry)(learningsPath, entry);
+        return entry;
+    }
+    /**
+     * Get all memory entries (JSONL format)
+     */
+    getMemories() {
+        if (!this.root || !(0, utils_js_1.isInitialized)(this.root)) {
+            return [];
+        }
+        const memoryPath = (0, utils_js_1.getFilePath)('MEMORY', this.root);
+        if (!(0, utils_js_1.isJsonlFormat)(memoryPath)) {
+            // Return empty for legacy format - user should migrate
+            console.warn('Legacy format detected. Run: memorylink migrate');
+            return [];
+        }
+        return (0, utils_js_1.readJsonlEntries)(memoryPath)
+            .filter(e => e.status === 'ACTIVE');
+    }
+    /**
+     * Get all change entries (JSONL format)
+     */
+    getChanges() {
+        if (!this.root || !(0, utils_js_1.isInitialized)(this.root)) {
+            return [];
+        }
+        const changesPath = (0, utils_js_1.getFilePath)('CHANGES', this.root);
+        if (!(0, utils_js_1.isJsonlFormat)(changesPath)) {
+            console.warn('Legacy format detected. Run: memorylink migrate');
+            return [];
+        }
+        return (0, utils_js_1.readJsonlEntries)(changesPath);
+    }
+    /**
+     * Get all learning entries (JSONL format)
+     */
+    getLearnings() {
+        if (!this.root || !(0, utils_js_1.isInitialized)(this.root)) {
+            return [];
+        }
+        const learningsPath = (0, utils_js_1.getFilePath)('LEARNINGS', this.root);
+        if (!(0, utils_js_1.isJsonlFormat)(learningsPath)) {
+            console.warn('Legacy format detected. Run: memorylink migrate');
+            return [];
+        }
+        return (0, utils_js_1.readJsonlEntries)(learningsPath)
+            .filter(e => e.status === 'ACTIVE');
+    }
+    /**
+     * Get successful learnings only
+     */
+    getSuccessfulLearnings() {
+        return this.getLearnings().filter(e => e.outcome === 'SUCCESS');
+    }
+    /**
+     * Get failed learnings only
+     */
+    getFailedLearnings() {
+        return this.getLearnings().filter(e => e.outcome === 'FAILED');
+    }
+    /**
+     * Get protected files list
+     */
+    getProtectedFiles() {
+        if (!this.root || !(0, utils_js_1.isInitialized)(this.root)) {
+            return [];
+        }
+        const protectedPath = (0, utils_js_1.getFilePath)('PROTECTED', this.root);
+        const lines = (0, utils_js_1.readLines)(protectedPath).filter(l => !l.startsWith('#'));
+        return lines.map(line => line.split('#')[0].trim()).filter(Boolean);
+    }
+    /**
+     * Search across all logs by keyword
+     */
+    search(keyword) {
+        const kw = keyword.toLowerCase();
+        const memories = this.getMemories().filter(e => e.details.toLowerCase().includes(kw) ||
+            e.tags?.some(t => t.toLowerCase().includes(kw)));
+        const learnings = this.getLearnings().filter(e => e.problem.toLowerCase().includes(kw) ||
+            e.solution.toLowerCase().includes(kw) ||
+            e.tags?.some(t => t.toLowerCase().includes(kw)));
+        const changes = this.getChanges().filter(e => e.file.toLowerCase().includes(kw) ||
+            e.reason.toLowerCase().includes(kw));
+        return { memories, learnings, changes };
+    }
+}
+exports.default = MemoryLink;
+//# sourceMappingURL=memorylink.js.map

package/dist/memorylink.js.map

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

package/dist/search/local-embeddings.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MemoryLink - Local Embeddings
+ * Local-first embeddings using @xenova/transformers (optional)
+ *
+ * v1.3: Week 3-4 - Local semantic search
+ */
+import type { Embedding } from './vector-search.js';
+/**
+ * Check if local embeddings are available
+ */
+export declare function isLocalEmbeddingsAvailable(): boolean;
+/**
+ * Generate embeddings using local model (Xenova Transformers)
+ * Falls back to error if not available
+ */
+export declare function generateEmbeddingLocal(text: string): Promise<Embedding>;
+/**
+ * Generate embeddings for multiple texts (batch) using local model
+ */
+export declare function generateEmbeddingsLocal(texts: string[]): Promise<Embedding[]>;
+//# sourceMappingURL=local-embeddings.d.ts.map

package/dist/search/local-embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-embeddings.d.ts","sourceRoot":"","sources":["../../src/search/local-embeddings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAQpD;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAuB7E;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAsCnF"}

package/dist/search/local-embeddings.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * MemoryLink - Local Embeddings
+ * Local-first embeddings using @xenova/transformers (optional)
+ *
+ * v1.3: Week 3-4 - Local semantic search
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLocalEmbeddingsAvailable = isLocalEmbeddingsAvailable;
+exports.generateEmbeddingLocal = generateEmbeddingLocal;
+exports.generateEmbeddingsLocal = generateEmbeddingsLocal;
+/**
+ * Check if local embeddings are available
+ */
+function isLocalEmbeddingsAvailable() {
+    try {
+        // Try to require transformers (optional dependency)
+        require.resolve('@xenova/transformers');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generate embeddings using local model (Xenova Transformers)
+ * Falls back to error if not available
+ */
+async function generateEmbeddingLocal(text) {
+    if (!isLocalEmbeddingsAvailable()) {
+        throw new Error('@xenova/transformers not installed. Install with: npm install @xenova/transformers');
+    }
+    try {
+        // Dynamic import to avoid requiring if not used
+        // @ts-ignore - Optional dependency, may not be installed
+        const { pipeline } = await import('@xenova/transformers');
+        // Use a lightweight model (all-MiniLM-L6-v2 is ~80MB)
+        const extractor = await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2', {
+            quantized: true, // Use quantized model for smaller size
+        });
+        const output = await extractor(text, { pooling: 'mean', normalize: true });
+        // Convert tensor to array
+        const embedding = Array.from(output.data);
+        return embedding;
+    }
+    catch (error) {
+        throw new Error(`Failed to generate local embedding: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Generate embeddings for multiple texts (batch) using local model
+ */
+async function generateEmbeddingsLocal(texts) {
+    if (!isLocalEmbeddingsAvailable()) {
+        throw new Error('@xenova/transformers not installed. Install with: npm install @xenova/transformers');
+    }
+    try {
+        // @ts-ignore - Optional dependency, may not be installed
+        const { pipeline } = await import('@xenova/transformers');
+        const extractor = await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2', {
+            quantized: true,
+        });
+        // Process in batches to avoid memory issues
+        const batchSize = 10;
+        const allEmbeddings = [];
+        for (let i = 0; i < texts.length; i += batchSize) {
+            const batch = texts.slice(i, i + batchSize);
+            const output = await extractor(batch, { pooling: 'mean', normalize: true });
+            // Convert tensor to array
+            // Output shape: [batch_size, embedding_dim] (e.g., [10, 384])
+            const outputArray = Array.from(output.data);
+            const embeddingDim = output.dims[1];
+            // Extract each embedding from the batch
+            for (let j = 0; j < batch.length; j++) {
+                const startIdx = j * embeddingDim;
+                const endIdx = startIdx + embeddingDim;
+                const embedding = outputArray.slice(startIdx, endIdx);
+                allEmbeddings.push(embedding);
+            }
+        }
+        return allEmbeddings;
+    }
+    catch (error) {
+        throw new Error(`Failed to generate local embeddings: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+//# sourceMappingURL=local-embeddings.js.map

package/dist/search/local-embeddings.js.map

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

package/dist/search/vector-search.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MemoryLink - Vector Search
+ * Semantic search using embeddings for better recall
+ *
+ * v1.1: Vector search implementation
+ *
+ * Supports:
+ * - OpenAI embeddings (if API key provided)
+ * - Local embeddings (optional, via transformers.js)
+ * - In-memory vector storage (for small datasets)
+ * - Optional persistent storage (SQLite + FAISS)
+ */
+import type { BaseEntry } from '../types.js';
+/**
+ * Vector embedding (1536 dimensions for OpenAI text-embedding-3-small, 384 for local models)
+ */
+export type Embedding = number[];
+/**
+ * Embedding provider type
+ */
+type EmbeddingProvider = 'openai' | 'local';
+/**
+ * Initialize vector store and index existing entries
+ */
+export declare function initializeVectorStore(root?: string, provider?: EmbeddingProvider): Promise<void>;
+/**
+ * Search using vector embeddings
+ */
+export declare function vectorSearch(query: string, options?: {
+    limit?: number;
+    threshold?: number;
+    root?: string;
+}): Promise<Array<{
+    entry: BaseEntry;
+    score: number;
+    text: string;
+}>>;
+/**
+ * Check if vector store is initialized (including from disk)
+ */
+export declare function isVectorStoreInitialized(root?: string): boolean;
+/**
+ * Load vector store from disk if available
+ */
+export declare function loadVectorStoreFromDisk(root?: string): Promise<boolean>;
+/**
+ * Get vector store statistics
+ */
+export declare function getVectorStoreStats(): {
+    size: number;
+    initialized: boolean;
+};
+/**
+ * Clear vector store (for re-indexing)
+ */
+export declare function clearVectorStore(): void;
+export {};
+//# sourceMappingURL=vector-search.d.ts.map

package/dist/search/vector-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search.d.ts","sourceRoot":"","sources":["../../src/search/vector-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,OAAO,KAAK,EAIV,SAAS,EACV,MAAM,aAAa,CAAC;AAOrB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;AAYjC;;GAEG;AACH,KAAK,iBAAiB,GAAG,QAAQ,GAAG,OAAO,CAAC;AA+T5C;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoGtG;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACV,GACL,OAAO,CAAC,KAAK,CAAC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAuCnE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAgB/D;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAQ5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC"}