@recallkit/core 0.1.0

package/dist/retrieval/contextPack.js

@@ -0,0 +1,40 @@
+import { normalizeMemoryScope } from "../memory/scope.js";
+export function buildContextPack(memories, limit = 6) {
+    const selected = memories
+        .filter((memory) => memory.lifecycle.status === "active")
+        .sort((left, right) => right.retrieval.importance * right.evidence.confidence -
+        left.retrieval.importance * left.evidence.confidence)
+        .slice(0, limit);
+    return formatContextPack(selected);
+}
+export function buildRankedContextPack(matches, memories, limit = 6) {
+    const memoryById = new Map(memories.map((memory) => [memory.id, memory]));
+    const selected = [];
+    const seen = new Set();
+    for (const match of matches) {
+        if (selected.length >= limit || seen.has(match.memoryId))
+            continue;
+        const memory = memoryById.get(match.memoryId);
+        if (!memory || memory.lifecycle.status !== "active")
+            continue;
+        seen.add(match.memoryId);
+        selected.push(memory);
+    }
+    return formatContextPack(selected);
+}
+function formatContextPack(selected) {
+    return {
+        answerHint: selected[0]?.summary ?? "No matching RecallKit memories were found.",
+        memories: selected.map((memory) => ({
+            id: memory.id,
+            kind: memory.kind,
+            text: memory.naturalText,
+            summary: memory.summary,
+            confidence: memory.evidence.confidence,
+            importance: memory.retrieval.importance,
+            source: memory.evidence.source,
+            scope: normalizeMemoryScope(memory.scope),
+        })),
+    };
+}
+//# sourceMappingURL=contextPack.js.map

package/dist/retrieval/contextPack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextPack.js","sourceRoot":"","sources":["../../src/retrieval/contextPack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAoB1D,MAAM,UAAU,gBAAgB,CAAC,QAAwB,EAAE,KAAK,GAAG,CAAC;IAClE,MAAM,QAAQ,GAAG,QAAQ;SACtB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC;SACxD,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,KAAK,CAAC,SAAS,CAAC,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU;QACtD,IAAI,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CACvD;SACA,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAEnB,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAoD,EACpD,QAAwB,EACxB,KAAK,GAAG,CAAC;IAET,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,QAAQ,CAAC,MAAM,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,SAAS;QACnE,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,QAAQ;YAAE,SAAS;QAC9D,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAwB;IACjD,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,4CAA4C;QAChF,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClC,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,WAAW;YACxB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;YACtC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,UAAU;YACvC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC9B,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC;SAC1C,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/retrieval/embeddings.d.ts

@@ -0,0 +1,6 @@
+export type MemoryEmbeddingProvider = {
+    embedQuery: (query: string) => Promise<number[] | undefined> | number[] | undefined;
+};
+export declare function cosineSimilarity(left: number[] | undefined, right: number[] | undefined): number;
+export declare function normalizeSimilarity(score: number): number;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/retrieval/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/retrieval/embeddings.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACrF,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAgBhG;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD"}

package/dist/retrieval/embeddings.js

