@bip-krishna/agentmind 0.1.0

package/dist/packages/core/src/memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../../../../packages/core/src/memory-store.ts"],"names":[],"mappings":""}

package/dist/packages/core/src/memory.d.ts

@@ -0,0 +1,75 @@
+import { type CreateMemoryInput, type ContextOptions, type ContextResult, type Memory as MemoryRecord, type MemoryType, type SearchResult } from "./types.js";
+import type { MemoryStore } from "./memory-store.js";
+import type { EmbeddingProvider } from "../../embeddings/src/provider.js";
+import { MemoryEvents } from "./events.js";
+import { type MemoryPolicy } from "./policy.js";
+import type { ExtractorProvider } from "./extraction.js";
+export interface MemoryCreateOptions {
+    project: string;
+    store?: MemoryStore;
+    embeddingProvider?: EmbeddingProvider;
+    extractor?: ExtractorProvider;
+    policy?: MemoryPolicy;
+}
+export type MemoryLifecycle = "extracted" | "candidate" | "validated" | "stored" | "retrieved" | "updated" | "archived";
+export declare class MemoryEngine {
+    private store;
+    private projectId;
+    private projectName;
+    private embeddingProvider?;
+    private extractor?;
+    private policy;
+    readonly events: MemoryEvents;
+    private ranker;
+    private consolidator;
+    private constructor();
+    static create(opts: MemoryCreateOptions): Promise<MemoryEngine>;
+    get project(): {
+        id: string;
+        name: string;
+    };
+    on<K extends Parameters<MemoryEvents["on"]>[0]>(event: K, listener: Parameters<MemoryEvents["on"]>[1]): this;
+    remember(input: Partial<CreateMemoryInput> & {
+        content: string;
+        type?: MemoryType;
+    }): Promise<MemoryRecord>;
+    /** ingest raw conversation — stores source + auto-extracts if policy/extractor configured */
+    ingest(input: {
+        role: string;
+        content: string;
+        sourceType?: "conversation" | "document" | "tool" | "manual";
+    }): Promise<{
+        sourceId: string;
+        extracted?: MemoryRecord[];
+    }>;
+    search(query: string, opts?: {
+        limit?: number;
+        types?: MemoryType[];
+        minImportance?: number;
+    }): Promise<SearchResult[]>;
+    context(opts: ContextOptions): Promise<ContextResult>;
+    context(query: string): Promise<ContextResult>;
+    buildContext(opts: ContextOptions): Promise<ContextResult>;
+    forget(id: string): Promise<void>;
+    forgetProject(projectId?: string): Promise<void>;
+    archive(id: string): Promise<void>;
+    deleteProject(): Promise<void>;
+    export(filter?: {
+        includeArchived?: boolean;
+    }): Promise<{
+        project: {
+            id: string;
+            name: string;
+        };
+        memories: MemoryRecord[];
+    }>;
+    consolidate(opts?: {
+        threshold?: number;
+        minClusterSize?: number;
+    }): Promise<import("./consolidation.js").ConsolidationResult[]>;
+    updateMemory(id: string, update: Partial<MemoryRecord>): Promise<void>;
+    private isNearDuplicate;
+    private maybeSupersedeConflicting;
+}
+export declare const Memory: typeof MemoryEngine;
+//# sourceMappingURL=memory.d.ts.map

package/dist/packages/core/src/memory.d.ts.map

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

package/dist/packages/core/src/memory.js

