@recapt/mcp 0.0.19-beta → 0.0.20

package/dist/tools/detectDrift.js

@@ -1,55 +0,0 @@
-/**
- * detect_drift tool
- *
- * Detect behavioral drift over time.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerDetectDrift(server) {
-    server.registerTool("detect_drift", {
-        description: "Detect behavioral drift over time by analyzing how user behavior patterns change. " +
-            "Splits data into time windows and measures centroid shift between consecutive periods. " +
-            "Use this for long-term monitoring to detect gradual UX degradation.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Scope drift detection to a specific page"),
-            days: z
-                .number()
-                .optional()
-                .default(30)
-                .describe("Number of days to analyze (default 30)"),
-            window_size: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Size of each time window in days (default 7)"),
-        }),
-    }, async ({ page_path, days, window_size, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/drift", {
-            page_path,
-            days: days ?? 30,
-            window_size: window_size ?? 7,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/detectRegressions.d.ts

@@ -1,6 +0,0 @@
-/**
- * detect_regressions tool
- *
- * Detect behavioral regressions by comparing recent data against baselines.
- */
-export declare function registerDetectRegressions(server: any): void;

package/dist/tools/detectRegressions.js

@@ -1,63 +0,0 @@
-/**
- * detect_regressions tool
- *
- * Detect behavioral regressions by comparing recent data against baselines.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerDetectRegressions(server) {
-    server.registerTool("detect_regressions", {
-        description: "Detect behavioral regressions by comparing recent data against rolling 7-day baselines. " +
-            "By default analyzes top 50 pages by traffic. Use sort_by='low_traffic' to check low-traffic " +
-            "pages that might otherwise be missed. Use offset/limit to paginate through all pages. " +
-            "Returns pages where frustration, confusion, or rage click rate have deviated significantly.",
-        inputSchema: z.object({
-            window_hours: z
-                .number()
-                .optional()
-                .default(24)
-                .describe("How many recent hours to compare against baseline (default 24)"),
-            limit: z
-                .number()
-                .optional()
-                .default(50)
-                .describe("Number of pages to check per request (default 50, max 100)"),
-            offset: z
-                .number()
-                .optional()
-                .default(0)
-                .describe("Skip this many pages for pagination (default 0)"),
-            sort_by: z
-                .enum(["traffic", "low_traffic"])
-                .optional()
-                .default("traffic")
-                .describe("Sort order: 'traffic' (default) or 'low_traffic' to check overlooked pages"),
-        }),
-    }, async ({ window_hours, limit, offset, sort_by, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/regressions", {
-            window_hours: window_hours ?? 24,
-            limit: limit ?? 50,
-            offset: offset ?? 0,
-            sort_by: sort_by ?? "traffic",
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/diagnostic.d.ts

@@ -1,6 +0,0 @@
-/**
- * Diagnostic tools for self-improvement workflow.
- *
- * Provides comprehensive site diagnostics, issue investigation, and validation.
- */
-export declare function registerDiagnosticTools(server: any): void;

package/dist/tools/diagnostic.js

