openclaw-cortex-memory 0.1.0-Alpha.2 → 0.1.0-Alpha.21

package/dist/src/store/embedding_utils.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeBaseUrl = normalizeBaseUrl;
+exports.resolveChunkingConfig = resolveChunkingConfig;
+exports.splitTextToChunks = splitTextToChunks;
+exports.embedTextWithChunks = embedTextWithChunks;
+function normalizeBaseUrl(value) {
+    if (!value)
+        return "";
+    return value.endsWith("/") ? value.slice(0, -1) : value;
+}
+function resolveChunkingConfig(config) {
+    const chunkSizeRaw = typeof config?.chunkSize === "number" && Number.isFinite(config.chunkSize)
+        ? Math.floor(config.chunkSize)
+        : 600;
+    const chunkSize = Math.max(200, Math.min(1200, chunkSizeRaw));
+    const overlapRaw = typeof config?.chunkOverlap === "number" && Number.isFinite(config.chunkOverlap)
+        ? Math.floor(config.chunkOverlap)
+        : Math.floor(chunkSize * 0.15);
+    const chunkOverlap = Math.max(20, Math.min(Math.floor(chunkSize * 0.25), overlapRaw, chunkSize - 20));
+    return {
+        chunkSize,
+        chunkOverlap: chunkOverlap <= 0 ? Math.max(20, Math.floor(chunkSize * 0.15)) : chunkOverlap,
+    };
+}
+function tokenize(text) {
+    const tokens = text
+        .replace(/\r\n/g, "\n")
+        .split(/\s+/)
+        .map(item => item.trim())
+        .filter(Boolean);
+    if (tokens.length > 0) {
+        return tokens;
+    }
+    return text
+        .replace(/\r\n/g, "\n")
+        .split("")
+        .map(item => item.trim())
+        .filter(Boolean);
+}
+function splitTextToChunks(text, config) {
+    const normalized = (text || "").trim();
+    if (!normalized) {
+        return [];
+    }
+    const runtime = resolveChunkingConfig(config);
+    const tokens = tokenize(normalized);
+    if (tokens.length <= runtime.chunkSize) {
+        return [normalized];
+    }
+    const chunks = [];
+    const step = Math.max(1, runtime.chunkSize - runtime.chunkOverlap);
+    let index = 0;
+    while (index < tokens.length) {
+        const slice = tokens.slice(index, index + runtime.chunkSize);
+        if (slice.length === 0) {
+            break;
+        }
+        chunks.push(slice.join(" "));
+        if (index + runtime.chunkSize >= tokens.length) {
+            break;
+        }
+        index += step;
+    }
+    return chunks;
+}
+async function requestEmbedding(args) {
+    const endpoint = args.baseUrl.endsWith("/embeddings") ? args.baseUrl : `${args.baseUrl}/embeddings`;
+    const body = {
+        input: args.text,
+        model: args.model,
+    };
+    if (typeof args.dimensions === "number" && Number.isFinite(args.dimensions) && args.dimensions > 0) {
+        body.dimensions = args.dimensions;
+    }
+    const timeoutMs = typeof args.timeoutMs === "number" && Number.isFinite(args.timeoutMs) && args.timeoutMs >= 1000
+        ? Math.floor(args.timeoutMs)
+        : 20000;
+    const maxRetries = typeof args.maxRetries === "number" && Number.isFinite(args.maxRetries) && args.maxRetries >= 1
+        ? Math.min(8, Math.floor(args.maxRetries))
+        : 4;
+    let lastError = null;
+    for (let attempt = 0; attempt < maxRetries; attempt += 1) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(endpoint, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    authorization: `Bearer ${args.apiKey}`,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                lastError = new Error(`embedding_http_${response.status}`);
+                continue;
+            }
+            const json = await response.json();
+            const embedding = json?.data?.[0]?.embedding;
+            if (Array.isArray(embedding) && embedding.length > 0) {
+                return embedding.filter(item => Number.isFinite(item));
+            }
+            lastError = new Error("embedding_empty");
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            lastError = error;
+        }
+        if (attempt < maxRetries - 1) {
+            await new Promise(resolve => setTimeout(resolve, 300 * Math.pow(2, attempt)));
+        }
+    }
+    if (lastError) {
+        throw lastError;
+    }
+    return null;
+}
+function averageEmbeddings(vectors) {
+    if (vectors.length === 0) {
+        return [];
+    }
+    const size = vectors[0].length;
+    const result = Array.from({ length: size }, () => 0);
+    for (const vector of vectors) {
+        const width = Math.min(size, vector.length);
+        for (let i = 0; i < width; i += 1) {
+            result[i] += vector[i];
+        }
+    }
+    for (let i = 0; i < result.length; i += 1) {
+        result[i] = Number((result[i] / vectors.length).toFixed(8));
+    }
+    return result;
+}
+async function embedTextWithChunks(args) {
+    const model = args.embedding?.model || "";
+    const apiKey = args.embedding?.apiKey || "";
+    const baseUrl = normalizeBaseUrl(args.embedding?.baseURL || args.embedding?.baseUrl);
+    if (!model || !apiKey || !baseUrl) {
+        return { chunkCount: 0, embeddingStatus: "pending" };
+    }
+    const chunks = splitTextToChunks(args.text, args.chunking);
+    if (chunks.length === 0) {
+        return { chunkCount: 0, embeddingStatus: "failed" };
+    }
+    const vectors = [];
+    for (const chunk of chunks) {
+        const embedding = await requestEmbedding({
+            text: chunk,
+            model,
+            apiKey,
+            baseUrl,
+            dimensions: args.embedding?.dimensions,
+            timeoutMs: args.embedding?.timeoutMs,
+            maxRetries: args.embedding?.maxRetries,
+        });
+        if (embedding && embedding.length > 0) {
+            vectors.push(embedding);
+        }
+    }
+    if (vectors.length === 0) {
+        return { chunkCount: chunks.length, embeddingStatus: "failed" };
+    }
+    return {
+        embedding: averageEmbeddings(vectors),
+        chunkCount: chunks.length,
+        embeddingStatus: "ok",
+    };
+}
+//# sourceMappingURL=embedding_utils.js.map

