@recapt/mcp 0.0.47 → 0.0.48

package/dist/index.js

@@ -2164,6 +2164,7 @@ var KNOWLEDGE_CATEGORIES = [
   "fix_pattern",
   "context"
 ];
+var IMPORTANCE_LEVELS = ["critical", "high", "normal", "low"];
 var ISSUE_CATEGORIES = [
   "code_error",
   "dead_click",
@@ -2175,25 +2176,35 @@ var ISSUE_CATEGORIES = [
   "structural_issue"
 ];
 var getSiteKnowledgeTool = {
-  name: "get_site_knowledge",
-  description: "Retrieve site-specific learnings including known false positives, intended behaviors, and successful fix patterns. Use at the start of a self-improvement workflow to avoid re-flagging known issues.",
+  name: "recall_memory",
+  description: "Search your persistent memory from previous sessions. Use to recall context, patterns, lessons learned, and site-specific knowledge. Supports semantic search (finds memories by meaning) or filter-based retrieval.",
   inputSchema: z27.object({
-    category: z27.enum(KNOWLEDGE_CATEGORIES).optional().describe("Filter by knowledge category"),
+    query: z27.string().optional().describe("Natural language search query to find relevant memories by meaning. When provided, uses semantic search to find memories by similarity."),
+    category: z27.enum(KNOWLEDGE_CATEGORIES).optional().describe("Filter by memory category"),
+    importance: z27.enum(IMPORTANCE_LEVELS).optional().describe("Filter by importance level"),
     page_path: z27.string().optional().describe("Filter by page path"),
     issue_category: z27.enum(ISSUE_CATEGORIES).optional().describe("Filter by issue category"),
-    limit: z27.number().optional().default(50).describe("Maximum number of entries to return (default: 50)")
+    limit: z27.number().optional().default(20).describe("Maximum number of memories to return (default: 20)")
   }),
   handler: async (args) => {
-    const { category, page_path, issue_category, limit } = args;
+    const { query, category, importance, page_path, issue_category, limit } = args;
     if (!isApiConfigured()) {
       return apiNotConfiguredResult();
     }
-    const { data, error } = await apiGet("/knowledge", {
-      category,
-      page_path,
-      issue_category,
-      limit: limit ?? 50
-    });
+    const params = {};
+    if (query)
+      params.query = query;
+    if (category)
+      params.category = category;
+    if (importance)
+      params.importance = importance;
+    if (page_path)
+      params.page_path = page_path;
+    if (issue_category)
+      params.issue_category = issue_category;
+    if (limit)
+      params.limit = limit;
+    const { data, error } = await apiGet("/knowledge", params);
     if (error) {
       return errorResult(error);
     }
@@ -2201,18 +2212,19 @@ var getSiteKnowledgeTool = {
   }
 };
 var addSiteKnowledgeTool = {
-  name: "add_site_knowledge",
-  description: "Store a site-specific learning. Use to record false positives, intended behaviors, successful fix patterns, or important context about the site.",
+  name: "remember",
+  description: "Store a persistent memory that will survive across sessions. Use when you discover important context, patterns, or lessons that your future self should know. Set importance to 'critical' for things you should ALWAYS be aware of in every session.",
   inputSchema: z27.object({
-    category: z27.enum(KNOWLEDGE_CATEGORIES).describe("Category of knowledge: false_positive, intended_behavior, fix_pattern, or context"),
-    subject: z27.string().describe("Unique identifier/title for this knowledge entry"),
-    content: z27.string().describe("Detailed description of the learning"),
+    category: z27.enum(KNOWLEDGE_CATEGORIES).describe("Category: false_positive (not a real issue), intended_behavior (by design), fix_pattern (what works/doesn't for fixes), context (general site knowledge)"),
+    subject: z27.string().describe("Short, unique title for this memory (used for deduplication)"),
+    content: z27.string().describe("Detailed description of what you learned"),
+    importance: z27.enum(IMPORTANCE_LEVELS).optional().default("normal").describe("How important is this memory? 'critical' = always loaded at start of every session, 'high' = loaded when working on related pages/categories, 'normal' = available via search (default), 'low' = rarely relevant"),
     page_path: z27.string().optional().describe("Associated page path (if applicable)"),
     element_selector: z27.string().optional().describe("Associated element selector (if applicable)"),
     issue_category: z27.enum(ISSUE_CATEGORIES).optional().describe("Associated issue category (if applicable)")
   }),
   handler: async (args) => {
-    const { category, subject, content, page_path, element_selector, issue_category } = args;
+    const { category, subject, content, importance, page_path, element_selector, issue_category } = args;
     if (!isApiConfigured()) {
       return apiNotConfiguredResult();
     }
@@ -2220,6 +2232,7 @@ var addSiteKnowledgeTool = {
       category,
       subject,
       content,
+      importance: importance || "normal",
       page_path,
       element_selector,
       issue_category,
@@ -2232,10 +2245,10 @@ var addSiteKnowledgeTool = {
   }
 };
 var deleteSiteKnowledgeTool = {
-  name: "delete_site_knowledge",
-  description: "Delete a site knowledge entry. Use when a learning is no longer valid or was created in error.",
+  name: "forget",
+  description: "Remove a memory that is no longer valid or was created in error. Use when you notice an outdated or incorrect memory during recall.",
   inputSchema: z27.object({
-    knowledge_id: z27.string().describe("The ID of the knowledge entry to delete")
+    knowledge_id: z27.string().describe("The ID of the memory to remove")
   }),
   handler: async (args) => {
     const { knowledge_id } = args;
@@ -2377,10 +2390,16 @@ var proposeFixTool = {
       iterations: z31.number().optional(),
       credits_used: z31.number().optional(),
       duration_ms: z31.number().optional()
-    }).optional().describe("AI execution metadata for tracking model selection and performance")
+    }).optional().describe("AI execution metadata for tracking model selection and performance"),
+    evidence_sessions: z31.array(z31.object({
+      session_id: z31.string().describe("Session ID that demonstrates this issue"),
+      reason: z31.string().optional().describe("Why this session was selected as evidence"),
+      frustration: z31.number().optional().describe("Frustration score for this session"),
+      page_path: z31.string().optional().describe("Page where the issue manifested")
+    })).max(5).optional().describe("Up to 5 example sessions that demonstrate the issue. Discovered via triage_sessions or search_sessions during investigation.")
   }),
   handler: async (args) => {
-    const { page_path, category, severity, diagnosis, proposed_fix, code_snippet, affected_files, code_changes, confidence, title, execution_metadata } = args;
+    const { page_path, category, severity, diagnosis, proposed_fix, code_snippet, affected_files, code_changes, confidence, title, execution_metadata, evidence_sessions } = args;
     if (!isApiConfigured()) {
       return apiNotConfiguredResult();
     }
@@ -2395,7 +2414,8 @@ var proposeFixTool = {
       code_changes,
       confidence,
       title,
-      execution_metadata
+      execution_metadata,
+      evidence_sessions
     });
     if (error) {
       return errorResult(error);
@@ -2600,10 +2620,17 @@ var updateRemediationTool = {
       description: z31.string().optional().describe("Description of the change")
     })).optional().describe("Detailed code changes with file contents"),
     confidence: z31.number().min(0).max(1).optional().describe("Updated confidence level in the fix (0-1)"),
