@recapt/mcp 0.0.19-beta → 0.0.20-beta

package/dist/tools/listSessions.js

@@ -1,67 +0,0 @@
-/**
- * list_sessions tool
- *
- * Lists and filters recorded sessions.
- * Thin proxy to external-api /sessions endpoint.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerListSessions(server) {
-    server.registerTool("list_sessions", {
-        description: "List and filter recorded sessions. Returns session metadata including status, " +
-            "duration, device, browser, and domains. Use to find sessions for a domain, " +
-            "check for active sessions, or browse by device type.",
-        inputSchema: z.object({
-            domain: z
-                .string()
-                .optional()
-                .describe("Filter by domain name (partial match supported)"),
-            status: z
-                .enum(["active", "terminated", "all"])
-                .optional()
-                .default("all")
-                .describe("Filter by session status"),
-            device: z
-                .enum(["desktop", "mobile", "tablet"])
-                .optional()
-                .describe("Filter by device type"),
-            days: z
-                .number()
-                .optional()
-                .default(7)
-                .describe("Number of days to look back (default: 7)"),
-            limit: z
-                .number()
-                .optional()
-                .default(20)
-                .describe("Maximum sessions to return (default: 20, max: 200)"),
-        }),
-    }, async ({ domain, status, device, days, limit, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/sessions", {
-            domain,
-            status: status === "all" ? undefined : status,
-            device,
-            days: days ?? 7,
-            limit: limit ?? 20,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/memory.d.ts

@@ -1,7 +0,0 @@
-/**
- * Memory management tools for MCP sessions.
- *
- * Provides working memory for AI agents to store intermediate results
- * and query across stored data without re-fetching.
- */
-export declare function registerMemoryTools(server: any): void;

package/dist/tools/memory.js

@@ -1,119 +0,0 @@
-/**
- * Memory management tools for MCP sessions.
- *
- * Provides working memory for AI agents to store intermediate results
- * and query across stored data without re-fetching.
- */
-import { z } from "zod";
-const memoryStore = new Map();
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerMemoryTools(server) {
-    server.registerTool("memory_save", {
-        description: "Save a value to working memory for later retrieval. " +
-            "Use this to store intermediate results from tool calls that you want to reference later.",
-        inputSchema: z.object({
-            key: z.string().describe("Unique key to store the value under"),
-            value: z.string().describe("Value to store (will be stored as string)"),
-            annotation: z
-                .string()
-                .optional()
-                .describe("Optional note about what this data represents"),
-        }),
-    }, async ({ key, value, annotation, }) => {
-        memoryStore.set(key, {
-            key,
-            value,
-            timestamp: Date.now(),
-            annotation,
-        });
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify({ success: true, key, size: value.length }),
-                },
-            ],
-        };
-    });
-    server.registerTool("memory_recall", {
-        description: "Retrieve a value from working memory by key. " +
-            "Use this to access data you previously stored with memory_save.",
-        inputSchema: z.object({
-            key: z.string().describe("Key to retrieve"),
-        }),
-    }, async ({ key }) => {
-        const entry = memoryStore.get(key);
-        if (!entry) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: `Key "${key}" not found in memory`,
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: entry.value,
-                },
-            ],
-        };
-    });
-    server.registerTool("memory_list", {
-        description: "List all keys currently stored in working memory. " +
-            "Returns key names, sizes, timestamps, and annotations.",
-        inputSchema: z.object({}),
-    }, async () => {
-        const entries = [...memoryStore.values()].map((entry) => ({
-            key: entry.key,
-            size: entry.value.length,
-            timestamp: new Date(entry.timestamp).toISOString(),
-            annotation: entry.annotation,
-        }));
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify({ count: entries.length, entries }),
-                },
-            ],
-        };
-    });
-    server.registerTool("memory_delete", {
-        description: "Delete a value from working memory by key.",
-        inputSchema: z.object({
-            key: z.string().describe("Key to delete"),
-        }),
-    }, async ({ key }) => {
-        const existed = memoryStore.delete(key);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify({ success: true, deleted: existed }),
-                },
-            ],
-        };
-    });
-    server.registerTool("memory_clear", {
-        description: "Clear all values from working memory. Use with caution.",
-        inputSchema: z.object({}),
-    }, async () => {
-        const count = memoryStore.size;
-        memoryStore.clear();
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify({ success: true, cleared: count }),
-                },
-            ],
-        };
-    });
-}

