@recallkit/core 0.1.0

package/dist/memory/compiler.js

@@ -0,0 +1,148 @@
+import { nanoid } from "nanoid";
+import { inferSuggestedScope, normalizeMemoryScope } from "./scope.js";
+import { scoreConfidence, scoreImportance } from "./scoring.js";
+const STOP_WORDS = new Set([
+    "the",
+    "and",
+    "for",
+    "that",
+    "this",
+    "with",
+    "from",
+    "into",
+    "must",
+    "should",
+    "would",
+    "about",
+    "their",
+    "there",
+    "using",
+    "use",
+]);
+export function classifyMemoryKind(text, provided) {
+    if (provided)
+        return provided;
+    const lower = text.toLowerCase();
+    if (/\b(must|never|required|constraint|privacy|private key)\b/.test(lower))
+        return "constraint";
+    if (/\b(decided|decision|choose|chosen|architecture)\b/.test(lower))
+        return "decision";
+    if (/\b(prefer|likes|default to|style)\b/.test(lower))
+        return "preference";
+    if (/\b(warn|avoid|risk|unsafe|insufficient)\b/.test(lower))
+        return "warning";
+    if (/\b(project|repo|workspace|build)\b/.test(lower))
+        return "project";
+    return "fact";
+}
+export function extractKeywords(text, tags = []) {
+    const words = text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, " ")
+        .split(/\s+/)
+        .filter((word) => word.length > 2 && !STOP_WORDS.has(word));
+    return [...new Set([...tags, ...words])].slice(0, 16);
+}
+export function summarizeText(text) {
+    const normalized = text.replace(/\s+/g, " ").trim();
+    if (normalized.length <= 140)
+        return normalized;
+    return `${normalized.slice(0, 137).trim()}...`;
+}
+export function compileMemoryCandidate(input, createdByAgent = "agent") {
+    const text = input.text.replace(/\s+/g, " ").trim();
+    if (!text)
+        throw new Error("Memory text is required.");
+    const kind = classifyMemoryKind(text, input.kind);
+    const reason = input.reason?.trim() || "Agent proposed this as durable user or project context.";
+    const scopeSuggestion = inferSuggestedScope({
+        text,
+        kind,
+        ...(input.scope ? { scope: input.scope } : {}),
+        ...(input.projectId ? { projectId: input.projectId } : {}),
+        ...(input.workspaceId ? { workspaceId: input.workspaceId } : {}),
+        ...(input.repoPath ? { repoPath: input.repoPath } : {}),
+    });
+    return {
+        id: `pending_${nanoid(12)}`,
+        text,
+        kind,
+        scope: scopeSuggestion.scope,
+        scopeReason: input.scopeReason?.trim() || scopeSuggestion.scopeReason,
+        tags: input.tags ?? [],
+        reason,
+        importance: scoreImportance(text, kind, input.importance),
+        confidence: scoreConfidence(reason, true),
+        createdAt: new Date().toISOString(),
+        createdByAgent,
+        status: "pending",
+    };
+}
+export function pendingToMemoryRecord(pending, ownerWallet) {
+    const keywords = extractKeywords(pending.text, pending.tags);
+    const summary = summarizeText(pending.text);
+    const scope = {
+        ...normalizeMemoryScope(pending.scope),
+        ownerWallet,
+    };
+    return {
+        id: `mem_${nanoid(16)}`,
+        kind: pending.kind,
+        subject: summary.split(/\s+/).slice(0, 5).join(" "),
+        predicate: inferPredicate(pending.kind),
+        object: summary,
+        naturalText: pending.text,
+        summary,
+        scope,
+        evidence: {
+            source: pending.status === "pending" ? "explicit_user_statement" : "user_edited",
+            confidence: pending.confidence,
+            reason: pending.reason,
+            createdByAgent: pending.createdByAgent,
+        },
+        retrieval: {
+            keywords,
+            topics: inferTopics(pending.text, pending.kind, keywords),
+            semanticSummary: summary,
+            importance: pending.importance,
+            freshness: 1,
+        },
+        lifecycle: {
+            createdAt: new Date().toISOString(),
+            status: "active",
+        },
+        links: {
+            relatedMemoryIds: [],
+        },
+    };
+}
+function inferPredicate(kind) {
+    switch (kind) {
+        case "constraint":
+            return "must_follow";
+        case "decision":
+            return "decided";
+        case "preference":
+            return "prefers";
+        case "instruction":
+            return "instructs";
+        case "warning":
+            return "warns";
+        default:
+            return "records";
+    }
+}
+function inferTopics(text, kind, keywords) {
+    const topics = new Set([kind]);
+    const lower = text.toLowerCase();
+    if (lower.includes("wallet") || lower.includes("private key"))
+        topics.add("wallet UX");
+    if (lower.includes("arkiv"))
+        topics.add("Arkiv writes");
+    if (lower.includes("privacy") || lower.includes("encrypt"))
+        topics.add("privacy");
+    for (const keyword of keywords.slice(0, 4))
+        topics.add(keyword);
+    return [...topics].slice(0, 8);
+}
+//# sourceMappingURL=compiler.js.map

