@radix-ai/ai-memory 0.1.0

package/dist/mcp-server/resources.js

@@ -0,0 +1,156 @@
+import { readFile } from "fs/promises";
+import { join, relative, resolve } from "path";
+import { existsSync } from "fs";
+import { ListResourcesRequestSchema, ReadResourceRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+// Returns the last N lines of a file, or all lines if fewer than N
+async function tail(filePath, lines) {
+    try {
+        const content = await readFile(filePath, "utf-8");
+        const all = content.split("\n");
+        return all.slice(-lines).join("\n");
+    }
+    catch {
+        return "";
+    }
+}
+// Read a file safely, returning empty string if not found
+async function safeRead(filePath) {
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+export function registerResources(server, aiDir) {
+    // List available resources
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        const resources = [
+            {
+                uri: "memory://identity",
+                name: "Identity + Project Status",
+                description: "IDENTITY.md and PROJECT_STATUS.md — project constraints and current focus",
+                mimeType: "text/markdown",
+            },
+            {
+                uri: "memory://index",
+                name: "Memory Index",
+                description: "Priority-ranked index of all active memory entries (~500 tokens)",
+                mimeType: "text/markdown",
+            },
+            {
+                uri: "memory://tails",
+                name: "Memory Tails",
+                description: "Recent entries from decisions, debugging, patterns, and thread-archive",
+                mimeType: "text/markdown",
+            },
+        ];
+        // Add harness/active if it exists (Full tier)
+        if (existsSync(join(aiDir, "temp/harness.json"))) {
+            resources.push({
+                uri: "memory://harness/active",
+                name: "Active Harness Rules",
+                description: "Currently active code constraint rules compiled from [P0] entries",
+                mimeType: "application/json",
+            });
+        }
+        // Add evals if report exists
+        if (existsSync(join(aiDir, "temp/eval-report.json"))) {
+            resources.push({
+                uri: "memory://evals",
+                name: "Eval Report",
+                description: "Latest memory health and governance metrics",
+                mimeType: "application/json",
+            });
+        }
+        return { resources };
+    });
+    // Read a resource by URI
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const uri = request.params.uri;
+        if (uri === "memory://identity") {
+            const identity = await safeRead(join(aiDir, "IDENTITY.md"));
+            const projectStatus = await safeRead(join(aiDir, "PROJECT_STATUS.md"));
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: "text/markdown",
+                        text: [identity, projectStatus].filter(Boolean).join("\n\n---\n\n"),
+                    },
+                ],
+            };
+        }
+        if (uri === "memory://index") {
+            const index = await safeRead(join(aiDir, "memory/memory-index.md"));
+            return {
+                contents: [{ uri, mimeType: "text/markdown", text: index || "Memory index not yet generated. Run `/mem-compound` to create it." }],
+            };
+        }
+        if (uri === "memory://tails") {
+            const sections = [];
+            const decisionsTail = await tail(join(aiDir, "memory/decisions.md"), 40);
+            if (decisionsTail)
+                sections.push(`## Recent Decisions\n\n${decisionsTail}`);
+            const debuggingTail = await tail(join(aiDir, "memory/debugging.md"), 30);
+            if (debuggingTail)
+                sections.push(`## Recent Debugging\n\n${debuggingTail}`);
+            const patternsTail = await tail(join(aiDir, "memory/patterns.md"), 20);
+            if (patternsTail)
+                sections.push(`## Recent Patterns\n\n${patternsTail}`);
+            const archiveTail = await tail(join(aiDir, "sessions/archive/thread-archive.md"), 200);
+            if (archiveTail)
+                sections.push(`## Session Archive (recent)\n\n${archiveTail}`);
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: "text/markdown",
+                        text: sections.join("\n\n---\n\n") || "No memory entries yet.",
+                    },
+                ],
+            };
+        }
+        if (uri === "memory://harness/active") {
+            const harness = await safeRead(join(aiDir, "temp/harness.json"));
+            return {
+                contents: [{ uri, mimeType: "application/json", text: harness || "[]" }],
+            };
+        }
+        if (uri === "memory://evals") {
+            const report = await safeRead(join(aiDir, "temp/eval-report.json"));
+            return {
+                contents: [{ uri, mimeType: "application/json", text: report || "{}" }],
+            };
+        }
+        // Dynamic: memory://file/{path}
+        if (uri.startsWith("memory://file/")) {
+            // Decode before path check to prevent %2e%2e bypass
+            let relativePath;
+            try {
+                relativePath = decodeURIComponent(uri.slice("memory://file/".length));
+            }
+            catch {
+                throw new McpError(ErrorCode.InvalidRequest, `Invalid URI encoding: ${uri}`);
+            }
+            // Security: ensure resolved path stays inside aiDir
+            const fullPath = resolve(aiDir, relativePath);
+            const rel = relative(aiDir, fullPath);
+            if (rel.startsWith("..") || rel.startsWith("/") || /\.\.[\\/]/.test(rel)) {
+                throw new McpError(ErrorCode.InvalidRequest, `Path traversal not allowed: ${relativePath}`);
+            }
+            const content = await safeRead(fullPath);
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: "text/markdown",
+                        text: content || `File not found: ${relativePath}`,
+                    },
+                ],
+            };
+        }
+        throw new McpError(ErrorCode.InvalidRequest, `Unknown resource URI: ${uri}`);
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp-server/resources.js.map

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

package/dist/mcp-server/tools.d.ts

@@ -0,0 +1,15 @@
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export interface ValidationResult {
+    violations: Array<{
+        rule_id: string;
+        message: string;
+        severity: string;
+    }>;
+    audit: Array<{
+        rule_id: string;
+        path: string;
+        status: "passed" | "failed" | "skipped";
+    }>;
+}
+export declare function registerTools(server: Server, aiDir: string): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp-server/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp-server/tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA4KxE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC1F;AA4HD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAitBjE"}