@@ -0,0 +1,23 @@
+export function cosineSimilarity(left, right) {
+    if (!left?.length || !right?.length || left.length !== right.length)
+        return 0;
+    let dot = 0;
+    let leftNorm = 0;
+    let rightNorm = 0;
+    for (let index = 0; index < left.length; index += 1) {
+        const leftValue = left[index] ?? 0;
+        const rightValue = right[index] ?? 0;
+        dot += leftValue * rightValue;
+        leftNorm += leftValue * leftValue;
+        rightNorm += rightValue * rightValue;
+    }
+    if (leftNorm === 0 || rightNorm === 0)
+        return 0;
+    return dot / (Math.sqrt(leftNorm) * Math.sqrt(rightNorm));
+}
+export function normalizeSimilarity(score) {
+    if (!Number.isFinite(score))
+        return 0;
+    return Math.max(0, Math.min(1, (score + 1) / 2));
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/retrieval/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/retrieval/embeddings.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,gBAAgB,CAAC,IAA0B,EAAE,KAA2B;IACtF,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IAE9E,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,GAAG,IAAI,SAAS,GAAG,UAAU,CAAC;QAC9B,QAAQ,IAAI,SAAS,GAAG,SAAS,CAAC;QAClC,SAAS,IAAI,UAAU,GAAG,UAAU,CAAC;IACvC,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAChD,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/retrieval/hybridRanker.d.ts

@@ -0,0 +1,7 @@
+import type { MemoryIndexEntry } from "../types.js";
+import type { QueryUnderstanding } from "./queryUnderstanding.js";
+export type RankedMemoryIndexEntry = MemoryIndexEntry & {
+    score: number;
+};
+export declare function rankIndexEntries(entries: MemoryIndexEntry[], understanding: QueryUnderstanding): RankedMemoryIndexEntry[];
+//# sourceMappingURL=hybridRanker.d.ts.map

package/dist/retrieval/hybridRanker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybridRanker.d.ts","sourceRoot":"","sources":["../../src/retrieval/hybridRanker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG;IACtD,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,aAAa,EAAE,kBAAkB,GAChC,sBAAsB,EAAE,CAiC1B"}

package/dist/retrieval/hybridRanker.js

@@ -0,0 +1,50 @@
+import { normalizeMemoryScope } from "../memory/scope.js";
+export function rankIndexEntries(entries, understanding) {
+    const queryKeywords = new Set(understanding.keywords.map((keyword) => keyword.toLowerCase()));
+    const likelyKinds = new Set(understanding.likelyKinds);
+    return entries
+        .filter((entry) => entry.status === "active")
+        .map((entry) => {
+        const keywordScore = scoreKeywords(queryKeywords, [
+            ...entry.keywords,
+            ...entry.topics,
+            entry.summary,
+            entry.semanticSummary,
+        ]);
+        const semanticScore = keywordScore;
+        const scope = normalizeMemoryScope(entry.scope);
+        const scopeScore = !understanding.scopeLevel || scope.level === understanding.scopeLevel ? 1 : 0.45;
+        const kindScore = likelyKinds.size === 0 || likelyKinds.has(entry.kind) ? 1 : 0.35;
+        const recencyScore = scoreRecency(entry.updatedAt ?? entry.createdAt);
+        return {
+            ...entry,
+            score: semanticScore * 0.3 +
+                keywordScore * 0.25 +
+                scopeScore * 0.2 +
+                kindScore * 0.1 +
+                entry.importance * 0.07 +
+                entry.confidence * 0.05 +
+                recencyScore * 0.03,
+        };
+    })
+        .sort((left, right) => right.score - left.score);
+}
+function scoreKeywords(queryKeywords, fields) {
+    if (queryKeywords.size === 0)
+        return 0.5;
+    const haystack = fields.join(" ").toLowerCase();
+    let hits = 0;
+    for (const keyword of queryKeywords) {
+        if (haystack.includes(keyword))
+            hits += 1;
+    }
+    return hits / queryKeywords.size;
+}
+function scoreRecency(createdAt) {
+    const ageMs = Date.now() - new Date(createdAt).getTime();
+    if (!Number.isFinite(ageMs) || ageMs < 0)
+        return 1;
+    const ageDays = ageMs / (1000 * 60 * 60 * 24);
+    return Math.max(0.15, 1 - ageDays / 365);
+}
+//# sourceMappingURL=hybridRanker.js.map

package/dist/retrieval/hybridRanker.js.map

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

package/dist/retrieval/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./queryUnderstanding.js";
+export * from "./indexSearch.js";
+export * from "./hybridRanker.js";
+export * from "./contextPack.js";
+export * from "./embeddings.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/retrieval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieval/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/retrieval/index.js

@@ -0,0 +1,6 @@
+export * from "./queryUnderstanding.js";
+export * from "./indexSearch.js";
+export * from "./hybridRanker.js";
+export * from "./contextPack.js";
+export * from "./embeddings.js";
+//# sourceMappingURL=index.js.map

package/dist/retrieval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retrieval/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/retrieval/indexSearch.d.ts

@@ -0,0 +1,19 @@
+import type { MemoryIndexEntry } from "../types.js";
+export type SearchMemoryIndexOptions = {
+    entries?: MemoryIndexEntry[];
+    limit?: number;
+    queryEmbedding?: number[];
+};
+export declare class MemoryIndexSearcher {
+    private readonly entries;
+    private readonly miniSearch;
+    constructor(entries: MemoryIndexEntry[]);
+    search(query: string, options?: SearchMemoryIndexOptions): Array<MemoryIndexEntry & {
+        score: number;
+    }>;
+}
+export declare function createMemoryIndexSearcher(entries: MemoryIndexEntry[]): MemoryIndexSearcher;
+export declare function searchMemoryIndex(entries: MemoryIndexEntry[], query: string, limit?: number): Array<MemoryIndexEntry & {
+    score: number;
+}>;
+//# sourceMappingURL=indexSearch.d.ts.map

package/dist/retrieval/indexSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexSearch.d.ts","sourceRoot":"","sources":["../../src/retrieval/indexSearch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpD,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+B;gBAE9C,OAAO,EAAE,gBAAgB,EAAE;IAUvC,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,wBAA6B,GACrC,KAAK,CAAC,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAwB/C;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,mBAAmB,CAE1F;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,KAAK,SAAI,GACR,KAAK,CAAC,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAE7C"}

package/dist/retrieval/indexSearch.js

@@ -0,0 +1,44 @@
+import MiniSearch from "minisearch";
+import { rankIndexEntries } from "./hybridRanker.js";
+import { cosineSimilarity, normalizeSimilarity } from "./embeddings.js";
+import { understandQuery } from "./queryUnderstanding.js";
+export class MemoryIndexSearcher {
+    entries;
+    miniSearch;
+    constructor(entries) {
+        this.entries = entries.filter((entry) => entry.status === "active");
+        this.miniSearch = new MiniSearch({
+            fields: ["summary", "semanticSummary", "keywords", "topics"],
+            storeFields: ["memoryId"],
+            idField: "memoryId",
+        });
+        this.miniSearch.addAll(this.entries);
+    }
+    search(query, options = {}) {
+        const limit = options.limit ?? 6;
+        const entries = (options.entries ?? this.entries).filter((entry) => entry.status === "active");
+        if (entries.length === 0)
+            return [];
+        const understanding = understandQuery(query);
+        const ranked = rankIndexEntries(entries, understanding);
+        const lexicalIds = new Set(this.miniSearch.search(query, { prefix: true, fuzzy: 0.2 }).map((hit) => hit.id));
+        return ranked
+            .map((entry) => ({
+            ...entry,
+            score: entry.score +
+                (lexicalIds.has(entry.memoryId) ? 0.1 : 0) +
+                (options.queryEmbedding
+                    ? normalizeSimilarity(cosineSimilarity(options.queryEmbedding, entry.embedding)) * 0.12
+                    : 0),
+        }))
+            .sort((left, right) => right.score - left.score)
+            .slice(0, limit);
+    }
+}
+export function createMemoryIndexSearcher(entries) {
+    return new MemoryIndexSearcher(entries);
+}
+export function searchMemoryIndex(entries, query, limit = 6) {
+    return createMemoryIndexSearcher(entries).search(query, { limit });
+}
+//# sourceMappingURL=indexSearch.js.map

package/dist/retrieval/indexSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexSearch.js","sourceRoot":"","sources":["../../src/retrieval/indexSearch.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAQ1D,MAAM,OAAO,mBAAmB;IACb,OAAO,CAAqB;IAC5B,UAAU,CAA+B;IAE1D,YAAY,OAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QACpE,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAmB;YACjD,MAAM,EAAE,CAAC,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,CAAC;YAC5D,WAAW,EAAE,CAAC,UAAU,CAAC;YACzB,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CACJ,KAAa,EACb,UAAoC,EAAE;QAEtC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QAC/F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CACjF,CAAC;QAEF,OAAO,MAAM;aACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACf,GAAG,KAAK;YACR,KAAK,EACH,KAAK,CAAC,KAAK;gBACX,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1C,CAAC,OAAO,CAAC,cAAc;oBACrB,CAAC,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,OAAO,CAAC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI;oBACvF,CAAC,CAAC,CAAC,CAAC;SACT,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;aAC/C,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,OAA2B;IACnE,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAA2B,EAC3B,KAAa,EACb,KAAK,GAAG,CAAC;IAET,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AACrE,CAAC"}

package/dist/retrieval/queryUnderstanding.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryKind, MemoryScopeLevel } from "../memory/schemas.js";
+export type QueryUnderstanding = {
+    scopeLevel?: MemoryScopeLevel;
+    projectId?: string;
+    likelyKinds: MemoryKind[];
+    keywords: string[];
+};
+export declare function understandQuery(query: string): QueryUnderstanding;
+//# sourceMappingURL=queryUnderstanding.d.ts.map