package/dist/memory/compiler.js.map

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

package/dist/memory/conflict.d.ts

@@ -0,0 +1,10 @@
+import type { MemoryIndexEntry } from "../types.js";
+import type { MemoryRecord } from "./schemas.js";
+export type ConflictResult = {
+    memoryId: string;
+    conflictsWith: string;
+    reason: string;
+};
+export declare function detectConflicts(newMemories: MemoryRecord[], existingEntries: MemoryIndexEntry[]): ConflictResult[];
+export declare function markSuperseded(entries: MemoryIndexEntry[], conflicts: ConflictResult[]): MemoryIndexEntry[];
+//# sourceMappingURL=conflict.d.ts.map

package/dist/memory/conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../src/memory/conflict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AASjD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,eAAe,CAC7B,WAAW,EAAE,YAAY,EAAE,EAC3B,eAAe,EAAE,gBAAgB,EAAE,GAClC,cAAc,EAAE,CAwBlB;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,SAAS,EAAE,cAAc,EAAE,GAC1B,gBAAgB,EAAE,CAOpB"}

package/dist/memory/conflict.js

@@ -0,0 +1,38 @@
+import { keywordOverlap } from "./scoring.js";
+const contradictionPairs = [
+    [/\bprivate key\b.*\b(use|ask|store|import)\b/i, /\bnever\b.*\bprivate key\b/i],
+    [/\bsponsored wallet\b/i, /\bconnected (user )?wallet\b/i],
+    [/\bone (signature|transaction) per memory\b/i, /\bbatch(ed)?\b/i],
+];
+export function detectConflicts(newMemories, existingEntries) {
+    const conflicts = [];
+    for (const memory of newMemories) {
+        for (const entry of existingEntries) {
+            if (entry.status !== "active")
+                continue;
+            if (entry.kind !== memory.kind && keywordOverlap(entry.keywords, memory.retrieval.keywords) < 0.4) {
+                continue;
+            }
+            const left = `${entry.summary} ${entry.semanticSummary}`;
+            const right = `${memory.summary} ${memory.naturalText}`;
+            if (isContradiction(left, right)) {
+                conflicts.push({
+                    memoryId: memory.id,
+                    conflictsWith: entry.memoryId,
+                    reason: "New memory appears to supersede an older policy or decision.",
+                });
+            }
+        }
+    }
+    return conflicts;
+}
+export function markSuperseded(entries, conflicts) {
+    const superseded = new Set(conflicts.map((conflict) => conflict.conflictsWith));
+    return entries.map((entry) => superseded.has(entry.memoryId)
+        ? { ...entry, status: "superseded", updatedAt: new Date().toISOString() }
+        : entry);
+}
+function isContradiction(left, right) {
+    return contradictionPairs.some(([a, b]) => (a.test(left) && b.test(right)) || (b.test(left) && a.test(right)));
+}
+//# sourceMappingURL=conflict.js.map