package/dist/tools/predictOutcomes.d.ts

@@ -1,6 +0,0 @@
-/**
- * predict_outcomes tool
- *
- * Predict session outcomes based on behavioral features.
- */
-export declare function registerPredictOutcomes(server: any): void;

package/dist/tools/predictOutcomes.js

@@ -1,66 +0,0 @@
-/**
- * predict_outcomes tool
- *
- * Predict session outcomes based on behavioral features.
- */
-import { z } from "zod";
-import { apiPost, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerPredictOutcomes(server) {
-    server.registerTool("predict_outcomes", {
-        description: "Predict session outcomes based on early behavioral signals. " +
-            "Provide either a session_id to analyze an existing session, or behavioral_features " +
-            "to predict outcomes for hypothetical scenarios. " +
-            "Returns predicted outcome (COMPLETED, STRUGGLED, BLOCKED, DISENGAGED) with confidence.",
-        inputSchema: z.object({
-            session_id: z
-                .string()
-                .optional()
-                .describe("Session ID to analyze and predict outcome for"),
-            behavioral_features: z
-                .object({
-                frustration: z.number().describe("Frustration score (0-1)"),
-                confusion: z.number().describe("Confusion score (0-1)"),
-                confidence: z.number().describe("Confidence score (0-1)"),
-            })
-                .optional()
-                .describe("Behavioral features to use for prediction"),
-        }),
-    }, async ({ session_id, behavioral_features, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (!session_id && !behavioral_features) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: "Either session_id or behavioral_features is required",
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost("/predict", {
-            session_id,
-            behavioral_features,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-}

package/dist/tools/remediation.d.ts

@@ -1,6 +0,0 @@
-/**
- * Remediation tools for self-improvement workflow.
- *
- * Provides fix proposal, deployment confirmation, evaluation, and history tracking.
- */
-export declare function registerRemediationTools(server: any): void;

package/dist/tools/remediation.js

@@ -1,335 +0,0 @@
-/**
- * Remediation tools for self-improvement workflow.
- *
- * Provides fix proposal, deployment confirmation, evaluation, and history tracking.
- */
-import { z } from "zod";
-import { apiGet, apiPost, apiPatch, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerRemediationTools(server) {
-    server.registerTool("propose_fix", {
-        description: "Propose a fix for an issue. Creates a remediation record with baseline metrics for later evaluation. Include detailed diagnosis and code suggestions when possible.",
-        inputSchema: z.object({
-            issue_id: z.string().describe("The ID of the issue to fix"),
-            diagnosis: z
-                .string()
-                .describe("Detailed analysis of the root cause of the issue"),
-            proposed_fix: z
-                .string()
-                .describe("Description of the proposed fix and how it addresses the root cause"),
-            code_snippet: z
-                .string()
-                .optional()
-                .describe("Suggested code changes (if applicable)"),
-            affected_files: z
-                .array(z.string())
-                .optional()
-                .describe("List of files that need to be modified"),
-            confidence: z
-                .number()
-                .min(0)
-                .max(1)
-                .describe("Confidence level in the fix (0-1). Use <0.7 when uncertain."),
-        }),
-    }, async ({ issue_id, diagnosis, proposed_fix, code_snippet, affected_files, confidence, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost("/remediations", {
-            issue_id,
-            diagnosis,
-            proposed_fix,
-            code_snippet,
-            affected_files,
-            confidence,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("list_pending_fixes", {
-        description: "List all proposed fixes awaiting deployment. Use to show the user what fixes are ready to be deployed.",
-        inputSchema: z.object({}),
-    }, async () => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/remediations/pending");
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("list_remediations", {
-        description: "List remediation records with optional filters. Use to review past and current fix attempts.",
-        inputSchema: z.object({
-            status: z
-                .enum([
-                "proposed",
-                "waiting",
-                "dismissed",
-                "deployed",
-                "evaluating",
-                "succeeded",
-                "failed",
-                "reverted",
-            ])
-                .optional()
-                .describe("Filter by remediation status"),
-            issue_id: z.string().optional().describe("Filter by issue ID"),
-            page_path: z.string().optional().describe("Filter by page path"),
-            limit: z
-                .number()
-                .optional()
-                .default(20)
-                .describe("Maximum number of results (default: 20)"),
-        }),
-    }, async ({ status, issue_id, page_path, limit, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/remediations", {
-            status,
-            issue_id,
-            page_path,
-            limit: limit ?? 20,
-        });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("confirm_deployment", {
-        description: "Confirm that a proposed fix has been deployed to production. This starts the evaluation timer. Call this when the user confirms they have deployed the fix.",
-        inputSchema: z.object({
-            remediation_id: z
-                .string()
-                .describe("The ID of the remediation to mark as deployed"),
-        }),
-    }, async ({ remediation_id }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPatch(`/remediations/${remediation_id}/deploy`, {});
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("evaluate_fix", {
-        description: "Evaluate if a deployed fix improved metrics. Compares post-deployment metrics to baseline. Returns success/partial/failed outcome with detailed verdict. Wait at least 24 hours after deployment for reliable results.",
-        inputSchema: z.object({
-            remediation_id: z
-                .string()
-                .describe("The ID of the remediation to evaluate"),
-            min_hours: z
-                .number()
-                .optional()
-                .default(24)
-                .describe("Minimum hours since deployment required (default: 24)"),
-        }),
-    }, async ({ remediation_id, min_hours, }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiPost(`/remediations/${remediation_id}/evaluate`, { min_hours: min_hours ?? 24 });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    server.registerTool("get_fix_history", {
-        description: "Get the full remediation history for an issue. Shows all fix attempts, their outcomes, and current status. Use before proposing a new fix to learn from past attempts.",
-        inputSchema: z.object({
-            issue_id: z
-                .string()
-                .describe("The ID of the issue to get fix history for"),
-        }),
-    }, async ({ issue_id }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet(`/remediations/history/${issue_id}`);
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        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/dist/tools/scanSite.d.ts

@@ -1,6 +0,0 @@
-/**
- * scan_site tool
- *
- * One-shot site health scan across all pages.
- */
-export declare function registerScanSite(server: any): void;

package/dist/tools/scanSite.js

@@ -1,51 +0,0 @@
-/**
- * scan_site tool
- *
- * One-shot site health scan across all pages.
- */
-import { z } from "zod";
-import { apiGet, isApiConfigured } from "../api/client.js";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerScanSite(server) {
-    server.registerTool("scan_site", {
-        description: "One-shot site health scan. Lists all pages and computes aggregate metrics " +
-            "for the top-N pages (default 10) sorted by session count. Returns a ranked " +
-            "table with frustration and health grade per page. " +
-            "Use this as the FIRST tool when the user asks a broad question without naming a specific page.",
-        inputSchema: z.object({
-            top_n: z
-                .number()
-                .optional()
-                .default(10)
-                .describe("Number of top pages to analyze (default 10)"),
-            offset: z
-                .number()
-                .optional()
-                .default(0)
-                .describe("Skip first N pages for pagination (default 0)"),
-        }),
-    }, async ({ top_n, offset }) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { data, error } = await apiGet("/site/overview", {
-            top_n: top_n ?? 10,
-            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/searchSessions.d.ts

@@ -1,6 +0,0 @@
-/**
- * search_sessions tool
- *
- * Search sessions by natural language query using vector search.
- */
-export declare function registerSearchSessions(server: any): void;