moltmind 0.1.0

package/dist/embeddings.js

@@ -0,0 +1,91 @@
+import { env, pipeline } from "@xenova/transformers";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const MODEL_NAME = "Xenova/all-MiniLM-L6-v2";
+const MODEL_DIR = join(homedir(), ".moltmind", "models");
+const LOAD_TIMEOUT_MS = 30_000;
+let extractor = null;
+let modelFailed = false;
+async function loadModel() {
+    if (extractor)
+        return extractor;
+    if (modelFailed)
+        return null;
+    // Configure cache directory before loading
+    env.cacheDir = MODEL_DIR;
+    // Disable browser-specific features
+    env.allowLocalModels = true;
+    env.allowRemoteModels = true;
+    try {
+        const loadPromise = pipeline("feature-extraction", MODEL_NAME, {
+            progress_callback: (progress) => {
+                if (progress.status === "download" && progress.file && progress.progress !== undefined) {
+                    console.error(`MoltMind: downloading ${progress.file} ${Math.round(progress.progress)}%`);
+                }
+            },
+        });
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error("Model loading timed out")), LOAD_TIMEOUT_MS);
+        });
+        extractor = await Promise.race([loadPromise, timeoutPromise]);
+        return extractor;
+    }
+    catch (err) {
+        modelFailed = true;
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`MoltMind: embedding model failed to load — falling back to FTS5-only search. Error: ${msg}`);
+        return null;
+    }
+}
+export async function embed(text) {
+    const model = await loadModel();
+    if (!model)
+        return null;
+    const output = await model(text, { pooling: "mean", normalize: true });
+    return output.data;
+}
+export function cosineSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denom === 0)
+        return 0;
+    return dot / denom;
+}
+export async function semanticSearch(query, memories) {
+    const queryEmbedding = await embed(query);
+    if (!queryEmbedding)
+        return [];
+    const results = memories.map((memory) => {
+        const memoryEmbedding = bufferToEmbedding(memory.embedding);
+        const score = cosineSimilarity(queryEmbedding, memoryEmbedding);
+        return { id: memory.id, score };
+    });
+    results.sort((a, b) => b.score - a.score);
+    return results;
+}
+export function embeddingToBuffer(embedding) {
+    return Buffer.from(embedding.buffer, embedding.byteOffset, embedding.byteLength);
+}
+export function bufferToEmbedding(buffer) {
+    const arrayBuffer = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+    return new Float32Array(arrayBuffer);
+}
+export function isModelReady() {
+    return extractor !== null;
+}
+// Exported for testing — allows resetting internal state
+export function _resetForTesting() {
+    extractor = null;
+    modelFailed = false;
+}
+export function _setModelFailed() {
+    modelFailed = true;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/embeddings.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { closeDb } from "./db.js";
+import { withDiagnostics } from "./diagnostics.js";
+import { initMetrics, recordToolCall } from "./metrics.js";
+import { handleMmStore } from "./tools/mm_store.js";
+import { handleMmRecall } from "./tools/mm_recall.js";
+import { handleMmRead } from "./tools/mm_read.js";
+import { handleMmUpdate } from "./tools/mm_update.js";
+import { handleMmDelete } from "./tools/mm_delete.js";
+import { handleMmStatus } from "./tools/mm_status.js";
+import { handleMmInit } from "./tools/mm_init.js";
+import { handleMmHandoffCreate } from "./tools/mm_handoff_create.js";
+import { handleMmHandoffLoad } from "./tools/mm_handoff_load.js";
+import { handleMmFeedback } from "./tools/mm_feedback.js";
+import { handleMmMetrics } from "./tools/mm_metrics.js";
+const server = new McpServer({
+    name: "moltmind",
+    version: "0.1.0",
+});
+function wrapTool(toolName, handler) {
+    return (args) => withDiagnostics(toolName, async () => {
+        const result = await handler(args);
+        recordToolCall(toolName, result.success !== false);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+        };
+    });
+}
+// --- Tool Registration ---
+server.tool("mm_store", "Store a memory (learning, error fix, decision, plan, or raw note). Use this whenever you learn something worth remembering across sessions.", {
+    title: z.string().max(500).describe("Short title for the memory"),
+    content: z.string().max(51200).describe("Full content of the memory"),
+    type: z.enum(["learning", "error", "decision", "plan", "raw"]).optional().describe("Memory type classification"),
+    tags: z.array(z.string().max(100)).max(20).optional().describe("Tags for categorization"),
+    metadata: z.record(z.string(), z.unknown()).optional().describe("Additional metadata"),
+}, wrapTool("mm_store", (args) => handleMmStore(args)));
+server.tool("mm_recall", "Search your memory using natural language. Finds semantically similar memories even if exact words don't match.", {
+    query: z.string().max(1000).describe("Natural language search query"),
+    limit: z.number().int().min(1).max(500).optional().describe("Max results to return (default 10)"),
+    tier: z.enum(["hot", "warm", "cold"]).optional().describe("Filter by memory tier"),
+    type: z.enum(["learning", "error", "decision", "plan", "raw"]).optional().describe("Filter by memory type"),
+}, wrapTool("mm_recall", (args) => handleMmRecall(args)));
+server.tool("mm_read", "Read a specific memory by its ID. Returns the full memory with all fields.", {
+    id: z.string().describe("The memory ID to read"),
+}, wrapTool("mm_read", (args) => handleMmRead(args)));
+server.tool("mm_update", "Update an existing memory. Only the fields you provide will be changed.", {
+    id: z.string().describe("The memory ID to update"),
+    title: z.string().max(500).optional().describe("New title"),
+    content: z.string().max(51200).optional().describe("New content"),
+    type: z.enum(["learning", "error", "decision", "plan", "raw"]).optional().describe("New type"),
+    tags: z.array(z.string().max(100)).max(20).optional().describe("New tags"),
+    metadata: z.record(z.string(), z.unknown()).optional().describe("New metadata"),
+    tier: z.enum(["hot", "warm", "cold", "archived"]).optional().describe("New tier"),
+}, wrapTool("mm_update", (args) => handleMmUpdate(args)));
+server.tool("mm_delete", "Archive a memory (soft delete). The memory is moved to archived tier and won't appear in recall results, but is not permanently removed.", {
+    id: z.string().describe("The memory ID to archive"),
+}, wrapTool("mm_delete", (args) => handleMmDelete(args)));
+server.tool("mm_status", "Get MoltMind server status: memory stats, health score, embedding model readiness, and uptime.", {}, wrapTool("mm_status", () => handleMmStatus()));
+server.tool("mm_init", "Initialize a project-local memory vault in the current directory. Creates .moltmind/memory.db for project-specific memories.", {}, wrapTool("mm_init", () => handleMmInit()));
+server.tool("mm_handoff_create", "Create a structured handoff document for agent-to-agent context transfer. Captures goal, state, next steps, and constraints.", {
+    goal: z.string().describe("What the next agent should accomplish"),
+    current_state: z.string().describe("Where things stand right now"),
+    next_action: z.string().describe("The immediate next step to take"),
+    constraints: z.array(z.string()).optional().describe("Rules or limitations to respect"),
+    known_unknowns: z.array(z.string()).optional().describe("Things that still need investigation"),
+    artifacts: z.array(z.string()).optional().describe("Files or resources involved"),
+    stop_conditions: z.array(z.string()).optional().describe("When to consider the goal complete"),
+}, wrapTool("mm_handoff_create", (args) => handleMmHandoffCreate(args)));
+server.tool("mm_handoff_load", "Load the most recent handoff to resume context from a previous session or agent.", {}, wrapTool("mm_handoff_load", () => handleMmHandoffLoad()));
+server.tool("mm_feedback", "Report a bug, request a feature, or flag friction with MoltMind. Your feedback directly shapes what gets built next.", {
+    type: z.enum(["bug", "feature_request", "friction"]).describe("Feedback type"),
+    message: z.string().max(2000).describe("Your feedback message"),
+    tool_name: z.string().optional().describe("Which tool the feedback is about"),
+}, wrapTool("mm_feedback", (args) => handleMmFeedback(args)));
+server.tool("mm_metrics", "Get a full adoption and health dashboard: install age, session count, per-tool usage stats, error rates, and feedback summary.", {}, wrapTool("mm_metrics", () => handleMmMetrics()));
+// --- Server lifecycle ---
+function shutdown() {
+    console.error("MoltMind shutting down");
+    closeDb();
+    process.exit(0);
+}
+async function main() {
+    initMetrics();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    console.error("MoltMind MCP server started");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,38 @@
+export declare function initMetrics(): void;
+export declare function recordToolCall(toolName: string, success: boolean): void;
+export interface FullMetrics {
+    adoption: {
+        instance_id: string;
+        install_age_days: number;
+        total_sessions: number;
+        first_seen: string;
+        last_seen: string;
+    };
+    health: {
+        score: number;
+        total_tool_calls: number;
+        total_errors: number;
+        error_rate_percent: number;
+    };
+    tool_usage: Record<string, {
+        calls: number;
+        errors: number;
+        error_rate: number;
+        avg_latency_ms: number;
+    }>;
+    top_errors: Array<{
+        tool_name: string;
+        error_count: number;
+    }>;
+    feedback_summary: {
+        total: number;
+        recent: Array<{
+            type: string;
+            message: string;
+            tool_name: string | null;
+            created_at: string;
+        }>;
+    };
+    uptime_seconds: number;
+}
+export declare function getFullMetrics(): FullMetrics;

package/dist/metrics.js

@@ -0,0 +1,105 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import crypto from "node:crypto";
+import { getMetric, setMetric, getDiagnosticsSummary } from "./db.js";
+import { getHealthScore, getRecentFeedback } from "./diagnostics.js";
+const MOLTMIND_DIR = join(homedir(), ".moltmind");
+const INSTANCE_ID_PATH = join(MOLTMIND_DIR, "instance_id");
+let instanceId = null;
+const startTime = Date.now();
+function getOrCreateInstanceId() {
+    if (instanceId)
+        return instanceId;
+    mkdirSync(MOLTMIND_DIR, { recursive: true });
+    if (existsSync(INSTANCE_ID_PATH)) {
+        instanceId = readFileSync(INSTANCE_ID_PATH, "utf-8").trim();
+    }
+    else {
+        instanceId = crypto.randomUUID();
+        writeFileSync(INSTANCE_ID_PATH, instanceId, "utf-8");
+    }
+    return instanceId;
+}
+export function initMetrics() {
+    const id = getOrCreateInstanceId();
+    // Set first_seen if not already set
+    if (!getMetric("first_seen")) {
+        setMetric("first_seen", new Date().toISOString());
+    }
+    // Increment total_sessions
+    const sessions = parseInt(getMetric("total_sessions") ?? "0", 10);
+    setMetric("total_sessions", String(sessions + 1));
+    // Update last_seen
+    setMetric("last_seen", new Date().toISOString());
+    console.error(`MoltMind: instance ${id.slice(0, 8)}... session #${sessions + 1}`);
+}
+export function recordToolCall(toolName, success) {
+    // Increment total_tool_calls
+    const totalCalls = parseInt(getMetric("total_tool_calls") ?? "0", 10);
+    setMetric("total_tool_calls", String(totalCalls + 1));
+    // Update tool_calls_by_name
+    const byName = JSON.parse(getMetric("tool_calls_by_name") ?? "{}");
+    byName[toolName] = (byName[toolName] ?? 0) + 1;
+    setMetric("tool_calls_by_name", JSON.stringify(byName));
+    // Update errors_by_tool if failed
+    if (!success) {
+        const errorsByTool = JSON.parse(getMetric("errors_by_tool") ?? "{}");
+        errorsByTool[toolName] = (errorsByTool[toolName] ?? 0) + 1;
+        setMetric("errors_by_tool", JSON.stringify(errorsByTool));
+    }
+}
+export function getFullMetrics() {
+    const id = getOrCreateInstanceId();
+    const firstSeen = getMetric("first_seen") ?? new Date().toISOString();
+    const lastSeen = getMetric("last_seen") ?? new Date().toISOString();
+    const totalSessions = parseInt(getMetric("total_sessions") ?? "0", 10);
+    const totalToolCalls = parseInt(getMetric("total_tool_calls") ?? "0", 10);
+    const errorsByTool = JSON.parse(getMetric("errors_by_tool") ?? "{}");
+    const totalErrors = Object.values(errorsByTool).reduce((sum, n) => sum + n, 0);
+    const healthScore = getHealthScore();
+    // Build tool_usage from diagnostics summary
+    const diagSummary = getDiagnosticsSummary();
+    const toolUsage = {};
+    for (const row of diagSummary) {
+        toolUsage[row.tool_name] = {
+            calls: row.calls,
+            errors: row.errors,
+            error_rate: row.calls > 0 ? row.errors / row.calls : 0,
+            avg_latency_ms: Math.round(row.avg_latency_ms * 100) / 100,
+        };
+    }
+    // Top errors: tools sorted by error count descending
+    const topErrors = Object.entries(errorsByTool)
+        .map(([tool_name, error_count]) => ({ tool_name, error_count }))
+        .sort((a, b) => b.error_count - a.error_count)
+        .slice(0, 5);
+    // Feedback
+    const recentFeedback = getRecentFeedback(5);
+    const installAgeDays = Math.floor((Date.now() - new Date(firstSeen).getTime()) / (1000 * 60 * 60 * 24));
+    return {
+        adoption: {
+            instance_id: id.slice(0, 8),
+            install_age_days: installAgeDays,
+            total_sessions: totalSessions,
+            first_seen: firstSeen,
+            last_seen: lastSeen,
+        },
+        health: {
+            score: healthScore,
+            total_tool_calls: totalToolCalls,
+            total_errors: totalErrors,
+            error_rate_percent: totalToolCalls > 0
+                ? Math.round((totalErrors / totalToolCalls) * 10000) / 100
+                : 0,
+        },
+        tool_usage: toolUsage,
+        top_errors: topErrors,
+        feedback_summary: {
+            total: recentFeedback.length,
+            recent: recentFeedback,
+        },
+        uptime_seconds: Math.floor((Date.now() - startTime) / 1000),
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/tools/mm_delete.d.ts

@@ -0,0 +1,6 @@
+export declare function handleMmDelete(args: {
+    id: string;
+}): Promise<{
+    success: boolean;
+    message: string;
+}>;

package/dist/tools/mm_delete.js

@@ -0,0 +1,9 @@
+import { deleteMemory } from "../db.js";
+export async function handleMmDelete(args) {
+    const deleted = deleteMemory(args.id);
+    if (!deleted) {
+        return { success: false, message: "Memory not found" };
+    }
+    return { success: true, message: "Memory archived" };
+}
+//# sourceMappingURL=mm_delete.js.map

package/dist/tools/mm_delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mm_delete.js","sourceRoot":"","sources":["../../src/tools/mm_delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAEpC;IACC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AACvD,CAAC"}

package/dist/tools/mm_feedback.d.ts

@@ -0,0 +1,8 @@
+export declare function handleMmFeedback(args: {
+    type: "bug" | "feature_request" | "friction";
+    message: string;
+    tool_name?: string;
+}): Promise<{
+    success: boolean;
+    message: string;
+}>;

package/dist/tools/mm_feedback.js

@@ -0,0 +1,6 @@
+import { submitFeedback } from "../diagnostics.js";
+export async function handleMmFeedback(args) {
+    submitFeedback(args.type, args.message, args.tool_name ?? null);
+    return { success: true, message: "Feedback recorded. Thank you." };
+}
+//# sourceMappingURL=mm_feedback.js.map

package/dist/tools/mm_feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mm_feedback.js","sourceRoot":"","sources":["../../src/tools/mm_feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAItC;IACC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;IAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;AACrE,CAAC"}

package/dist/tools/mm_handoff_create.d.ts

@@ -0,0 +1,9 @@
+export declare function handleMmHandoffCreate(args: {
+    goal: string;
+    current_state: string;
+    next_action: string;
+    constraints?: string[];
+    known_unknowns?: string[];
+    artifacts?: string[];
+    stop_conditions?: string[];
+}): Promise<Record<string, unknown>>;

package/dist/tools/mm_handoff_create.js

@@ -0,0 +1,16 @@
+import crypto from "node:crypto";
+import { insertHandoff } from "../db.js";
+export async function handleMmHandoffCreate(args) {
+    const handoff = insertHandoff({
+        goal: args.goal,
+        current_state: args.current_state,
+        next_action: args.next_action,
+        constraints: args.constraints ?? [],
+        known_unknowns: args.known_unknowns ?? [],
+        artifacts: args.artifacts ?? [],
+        stop_conditions: args.stop_conditions ?? [],
+        session_id: crypto.randomUUID(),
+    });
+    return { success: true, handoff };
+}
+//# sourceMappingURL=mm_handoff_create.js.map

package/dist/tools/mm_handoff_create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mm_handoff_create.js","sourceRoot":"","sources":["../../src/tools/mm_handoff_create.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAQ3C;IACC,MAAM,OAAO,GAAG,aAAa,CAAC;QAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QACnC,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,EAAE;QACzC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;QAC/B,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,EAAE;QAC3C,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;KAChC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/tools/mm_handoff_load.d.ts

@@ -0,0 +1 @@
+export declare function handleMmHandoffLoad(): Promise<Record<string, unknown>>;

package/dist/tools/mm_handoff_load.js

@@ -0,0 +1,9 @@
+import { getLatestHandoff } from "../db.js";
+export async function handleMmHandoffLoad() {
+    const handoff = getLatestHandoff();
+    if (!handoff) {
+        return { success: false, message: "No handoff found" };
+    }
+    return { success: true, handoff };
+}
+//# sourceMappingURL=mm_handoff_load.js.map

package/dist/tools/mm_handoff_load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mm_handoff_load.js","sourceRoot":"","sources":["../../src/tools/mm_handoff_load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/tools/mm_init.d.ts

@@ -0,0 +1,5 @@
+export declare function handleMmInit(): Promise<{
+    success: boolean;
+    path: string;
+    message: string;
+}>;

package/dist/tools/mm_init.js

@@ -0,0 +1,6 @@
+import { initProjectVault } from "../db.js";
+export async function handleMmInit() {
+    const path = initProjectVault();
+    return { success: true, path, message: "Project vault initialized at .moltmind/memory.db" };
+}
+//# sourceMappingURL=mm_init.js.map

package/dist/tools/mm_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mm_init.js","sourceRoot":"","sources":["../../src/tools/mm_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,kDAAkD,EAAE,CAAC;AAC9F,CAAC"}

package/dist/tools/mm_metrics.d.ts

@@ -0,0 +1 @@
+export declare function handleMmMetrics(): Promise<Record<string, unknown>>;

package/dist/tools/mm_metrics.js

@@ -0,0 +1,6 @@
+import { getFullMetrics } from "../metrics.js";
+export async function handleMmMetrics() {
+    const metrics = getFullMetrics();
+    return { success: true, ...metrics };
+}
+//# sourceMappingURL=mm_metrics.js.map

package/dist/tools/mm_metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mm_metrics.js","sourceRoot":"","sources":["../../src/tools/mm_metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;AACvC,CAAC"}

package/dist/tools/mm_read.d.ts

@@ -0,0 +1,3 @@
+export declare function handleMmRead(args: {
+    id: string;
+}): Promise<Record<string, unknown>>;

package/dist/tools/mm_read.js

@@ -0,0 +1,24 @@
+import { getMemory } from "../db.js";
+export async function handleMmRead(args) {
+    const memory = getMemory(args.id);
+    if (!memory) {
+        return { success: false, message: "Memory not found" };
+    }
+    return {
+        success: true,
+        memory: {
+            id: memory.id,
+            type: memory.type,
+            title: memory.title,
+            content: memory.content,
+            tags: memory.tags,
+            metadata: memory.metadata,
+            tier: memory.tier,
+            created_at: memory.created_at,
+            updated_at: memory.updated_at,
+            accessed_at: memory.accessed_at,
+            access_count: memory.access_count,
+        },
+    };
+}
+//# sourceMappingURL=mm_read.js.map

package/dist/tools/mm_read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mm_read.js","sourceRoot":"","sources":["../../src/tools/mm_read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAElC;IACC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IACzD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE;YACN,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/mm_recall.d.ts

@@ -0,0 +1,11 @@
+import type { MemoryType, MemoryTier } from "../types.js";
+export declare function handleMmRecall(args: {
+    query: string;
+    limit?: number;
+    tier?: MemoryTier;
+    type?: MemoryType;
+}): Promise<{
+    success: boolean;
+    results: Array<Record<string, unknown>>;
+    count: number;
+}>;

package/dist/tools/mm_recall.js

@@ -0,0 +1,71 @@
+import { searchMemoriesFTS, getAllMemories } from "../db.js";
+import { embed, cosineSimilarity, bufferToEmbedding, isModelReady } from "../embeddings.js";
+export async function handleMmRecall(args) {
+    const limit = args.limit ?? 10;
+    const fetchLimit = limit * 2;
+    // FTS5 keyword search
+    const ftsResults = searchMemoriesFTS(args.query, fetchLimit);
+    // Build FTS score map (rank by position, normalized 0-1)
+    const ftsScoreMap = new Map();
+    ftsResults.forEach((mem, i) => {
+        ftsScoreMap.set(mem.id, 1 - i / Math.max(ftsResults.length, 1));
+    });
+    // Semantic search (if model available)
+    const semanticScoreMap = new Map();
+    const queryEmbedding = await embed(args.query);
+    if (queryEmbedding) {
+        // Get all non-archived memories with embeddings
+        const allMemories = getAllMemories(args.tier, 1000);
+        for (const mem of allMemories) {
+            if (mem.embedding) {
+                const memEmbedding = bufferToEmbedding(mem.embedding);
+                const score = cosineSimilarity(queryEmbedding, memEmbedding);
+                semanticScoreMap.set(mem.id, score);
+            }
+        }
+    }
+    // Merge: collect all unique IDs
+    const allIds = new Set([...ftsScoreMap.keys(), ...semanticScoreMap.keys()]);
+    const scored = [];
+    for (const id of allIds) {
+        const ftsScore = ftsScoreMap.get(id) ?? 0;
+        const semScore = semanticScoreMap.get(id) ?? 0;
+        // Hybrid weighting: semantic 0.7, keyword 0.3
+        const combinedScore = isModelReady()
+            ? semScore * 0.7 + ftsScore * 0.3
+            : ftsScore; // FTS-only fallback
+        scored.push({ id, score: combinedScore });
+    }
+    scored.sort((a, b) => b.score - a.score);
+    const topIds = scored.slice(0, limit);
+    // Build result objects from FTS results + all memories
+    const allMemMap = new Map();
+    for (const mem of ftsResults)
+        allMemMap.set(mem.id, mem);
+    if (queryEmbedding) {
+        const allMems = getAllMemories(args.tier, 1000);
+        for (const mem of allMems)
+            allMemMap.set(mem.id, mem);
+    }
+    const results = topIds
+        .map(({ id, score }) => {
+        const mem = allMemMap.get(id);
+        if (!mem)
+            return null;
+        // Filter by type if specified
+        if (args.type && mem.type !== args.type)
+            return null;
+        return {
+            id: mem.id,
+            title: mem.title,
+            content: mem.content,
+            type: mem.type,
+            score: Math.round(score * 1000) / 1000,
+            tags: mem.tags,
+            created_at: mem.created_at,
+        };
+    })
+        .filter((r) => r !== null);
+    return { success: true, results, count: results.length };
+}
+//# sourceMappingURL=mm_recall.js.map

package/dist/tools/mm_recall.js.map

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

package/dist/tools/mm_status.d.ts

@@ -0,0 +1 @@
+export declare function handleMmStatus(): Promise<Record<string, unknown>>;