@recapt/mcp 0.0.42 → 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 });
@@ -145,8 +164,6 @@ function registerAllToolHandlers() {
   toolHandlers.set("analyze_funnel", createApiHandler("POST", "/flows/funnel"));
   toolHandlers.set("get_flow_friction", createApiHandler("GET", "/flow-friction"));
   toolHandlers.set("get_journey_patterns", createApiHandler("GET", "/flows/patterns"));
-  toolHandlers.set("get_issues", createApiHandler("GET", "/issues"));
-  toolHandlers.set("get_actionable_issues", createApiHandler("GET", "/actionable-issues"));
   toolHandlers.set("get_anomalies", createApiHandler("GET", "/anomalies"));
   toolHandlers.set("detect_regressions", createApiHandler("GET", "/regressions"));
   toolHandlers.set("detect_drift", createApiHandler("GET", "/drift"));
@@ -1069,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;
@@ -1104,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;
@@ -1328,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`, {
@@ -1748,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);
     }
@@ -2019,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"),
@@ -2810,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 = [
@@ -2892,7 +3072,9 @@ var allTools = [
   createMergeRequestTool,
   checkMrStatusTool,
   listOpenMrsTool,
-  listRepositoryFilesTool
+  listRepositoryFilesTool,
+  getRepoTreeTool,
+  searchCodeTool
 ];
 var EXPOSED_TOOL_NAMES = [
   "get_domains",