package/dist/src/store/embedding_utils.js.map

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

package/dist/src/store/graph_memory_store.d.ts

@@ -0,0 +1,44 @@
+import { GraphQualityMode, GraphRelation, GraphMemoryRecord } from "../graph/ontology";
+interface LoggerLike {
+    debug: (message: string, ...args: unknown[]) => void;
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+}
+interface GraphMemoryStoreOptions {
+    projectRoot: string;
+    memoryRoot: string;
+    logger: LoggerLike;
+    qualityMode?: GraphQualityMode;
+}
+interface GraphPayloadInput {
+    sourceEventId: string;
+    sourceLayer: "archive_event" | "active_only";
+    archiveEventId?: string;
+    sessionId: string;
+    sourceFile?: string;
+    eventType?: string;
+    entities?: string[];
+    entity_types?: Record<string, string>;
+    relations?: GraphRelation[];
+    gateSource: "sync" | "session_end" | "manual";
+    confidence?: number;
+    sourceText?: string;
+}
+interface AppendResult {
+    success: boolean;
+    reason?: string;
+    record?: GraphMemoryRecord;
+}
+export declare function createGraphMemoryStore(options: GraphMemoryStoreOptions): {
+    append(input: GraphPayloadInput): Promise<AppendResult>;
+    loadAll(): GraphMemoryRecord[];
+    loadByArchiveEventId(archiveEventId: string): GraphMemoryRecord[];
+    loadByEntity(entityName: string): GraphMemoryRecord[];
+    getStats(): {
+        totalRecords: number;
+        totalEntities: number;
+        totalRelations: number;
+    };
+};
+export type { GraphMemoryRecord, GraphPayloadInput, AppendResult };
+//# sourceMappingURL=graph_memory_store.d.ts.map

package/dist/src/store/graph_memory_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph_memory_store.d.ts","sourceRoot":"","sources":["../../../src/store/graph_memory_store.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EAGlB,MAAM,mBAAmB,CAAC;AAG3B,UAAU,UAAU;IAClB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrD;AAED,UAAU,uBAAuB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED,UAAU,iBAAiB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,eAAe,GAAG,aAAa,CAAC;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AA0BD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG;IACxE,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACxD,OAAO,IAAI,iBAAiB,EAAE,CAAC;IAC/B,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAClE,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACtD,QAAQ,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CACrF,CA2IA;AAED,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC"}

package/dist/src/store/graph_memory_store.js