@@ -0,0 +1,402 @@
+import { randomUUID } from "node:crypto";
+import { CreateMemoryInputSchema, } from "./types.js";
+import { HybridRanker } from "../../retrieval/src/ranker.js";
+import { estimateTokens } from "../../retrieval/src/token.js";
+import { MemoryEvents } from "./events.js";
+import { resolvePolicy, isSensitive } from "./policy.js";
+import { Consolidator } from "./consolidation.js";
+import { cosineSimilarity } from "../../embeddings/src/provider.js";
+export class MemoryEngine {
+    store;
+    projectId;
+    projectName;
+    embeddingProvider;
+    extractor;
+    policy;
+    events = new MemoryEvents();
+    ranker;
+    consolidator;
+    constructor(opts) {
+        this.store = opts.store;
+        this.projectId = opts.projectId;
+        this.projectName = opts.projectName;
+        this.embeddingProvider = opts.embeddingProvider;
+        this.extractor = opts.extractor;
+        this.policy = resolvePolicy(opts.policy);
+        this.ranker = opts.ranker ?? new HybridRanker();
+        this.consolidator = new Consolidator(this.store, this.embeddingProvider);
+    }
+    static async create(opts) {
+        const store = opts.store ?? (await import("../../storage/src/config.js").then(m => m.createStoreFromConfig(m.resolveStorageConfig())));
+        let project = await store.getProjectByName(opts.project);
+        if (!project) {
+            project = await store.getProject(opts.project);
+        }
+        if (!project) {
+            const now = new Date();
+            const p = { id: randomUUID(), name: opts.project, createdAt: now, updatedAt: now };
+            await store.createProject(p);
+            project = p;
+        }
+        return new MemoryEngine({
+            store,
+            projectId: project.id,
+            projectName: project.name,
+            embeddingProvider: opts.embeddingProvider,
+            extractor: opts.extractor,
+            policy: opts.policy,
+        });
+    }
+    get project() {
+        return { id: this.projectId, name: this.projectName };
+    }
+    // ---------- Ingest / Remember ----------
+    on(event, listener) {
+        this.events.on(event, listener);
+        return this;
+    }
+    async remember(input) {
+        const parsed = CreateMemoryInputSchema.parse(input);
+        // Policy checks — minimumImportance applies only to auto-extracted memories; manual remember always allowed
+        if (!this.policy.storeSensitiveData && isSensitive(parsed.content)) {
+            throw new Error("Refusing to store sensitive data (policy.storeSensitiveData=false)");
+        }
+        if (this.policy.shouldRemember) {
+            const allowed = await this.policy.shouldRemember({
+                projectId: this.projectId,
+                type: parsed.type,
+                content: parsed.content,
+                importance: parsed.importance,
+                confidence: parsed.confidence,
+                status: "active",
+                createdAt: new Date(),
+                updatedAt: new Date(),
+                accessCount: 0,
+                metadata: parsed.metadata,
+                archived: false,
+            });
+            if (!allowed)
+                throw new Error("Policy shouldRemember returned false");
+        }
+        const count = (await this.store.listMemories(this.projectId)).filter((m) => !m.archived).length;
+        if (count >= this.policy.maxMemoriesPerProject) {
+            throw new Error(`maxMemoriesPerProject ${this.policy.maxMemoriesPerProject} reached`);
+        }
+        const now = new Date();
+        const mem = {
+            id: randomUUID(),
+            projectId: this.projectId,
+            type: parsed.type,
+            content: parsed.content,
+            importance: parsed.importance,
+            confidence: parsed.confidence,
+            status: "active",
+            createdAt: now,
+            updatedAt: now,
+            accessCount: 0,
+            sourceId: parsed.sourceId,
+            metadata: parsed.metadata,
+            archived: false,
+        };
+        // Deduplication: keyword similarity check against existing memories
+        const existing = await this.store.listMemories(this.projectId);
+        for (const e of existing) {
+            if (e.archived || e.status === "superseded")
+                continue;
+            if (this.isNearDuplicate(e.content, mem.content)) {
+                // update existing instead of creating new
+                await this.store.updateMemory(e.id, {
+                    content: mem.content,
+                    importance: Math.max(e.importance, mem.importance),
+                    updatedAt: now,
+                    accessCount: e.accessCount,
+                });
+                if (this.embeddingProvider) {
+                    const vec = await this.embeddingProvider.embed(mem.content);
+                    await this.store.upsertEmbedding(e.id, vec, this.embeddingProvider.model);
+                }
+                const updated = await this.store.getMemory(e.id);
+                return updated;
+            }
+        }
+        // Conflict detection (simple): if embedding similarity high but content contradicts via keyword overlap low? fallback to string includes
+        // For MVP: if we detect "switched to" / "migrated" / "instead of", supersede previous conflicting memory
+        await this.maybeSupersedeConflicting(mem);
+        await this.store.createMemory(mem);
+        if (this.embeddingProvider) {
+            const vec = await this.embeddingProvider.embed(mem.content);
+            await this.store.upsertEmbedding(mem.id, vec, this.embeddingProvider.model);
+            mem.embedding = vec;
+        }
+        this.events.emit("memory.created", mem);
+        return mem;
+    }
+    /** ingest raw conversation — stores source + auto-extracts if policy/extractor configured */
+    async ingest(input) {
+        const sourceId = randomUUID();
+        await this.store.createSource({
+            id: sourceId,
+            projectId: this.projectId,
+            type: input.sourceType ?? "conversation",
+            content: `${input.role}: ${input.content}`,
+            createdAt: new Date(),
+            metadata: { role: input.role },
+        });
+        if (this.policy.autoExtract && this.extractor) {
+            const extracted = await this.extractor.extract(input.content);
+            const memories = [];
+            for (const e of extracted) {
+                if (e.importance < this.policy.minimumImportance)
+                    continue;
+                try {
+                    const m = await this.remember({ type: e.type, content: e.content, importance: e.importance, confidence: e.confidence, sourceId, metadata: { autoExtracted: true } });
+                    memories.push(m);
+                }
+                catch { }
+            }
+            if (!this.policy.retainConversations) {
+                // optionally delete source after extraction — keep for traceability if needed
+            }
+            return { sourceId, extracted: memories };
+        }
+        return { sourceId };
+    }
+    // ---------- Search ----------
+    async search(query, opts) {
+        const limit = opts?.limit ?? 5;
+        // If we have embeddings, do semantic + keyword hybrid; else keyword fallback via store.search
+        if (this.embeddingProvider) {
+            const qVec = await this.embeddingProvider.embed(query);
+            // Prefer native pgvector search if available (faster, uses HNSW index)
+            if (this.store.vectorSearch) {
+                try {
+                    const vectorResults = await this.store.vectorSearch(this.projectId, qVec, limit * 3);
+                    const withVectors = vectorResults
+                        .filter(({ memory }) => !memory.archived && memory.status !== "archived")
+                        .filter(({ memory }) => !opts?.types || opts.types.includes(memory.type))
+                        .filter(({ memory }) => opts?.minImportance === undefined || memory.importance >= opts.minImportance)
+                        .map(({ memory, distance }) => ({ ...memory, _vec: undefined, _distance: distance }));
+                    // Hybrid rank still applies keyword+importance+recency on top of vector distance
+                    const candidates = this.ranker.rank(withVectors, query, qVec);
+                    const top = candidates.slice(0, limit);
+                    for (const c of top) {
+                        await this.store.updateMemory(c.memory.id, { lastAccessedAt: new Date(), accessCount: c.memory.accessCount + 1 });
+                    }
+                    const eventId = randomUUID();
+                    const scores = {};
+                    top.forEach((r) => (scores[r.memory.id] = r.score));
+                    const retrievalEvent = { id: eventId, projectId: this.projectId, query, retrievedMemoryIds: top.map((r) => r.memory.id), scores, finalContextTokens: estimateTokens(top.map((r) => r.memory.content).join("\n")), createdAt: new Date() };
+                    await this.store.logRetrieval(retrievalEvent);
+                    this.events.emit("retrieval.completed", retrievalEvent);
+                    this.events.emit("memory.retrieved", top.map((r) => r.memory), query);
+                    return top.map((r) => ({ memory: r.memory, score: r.score, semanticScore: r.semanticScore, keywordScore: r.keywordScore }));
+                }
+                catch {
+                    // fallback to JS ranking
+                }
+            }
+            const all = await this.store.listMemories(this.projectId);
+            const withEmbeddings = [];
+            for (const m of all) {
+                if (m.archived || m.status === "archived")
+                    continue;
+                if (opts?.types && !opts.types.includes(m.type))
+                    continue;
+                if (opts?.minImportance !== undefined && m.importance < opts.minImportance)
+                    continue;
+                const emb = await this.store.getEmbedding(m.id);
+                withEmbeddings.push({ ...m, _vec: emb?.vector });
+            }
+            // rank via HybridRanker (semantic cosine + keyword + importance + recency)
+            const candidates = this.ranker.rank(withEmbeddings, query, qVec);
+            const top = candidates.slice(0, limit);
+            // update access counts
+            for (const c of top) {
+                await this.store.updateMemory(c.memory.id, {
+                    lastAccessedAt: new Date(),
+                    accessCount: c.memory.accessCount + 1,
+                });
+            }
+            // log retrieval
+            const eventId = randomUUID();
+            const scores = {};
+            top.forEach((r) => (scores[r.memory.id] = r.score));
+            const retrievalEvent = {
+                id: eventId,
+                projectId: this.projectId,
+                query,
+                retrievedMemoryIds: top.map((r) => r.memory.id),
+                scores,
+                finalContextTokens: estimateTokens(top.map((r) => r.memory.content).join("\n")),
+                createdAt: new Date(),
+            };
+            await this.store.logRetrieval(retrievalEvent);
+            this.events.emit("retrieval.completed", retrievalEvent);
+            this.events.emit("memory.retrieved", top.map((r) => r.memory), query);
+            return top.map((r) => ({
+                memory: r.memory,
+                score: r.score,
+                semanticScore: r.semanticScore,
+                keywordScore: r.keywordScore,
+            }));
+        }
+        // fallback: store's keyword search
+        const results = await this.store.search({
+            projectId: this.projectId,
+            query,
+            types: opts?.types,
+            limit,
+            minImportance: opts?.minImportance,
+        });
+        for (const r of results) {
+            await this.store.updateMemory(r.memory.id, {
+                lastAccessedAt: new Date(),
+                accessCount: r.memory.accessCount + 1,
+            });
+        }
+        return results;
+    }
+    async context(opts) {
+        const q = typeof opts === "string" ? opts : opts.query;
+        const maxTokens = typeof opts === "string" ? 6000 : (opts.maxTokens ?? 6000);
+        const limit = typeof opts === "string" ? 5 : (opts.limit ?? 10);
+        const types = typeof opts === "string" ? undefined : opts.types;
+        const results = await this.search(q, { limit, types });
+        // token budgeting: greedily add until maxTokens
+        const memories = [];
+        let tokenCount = 0;
+        const header = `Relevant project memory (${this.projectName}):\n`;
+        tokenCount += estimateTokens(header);
+        let text = header;
+        for (const r of results) {
+            const chunk = `- ${r.memory.content}\n`;
+            const chunkTokens = estimateTokens(chunk);
+            if (tokenCount + chunkTokens > maxTokens)
+                break;
+            memories.push(r.memory);
+            text += chunk;
+            tokenCount += chunkTokens;
+        }
+        if (memories.length === 0) {
+            text = "";
+            tokenCount = 0;
+        }
+        return {
+            memories,
+            text,
+            tokenCount,
+            sources: [...new Set(memories.map((m) => m.sourceId).filter(Boolean))],
+        };
+    }
+    // alias
+    buildContext(opts) {
+        return this.context(opts);
+    }
+    // ---------- Lifecycle ----------
+    async forget(id) {
+        const mem = await this.store.getMemory(id);
+        await this.store.deleteMemory(id);
+        // Embeddings contain derived data — ensure deleted (store cascade handles it, but explicit for InMemory)
+        try {
+            await this.store.deleteEmbedding?.(id);
+        }
+        catch { }
+        this.events.emit("memory.deleted", id);
+        if (mem)
+            this.events.emit("memory.archived", mem);
+    }
+    async forgetProject(projectId) {
+        const pid = projectId ?? this.projectId;
+        const memories = await this.store.listMemories(pid);
+        for (const m of memories)
+            await this.store.deleteMemory(m.id);
+        await this.store.deleteProject(pid);
+    }
+    async archive(id) {
+        await this.store.archiveMemory(id);
+        const mem = await this.store.getMemory(id);
+        if (mem)
+            this.events.emit("memory.archived", mem);
+    }
+    async deleteProject() {
+        await this.forgetProject(this.projectId);
+    }
+    async export(filter) {
+        let memories = await this.store.listMemories(this.projectId);
+        if (!filter?.includeArchived)
+            memories = memories.filter((m) => !m.archived);
+        return { project: { id: this.projectId, name: this.projectName }, memories };
+    }
+    async consolidate(opts) {
+        const results = await this.consolidator.consolidate(this.projectId, opts);
+        for (const r of results)
+            this.events.emit("consolidation.completed", r.summary, r.sourceIds);
+        return results;
+    }
+    async updateMemory(id, update) {
+        await this.store.updateMemory(id, update);
+        const mem = await this.store.getMemory(id);
+        if (mem)
+            this.events.emit("memory.updated", mem);
+        if (update.content && this.embeddingProvider && mem) {
+            const vec = await this.embeddingProvider.embed(mem.content);
+            await this.store.upsertEmbedding(id, vec, this.embeddingProvider.model);
+        }
+    }
+    // ---------- Helpers ----------
+    isNearDuplicate(a, b) {
+        const norm = (s) => s.toLowerCase().replace(/\W+/g, " ").trim();
+        const na = norm(a), nb = norm(b);
+        if (na === nb)
+            return true;
+        // Jaccard over tokens threshold 0.85
+        const sa = new Set(na.split(" "));
+        const sb = new Set(nb.split(" "));
+        const inter = [...sa].filter((x) => sb.has(x)).length;
+        const union = new Set([...sa, ...sb]).size;
+        return union > 0 && inter / union > 0.85;
+    }
+    async maybeSupersedeConflicting(newMem) {
+        const triggers = ["switched to", "migrated to", "changed to", "instead of", "no longer", "replaced", "now using", "moved to"];
+        const lower = newMem.content.toLowerCase();
+        const triggered = triggers.some((t) => lower.includes(t));
+        const existing = await this.store.listMemories(this.projectId);
+        const newTokens = new Set(lower.split(/\W+/).filter(Boolean));
+        // Embedding-aware conflict: if semantic similarity high but content contradicts
+        let newVec = null;
+        if (this.embeddingProvider) {
+            try {
+                newVec = await this.embeddingProvider.embed(newMem.content);
+            }
+            catch { }
+        }
+        for (const e of existing) {
+            if (e.archived || e.status !== "active")
+                continue;
+            const overlap = e.content.toLowerCase().split(/\W+/).filter((w) => newTokens.has(w)).length;
+            let shouldSupersede = false;
+            if (triggered && overlap >= 2 && !this.isNearDuplicate(e.content, newMem.content)) {
+                const nouns = ["database", "postgres", "mongodb", "sqlite", "storage", "backend", "auth", "payment", "api", "framework"];
+                const sharesNoun = nouns.some((n) => e.content.toLowerCase().includes(n) && lower.includes(n));
+                if (sharesNoun)
+                    shouldSupersede = true;
+            }
+            // Embedding similarity conflict: high similarity (>0.82) but not duplicate -> likely same topic updated
+            if (!shouldSupersede && newVec && triggered) {
+                const emb = await this.store.getEmbedding(e.id);
+                if (emb) {
+                    const sim = cosineSimilarity(newVec, emb.vector);
+                    if (sim > 0.82 && !this.isNearDuplicate(e.content, newMem.content))
+                        shouldSupersede = true;
+                }
+            }
+            if (shouldSupersede) {
+                await this.store.updateMemory(e.id, { status: "superseded", archived: false, updatedAt: new Date() });
+                this.events.emit("memory.superseded", e, newMem);
+            }
+        }
+    }
+}
+// Convenience alias per spec: `Memory` class
+export const Memory = MemoryEngine;
+//# sourceMappingURL=memory.js.map

