@recapt/mcp 0.0.19-beta → 0.0.20

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@recapt/mcp",
-  "version": "0.0.19-beta",
+  "version": "0.0.20",
   "description": "MCP exposing recapt behavioral intelligence to AI coding agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
   "scripts": {
-    "build": "npm run generate-catalog && tsc && cp src/tools/catalog/toolCatalog.json src/tools/catalog/anthropicToolCatalog.json dist/tools/catalog/",
+    "build": "npm run generate-catalog && tsup",
+    "build:tsc": "npm run generate-catalog && tsc && cp src/tools/catalog/toolCatalog.json src/tools/catalog/anthropicToolCatalog.json dist/tools/catalog/",
     "build:workflows": "tsx scripts/buildWorkflows.ts",
     "clean": "rimraf ./dist",
     "dev": "tsx --watch src/index.ts",
@@ -32,6 +33,7 @@
     "@inquirer/prompts": "^8.3.2",
     "@modelcontextprotocol/sdk": "^1.12.0",
     "commander": "^14.0.3",
+    "dotenv": "^17.2.2",
     "zod": "^3.24.0"
   },
   "optionalDependencies": {
@@ -39,13 +41,13 @@
   },
   "peerDependencies": {
     "@types/node": "^24.3.1",
-    "dotenv": "^17.2.2",
     "prettier": "^3.8.1",
     "rimraf": "^6.0.1",
     "tsx": "^4.16.5",
     "typescript": "5.9.3"
   },
   "devDependencies": {
+    "tsup": "^8.5.1",
     "yaml": "^2.8.3"
   }
 }

package/dist/api/client.d.ts

@@ -1,6 +0,0 @@
-/**
- * HTTP client for calling external-api query endpoints.
- *
- * Re-exports from @glimt/mcp-tools for backward compatibility.
- */
-export { isApiConfigured, getApiUrl, apiGet, apiPost, apiPatch, apiDelete, } from "@glimt/mcp-tools";

package/dist/api/client.js

@@ -1,6 +0,0 @@
-/**
- * HTTP client for calling external-api query endpoints.
- *
- * Re-exports from @glimt/mcp-tools for backward compatibility.
- */
-export { isApiConfigured, getApiUrl, apiGet, apiPost, apiPatch, apiDelete, } from "@glimt/mcp-tools";

package/dist/cli/commands/setup-self-improvement-gh.d.ts

@@ -1,7 +0,0 @@
-/**
- * Setup Self-Improvement GitHub Command
- *
- * Interactive wizard to set up the self-improvement agentic workflow for GitHub.
- */
-import { Command } from "commander";
-export declare const setupSelfImprovementGhCommand: Command;

package/dist/cli/commands/setup-self-improvement-gh.js

