@recapt/mcp 0.0.18-beta → 0.0.20-beta

package/dist/cli/utils/ide-config.js

@@ -1,294 +0,0 @@
-/**
- * IDE Configuration Utilities
- *
- * Handles detection and configuration of MCP servers across different AI IDEs.
- */
-import fs from "fs";
-import path from "path";
-import os from "os";
-export const IDE_CONFIGS = [
-    {
-        name: "Cursor",
-        globalPath: "~/.cursor/mcp.json",
-        projectPath: ".cursor/mcp.json",
-        rootKey: "mcpServers",
-        format: "json",
-    },
-    {
-        name: "Claude Code",
-        globalPath: "~/.claude.json",
-        projectPath: ".mcp.json",
-        rootKey: "mcpServers",
-        format: "json",
-    },
-    {
-        name: "Windsurf",
-        globalPath: "~/.windsurf/mcp.json",
-        projectPath: ".windsurf/mcp.json",
-        rootKey: "mcpServers",
-        format: "json",
-    },
-    {
-        name: "VS Code",
-        globalPath: null,
-        projectPath: ".vscode/mcp.json",
-        rootKey: "servers",
-        format: "json",
-    },
-    {
-        name: "Codex CLI",
-        globalPath: "~/.codex/config.toml",
-        projectPath: ".codex/config.toml",
-        rootKey: "mcp_servers",
-        format: "toml",
-    },
-    {
-        name: "Zed",
-        globalPath: "~/.config/zed/settings.json",
-        projectPath: ".zed/settings.json",
-        rootKey: "context_servers",
-        format: "json",
-    },
-    {
-        name: "GitHub Copilot",
-        globalPath: null,
-        projectPath: ".github/mcp.json",
-        rootKey: "servers",
-        format: "json",
-    },
-];
-function expandPath(p) {
-    if (p.startsWith("~/")) {
-        return path.join(os.homedir(), p.slice(2));
-    }
-    return p;
-}
-function ideExists(config) {
-    if (!config.globalPath) {
-        return false;
-    }
-    const resolved = expandPath(config.globalPath);
-    const dir = path.dirname(resolved);
-    if (config.name === "Claude Code") {
-        return (fs.existsSync(resolved) ||
-            fs.existsSync(path.join(os.homedir(), ".claude")));
-    }
-    if (config.name === "Zed") {
-        return fs.existsSync(path.join(os.homedir(), ".config", "zed"));
-    }
-    if (config.name === "Codex CLI") {
-        return fs.existsSync(path.join(os.homedir(), ".codex"));
-    }
-    return fs.existsSync(dir);
-}
-export function detectInstalledIdes() {
-    return IDE_CONFIGS.map((config) => ({
-        config,
-        detected: ideExists(config),
-        globalPathResolved: config.globalPath
-            ? expandPath(config.globalPath)
-            : null,
-    }));
-}
-function getRecaptServerConfig(secretKey) {
-    return {
-        type: "stdio",
-        command: "npx",
-        args: ["-y", "@recapt/mcp@latest"],
-        env: {
-            RECAPT_SECRET_KEY: secretKey,
-        },
-    };
-}
-export function readIdeConfig(configPath, format = "json") {
-    const resolved = expandPath(configPath);
-    if (!fs.existsSync(resolved)) {
-        return {};
-    }
-    try {
-        const content = fs.readFileSync(resolved, "utf-8");
-        if (format === "toml") {
-            return parseToml(content);
-        }
-        return JSON.parse(content);
-    }
-    catch {
-        return {};
-    }
-}
-function parseToml(content) {
-    const result = {};
-    let currentSection = "";
-    let currentSubSection = "";
-    for (const line of content.split("\n")) {
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith("#")) {
-            continue;
-        }
-        const sectionMatch = trimmed.match(/^\[([^\]]+)\]$/);
-        if (sectionMatch) {
-            const section = sectionMatch[1];
-            const parts = section.split(".");
-            if (parts.length === 1) {
-                currentSection = parts[0];
-                currentSubSection = "";
-                if (!result[currentSection]) {
-                    result[currentSection] = {};
-                }
-            }
-            else if (parts.length === 2) {
-                currentSection = parts[0];
-                currentSubSection = parts[1];
-                if (!result[currentSection]) {
-                    result[currentSection] = {};
-                }
-                const sectionObj = result[currentSection];
-                if (!sectionObj[currentSubSection]) {
-                    sectionObj[currentSubSection] = {};
-                }
-            }
-            continue;
-        }
-        const kvMatch = trimmed.match(/^(\w+)\s*=\s*(.+)$/);
-        if (kvMatch) {
-            const [, key, rawValue] = kvMatch;
-            const value = parseTomlValue(rawValue);
-            if (currentSubSection) {
-                const sectionObj = result[currentSection];
-                const subSectionObj = sectionObj[currentSubSection];
-                subSectionObj[key] = value;
-            }
-            else if (currentSection) {
-                const sectionObj = result[currentSection];
-                sectionObj[key] = value;
-            }
-            else {
-                result[key] = value;
-            }
-        }
-    }
-    return result;
-}
-function parseTomlValue(raw) {
-    const trimmed = raw.trim();
-    if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
-        return trimmed.slice(1, -1);
-    }
-    if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
-        return trimmed.slice(1, -1);
-    }
-    if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
-        const inner = trimmed.slice(1, -1);
-        if (!inner.trim())
-            return [];
-        return inner.split(",").map((item) => {
-            const t = item.trim();
-            if ((t.startsWith('"') && t.endsWith('"')) ||
-                (t.startsWith("'") && t.endsWith("'"))) {
-                return t.slice(1, -1);
-            }
-            return t;
-        });
-    }
-    if (trimmed === "true")
-        return true;
-    if (trimmed === "false")
-        return false;
-    const num = Number(trimmed);
-    if (!isNaN(num))
-        return num;
-    return trimmed;
-}
-function stringifyToml(obj, prefix = "") {
-    const lines = [];
-    for (const [key, value] of Object.entries(obj)) {
-        if (value === null || value === undefined)
-            continue;
-        if (typeof value === "object" && !Array.isArray(value)) {
-            const sectionKey = prefix ? `${prefix}.${key}` : key;
-            const nested = value;
-            const hasNestedObjects = Object.values(nested).some((v) => typeof v === "object" && !Array.isArray(v));
-            if (hasNestedObjects) {
-                for (const [subKey, subValue] of Object.entries(nested)) {
-                    if (typeof subValue === "object" && !Array.isArray(subValue)) {
-                        lines.push(`[${sectionKey}.${subKey}]`);
-                        for (const [k, v] of Object.entries(subValue)) {
-                            lines.push(`${k} = ${tomlValue(v)}`);
-                        }
-                        lines.push("");
-                    }
-                }
-            }
-            else {
-                lines.push(`[${sectionKey}]`);
-                for (const [k, v] of Object.entries(nested)) {
-                    lines.push(`${k} = ${tomlValue(v)}`);
-                }
-                lines.push("");
-            }
-        }
-    }
-    return lines.join("\n");
-}
-function tomlValue(value) {
-    if (typeof value === "string") {
-        return `"${value}"`;
-    }
-    if (Array.isArray(value)) {
-        return `[${value.map((v) => (typeof v === "string" ? `"${v}"` : String(v))).join(", ")}]`;
-    }
-    return String(value);
-}
-export function writeIdeConfig(configPath, config, format = "json") {
-    const resolved = expandPath(configPath);
-    const dir = path.dirname(resolved);
-    if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-    }
-    if (format === "toml") {
-        fs.writeFileSync(resolved, stringifyToml(config));
-    }
-    else {
-        fs.writeFileSync(resolved, JSON.stringify(config, null, 2) + "\n");
-    }
-}
-export function addRecaptToIdeConfig(ide, secretKey, useGlobal = true) {
-    const configPath = useGlobal && ide.globalPath ? ide.globalPath : ide.projectPath;
-    const resolved = expandPath(configPath);
-    const existing = readIdeConfig(configPath, ide.format);
-    const rootKey = ide.rootKey;
-    const servers = existing[rootKey] || {};
-    servers["recapt"] = getRecaptServerConfig(secretKey);
-    existing[rootKey] = servers;
-    writeIdeConfig(configPath, existing, ide.format);
-    return resolved;
-}
-export function removeRecaptFromIdeConfig(ide, useGlobal = true) {
-    const configPath = useGlobal && ide.globalPath ? ide.globalPath : ide.projectPath;
-    const resolved = expandPath(configPath);
-    if (!fs.existsSync(resolved)) {
-        return false;
-    }
-    const existing = readIdeConfig(configPath, ide.format);
-    const rootKey = ide.rootKey;
-    const servers = existing[rootKey] || {};
-    if (!("recapt" in servers)) {
-        return false;
-    }
-    delete servers["recapt"];
-    existing[rootKey] = servers;
-    writeIdeConfig(configPath, existing, ide.format);
-    return true;
-}
-export function isRecaptConfigured(ide) {
-    if (ide.globalPath) {
-        const globalConfig = readIdeConfig(ide.globalPath, ide.format);
-        const servers = globalConfig[ide.rootKey] || {};
-        if ("recapt" in servers) {
-            return true;
-        }
-    }
-    const projectConfig = readIdeConfig(ide.projectPath, ide.format);
-    const servers = projectConfig[ide.rootKey] || {};
-    return "recapt" in servers;
-}

