exovault-mcp-server 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search.d.ts","sourceRoot":"","sources":["../../src/tools/semantic-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO7C;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,EACb,IAAI,SAAK,EACT,SAAS,SAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAyFjB"}

package/dist/tools/semantic-search.js

@@ -0,0 +1,85 @@
+import { matchNoteEmbeddings, getNotesByIds } from "../db.js";
+import { generateQueryEmbedding } from "../openai.js";
+import { decrypt } from "../crypto.js";
+import { stripHtml } from "../strip-html.js";
+import { logMcpUsageEvent } from "../usage.js";
+/**
+ * Semantic search: generates an embedding for the query, finds similar note
+ * chunks via pgvector, deduplicates to note level (keeping best similarity),
+ * and returns previews with similarity scores.
+ */
+export async function semanticSearch(ctx, query, topK = 10, threshold = 0.5) {
+    if (!ctx.openaiApiKey) {
+        return JSON.stringify({
+            error: "No OpenAI API key configured. Run 'npx exovault-mcp setup' to add one, or add \"openaiApiKey\" to ~/.exovault-mcp/config.json.",
+        });
+    }
+    // 1. Generate query embedding
+    const embedding = await generateQueryEmbedding(query, ctx.openaiApiKey);
+    // 2. Find matching chunks via Supabase RPC
+    const matches = await matchNoteEmbeddings(ctx.supabase, embedding, ctx.userId, threshold, topK * 3 // fetch extra chunks since multiple chunks can belong to one note
+    );
+    if (matches.length === 0) {
+        const payload = JSON.stringify([]);
+        await logMcpUsageEvent({
+            supabase: ctx.supabase,
+            userId: ctx.userId,
+            operationType: "mcp_semantic_search",
+            modelId: "text-embedding-3-small",
+            inputText: query,
+            outputText: payload,
+            embeddingTokens: Math.ceil(query.length / 4),
+        });
+        return payload;
+    }
+    // 3. Deduplicate chunks to note level — keep highest similarity per note
+    const bestByNote = new Map();
+    for (const m of matches) {
+        const existing = bestByNote.get(m.note_id);
+        if (existing === undefined || m.similarity > existing) {
+            bestByNote.set(m.note_id, m.similarity);
+        }
+    }
+    // 4. Fetch the actual notes
+    const noteIds = Array.from(bestByNote.keys());
+    const notes = await getNotesByIds(ctx.supabase, ctx.userId, noteIds);
+    // 5. Decrypt and build results
+    const results = await Promise.all(notes.map(async (note) => {
+        const [title, content] = await Promise.all([
+            decrypt(note.encrypted_title, note.title_iv, ctx.masterKey),
+            decrypt(note.encrypted_content, note.content_iv, ctx.masterKey),
+        ]);
+        let tags = [];
+        if (note.encrypted_tags && note.tags_iv) {
+            try {
+                const tagsJson = await decrypt(note.encrypted_tags, note.tags_iv, ctx.masterKey);
+                tags = JSON.parse(tagsJson);
+            }
+            catch {
+                // ignore
+            }
+        }
+        return {
+            id: note.id,
+            title,
+            tags,
+            preview: stripHtml(content).slice(0, 300),
+            similarity: bestByNote.get(note.id) ?? 0,
+            vaultId: note.vault_id,
+            updatedAt: note.updated_at,
+        };
+    }));
+    // Sort by similarity descending and limit to topK
+    results.sort((a, b) => b.similarity - a.similarity);
+    const payload = JSON.stringify(results.slice(0, topK), null, 2);
+    await logMcpUsageEvent({
+        supabase: ctx.supabase,
+        userId: ctx.userId,
+        operationType: "mcp_semantic_search",
+        modelId: "text-embedding-3-small",
+        inputText: query,
+        outputText: payload,
+        embeddingTokens: Math.ceil(query.length / 4),
+    });
+    return payload;
+}

package/dist/tools/semantic-search.js.map

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

package/dist/tools/session-start.d.ts