@@ -1,109 +0,0 @@
-/**
- * Diagnostic tools for self-improvement workflow.
- *
- * Provides comprehensive site diagnostics, issue investigation, and validation.
- */
-import { z } from "zod";
-import { apiGet, apiPost, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerDiagnosticTools(server) {
-    server.registerTool("run_full_diagnostic", {
-        description: "Get a quick site health overview with prioritized issues and problem pages. " +
-            "This is a lightweight entry point — it does NOT include regression detection. " +
-            "For a complete analysis, call detect_regressions separately after this. " +
-            "Returns: health score, top issues, pages needing attention, and investigation order.",
-        inputSchema: z.object({
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to analyze (default: 7)"),
-        }),
-    }, async ({ days }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/diagnostic/full", { days: days ?? 7 });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("investigate_issue", {
-        description: "Deep-dive into a specific issue. Returns affected sessions, element friction data, " +
-            "related console errors, similar issues, and page context. Use after identifying an " +
-            "issue to understand root cause. NOTE: Free tier users get issue summary and page " +
-            "context only. Detailed investigation data (affected sessions, element friction, " +
-            "related errors) requires a paid plan (Starter+).",
-        inputSchema: z.object({
-            issue_id: z.string().describe("The ID of the issue to investigate"),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to look back (default: 7)"),
-        }),
-    }, async ({ issue_id, days }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet(`/issues/${issue_id}/investigate`, { days: days ?? 7 });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("validate_issue", {
-        description: "Check if an issue is still actively occurring. Returns staleness info and recommendation (investigate, dismiss_stale, or monitor). Use to filter out stale issues before proposing fixes.",
-        inputSchema: z.object({
-            issue_id: z.string().describe("The ID of the issue to validate"),
-            lookback_days: z
-                .number()
-                .optional()
-                .default(3)
-                .describe("Number of days to look back for recent occurrences (default: 3)"),
-        }),
-    }, async ({ issue_id, lookback_days, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost(`/issues/${issue_id}/validate`, { lookback_days: lookback_days ?? 3 });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/discoverPersonas.d.ts

@@ -1,6 +0,0 @@
-/**
- * discover_personas tool
- *
- * Discover behavioral personas - groups of users who behave similarly.
- */
-export declare function registerDiscoverPersonas(server: any): void;

package/dist/tools/discoverPersonas.js

@@ -1,50 +0,0 @@
-/**
- * discover_personas tool
- *
- * Discover behavioral personas - groups of users who behave similarly.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerDiscoverPersonas(server) {
-    server.registerTool("discover_personas", {
-        description: "Discover behavioral personas - groups of users who behave similarly " +
-            "(e.g. confident completers, frustrated battlers, lost explorers). " +
-            "Returns rich profiles with descriptions, risk factors, and recommended interventions. " +
-            "Uses K-means clustering on behavioral embeddings. Optionally scope to a specific page.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Scope persona discovery to a specific page"),
-            num_personas: z
-                .number()
-                .optional()
-                .default(4)
-                .describe("Number of personas to discover (default 4, max 8)"),
-        }),
-    }, async ({ page_path, num_personas, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/personas", {
-            page_path,
-            num_personas: num_personas ?? 4,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getActionableIssues.d.ts

@@ -1,7 +0,0 @@
-/**
- * get_actionable_issues tool
- *
- * Returns UX issues with element context for investigation.
- * Thin proxy to external-api /actionable-issues endpoint.
- */
-export declare function registerGetActionableIssues(server: any): void;

package/dist/tools/getActionableIssues.js

@@ -1,55 +0,0 @@
-/**
- * get_actionable_issues tool
- *
- * Returns UX issues with element context for investigation.
- * Thin proxy to external-api /actionable-issues endpoint.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetActionableIssues(server) {
-    server.registerTool("get_actionable_issues", {
-        description: "Get UX issues with element context. Returns detected issues (rage clicks, dead clicks, " +
-            "errors, etc.) along with the most affected elements on each page. " +
-            "Use this when you want to understand and fix specific UX problems.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Filter to a specific page path (e.g., /checkout)"),
-            severity: z
-                .enum(["critical", "high", "medium", "low", "info"])
-                .optional()
-                .describe("Minimum severity level to include"),
-            limit: z
-                .number()
-                .optional()
-                .default(10)
-                .describe("Maximum number of issues to return (default: 10)"),
-        }),
-    }, async ({ page_path, severity, limit, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/actionable-issues", {
-            page_path,
-            severity,
-            limit: limit ?? 10,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getAnomalies.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_anomalies tool
- *
- * Detects anomalous sessions and frustration spikes.
- */
-export declare function registerGetAnomalies(server: any): void;

package/dist/tools/getAnomalies.js

@@ -1,53 +0,0 @@
-/**
- * get_anomalies tool
- *
- * Detects anomalous sessions and frustration spikes.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetAnomalies(server) {
-    server.registerTool("get_anomalies", {
-        description: "Detect anomalous sessions and frustration spikes. Finds sessions that deviate from normal behavior patterns.",
-        inputSchema: z.object({
-            threshold: z
-                .number()
-                .optional()
-                .default(0.35)
-                .describe("Anomaly threshold (0-1, default: 0.35)"),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Days to analyze for frustration spikes (default: 7)"),
-            page_path: z
-                .string()
-                .optional()
-                .describe("Optional: filter to a specific page"),
-        }),
-    }, async ({ threshold, days, page_path, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/anomalies", {
-            threshold: threshold ?? 0.35,
-            days: days ?? 7,
-            page_path,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getConsoleErrors.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_console_errors tool
- *
- * Query JavaScript console errors and warnings from user sessions.
- */
-export declare function registerGetConsoleErrors(server: any): void;

package/dist/tools/getConsoleErrors.js

@@ -1,61 +0,0 @@
-/**
- * get_console_errors tool
- *
- * Query JavaScript console errors and warnings from user sessions.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetConsoleErrors(server) {
-    server.registerTool("get_console_errors", {
-        description: "Query JavaScript console errors and warnings from user sessions. " +
-            "Use this when you suspect page unresponsiveness, broken buttons, or rendering issues. " +
-            "Returns the most common errors grouped by message, with session impact counts. " +
-            "High rage clicks on root/body elements often correlate with JS errors.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Filter errors to a specific page path"),
-            session_id: z
-                .string()
-                .optional()
-                .describe("Filter errors to a specific session"),
-            severity: z
-                .enum(["error", "warn", "all"])
-                .optional()
-                .default("error")
-                .describe('Filter by severity: "error" (default), "warn", or "all"'),
-            limit: z
-                .number()
-                .optional()
-                .default(200)
-                .describe("Max log documents to scan (default 200)"),
-        }),
-    }, async ({ page_path, session_id, severity, limit, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/console-errors", {
-            page_path,
-            session_id,
-            severity: severity ?? "error",
-            limit: limit ?? 200,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getDeadClicks.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_dead_clicks tool
- *
- * Find buttons and links that users click but nothing happens (dead clicks).
- */
-export declare function registerGetDeadClicks(server: any): void;

package/dist/tools/getDeadClicks.js

@@ -1,42 +0,0 @@
-/**
- * get_dead_clicks tool
- *
- * Find buttons and links that users click but nothing happens (dead clicks).
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetDeadClicks(server) {
-    server.registerTool("get_dead_clicks", {
-        description: "Find buttons and links that users click but nothing happens (dead clicks). " +
-            "These are interactive elements where the click produced no visible DOM change. " +
-            "Use this to identify BROKEN or UNRESPONSIVE UI elements that frustrate users.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .describe("Page path to check for dead clicks (required)"),
-        }),
-    }, async ({ page_path }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/dead-clicks", {
-            page_path,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getDomains.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_domains tool
- *
- * Returns the list of domains configured for the organization.
- */
-export declare function registerGetDomains(server: any): void;

package/dist/tools/getDomains.js

@@ -1,34 +0,0 @@
-/**
- * get_domains tool
- *
- * Returns the list of domains configured for the organization.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetDomains(server) {
-    server.registerTool("get_domains", {
-        description: "Get the list of domains configured for the organization. Domains represent different websites or applications being tracked.",
-        inputSchema: z.object({}),
-    }, async () => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/domains");
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getElementFriction.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_element_friction tool
- *
- * Returns per-element friction data for a specific page.
- */
-export declare function registerGetElementFriction(server: any): void;

package/dist/tools/getElementFriction.js

@@ -1,45 +0,0 @@
-/**
- * get_element_friction tool
- *
- * Returns per-element friction data for a specific page.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetElementFriction(server) {
-    server.registerTool("get_element_friction", {
-        description: "Get per-element friction data for a page. Shows which elements cause user frustration, with click counts and dominant frustration signals.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .describe("Page path to analyze (e.g., /checkout)"),
-            selector_filter: z
-                .string()
-                .optional()
-                .describe("Optional: filter elements by selector substring"),
-        }),
-    }, async ({ page_path, selector_filter, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/elements", {
-            page_path,
-            selector_filter,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getFlowFriction.d.ts

@@ -1,7 +0,0 @@
-/**
- * get_flow_friction tool
- *
- * Discovers high-friction user flows by analyzing navigation patterns
- * and behavioral data. Thin proxy to external-api /flow-friction endpoint.
- */
-export declare function registerGetFlowFriction(server: any): void;