package/dist/cli/utils/prompts.d.ts

@@ -1,22 +0,0 @@
-/**
- * Interactive Prompts
- *
- * Arrow-key navigable prompts for CLI interactions using @inquirer/prompts.
- */
-export declare function confirm(message: string, defaultYes?: boolean): Promise<boolean>;
-export declare function input(message: string, defaultValue?: string): Promise<string>;
-export declare function secret(message: string): Promise<string>;
-export interface SelectOption<T = string> {
-    label: string;
-    value: T;
-    selected?: boolean;
-}
-export declare function multiSelect<T = string>(message: string, options: SelectOption<T>[]): Promise<T[]>;
-export declare function select<T = string>(message: string, options: SelectOption<T>[]): Promise<T | null>;
-export declare function print(message: string): void;
-export declare function success(message: string): void;
-export declare function error(message: string): void;
-export declare function info(message: string): void;
-export declare function warn(message: string): void;
-export declare function newline(): void;
-export declare function header(title: string): void;

package/dist/cli/utils/prompts.js

@@ -1,71 +0,0 @@
-/**
- * Interactive Prompts
- *
- * Arrow-key navigable prompts for CLI interactions using @inquirer/prompts.
- */
-import { confirm as inquirerConfirm, input as inquirerInput, password as inquirerPassword, select as inquirerSelect, checkbox as inquirerCheckbox, } from "@inquirer/prompts";
-export async function confirm(message, defaultYes = true) {
-    return inquirerConfirm({
-        message,
-        default: defaultYes,
-    });
-}
-export async function input(message, defaultValue) {
-    return inquirerInput({
-        message,
-        default: defaultValue,
-    });
-}
-export async function secret(message) {
-    const value = await inquirerPassword({
-        message,
-        mask: "*",
-    });
-    return value.trim();
-}
-export async function multiSelect(message, options) {
-    return inquirerCheckbox({
-        message,
-        choices: options.map((opt) => ({
-            name: opt.label,
-            value: opt.value,
-            checked: opt.selected ?? false,
-        })),
-    });
-}
-export async function select(message, options) {
-    if (options.length === 0) {
-        return null;
-    }
-    return inquirerSelect({
-        message,
-        choices: options.map((opt) => ({
-            name: opt.label,
-            value: opt.value,
-        })),
-    });
-}
-export function print(message) {
-    console.log(message);
-}
-export function success(message) {
-    console.log(`✓ ${message}`);
-}
-export function error(message) {
-    console.error(`✗ ${message}`);
-}
-export function info(message) {
-    console.log(`ℹ ${message}`);
-}
-export function warn(message) {
-    console.log(`⚠ ${message}`);
-}
-export function newline() {
-    console.log();
-}
-export function header(title) {
-    console.log();
-    console.log(title);
-    console.log("=".repeat(title.length));
-    console.log();
-}

