@recapt/mcp 0.0.14-beta → 0.0.16-beta

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

@@ -193,7 +193,7 @@ async function runSetupSelfHealingGh() {
     }
     newline();
     print("Installing self-healing skill...");
-    const skillInstalled = installSkill(cwd, "self-healing");
+    const skillInstalled = installSkill(cwd, "self-healing", true);
     if (!skillInstalled) {
         error("Failed to install self-healing skill");
         process.exit(1);

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

@@ -12,13 +12,13 @@ interface SkillInfo {
 }
 export type { SkillInfo };
 export declare function getAvailableSkills(): SkillInfo[];
-export declare function installSkill(cwd: string, skillName: string): boolean;
+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): InstallResult;
-export declare function installSelectedSkills(cwd: string, skillNames: string[]): InstallResult;
+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

@@ -115,7 +115,7 @@ ${MARKER_END}`;
     }
     writeAgentsMd(cwd, content + "\n");
 }
-export function installSkill(cwd, skillName) {
+export function installSkill(cwd, skillName, force = false) {
     let skills;
     try {
         skills = getAvailableSkills();
@@ -134,11 +134,23 @@ export function installSkill(cwd, skillName) {
     const sourcePath = path.join(SKILLS_DIR, skill.file);
     const destPath = path.join(cwd, AGENTS_DIR, skill.file);
     if (fs.existsSync(destPath)) {
-        console.log(`Skill already installed: ${skillName}`);
-        return true;
+        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}`);
     }
-    fs.copyFileSync(sourcePath, destPath);
-    console.log(`Installed: ${skillName} → ${AGENTS_DIR}/${skill.file}`);
     updateAgentsMdReferences(cwd);
     return true;
 }
@@ -180,7 +192,7 @@ function listSkills(cwd) {
     }
     console.log();
 }
-export function installAllSkills(cwd) {
+export function installAllSkills(cwd, force = false) {
     let skills;
     try {
         skills = getAvailableSkills();
@@ -190,14 +202,14 @@ export function installAllSkills(cwd) {
         console.error(`Failed to load skills: ${message}`);
         return { success: false, installed: [], failed: [], error: message };
     }
-    return installSelectedSkills(cwd, skills.map((s) => s.name));
+    return installSelectedSkills(cwd, skills.map((s) => s.name), force);
 }
-export function installSelectedSkills(cwd, skillNames) {
+export function installSelectedSkills(cwd, skillNames, force = false) {
     const installed = [];
     const failed = [];
     for (const skillName of skillNames) {
         try {
-            if (installSkill(cwd, skillName)) {
+            if (installSkill(cwd, skillName, force)) {
                 installed.push(skillName);
             }
             else {
@@ -224,17 +236,18 @@ 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);
+        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)) {
+    if (installSkill(cwd, name, options.force)) {
         console.log(`\nSkill reference added to ${AGENTS_MD}`);
     }
 });

package/dist/index.js

@@ -30,6 +30,7 @@ import { registerGetDomains } from "./tools/getDomains.js";
 import { registerMemoryTools } from "./tools/memory.js";
 import { registerTriageSessions } from "./tools/triageSessions.js";
 import { registerDiagnosticTools } from "./tools/diagnostic.js";
+import { registerGetUpgradeOptions } from "./tools/upgradeOptions.js";
 // ─────────────────────────────────────────────────────────────────────────────
 // Hidden Tool Handlers - Registered with call_tool registry
 // ─────────────────────────────────────────────────────────────────────────────
@@ -203,6 +204,12 @@ function registerHiddenTools() {
     })));
     registerToolHandler("delete_site_knowledge", createApiHandler("DELETE", (args) => `/knowledge/${args.knowledge_id}`));
     registerToolHandler("get_similar_fixes", createApiHandler("GET", "/knowledge/similar-fixes"));
+    // Healing Runs (workflow tracking)
+    registerToolHandler("start_healing_run", createApiHandler("POST", "/healing-runs"));
+    registerToolHandler("update_healing_run", createApiHandler("PATCH", (args) => `/healing-runs/${args.run_id}`));
+    registerToolHandler("record_healing_action", createApiHandler("POST", (args) => `/healing-runs/${args.run_id}/actions`));
+    registerToolHandler("get_healing_run", createApiHandler("GET", (args) => `/healing-runs/${args.run_id}`));
+    registerToolHandler("list_healing_runs", createApiHandler("GET", "/healing-runs"));
 }
 // ─────────────────────────────────────────────────────────────────────────────
 // Server Instructions
@@ -233,8 +240,27 @@ These tools are always visible (no search needed):
 - **get_domains** — List tracked domains (good starting point)
 - **run_full_diagnostic** — Quick site health overview (lightweight, fast)
 - **triage_sessions** — Find sessions needing attention
+- **get_upgrade_options** — Check available plan upgrades and features
 - **memory_*** — Store/retrieve intermediate results
 
+## Tier-Based Access
+
+Some features are limited based on the user's subscription tier:
+
+**Free Tier (Diagnose):**
+- Full access to issue detection and diagnostics
+- Session summaries and triage results
+- Page metrics and health scores
+
+**Paid Tiers (Solve):**
+- Session replay URLs (Starter+)
+- Detailed investigation data (Starter+)
+- AI-powered fix suggestions (Team+)
+- Outcome predictions (Team+)
+
+When a response includes an \`upgrade\` object, the user needs a higher tier for full access.
+Use \`get_upgrade_options\` to explain the benefits of upgrading.
+
 ## Comprehensive Site Analysis
 
 For a full site analysis, run these tools in sequence:
@@ -303,10 +329,11 @@ async function main() {
     registerGetDomains(server);
     registerDiagnosticTools(server); // Includes run_full_diagnostic
     registerTriageSessions(server);
+    registerGetUpgradeOptions(server);
     registerMemoryTools(server);
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("[MCP] Server running on stdio (10 exposed tools, 38 hidden)");
+    console.error("[MCP] Server running on stdio (11 exposed tools, 38 hidden)");
 }
 main().catch((err) => {
     console.error("[MCP] Fatal error:", err);