@recapt/mcp 0.0.19-beta → 0.0.20

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;

package/dist/tools/upgradeOptions.js

@@ -1,67 +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.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetUpgradeOptions(server) {
-    server.registerTool("get_upgrade_options", {
-        description: "Get available upgrade options for the current plan. Use this when a user hits a " +
-            "feature limit or when you need to explain what's available on higher tiers. " +
-            "Returns the current plan, available upgrades with their features and benefits, " +
-            "and a direct link to the billing page. Use this to help users understand the " +
-            "value of upgrading when they encounter gated features.",
-        inputSchema: z.object({}),
-    }, async () => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/upgrade-options");
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        // Format output for better LLM comprehension
-        const output = formatUpgradeOptions(data);
-        return { content: [{ type: "text", text: output }] };
-    });
-}
-function formatUpgradeOptions(data) {
-    const lines = [];
-    lines.push("# UPGRADE OPTIONS\n");
-    lines.push(`**Current Plan:** ${data.currentPlan.name} (${data.currentPlan.tag})\n`);
-    if (data.availableUpgrades.length === 0) {
-        lines.push("You're on the highest tier! No upgrades available.");
-        return lines.join("\n");
-    }
-    lines.push("## Available Upgrades\n");
-    for (const upgrade of data.availableUpgrades) {
-        lines.push(`### ${upgrade.name}\n`);
-        lines.push("**Features:**");
-        for (const feature of upgrade.features) {
-            lines.push(`- ${feature}`);
-        }
-        lines.push("");
-        lines.push("**Benefits:**");
-        for (const benefit of upgrade.benefits) {
-            lines.push(`- ${benefit}`);
-        }
-        lines.push("");
-    }
-    lines.push("---");
-    lines.push(`**Upgrade now:** ${data.upgradeUrl}`);
-    return lines.join("\n");
-}