@@ -0,0 +1,168 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGraphMemoryStore = createGraphMemoryStore;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const ontology_1 = require("../graph/ontology");
+const llm_output_validator_1 = require("../quality/llm_output_validator");
+function ensureDirForFile(filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+function generateGraphId() {
+    return `gph_${Date.now().toString(36)}_${crypto.randomBytes(4).toString("hex")}`;
+}
+function createGraphMemoryStore(options) {
+    const graphMemoryPath = path.join(options.memoryRoot, "graph", "memory.jsonl");
+    const mutationLogPath = path.join(options.memoryRoot, "graph", "mutation_log.jsonl");
+    const graphSchema = (0, ontology_1.loadGraphSchema)(options.projectRoot);
+    options.logger.info(`Graph memory store initialized at ${graphMemoryPath}`);
+    async function append(input) {
+        const validation = (0, ontology_1.validateGraphPayload)({
+            sourceEventId: input.sourceEventId,
+            sourceLayer: input.sourceLayer,
+            archiveEventId: input.archiveEventId,
+            sessionId: input.sessionId,
+            sourceFile: input.sourceFile,
+            eventType: input.eventType,
+            entities: input.entities,
+            entity_types: input.entity_types,
+            relations: input.relations,
+            gateSource: input.gateSource,
+            confidence: input.confidence,
+            schema: graphSchema,
+            sourceText: input.sourceText,
+            qualityMode: options.qualityMode || "warn",
+        });
+        if (!validation.valid) {
+            options.logger.info(`graph_skip_reason=${validation.reason} source_event_id=${input.sourceEventId}`);
+            return { success: false, reason: validation.reason };
+        }
+        if (Array.isArray(validation.warnings) && validation.warnings.length > 0) {
+            options.logger.warn(`graph_quality_warning source_event_id=${input.sourceEventId} warnings=${validation.warnings.join("|")}`);
+        }
+        const record = validation.normalized;
+        record.id = generateGraphId();
+        record.timestamp = new Date().toISOString();
+        const line = JSON.stringify(record);
+        const qualityCheck = (0, llm_output_validator_1.validateGraphJsonlLine)(line);
+        if (!qualityCheck.valid) {
+            const reason = `graph_record_quality_invalid:${qualityCheck.errors.join("|")}`;
+            options.logger.warn(`graph_skip_reason=${reason} source_event_id=${input.sourceEventId}`);
+            return { success: false, reason };
+        }
+        if (qualityCheck.warnings.length > 0) {
+            options.logger.warn(`graph_quality_warning source_event_id=${input.sourceEventId} warnings=${qualityCheck.warnings.join("|")}`);
+        }
+        const mutationEntry = {
+            op: "insert_graph",
+            id: record.id,
+            source_event_id: record.source_event_id,
+            source_layer: record.source_layer,
+            archive_event_id: record.archive_event_id,
+            timestamp: record.timestamp,
+            session_id: record.session_id,
+            gate_source: record.gate_source,
+            entity_count: record.entities.length,
+            relation_count: record.relations.length,
+        };
+        const mutationLine = JSON.stringify(mutationEntry);
+        ensureDirForFile(graphMemoryPath);
+        ensureDirForFile(mutationLogPath);
+        fs.appendFileSync(graphMemoryPath, `${line}\n`, "utf-8");
+        fs.appendFileSync(mutationLogPath, `${mutationLine}\n`, "utf-8");
+        options.logger.info(`graph_write id=${record.id} source_event_id=${record.source_event_id} source_layer=${record.source_layer} entities=${record.entities.length} relations=${record.relations.length} gate_source=${record.gate_source}`);
+        return { success: true, record };
+    }
+    function loadAll() {
+        if (!fs.existsSync(graphMemoryPath)) {
+            return [];
+        }
+        const content = fs.readFileSync(graphMemoryPath, "utf-8");
+        const lines = content.split(/\r?\n/).filter(Boolean);
+        const records = [];
+        for (const line of lines) {
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed && parsed.id && (parsed.source_event_id || parsed.archive_event_id)) {
+                    if (!parsed.source_event_id && parsed.archive_event_id) {
+                        parsed.source_event_id = parsed.archive_event_id;
+                        parsed.source_layer = "archive_event";
+                    }
+                    records.push(parsed);
+                }
+            }
+            catch {
+                options.logger.warn(`graph_memory_parse_error line=${line.slice(0, 100)}`);
+            }
+        }
+        return records;
+    }
+    function loadByArchiveEventId(archiveEventId) {
+        return loadAll().filter(record => record.archive_event_id === archiveEventId || record.source_event_id === archiveEventId);
+    }
+    function loadByEntity(entityName) {
+        const normalized = entityName.trim().toLowerCase();
+        return loadAll().filter(record => record.entities.some(entity => entity.trim().toLowerCase() === normalized));
+    }
+    function getStats() {
+        const all = loadAll();
+        const entitySet = new Set();
+        let totalRelations = 0;
+        for (const record of all) {
+            for (const entity of record.entities) {
+                entitySet.add(entity.trim().toLowerCase());
+            }
+            totalRelations += record.relations.length;
+        }
+        return {
+            totalRecords: all.length,
+            totalEntities: entitySet.size,
+            totalRelations,
+        };
+    }
+    return {
+        append,
+        loadAll,
+        loadByArchiveEventId,
+        loadByEntity,
+        getStats,
+    };
+}
+//# sourceMappingURL=graph_memory_store.js.map