@@ -0,0 +1,24 @@
+import type { McpContext } from "../auth.js";
+/**
+ * Session start tool: returns recent context so an agent can resume
+ * where a previous session left off.
+ *
+ * Composes existing tools to return:
+ * 1. Recent episodic memories (session summaries)
+ * 2. High-importance facts and constraints
+ * 3. Active tasks
+ * 4. Available vaults
+ * 5. Recently active agents
+ * 6. Optional query-scoped context
+ */
+export declare function sessionStart(ctx: McpContext, input: {
+    vaultId?: string;
+    query?: string;
+    summaryOnly?: boolean;
+    mode?: string;
+    maxEpisodic?: number;
+    maxFacts?: number;
+    maxTasks?: number;
+    maxConstraints?: number;
+    agentId?: string;
+}): Promise<string>;

package/dist/tools/session-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/tools/session-start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU7C;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE;IACL,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,MAAM,CAAC,CA4SjB"}

package/dist/tools/session-start.js

@@ -0,0 +1,256 @@
+import { getMemories, getVaults, countNotesByVault, getActiveAgents, getMemoryHealthStats, getPendingMessages, bulkUpdateMessageStatus } from "../db.js";
+import { decrypt } from "../crypto.js";
+import { searchMemories } from "./search-memories.js";
+import { logMcpUsageEvent } from "../usage.js";
+import { resolveContextLimits } from "./context-profiles.js";
+import { compactAndDedup } from "../session-dedup.js";
+import { runCleanup } from "./cleanup-memories.js";
+import { flagStaleTasks } from "./stale-tasks.js";
+/**
+ * Session start tool: returns recent context so an agent can resume
+ * where a previous session left off.
+ *
+ * Composes existing tools to return:
+ * 1. Recent episodic memories (session summaries)
+ * 2. High-importance facts and constraints
+ * 3. Active tasks
+ * 4. Available vaults
+ * 5. Recently active agents
+ * 6. Optional query-scoped context
+ */
+export async function sessionStart(ctx, input) {
+    const limits = resolveContextLimits({
+        mode: input.mode,
+        maxEpisodic: input.maxEpisodic,
+        maxFacts: input.maxFacts,
+        maxTasks: input.maxTasks,
+        maxConstraints: input.maxConstraints,
+    });
+    // ── None mode: skip all memory queries, return only vault metadata + agents ──
+    const allZero = limits.maxEpisodic === 0 &&
+        limits.maxFacts === 0 &&
+        limits.maxTasks === 0 &&
+        limits.maxConstraints === 0;
+    if (allZero) {
+        const [vaults, noteCounts, agents] = await Promise.all([
+            getVaults(ctx.supabase, ctx.userId),
+            countNotesByVault(ctx.supabase, ctx.userId),
+            getActiveAgents(ctx.supabase, ctx.userId, 7, 5),
+        ]);
+        const vaultList = await Promise.all(vaults.map(async (v) => {
+            const name = await decrypt(v.encrypted_name, v.name_iv, ctx.masterKey);
+            return { id: v.id, name, noteCount: noteCounts[v.id] ?? 0 };
+        }));
+        const payload = JSON.stringify({
+            sessionContext: {
+                recentSessions: [],
+                importantFacts: [],
+                activeTasks: [],
+                constraints: [],
+            },
+            vaults: vaultList,
+            recentAgents: agents,
+        }, null, 2);
+        await logMcpUsageEvent({
+            supabase: ctx.supabase,
+            userId: ctx.userId,
+            operationType: "mcp_session_start",
+            vaultId: input.vaultId,
+            outputText: payload,
+        });
+        return payload;
+    }
+    // Run independent fetches in parallel with DB-level type filtering
+    const [episodicRows, factRows, taskRows, constraintRows, vaults, noteCounts, agents, healthStats, cleanupResult, pendingMsgRows,] = await Promise.all([
+        // Recent episodic memories (session summaries)
+        getMemories(ctx.supabase, ctx.userId, {
+            vaultId: input.vaultId,
+            memoryType: "episodic",
+            limit: limits.maxEpisodic,
+        }),
+        // High-importance facts, ordered by importance
+        getMemories(ctx.supabase, ctx.userId, {
+            vaultId: input.vaultId,
+            memoryType: "fact",
+            minImportance: 3,
+            orderBy: "importance",
+            limit: limits.maxFacts,
+        }),
+        // Active tasks
+        getMemories(ctx.supabase, ctx.userId, {
+            vaultId: input.vaultId,
+            memoryType: "task",
+            limit: limits.maxTasks,
+        }),
+        // Constraints — importance >= 3 (consistent with facts filter)
+        getMemories(ctx.supabase, ctx.userId, {
+            vaultId: input.vaultId,
+            memoryType: "constraint",
+            minImportance: 3,
+            orderBy: "importance",
+            limit: limits.maxConstraints,
+        }),
+        // Available vaults
+        getVaults(ctx.supabase, ctx.userId),
+        // Note counts per vault
+        countNotesByVault(ctx.supabase, ctx.userId),
+        // Recently active agents (last 7 days, cap to 5)
+        getActiveAgents(ctx.supabase, ctx.userId, 7, 5),
+        // Memory health stats (embedding indexing status)
+        getMemoryHealthStats(ctx.supabase, ctx.userId, input.vaultId),
+        // Auto-cleanup: safe rules only (failed indexing + superseded), non-blocking
+        runCleanup(ctx, input.vaultId, { safeOnly: true }).catch((e) => {
+            process.stderr.write(`[session-start] auto-cleanup failed: ${e.message}\n`);
+            return null;
+        }),
+        // Pending agent messages (budget: 5 on session_start)
+        input.agentId
+            ? getPendingMessages(ctx.supabase, ctx.userId, input.agentId, 5).catch(() => [])
+            : Promise.resolve([]),
+    ]);
+    // Decrypt all memory rows in parallel
+    // Default to summaryOnly=true to reduce token usage (~40-50% reduction)
+    const useSummaryOnly = input.summaryOnly !== false;
+    const SUMMARY_MAX_CHARS = 120;
+    async function decryptMemory(m) {
+        let summary = null;
+        if (m.encrypted_summary && m.summary_iv) {
+            summary = await decrypt(m.encrypted_summary, m.summary_iv, ctx.masterKey).catch(() => null);
+        }
+        // In summaryOnly mode: clipped summary + ID. Agent calls read_memories for full content.
+        if (useSummaryOnly) {
+            let label = summary;
+            if (!label) {
+                // Fallback: decrypt and clip content
+                label = await decrypt(m.encrypted_content, m.content_iv, ctx.masterKey).catch(() => "");
+            }
+            // Always clip — both summary and content can be long
+            if (label && label.length > SUMMARY_MAX_CHARS) {
+                label = label.slice(0, SUMMARY_MAX_CHARS) + "...";
+            }
+            return {
+                id: m.id,
+                memoryType: m.memory_type,
+                summary: label,
+                importance: m.importance,
+            };
+        }
+        const content = await decrypt(m.encrypted_content, m.content_iv, ctx.masterKey);
+        return {
+            id: m.id,
+            memoryType: m.memory_type,
+            content,
+            summary,
+            importance: m.importance,
+            confidence: m.confidence,
+            vaultId: m.vault_id,
+            agentId: m.agent_id,
+            entities: m.entities,
+            updatedAt: m.updated_at,
+        };
+    }
+    const [episodic, facts, tasks, constraints] = await Promise.all([
+        Promise.all(episodicRows.map(decryptMemory)),
+        Promise.all(factRows.map(decryptMemory)),
+        Promise.all(taskRows.map(decryptMemory)),
+        Promise.all(constraintRows.map(decryptMemory)),
+    ]);
+    // Decrypt vault names
+    const vaultList = await Promise.all(vaults.map(async (v) => {
+        const name = await decrypt(v.encrypted_name, v.name_iv, ctx.masterKey);
+        return {
+            id: v.id,
+            name,
+            noteCount: noteCounts[v.id] ?? 0,
+        };
+    }));
+    // Optional: query-scoped context via semantic search
+    let queryContext = null;
+    if (input.query) {
+        const searchResult = await searchMemories(ctx, {
+            query: input.query,
+            vaultId: input.vaultId,
+            topK: 5,
+        });
+        queryContext = JSON.parse(searchResult);
+    }
+    // Deduplicate and compact memories before returning
+    const compactedTasks = compactAndDedup(tasks, useSummaryOnly);
+    // Flag stale tasks and enrich with metadata fields (doneWhen, planGroupId, completionSource)
+    const taskMetaMap = new Map(taskRows.map((r) => {
+        const meta = r.metadata ?? {};
+        return [r.id, meta];
+    }));
+    // Enrich compacted tasks with metadata fields relevant to task lifecycle
+    const enrichedTasks = compactedTasks.map((t) => {
+        const task = t;
+        const meta = taskMetaMap.get(task.id) ?? {};
+        return {
+            ...task,
+            ...(meta.doneWhen ? { doneWhen: meta.doneWhen } : {}),
+            ...(meta.planGroupId ? { planGroupId: meta.planGroupId } : {}),
+            ...(meta.completionSource ? { completionSource: meta.completionSource } : {}),
+        };
+    });
+    const tasksWithStaleness = flagStaleTasks(enrichedTasks, {
+        getStatus: (t) => {
+            const meta = taskMetaMap.get(t.id);
+            return meta?.taskStatus;
+        },
+    });
+    const result = {
+        sessionContext: {
+            recentSessions: compactAndDedup(episodic, useSummaryOnly),
+            importantFacts: compactAndDedup(facts, useSummaryOnly),
+            activeTasks: tasksWithStaleness,
+            constraints: compactAndDedup(constraints, useSummaryOnly),
+        },
+        memoryHealth: healthStats,
+        vaults: vaultList,
+        recentAgents: agents,
+    };
+    if (queryContext) {
+        result.queryResults = queryContext;
+    }
+    // Include auto-cleanup results when items were archived
+    if (cleanupResult && cleanupResult.archivedCount > 0) {
+        result.autoCleanup = {
+            archivedCount: cleanupResult.archivedCount,
+            reasons: cleanupResult.candidates.map((c) => c.reason),
+        };
+    }
+    // Decrypt and attach pending messages
+    if (pendingMsgRows.length > 0) {
+        try {
+            const pendingMessages = await Promise.all(pendingMsgRows.map(async (m) => {
+                const content = await decrypt(m.encrypted_content, m.content_iv, ctx.masterKey);
+                return {
+                    id: m.id,
+                    senderId: m.sender_id,
+                    senderType: m.sender_type,
+                    category: m.category,
+                    priority: m.priority,
+                    subject: m.subject,
+                    content,
+                    createdAt: m.created_at,
+                };
+            }));
+            result.pendingMessages = pendingMessages;
+            // Mark as delivered (best-effort)
+            await bulkUpdateMessageStatus(ctx.supabase, pendingMsgRows.map((m) => m.id), ctx.userId, "delivered", { delivered_at: new Date().toISOString() }).catch(() => { });
+        }
+        catch {
+            // Best-effort — never block session_start
+        }
+    }
+    const payload = JSON.stringify(result);
+    await logMcpUsageEvent({
+        supabase: ctx.supabase,
+        userId: ctx.userId,
+        operationType: "mcp_session_start",
+        vaultId: input.vaultId,
+        inputText: input.query,
+        outputText: payload,
+    });
+    return payload;
+}