package/dist/packages/core/src/memory.js.map

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

package/dist/packages/core/src/policy.d.ts

@@ -0,0 +1,17 @@
+import type { Memory } from "./types.js";
+export interface MemoryPolicy {
+    autoExtract?: boolean;
+    minimumImportance?: number;
+    maxMemoriesPerProject?: number;
+    retainConversations?: boolean;
+    storeSensitiveData?: boolean;
+    shouldRemember?: (memory: Omit<Memory, "id" | "createdAt" | "updatedAt">) => boolean | Promise<boolean>;
+    maxTokensPerContext?: number;
+}
+export declare const DEFAULT_POLICY: Required<Omit<MemoryPolicy, "shouldRemember">> & {
+    shouldRemember?: MemoryPolicy["shouldRemember"];
+};
+export declare function resolvePolicy(overrides?: MemoryPolicy): typeof DEFAULT_POLICY;
+export declare const SENSITIVE_PATTERNS: RegExp[];
+export declare function isSensitive(content: string): boolean;
+//# sourceMappingURL=policy.d.ts.map

package/dist/packages/core/src/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxG,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC,GAAG;IAAE,cAAc,CAAC,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAA;CAO9H,CAAC;AAEF,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,YAAY,GAAG,OAAO,cAAc,CAE7E;AAED,eAAO,MAAM,kBAAkB,UAM9B,CAAC;AAEF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/packages/core/src/policy.js

