agent-recall-mcp 3.2.3 → 3.3.2

package/dist/tools/knowledge-read.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=knowledge-read.d.ts.map

package/dist/tools/knowledge-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-read.d.ts","sourceRoot":"","sources":["../../src/tools/knowledge-read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwHhD"}

package/dist/tools/knowledge-read.js

@@ -0,0 +1,118 @@
+import * as z from "zod/v4";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+export function register(server) {
+    server.registerTool("knowledge_read", {
+        title: "Read Knowledge Lessons",
+        description: "Read lessons from knowledge files. Used before starting work to learn from past mistakes. " +
+            "Can filter by project, category, and search query.",
+        inputSchema: {
+            project: z.string().optional().describe("Specific project, or omit for all projects"),
+            category: z
+                .enum(["extraction", "build", "verification", "tools", "general"])
+                .optional()
+                .describe("Specific category, or omit for all categories"),
+            query: z.string().optional().describe("Search term to filter lessons (case-insensitive)"),
+        },
+    }, async ({ project, category, query }) => {
+        const baseDir = process.env.AGENT_RECALL_DIR || path.join(os.homedir(), ".agent-recall");
+        const projectsDir = path.join(baseDir, "projects");
+        let projectDirs = [];
+        if (project) {
+            const safe = project.replace(/[^a-zA-Z0-9_\-\.]/g, "-");
+            const dir = path.join(projectsDir, safe, "knowledge");
+            if (fs.existsSync(dir)) {
+                projectDirs.push({ slug: safe, dir });
+            }
+        }
+        else {
+            if (fs.existsSync(projectsDir)) {
+                try {
+                    const entries = fs.readdirSync(projectsDir);
+                    for (const entry of entries) {
+                        const dir = path.join(projectsDir, entry, "knowledge");
+                        if (fs.existsSync(dir)) {
+                            projectDirs.push({ slug: entry, dir });
+                        }
+                    }
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+        if (projectDirs.length === 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "No knowledge entries found. Start logging lessons with knowledge_write.",
+                    }],
+            };
+        }
+        const categories = category
+            ? [`${category}.md`]
+            : ["extraction.md", "build.md", "verification.md", "tools.md", "general.md"];
+        let combined = "";
+        for (const pd of projectDirs) {
+            for (const catFile of categories) {
+                const filePath = path.join(pd.dir, catFile);
+                if (!fs.existsSync(filePath))
+                    continue;
+                const content = fs.readFileSync(filePath, "utf-8");
+                if (query) {
+                    const queryLower = query.toLowerCase();
+                    const lines = content.split("\n");
+                    const matchedEntries = [];
+                    let currentEntry = [];
+                    for (const line of lines) {
+                        if (line.startsWith("### ")) {
+                            if (currentEntry.length > 0) {
+                                const entryText = currentEntry.join("\n");
+                                if (entryText.toLowerCase().includes(queryLower)) {
+                                    matchedEntries.push(entryText);
+                                }
+                            }
+                            currentEntry = [line];
+                        }
+                        else {
+                            currentEntry.push(line);
+                        }
+                    }
+                    if (currentEntry.length > 0) {
+                        const entryText = currentEntry.join("\n");
+                        if (entryText.toLowerCase().includes(queryLower)) {
+                            matchedEntries.push(entryText);
+                        }
+                    }
+                    if (matchedEntries.length > 0) {
+                        combined += `\n## ${pd.slug} / ${catFile.replace(".md", "")}\n\n`;
+                        combined += matchedEntries.join("\n") + "\n";
+                    }
+                }
+                else {
+                    combined += `\n## ${pd.slug} / ${catFile.replace(".md", "")}\n\n`;
+                    combined += content + "\n";
+                }
+            }
+        }
+        if (!combined.trim()) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "No knowledge entries found. Start logging lessons with knowledge_write.",
+                    }],
+            };
+        }
+        if (combined.length > 5000) {
+            combined = combined.slice(0, 5000) + "\n\n...(truncated, narrow your query for more)";
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: combined,
+                }],
+        };
+    });
+}
+//# sourceMappingURL=knowledge-read.js.map

package/dist/tools/knowledge-read.js.map

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