package/dist/memory/conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.js","sourceRoot":"","sources":["../../src/memory/conflict.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,kBAAkB,GAA4B;IAClD,CAAC,8CAA8C,EAAE,6BAA6B,CAAC;IAC/E,CAAC,uBAAuB,EAAE,+BAA+B,CAAC;IAC1D,CAAC,6CAA6C,EAAE,iBAAiB,CAAC;CACnE,CAAC;AAQF,MAAM,UAAU,eAAe,CAC7B,WAA2B,EAC3B,eAAmC;IAEnC,MAAM,SAAS,GAAqB,EAAE,CAAC;IAEvC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAS;YACxC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,GAAG,EAAE,CAAC;gBAClG,SAAS;YACX,CAAC;YAED,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAExD,IAAI,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;gBACjC,SAAS,CAAC,IAAI,CAAC;oBACb,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,aAAa,EAAE,KAAK,CAAC,QAAQ;oBAC7B,MAAM,EAAE,8DAA8D;iBACvE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAA2B,EAC3B,SAA2B;IAE3B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IAChF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3B,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC5B,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QACzE,CAAC,CAAC,KAAK,CACV,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa;IAClD,OAAO,kBAAkB,CAAC,IAAI,CAC5B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAC/E,CAAC;AACJ,CAAC"}

package/dist/memory/consolidation.d.ts

@@ -0,0 +1,3 @@
+import type { MemoryRecord } from "./schemas.js";
+export declare function createConsolidatedMemory(memories: MemoryRecord[]): MemoryRecord | undefined;
+//# sourceMappingURL=consolidation.d.ts.map

package/dist/memory/consolidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../../src/memory/consolidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,GAAG,SAAS,CAqC3F"}

package/dist/memory/consolidation.js

@@ -0,0 +1,38 @@
+export function createConsolidatedMemory(memories) {
+    if (memories.length < 3)
+        return undefined;
+    const related = memories
+        .filter((memory) => memory.kind === "constraint" || memory.kind === "decision")
+        .slice(0, 5);
+    if (related.length < 3)
+        return undefined;
+    const base = related[0];
+    if (!base)
+        return undefined;
+    const combined = related.map((memory) => memory.summary.replace(/\.$/, "")).join(". ");
+    return {
+        ...base,
+        id: `${base.id}_consolidated`,
+        kind: "project",
+        subject: "RecallKit memory policy",
+        predicate: "summarizes",
+        object: combined,
+        naturalText: combined,
+        summary: combined.length > 180 ? `${combined.slice(0, 177).trim()}...` : combined,
+        evidence: {
+            ...base.evidence,
+            reason: "Consolidated from related user-approved memory candidates.",
+        },
+        retrieval: {
+            ...base.retrieval,
+            keywords: [...new Set(related.flatMap((memory) => memory.retrieval.keywords))].slice(0, 16),
+            topics: [...new Set(related.flatMap((memory) => memory.retrieval.topics))].slice(0, 10),
+            importance: Math.max(...related.map((memory) => memory.retrieval.importance)),
+        },
+        links: {
+            parentMemoryId: base.id,
+            relatedMemoryIds: related.map((memory) => memory.id),
+        },
+    };
+}
+//# sourceMappingURL=consolidation.js.map

package/dist/memory/consolidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation.js","sourceRoot":"","sources":["../../src/memory/consolidation.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB,CAAC,QAAwB;IAC/D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAE1C,MAAM,OAAO,GAAG,QAAQ;SACrB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;SAC9E,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEvF,OAAO;QACL,GAAG,IAAI;QACP,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,eAAe;QAC7B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,yBAAyB;QAClC,SAAS,EAAE,YAAY;QACvB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ;QACjF,QAAQ,EAAE;YACR,GAAG,IAAI,CAAC,QAAQ;YAChB,MAAM,EAAE,4DAA4D;SACrE;QACD,SAAS,EAAE;YACT,GAAG,IAAI,CAAC,SAAS;YACjB,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC3F,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACvF,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;SAC9E;QACD,KAAK,EAAE;YACL,cAAc,EAAE,IAAI,CAAC,EAAE;YACvB,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;SACrD;KACF,CAAC;AACJ,CAAC"}

package/dist/memory/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./schemas.js";
+export * from "./compiler.js";
+export * from "./scoring.js";
+export * from "./consolidation.js";
+export * from "./conflict.js";
+export * from "./scope.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,7 @@
+export * from "./schemas.js";
+export * from "./compiler.js";
+export * from "./scoring.js";
+export * from "./consolidation.js";
+export * from "./conflict.js";
+export * from "./scope.js";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/memory/schemas.d.ts

