@recapt/mcp 0.0.18-beta → 0.0.20-beta

package/dist/tools/remediation.js

@@ -1,223 +0,0 @@
-/**
- * Remediation tools for self-improvement workflow.
- *
- * Provides fix proposal, deployment confirmation, evaluation, and history tracking.
- */
-import { z } from "zod";
-import { apiGet, apiPost, apiPatch, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerRemediationTools(server) {
-    server.registerTool("propose_fix", {
-        description: "Propose a fix for an issue. Creates a remediation record with baseline metrics for later evaluation. Include detailed diagnosis and code suggestions when possible.",
-        inputSchema: z.object({
-            issue_id: z.string().describe("The ID of the issue to fix"),
-            diagnosis: z
-                .string()
-                .describe("Detailed analysis of the root cause of the issue"),
-            proposed_fix: z
-                .string()
-                .describe("Description of the proposed fix and how it addresses the root cause"),
-            code_snippet: z
-                .string()
-                .optional()
-                .describe("Suggested code changes (if applicable)"),
-            affected_files: z
-                .array(z.string())
-                .optional()
-                .describe("List of files that need to be modified"),
-            confidence: z
-                .number()
-                .min(0)
-                .max(1)
-                .describe("Confidence level in the fix (0-1). Use <0.7 when uncertain."),
-        }),
-    }, async ({ issue_id, diagnosis, proposed_fix, code_snippet, affected_files, confidence, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost("/remediations", {
-            issue_id,
-            diagnosis,
-            proposed_fix,
-            code_snippet,
-            affected_files,
-            confidence,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("list_pending_fixes", {
-        description: "List all proposed fixes awaiting deployment. Use to show the user what fixes are ready to be deployed.",
-        inputSchema: z.object({}),
-    }, async () => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/remediations/pending");
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("list_remediations", {
-        description: "List remediation records with optional filters. Use to review past and current fix attempts.",
-        inputSchema: z.object({
-            status: z
-                .enum([
-                "proposed",
-                "deployed",
-                "evaluating",
-                "succeeded",
-                "failed",
-                "reverted",
-            ])
-                .optional()
-                .describe("Filter by remediation status"),
-            issue_id: z.string().optional().describe("Filter by issue ID"),
-            page_path: z.string().optional().describe("Filter by page path"),
-            limit: z
-                .number()
-                .optional()
-                .default(20)
-                .describe("Maximum number of results (default: 20)"),
-        }),
-    }, async ({ status, issue_id, page_path, limit, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/remediations", {
-            status,
-            issue_id,
-            page_path,
-            limit: limit ?? 20,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("confirm_deployment", {
-        description: "Confirm that a proposed fix has been deployed to production. This starts the evaluation timer. Call this when the user confirms they have deployed the fix.",
-        inputSchema: z.object({
-            remediation_id: z
-                .string()
-                .describe("The ID of the remediation to mark as deployed"),
-        }),
-    }, async ({ remediation_id }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPatch(`/remediations/${remediation_id}/deploy`, {});
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("evaluate_fix", {
-        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: z.object({
-            remediation_id: z
-                .string()
-                .describe("The ID of the remediation to evaluate"),
-            min_hours: z
-                .number()
-                .optional()
-                .default(24)
-                .describe("Minimum hours since deployment required (default: 24)"),
-        }),
-    }, async ({ remediation_id, min_hours, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost(`/remediations/${remediation_id}/evaluate`, { min_hours: min_hours ?? 24 });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("get_fix_history", {
-        description: "Get the full remediation history for an issue. Shows all fix attempts, their outcomes, and current status. Use before proposing a new fix to learn from past attempts.",
-        inputSchema: z.object({
-            issue_id: z
-                .string()
-                .describe("The ID of the issue to get fix history for"),
-        }),
-    }, async ({ issue_id }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet(`/remediations/history/${issue_id}`);
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/scanSite.d.ts

@@ -1,6 +0,0 @@
-/**
- * scan_site tool
- *
- * One-shot site health scan across all pages.
- */
-export declare function registerScanSite(server: any): void;

package/dist/tools/scanSite.js

@@ -1,51 +0,0 @@
-/**
- * scan_site tool
- *
- * One-shot site health scan across all pages.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerScanSite(server) {
-    server.registerTool("scan_site", {
-        description: "One-shot site health scan. Lists all pages and computes aggregate metrics " +
-            "for the top-N pages (default 10) sorted by session count. Returns a ranked " +
-            "table with frustration and health grade per page. " +
-            "Use this as the FIRST tool when the user asks a broad question without naming a specific page.",
-        inputSchema: z.object({
-            top_n: z
-                .number()
-                .optional()
-                .default(10)
-                .describe("Number of top pages to analyze (default 10)"),
-            offset: z
-                .number()
-                .optional()
-                .default(0)
-                .describe("Skip first N pages for pagination (default 0)"),
-        }),
-    }, async ({ top_n, offset }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/site/overview", {
-            top_n: top_n ?? 10,
-            offset: offset ?? 0,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/searchSessions.d.ts

@@ -1,6 +0,0 @@
-/**
- * search_sessions tool
- *
- * Search sessions by natural language query using vector search.
- */
-export declare function registerSearchSessions(server: any): void;

package/dist/tools/searchSessions.js

@@ -1,51 +0,0 @@
-/**
- * search_sessions tool
- *
- * Search sessions by natural language query using vector search.
- */
-import { z } from "zod";
-import { apiPost, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerSearchSessions(server) {
-    server.registerTool("search_sessions", {
-        description: 'Search sessions by natural language query. Examples: "frustrated users on checkout", "rage clicks on pricing page", "confused users who abandoned cart".',
-        inputSchema: z.object({
-            query: z
-                .string()
-                .describe("Natural language search query describing the sessions you want to find"),
-            page_path: z
-                .string()
-                .optional()
-                .describe("Optional: filter to a specific page path"),
-            limit: z
-                .number()
-                .optional()
-                .default(10)
-                .describe("Maximum number of sessions to return (default: 10)"),
-        }),
-    }, async ({ query, page_path, limit, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost("/sessions/search", {
-            query,
-            page_path,
-            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/triage.d.ts

@@ -1,6 +0,0 @@
-/**
- * Triage tools for self-improvement workflow.
- *
- * Provides issue dismissal, marking intended behavior, and issue history.
- */
-export declare function registerTriageTools(server: any): void;

package/dist/tools/triage.js

@@ -1,114 +0,0 @@
-/**
- * Triage tools for self-improvement workflow.
- *
- * Provides issue dismissal, marking intended behavior, and issue history.
- */
-import { z } from "zod";
-import { apiGet, apiPost, isApiConfigured } from "../api/client.js";
-const DISMISS_REASONS = [
-    "stale",
-    "intended",
-    "duplicate",
-    "false_positive",
-];
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerTriageTools(server) {
-    server.registerTool("dismiss_issue", {
-        description: "Dismiss an issue as a false positive. Creates site knowledge to prevent re-flagging. Use when an issue is stale, intended behavior, a duplicate, or a false positive. Always confirm with user before dismissing.",
-        inputSchema: z.object({
-            issue_id: z.string().describe("The ID of the issue to dismiss"),
-            reason: z
-                .enum(DISMISS_REASONS)
-                .describe("Reason for dismissal: stale, intended, duplicate, or false_positive"),
-            explanation: z
-                .string()
-                .describe("Detailed explanation of why this issue is being dismissed"),
-            create_knowledge: z
-                .boolean()
-                .optional()
-                .default(true)
-                .describe("Whether to create site knowledge entry (default: true)"),
-        }),
-    }, async ({ issue_id, reason, explanation, create_knowledge, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost(`/issues/${issue_id}/dismiss`, {
-            reason,
-            explanation,
-            create_knowledge: create_knowledge ?? true,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("mark_intended_behavior", {
-        description: "Mark an issue as intended behavior. This is a shortcut for dismissing with reason 'intended' and always creates site knowledge. Use when the detected behavior is by design (e.g., disabled button clicks are expected).",
-        inputSchema: z.object({
-            issue_id: z
-                .string()
-                .describe("The ID of the issue to mark as intended"),
-            explanation: z
-                .string()
-                .describe("Explanation of why this behavior is intended"),
-        }),
-    }, async ({ issue_id, explanation, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost(`/issues/${issue_id}/mark-intended`, { explanation });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("get_issue_history", {
-        description: "Get the full history of an issue including status changes, remediation attempts, and outcomes. Use to understand past fix attempts before proposing new ones.",
-        inputSchema: z.object({
-            issue_id: z.string().describe("The ID of the issue to get history for"),
-        }),
-    }, async ({ issue_id }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet(`/issues/${issue_id}/history`);
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/triageSessions.d.ts

@@ -1,8 +0,0 @@
-/**
- * triage_sessions tool
- *
- * Automatically triages sessions to find compromised user experiences.
- * Analyzes user comments, frustration signals, rage clicks, and console errors.
- * Thin proxy to external-api /sessions/triage endpoint.
- */
-export declare function registerTriageSessions(server: any): void;

package/dist/tools/triageSessions.js

@@ -1,197 +0,0 @@
-/**
- * triage_sessions tool
- *
- * Automatically triages sessions to find compromised user experiences.
- * Analyzes user comments, frustration signals, rage clicks, and console errors.
- * Thin proxy to external-api /sessions/triage endpoint.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-function formatDuration(seconds) {
-    if (!seconds)
-        return "unknown";
-    if (seconds < 60)
-        return `${seconds}s`;
-    if (seconds < 3600)
-        return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
-    const hours = Math.floor(seconds / 3600);
-    const mins = Math.floor((seconds % 3600) / 60);
-    return `${hours}h ${mins}m`;
-}
-function getActionReason(session) {
-    const reasons = [];
-    if (session.user_comments.length > 0) {
-        reasons.push(`USER FEEDBACK: ${session.user_comments.length} comment(s) - "${session.user_comments[0].text.slice(0, 100)}${session.user_comments[0].text.length > 100 ? "..." : ""}"`);
-    }
-    if (session.behavioral_signals.frustration >= 0.5) {
-        reasons.push(`HIGH FRUSTRATION: ${(session.behavioral_signals.frustration * 100).toFixed(0)}%`);
-    }
-    else if (session.behavioral_signals.frustration >= 0.3) {
-        reasons.push(`MODERATE FRUSTRATION: ${(session.behavioral_signals.frustration * 100).toFixed(0)}%`);
-    }
-    if (session.behavioral_signals.has_rage_clicks) {
-        reasons.push("RAGE CLICKS detected");
-    }
-    if (session.console_errors.length > 0) {
-        const errorCount = session.console_errors.reduce((sum, e) => sum + e.count, 0);
-        reasons.push(`JS ERRORS: ${errorCount} error(s) - "${session.console_errors[0].message.slice(0, 80)}..."`);
-    }
-    if (!session.behavioral_signals.has_behavioral_data) {
-        reasons.push("NOTE: No behavioral analysis data available for this session");
-    }
-    if (reasons.length === 0) {
-        reasons.push("Low severity - no major issues detected");
-    }
-    return reasons.join("\n  - ");
-}
-function formatTriageOutput(data) {
-    const lines = [];
-    // Summary
-    lines.push("# SESSION TRIAGE RESULTS\n");
-    lines.push(`Total sessions analyzed: ${data.summary.total_sessions}`);
-    lines.push(`Sessions with issues: ${data.summary.flagged_sessions}`);
-    lines.push(`Sessions with user comments: ${data.summary.sessions_with_comments}`);
-    if (data.sessions.length === 0) {
-        lines.push("\nNo sessions require attention.");
-        return lines.join("\n");
-    }
-    // Group by severity
-    const critical = data.sessions.filter((s) => s.severity === "critical");
-    const high = data.sessions.filter((s) => s.severity === "high");
-    const medium = data.sessions.filter((s) => s.severity === "medium");
-    const low = data.sessions.filter((s) => s.severity === "low");
-    lines.push("\n## PRIORITY SUMMARY");
-    lines.push(`- CRITICAL: ${critical.length} session(s) - investigate immediately`);
-    lines.push(`- HIGH: ${high.length} session(s) - investigate soon`);
-    lines.push(`- MEDIUM: ${medium.length} session(s) - review when possible`);
-    lines.push(`- LOW: ${low.length} session(s) - likely okay`);
-    // Action recommendations
-    lines.push("\n## RECOMMENDED ACTIONS\n");
-    if (critical.length > 0) {
-        lines.push("### CRITICAL - Investigate Immediately\n");
-        for (const s of critical) {
-            lines.push(`**Session ${s.session_id.slice(-8)}** (${formatDuration(s.duration_seconds)}, ${s.device})`);
-            lines.push(`  Replay: ${s.replay_url}`);
-            lines.push(`  Score: ${(s.triage_score * 100).toFixed(0)}%`);
-            lines.push(`  Why: ${getActionReason(s)}`);
-            if (s.pages_visited.length > 0) {
-                lines.push(`  Pages: ${s.pages_visited.slice(0, 3).join(", ")}${s.pages_visited.length > 3 ? ` (+${s.pages_visited.length - 3} more)` : ""}`);
-            }
-            lines.push("");
-        }
-    }
-    if (high.length > 0) {
-        lines.push("### HIGH - Investigate Soon\n");
-        for (const s of high) {
-            lines.push(`**Session ${s.session_id.slice(-8)}** (${formatDuration(s.duration_seconds)}, ${s.device})`);
-            lines.push(`  Replay: ${s.replay_url}`);
-            lines.push(`  Score: ${(s.triage_score * 100).toFixed(0)}%`);
-            lines.push(`  Why: ${getActionReason(s)}`);
-            if (s.pages_visited.length > 0) {
-                lines.push(`  Pages: ${s.pages_visited.slice(0, 3).join(", ")}${s.pages_visited.length > 3 ? ` (+${s.pages_visited.length - 3} more)` : ""}`);
-            }
-            lines.push("");
-        }
-    }
-    if (medium.length > 0) {
-        lines.push("### MEDIUM - Review When Possible\n");
-        for (const s of medium) {
-            lines.push(`- Session ${s.session_id.slice(-8)} (${formatDuration(s.duration_seconds)}): ${getActionReason(s).split("\n")[0]}`);
-            lines.push(`  ${s.replay_url}`);
-        }
-        lines.push("");
-    }
-    if (low.length > 0) {
-        lines.push("### LOW - Likely Okay\n");
-        lines.push(`${low.length} session(s) with minor or no issues detected.`);
-        if (low.length <= 3) {
-            for (const s of low) {
-                lines.push(`- Session ${s.session_id.slice(-8)}: ${s.replay_url}`);
-            }
-        }
-        lines.push("");
-    }
-    // Raw data for reference (compact)
-    lines.push("\n## RAW DATA (for detailed analysis)\n");
-    lines.push("```json");
-    lines.push(JSON.stringify({
-        summary: data.summary,
-        sessions: data.sessions.map((s) => ({
-            id: s.session_id,
-            severity: s.severity,
-            score: s.triage_score,
-            url: s.replay_url,
-            comments: s.user_comments.length,
-            frustration: s.behavioral_signals.frustration,
-            rage_clicks: s.behavioral_signals.has_rage_clicks,
-            errors: s.console_errors.length,
-            has_data: s.behavioral_signals.has_behavioral_data,
-        })),
-    }, null, 2));
-    lines.push("```");
-    return lines.join("\n");
-}
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerTriageSessions(server) {
-    server.registerTool("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: z.object({
-            session_ids: z
-                .array(z.string())
-                .optional()
-                .describe("Triage specific sessions by ID. If provided, other filters are ignored."),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Lookback period in days (default: 7). Ignored if session_ids is provided."),
-            page_path: z
-                .string()
-                .optional()
-                .describe("Filter to sessions that visited a specific page"),
-            min_severity: z
-                .enum(["critical", "high", "medium", "low"])
-                .optional()
-                .describe("Minimum severity to include in results"),
-            limit: z
-                .number()
-                .optional()
-                .default(20)
-                .describe("Maximum sessions to return (default: 20, max: 100)"),
-        }),
-    }, async ({ session_ids, days, page_path, min_severity, limit, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/sessions/triage", {
-            session_ids: session_ids?.join(","),
-            days: session_ids?.length ? undefined : (days ?? 7),
-            page_path: session_ids?.length ? undefined : page_path,
-            min_severity,
-            limit: session_ids?.length ? session_ids.length : (limit ?? 20),
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        // Format output for better LLM comprehension
-        const formattedOutput = formatTriageOutput(data);
-        return { content: [{ type: "text", text: formattedOutput }] };
-    });
-}

package/dist/tools/upgradeOptions.d.ts

@@ -1,7 +0,0 @@
-/**
- * get_upgrade_options tool
- *
- * Provides upgrade information for AI agents to communicate upgrade paths to users.
- * Part of the "Diagnose Free, Solve Paid" pattern.
- */
-export declare function registerGetUpgradeOptions(server: any): void;