@recapt/mcp 0.0.18-beta → 0.0.20-beta

package/dist/cli/commands/setup.js

@@ -1,173 +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";
-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 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 rawKey = await secret("Paste your MCP key");
-    const key = rawKey?.trim();
-    if (!key) {
-        error("No key provided.");
-        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();
-    // Small delay to prevent stdin buffering issues from IDE selection
-    await new Promise((resolve) => setTimeout(resolve, 100));
-    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;

package/dist/cli/commands/skill.js

@@ -1,264 +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";
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const SKILLS_DIR = path.resolve(__dirname, "../../../skills");
-const AGENTS_DIR = ".agents/recapt";
-const AGENTS_MD = "AGENTS.md";
-const MARKER_START = "<!-- recapt:skills -->";
-const MARKER_END = "<!-- /recapt:skills -->";
-export function getAvailableSkills() {
-    if (!fs.existsSync(SKILLS_DIR)) {
-        throw new Error(`Skills directory not found: ${SKILLS_DIR}`);
-    }
-    const files = fs.readdirSync(SKILLS_DIR).filter((f) => f.endsWith(".md"));
-    if (files.length === 0) {
-        throw new Error(`No skill files found in: ${SKILLS_DIR}`);
-    }
-    return files.map((file) => {
-        const content = fs.readFileSync(path.join(SKILLS_DIR, file), "utf-8");
-        const firstLine = content.split("\n")[0];
-        const description = firstLine.startsWith("# ")
-            ? firstLine.slice(2).trim()
-            : file.replace(".md", "");
-        return {
-            name: file.replace(".md", ""),
-            file,
-            description,
-        };
-    });
-}
-function getInstalledSkills(cwd) {
-    const agentsDir = path.join(cwd, AGENTS_DIR);
-    if (!fs.existsSync(agentsDir)) {
-        return [];
-    }
-    return fs
-        .readdirSync(agentsDir)
-        .filter((f) => f.endsWith(".md"))
-        .map((f) => f.replace(".md", ""));
-}
-function ensureAgentsDir(cwd) {
-    const agentsDir = path.join(cwd, AGENTS_DIR);
-    if (!fs.existsSync(agentsDir)) {
-        fs.mkdirSync(agentsDir, { recursive: true });
-        console.log(`Created ${AGENTS_DIR}/`);
-    }
-}
-function readAgentsMd(cwd) {
-    const agentsMdPath = path.join(cwd, AGENTS_MD);
-    if (!fs.existsSync(agentsMdPath)) {
-        return "";
-    }
-    return fs.readFileSync(agentsMdPath, "utf-8");
-}
-function writeAgentsMd(cwd, content) {
-    const agentsMdPath = path.join(cwd, AGENTS_MD);
-    fs.writeFileSync(agentsMdPath, content);
-}
-function getSkillDisplayName(skillName) {
-    try {
-        const skills = getAvailableSkills();
-        const skill = skills.find((s) => s.name === skillName);
-        return skill?.description ?? skillName;
-    }
-    catch {
-        return skillName;
-    }
-}
-function updateAgentsMdReferences(cwd) {
-    const installed = getInstalledSkills(cwd);
-    let content = readAgentsMd(cwd);
-    if (installed.length === 0) {
-        if (content.includes(MARKER_START)) {
-            const regex = new RegExp(`\\n?${MARKER_START}[\\s\\S]*?${MARKER_END}\\n?`, "g");
-            content = content.replace(regex, "").trim();
-            if (content) {
-                writeAgentsMd(cwd, content + "\n");
-            }
-            else {
-                const agentsMdPath = path.join(cwd, AGENTS_MD);
-                if (fs.existsSync(agentsMdPath)) {
-                    fs.unlinkSync(agentsMdPath);
-                    console.log(`Removed empty ${AGENTS_MD}`);
-                }
-            }
-        }
-        return;
-    }
-    const skillLinks = installed
-        .map((name) => `- [${getSkillDisplayName(name)}](${AGENTS_DIR}/${name}.md)`)
-        .join("\n");
-    const newBlock = `${MARKER_START}
-For recapt behavioral intelligence workflows, see:
-${skillLinks}
-${MARKER_END}`;
-    if (content.includes(MARKER_START)) {
-        const regex = new RegExp(`${MARKER_START}[\\s\\S]*?${MARKER_END}`, "g");
-        content = content.replace(regex, newBlock);
-    }
-    else {
-        if (content.trim()) {
-            content = content.trim() + "\n\n" + newBlock;
-        }
-        else {
-            content = `# Project Agent Instructions\n\n${newBlock}`;
-        }
-    }
-    writeAgentsMd(cwd, content + "\n");
-}
-export function installSkill(cwd, skillName, force = false) {
-    let skills;
-    try {
-        skills = getAvailableSkills();
-    }
-    catch (err) {
-        console.error(`Failed to load skills: ${err instanceof Error ? err.message : err}`);
-        return false;
-    }
-    const skill = skills.find((s) => s.name === skillName);
-    if (!skill) {
-        console.error(`Unknown skill: ${skillName}`);
-        console.error(`Available skills: ${skills.map((s) => s.name).join(", ")}`);
-        return false;
-    }
-    ensureAgentsDir(cwd);
-    const sourcePath = path.join(SKILLS_DIR, skill.file);
-    const destPath = path.join(cwd, AGENTS_DIR, skill.file);
-    if (fs.existsSync(destPath)) {
-        const sourceContent = fs.readFileSync(sourcePath, "utf-8");
-        const destContent = fs.readFileSync(destPath, "utf-8");
-        if (sourceContent === destContent) {
-            console.log(`Skill already up to date: ${skillName}`);
-            return true;
-        }
-        if (!force) {
-            console.log(`Skill outdated: ${skillName} (use --force to update)`);
-            return true;
-        }
-        fs.copyFileSync(sourcePath, destPath);
-        console.log(`Updated: ${skillName} → ${AGENTS_DIR}/${skill.file}`);
-    }
-    else {
-        fs.copyFileSync(sourcePath, destPath);
-        console.log(`Installed: ${skillName} → ${AGENTS_DIR}/${skill.file}`);
-    }
-    updateAgentsMdReferences(cwd);
-    return true;
-}
-function uninstallSkill(cwd, skillName) {
-    const skillPath = path.join(cwd, AGENTS_DIR, `${skillName}.md`);
-    if (!fs.existsSync(skillPath)) {
-        console.error(`Skill not installed: ${skillName}`);
-        return false;
-    }
-    fs.unlinkSync(skillPath);
-    console.log(`Uninstalled: ${skillName}`);
-    updateAgentsMdReferences(cwd);
-    const agentsDir = path.join(cwd, AGENTS_DIR);
-    const remaining = fs.readdirSync(agentsDir);
-    if (remaining.length === 0) {
-        fs.rmdirSync(agentsDir);
-        const parentDir = path.dirname(agentsDir);
-        if (fs.existsSync(parentDir) && fs.readdirSync(parentDir).length === 0) {
-            fs.rmdirSync(parentDir);
-        }
-        console.log(`Removed empty ${AGENTS_DIR}/`);
-    }
-    return true;
-}
-function listSkills(cwd) {
-    let available;
-    try {
-        available = getAvailableSkills();
-    }
-    catch (err) {
-        console.error(`Failed to load skills: ${err instanceof Error ? err.message : err}`);
-        process.exit(1);
-    }
-    const installed = new Set(getInstalledSkills(cwd));
-    console.log("\nAvailable recapt skills:\n");
-    for (const skill of available) {
-        const status = installed.has(skill.name) ? "[installed]" : "";
-        console.log(`  ${skill.name.padEnd(20)} ${skill.description} ${status}`);
-    }
-    console.log();
-}
-export function installAllSkills(cwd, force = false) {
-    let skills;
-    try {
-        skills = getAvailableSkills();
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        console.error(`Failed to load skills: ${message}`);
-        return { success: false, installed: [], failed: [], error: message };
-    }
-    return installSelectedSkills(cwd, skills.map((s) => s.name), force);
-}
-export function installSelectedSkills(cwd, skillNames, force = false) {
-    const installed = [];
-    const failed = [];
-    for (const skillName of skillNames) {
-        try {
-            if (installSkill(cwd, skillName, force)) {
-                installed.push(skillName);
-            }
-            else {
-                failed.push(skillName);
-            }
-        }
-        catch (err) {
-            console.error(`Failed to install ${skillName}: ${err}`);
-            failed.push(skillName);
-        }
-    }
-    const success = failed.length === 0 && installed.length > 0;
-    if (success && installed.length > 1) {
-        console.log(`\nAll skills installed. See ${AGENTS_MD} for references.`);
-    }
-    return { success, installed, failed };
-}
-const listCommand = new Command("list")
-    .description("Show available skills")
-    .action(() => {
-    listSkills(process.cwd());
-});
-const installCommand = new Command("install")
-    .description("Install a skill")
-    .argument("[name]", "Skill name to install")
-    .option("-a, --all", "Install all skills")
-    .option("-f, --force", "Force update if skill already exists")
-    .action((name, options) => {
-    const cwd = process.cwd();
-    if (options.all) {
-        installAllSkills(cwd, options.force);
-        return;
-    }
-    if (!name) {
-        console.error("Usage: recapt skill install <name> or recapt skill install --all");
-        process.exit(1);
-    }
-    if (installSkill(cwd, name, options.force)) {
-        console.log(`\nSkill reference added to ${AGENTS_MD}`);
-    }
-});
-const uninstallCommand = new Command("uninstall")
-    .description("Remove a skill")
-    .argument("<name>", "Skill name to uninstall")
-    .action((name) => {
-    uninstallSkill(process.cwd(), name);
-});
-export const skillCommand = new Command("skill")
-    .description("Manage recapt workflow skills")
-    .addCommand(listCommand)
-    .addCommand(installCommand)
-    .addCommand(uninstallCommand);

package/dist/cli/utils/ide-config.d.ts

@@ -1,31 +0,0 @@
-/**
- * IDE Configuration Utilities
- *
- * Handles detection and configuration of MCP servers across different AI IDEs.
- */
-export type ConfigFormat = "json" | "toml";
-export interface IdeConfig {
-    name: string;
-    globalPath: string | null;
-    projectPath: string;
-    rootKey: string;
-    format: ConfigFormat;
-}
-export declare const IDE_CONFIGS: IdeConfig[];
-export interface DetectedIde {
-    config: IdeConfig;
-    detected: boolean;
-    globalPathResolved: string | null;
-}
-export declare function detectInstalledIdes(): DetectedIde[];
-export interface McpServerConfig {
-    type?: string;
-    command: string;
-    args: string[];
-    env: Record<string, string>;
-}
-export declare function readIdeConfig(configPath: string, format?: ConfigFormat): Record<string, unknown>;
-export declare function writeIdeConfig(configPath: string, config: Record<string, unknown>, format?: ConfigFormat): void;
-export declare function addRecaptToIdeConfig(ide: IdeConfig, secretKey: string, useGlobal?: boolean): string;
-export declare function removeRecaptFromIdeConfig(ide: IdeConfig, useGlobal?: boolean): boolean;
-export declare function isRecaptConfigured(ide: IdeConfig): boolean;