@recapt/mcp 0.0.43 → 0.0.44

package/dist/index.js

@@ -8,6 +8,14 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // ../../libraries/mcp-tools/dist/client.js
 var DEFAULT_API_URL = "https://api.recapt.app";
 var REQUEST_TIMEOUT_MS = 12e4;
+var MAX_RETRIES = 3;
+var RETRY_BASE_MS = 500;
+function isTransientError(err) {
+  if (!(err instanceof Error))
+    return false;
+  const msg = err.message.toLowerCase();
+  return msg === "fetch failed" || msg.includes("econnreset") || msg.includes("econnrefused") || msg.includes("socket hang up") || msg.includes("network") || err.name === "AbortError";
+}
 var _config = {};
 function getApiUrl() {
   return _config.apiUrl || process.env.RECAPT_API_URL || process.env.MCP_API_URL || process.env.EXTERNAL_API_URL || DEFAULT_API_URL;
@@ -50,8 +58,6 @@ async function request(options) {
       requestBody = { ...requestBody, domain: domainFilter.join(",") };
     }
   }
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
   const headers = {
     "x-private-key": secretKey,
     "Content-Type": "application/json"
@@ -60,27 +66,40 @@ async function request(options) {
   if (orgId) {
     headers["x-organization-id"] = orgId;
   }
-  try {
-    const res = await fetch(url.toString(), {
-      method,
-      headers,
-      body: requestBody ? JSON.stringify(requestBody) : void 0,
-      signal: controller.signal
-    });
-    clearTimeout(timeout);
-    if (!res.ok) {
-      const errorBody = await res.json().catch(() => ({}));
-      return { error: errorBody.error || `HTTP ${res.status}` };
-    }
-    const data = await res.json();
-    return { data };
-  } catch (err) {
-    clearTimeout(timeout);
-    if (err instanceof Error && err.name === "AbortError") {
-      return { error: `Request timed out after ${REQUEST_TIMEOUT_MS / 1e3}s` };
+  const bodyStr = requestBody ? JSON.stringify(requestBody) : void 0;
+  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    try {
+      const res = await fetch(url.toString(), {
+        method,
+        headers,
+        body: bodyStr,
+        signal: controller.signal
+      });
+      clearTimeout(timeout);
+      if (!res.ok) {
+        const errorBody = await res.json().catch(() => ({}));
+        return { error: errorBody.error || `HTTP ${res.status}` };
+      }
+      const data = await res.json();
+      return { data };
+    } catch (err) {
+      clearTimeout(timeout);
+      if (attempt < MAX_RETRIES && isTransientError(err)) {
+        const delay = RETRY_BASE_MS * 2 ** attempt;
+        await new Promise((r) => setTimeout(r, delay));
+        continue;
+      }
+      if (err instanceof Error && err.name === "AbortError") {
+        return {
+          error: `Request timed out after ${REQUEST_TIMEOUT_MS / 1e3}s`
+        };
+      }
+      return { error: err instanceof Error ? err.message : String(err) };
     }
-    return { error: err instanceof Error ? err.message : String(err) };
   }
+  return { error: "Request failed after retries" };
 }
 function apiGet(path, params) {
   return request({ method: "GET", path, params });
@@ -1067,7 +1086,16 @@ var getSessionDetailsTool = {
   description: "Get behavioral timeline for one or more sessions. Shows how frustration, confusion, and confidence evolved over time. Accepts a single session_id or an array of session_ids (max 20).",
   inputSchema: z21.object({
     session_id: z21.string().optional().describe("Single session ID to get details for"),
-    session_ids: z21.array(z21.string()).max(20).optional().describe("Array of session IDs to get details for (max 20)")
+    session_ids: z21.preprocess((val) => {
+      if (typeof val === "string") {
+        try {
+          return JSON.parse(val);
+        } catch {
+          return val;
+        }
+      }
+      return val;
+    }, z21.array(z21.string()).max(20).optional()).describe("Array of session IDs to get details for (max 20)")
   }),
   handler: async (args) => {
     const { session_id, session_ids } = args;
@@ -1102,7 +1130,16 @@ var getSessionPagesTool = {
   description: "Get the pages visited within one or more sessions. Returns navigation history with timestamps, source pages, and dwell times. Use this to understand the user's journey through the site during a session. Accepts a single session_id or an array of session_ids (max 20).",
   inputSchema: z22.object({
     session_id: z22.string().optional().describe("Single session ID to get pages for"),
-    session_ids: z22.array(z22.string()).max(20).optional().describe("Array of session IDs to get pages for (max 20)")
+    session_ids: z22.preprocess((val) => {
+      if (typeof val === "string") {
+        try {
+          return JSON.parse(val);
+        } catch {
+          return val;
+        }
+      }
+      return val;
+    }, z22.array(z22.string()).max(20).optional()).describe("Array of session IDs to get pages for (max 20)")
   }),
   handler: async (args) => {
     const { session_id, session_ids } = args;
@@ -1326,9 +1363,9 @@ var recordImprovementActionTool = {
       return apiNotConfiguredResult();
     }
     if (remediation_id) {
-      const { data: remediation, error: remediationError } = await apiGet(`/remediations/${remediation_id}`);
-      if (remediationError || !remediation) {
-        return errorResult(`Remediation ${remediation_id} not found`);
+      const { error: remediationError } = await apiGet(`/remediations/${remediation_id}`);
+      if (remediationError) {
+        console.warn(`Preflight remediation check failed for ${remediation_id}: ${remediationError}. Proceeding with POST.`);
       }
     }
     const { data, error } = await apiPost(`/improvement-runs/${run_id}/actions`, {
@@ -1746,14 +1783,18 @@ var evaluateFixTool = {
   description: "Evaluate if a deployed fix improved metrics. Compares post-deployment metrics to baseline. Returns success/partial/failed outcome with detailed verdict. Wait at least 24 hours after deployment for reliable results.",
   inputSchema: z30.object({
     remediation_id: z30.string().describe("The ID of the remediation to evaluate"),
-    min_hours: z30.number().optional().default(24).describe("Minimum hours since deployment required (default: 24)")
+    min_hours: z30.number().optional().default(24).describe("Minimum hours since deployment required (default: 24)"),
+    skip_status_update: z30.boolean().optional().default(false).describe("When true, skips writing remediation status (used in phased mode where applyEvaluateUpdates is authoritative)")
   }),
   handler: async (args) => {
-    const { remediation_id, min_hours } = args;
+    const { remediation_id, min_hours, skip_status_update } = args;
     if (!isApiConfigured()) {
       return apiNotConfiguredResult();
     }
-    const { data, error } = await apiPost(`/remediations/${remediation_id}/evaluate`, { min_hours: min_hours ?? 24 });
+    const { data, error } = await apiPost(`/remediations/${remediation_id}/evaluate`, {
+      min_hours: min_hours ?? 24,
+      skip_status_update: skip_status_update ?? false
+    });
     if (error) {
       return errorResult(error);
     }
@@ -2017,7 +2058,16 @@ var triageSessionsTool = {
   name: "triage_sessions",
   description: "Automatically triage sessions to find compromised user experiences. Analyzes user comments, frustration signals, rage clicks, and console errors. Returns flagged sessions with evidence and replay links. Use this to identify sessions that need attention without manually reviewing every recording. Can triage specific sessions by ID(s) or scan for problematic sessions. NOTE: Session replay URLs require a paid plan (Starter+). Free tier users can see session summaries and triage scores but not watch replays.",
   inputSchema: z33.object({
-    session_ids: z33.array(z33.string()).optional().describe("Triage specific sessions by ID. If provided, other filters are ignored."),
+    session_ids: z33.preprocess((val) => {
+      if (typeof val === "string") {
+        try {
+          return JSON.parse(val);
+        } catch {
+          return val;
+        }
+      }
+      return val;
+    }, z33.array(z33.string()).optional()).describe("Triage specific sessions by ID. If provided, other filters are ignored."),
     days: z33.number().optional().default(7).describe("Lookback period in days (default: 7). Ignored if session_ids is provided."),
     page_path: z33.string().optional().describe("Filter to sessions that visited a specific page"),
     min_severity: z33.enum(["critical", "high", "medium", "low"]).optional().describe("Minimum severity to include in results"),
@@ -2808,6 +2858,138 @@ var listRepositoryFilesTool = {
     }
   }
 };
+var getRepoTreeTool = {
+  name: "get_repo_tree",
+  description: "Get a condensed directory-only tree of the repository structure. Returns a nested object showing the folder hierarchy up to a configurable depth. Much faster than recursive list_repository_files for understanding project layout. Use this FIRST to orient yourself, then list_repository_files on specific directories.",
+  inputSchema: z35.object({
+    max_depth: z35.number().optional().default(4).describe("Maximum directory depth to return (default: 4)"),
+    branch: z35.string().optional().describe("Branch to read from (default: main)")
+  }),
+  handler: async (args) => {
+    try {
+      const ctx = getGitContext();
+      const maxDepth = args.max_depth || 4;
+      const branch = args.branch || "main";
+      if (ctx.provider === "github") {
+        const res = await githubRequest(`/repos/${ctx.repoFullName}/git/trees/${branch}?recursive=1`);
+        if (!res.ok) {
+          return errorResult(`Failed to get repo tree: ${res.statusText}`);
+        }
+        const data = await res.json();
+        const dirs = data.tree.filter((item) => item.type === "tree").map((item) => item.path);
+        const tree = buildNestedTree(dirs, maxDepth);
+        const totalDirs = dirs.length;
+        return successResult({
+          tree,
+          total_directories: totalDirs,
+          depth: maxDepth,
+          provider: "github"
+        });
+      } else {
+        const encodedPath = encodeURIComponent(ctx.repoFullName);
+        const res = await gitlabRequest(`/projects/${encodedPath}/repository/tree?ref=${branch}&recursive=true&per_page=100`);
+        if (!res.ok) {
+          return errorResult(`Failed to get repo tree: ${res.statusText}`);
+        }
+        const data = await res.json();
+        const dirs = data.filter((item) => item.type === "tree").map((item) => item.path);
+        const tree = buildNestedTree(dirs, maxDepth);
+        const totalDirs = dirs.length;
+        return successResult({
+          tree,
+          total_directories: totalDirs,
+          depth: maxDepth,
+          provider: "gitlab"
+        });
+      }
+    } catch (error) {
+      return errorResult(error instanceof Error ? error.message : "Failed to get repo tree");
+    }
+  }
+};
+var searchCodeTool = {
+  name: "search_code",
+  description: "Search for code patterns, symbols, or imports across the repository. Use this to find existing conventions, verify import paths, or discover reusable utilities before writing code. Rate-limited (~10 req/min on GitHub) \u2014 use sparingly and with specific queries.",
+  inputSchema: z35.object({
+    query: z35.string().describe('Search terms (e.g., "import { Button }", "useMemo", "className={styles.")'),
+    path_filter: z35.string().optional().describe('Restrict search to a directory (e.g., "client/src/components")'),
+    extension: z35.string().optional().describe('Filter by file extension (e.g., "tsx", "ts", "css")')
+  }),
+  handler: async (args) => {
+    try {
+      const ctx = getGitContext();
+      const query = args.query;
+      const pathFilter = args.path_filter;
+      const extension = args.extension;
+      if (ctx.provider === "github") {
+        let q = `${query} repo:${ctx.repoFullName}`;
+        if (pathFilter)
+          q += ` path:${pathFilter}`;
+        if (extension)
+          q += ` extension:${extension}`;
+        const res = await githubRequest(`/search/code?q=${encodeURIComponent(q)}&per_page=10`, {
+          headers: {
+            Accept: "application/vnd.github.text-match+json"
+          }
+        });
+        if (!res.ok) {
+          const err = await res.json();
+          return errorResult(err.message || `Code search failed: ${res.status}`);
+        }
+        const data = await res.json();
+        const results = data.items.map((item) => ({
+          path: item.path,
+          score: item.score,
+          matched_lines: (item.text_matches ?? []).map((m) => m.fragment),
+          url: item.html_url
+        }));
+        return successResult({
+          total_count: data.total_count,
+          results,
+          provider: "github"
+        });
+      } else {
+        const encodedPath = encodeURIComponent(ctx.repoFullName);
+        const searchQuery = pathFilter ? `${query} filename:${pathFilter}` : query;
+        const res = await gitlabRequest(`/projects/${encodedPath}/search?scope=blobs&search=${encodeURIComponent(searchQuery)}&per_page=10`);
+        if (!res.ok) {
+          const err = await res.json();
+          return errorResult(err.message || `Code search failed: ${res.status}`);
+        }
+        const data = await res.json();
+        const results = data.map((item) => ({
+          path: item.path,
+          matched_lines: [item.data],
+          startline: item.startline
+        }));
+        return successResult({
+          total_count: results.length,
+          results,
+          provider: "gitlab"
+        });
+      }
+    } catch (error) {
+      return errorResult(error instanceof Error ? error.message : "Code search failed");
+    }
+  }
+};
+function buildNestedTree(dirs, maxDepth) {
+  const tree = {};
+  for (const dir of dirs) {
+    const parts = dir.split("/");
+    if (parts.length > maxDepth)
+      continue;
+    let current = tree;
+    for (const part of parts) {
+      const key = `${part}/`;
+      if (!current[key]) {
+        current[key] = {};
+      }
+      current = current[key];
+    }
+  }
+  return tree;
+}
 
 // ../../libraries/mcp-tools/dist/tools/index.js
 var allTools = [
@@ -2890,7 +3072,9 @@ var allTools = [
   createMergeRequestTool,
   checkMrStatusTool,
   listOpenMrsTool,
-  listRepositoryFilesTool
+  listRepositoryFilesTool,
+  getRepoTreeTool,
+  searchCodeTool
 ];
 var EXPOSED_TOOL_NAMES = [
   "get_domains",

package/dist/tools/catalog/anthropicToolCatalog.json

@@ -595,92 +595,57 @@
     }
   },
   {
-    "name": "dismiss_issue",
-    "description": "Dismiss an issue as a false positive. Creates site knowledge to prevent re-flagging.",
+    "name": "propose_fix",
+    "description": "Propose a fix for a UX issue. REQUIRED: page_path, diagnosis, proposed_fix, confidence. Creates a remediation record with baseline metrics for later evaluation. Returns remediation_id for tracking.",
     "input_schema": {
       "type": "object",
       "properties": {
-        "issue_id": {
-          "description": "The ID of the issue to dismiss",
-          "type": "string"
-        },
-        "reason": {
-          "description": "Reason for dismissal",
-          "type": "string"
-        },
-        "explanation": {
-          "description": "Detailed explanation",
+        "page_path": {
+          "description": "The page path where the issue occurs",
           "type": "string"
         },
-        "create_knowledge": {
-          "description": "Whether to create site knowledge entry (default: true)",
-          "type": "boolean"
-        }
-      },
-      "required": [
-        "issue_id",
-        "reason",
-        "explanation"
-      ]
-    }
-  },
-  {
-    "name": "mark_intended_behavior",
-    "description": "Mark an issue as intended behavior. Creates site knowledge to prevent re-flagging.",
-    "input_schema": {
-      "type": "object",
-      "properties": {
-        "issue_id": {
-          "description": "The ID of the issue to mark as intended",
+        "category": {
+          "description": "The issue category (code_error, dead_click, rage_click, ux_friction, performance, form_issue, behavioral_anomaly, structural_issue)",
           "type": "string"
         },
-        "explanation": {
-          "description": "Explanation of why this behavior is intended",
-          "type": "string"
-        }
-      },
-      "required": [
-        "issue_id",
-        "explanation"
-      ]
-    }
-  },
-  {
-    "name": "propose_fix",
-    "description": "Propose a fix for an issue. Creates a remediation record with baseline metrics for later evaluation. Use this to create a new remediation, even without an existing issue ID.",
-    "input_schema": {
-      "type": "object",
-      "properties": {
-        "issue_id": {
-          "description": "The ID of the issue to fix",
+        "severity": {
+          "description": "The issue severity (critical, high, medium, low, info)",
           "type": "string"
         },
         "diagnosis": {
-          "description": "Detailed analysis of the root cause",
+          "description": "Detailed analysis of the root cause of the issue",
           "type": "string"
         },
         "proposed_fix": {
-          "description": "Description of the proposed fix",
+          "description": "Description of the proposed fix and how it addresses the root cause",
           "type": "string"
         },
         "code_snippet": {
-          "description": "Suggested code changes",
+          "description": "Suggested code changes (if applicable)",
           "type": "string"
         },
         "affected_files": {
-          "description": "List of files to modify",
+          "description": "List of files that need to be modified",
           "type": "array",
           "items": {
             "type": "string"
           }
         },
         "confidence": {
-          "description": "Confidence level (0-1)",
+          "description": "Confidence level in the fix (0-1). Use <0.7 when uncertain.",
           "type": "number"
+        },
+        "title": {
+          "description": "User-friendly title describing the issue from the user's perspective",
+          "type": "string"
+        },
+        "execution_metadata": {
+          "description": "AI execution metadata for tracking model selection and performance",
+          "type": "object"
         }
       },
       "required": [
-        "issue_id",
+        "page_path",
         "diagnosis",
         "proposed_fix",
         "confidence"
@@ -722,6 +687,29 @@
       "required": []
     }
   },
+  {
+    "name": "list_remediations_by_status",
+    "description": "List remediations filtered by one or more statuses. Use to find all 'waiting' PRs or 'deployed' fixes ready for evaluation.",
+    "input_schema": {
+      "type": "object",
+      "properties": {
+        "statuses": {
+          "description": "List of statuses to filter by (e.g. ['waiting', 'deployed'])",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "include_execution": {
+          "description": "Include execution metadata (difficulty class, model used)",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "statuses"
+      ]
+    }
+  },
   {
     "name": "confirm_deployment",
     "description": "Confirm that a proposed fix has been deployed to production. Starts the evaluation timer.",
@@ -1318,6 +1306,48 @@
       "required": []
     }
   },
+  {
+    "name": "get_repo_tree",
+    "description": "Get a condensed directory-only tree of the repository. Returns a nested object showing the folder hierarchy up to a configurable depth. Use FIRST to understand project layout before navigating with list_repository_files.",
+    "input_schema": {
+      "type": "object",
+      "properties": {
+        "max_depth": {
+          "description": "Maximum directory depth (default: 4)",
+          "type": "number"
+        },
+        "branch": {
+          "description": "Branch name (default: main)",
+          "type": "string"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "search_code",
+    "description": "Search for code patterns, symbols, or imports across the repository. Use to find existing conventions, verify import paths, or discover reusable utilities. Rate-limited (~10 req/min) — use sparingly with specific queries.",
+    "input_schema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "description": "Search terms (e.g., \"import { Button }\", \"useMemo\", \"className={styles.\")",
+          "type": "string"
+        },
+        "path_filter": {
+          "description": "Restrict search to a directory (e.g., \"client/src/components\")",
+          "type": "string"
+        },
+        "extension": {
+          "description": "Filter by file extension (e.g., \"tsx\", \"ts\", \"css\")",
+          "type": "string"
+        }
+      },
+      "required": [
+        "query"
+      ]
+    }
+  },
   {
     "name": "get_file_content",
     "description": "Read file contents from the repository.",