prism-mcp-server 4.2.0 → 4.6.0

package/dist/tools/compactionHandler.js

@@ -7,8 +7,8 @@
  * ═══════════════════════════════════════════════════════════════════
  */
 import { getStorage } from "../storage/index.js";
-import { GOOGLE_API_KEY, PRISM_USER_ID } from "../config.js";
-import { GoogleGenerativeAI } from "@google/generative-ai";
+import { PRISM_USER_ID } from "../config.js";
+import { getLLMProvider } from "../utils/llm/factory.js";
 import { debugLog } from "../utils/logger.js";
 // ─── Constants ────────────────────────────────────────────────
 const COMPACTION_CHUNK_SIZE = 10;
@@ -17,27 +17,20 @@ const MAX_ENTRIES_PER_RUN = 100;
 export function isCompactLedgerArgs(args) {
     return typeof args === "object" && args !== null;
 }
-// ─── Gemini Summarization ─────────────────────────────────────
+// ─── LLM Summarization ────────────────────────────────────────
 async function summarizeEntries(entries) {
-    if (!GOOGLE_API_KEY) {
-        throw new Error("Cannot compact ledger: GOOGLE_API_KEY required for Gemini summarization");
-    }
-    const genAI = new GoogleGenerativeAI(GOOGLE_API_KEY);
-    const model = genAI.getGenerativeModel({ model: "gemini-1.5-flash" });
+    const llm = getLLMProvider(); // throws if no API key configured
     const entriesText = entries.map((e, i) => `[${i + 1}] ${e.session_date || "unknown date"}: ${e.summary || "no summary"}\n` +
         (e.decisions?.length ? `  Decisions: ${e.decisions.join("; ")}\n` : "") +
         (e.files_changed?.length ? `  Files: ${e.files_changed.join(", ")}\n` : "")).join("\n");
-    const prompt = `You are compressing a session history log. Summarize these ${entries.length} ` +
+    const prompt = (`You are compressing a session history log. Summarize these ${entries.length} ` +
         `work sessions into a single concise paragraph (max 500 words).\n\n` +
         `PRESERVE: key decisions, important file changes, error resolutions, ` +
         `architecture changes, and any recurring patterns.\n` +
         `OMIT: routine operations, intermediate debugging steps, and redundant details.\n\n` +
         `Sessions to summarize:\n${entriesText}\n\n` +
-        `Provide ONLY the summary paragraph, no headers or formatting.`;
-    const truncatedPrompt = prompt.substring(0, 30000);
-    const result = await model.generateContent(truncatedPrompt);
-    const response = result.response;
-    return response.text();
+        `Provide ONLY the summary paragraph, no headers or formatting.`).substring(0, 30000);
+    return llm.generateText(prompt);
 }
 // ─── Main Handler ─────────────────────────────────────────────
 export async function compactLedgerHandler(args) {

package/dist/tools/handlers.js

@@ -20,7 +20,7 @@
  * helps the AI understand how much token budget was saved.
  */
 import { performWebSearch, performWebSearchRaw, performLocalSearch, performLocalSearchRaw, performBraveAnswers } from "../utils/braveApi.js";
-import { analyzePaperWithGemini } from "../utils/googleAi.js";
+import { getLLMProvider } from "../utils/llm/factory.js";
 import { isBraveWebSearchArgs, isBraveLocalSearchArgs, isBraveAnswersArgs, isGeminiResearchPaperAnalysisArgs, isBraveWebSearchCodeModeArgs, isBraveLocalSearchCodeModeArgs, isCodeModeTransformArgs } from "./definitions.js";
 import { runInSandbox } from "../utils/executor.js";
 import { CODE_MODE_TEMPLATES, getTemplateNames } from "../templates/codeMode.js";
@@ -216,8 +216,31 @@ export async function researchPaperAnalysisHandler(args) {
         };
     }
     try {
-        debugLog(`Analyzing research paper with Gemini (${analysisType} analysis)...`);
-        const analysis = await analyzePaperWithGemini(paperContent, analysisType, additionalContext);
+        debugLog(`Analyzing research paper (${analysisType} analysis)...`);
+        // Build the analysis prompt (mirrors the original analyzePaperWithGemini logic)
+        let prompt = `I need you to perform a detailed ${analysisType} analysis of the following research paper.\n\n`;
+        if (additionalContext) {
+            prompt += `Additional context: ${additionalContext}\n\n`;
+        }
+        prompt += `Research paper content:\n${paperContent}\n\n`;
+        switch (analysisType.toLowerCase()) {
+            case "summary":
+                prompt += "Provide a comprehensive summary including the research question, methodology, key findings, and conclusions.";
+                break;
+            case "critique":
+                prompt += "Provide a critical evaluation of the research methodology, validity of findings, limitations, and suggestions for improvement.";
+                break;
+            case "literature review":
+                prompt += "Analyze how this paper fits into the broader research landscape, identifying key related works and research gaps.";
+                break;
+            case "key findings":
+                prompt += "Extract and explain the most significant findings and their implications.";
+                break;
+            default:
+                prompt += "Perform a comprehensive analysis including summary, methodology assessment, key findings, limitations, and significance.";
+        }
+        const llm = getLLMProvider();
+        const analysis = await llm.generateText(prompt);
         return {
             content: [{ type: "text", text: analysis }],
             isError: false,

package/dist/tools/index.js

@@ -26,8 +26,8 @@ export { webSearchHandler, braveWebSearchCodeModeHandler, localSearchHandler, br
 // This file always exports them — server.ts decides whether to include them in the tool list.
 //
 // v0.4.0: Added SESSION_COMPACT_LEDGER_TOOL and SESSION_SEARCH_MEMORY_TOOL
-export { SESSION_SAVE_LEDGER_TOOL, SESSION_SAVE_HANDOFF_TOOL, SESSION_LOAD_CONTEXT_TOOL, KNOWLEDGE_SEARCH_TOOL, KNOWLEDGE_FORGET_TOOL, SESSION_COMPACT_LEDGER_TOOL, SESSION_SEARCH_MEMORY_TOOL, MEMORY_HISTORY_TOOL, MEMORY_CHECKOUT_TOOL, SESSION_SAVE_IMAGE_TOOL, SESSION_VIEW_IMAGE_TOOL, SESSION_HEALTH_CHECK_TOOL, SESSION_FORGET_MEMORY_TOOL, KNOWLEDGE_SET_RETENTION_TOOL, SESSION_SAVE_EXPERIENCE_TOOL, KNOWLEDGE_UPVOTE_TOOL, KNOWLEDGE_DOWNVOTE_TOOL } from "./sessionMemoryDefinitions.js";
-export { sessionSaveLedgerHandler, sessionSaveHandoffHandler, sessionLoadContextHandler, knowledgeSearchHandler, knowledgeForgetHandler, sessionSearchMemoryHandler, backfillEmbeddingsHandler, memoryHistoryHandler, memoryCheckoutHandler, sessionSaveImageHandler, sessionViewImageHandler, sessionHealthCheckHandler, sessionForgetMemoryHandler, knowledgeSetRetentionHandler, sessionSaveExperienceHandler, knowledgeUpvoteHandler, knowledgeDownvoteHandler } from "./sessionMemoryHandlers.js";
+export { SESSION_SAVE_LEDGER_TOOL, SESSION_SAVE_HANDOFF_TOOL, SESSION_LOAD_CONTEXT_TOOL, KNOWLEDGE_SEARCH_TOOL, KNOWLEDGE_FORGET_TOOL, SESSION_COMPACT_LEDGER_TOOL, SESSION_SEARCH_MEMORY_TOOL, MEMORY_HISTORY_TOOL, MEMORY_CHECKOUT_TOOL, SESSION_SAVE_IMAGE_TOOL, SESSION_VIEW_IMAGE_TOOL, SESSION_HEALTH_CHECK_TOOL, SESSION_FORGET_MEMORY_TOOL, SESSION_EXPORT_MEMORY_TOOL, KNOWLEDGE_SET_RETENTION_TOOL, SESSION_SAVE_EXPERIENCE_TOOL, KNOWLEDGE_UPVOTE_TOOL, KNOWLEDGE_DOWNVOTE_TOOL, KNOWLEDGE_SYNC_RULES_TOOL } from "./sessionMemoryDefinitions.js";
+export { sessionSaveLedgerHandler, sessionSaveHandoffHandler, sessionLoadContextHandler, knowledgeSearchHandler, knowledgeForgetHandler, sessionSearchMemoryHandler, backfillEmbeddingsHandler, memoryHistoryHandler, memoryCheckoutHandler, sessionSaveImageHandler, sessionViewImageHandler, sessionHealthCheckHandler, sessionForgetMemoryHandler, knowledgeSetRetentionHandler, sessionSaveExperienceHandler, knowledgeUpvoteHandler, knowledgeDownvoteHandler, knowledgeSyncRulesHandler, sessionExportMemoryHandler } from "./sessionMemoryHandlers.js";
 // ── Compaction Handler (v0.4.0 — Enhancement #2) ──
 // The compaction handler is in a separate file because it's significantly
 // more complex than the other session memory handlers (chunked Gemini

package/dist/tools/sessionMemoryDefinitions.js

@@ -605,6 +605,59 @@ export function isSessionForgetMemoryArgs(args) {
         "memory_id" in args &&
         typeof args.memory_id === "string");
 }
+// ─── Phase 2: GDPR Export Tool ─────────────────────────────────────────
+//
+// Complements session_forget_memory (surgical deletion) with a full data
+// portability export. Fulfills GDPR Article 20 (Right to Data Portability).
+// API keys are always redacted from the exported settings object.
+export const SESSION_EXPORT_MEMORY_TOOL = {
+    name: "session_export_memory",
+    description: "Export all of a project's memory to a local file. " +
+        "Fulfills GDPR Article 20 (Right to Data Portability) and the " +
+        "'local-first' portability promise.\n\n" +
+        "**What is exported:**\n" +
+        "- All session ledger entries (summaries, decisions, TODOs, file changes)\n" +
+        "- Current handoff state (live project context)\n" +
+        "- System settings (API keys are \"**REDACTED**\" for security)\n" +
+        "- Visual memory index (descriptions, captions, timestamps; not the raw files)\n\n" +
+        "**Formats:**\n" +
+        "- `json` — machine-readable, suitable for import into another Prism instance\n" +
+        "- `markdown` — human-readable, ideal for Obsidian, Notion, or archiving\n\n" +
+        "⚠️ Output directory must exist and be writable. " +
+        "Filenames are auto-generated: `prism-export-<project>-<date>.(json|md)`",
+    inputSchema: {
+        type: "object",
+        properties: {
+            project: {
+                type: "string",
+                description: "Project to export. If omitted, exports ALL projects into separate files.",
+            },
+            format: {
+                type: "string",
+                enum: ["json", "markdown"],
+                description: "Export format: 'json' (machine-readable) or 'markdown' (human-readable). Default: json.",
+                default: "json",
+            },
+            output_dir: {
+                type: "string",
+                description: "Absolute path to the directory where the export file(s) will be written. " +
+                    "Must exist and be writable. Example: '/Users/admin/Desktop'.",
+            },
+        },
+        required: ["output_dir"],
+    },
+};
+/**
+ * Type guard for session_export_memory arguments.
+ * output_dir is required (must be an absolute path).
+ * project and format are optional.
+ */
+export function isSessionExportMemoryArgs(args) {
+    return (typeof args === "object" &&
+        args !== null &&
+        "output_dir" in args &&
+        typeof args.output_dir === "string");
+}
 // ─── v3.1: Knowledge Set Retention (TTL) ─────────────────────
 export const KNOWLEDGE_SET_RETENTION_TOOL = {
     name: "knowledge_set_retention",
@@ -743,3 +796,43 @@ export function isKnowledgeVoteArgs(args) {
         "id" in args &&
         typeof args.id === "string");
 }
+// ─── v4.2: Knowledge Sync Rules Tool ─────────────────────────
+export const KNOWLEDGE_SYNC_RULES_TOOL = {
+    name: "knowledge_sync_rules",
+    description: "Auto-sync graduated insights (importance >= 7) into your project's IDE rules file " +
+        "(.cursorrules or .clauderules). This bridges behavioral memory with static IDE context — " +
+        "turning dynamic agent learnings into always-on rules.\n\n" +
+        "**How it works:**\n" +
+        "1. Fetches graduated insights from the ledger\n" +
+        "2. Formats them as markdown rules inside sentinel markers\n" +
+        "3. Idempotently writes them into the target file at the project's configured repo_path\n\n" +
+        "**Requirements:** The project must have a repo_path configured in the dashboard.\n\n" +
+        "**Idempotency:** Uses `<!-- PRISM:AUTO-RULES:START -->` / `<!-- PRISM:AUTO-RULES:END -->` " +
+        "sentinel markers. Running this tool multiple times produces the same file. " +
+        "User-maintained content outside the sentinels is never touched.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            project: {
+                type: "string",
+                description: "Project identifier. Must have a repo_path configured in the dashboard.",
+            },
+            target_file: {
+                type: "string",
+                description: "Target rules filename (default: '.cursorrules'). " +
+                    "Common values: '.cursorrules', '.clauderules'.",
+            },
+            dry_run: {
+                type: "boolean",
+                description: "If true, returns a preview of the rules block without writing to disk. Default: false.",
+            },
+        },
+        required: ["project"],
+    },
+};
+export function isKnowledgeSyncRulesArgs(args) {
+    return (typeof args === "object" &&
+        args !== null &&
+        "project" in args &&
+        typeof args.project === "string");
+}