-    title: z31.string().optional().describe("Updated user-friendly title")
+    title: z31.string().optional().describe("Updated user-friendly title"),
+    evidence_sessions: z31.array(z31.object({
+      session_id: z31.string().describe("Session ID that demonstrates this issue"),
+      reason: z31.string().optional().describe("Why this session was selected as evidence"),
+      frustration: z31.number().optional().describe("Frustration score for this session"),
+      page_path: z31.string().optional().describe("Page where the issue manifested")
+    })).max(5).optional().describe("Up to 5 example sessions that demonstrate the issue. Replaces any existing evidence sessions."),
+    user_context: z31.string().optional().describe("User-provided context, constraints, or business rules relevant to this remediation. Synthesize into a concise summary \u2014 replaces any existing context.")
   }),
   handler: async (args) => {
-    const { remediation_id, proposed_fix, code_snippet, affected_files, code_changes, confidence, title } = args;
+    const { remediation_id, proposed_fix, code_snippet, affected_files, code_changes, confidence, title, evidence_sessions, user_context } = args;
     if (!isApiConfigured()) {
       return apiNotConfiguredResult();
     }
@@ -2613,7 +2640,9 @@ var updateRemediationTool = {
       affected_files,
       code_changes,
       confidence,
-      title
+      title,
+      evidence_sessions,
+      user_context
     });
     if (error) {
       return errorResult(error);
@@ -3150,6 +3179,9 @@ var EXPOSED_TOOL_NAMES = [
   "get_upgrade_options",
   "search_tools",
   "call_tool",
+  "recall_memory",
+  "remember",
+  "forget",
   "memory_save",
   "query_memory",
   "memory_recall",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recapt/mcp",
-  "version": "0.0.47",
+  "version": "0.0.48",
   "description": "MCP exposing recapt behavioral intelligence to AI coding agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",