agent-recall-core 3.3.10 → 3.3.12

package/dist/tools-logic/smart-recall.js

@@ -0,0 +1,199 @@
+/**
+ * smart_recall — unified cross-store search.
+ *
+ * Searches palace, journal, and insights in one call.
+ * Returns ranked results with source attribution.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { palaceSearch } from "./palace-search.js";
+import { journalSearch } from "./journal-search.js";
+import { recallInsight } from "./recall-insight.js";
+import { getRoot } from "../types.js";
+import { ensureDir } from "../storage/fs-utils.js";
+/** Simple stable hash for feedback matching. */
+function stableId(source, title) {
+    let hash = 0;
+    const str = `${source}:${title}`;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash |= 0;
+    }
+    return Math.abs(hash).toString(36).slice(0, 8);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Calculate keyword overlap between query and text. */
+function keywordExactness(query, text) {
+    const queryWords = query.toLowerCase().split(/\s+/).filter((w) => w.length > 2);
+    if (queryWords.length === 0)
+        return 0;
+    const textLower = text.toLowerCase();
+    const matches = queryWords.filter((w) => textLower.includes(w));
+    return matches.length / queryWords.length;
+}
+/** Days between a date string and now. */
+function daysSince(dateStr) {
+    const d = new Date(dateStr);
+    if (isNaN(d.getTime()))
+        return 365; // fallback: old
+    return Math.max(0, (Date.now() - d.getTime()) / (1000 * 60 * 60 * 24));
+}
+function feedbackLogPath() {
+    return path.join(getRoot(), "feedback-log.json");
+}
+function readFeedbackLog() {
+    const p = feedbackLogPath();
+    if (!fs.existsSync(p))
+        return [];
+    try {
+        return JSON.parse(fs.readFileSync(p, "utf-8"));
+    }
+    catch {
+        return [];
+    }
+}
+/** Process relevance feedback — store and adjust salience signals. */
+function processFeedback(feedback, query) {
+    ensureDir(path.dirname(feedbackLogPath()));
+    const log = readFeedbackLog();
+    const date = new Date().toISOString().slice(0, 10);
+    for (const f of feedback) {
+        log.push({ query, id: f.id, title: f.title ?? "", useful: f.useful, date });
+    }
+    // Keep last 200 entries
+    fs.writeFileSync(feedbackLogPath(), JSON.stringify(log.slice(-200), null, 2), "utf-8");
+}
+export async function smartRecall(input) {
+    // Process relevance feedback if provided
+    if (input.feedback && input.feedback.length > 0) {
+        processFeedback(input.feedback, input.query);
+    }
+    const limit = input.limit ?? 10;
+    const allResults = [];
+    let totalSearched = 0;
+    const sourcesQueried = [];
+    // 1. Palace search
+    try {
+        const palaceResults = await palaceSearch({ query: input.query, project: input.project });
+        sourcesQueried.push("palace");
+        totalSearched += palaceResults.total_matches;
+        for (const r of palaceResults.results) {
+            const title = `${r.room}/${r.file}`;
+            allResults.push({
+                id: stableId("palace", title),
+                source: "palace",
+                title,
+                excerpt: r.excerpt,
+                score: 0, // computed below
+                room: r.room,
+            });
+            // Compute score: salience as relevance, keyword match, recency unknown (use salience as proxy)
+            const relevance = r.salience;
+            const exactness = keywordExactness(input.query, r.excerpt);
+            const recency = r.salience; // palace salience already incorporates recency
+            allResults[allResults.length - 1].score =
+                relevance * 0.50 + exactness * 0.30 + recency * 0.20;
+        }
+    }
+    catch {
+        // Palace may not be initialized
+    }
+    // 2. Journal search
+    try {
+        const journalResults = await journalSearch({
+            query: input.query,
+            project: input.project,
+            include_palace: false,
+        });
+        sourcesQueried.push("journal");
+        totalSearched += journalResults.results.length;
+        for (const r of journalResults.results) {
+            const days = daysSince(r.date);
+            const recency = Math.pow(0.95, days);
+            const exactness = keywordExactness(input.query, r.excerpt);
+            const title = `${r.date} / ${r.section}`;
+            allResults.push({
+                id: stableId("journal", title),
+                source: "journal",
+                title,
+                excerpt: r.excerpt,
+                score: recency * 0.60 + exactness * 0.40,
+                date: r.date,
+            });
+        }
+    }
+    catch {
+        // Journal may not exist
+    }
+    // 3. Insight recall
+    try {
+        const insightResults = await recallInsight({
+            context: input.query,
+            limit: limit,
+            include_awareness: false,
+        });
+        sourcesQueried.push("insight");
+        totalSearched += insightResults.total_in_index;
+        // Normalize relevance scores
+        const maxRelevance = Math.max(1, ...insightResults.matching_insights.map((i) => i.relevance));
+        for (const i of insightResults.matching_insights) {
+            const relevance = i.relevance / maxRelevance;
+            const exactness = keywordExactness(input.query, i.title);
+            // Insights don't have dates, use confirmation count as a recency proxy
+            const recency = Math.min(1.0, Math.log2(i.confirmed + 1) / 3);
+            allResults.push({
+                id: stableId("insight", i.title),
+                source: "insight",
+                title: i.title,
+                excerpt: `[${i.severity}] ${i.applies_when.join(", ")}`,
+                score: relevance * 0.50 + exactness * 0.30 + recency * 0.20,
+                severity: i.severity,
+            });
+        }
+    }
+    catch {
+        // Insights may be empty
+    }
+    // 4.5 Apply feedback adjustments — query-aware, ID-first matching
+    const feedbackLog = readFeedbackLog();
+    if (feedbackLog.length > 0) {
+        // Pre-filter: only feedback from similar queries
+        const queryWords = input.query.toLowerCase().split(/\s+/).filter((w) => w.length > 2);
+        const relevantFeedback = feedbackLog.filter((f) => {
+            if (!f.query)
+                return true; // legacy entries without query always apply
+            const fWords = f.query.toLowerCase().split(/\s+/).filter((w) => w.length > 2);
+            const overlap = queryWords.filter((w) => fWords.includes(w)).length;
+            return overlap > 0;
+        });
+        for (const r of allResults) {
+            const match = (f) => (f.id && f.id === r.id) || (f.title && f.title === r.title);
+            const positives = relevantFeedback.filter((f) => match(f) && f.useful).length;
+            const negatives = relevantFeedback.filter((f) => match(f) && !f.useful).length;
+            r.score += (positives * 0.03) - (negatives * 0.05);
+            r.score = Math.max(0, Math.min(1, r.score));
+        }
+    }
+    // 5. Deduplicate: if same excerpt appears in palace and journal, keep palace
+    const seen = new Set();
+    const deduped = [];
+    for (const r of allResults) {
+        const key = r.excerpt.toLowerCase().replace(/\s+/g, " ").trim();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        deduped.push(r);
+    }
+    // 5. Sort by score descending, return top N
+    deduped.sort((a, b) => b.score - a.score);
+    return {
+        query: input.query,
+        results: deduped.slice(0, limit),
+        total_searched: totalSearched,
+        sources_queried: sourcesQueried,
+    };
+}
+//# sourceMappingURL=smart-recall.js.map