package/dist/tools/knowledge-write.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=knowledge-write.d.ts.map

package/dist/tools/knowledge-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-write.d.ts","sourceRoot":"","sources":["../../src/tools/knowledge-write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmFhD"}

package/dist/tools/knowledge-write.js

@@ -0,0 +1,89 @@
+import * as z from "zod/v4";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { ensureDir, todayISO } from "../storage/fs-utils.js";
+import { resolveProject } from "../storage/project.js";
+import { palaceDir } from "../storage/paths.js";
+import { ensurePalaceInitialized, roomExists, createRoom } from "../palace/rooms.js";
+import { fanOut } from "../palace/fan-out.js";
+import { updatePalaceIndex } from "../palace/index-manager.js";
+export function register(server) {
+    server.registerTool("knowledge_write", {
+        title: "Write Knowledge Lesson",
+        description: "Write a structured lesson to the knowledge palace room. " +
+            "Category is now dynamic — any string creates a topic file in the knowledge room. " +
+            "Also writes to legacy knowledge/ dir for backward compatibility.",
+        inputSchema: {
+            project: z.string().default("auto").describe("Project name for scoping"),
+            category: z.string().describe("Knowledge category (any string — creates a topic file in the knowledge room)"),
+            title: z.string().describe("Short title of the lesson"),
+            what_happened: z.string().describe("What went wrong or right"),
+            root_cause: z.string().describe("Why it happened"),
+            fix: z.string().describe("How to prevent/fix it"),
+            severity: z
+                .enum(["critical", "important", "minor"])
+                .default("important")
+                .describe("Severity level of the lesson"),
+        },
+    }, async ({ project, category, title, what_happened, root_cause, fix, severity }) => {
+        const slug = await resolveProject(project);
+        const safe = slug.replace(/[^a-zA-Z0-9_\-\.]/g, "-");
+        const safeCategory = category.replace(/[^a-zA-Z0-9_\-]/g, "-").toLowerCase();
+        const date = todayISO();
+        let entry = `### ${title} (${slug}, ${date})\n`;
+        entry += `- **What happened:** ${what_happened}\n`;
+        entry += `- **Root cause:** ${root_cause}\n`;
+        entry += `- **Fix:** ${fix}\n`;
+        entry += `- **Severity:** ${severity}\n\n`;
+        // Legacy: write to knowledge/ dir
+        const baseDir = process.env.AGENT_RECALL_ROOT || path.join(os.homedir(), ".agent-recall");
+        const knowledgeDir = path.join(baseDir, "projects", safe, "knowledge");
+        ensureDir(knowledgeDir);
+        const legacyPath = path.join(knowledgeDir, `${safeCategory}.md`);
+        if (!fs.existsSync(legacyPath)) {
+            fs.writeFileSync(legacyPath, `# Knowledge — ${category}\n\n${entry}`, "utf-8");
+        }
+        else {
+            fs.appendFileSync(legacyPath, entry, "utf-8");
+        }
+        // Palace: write to knowledge room
+        let palaceResult = null;
+        try {
+            ensurePalaceInitialized(slug);
+            if (!roomExists(slug, "knowledge")) {
+                createRoom(slug, "knowledge", "Knowledge", "Learned lessons by category", ["learning"]);
+            }
+            const pd = palaceDir(slug);
+            const topicPath = path.join(pd, "rooms", "knowledge", `${safeCategory}.md`);
+            ensureDir(path.dirname(topicPath));
+            if (!fs.existsSync(topicPath)) {
+                fs.writeFileSync(topicPath, `# knowledge / ${category}\n\n${entry}`, "utf-8");
+            }
+            else {
+                fs.appendFileSync(topicPath, entry, "utf-8");
+            }
+            fanOut(slug, "knowledge", safeCategory, `${title}: ${what_happened}`, [], severity === "critical" ? "high" : "medium");
+            updatePalaceIndex(slug);
+            palaceResult = { room: "knowledge", topic: safeCategory };
+        }
+        catch {
+            // Palace integration is optional
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        project: slug,
+                        category: safeCategory,
+                        title,
+                        severity,
+                        file: legacyPath,
+                        palace: palaceResult,
+                    }),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=knowledge-write.js.map

package/dist/tools/knowledge-write.js.map

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

package/dist/tools/nudge.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=nudge.d.ts.map

package/dist/tools/nudge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nudge.d.ts","sourceRoot":"","sources":["../../src/tools/nudge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoChD"}

package/dist/tools/nudge.js

@@ -0,0 +1,41 @@
+import * as z from "zod/v4";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { resolveProject } from "../storage/project.js";
+import { journalDir } from "../storage/paths.js";
+import { ensureDir, todayISO } from "../storage/fs-utils.js";
+export function register(server) {
+    server.registerTool("nudge", {
+        title: "Nudge",
+        description: "Surface a contradiction between the human's current input and a prior statement/decision. Helps the human clarify their own thinking.",
+        inputSchema: {
+            past_statement: z.string().describe("What the human said/decided before (with date if known)"),
+            current_statement: z.string().describe("What the human is saying now"),
+            question: z.string().describe("The clarifying question to ask"),
+            category: z.enum(["goal", "scope", "priority", "technical", "aesthetic"]).default("goal"),
+            project: z.string().default("auto"),
+        },
+    }, async ({ past_statement, current_statement, question, category, project }) => {
+        const slug = await resolveProject(project);
+        const date = todayISO();
+        const dir = journalDir(slug);
+        ensureDir(dir);
+        const time = new Date().toISOString().slice(11, 19);
+        let entry = `### Nudge (${time})\n`;
+        entry += `**Past**: ${past_statement}\n`;
+        entry += `**Now**: ${current_statement}\n`;
+        entry += `**Question**: ${question}\n`;
+        entry += `**Category**: ${category}\n\n`;
+        const logPath = path.join(dir, `${date}-alignment.md`);
+        if (!fs.existsSync(logPath)) {
+            fs.writeFileSync(logPath, `# ${date} — Alignment Records\n\n---\n\n${entry}`, "utf-8");
+        }
+        else {
+            fs.appendFileSync(logPath, entry, "utf-8");
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, date, category, file: logPath }) }],
+        };
+    });
+}
+//# sourceMappingURL=nudge.js.map