package/dist/tools/session-start.js.map

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

package/dist/tools/stale-tasks.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Stale task detection — pure function that annotates tasks with staleness warnings.
+ *
+ * When a session crashes or an agent disconnects, tasks may remain as `in_progress`
+ * indefinitely. This function flags those tasks so the next session can address them.
+ */
+export declare const DEFAULT_STALE_HOURS = 48;
+export interface FlagStaleTasksOptions<T> {
+    /** Hours after which an in_progress task is considered stale. Default: 48. */
+    staleAfterHours?: number;
+    /** Extract the task status from a task object. Default: checks metadata.taskStatus. */
+    getStatus?: (task: T) => string | undefined;
+    /** Current time for testing. Default: new Date(). */
+    now?: Date;
+}
+/**
+ * Pure function: annotates tasks that have been `in_progress` longer than the threshold.
+ * Does NOT mutate input — returns a new array with `staleWarning` added where applicable.
+ */
+export declare function flagStaleTasks<T extends Record<string, unknown>>(tasks: T[], options?: FlagStaleTasksOptions<T>): (T & {
+    staleWarning?: string;
+})[];

package/dist/tools/stale-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/stale-tasks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IAC5C,qDAAqD;IACrD,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACjC,CAAC,CAAC,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CAgCnC"}

