@recapt/mcp 0.0.19-beta → 0.0.20

package/dist/tools/getFlowFriction.js

@@ -1,57 +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.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetFlowFriction(server) {
-    server.registerTool("get_flow_friction", {
-        description: "Discover user flows with behavioral metrics. Returns navigation transitions " +
-            "with frustration, confusion, and health scores for each page in the flow. " +
-            "Also flags backtrack hotspots (pages users return to) and dropoff pages. " +
-            "Use this to find which flows need optimization.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Focus on flows involving this page (e.g., /checkout)"),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to analyze (default: 7)"),
-            limit: z
-                .number()
-                .optional()
-                .default(10)
-                .describe("Maximum number of flows to return (default: 10)"),
-        }),
-    }, async ({ page_path, days, limit, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/flow-friction", {
-            page_path,
-            days: days ?? 7,
-            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/getFormFriction.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_form_friction tool
- *
- * Analyze which form fields cause friction.
- */
-export declare function registerGetFormFriction(server: any): void;

package/dist/tools/getFormFriction.js

@@ -1,42 +0,0 @@
-/**
- * get_form_friction tool
- *
- * Analyze which form fields cause friction.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetFormFriction(server) {
-    server.registerTool("get_form_friction", {
-        description: "Analyze which form fields cause friction on a page. " +
-            "Returns per-field metrics including dwell time, correction rate, and abandonment rate. " +
-            "Use this to identify problematic form fields in checkout, signup, or other forms.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .describe("Page path containing the form to analyze (required)"),
-        }),
-    }, async ({ page_path }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/forms/friction", {
-            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/getIssues.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_issues tool
- *
- * Returns detected UX issues.
- */
-export declare function registerGetIssues(server: any): void;

package/dist/tools/getIssues.js

@@ -1,82 +0,0 @@
-/**
- * get_issues tool
- *
- * Returns detected UX issues.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-const VALID_CATEGORIES = [
-    "code_error",
-    "dead_click",
-    "rage_click",
-    "ux_friction",
-    "performance",
-    "form_issue",
-    "behavioral_anomaly",
-    "structural_issue",
-];
-const VALID_SEVERITIES = ["critical", "high", "medium", "low", "info"];
-const VALID_STATUSES = [
-    "pending",
-    "active",
-    "escalated",
-    "resolved",
-    "dismissed",
-    "expired",
-];
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetIssues(server) {
-    server.registerTool("get_issues", {
-        description: "Get detected UX issues. Issues are automatically detected from session recordings and include rage clicks, dead clicks, form issues, and behavioral anomalies.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Filter issues to a specific page path"),
-            category: z
-                .enum(VALID_CATEGORIES)
-                .optional()
-                .describe("Filter by issue category"),
-            severity: z
-                .enum(VALID_SEVERITIES)
-                .optional()
-                .describe("Filter by severity level"),
-            status: z
-                .enum(VALID_STATUSES)
-                .optional()
-                .default("active")
-                .describe("Filter by status (default: active)"),
-            limit: z
-                .number()
-                .optional()
-                .default(20)
-                .describe("Maximum number of issues to return (default: 20)"),
-        }),
-    }, async ({ page_path, category, severity, status, limit, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/issues", {
-            page_path,
-            category,
-            severity,
-            status: status ?? "active",
-            limit: limit ?? 20,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getJourneyPatterns.d.ts

@@ -1,7 +0,0 @@
-/**
- * get_journey_patterns tool
- *
- * Discovers navigation patterns across sessions.
- * Thin proxy to external-api /flows/patterns endpoint.
- */
-export declare function registerGetJourneyPatterns(server: any): void;

package/dist/tools/getJourneyPatterns.js

@@ -1,50 +0,0 @@
-/**
- * get_journey_patterns tool
- *
- * Discovers navigation patterns across sessions.
- * Thin proxy to external-api /flows/patterns endpoint.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetJourneyPatterns(server) {
-    server.registerTool("get_journey_patterns", {
-        description: "Discover navigation patterns across sessions. Returns top page transitions, " +
-            "backtrack hotspots (pages users return to), and dropoff pages (where sessions end). " +
-            "Use this to understand organic user navigation.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Filter to transitions involving this page (e.g., /pricing)"),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to analyze (default: 7)"),
-        }),
-    }, async ({ page_path, days }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/flows/patterns", {
-            page_path,
-            days: days ?? 7,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getPageMetrics.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_page_metrics tool
- *
- * Returns aggregated behavioral metrics for a specific page or all pages.
- */
-export declare function registerGetPageMetrics(server: any): void;

package/dist/tools/getPageMetrics.js

@@ -1,47 +0,0 @@
-/**
- * get_page_metrics tool
- *
- * Returns aggregated behavioral metrics for a specific page or all pages.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetPageMetrics(server) {
-    server.registerTool("get_page_metrics", {
-        description: "Get aggregated behavioral metrics for a page. Returns frustration, confusion, confidence, energy scores, and health score. If page_path is omitted, returns metrics for all pages.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Page path to get metrics for (e.g., /checkout). Omit to get all pages."),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to look back (default: 7)"),
-        }),
-    }, async ({ page_path, days }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/pages", {
-            page_path,
-            days,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getPageTrends.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_page_trends tool
- *
- * Returns daily behavioral trends for a page.
- */
-export declare function registerGetPageTrends(server: any): void;

package/dist/tools/getPageTrends.js

@@ -1,46 +0,0 @@
-/**
- * get_page_trends tool
- *
- * Returns daily behavioral trends for a page.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetPageTrends(server) {
-    server.registerTool("get_page_trends", {
-        description: "Get daily behavioral trends for a page. Shows how frustration, confusion, and confidence change over time.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .describe("Page path to analyze (e.g., /checkout)"),
-            days: z
-                .number()
-                .optional()
-                .default(14)
-                .describe("Number of days to look back (default: 14)"),
-        }),
-    }, async ({ page_path, days }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/trends", {
-            page_path,
-            days: days ?? 14,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getSessionDetails.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_session_details tool
- *
- * Returns behavioral timeline for one or more sessions.
- */
-export declare function registerGetSessionDetails(server: any): void;

package/dist/tools/getSessionDetails.js

@@ -1,70 +0,0 @@
-/**
- * get_session_details tool
- *
- * Returns behavioral timeline for one or more sessions.
- */
-import { z } from "zod";
-import { apiGet, apiPost, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetSessionDetails(server) {
-    server.registerTool("get_session_details", {
-        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: z.object({
-            session_id: z
-                .string()
-                .optional()
-                .describe("Single session ID to get details for"),
-            session_ids: z
-                .array(z.string())
-                .max(20)
-                .optional()
-                .describe("Array of session IDs to get details for (max 20)"),
-        }),
-    }, async ({ session_id, session_ids, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (!session_id && (!session_ids || session_ids.length === 0)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: "Either session_id or session_ids must be provided",
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (session_id && !session_ids) {
-            const { data, error } = await apiGet(`/sessions/${session_id}`);
-            if (error) {
-                return {
-                    content: [{ type: "text", text: JSON.stringify({ error }) }],
-                    isError: true,
-                };
-            }
-            return { content: [{ type: "text", text: JSON.stringify(data) }] };
-        }
-        const ids = session_ids ?? [session_id];
-        const { data, error } = await apiPost("/sessions/details", {
-            session_ids: ids,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getSessionPages.d.ts

@@ -1,7 +0,0 @@
-/**
- * get_session_pages tool
- *
- * Returns the pages visited within one or more sessions.
- * Thin proxy to external-api /sessions/:id/pages and /sessions/pages endpoints.
- */
-export declare function registerGetSessionPages(server: any): void;

package/dist/tools/getSessionPages.js

@@ -1,74 +0,0 @@
-/**
- * get_session_pages tool
- *
- * Returns the pages visited within one or more sessions.
- * Thin proxy to external-api /sessions/:id/pages and /sessions/pages endpoints.
- */
-import { z } from "zod";
-import { apiGet, apiPost, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetSessionPages(server) {
-    server.registerTool("get_session_pages", {
-        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: z.object({
-            session_id: z
-                .string()
-                .optional()
-                .describe("Single session ID to get pages for"),
-            session_ids: z
-                .array(z.string())
-                .max(20)
-                .optional()
-                .describe("Array of session IDs to get pages for (max 20)"),
-        }),
-    }, async ({ session_id, session_ids, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (!session_id && (!session_ids || session_ids.length === 0)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: "Either session_id or session_ids must be provided",
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (session_id && !session_ids) {
-            const { data, error } = await apiGet(`/sessions/${session_id}/pages`);
-            if (error) {
-                return {
-                    content: [{ type: "text", text: JSON.stringify({ error }) }],
-                    isError: true,
-                };
-            }
-            return { content: [{ type: "text", text: JSON.stringify(data) }] };
-        }
-        const ids = session_ids ?? [session_id];
-        const { data, error } = await apiPost("/sessions/pages", {
-            session_ids: ids,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getUxHealthReport.d.ts

@@ -1,7 +0,0 @@
-/**
- * get_ux_health_report tool
- *
- * Returns a comprehensive UX health report for the website or a specific page.
- * Thin proxy to external-api /health-report endpoint.
- */
-export declare function registerGetUxHealthReport(server: any): void;

package/dist/tools/getUxHealthReport.js

@@ -1,50 +0,0 @@
-/**
- * get_ux_health_report tool
- *
- * Returns a comprehensive UX health report for the website or a specific page.
- * Thin proxy to external-api /health-report endpoint.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetUxHealthReport(server) {
-    server.registerTool("get_ux_health_report", {
-        description: "Get a comprehensive UX health report combining page metrics, issues, and anomalies. " +
-            "Returns overall health score, per-page breakdown, active issues, and frustration spikes. " +
-            "Use this as a starting point to understand overall UX state before diving deeper.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Focus on a specific page (omit for site-wide report)"),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to analyze (default: 7)"),
-        }),
-    }, async ({ page_path, days }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/health-report", {
-            page_path,
-            days: days ?? 7,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/improvementRun.d.ts

@@ -1,6 +0,0 @@
-/**
- * Improvement Run tools for tracking self-improvement workflow executions.
- *
- * Provides run registration, phase updates, action recording, and run listing.
- */
-export declare function registerImprovementRunTools(server: any): void;