package/dist/tools/nudge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nudge.js","sourceRoot":"","sources":["../../src/tools/nudge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,KAAK,EAAE,OAAO;QACd,WAAW,EACT,uIAAuI;QACzI,WAAW,EAAE;YACX,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;YAC9F,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAC/D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YACzF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC;KACF,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;QAC9E,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC7B,SAAS,CAAC,GAAG,CAAC,CAAC;QAEf,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,KAAK,GAAG,cAAc,IAAI,KAAK,CAAC;QACpC,KAAK,IAAI,aAAa,cAAc,IAAI,CAAC;QACzC,KAAK,IAAI,YAAY,iBAAiB,IAAI,CAAC;QAC3C,KAAK,IAAI,iBAAiB,QAAQ,IAAI,CAAC;QACvC,KAAK,IAAI,iBAAiB,QAAQ,MAAM,CAAC;QAEzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,eAAe,CAAC,CAAC;QACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,IAAI,kCAAkC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;SAC7G,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/palace-lint.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tool: palace_lint — Health check for the Memory Palace.
+ * Detects contradictions, stale memories, orphan rooms, missing cross-refs.
+ */
+import type { ServerType } from "../server.js";
+export declare function register(server: ServerType): void;
+//# sourceMappingURL=palace-lint.d.ts.map

package/dist/tools/palace-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palace-lint.d.ts","sourceRoot":"","sources":["../../src/tools/palace-lint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAiB/C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAsJjD"}

package/dist/tools/palace-lint.js