package/dist/tools/stale-tasks.js

@@ -0,0 +1,39 @@
+/**
+ * Stale task detection — pure function that annotates tasks with staleness warnings.
+ *
+ * When a session crashes or an agent disconnects, tasks may remain as `in_progress`
+ * indefinitely. This function flags those tasks so the next session can address them.
+ */
+export const DEFAULT_STALE_HOURS = 48;
+/**
+ * Pure function: annotates tasks that have been `in_progress` longer than the threshold.
+ * Does NOT mutate input — returns a new array with `staleWarning` added where applicable.
+ */
+export function flagStaleTasks(tasks, options) {
+    const staleAfterHours = options?.staleAfterHours ?? DEFAULT_STALE_HOURS;
+    const staleAfterMs = staleAfterHours * 60 * 60 * 1000;
+    const now = options?.now ?? new Date();
+    const getStatus = options?.getStatus ??
+        ((task) => {
+            const meta = task.metadata;
+            return meta?.taskStatus ?? undefined;
+        });
+    return tasks.map((task) => {
+        const status = getStatus(task);
+        if (status !== "in_progress")
+            return { ...task };
+        const updatedAt = task.updatedAt;
+        if (!updatedAt)
+            return { ...task };
+        const updatedTime = new Date(updatedAt).getTime();
+        const ageMs = now.getTime() - updatedTime;
+        if (ageMs <= staleAfterMs)
+            return { ...task };
+        const ageHours = Math.floor(ageMs / (1000 * 60 * 60));
+        return {
+            ...task,
+            staleWarning: `This task has been in_progress for ${ageHours}h without updates. ` +
+                `It may have been abandoned by a previous session. Consider updating its status.`,
+        };
+    });
+}