@@ -0,0 +1,22 @@
+export const DEFAULT_POLICY = {
+    autoExtract: false,
+    minimumImportance: 0.65,
+    maxMemoriesPerProject: 10000,
+    retainConversations: false,
+    storeSensitiveData: false,
+    maxTokensPerContext: 6000,
+};
+export function resolvePolicy(overrides) {
+    return { ...DEFAULT_POLICY, ...overrides };
+}
+export const SENSITIVE_PATTERNS = [
+    /password/i,
+    /api[_-]?key/i,
+    /secret/i,
+    /\bssn\b/i,
+    /credit[_-]?card/i,
+];
+export function isSensitive(content) {
+    return SENSITIVE_PATTERNS.some((re) => re.test(content));
+}
+//# sourceMappingURL=policy.js.map

package/dist/packages/core/src/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../../packages/core/src/policy.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,cAAc,GAAyG;IAClI,WAAW,EAAE,KAAK;IAClB,iBAAiB,EAAE,IAAI;IACvB,qBAAqB,EAAE,KAAK;IAC5B,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,KAAK;IACzB,mBAAmB,EAAE,IAAI;CAC1B,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,SAAwB;IACpD,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,SAAS,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,WAAW;IACX,cAAc;IACd,SAAS;IACT,UAAU;IACV,kBAAkB;CACnB,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3D,CAAC"}