@@ -0,0 +1,149 @@
+/**
+ * Tool: palace_lint — Health check for the Memory Palace.
+ * Detects contradictions, stale memories, orphan rooms, missing cross-refs.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as z from "zod/v4";
+import { resolveProject } from "../storage/project.js";
+import { palaceDir } from "../storage/paths.js";
+import { ensurePalaceInitialized, listRooms } from "../palace/rooms.js";
+import { getConnectionCount } from "../palace/graph.js";
+import { computeSalience, ARCHIVE_THRESHOLD } from "../palace/salience.js";
+import { updatePalaceIndex } from "../palace/index-manager.js";
+import { appendToLog } from "../palace/log.js";
+export function register(server) {
+    server.registerTool("palace_lint", {
+        title: "Lint Memory Palace",
+        description: "Health check: find stale memories, orphan rooms (no connections), low-salience entries, " +
+            "and missing cross-references. Use fix=true to auto-archive low-salience entries.",
+        inputSchema: {
+            fix: z.boolean().default(false).describe("If true, auto-archive memories below salience threshold"),
+            project: z.string().default("auto"),
+        },
+    }, async ({ fix, project }) => {
+        const slug = await resolveProject(project);
+        ensurePalaceInitialized(slug);
+        const rooms = listRooms(slug);
+        const pd = palaceDir(slug);
+        const issues = [];
+        let fixed = 0;
+        for (const room of rooms) {
+            const roomPath = path.join(pd, "rooms", room.slug);
+            // Check: orphan rooms (no connections)
+            const connCount = getConnectionCount(pd, room.slug);
+            if (connCount === 0 && room.connections.length === 0) {
+                issues.push({
+                    type: "orphan",
+                    severity: "warning",
+                    room: room.slug,
+                    description: `Room '${room.name}' has no connections to other rooms`,
+                    suggestion: `Add connections via palace_write with [[wikilinks]] or connections param`,
+                });
+            }
+            // Check: stale rooms (not accessed in 30+ days)
+            const daysSinceAccess = (Date.now() - new Date(room.last_accessed).getTime()) / (1000 * 60 * 60 * 24);
+            if (daysSinceAccess > 30) {
+                issues.push({
+                    type: "stale",
+                    severity: "info",
+                    room: room.slug,
+                    description: `Room '${room.name}' not accessed in ${Math.floor(daysSinceAccess)} days`,
+                    suggestion: `Review if still relevant. Access it to refresh salience.`,
+                });
+            }
+            // Check: low salience
+            const salience = computeSalience({
+                importance: "medium",
+                lastUpdated: room.updated,
+                accessCount: room.access_count,
+                connectionCount: connCount,
+            });
+            if (salience < ARCHIVE_THRESHOLD) {
+                issues.push({
+                    type: "low_salience",
+                    severity: "warning",
+                    room: room.slug,
+                    description: `Room '${room.name}' salience is ${salience.toFixed(3)} (below ${ARCHIVE_THRESHOLD})`,
+                    suggestion: fix ? "Auto-archiving..." : "Consider archiving or refreshing with new content",
+                });
+                if (fix) {
+                    // Move room to archive
+                    const archiveDir = path.join(pd, "archive", room.slug);
+                    if (!fs.existsSync(archiveDir)) {
+                        fs.mkdirSync(archiveDir, { recursive: true });
+                    }
+                    // Copy files
+                    if (fs.existsSync(roomPath)) {
+                        const files = fs.readdirSync(roomPath);
+                        for (const file of files) {
+                            fs.copyFileSync(path.join(roomPath, file), path.join(archiveDir, file));
+                        }
+                        // Remove original room
+                        fs.rmSync(roomPath, { recursive: true });
+                        fixed++;
+                    }
+                }
+            }
+            // Check: empty rooms (no content files beyond README.md)
+            if (fs.existsSync(roomPath)) {
+                const files = fs.readdirSync(roomPath)
+                    .filter((f) => f.endsWith(".md") && f !== "README.md");
+                if (files.length === 0) {
+                    issues.push({
+                        type: "empty",
+                        severity: "info",
+                        room: room.slug,
+                        description: `Room '${room.name}' has no topic files (only README)`,
+                        suggestion: "Add content with palace_write(room='${room.slug}', topic='...')",
+                    });
+                }
+            }
+            // Check: missing README.md
+            if (!fs.existsSync(path.join(roomPath, "README.md"))) {
+                issues.push({
+                    type: "missing_readme",
+                    severity: "warning",
+                    room: room.slug,
+                    description: `Room '${room.name}' is missing README.md`,
+                    suggestion: "Recreate with palace_write",
+                });
+            }
+        }
+        // Update palace index after potential changes
+        if (fix && fixed > 0) {
+            updatePalaceIndex(slug);
+        }
+        // Update last_lint timestamp
+        const indexPath = path.join(pd, "palace-index.json");
+        if (fs.existsSync(indexPath)) {
+            try {
+                const index = JSON.parse(fs.readFileSync(indexPath, "utf-8"));
+                index.last_lint = new Date().toISOString();
+                fs.writeFileSync(indexPath, JSON.stringify(index, null, 2), "utf-8");
+            }
+            catch {
+                // ignore
+            }
+        }
+        // Log lint operation
+        appendToLog(slug, "palace_lint", {
+            issues_found: issues.length,
+            fixed,
+            rooms_checked: rooms.length,
+        });
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        project: slug,
+                        issues,
+                        total_issues: issues.length,
+                        fixed,
+                        rooms_checked: rooms.length,
+                    }),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=palace-lint.js.map

package/dist/tools/palace-lint.js.map

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

package/dist/tools/palace-read.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tool: palace_read — Read a room overview or specific topic from the palace.
+ */
+import type { ServerType } from "../server.js";
+export declare function register(server: ServerType): void;
+//# sourceMappingURL=palace-read.d.ts.map

