@recapt/mcp 0.0.18-beta → 0.0.20-beta

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;

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;