package/dist/retrieval/queryUnderstanding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryUnderstanding.d.ts","sourceRoot":"","sources":["../../src/retrieval/queryUnderstanding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGzE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CA0BjE"}

package/dist/retrieval/queryUnderstanding.js

@@ -0,0 +1,27 @@
+import { extractKeywords } from "../memory/compiler.js";
+export function understandQuery(query) {
+    const lower = query.toLowerCase();
+    const likelyKinds = new Set();
+    let scopeLevel;
+    if (/\b(project|architecture|build|repo)\b/.test(lower)) {
+        scopeLevel = "project";
+        likelyKinds.add("project");
+    }
+    if (/\b(prefer|like|style)\b/.test(lower)) {
+        likelyKinds.add("preference");
+        likelyKinds.add("style");
+    }
+    if (/\b(decide|decision|should|must|never|constraint)\b/.test(lower)) {
+        likelyKinds.add("decision");
+        likelyKinds.add("constraint");
+    }
+    if (/\bhow should i talk|how should i write|tone\b/.test(lower)) {
+        likelyKinds.add("style");
+    }
+    return {
+        ...(scopeLevel ? { scopeLevel } : {}),
+        likelyKinds: [...likelyKinds],
+        keywords: extractKeywords(query),
+    };
+}
+//# sourceMappingURL=queryUnderstanding.js.map

