@recapt/mcp 0.0.19-beta → 0.0.20-beta

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;

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;