package/dist/tools/stale-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-tasks.js","sourceRoot":"","sources":["../../src/tools/stale-tasks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAWtC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAU,EACV,OAAkC;IAElC,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe,IAAI,mBAAmB,CAAC;IACxE,MAAM,YAAY,GAAG,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACtD,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IAEvC,MAAM,SAAS,GACb,OAAO,EAAE,SAAS;QAClB,CAAC,CAAC,IAAO,EAAE,EAAE;YACX,MAAM,IAAI,GAAG,IAAI,CAAC,QAA+C,CAAC;YAClE,OAAQ,IAAI,EAAE,UAAqB,IAAI,SAAS,CAAC;QACnD,CAAC,CAAC,CAAC;IAEL,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,MAAM,KAAK,aAAa;YAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;QAEjD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAsC,CAAC;QAC9D,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;QAEnC,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC;QAE1C,IAAI,KAAK,IAAI,YAAY;YAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;QAE9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACtD,OAAO;YACL,GAAG,IAAI;YACP,YAAY,EACV,sCAAsC,QAAQ,qBAAqB;gBACnE,iFAAiF;SACpF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/temporal-decay.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Temporal decay for memory search results (MCP server copy).
+ *
+ * Keep in sync with src/lib/search/temporal-decay.ts in the Next.js app.
+ *
+ * Formula: decayedScore = rrfScore × e^(-λ × ageInDays)
+ * where λ = ln(2) / halfLifeDays
+ */
+export interface ScoredCandidate {
+    id: string;
+    score: number;
+    updatedAt: Date;
+    importance: number;
+}
+export interface DecayedCandidate {
+    id: string;
+    score: number;
+}
+export declare function computeDecayMultiplier(ageInDays: number, halfLifeDays: number): number;
+export declare function applyTemporalDecay(score: number, updatedAt: Date, importance: number, halfLifeDays: number, now?: Date): number;
+export declare function applyTemporalDecayBatch(candidates: ScoredCandidate[], halfLifeDays: number, now?: Date): DecayedCandidate[];