package/dist/retrieval/queryUnderstanding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryUnderstanding.js","sourceRoot":"","sources":["../../src/retrieval/queryUnderstanding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AASxD,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAc,CAAC;IAC1C,IAAI,UAAwC,CAAC;IAE7C,IAAI,uCAAuC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,UAAU,GAAG,SAAS,CAAC;QACvB,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC9B,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,oDAAoD,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5B,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,+CAA+C,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC;QAC7B,QAAQ,EAAE,eAAe,CAAC,KAAK,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/storage/cacheStore.d.ts

@@ -0,0 +1,3 @@
+export declare function readCacheJson<T>(name: string, baseDir?: string): Promise<T | undefined>;
+export declare function writeCacheJson<T>(name: string, value: T, baseDir?: string): Promise<void>;
+//# sourceMappingURL=cacheStore.d.ts.map

package/dist/storage/cacheStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheStore.d.ts","sourceRoot":"","sources":["../../src/storage/cacheStore.ts"],"names":[],"mappings":"AAIA,wBAAsB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAAmB,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAEvG;AAED,wBAAsB,cAAc,CAAC,CAAC,EACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,EACR,OAAO,SAAmB,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/storage/cacheStore.js

@@ -0,0 +1,10 @@
+import { cacheFilePath } from "./paths.js";
+import { defaultBaseDir } from "./paths.js";
+import { readJsonFile, writeJsonFile } from "./jsonFile.js";
+export async function readCacheJson(name, baseDir = defaultBaseDir()) {
+    return readJsonFile(cacheFilePath(name, baseDir), undefined);
+}
+export async function writeCacheJson(name, value, baseDir = defaultBaseDir()) {
+    await writeJsonFile(cacheFilePath(name, baseDir), value);
+}
+//# sourceMappingURL=cacheStore.js.map

package/dist/storage/cacheStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheStore.js","sourceRoot":"","sources":["../../src/storage/cacheStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,IAAY,EAAE,OAAO,GAAG,cAAc,EAAE;IAC7E,OAAO,YAAY,CAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,KAAQ,EACR,OAAO,GAAG,cAAc,EAAE;IAE1B,MAAM,aAAa,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC"}

package/dist/storage/configStore.d.ts

@@ -0,0 +1,10 @@
+import type { WalletStatus } from "../types.js";
+export type RecallKitConfig = {
+    ownerWallet?: string;
+    approvalAppUrl: string;
+    arkivChain: "braga";
+};
+export declare function readConfig(baseDir?: string): Promise<RecallKitConfig>;
+export declare function writeConfig(config: Partial<RecallKitConfig>, baseDir?: string): Promise<RecallKitConfig>;
+export declare function getWalletStatus(baseDir?: string): Promise<WalletStatus>;
+//# sourceMappingURL=configStore.d.ts.map

