@recapt/mcp 0.0.18-beta → 0.0.20-beta

package/dist/tools/getPageMetrics.js

@@ -1,47 +0,0 @@
-/**
- * get_page_metrics tool
- *
- * Returns aggregated behavioral metrics for a specific page or all pages.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetPageMetrics(server) {
-    server.registerTool("get_page_metrics", {
-        description: "Get aggregated behavioral metrics for a page. Returns frustration, confusion, confidence, energy scores, and health score. If page_path is omitted, returns metrics for all pages.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Page path to get metrics for (e.g., /checkout). Omit to get all pages."),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to look back (default: 7)"),
-        }),
-    }, async ({ page_path, days }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/pages", {
-            page_path,
-            days,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getPageTrends.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_page_trends tool
- *
- * Returns daily behavioral trends for a page.
- */
-export declare function registerGetPageTrends(server: any): void;

package/dist/tools/getPageTrends.js

@@ -1,46 +0,0 @@
-/**
- * get_page_trends tool
- *
- * Returns daily behavioral trends for a page.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetPageTrends(server) {
-    server.registerTool("get_page_trends", {
-        description: "Get daily behavioral trends for a page. Shows how frustration, confusion, and confidence change over time.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .describe("Page path to analyze (e.g., /checkout)"),
-            days: z
-                .number()
-                .optional()
-                .default(14)
-                .describe("Number of days to look back (default: 14)"),
-        }),
-    }, async ({ page_path, days }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/trends", {
-            page_path,
-            days: days ?? 14,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getSessionDetails.d.ts

@@ -1,6 +0,0 @@
-/**
- * get_session_details tool
- *
- * Returns behavioral timeline for one or more sessions.
- */
-export declare function registerGetSessionDetails(server: any): void;

package/dist/tools/getSessionDetails.js

@@ -1,70 +0,0 @@
-/**
- * get_session_details tool
- *
- * Returns behavioral timeline for one or more sessions.
- */
-import { z } from "zod";
-import { apiGet, apiPost, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetSessionDetails(server) {
-    server.registerTool("get_session_details", {
-        description: "Get behavioral timeline for one or more sessions. Shows how frustration, confusion, and confidence evolved over time. Accepts a single session_id or an array of session_ids (max 20).",
-        inputSchema: z.object({
-            session_id: z
-                .string()
-                .optional()
-                .describe("Single session ID to get details for"),
-            session_ids: z
-                .array(z.string())
-                .max(20)
-                .optional()
-                .describe("Array of session IDs to get details for (max 20)"),
-        }),
-    }, async ({ session_id, session_ids, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (!session_id && (!session_ids || session_ids.length === 0)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: "Either session_id or session_ids must be provided",
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (session_id && !session_ids) {
-            const { data, error } = await apiGet(`/sessions/${session_id}`);
-            if (error) {
-                return {
-                    content: [{ type: "text", text: JSON.stringify({ error }) }],
-                    isError: true,
-                };
-            }
-            return { content: [{ type: "text", text: JSON.stringify(data) }] };
-        }
-        const ids = session_ids ?? [session_id];
-        const { data, error } = await apiPost("/sessions/details", {
-            session_ids: ids,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getSessionPages.d.ts

@@ -1,7 +0,0 @@
-/**
- * get_session_pages tool
- *
- * Returns the pages visited within one or more sessions.
- * Thin proxy to external-api /sessions/:id/pages and /sessions/pages endpoints.
- */
-export declare function registerGetSessionPages(server: any): void;

package/dist/tools/getSessionPages.js

@@ -1,74 +0,0 @@
-/**
- * get_session_pages tool
- *
- * Returns the pages visited within one or more sessions.
- * Thin proxy to external-api /sessions/:id/pages and /sessions/pages endpoints.
- */
-import { z } from "zod";
-import { apiGet, apiPost, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetSessionPages(server) {
-    server.registerTool("get_session_pages", {
-        description: "Get the pages visited within one or more sessions. Returns navigation history " +
-            "with timestamps, source pages, and dwell times. Use this to understand the " +
-            "user's journey through the site during a session. Accepts a single session_id " +
-            "or an array of session_ids (max 20).",
-        inputSchema: z.object({
-            session_id: z
-                .string()
-                .optional()
-                .describe("Single session ID to get pages for"),
-            session_ids: z
-                .array(z.string())
-                .max(20)
-                .optional()
-                .describe("Array of session IDs to get pages for (max 20)"),
-        }),
-    }, async ({ session_id, session_ids, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (!session_id && (!session_ids || session_ids.length === 0)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: "Either session_id or session_ids must be provided",
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (session_id && !session_ids) {
-            const { data, error } = await apiGet(`/sessions/${session_id}/pages`);
-            if (error) {
-                return {
-                    content: [{ type: "text", text: JSON.stringify({ error }) }],
-                    isError: true,
-                };
-            }
-            return { content: [{ type: "text", text: JSON.stringify(data) }] };
-        }
-        const ids = session_ids ?? [session_id];
-        const { data, error } = await apiPost("/sessions/pages", {
-            session_ids: ids,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/getUxHealthReport.d.ts

@@ -1,7 +0,0 @@
-/**
- * get_ux_health_report tool
- *
- * Returns a comprehensive UX health report for the website or a specific page.
- * Thin proxy to external-api /health-report endpoint.
- */
-export declare function registerGetUxHealthReport(server: any): void;

package/dist/tools/getUxHealthReport.js

@@ -1,50 +0,0 @@
-/**
- * get_ux_health_report tool
- *
- * Returns a comprehensive UX health report for the website or a specific page.
- * Thin proxy to external-api /health-report endpoint.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerGetUxHealthReport(server) {
-    server.registerTool("get_ux_health_report", {
-        description: "Get a comprehensive UX health report combining page metrics, issues, and anomalies. " +
-            "Returns overall health score, per-page breakdown, active issues, and frustration spikes. " +
-            "Use this as a starting point to understand overall UX state before diving deeper.",
-        inputSchema: z.object({
-            page_path: z
-                .string()
-                .optional()
-                .describe("Focus on a specific page (omit for site-wide report)"),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to analyze (default: 7)"),
-        }),
-    }, async ({ page_path, days }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/health-report", {
-            page_path,
-            days: days ?? 7,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/improvementRun.d.ts

@@ -1,6 +0,0 @@
-/**
- * Improvement Run tools for tracking self-improvement workflow executions.
- *
- * Provides run registration, phase updates, action recording, and run listing.
- */
-export declare function registerImprovementRunTools(server: any): void;

package/dist/tools/improvementRun.js

@@ -1,315 +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"),
-            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, 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,
-            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)"),
-        }),
-    }, async ({ run_id, issue_id, action_type, hypothesis, expected_improvement, code_changes, pr_url, pr_number, remediation_id, deferral_reason, dismissal_reason, }) => {
-        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,
-        });
-        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;