package/dist/tools/analyzeFlow.d.ts

@@ -1,7 +0,0 @@
-/**
- * analyze_flow tool
- *
- * Analyzes user navigation flows between pages.
- * Thin proxy to external-api /flows/analyze endpoint.
- */
-export declare function registerAnalyzeFlow(server: any): void;

package/dist/tools/analyzeFlow.js

@@ -1,68 +0,0 @@
-/**
- * analyze_flow tool
- *
- * Analyzes user navigation flows between pages.
- * Thin proxy to external-api /flows/analyze endpoint.
- */
-import { z } from "zod";
-import { apiPost, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerAnalyzeFlow(server) {
-    server.registerTool("analyze_flow", {
-        description: "Analyze user navigation flows between pages. Returns paths with steps, " +
-            "behavioral metrics (frustration, confusion), success rates, and bottlenecks. " +
-            "Use this to understand how users navigate between specific pages.",
-        inputSchema: z.object({
-            start_page: z
-                .string()
-                .optional()
-                .describe("Starting page path (e.g., /pricing). Partial match supported."),
-            end_page: z
-                .string()
-                .optional()
-                .describe("Ending page path (e.g., /checkout). Partial match supported."),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to analyze (default: 7)"),
-        }),
-    }, async ({ start_page, end_page, days, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (!start_page && !end_page) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: "At least one of start_page or end_page is required",
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost("/flows/analyze", {
-            start_page,
-            end_page,
-            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/analyzeFunnel.d.ts

@@ -1,7 +0,0 @@
-/**
- * analyze_funnel tool
- *
- * Analyzes conversion funnels through a defined sequence of pages.
- * Thin proxy to external-api /flows/funnel endpoint.
- */
-export declare function registerAnalyzeFunnel(server: any): void;

package/dist/tools/analyzeFunnel.js

@@ -1,63 +0,0 @@
-/**
- * analyze_funnel tool
- *
- * Analyzes conversion funnels through a defined sequence of pages.
- * Thin proxy to external-api /flows/funnel endpoint.
- */
-import { z } from "zod";
-import { apiPost, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerAnalyzeFunnel(server) {
-    server.registerTool("analyze_funnel", {
-        description: "Analyze a conversion funnel through a sequence of pages. Returns per-step metrics " +
-            "(entered, converted, dropped, dwell time, frustration, confusion) and dropoff analysis " +
-            'showing where users exit. Supports wildcards: "/checkout*" matches all checkout pages.',
-        inputSchema: z.object({
-            steps: z
-                .array(z.string())
-                .min(2)
-                .describe('Ordered page paths forming the funnel (e.g., ["/cart", "/checkout", "/payment"])'),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to analyze (default: 7)"),
-        }),
-    }, async ({ steps, days }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (!steps || steps.length < 2) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: "At least 2 steps are required for funnel analysis",
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost("/flows/funnel", {
-            steps,
-            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/catalog/callTool.d.ts

@@ -1,22 +0,0 @@
-/**
- * Call Tool — Universal tool proxy for executing any tool by name.
- *
- * This tool allows the agent to invoke ANY tool by name without having
- * all tool descriptions in context. The agent discovers tools via search_tools,
- * then calls them through this proxy.
- *
- * Benefits:
- * - Minimal context: Only ~10 tools have descriptions in the prompt
- * - All 40+ analysis tools accessible on-demand
- * - Scales to any number of tools without context bloat
- */
-export type ToolHandler = (args: Record<string, unknown>) => Promise<{
-    content: Array<{
-        type: string;
-        text: string;
-    }>;
-    isError?: boolean;
-}>;
-export declare function registerToolHandler(name: string, handler: ToolHandler): void;
-export declare function getToolHandler(name: string): ToolHandler | undefined;
-export declare function registerCallTool(server: any): void;

package/dist/tools/catalog/callTool.js

@@ -1,92 +0,0 @@
-/**
- * Call Tool — Universal tool proxy for executing any tool by name.
- *
- * This tool allows the agent to invoke ANY tool by name without having
- * all tool descriptions in context. The agent discovers tools via search_tools,
- * then calls them through this proxy.
- *
- * Benefits:
- * - Minimal context: Only ~10 tools have descriptions in the prompt
- * - All 40+ analysis tools accessible on-demand
- * - Scales to any number of tools without context bloat
- */
-import { z } from "zod";
-import { getToolByName } from "./searchTools.js";
-const toolRegistry = new Map();
-export function registerToolHandler(name, handler) {
-    toolRegistry.set(name, handler);
-}
-export function getToolHandler(name) {
-    return toolRegistry.get(name);
-}
-const callToolSchema = z.object({
-    tool_name: z
-        .string()
-        .describe("The exact name of the tool to call (e.g., 'get_page_metrics', 'analyze_flow', 'compare_cohorts')"),
-    arguments: z
-        .record(z.string(), z.unknown())
-        .describe("The arguments to pass to the tool as a JSON object. Check the tool description from search_tools for required parameters."),
-});
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerCallTool(server) {
-    server.registerTool("call_tool", {
-        description: "Execute any analysis tool by name. Use search_tools first to discover available tools, " +
-            "then call them through this proxy. Pass the exact tool name and arguments as a JSON object. " +
-            "Example: call_tool({ tool_name: 'get_page_metrics', arguments: { page_path: '/checkout' } })",
-        inputSchema: callToolSchema,
-    }, async ({ tool_name, arguments: args }) => {
-        const handler = toolRegistry.get(tool_name);
-        if (!handler) {
-            const catalogEntry = getToolByName(tool_name);
-            if (catalogEntry) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({
-                                error: `Tool "${tool_name}" exists in catalog but is not registered. This may be a server configuration issue.`,
-                                tool_info: {
-                                    name: catalogEntry.name,
-                                    description: catalogEntry.description,
-                                    category: catalogEntry.category,
-                                },
-                            }),
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: `Unknown tool: ${tool_name}`,
-                            hint: "Use search_tools to discover available tools first.",
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        try {
-            return await handler(args);
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: `Tool execution failed: ${message}`,
-                            tool_name,
-                            arguments: args,
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-}

package/dist/tools/catalog/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * Tool Catalog — Registry and discovery for MCP tools.
- *
- * Exports:
- * - searchTools: Find tools by natural language query
- * - registerSearchTools: Register the search_tools MCP tool
- * - registerCallTool: Register the call_tool MCP tool
- * - registerToolHandler: Register a tool handler for call_tool to invoke
- */
-export { searchTools, getToolByName, getAllTools, registerSearchTools, type ToolEntry, } from "./searchTools.js";
-export { registerCallTool, registerToolHandler, getToolHandler, type ToolHandler, } from "./callTool.js";

package/dist/tools/catalog/index.js

@@ -1,11 +0,0 @@
-/**
- * Tool Catalog — Registry and discovery for MCP tools.
- *
- * Exports:
- * - searchTools: Find tools by natural language query
- * - registerSearchTools: Register the search_tools MCP tool
- * - registerCallTool: Register the call_tool MCP tool
- * - registerToolHandler: Register a tool handler for call_tool to invoke
- */
-export { searchTools, getToolByName, getAllTools, registerSearchTools, } from "./searchTools.js";
-export { registerCallTool, registerToolHandler, getToolHandler, } from "./callTool.js";