package/dist/storage/configStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configStore.d.ts","sourceRoot":"","sources":["../../src/storage/configStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAOF,wBAAsB,UAAU,CAAC,OAAO,SAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAGrF;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,OAAO,SAAmB,GACzB,OAAO,CAAC,eAAe,CAAC,CAI1B;AAED,wBAAsB,eAAe,CAAC,OAAO,SAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAYvF"}

package/dist/storage/configStore.js

@@ -0,0 +1,40 @@
+import { DEFAULT_APPROVAL_APP_URL } from "../constants.js";
+import { configFilePath, defaultBaseDir } from "./paths.js";
+import { readJsonFile, writeJsonFile } from "./jsonFile.js";
+const defaultConfig = {
+    approvalAppUrl: DEFAULT_APPROVAL_APP_URL,
+    arkivChain: "braga",
+};
+export async function readConfig(baseDir = defaultBaseDir()) {
+    const config = await readJsonFile(configFilePath(baseDir), {});
+    return normalizeConfig(config);
+}
+export async function writeConfig(config, baseDir = defaultBaseDir()) {
+    const next = normalizeConfig({ ...(await readConfig(baseDir)), ...config });
+    await writeJsonFile(configFilePath(baseDir), next);
+    return next;
+}
+export async function getWalletStatus(baseDir = defaultBaseDir()) {
+    const config = await readConfig(baseDir);
+    return {
+        connected: Boolean(config.ownerWallet),
+        approvalAppUrl: config.approvalAppUrl,
+        ...(config.ownerWallet
+            ? {
+                ownerWallet: config.ownerWallet,
+                network: config.arkivChain,
+            }
+            : {}),
+    };
+}
+function normalizeConfig(config) {
+    const normalized = {
+        approvalAppUrl: config.approvalAppUrl ?? defaultConfig.approvalAppUrl,
+        arkivChain: "braga",
+    };
+    if (config.ownerWallet) {
+        normalized.ownerWallet = config.ownerWallet;
+    }
+    return normalized;
+}
+//# sourceMappingURL=configStore.js.map

package/dist/storage/configStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configStore.js","sourceRoot":"","sources":["../../src/storage/configStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQ5D,MAAM,aAAa,GAAoB;IACrC,cAAc,EAAE,wBAAwB;IACxC,UAAU,EAAE,OAAO;CACpB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAO,GAAG,cAAc,EAAE;IACzD,MAAM,MAAM,GAAG,MAAM,YAAY,CAA2B,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACzF,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAgC,EAChC,OAAO,GAAG,cAAc,EAAE;IAE1B,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC5E,MAAM,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAO,GAAG,cAAc,EAAE;IAC9D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;QACtC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,GAAG,CAAC,MAAM,CAAC,WAAW;YACpB,CAAC,CAAC;gBACE,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,OAAO,EAAE,MAAM,CAAC,UAAU;aAC3B;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,MAAgC;IACvD,MAAM,UAAU,GAAoB;QAClC,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,aAAa,CAAC,cAAc;QACrE,UAAU,EAAE,OAAO;KACpB,CAAC;IAEF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,UAAU,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAC9C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./paths.js";
+export * from "./jsonFile.js";
+export * from "./configStore.js";
+export * from "./pendingMemoryStore.js";
+export * from "./cacheStore.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,6 @@
+export * from "./paths.js";
+export * from "./jsonFile.js";
+export * from "./configStore.js";
+export * from "./pendingMemoryStore.js";
+export * from "./cacheStore.js";
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

package/dist/storage/jsonFile.d.ts

@@ -0,0 +1,5 @@
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function readJsonFile<T>(filePath: string, fallback: T): Promise<T>;
+export declare function writeJsonFile<T>(filePath: string, value: T): Promise<void>;
+export declare function isMissingFile(error: unknown): boolean;
+//# sourceMappingURL=jsonFile.d.ts.map

package/dist/storage/jsonFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonFile.d.ts","sourceRoot":"","sources":["../../src/storage/jsonFile.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAO/E;AAED,wBAAsB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAErD"}

