@recapt/mcp 0.0.17-beta → 0.0.19-beta

package/dist/tools/improvementRun.js

@@ -60,6 +60,10 @@ export function registerImprovementRunTools(server) {
                 .enum(["running", "completed", "failed", "cancelled"])
                 .optional()
                 .describe("New status for the run"),
+            title: z
+                .string()
+                .optional()
+                .describe("A concise title summarizing what was fixed in this run (e.g., 'Fixed checkout button, improved mobile nav'). Set when completing the run."),
             phases: z
                 .array(z.object({
                 name: z.string(),
@@ -95,7 +99,7 @@ export function registerImprovementRunTools(server) {
                 .optional()
                 .describe("Total duration of the run in milliseconds"),
         }),
-    }, async ({ run_id, status, phases, summary, completed_at, duration_ms, }) => {
+    }, async ({ run_id, status, title, phases, summary, completed_at, duration_ms, }) => {
         if (!isApiConfigured()) {
             return {
                 content: [
@@ -109,6 +113,7 @@ export function registerImprovementRunTools(server) {
         }
         const { data, error } = await apiPatch(`/improvement-runs/${run_id}`, {
             status,
+            title,
             phases,
             summary,
             completed_at,
@@ -203,8 +208,30 @@ export function registerImprovementRunTools(server) {
                 .string()
                 .optional()
                 .describe("Explanation for why the issue was dismissed (for dismissed/marked_intended actions)"),
+            page_path: z
+                .string()
+                .optional()
+                .describe("Page path affected by the fix (used for auto-creating remediation when remediation_id is not provided)"),
+            element_selector: z
+                .string()
+                .optional()
+                .describe("CSS selector of the affected element (used for auto-creating remediation)"),
+            diagnosis: z
+                .string()
+                .optional()
+                .describe("Root cause analysis (used for auto-creating remediation; defaults to hypothesis if not provided)"),
+            proposed_fix: z
+                .string()
+                .optional()
+                .describe("Fix description (used for auto-creating remediation; defaults to expected_improvement if not provided)"),
+            confidence: z
+                .number()
+                .min(0)
+                .max(1)
+                .optional()
+                .describe("Fix confidence 0-1 (used for auto-creating remediation; defaults to 0.7)"),
         }),
-    }, async ({ run_id, issue_id, action_type, hypothesis, expected_improvement, code_changes, pr_url, pr_number, remediation_id, deferral_reason, dismissal_reason, }) => {
+    }, async ({ run_id, issue_id, action_type, hypothesis, expected_improvement, code_changes, pr_url, pr_number, remediation_id, deferral_reason, dismissal_reason, page_path, element_selector, diagnosis, proposed_fix, confidence, }) => {
         if (!isApiConfigured()) {
             return {
                 content: [
@@ -227,6 +254,50 @@ export function registerImprovementRunTools(server) {
             remediation_id,
             deferral_reason,
             dismissal_reason,
+            page_path,
+            element_selector,
+            diagnosis,
+            proposed_fix,
+            confidence,
+        });
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+    server.registerTool("update_improvement_action", {
+        description: "Update an existing improvement run action with PR information. Use this after a PR has been created to link it to the action. " +
+            "This is especially useful in GitHub Actions workflows where the PR is created after the action is recorded.",
+        inputSchema: z.object({
+            run_id: z.string().describe("The ID of the improvement run"),
+            action_id: z.string().describe("The ID of the action to update"),
+            pr_url: z
+                .string()
+                .optional()
+                .describe("GitHub PR URL to link to this action"),
+            pr_number: z
+                .number()
+                .optional()
+                .describe("GitHub PR number to link to this action"),
+        }),
+    }, async ({ run_id, action_id, pr_url, pr_number, }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiPatch(`/improvement-runs/${run_id}/actions/${action_id}`, {
+            pr_url,
+            pr_number,
         });
         if (error) {
             return {

package/dist/tools/remediation.js

@@ -89,6 +89,8 @@ export function registerRemediationTools(server) {
             status: z
                 .enum([
                 "proposed",
+                "waiting",
+                "dismissed",
                 "deployed",
                 "evaluating",
                 "succeeded",
@@ -220,4 +222,114 @@ export function registerRemediationTools(server) {
         }
         return { content: [{ type: "text", text: JSON.stringify(data) }] };
     });
+    server.registerTool("update_remediation_status", {
+        description: "Update the status of a remediation based on PR events. Use to mark a fix as 'waiting' (PR created), 'deployed' (PR merged), or 'dismissed' (PR closed without merge).",
+        inputSchema: z.object({
+            remediation_id: z
+                .string()
+                .describe("The ID of the remediation to update"),
+            status: z
+                .enum(["waiting", "deployed", "dismissed"])
+                .describe("New status: 'waiting' = PR open, 'deployed' = PR merged, 'dismissed' = PR closed without merge"),
+            pr_url: z.string().optional().describe("URL of the pull request"),
+            pr_number: z.number().optional().describe("PR number"),
+            pr_merged_at: z
+                .string()
+                .optional()
+                .describe("ISO timestamp when PR was merged"),
+            pr_closed_at: z
+                .string()
+                .optional()
+                .describe("ISO timestamp when PR was closed"),
+        }),
+    }, async ({ remediation_id, status, pr_url, pr_number, pr_merged_at, pr_closed_at, }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiPatch(`/remediations/${remediation_id}/status`, {
+            status,
+            pr_url,
+            pr_number,
+            pr_merged_at,
+            pr_closed_at,
+        });
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+    server.registerTool("list_remediations_by_status", {
+        description: "List remediations filtered by one or more statuses. Use to find all 'waiting' PRs or 'deployed' fixes ready for evaluation.",
+        inputSchema: z.object({
+            statuses: z
+                .array(z.enum([
+                "proposed",
+                "waiting",
+                "dismissed",
+                "deployed",
+                "evaluating",
+                "succeeded",
+                "failed",
+                "reverted",
+            ]))
+                .describe("List of statuses to filter by"),
+        }),
+    }, async ({ statuses }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiGet(`/remediations/by-status`, { statuses: statuses.join(",") });
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
+    server.registerTool("get_remediation_by_pr", {
+        description: "Get a remediation by its PR number. Use to look up fix details when processing PR events.",
+        inputSchema: z.object({
+            pr_number: z.number().describe("The PR number to look up"),
+        }),
+    }, async ({ pr_number }) => {
+        if (!isApiConfigured()) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: "API not configured" }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { data, error } = await apiGet(`/remediations/by-pr/${pr_number}`);
+        if (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error }) }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    });
 }

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@recapt/mcp",
-  "version": "0.0.17-beta",
+  "version": "0.0.19-beta",
   "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 dist/tools/catalog/",
+    "build": "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",
     "start": "node dist/index.js",
@@ -27,6 +28,7 @@
   "author": "Recapt",
   "license": "ISC",
   "dependencies": {
+    "@glimt/mcp-tools": "file:../../libraries/mcp-tools",
     "@inquirer/prompts": "^8.3.2",
     "@modelcontextprotocol/sdk": "^1.12.0",
     "commander": "^14.0.3",
@@ -42,5 +44,8 @@
     "rimraf": "^6.0.1",
     "tsx": "^4.16.5",
     "typescript": "5.9.3"
+  },
+  "devDependencies": {
+    "yaml": "^2.8.3"
   }
 }