@@ -0,0 +1,75 @@
+export type MemoryKind = "preference" | "fact" | "project" | "decision" | "constraint" | "instruction" | "task_context" | "relationship" | "style" | "warning";
+export type MemorySource = "explicit_user_statement" | "agent_inference" | "imported_context" | "user_edited";
+export type MemoryStatus = "active" | "superseded" | "archived" | "deleted";
+export declare const PENDING_MEMORY_STATUSES: readonly ["pending", "approved", "rejected", "committed"];
+export type PendingMemoryStatus = (typeof PENDING_MEMORY_STATUSES)[number];
+export declare function isPendingMemoryStatus(value: unknown): value is PendingMemoryStatus;
+export type MemoryScopeLevel = "global" | "project" | "session";
+export type MemoryScope = {
+    level: MemoryScopeLevel;
+    projectId?: string;
+    workspaceId?: string;
+    repoPath?: string;
+    ownerWallet?: string;
+};
+export type MemoryRecord = {
+    id: string;
+    kind: MemoryKind;
+    subject: string;
+    predicate: string;
+    object: string;
+    naturalText: string;
+    summary: string;
+    scope: MemoryScope;
+    evidence: {
+        source: MemorySource;
+        confidence: number;
+        reason: string;
+        createdByAgent: string;
+    };
+    retrieval: {
+        keywords: string[];
+        topics: string[];
+        semanticSummary: string;
+        importance: number;
+        freshness: number;
+    };
+    lifecycle: {
+        createdAt: string;
+        updatedAt?: string;
+        expiresAt?: string;
+        status: MemoryStatus;
+    };
+    links: {
+        parentMemoryId?: string;
+        relatedMemoryIds: string[];
+        supersedes?: string;
+    };
+};
+export type PendingMemoryCandidate = {
+    id: string;
+    text: string;
+    kind: MemoryKind;
+    scope: MemoryScope;
+    scopeReason: string;
+    tags: string[];
+    reason: string;
+    importance: number;
+    confidence: number;
+    createdAt: string;
+    createdByAgent: string;
+    status: PendingMemoryStatus;
+};
+export type SuggestMemoryInput = {
+    text: string;
+    kind?: MemoryKind;
+    scope?: Partial<MemoryScope>;
+    projectId?: string;
+    workspaceId?: string;
+    repoPath?: string;
+    tags?: string[];
+    reason?: string;
+    scopeReason?: string;
+    importance?: number;
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/memory/schemas.d.ts.map

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

package/dist/memory/schemas.js

@@ -0,0 +1,5 @@
+export const PENDING_MEMORY_STATUSES = ["pending", "approved", "rejected", "committed"];
+export function isPendingMemoryStatus(value) {
+    return typeof value === "string" && PENDING_MEMORY_STATUSES.includes(value);
+}
+//# sourceMappingURL=schemas.js.map

package/dist/memory/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/memory/schemas.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAU,CAAC;AAGjG,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,uBAA6C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACrG,CAAC"}

package/dist/memory/scope.d.ts

@@ -0,0 +1,24 @@
+import type { MemoryIndexEntry } from "../types.js";
+import type { MemoryScope } from "./schemas.js";
+export type ScopeMode = "global_only" | "project_with_global" | "project_only";
+type ScopeInput = Partial<MemoryScope> | undefined;
+export declare function normalizeMemoryScope(scope?: ScopeInput): MemoryScope;
+export declare function normalizeScopeMode(value: unknown, projectId?: string): ScopeMode;
+export declare function isMemoryEntryInScope(entry: MemoryIndexEntry, params: {
+    projectId?: string;
+    scopeMode: ScopeMode;
+}): boolean;
+export declare function inferSuggestedScope(input: {
+    text: string;
+    scope?: ScopeInput;
+    projectId?: string;
+    workspaceId?: string;
+    repoPath?: string;
+    kind?: string;
+}): {
+    scope: MemoryScope;
+    scopeReason: string;
+};
+export declare function reasonForScope(scope: MemoryScope): string;
+export {};
+//# sourceMappingURL=scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/memory/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAC;AAElE,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,qBAAqB,GAAG,cAAc,CAAC;AAK/E,KAAK,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;AAEnD,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,WAAW,CAkBpE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAKhF;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,GACnD,OAAO,CAsBT;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAuC9C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAUzD"}

package/dist/memory/scope.js

@@ -0,0 +1,96 @@
+const VALID_SCOPE_LEVELS = new Set(["global", "project", "session"]);
+const VALID_SCOPE_MODES = new Set(["global_only", "project_with_global", "project_only"]);
+export function normalizeMemoryScope(scope) {
+    if (!scope || typeof scope !== "object")
+        return { level: "global" };
+    const projectId = cleanString(scope.projectId);
+    const workspaceId = cleanString(scope.workspaceId);
+    const repoPath = cleanString(scope.repoPath);
+    const explicitLevel = VALID_SCOPE_LEVELS.has(scope.level)
+        ? scope.level
+        : undefined;
+    const level = explicitLevel ?? (projectId || workspaceId || repoPath ? "project" : "global");
+    return {
+        level,
+        ...(level === "project" && projectId ? { projectId } : {}),
+        ...(level === "project" && workspaceId ? { workspaceId } : {}),
+        ...(level === "project" && repoPath ? { repoPath } : {}),
+        ...(scope.ownerWallet ? { ownerWallet: scope.ownerWallet } : {}),
+    };
+}
+export function normalizeScopeMode(value, projectId) {
+    if (typeof value === "string" && VALID_SCOPE_MODES.has(value)) {
+        return value;
+    }
+    return projectId ? "project_with_global" : "global_only";
+}
+export function isMemoryEntryInScope(entry, params) {
+    if (entry.status && entry.status !== "active")
+        return false;
+    const scope = normalizeMemoryScope(entry.scope);
+    const projectId = cleanString(params.projectId);
+    if (params.scopeMode === "global_only") {
+        return scope.level === "global";
+    }
+    if (params.scopeMode === "project_only") {
+        return Boolean(projectId && scope.level === "project" && scope.projectId === projectId);
+    }
+    if (params.scopeMode === "project_with_global") {
+        return (scope.level === "global" ||
+            Boolean(projectId && scope.level === "project" && scope.projectId === projectId));
+    }
+    return false;
+}
+export function inferSuggestedScope(input) {
+    const mergedScope = {
+        ...(input.scope ?? {}),
+        ...(input.projectId ? { projectId: input.projectId } : {}),
+        ...(input.workspaceId ? { workspaceId: input.workspaceId } : {}),
+        ...(input.repoPath ? { repoPath: input.repoPath } : {}),
+    };
+    if (input.scope?.level || input.projectId || input.workspaceId || input.repoPath) {
+        const scope = normalizeMemoryScope(mergedScope);
+        return { scope, scopeReason: reasonForScope(scope) };
+    }
+    const lower = input.text.toLowerCase();
+    if (/\b(command output|temporary|for now|debugging|current branch|one-off|short-lived|todo today|this session)\b/.test(lower)) {
+        return {
+            scope: { level: "session" },
+            scopeReason: "This looks like temporary session context that should stay local unless upgraded.",
+        };
+    }
+    if (/\b(architecture|repo|repository|file|path|bug|implementation|deploy|deployment|feature|branch|build|current project)\b/.test(lower)) {
+        return {
+            scope: normalizeMemoryScope({ level: "project" }),
+            scopeReason: "This appears to be project-specific implementation or architecture context.",
+        };
+    }
+    if (/\b(prefer|preference|communication style|coding style|security preference|always|never|general|across projects|tool preference)\b/.test(lower)) {
+        return {
+            scope: { level: "global" },
+            scopeReason: "This appears to be a stable user preference that can apply across projects.",
+        };
+    }
+    return {
+        scope: { level: "global" },
+        scopeReason: "No project was provided, so this memory defaults to global scope.",
+    };
+}
+export function reasonForScope(scope) {
+    if (scope.level === "project") {
+        return scope.projectId
+            ? `This memory is tied to the ${scope.projectId} project.`
+            : "This memory is tied to the current project. Add a project id before committing if it should be project-specific.";
+    }
+    if (scope.level === "session") {
+        return "This memory is temporary session context and stays local unless upgraded.";
+    }
+    return "This memory can apply across projects.";
+}
+function cleanString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+//# sourceMappingURL=scope.js.map

package/dist/memory/scope.js.map

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

package/dist/memory/scoring.d.ts

@@ -0,0 +1,6 @@
+import type { MemoryKind } from "./schemas.js";
+export declare function clampScore(value: number, fallback?: number): number;
+export declare function scoreImportance(text: string, kind: MemoryKind, provided?: number): number;
+export declare function scoreConfidence(reason: string | undefined, explicit?: boolean): number;
+export declare function keywordOverlap(left: string[], right: string[]): number;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/memory/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/memory/scoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/C,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAGhE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAezF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,UAAO,GAAG,MAAM,CAInF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAStE"}

package/dist/memory/scoring.js

@@ -0,0 +1,39 @@
+const highValueKinds = new Set(["constraint", "decision", "instruction", "warning"]);
+export function clampScore(value, fallback = 0.5) {
+    if (!Number.isFinite(value))
+        return fallback;
+    return Math.max(0, Math.min(1, value));
+}
+export function scoreImportance(text, kind, provided) {
+    if (typeof provided === "number")
+        return clampScore(provided);
+    const lower = text.toLowerCase();
+    let score = highValueKinds.has(kind) ? 0.8 : 0.55;
+    if (/\b(must|never|required|always|prefer|decision|architecture|private key|wallet)\b/.test(lower)) {
+        score += 0.15;
+    }
+    if (/\b(temporary|today|right now|scratch|draft)\b/.test(lower)) {
+        score -= 0.2;
+    }
+    return clampScore(score);
+}
+export function scoreConfidence(reason, explicit = true) {
+    if (!explicit)
+        return 0.62;
+    if (reason?.trim())
+        return 0.94;
+    return 0.88;
+}
+export function keywordOverlap(left, right) {
+    if (left.length === 0 || right.length === 0)
+        return 0;
+    const a = new Set(left.map((item) => item.toLowerCase()));
+    const b = new Set(right.map((item) => item.toLowerCase()));
+    let overlap = 0;
+    for (const item of a) {
+        if (b.has(item))
+            overlap += 1;
+    }
+    return overlap / Math.max(a.size, b.size);
+}
+//# sourceMappingURL=scoring.js.map

package/dist/memory/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../src/memory/scoring.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,IAAI,GAAG,CAAa,CAAC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAEjG,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,QAAQ,GAAG,GAAG;IACtD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAgB,EAAE,QAAiB;IAC/E,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE9D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAElD,IAAI,kFAAkF,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnG,KAAK,IAAI,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,+CAA+C,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,KAAK,IAAI,GAAG,CAAC;IACf,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAA0B,EAAE,QAAQ,GAAG,IAAI;IACzE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAc,EAAE,KAAe;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC3D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/retrieval/contextPack.d.ts

@@ -0,0 +1,21 @@
+import type { MemoryRecord, MemoryScope } from "../memory/schemas.js";
+import type { MemoryIndexEntry } from "../types.js";
+export type ContextPackMemory = {
+    id: string;
+    kind: string;
+    text: string;
+    summary: string;
+    confidence: number;
+    importance: number;
+    source: string;
+    scope: MemoryScope;
+};
+export type ContextPack = {
+    answerHint: string;
+    memories: ContextPackMemory[];
+};
+export declare function buildContextPack(memories: MemoryRecord[], limit?: number): ContextPack;
+export declare function buildRankedContextPack(matches: Array<MemoryIndexEntry & {
+    score: number;
+}>, memories: MemoryRecord[], limit?: number): ContextPack;
+//# sourceMappingURL=contextPack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextPack.d.ts","sourceRoot":"","sources":["../../src/retrieval/contextPack.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,KAAK,SAAI,GAAG,WAAW,CAWjF;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,KAAK,CAAC,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACpD,QAAQ,EAAE,YAAY,EAAE,EACxB,KAAK,SAAI,GACR,WAAW,CAcb"}