package/dist/storage/jsonFile.js

@@ -0,0 +1,23 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+export async function ensureDir(dir) {
+    await fs.mkdir(dir, { recursive: true });
+}
+export async function readJsonFile(filePath, fallback) {
+    try {
+        return JSON.parse(await fs.readFile(filePath, "utf8"));
+    }
+    catch (error) {
+        if (isMissingFile(error))
+            return fallback;
+        throw error;
+    }
+}
+export async function writeJsonFile(filePath, value) {
+    await ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+export function isMissingFile(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+//# sourceMappingURL=jsonFile.js.map

package/dist/storage/jsonFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonFile.js","sourceRoot":"","sources":["../../src/storage/jsonFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB,EAAE,QAAW;IACjE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAM,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,aAAa,CAAC,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC1C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,QAAgB,EAAE,KAAQ;IAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnG,CAAC"}

package/dist/storage/paths.d.ts

@@ -0,0 +1,7 @@
+export declare function defaultBaseDir(): string;
+export declare function recallKitDir(baseDir?: string): string;
+export declare function pendingFilePath(baseDir?: string): string;
+export declare function configFilePath(baseDir?: string): string;
+export declare function cacheDir(baseDir?: string): string;
+export declare function cacheFilePath(name: string, baseDir?: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/storage/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/storage/paths.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,YAAY,CAAC,OAAO,SAAmB,GAAG,MAAM,CAE/D;AAED,wBAAgB,eAAe,CAAC,OAAO,SAAmB,GAAG,MAAM,CAElE;AAED,wBAAgB,cAAc,CAAC,OAAO,SAAmB,GAAG,MAAM,CAEjE;AAED,wBAAgB,QAAQ,CAAC,OAAO,SAAmB,GAAG,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAmB,GAAG,MAAM,CAE9E"}

package/dist/storage/paths.js

@@ -0,0 +1,21 @@
+import path from "node:path";
+import { DEFAULT_RECALLKIT_DIR } from "../constants.js";
+export function defaultBaseDir() {
+    return process.env.RECALLKIT_DATA_DIR ?? process.cwd();
+}
+export function recallKitDir(baseDir = defaultBaseDir()) {
+    return path.join(baseDir, DEFAULT_RECALLKIT_DIR);
+}
+export function pendingFilePath(baseDir = defaultBaseDir()) {
+    return path.join(recallKitDir(baseDir), "pending.json");
+}
+export function configFilePath(baseDir = defaultBaseDir()) {
+    return path.join(recallKitDir(baseDir), "config.json");
+}
+export function cacheDir(baseDir = defaultBaseDir()) {
+    return path.join(recallKitDir(baseDir), "cache");
+}
+export function cacheFilePath(name, baseDir = defaultBaseDir()) {
+    return path.join(cacheDir(baseDir), name);
+}
+//# sourceMappingURL=paths.js.map

package/dist/storage/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/storage/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,cAAc,EAAE;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAO,GAAG,cAAc,EAAE;IACxD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAO,GAAG,cAAc,EAAE;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAO,GAAG,cAAc,EAAE;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAO,GAAG,cAAc,EAAE;IACpE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/storage/pendingMemoryStore.d.ts

@@ -0,0 +1,9 @@
+import { type PendingMemoryCandidate } from "../memory/schemas.js";
+export declare function ensureRecallKitDir(baseDir?: string): Promise<void>;
+export declare function readPendingMemories(baseDir?: string): Promise<PendingMemoryCandidate[]>;
+export declare function writePendingMemories(pending: PendingMemoryCandidate[], baseDir?: string): Promise<void>;
+export declare function addPendingMemory(candidate: PendingMemoryCandidate, baseDir?: string): Promise<PendingMemoryCandidate>;
+export declare function updatePendingMemory(id: string, update: Partial<PendingMemoryCandidate>, baseDir?: string): Promise<PendingMemoryCandidate | undefined>;
+export declare function deletePendingMemory(id: string, baseDir?: string): Promise<boolean>;
+export declare function clearCommittedPending(ids: string[], baseDir?: string): Promise<void>;
+//# sourceMappingURL=pendingMemoryStore.d.ts.map

package/dist/storage/pendingMemoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingMemoryStore.d.ts","sourceRoot":"","sources":["../../src/storage/pendingMemoryStore.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAI1F,wBAAsB,kBAAkB,CAAC,OAAO,SAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;AAED,wBAAsB,mBAAmB,CAAC,OAAO,SAAmB,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAGvG;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,EAAE,EACjC,OAAO,SAAmB,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,sBAAsB,EACjC,OAAO,SAAmB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAKjC;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,EACvC,OAAO,SAAmB,GACzB,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAW7C;AAED,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,SAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlG;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,SAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpG"}

package/dist/storage/pendingMemoryStore.js

@@ -0,0 +1,74 @@
+import { normalizeMemoryScope, reasonForScope } from "../memory/scope.js";
+import { isPendingMemoryStatus } from "../memory/schemas.js";
+import { writeJsonFile, ensureDir, readJsonFile } from "./jsonFile.js";
+import { defaultBaseDir, pendingFilePath, recallKitDir } from "./paths.js";
+export async function ensureRecallKitDir(baseDir = defaultBaseDir()) {
+    await ensureDir(recallKitDir(baseDir));
+}
+export async function readPendingMemories(baseDir = defaultBaseDir()) {
+    const parsed = await readJsonFile(pendingFilePath(baseDir), []);
+    return Array.isArray(parsed) ? parsed.map(normalizePendingMemoryCandidate).filter(isPendingMemoryCandidate) : [];
+}
+export async function writePendingMemories(pending, baseDir = defaultBaseDir()) {
+    await writeJsonFile(pendingFilePath(baseDir), pending);
+}
+export async function addPendingMemory(candidate, baseDir = defaultBaseDir()) {
+    const pending = await readPendingMemories(baseDir);
+    pending.unshift(candidate);
+    await writePendingMemories(pending, baseDir);
+    return candidate;
+}
+export async function updatePendingMemory(id, update, baseDir = defaultBaseDir()) {
+    const pending = await readPendingMemories(baseDir);
+    const index = pending.findIndex((candidate) => candidate.id === id);
+    if (index === -1)
+        return undefined;
+    const existing = pending[index];
+    if (!existing)
+        return undefined;
+    const next = { ...existing, ...update };
+    pending[index] = next;
+    await writePendingMemories(pending, baseDir);
+    return next;
+}
+export async function deletePendingMemory(id, baseDir = defaultBaseDir()) {
+    const pending = await readPendingMemories(baseDir);
+    const next = pending.filter((candidate) => candidate.id !== id);
+    await writePendingMemories(next, baseDir);
+    return next.length !== pending.length;
+}
+export async function clearCommittedPending(ids, baseDir = defaultBaseDir()) {
+    const selected = new Set(ids);
+    const pending = await readPendingMemories(baseDir);
+    await writePendingMemories(pending.filter((candidate) => !selected.has(candidate.id)), baseDir);
+}
+function isPendingMemoryCandidate(value) {
+    const candidate = value;
+    return (typeof candidate === "object" &&
+        candidate !== null &&
+        typeof candidate.id === "string" &&
+        typeof candidate.text === "string" &&
+        typeof candidate.kind === "string" &&
+        typeof candidate.scope === "object" &&
+        candidate.scope !== null &&
+        typeof candidate.scopeReason === "string" &&
+        Array.isArray(candidate.tags) &&
+        typeof candidate.reason === "string" &&
+        typeof candidate.createdAt === "string" &&
+        typeof candidate.createdByAgent === "string" &&
+        typeof candidate.importance === "number" &&
+        typeof candidate.confidence === "number" &&
+        isPendingMemoryStatus(candidate.status));
+}
+function normalizePendingMemoryCandidate(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return value;
+    const candidate = value;
+    const scope = normalizeMemoryScope(candidate.scope);
+    return {
+        ...candidate,
+        scope,
+        scopeReason: typeof candidate.scopeReason === "string" ? candidate.scopeReason : reasonForScope(scope),
+    };
+}
+//# sourceMappingURL=pendingMemoryStore.js.map

package/dist/storage/pendingMemoryStore.js.map

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

package/dist/tests/memory/scope.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scope.test.d.ts.map

package/dist/tests/memory/scope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.test.d.ts","sourceRoot":"","sources":["../../../src/tests/memory/scope.test.ts"],"names":[],"mappings":""}