package/dist/tools-logic/smart-recall.js.map

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

package/dist/tools-logic/smart-remember.d.ts

@@ -0,0 +1,20 @@
+/**
+ * smart_remember — classify content and route to the right memory store.
+ *
+ * Agents call one tool; the system figures out where it belongs.
+ * Pure keyword scoring, no LLM calls.
+ */
+export interface SmartRememberInput {
+    content: string;
+    context?: string;
+    project?: string;
+}
+export interface SmartRememberResult {
+    success: boolean;
+    routed_to: string;
+    classification: string;
+    auto_name: string;
+    result: unknown;
+}
+export declare function smartRemember(input: SmartRememberInput): Promise<SmartRememberResult>;
+//# sourceMappingURL=smart-remember.d.ts.map

package/dist/tools-logic/smart-remember.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-remember.d.ts","sourceRoot":"","sources":["../../src/tools-logic/smart-remember.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AA0ED,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiE3F"}

package/dist/tools-logic/smart-remember.js

@@ -0,0 +1,138 @@
+/**
+ * smart_remember — classify content and route to the right memory store.
+ *
+ * Agents call one tool; the system figures out where it belongs.
+ * Pure keyword scoring, no LLM calls.
+ */
+import { generateSlug, detectContentType } from "../helpers/auto-name.js";
+import { journalCapture } from "./journal-capture.js";
+import { palaceWrite } from "./palace-write.js";
+import { knowledgeWrite } from "./knowledge-write.js";
+import { awarenessUpdate } from "./awareness-update.js";
+const ROUTE_SIGNALS = {
+    knowledge_write: [
+        /\bbug\b/i, /\bfix(ed)?\b/i, /\berror\b/i, /\broot cause\b/i, /\blesson\b/i,
+        /\bregression\b/i, /\bcrash(ed)?\b/i, /\bworkaround\b/i, /\bwhat happened\b/i,
+        /\bbroke\b/i, /\bexception\b/i, /\btraceback\b/i, /\bstacktrace\b/i,
+        /\bthrew\b/i, /\bpanic\b/i, /\bfailed\b/i, /\bnull pointer\b/i,
+        /\bundefined\b.*\berror\b/i, /\btypeerror\b/i, /\battributeerror\b/i,
+    ],
+    awareness_update: [
+        /\balways\b/i, /\bnever\b/i, /\bpattern\b/i, /\bacross projects\b/i,
+        /\binsight\b/i, /\bgeneral rule\b/i, /\bapplies when\b/i, /\brealized\b/i,
+        /\bcross-project\b/i, /\bobserved that\b/i,
+    ],
+    palace_write: [
+        /\barchitecture\b/i, /\bdecision\b/i, /\bdesign\b/i, /\bschema\b/i,
+        /\bapproach\b/i, /\bchose\b/i, /\bdecided\b/i, /\bwill use\b/i,
+        /\bstructure\b/i, /\bapi\b/i,
+    ],
+    journal_capture: [
+        /\btoday\b/i, /\bsession\b/i, /\bcompleted\b/i, /\bworked on\b/i,
+        /\btried\b/i, /\bstatus\b/i, /\bprogress\b/i, /\bblocked\b/i,
+        /\bnext\b/i, /\bdid\b/i,
+    ],
+};
+// Higher boost = more specific store. knowledge and awareness get slight boosts
+// because they're more valuable when correctly classified.
+const ROUTE_BOOSTS = {
+    knowledge_write: 1.2,
+    awareness_update: 1.3,
+    palace_write: 1.0,
+    journal_capture: 1.0,
+};
+function classifyRoute(content, context) {
+    const text = context ? `${context} ${content}` : content;
+    // Check context hint first (strong signal)
+    if (context) {
+        const lower = context.toLowerCase();
+        if (/bug|fix|error|regression|crash/i.test(lower))
+            return "knowledge_write";
+        if (/architecture|design|decision|schema/i.test(lower))
+            return "palace_write";
+        if (/insight|lesson|pattern|across/i.test(lower))
+            return "awareness_update";
+        if (/session|log|today|progress/i.test(lower))
+            return "journal_capture";
+    }
+    // Score each route
+    const scores = [];
+    for (const [route, patterns] of Object.entries(ROUTE_SIGNALS)) {
+        let count = 0;
+        for (const pattern of patterns) {
+            if (pattern.test(text))
+                count++;
+        }
+        scores.push({ route, score: count * ROUTE_BOOSTS[route] });
+    }
+    scores.sort((a, b) => b.score - a.score);
+    // Default to journal_capture if no clear signal
+    return scores[0].score > 0 ? scores[0].route : "journal_capture";
+}
+// ---------------------------------------------------------------------------
+// Dispatch
+// ---------------------------------------------------------------------------
+export async function smartRemember(input) {
+    const route = classifyRoute(input.content, input.context);
+    const slugResult = generateSlug(input.content);
+    const autoName = slugResult.slug;
+    let result;
+    switch (route) {
+        case "journal_capture": {
+            result = await journalCapture({
+                question: "Auto-captured",
+                answer: input.content,
+                project: input.project,
+            });
+            break;
+        }
+        case "palace_write": {
+            // Use content type as room, auto-name generates the topic
+            const contentType = detectContentType(input.content);
+            const room = contentType === "general" ? "knowledge" : contentType;
+            result = await palaceWrite({
+                room,
+                content: input.content,
+                project: input.project,
+                auto_name: true,
+            });
+            break;
+        }
+        case "knowledge_write": {
+            // Extract title from first sentence or first line
+            const firstLine = input.content.split(/[.\n]/)[0]?.trim() ?? "Auto-captured lesson";
+            result = await knowledgeWrite({
+                category: slugResult.contentType,
+                title: firstLine.slice(0, 80),
+                what_happened: input.content,
+                root_cause: "See content",
+                fix: "See content",
+                project: input.project,
+            });
+            break;
+        }
+        case "awareness_update": {
+            // Extract title from first sentence
+            const title = input.content.split(/[.\n]/)[0]?.trim().slice(0, 80) ?? "Auto-captured insight";
+            result = await awarenessUpdate({
+                insights: [
+                    {
+                        title,
+                        evidence: input.content,
+                        applies_when: slugResult.keywords,
+                        source: `smart_remember ${new Date().toISOString().slice(0, 10)}`,
+                    },
+                ],
+            });
+            break;
+        }
+    }
+    return {
+        success: true,
+        routed_to: route,
+        classification: slugResult.contentType,
+        auto_name: autoName,
+        result,
+    };
+}
+//# sourceMappingURL=smart-remember.js.map

package/dist/tools-logic/smart-remember.js.map

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

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared types, interfaces, and constants for agent-recall-mcp.
  */
-export declare const VERSION = "3.3.10";
+export declare const VERSION = "3.3.12";
 /**
  * Set the storage root directory. This is process-global state —
  * only one root is active at a time. Call before any other operations.

package/dist/types.js

@@ -6,7 +6,7 @@ import * as os from "node:os";
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
-export const VERSION = "3.3.10";
+export const VERSION = "3.3.12";
 // ---------------------------------------------------------------------------
 // Root directory (configurable at runtime for SDK usage)
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-recall-core",
-  "version": "3.3.10",
+  "version": "3.3.12",
   "description": "Core memory palace engine for AgentRecall",
   "type": "module",
   "main": "dist/index.js",