package/dist/tools/temporal-decay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-decay.d.ts","sourceRoot":"","sources":["../../src/tools/temporal-decay.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAItF;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,IAAI,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,IAAiB,GACrB,MAAM,CAKR;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,eAAe,EAAE,EAC7B,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,IAAiB,GACrB,gBAAgB,EAAE,CASpB"}

package/dist/tools/temporal-decay.js

@@ -0,0 +1,32 @@
+/**
+ * Temporal decay for memory search results (MCP server copy).
+ *
+ * Keep in sync with src/lib/search/temporal-decay.ts in the Next.js app.
+ *
+ * Formula: decayedScore = rrfScore × e^(-λ × ageInDays)
+ * where λ = ln(2) / halfLifeDays
+ */
+const EVERGREEN_MIN_IMPORTANCE = 4;
+export function computeDecayMultiplier(ageInDays, halfLifeDays) {
+    if (ageInDays <= 0)
+        return 1.0;
+    const lambda = Math.LN2 / halfLifeDays;
+    return Math.exp(-lambda * ageInDays);
+}
+export function applyTemporalDecay(score, updatedAt, importance, halfLifeDays, now = new Date()) {
+    if (importance >= EVERGREEN_MIN_IMPORTANCE)
+        return score;
+    const ageMs = now.getTime() - updatedAt.getTime();
+    const ageInDays = Math.max(0, ageMs / (1000 * 60 * 60 * 24));
+    return score * computeDecayMultiplier(ageInDays, halfLifeDays);
+}
+export function applyTemporalDecayBatch(candidates, halfLifeDays, now = new Date()) {
+    if (candidates.length === 0)
+        return [];
+    return candidates
+        .map((c) => ({
+        id: c.id,
+        score: applyTemporalDecay(c.score, c.updatedAt, c.importance, halfLifeDays, now),
+    }))
+        .sort((a, b) => b.score - a.score);
+}

package/dist/tools/temporal-decay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-decay.js","sourceRoot":"","sources":["../../src/tools/temporal-decay.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAcnC,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,YAAoB;IAC5E,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,SAAe,EACf,UAAkB,EAClB,YAAoB,EACpB,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,UAAU,IAAI,wBAAwB;QAAE,OAAO,KAAK,CAAC;IACzD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC7D,OAAO,KAAK,GAAG,sBAAsB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,UAA6B,EAC7B,YAAoB,EACpB,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,OAAO,UAAU;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,CAAC;KACjF,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/tools/update-memory.d.ts

@@ -0,0 +1,19 @@
+import type { McpContext } from "../auth.js";
+interface MemoryRelation {
+    memoryId: string;
+    relationType: "derived_from" | "contradicts" | "refines" | "part_of" | "supersedes";
+}
+export declare function updateMemoryTool(ctx: McpContext, input: {
+    memoryId: string;
+    content?: string;
+    summary?: string;
+    memoryType?: string;
+    importance?: number;
+    confidence?: number;
+    entities?: string[];
+    relatedMemoryIds?: MemoryRelation[];
+    sourceNoteIds?: string[];
+    isArchived?: boolean;
+    metadata?: Record<string, unknown>;
+}): Promise<string>;
+export {};

package/dist/tools/update-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-memory.d.ts","sourceRoot":"","sources":["../../src/tools/update-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA0C7C,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,cAAc,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;CACrF;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GACA,OAAO,CAAC,MAAM,CAAC,CA2NjB"}