package/dist/tools/palace-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palace-read.d.ts","sourceRoot":"","sources":["../../src/tools/palace-read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK/C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CA2EjD"}

package/dist/tools/palace-read.js

@@ -0,0 +1,78 @@
+/**
+ * Tool: palace_read — Read a room overview or specific topic from the palace.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as z from "zod/v4";
+import { resolveProject } from "../storage/project.js";
+import { palaceDir } from "../storage/paths.js";
+import { ensurePalaceInitialized, getRoomMeta, listRooms, recordAccess } from "../palace/rooms.js";
+export function register(server) {
+    server.registerTool("palace_read", {
+        title: "Read Palace Room",
+        description: "Read a room overview or specific topic from the Memory Palace. " +
+            "Returns room content with metadata. Use without room param to list all rooms.",
+        inputSchema: {
+            room: z.string().optional().describe("Room slug (e.g., 'goals', 'architecture'). Omit to list all rooms."),
+            topic: z.string().optional().describe("Specific topic file within the room (e.g., 'decisions', 'active'). Omit for room README."),
+            project: z.string().default("auto"),
+        },
+    }, async ({ room, topic, project }) => {
+        const slug = await resolveProject(project);
+        ensurePalaceInitialized(slug);
+        if (!room) {
+            // List all rooms
+            const rooms = listRooms(slug);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            project: slug,
+                            rooms: rooms.map((r) => ({
+                                slug: r.slug,
+                                name: r.name,
+                                description: r.description,
+                                salience: r.salience,
+                                connections: r.connections,
+                                tags: r.tags,
+                            })),
+                        }),
+                    }],
+            };
+        }
+        // Read specific room
+        const meta = getRoomMeta(slug, room);
+        if (!meta) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: `Room '${room}' not found in project '${slug}'` }) }],
+                isError: true,
+            };
+        }
+        recordAccess(slug, room);
+        const pd = palaceDir(slug);
+        const targetFile = topic
+            ? path.join(pd, "rooms", room, `${topic}.md`)
+            : path.join(pd, "rooms", room, "README.md");
+        if (!fs.existsSync(targetFile)) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: `File not found: ${topic ? topic + '.md' : 'README.md'} in room '${room}'` }) }],
+                isError: true,
+            };
+        }
+        const content = fs.readFileSync(targetFile, "utf-8");
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        room: room,
+                        topic: topic ?? "README",
+                        project: slug,
+                        salience: meta.salience,
+                        connections: meta.connections,
+                        content,
+                    }),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=palace-read.js.map

package/dist/tools/palace-read.js.map

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

package/dist/tools/palace-search.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tool: palace_search — Search across palace rooms, ranked by salience.
+ */
+import type { ServerType } from "../server.js";
+export declare function register(server: ServerType): void;
+//# sourceMappingURL=palace-search.d.ts.map

package/dist/tools/palace-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palace-search.d.ts","sourceRoot":"","sources":["../../src/tools/palace-search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAa/C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CA+EjD"}