@recapt/mcp 0.0.19-beta → 0.0.20

package/dist/tools/improvementRun.js

@@ -1,386 +0,0 @@
-/**
- * Improvement Run tools for tracking self-improvement workflow executions.
- *
- * Provides run registration, phase updates, action recording, and run listing.
- */
-import { z } from "zod";
-import { apiGet, apiPost, apiPatch, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerImprovementRunTools(server) {
-    server.registerTool("start_improvement_run", {
-        description: "Register the start of a self-improvement workflow run. Call this at the beginning of an improvement session to track the run and its outcomes. Returns a run ID to use for subsequent updates.",
-        inputSchema: z.object({
-            trigger_type: z
-                .enum(["github_actions", "cron", "manual", "api"])
-                .describe("What triggered this improvement run"),
-            trigger_metadata: z
-                .record(z.unknown())
-                .optional()
-                .describe("Additional metadata about the trigger (e.g., GitHub run ID, branch, actor)"),
-            phases: z
-                .array(z.object({
-                name: z.string(),
-                status: z
-                    .enum(["pending", "running", "completed", "skipped", "failed"])
-                    .default("pending"),
-            }))
-                .optional()
-                .describe("Initial phases to track (e.g., diagnose, investigate, fix)"),
-        }),
-    }, async ({ trigger_type, trigger_metadata, phases, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost("/improvement-runs", {
-            trigger_type,
-            trigger_metadata,
-            phases,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("update_improvement_run", {
-        description: "Update an improvement run's status, phases, or summary. Use to track progress through the workflow phases and record final outcomes.",
-        inputSchema: z.object({
-            run_id: z.string().describe("The ID of the improvement run to update"),
-            status: z
-                .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(),
-                status: z.enum([
-                    "pending",
-                    "running",
-                    "completed",
-                    "skipped",
-                    "failed",
-                ]),
-                startedAt: z.string().nullable().optional(),
-                completedAt: z.string().nullable().optional(),
-                output: z.record(z.unknown()).optional(),
-            }))
-                .optional()
-                .describe("Updated phases array"),
-            summary: z
-                .object({
-                issuesFound: z.number().optional(),
-                issuesFixed: z.number().optional(),
-                issuesDeferred: z.number().optional(),
-                issuesDismissed: z.number().optional(),
-                prsCreated: z.number().optional(),
-            })
-                .optional()
-                .describe("Updated summary counts"),
-            completed_at: z
-                .string()
-                .optional()
-                .describe("ISO timestamp when the run completed"),
-            duration_ms: z
-                .number()
-                .optional()
-                .describe("Total duration of the run in milliseconds"),
-        }),
-    }, async ({ run_id, status, title, phases, summary, completed_at, duration_ms, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPatch(`/improvement-runs/${run_id}`, {
-            status,
-            title,
-            phases,
-            summary,
-            completed_at,
-            duration_ms,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("record_improvement_action", {
-        description: "Record an action taken during an improvement run. Use to track what was done for each issue: code fixes, deferrals, dismissals, etc. " +
-            "IMPORTANT: When recording code_fix actions, the code_changes.diff field must contain ACTUAL SOURCE CODE in unified diff format, " +
-            "not a description of what changed. Include the literal code lines with proper +/- prefixes.",
-        inputSchema: z.object({
-            run_id: z.string().describe("The ID of the improvement run"),
-            issue_id: z
-                .string()
-                .optional()
-                .describe("The ID of the issue this action relates to (if any)"),
-            action_type: z
-                .enum([
-                "code_fix",
-                "needs_more_data",
-                "dismissed",
-                "marked_intended",
-                "knowledge_added",
-            ])
-                .describe("Type of action taken"),
-            hypothesis: z.string().describe("AI's reasoning for this action"),
-            expected_improvement: z
-                .string()
-                .describe("What improvement is expected from this action"),
-            code_changes: z
-                .array(z.object({
-                file: z.string().describe("Path to the changed file"),
-                diff: z
-                    .string()
-                    .describe("CRITICAL: Must be actual source code in unified diff format, NOT a description of changes. " +
-                    "This field must contain the literal code lines that were changed.\n\n" +
-                    "FORMAT REQUIREMENTS:\n" +
-                    "1. Start with @@ header: @@ -oldStart,oldCount +newStart,newCount @@\n" +
-                    "2. Context lines (unchanged): prefix with single space ' '\n" +
-                    "3. Removed lines: prefix with minus '-'\n" +
-                    "4. Added lines: prefix with plus '+'\n" +
-                    "5. Include 5 lines of context before and after the change\n\n" +
-                    "CORRECT EXAMPLE:\n" +
-                    "@@ -35,7 +35,9 @@\n" +
-                    " import { Spinner } from '@chakra-ui/react';\n" +
-                    " \n" +
-                    " export function FilterDropdown({ filters }) {\n" +
-                    "-  const [isOpen, setIsOpen] = useState(false);\n" +
-                    "+  const [isOpen, setIsOpen] = useState(false);\n" +
-                    "+  const [isLoading, setIsLoading] = useState(false);\n" +
-                    "   const handleClick = () => {\n" +
-                    " \n\n" +
-                    "WRONG (do NOT do this):\n" +
-                    "- 'Added isLoading state to provide feedback'\n" +
-                    "- 'Changed the button to show a spinner'\n" +
-                    "- Any prose description instead of actual code"),
-                startLine: z
-                    .number()
-                    .describe("Line number in the original file where the first line of the diff begins (the first context line)"),
-                linesAdded: z
-                    .number()
-                    .default(0)
-                    .describe("Count of lines added (lines starting with '+')"),
-                linesRemoved: z
-                    .number()
-                    .default(0)
-                    .describe("Count of lines removed (lines starting with '-')"),
-            }))
-                .optional()
-                .describe("Array of code changes. Each diff MUST contain actual source code lines, not descriptions."),
-            pr_url: z
-                .string()
-                .optional()
-                .describe("GitHub PR URL if a PR was created"),
-            pr_number: z.number().optional().describe("GitHub PR number"),
-            remediation_id: z
-                .string()
-                .optional()
-                .describe("ID of the associated remediation record (if any)"),
-            deferral_reason: z
-                .string()
-                .optional()
-                .describe("Explanation for why the issue was deferred (for needs_more_data actions)"),
-            dismissal_reason: z
-                .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, page_path, element_selector, diagnosis, proposed_fix, confidence, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost(`/improvement-runs/${run_id}/actions`, {
-            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 (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 {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("get_improvement_run", {
-        description: "Get details of a specific improvement run including all actions taken. Use to review what happened during a run.",
-        inputSchema: z.object({
-            run_id: z
-                .string()
-                .describe("The ID of the improvement run to retrieve"),
-        }),
-    }, async ({ run_id }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet(`/improvement-runs/${run_id}`);
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("list_improvement_runs", {
-        description: "List recent improvement runs with optional filters. Use to review past runs and their outcomes.",
-        inputSchema: z.object({
-            status: z
-                .enum(["running", "completed", "failed", "cancelled"])
-                .optional()
-                .describe("Filter by run status"),
-            trigger_type: z
-                .enum(["github_actions", "cron", "manual", "api"])
-                .optional()
-                .describe("Filter by trigger type"),
-            limit: z
-                .number()
-                .optional()
-                .default(20)
-                .describe("Maximum number of results (default: 20)"),
-            offset: z
-                .number()
-                .optional()
-                .default(0)
-                .describe("Offset for pagination"),
-        }),
-    }, async ({ status, trigger_type, limit, offset, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/improvement-runs", {
-            status,
-            trigger_type,
-            limit: limit ?? 20,
-            offset: offset ?? 0,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/knowledge.d.ts

@@ -1,6 +0,0 @@
-/**
- * Knowledge tools for self-improvement workflow.
- *
- * Provides site-specific knowledge management for learning from past fixes.
- */
-export declare function registerKnowledgeTools(server: any): void;

package/dist/tools/knowledge.js

@@ -1,186 +0,0 @@
-/**
- * Knowledge tools for self-improvement workflow.
- *
- * Provides site-specific knowledge management for learning from past fixes.
- */
-import { z } from "zod";
-import { apiGet, apiPost, apiDelete, isApiConfigured } from "../api/client.js";
-const KNOWLEDGE_CATEGORIES = [
-    "false_positive",
-    "intended_behavior",
-    "fix_pattern",
-    "context",
-];
-const ISSUE_CATEGORIES = [
-    "code_error",
-    "dead_click",
-    "rage_click",
-    "ux_friction",
-    "performance",
-    "form_issue",
-    "behavioral_anomaly",
-    "structural_issue",
-];
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerKnowledgeTools(server) {
-    server.registerTool("get_site_knowledge", {
-        description: "Retrieve site-specific learnings including known false positives, intended behaviors, and successful fix patterns. Use at the start of a self-improvement workflow to avoid re-flagging known issues.",
-        inputSchema: z.object({
-            category: z
-                .enum(KNOWLEDGE_CATEGORIES)
-                .optional()
-                .describe("Filter by knowledge category"),
-            page_path: z.string().optional().describe("Filter by page path"),
-            issue_category: z
-                .enum(ISSUE_CATEGORIES)
-                .optional()
-                .describe("Filter by issue category"),
-            limit: z
-                .number()
-                .optional()
-                .default(50)
-                .describe("Maximum number of entries to return (default: 50)"),
-        }),
-    }, async ({ category, page_path, issue_category, limit, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/knowledge", {
-            category,
-            page_path,
-            issue_category,
-            limit: limit ?? 50,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("add_site_knowledge", {
-        description: "Store a site-specific learning. Use to record false positives, intended behaviors, successful fix patterns, or important context about the site.",
-        inputSchema: z.object({
-            category: z
-                .enum(KNOWLEDGE_CATEGORIES)
-                .describe("Category of knowledge: false_positive, intended_behavior, fix_pattern, or context"),
-            subject: z
-                .string()
-                .describe("Unique identifier/title for this knowledge entry"),
-            content: z.string().describe("Detailed description of the learning"),
-            page_path: z
-                .string()
-                .optional()
-                .describe("Associated page path (if applicable)"),
-            element_selector: z
-                .string()
-                .optional()
-                .describe("Associated element selector (if applicable)"),
-            issue_category: z
-                .enum(ISSUE_CATEGORIES)
-                .optional()
-                .describe("Associated issue category (if applicable)"),
-        }),
-    }, async ({ category, subject, content, page_path, element_selector, issue_category, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost("/knowledge", {
-            category,
-            subject,
-            content,
-            page_path,
-            element_selector,
-            issue_category,
-            source: "agent",
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("delete_site_knowledge", {
-        description: "Delete a site knowledge entry. Use when a learning is no longer valid or was created in error.",
-        inputSchema: z.object({
-            knowledge_id: z
-                .string()
-                .describe("The ID of the knowledge entry to delete"),
-        }),
-    }, async ({ knowledge_id }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiDelete(`/knowledge/${knowledge_id}`);
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("get_similar_fixes", {
-        description: "Find past fixes for similar issues. Returns successful and failed remediation attempts for issues with the same category, page, or element. Use before proposing a fix to learn from past attempts.",
-        inputSchema: z.object({
-            issue_id: z
-                .string()
-                .describe("The ID of the issue to find similar fixes for"),
-            limit: z
-                .number()
-                .optional()
-                .default(5)
-                .describe("Maximum number of similar fixes to return (default: 5)"),
-        }),
-    }, async ({ issue_id, limit }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/knowledge/similar-fixes", {
-            issue_id,
-            limit: limit ?? 5,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/listPages.d.ts

@@ -1,6 +0,0 @@
-/**
- * list_pages tool
- *
- * List all tracked pages with basic metrics.
- */
-export declare function registerListPages(server: any): void;

package/dist/tools/listPages.js

@@ -1,50 +0,0 @@
-/**
- * list_pages tool
- *
- * List all tracked pages with basic metrics.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerListPages(server) {
-    server.registerTool("list_pages", {
-        description: "List all tracked pages with basic metrics. " +
-            "Returns page paths sorted by session count with frustration and health grade. " +
-            "Use this to discover what pages are being tracked before diving into specific pages.",
-        inputSchema: z.object({
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to look back (default 7)"),
-            limit: z
-                .number()
-                .optional()
-                .default(50)
-                .describe("Maximum number of pages to return (default 50)"),
-        }),
-    }, async ({ days, limit }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/pages/list", {
-            days: days ?? 7,
-            limit: limit ?? 50,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/listSessions.d.ts

@@ -1,7 +0,0 @@
-/**
- * list_sessions tool
- *
- * Lists and filters recorded sessions.
- * Thin proxy to external-api /sessions endpoint.
- */
-export declare function registerListSessions(server: any): void;