@@ -1,310 +0,0 @@
-/**
- * Setup Self-Improvement GitHub Command
- *
- * Interactive wizard to set up the self-improvement agentic workflow for GitHub.
- */
-import { Command } from "commander";
-import { exec, execSync } from "child_process";
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-import { installSkill } from "./skill.js";
-import { confirm, select, multiSelect, input, header, print, success, error, info, warn, newline, } from "../utils/prompts.js";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const TEMPLATES_DIR = path.resolve(__dirname, "../../../templates");
-const WORKFLOW_TEMPLATE = "self-improvement.md";
-const WORKFLOW_DEST = ".github/workflows/self-improvement.md";
-const ENGINES = [
-    { id: "claude", name: "Claude (Anthropic)", secretName: "ANTHROPIC_API_KEY" },
-    { id: "copilot", name: "GitHub Copilot", secretName: "COPILOT_GITHUB_TOKEN" },
-    { id: "codex", name: "Codex (OpenAI)", secretName: "OPENAI_API_KEY" },
-];
-const API_URL = process.env.RECAPT_API_URL ||
-    process.env.EXTERNAL_API_URL ||
-    "https://api.recapt.app";
-async function fetchDomains(secretKey) {
-    try {
-        const res = await fetch(`${API_URL}/v1beta/query/domains`, {
-            headers: {
-                "x-private-key": secretKey,
-                "Content-Type": "application/json",
-            },
-        });
-        if (!res.ok) {
-            return null;
-        }
-        const data = (await res.json());
-        return data;
-    }
-    catch {
-        return null;
-    }
-}
-function commandExists(cmd) {
-    try {
-        execSync(`which ${cmd}`, { stdio: "ignore" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function ghExtensionInstalled(extension) {
-    try {
-        const output = execSync("gh extension list", { encoding: "utf-8" });
-        return output.includes(extension);
-    }
-    catch {
-        return false;
-    }
-}
-function isGitRepo() {
-    try {
-        execSync("git rev-parse --is-inside-work-tree", { stdio: "ignore" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function getRepoUrl() {
-    try {
-        const url = execSync("gh repo view --json url -q .url", {
-            encoding: "utf-8",
-        }).trim();
-        return url || null;
-    }
-    catch {
-        return null;
-    }
-}
-function openBrowser(url) {
-    const platform = process.platform;
-    let command;
-    switch (platform) {
-        case "darwin":
-            command = `open "${url}"`;
-            break;
-        case "win32":
-            command = `start "" "${url}"`;
-            break;
-        default:
-            command = `xdg-open "${url}"`;
-    }
-    exec(command, (err) => {
-        if (err) {
-            info(`Could not open browser automatically. Please visit: ${url}`);
-        }
-    });
-}
-async function runSetupSelfImprovementGh() {
-    header("Recapt Self-Improvement GitHub Setup");
-    const cwd = process.cwd();
-    print("Checking prerequisites...");
-    newline();
-    const hasGh = commandExists("gh");
-    print(`  ${hasGh ? "[x]" : "[ ]"} gh CLI installed`);
-    if (!hasGh) {
-        newline();
-        error("GitHub CLI (gh) is required but not installed.");
-        info("Install it from: https://cli.github.com/");
-        process.exit(1);
-    }
-    const hasGhAw = ghExtensionInstalled("github/gh-aw");
-    print(`  ${hasGhAw ? "[x]" : "[ ]"} gh-aw extension installed`);
-    if (!hasGhAw) {
-        newline();
-        const shouldInstall = await confirm("gh-aw extension is required. Install it now?", true);
-        if (shouldInstall) {
-            print("Installing gh-aw extension...");
-            try {
-                execSync("gh extension install github/gh-aw", { stdio: "inherit" });
-                success("gh-aw extension installed");
-            }
-            catch {
-                error("Failed to install gh-aw extension");
-                info("Try manually: gh extension install github/gh-aw");
-                process.exit(1);
-            }
-        }
-        else {
-            error("gh-aw extension is required to continue.");
-            process.exit(1);
-        }
-    }
-    const inGitRepo = isGitRepo();
-    print(`  ${inGitRepo ? "[x]" : "[ ]"} Git repository detected`);
-    if (!inGitRepo) {
-        newline();
-        error("This command must be run from within a git repository.");
-        process.exit(1);
-    }
-    newline();
-    const engineOptions = ENGINES.map((engine) => ({
-        label: `${engine.name} (requires ${engine.secretName} secret)`,
-        value: engine,
-    }));
-    const selectedEngine = await select("Which AI engine do you want to use?", engineOptions);
-    if (!selectedEngine) {
-        error("No engine selected.");
-        process.exit(1);
-    }
-    newline();
-    // Domain selection
-    print("Configuring domain filter...");
-    info("You can optionally limit the workflow to specific domains.");
-    newline();
-    let selectedDomains = [];
-    const recaptKey = await input("Enter your RECAPT_SECRET_KEY to fetch domains (or press Enter to skip)");
-    if (recaptKey) {
-        const domains = await fetchDomains(recaptKey);
-        if (domains && domains.length > 0) {
-            const domainOptions = [
-                { label: "All domains", value: "__all__", selected: true },
-                ...domains.map((d) => ({
-                    label: d.domainName,
-                    value: d.domainName,
-                    selected: false,
-                })),
-            ];
-            const selected = await multiSelect("Which domains should this workflow analyze?", domainOptions);
-            if (!selected.includes("__all__") && selected.length > 0) {
-                selectedDomains = selected;
-                success(`Selected domains: ${selectedDomains.join(", ")}`);
-            }
-            else {
-                info("Will analyze all domains");
-            }
-        }
-        else {
-            warn("Could not fetch domains. Will analyze all domains.");
-        }
-    }
-    else {
-        const manualDomain = await input("Enter a specific domain to filter (or press Enter for all domains)");
-        if (manualDomain) {
-            selectedDomains = [manualDomain];
-            success(`Selected domain: ${manualDomain}`);
-        }
-        else {
-            info("Will analyze all domains");
-        }
-    }
-    newline();
-    print("Installing self-improvement skill...");
-    const skillInstalled = installSkill(cwd, "self-improvement", true);
-    if (!skillInstalled) {
-        error("Failed to install self-improvement skill");
-        process.exit(1);
-    }
-    newline();
-    print("Creating workflow...");
-    const templatePath = path.join(TEMPLATES_DIR, WORKFLOW_TEMPLATE);
-    const destPath = path.join(cwd, WORKFLOW_DEST);
-    const destDir = path.dirname(destPath);
-    if (!fs.existsSync(templatePath)) {
-        error(`Workflow template not found: ${templatePath}`);
-        process.exit(1);
-    }
-    if (!fs.existsSync(destDir)) {
-        fs.mkdirSync(destDir, { recursive: true });
-    }
-    const templateContent = fs.readFileSync(templatePath, "utf-8");
-    // Build domain config section
-    let domainConfig = "";
-    if (selectedDomains.length > 0) {
-        const domainList = selectedDomains.join(", ");
-        domainConfig = `### Domain Restriction
-
-**Target domains:** ${domainList}
-
-Before doing any work:
-1. Call \`get_domains\` to verify the target domain(s) exist
-2. If any target domain is NOT in the list, stop immediately and report: "Domain not found: [domain]. Available domains: [list]"
-3. If domains are valid, pass the \`domain\` parameter to all tools that support filtering (e.g., \`run_full_diagnostic\`, \`get_page_metrics\`, etc.)
-
-Do NOT analyze or fix issues for domains not in the target list.
-
-`;
-    }
-    else {
-        domainConfig = `### Domain Scope
-
-**Target:** All domains
-
-Analyze and fix issues across all domains configured in recapt. Call \`get_domains\` first to see available domains.
-
-`;
-    }
-    // Replace placeholders (support both {{VAR}} and { { VAR } } formats)
-    const workflowContent = templateContent
-        .replace(/\{\s*\{\s*ENGINE\s*\}\s*\}/g, selectedEngine.id)
-        .replace(/\{\s*\{\s*DOMAIN_CONFIG\s*\}\s*\}/g, domainConfig);
-    if (fs.existsSync(destPath)) {
-        const overwrite = await confirm("Workflow file already exists. Overwrite?", false);
-        if (!overwrite) {
-            info("Skipping workflow creation");
-        }
-        else {
-            fs.writeFileSync(destPath, workflowContent);
-            success(`Created: ${WORKFLOW_DEST}`);
-        }
-    }
-    else {
-        fs.writeFileSync(destPath, workflowContent);
-        success(`Created: ${WORKFLOW_DEST}`);
-    }
-    newline();
-    print("Compiling workflow...");
-    try {
-        execSync("gh aw compile", { cwd, stdio: "inherit" });
-        success("Created: .github/workflows/self-improvement.lock.yml");
-    }
-    catch {
-        warn("Failed to compile workflow. You can run 'gh aw compile' manually.");
-    }
-    newline();
-    print("GitHub Secrets Required:");
-    info(`1. ${selectedEngine.secretName} - For ${selectedEngine.name} to run the agent`);
-    info("2. RECAPT_SECRET_KEY - For recapt behavioral intelligence");
-    newline();
-    const repoUrl = getRepoUrl();
-    if (repoUrl) {
-        const secretsUrl = `${repoUrl}/settings/secrets/actions`;
-        const openSecrets = await confirm("Open GitHub secrets page?", true);
-        if (openSecrets) {
-            openBrowser(secretsUrl);
-            await new Promise((resolve) => setTimeout(resolve, 1000));
-        }
-    }
-    else {
-        info("Go to your repository Settings → Secrets and variables → Actions");
-        info(`Add ${selectedEngine.secretName} and RECAPT_SECRET_KEY as secrets.`);
-    }
-    newline();
-    success("Setup complete!");
-    newline();
-    print("Next steps:");
-    print('  1. git add . && git commit -m "Add recapt self-improvement workflow"');
-    print("  2. git push");
-    print("  3. Run manually: gh aw run self-improvement");
-    newline();
-    warn("Important: Enable PR creation permissions");
-    info("The workflow needs permission to create pull requests.");
-    info("Go to Settings → Actions → General → Workflow permissions");
-    info('Enable "Allow GitHub Actions to create and approve pull requests"');
-    info("(This may need to be set at the organization level)");
-    newline();
-}
-export const setupSelfImprovementGhCommand = new Command("setup-self-improvement-gh")
-    .description("Set up automated self-improvement workflow for GitHub Actions")
-    .action(async () => {
-    try {
-        await runSetupSelfImprovementGh();
-    }
-    catch (err) {
-        error(`Setup failed: ${err}`);
-        process.exit(1);
-    }
-});

package/dist/cli/commands/setup.d.ts

@@ -1,7 +0,0 @@
-/**
- * Setup Command
- *
- * Interactive wizard to configure recapt MCP server across AI IDEs.
- */
-import { Command } from "commander";
-export declare const setupCommand: Command;

package/dist/cli/commands/setup.js

@@ -1,178 +0,0 @@
-/**
- * Setup Command
- *
- * Interactive wizard to configure recapt MCP server across AI IDEs.
- */
-import { Command } from "commander";
-import { exec } from "child_process";
-import { detectInstalledIdes, addRecaptToIdeConfig, } from "../utils/ide-config.js";
-import { confirm, secret, multiSelect, header, print, success, error, info, warn, newline, } from "../utils/prompts.js";
-import { installAllSkills, installSelectedSkills, getAvailableSkills, } from "./skill.js";
-const SETTINGS_URL = "https://dash.recapt.app/settings";
-const MCP_KEY_PREFIX = "mcp_sk_";
-function openBrowser(url) {
-    const platform = process.platform;
-    let command;
-    switch (platform) {
-        case "darwin":
-            command = `open "${url}"`;
-            break;
-        case "win32":
-            command = `start "" "${url}"`;
-            break;
-        default:
-            command = `xdg-open "${url}"`;
-    }
-    exec(command, (err) => {
-        if (err) {
-            info(`Could not open browser automatically. Please visit: ${url}`);
-        }
-    });
-}
-function validateMcpKey(key) {
-    return key.startsWith(MCP_KEY_PREFIX);
-}
-async function promptForKey() {
-    const hasKey = await confirm("Do you have a Recapt MCP key?", false);
-    if (!hasKey) {
-        newline();
-        info(`Opening ${SETTINGS_URL} (MCP Keys tab)...`);
-        info("Create a new MCP key and copy it.");
-        newline();
-        openBrowser(SETTINGS_URL);
-        await new Promise((resolve) => setTimeout(resolve, 2000));
-    }
-    const key = await secret("Paste your MCP key");
-    if (!key) {
-        error("No key provided.");
-        return null;
-    }
-    if (!validateMcpKey(key)) {
-        error(`Invalid MCP key format. Keys should start with "${MCP_KEY_PREFIX}".`);
-        return null;
-    }
-    return key;
-}
-async function runSetup() {
-    header("Recapt MCP Setup");
-    const detectedIdes = detectInstalledIdes();
-    const installedIdes = detectedIdes.filter((ide) => ide.detected);
-    print("Detected AI IDEs:");
-    newline();
-    for (const ide of detectedIdes) {
-        const marker = ide.detected ? "[x]" : "[ ]";
-        const status = ide.detected ? `(${ide.globalPathResolved})` : "(not found)";
-        print(`  ${marker} ${ide.config.name} ${status}`);
-    }
-    newline();
-    if (installedIdes.length === 0) {
-        error("No supported AI IDEs detected.");
-        info("Supported IDEs: Cursor, Claude Code, Windsurf, VS Code");
-        info("Make sure at least one is installed before running setup.");
-        process.exit(1);
-    }
-    const options = installedIdes.map((ide) => ({
-        label: ide.config.name,
-        value: ide.config,
-        selected: true,
-    }));
-    const selectedIdes = await multiSelect("Which IDE(s) do you want to configure?", options);
-    if (selectedIdes.length === 0) {
-        info("No IDEs selected. Exiting.");
-        return;
-    }
-    newline();
-    const mcpKey = await promptForKey();
-    if (!mcpKey) {
-        process.exit(1);
-    }
-    newline();
-    print("Writing configuration...");
-    newline();
-    const configuredPaths = [];
-    for (const ide of selectedIdes) {
-        try {
-            const configPath = addRecaptToIdeConfig(ide, mcpKey, true);
-            success(`${ide.name}: ${configPath}`);
-            configuredPaths.push(configPath);
-        }
-        catch (err) {
-            error(`${ide.name}: Failed to write config - ${err}`);
-        }
-    }
-    if (configuredPaths.length === 0) {
-        error("Failed to configure any IDEs.");
-        process.exit(1);
-    }
-    newline();
-    const shouldInstallSkills = await confirm("Install recapt skills?", true);
-    if (shouldInstallSkills) {
-        newline();
-        let availableSkills;
-        try {
-            availableSkills = getAvailableSkills();
-        }
-        catch (err) {
-            error(`Failed to load skills: ${err instanceof Error ? err.message : err}`);
-            availableSkills = [];
-        }
-        if (availableSkills.length > 0) {
-            const skillOptions = [
-                { label: "Install all skills", value: "__all__", selected: true },
-                ...availableSkills.map((skill) => ({
-                    label: `${skill.name} - ${skill.description}`,
-                    value: skill.name,
-                    selected: false,
-                })),
-            ];
-            const selectedSkills = await multiSelect("Which skills do you want to install?", skillOptions);
-            if (selectedSkills.length > 0) {
-                newline();
-                print("Installing skills...");
-                newline();
-                const cwd = process.cwd();
-                let result;
-                if (selectedSkills.includes("__all__")) {
-                    result = installAllSkills(cwd);
-                }
-                else {
-                    result = installSelectedSkills(cwd, selectedSkills);
-                }
-                if (result.error) {
-                    error(`Failed to load skills: ${result.error}`);
-                }
-                else if (result.installed.length > 0) {
-                    success(`Installed ${result.installed.length} skill(s): ${result.installed.join(", ")}`);
-                    if (result.failed.length > 0) {
-                        warn(`Failed to install: ${result.failed.join(", ")}`);
-                    }
-                }
-                else if (result.failed.length > 0) {
-                    error(`Failed to install skills: ${result.failed.join(", ")}`);
-                }
-                else {
-                    info("No skills were installed.");
-                }
-            }
-            else {
-                info("No skills selected.");
-            }
-        }
-    }
-    newline();
-    success("Setup complete!");
-    newline();
-    info("Restart your IDE(s) to activate the MCP server.");
-    newline();
-}
-export const setupCommand = new Command("setup")
-    .description("Configure recapt MCP server for your AI IDE(s)")
-    .action(async () => {
-    try {
-        await runSetup();
-    }
-    catch (err) {
-        error(`Setup failed: ${err}`);
-        process.exit(1);
-    }
-});

package/dist/cli/commands/skill.d.ts

@@ -1,24 +0,0 @@
-/**
- * Skill Command
- *
- * Manages recapt workflow skills installation to .agents/recapt/.
- * Works across all AI IDEs that support the AGENTS.md standard.
- */
-import { Command } from "commander";
-interface SkillInfo {
-    name: string;
-    file: string;
-    description: string;
-}
-export type { SkillInfo };
-export declare function getAvailableSkills(): SkillInfo[];
-export declare function installSkill(cwd: string, skillName: string, force?: boolean): boolean;
-export interface InstallResult {
-    success: boolean;
-    installed: string[];
-    failed: string[];
-    error?: string;
-}
-export declare function installAllSkills(cwd: string, force?: boolean): InstallResult;
-export declare function installSelectedSkills(cwd: string, skillNames: string[], force?: boolean): InstallResult;
-export declare const skillCommand: Command;