package/dist/src/store/graph_memory_store.js.map

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

package/dist/src/store/read_store.d.ts

@@ -5,6 +5,7 @@ interface LoggerLike {
 export interface ReadStoreSearchArgs {
     query: string;
     topK: number;
+    mode?: "default" | "lightweight";
 }
 export interface ReadStoreHotArgs {
     limit: number;
@@ -22,6 +23,91 @@ interface ReadStoreOptions {
     projectRoot: string;
     dbPath?: string;
     logger: LoggerLike;
+    embedding?: {
+        provider: string;
+        model: string;
+        apiKey?: string;
+        baseURL?: string;
+        baseUrl?: string;
+        dimensions?: number;
+    };
+    reranker?: {
+        provider?: string;
+        model: string;
+        apiKey?: string;
+        baseURL?: string;
+        baseUrl?: string;
+    };
+    llm?: {
+        provider: string;
+        model: string;
+        apiKey?: string;
+        baseURL?: string;
+        baseUrl?: string;
+    };
+    fusion?: {
+        enabled?: boolean;
+        maxCandidates?: number;
+        authoritative?: boolean;
+        channelWeights?: {
+            rules?: number;
+            archive?: number;
+            vector?: number;
+            graph?: number;
+        };
+        channelTopK?: {
+            rules?: number;
+            archive?: number;
+            vector?: number;
+            graph?: number;
+        };
+        minLexicalHits?: number;
+        minSemanticHits?: number;
+        lengthNorm?: {
+            enabled?: boolean;
+            pivotChars?: number;
+            strength?: number;
+            minFactor?: number;
+        };
+    };
+    memoryDecay?: {
+        enabled?: boolean;
+        minFloor?: number;
+        defaultHalfLifeDays?: number;
+        halfLifeByEventType?: Record<string, number>;
+        antiDecay?: {
+            enabled?: boolean;
+            maxBoost?: number;
+            hitWeight?: number;
+            recentWindowDays?: number;
+        };
+    };
+    readTuning?: {
+        scoring?: {
+            lexicalWeight?: number;
+            bm25Scale?: number;
+            semanticWeight?: number;
+            recencyWeight?: number;
+            qualityWeight?: number;
+            typeMatchWeight?: number;
+            graphMatchWeight?: number;
+        };
+        rrf?: {
+            k?: number;
+            weight?: number;
+        };
+        recency?: {
+            buckets?: Array<{
+                maxAgeHours: number;
+                score: number;
+                bonus: number;
+            }>;
+        };
+        autoContext?: {
+            queryMaxChars?: number;
+            lightweightSearch?: boolean;
+        };
+    };
 }
 export interface ReadStore {
     searchMemory(args: ReadStoreSearchArgs): Promise<{

package/dist/src/store/read_store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read_store.d.ts","sourceRoot":"","sources":["../../../src/store/read_store.ts"],"names":[],"mappings":"AAGA,UAAU,UAAU;IAClB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,EAAE,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AASD,UAAU,gBAAgB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACzE,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACvE,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAC/C,WAAW,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,OAAO,EAAE,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QACzE,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;KACzB,CAAC,CAAC;CACJ;AAiID,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAwFpE"}
+{"version":3,"file":"read_store.d.ts","sourceRoot":"","sources":["../../../src/store/read_store.ts"],"names":[],"mappings":"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"}