@recapt/mcp 0.0.17-beta → 0.0.19-beta

package/dist/api/client.d.ts

@@ -1,14 +1,6 @@
 /**
  * HTTP client for calling external-api query endpoints.
+ *
+ * Re-exports from @glimt/mcp-tools for backward compatibility.
  */
-export declare function isApiConfigured(): boolean;
-export declare function getApiUrl(): string;
-interface ApiResponse<T> {
-    data?: T;
-    error?: string;
-}
-export declare function apiGet<T>(path: string, params?: Record<string, string | number | undefined>): Promise<ApiResponse<T>>;
-export declare function apiPost<T>(path: string, body?: Record<string, unknown>): Promise<ApiResponse<T>>;
-export declare function apiPatch<T>(path: string, body?: Record<string, unknown>): Promise<ApiResponse<T>>;
-export declare function apiDelete<T>(path: string): Promise<ApiResponse<T>>;
-export {};
+export { isApiConfigured, getApiUrl, apiGet, apiPost, apiPatch, apiDelete, } from "@glimt/mcp-tools";

package/dist/api/client.js

@@ -1,67 +1,6 @@
 /**
  * HTTP client for calling external-api query endpoints.
+ *
+ * Re-exports from @glimt/mcp-tools for backward compatibility.
  */
-const API_URL = process.env.RECAPT_API_URL ||
-    process.env.EXTERNAL_API_URL ||
-    "https://api.recapt.app";
-const SECRET_KEY = process.env.RECAPT_SECRET_KEY;
-const REQUEST_TIMEOUT_MS = 120_000;
-export function isApiConfigured() {
-    return !!SECRET_KEY;
-}
-export function getApiUrl() {
-    return API_URL;
-}
-async function request(options) {
-    const { method, path, params, body } = options;
-    if (!SECRET_KEY) {
-        return { error: "RECAPT_SECRET_KEY not configured" };
-    }
-    const url = new URL(`${API_URL}/v1beta/query${path}`);
-    if (params) {
-        for (const [key, value] of Object.entries(params)) {
-            if (value !== undefined) {
-                url.searchParams.set(key, String(value));
-            }
-        }
-    }
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
-    try {
-        const res = await fetch(url.toString(), {
-            method,
-            headers: {
-                "x-private-key": SECRET_KEY,
-                "Content-Type": "application/json",
-            },
-            body: body ? JSON.stringify(body) : undefined,
-            signal: controller.signal,
-        });
-        clearTimeout(timeout);
-        if (!res.ok) {
-            const errorBody = (await res.json().catch(() => ({})));
-            return { error: errorBody.error || `HTTP ${res.status}` };
-        }
-        const data = (await res.json());
-        return { data };
-    }
-    catch (err) {
-        clearTimeout(timeout);
-        if (err instanceof Error && err.name === "AbortError") {
-            return { error: `Request timed out after ${REQUEST_TIMEOUT_MS / 1000}s` };
-        }
-        return { error: err instanceof Error ? err.message : String(err) };
-    }
-}
-export function apiGet(path, params) {
-    return request({ method: "GET", path, params });
-}
-export function apiPost(path, body = {}) {
-    return request({ method: "POST", path, body });
-}
-export function apiPatch(path, body = {}) {
-    return request({ method: "PATCH", path, body });
-}
-export function apiDelete(path) {
-    return request({ method: "DELETE", path });
-}
+export { isApiConfigured, getApiUrl, apiGet, apiPost, apiPatch, apiDelete, } from "@glimt/mcp-tools";

package/dist/cli/commands/setup.js

@@ -30,7 +30,7 @@ function openBrowser(url) {
     });
 }
 function validateMcpKey(key) {
-    return (key.startsWith(MCP_KEY_PREFIX) && key.length > MCP_KEY_PREFIX.length + 10);
+    return key.startsWith(MCP_KEY_PREFIX);
 }
 async function promptForKey() {
     const hasKey = await confirm("Do you have a Recapt MCP key?", false);

package/dist/index.d.ts

@@ -6,14 +6,15 @@
  * Uses a search_tools + call_tool pattern to minimize context while
  * providing access to 40+ analysis tools.
  *
- * Exposed tools (10):
+ * Exposed tools (11):
  * - search_tools: Discover tools by intent
  * - call_tool: Execute discovered tools
  * - get_domains: List tracked domains
  * - run_full_diagnostic: Self-improvement entry point
  * - triage_sessions: Find sessions needing attention
+ * - get_upgrade_options: Check available plan upgrades
  * - memory_save, memory_recall, memory_list, memory_delete, memory_clear
  *
- * Hidden tools (38): Accessible via call_tool after discovery with search_tools
+ * Hidden tools (50+): Accessible via call_tool after discovery with search_tools
  */
 import "dotenv/config";

package/dist/index.js

@@ -6,210 +6,44 @@
  * Uses a search_tools + call_tool pattern to minimize context while
  * providing access to 40+ analysis tools.
  *
- * Exposed tools (10):
+ * Exposed tools (11):
  * - search_tools: Discover tools by intent
  * - call_tool: Execute discovered tools
  * - get_domains: List tracked domains
  * - run_full_diagnostic: Self-improvement entry point
  * - triage_sessions: Find sessions needing attention
+ * - get_upgrade_options: Check available plan upgrades
  * - memory_save, memory_recall, memory_list, memory_delete, memory_clear
  *
- * Hidden tools (38): Accessible via call_tool after discovery with search_tools
+ * Hidden tools (50+): Accessible via call_tool after discovery with search_tools
  */
 import "dotenv/config";
 // @ts-ignore - MCP SDK types are complex
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 // @ts-ignore - MCP SDK types are complex
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { isApiConfigured, getApiUrl, apiGet, apiPost, apiPatch, apiDelete, } from "./api/client.js";
+import { isApiConfigured, getApiUrl, allTools, hiddenTools, getDomainsTool, runFullDiagnosticTool, triageSessionsTool, getUpgradeOptionsTool, } from "@glimt/mcp-tools";
 import { registerSearchTools, registerCallTool, registerToolHandler, } from "./tools/catalog/index.js";
-// ─────────────────────────────────────────────────────────────────────────────
-// Exposed Tools - Registered directly with the MCP server
-// ─────────────────────────────────────────────────────────────────────────────
-import { registerGetDomains } from "./tools/getDomains.js";
 import { registerMemoryTools } from "./tools/memory.js";
-import { registerTriageSessions } from "./tools/triageSessions.js";
-import { registerDiagnosticTools } from "./tools/diagnostic.js";
-import { registerGetUpgradeOptions } from "./tools/upgradeOptions.js";
 // ─────────────────────────────────────────────────────────────────────────────
-// Hidden Tool Handlers - Registered with call_tool registry
+// Tool Registration
 // ─────────────────────────────────────────────────────────────────────────────
-function createApiHandler(method, endpoint, buildParams) {
-    return async (args) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const url = typeof endpoint === "function" ? endpoint(args) : endpoint;
-        const params = buildParams ? buildParams(args) : args;
-        const apiCall = {
-            GET: () => apiGet(url, params),
-            POST: () => apiPost(url, params),
-            PATCH: () => apiPatch(url, params),
-            DELETE: () => apiDelete(url),
-        }[method];
-        const { data, error } = await apiCall();
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    };
+/**
+ * Register a tool definition with the MCP server.
+ * The MCP SDK accepts Zod schemas directly via .shape
+ */
+function registerToolWithServer(server, tool) {
+    // Use type assertion to avoid "Type instantiation is excessively deep" error
+    // The MCP SDK's complex generic types cause TypeScript to struggle
+    server.tool(tool.name, tool.description, tool.inputSchema.shape, tool.handler);
 }
+/**
+ * Register all hidden tools with the call_tool registry.
+ */
 function registerHiddenTools() {
-    // Page Analysis
-    registerToolHandler("get_page_metrics", createApiHandler("GET", "/pages"));
-    registerToolHandler("get_element_friction", createApiHandler("GET", "/elements"));
-    registerToolHandler("get_page_trends", createApiHandler("GET", "/trends"));
-    registerToolHandler("get_dead_clicks", createApiHandler("GET", "/dead-clicks"));
-    registerToolHandler("get_console_errors", createApiHandler("GET", "/console-errors"));
-    registerToolHandler("get_form_friction", createApiHandler("GET", "/forms/friction"));
-    registerToolHandler("list_pages", createApiHandler("GET", "/pages/list"));
-    registerToolHandler("scan_site", createApiHandler("GET", "/site/overview", (args) => ({
-        top_n: args.top_n ?? 10,
-        offset: args.offset ?? 0,
-    })));
-    registerToolHandler("get_ux_health_report", createApiHandler("GET", "/health-report"));
-    // Flow Analysis
-    registerToolHandler("analyze_flow", createApiHandler("POST", "/flows/analyze"));
-    registerToolHandler("analyze_funnel", createApiHandler("POST", "/flows/funnel"));
-    registerToolHandler("get_flow_friction", createApiHandler("GET", "/flow-friction"));
-    registerToolHandler("get_journey_patterns", createApiHandler("GET", "/flows/patterns"));
-    // Issue Detection
-    registerToolHandler("get_issues", createApiHandler("GET", "/issues"));
-    registerToolHandler("get_actionable_issues", createApiHandler("GET", "/actionable-issues"));
-    registerToolHandler("get_anomalies", createApiHandler("GET", "/anomalies"));
-    registerToolHandler("detect_regressions", createApiHandler("GET", "/regressions"));
-    registerToolHandler("detect_drift", createApiHandler("GET", "/drift"));
-    // Comparison & Segmentation
-    registerToolHandler("compare_cohorts", createApiHandler("POST", "/cohorts/compare"));
-    registerToolHandler("compare_periods", createApiHandler("POST", "/pages/compare-periods"));
-    registerToolHandler("discover_personas", createApiHandler("GET", "/personas"));
-    // Session Analysis
-    registerToolHandler("search_sessions", createApiHandler("POST", "/sessions/search"));
-    registerToolHandler("list_sessions", createApiHandler("GET", "/sessions"));
-    registerToolHandler("get_session_pages", async (args) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { session_id, session_ids } = args;
-        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,
-            };
-        }
-        const isSingleSession = session_id && !session_ids;
-        const { data, error } = isSingleSession
-            ? await apiGet(`/sessions/${session_id}/pages`)
-            : await apiPost("/sessions/pages", {
-                session_ids: session_ids ?? [session_id],
-            });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    registerToolHandler("get_session_details", async (args) => {
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({ error: "API not configured" }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { session_id, session_ids } = args;
-        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,
-            };
-        }
-        const isSingleSession = session_id && !session_ids;
-        const { data, error } = isSingleSession
-            ? await apiGet(`/sessions/${session_id}`)
-            : await apiPost("/sessions/details", {
-                session_ids: session_ids ?? [session_id],
-            });
-        if (error) {
-            return {
-                content: [{ type: "text", text: JSON.stringify({ error }) }],
-                isError: true,
-            };
-        }
-        return { content: [{ type: "text", text: JSON.stringify(data) }] };
-    });
-    registerToolHandler("predict_outcomes", createApiHandler("POST", "/predict"));
-    // Diagnostic (investigate_issue and validate_issue - run_full_diagnostic is exposed)
-    registerToolHandler("investigate_issue", createApiHandler("GET", (args) => `/issues/${args.issue_id}/investigate`, (args) => ({ days: args.days ?? 7 })));
-    registerToolHandler("validate_issue", createApiHandler("POST", (args) => `/issues/${args.issue_id}/validate`, (args) => ({ lookback_days: args.lookback_days ?? 3 })));
-    // Triage
-    registerToolHandler("dismiss_issue", createApiHandler("POST", (args) => `/issues/${args.issue_id}/dismiss`, (args) => ({
-        reason: args.reason,
-        explanation: args.explanation,
-        create_knowledge: args.create_knowledge ?? true,
-    })));
-    registerToolHandler("mark_intended_behavior", createApiHandler("POST", (args) => `/issues/${args.issue_id}/mark-intended`, (args) => ({ explanation: args.explanation })));
-    registerToolHandler("get_issue_history", createApiHandler("GET", (args) => `/issues/${args.issue_id}/history`));
-    // Remediation
-    registerToolHandler("propose_fix", createApiHandler("POST", "/remediations"));
-    registerToolHandler("list_pending_fixes", createApiHandler("GET", "/remediations/pending"));
-    registerToolHandler("list_remediations", createApiHandler("GET", "/remediations"));
-    registerToolHandler("confirm_deployment", createApiHandler("PATCH", (args) => `/remediations/${args.remediation_id}/deploy`, () => ({})));
-    registerToolHandler("evaluate_fix", createApiHandler("POST", (args) => `/remediations/${args.remediation_id}/evaluate`, (args) => ({ min_hours: args.min_hours ?? 24 })));
-    registerToolHandler("get_fix_history", createApiHandler("GET", (args) => `/remediations/history/${args.issue_id}`));
-    // Knowledge
-    registerToolHandler("get_site_knowledge", createApiHandler("GET", "/knowledge"));
-    registerToolHandler("add_site_knowledge", createApiHandler("POST", "/knowledge", (args) => ({
-        ...args,
-        source: "agent",
-    })));
-    registerToolHandler("delete_site_knowledge", createApiHandler("DELETE", (args) => `/knowledge/${args.knowledge_id}`));
-    registerToolHandler("get_similar_fixes", createApiHandler("GET", "/knowledge/similar-fixes"));
-    // Improvement Runs (workflow tracking)
-    registerToolHandler("start_improvement_run", createApiHandler("POST", "/improvement-runs"));
-    registerToolHandler("update_improvement_run", createApiHandler("PATCH", (args) => `/improvement-runs/${args.run_id}`));
-    registerToolHandler("record_improvement_action", createApiHandler("POST", (args) => `/improvement-runs/${args.run_id}/actions`));
-    registerToolHandler("get_improvement_run", createApiHandler("GET", (args) => `/improvement-runs/${args.run_id}`));
-    registerToolHandler("list_improvement_runs", createApiHandler("GET", "/improvement-runs"));
+    for (const tool of hiddenTools) {
+        registerToolHandler(tool.name, tool.handler);
+    }
 }
 // ─────────────────────────────────────────────────────────────────────────────
 // Server Instructions
@@ -323,17 +157,20 @@ async function main() {
     });
     // Register hidden tool handlers first (for call_tool to use)
     registerHiddenTools();
-    // Register exposed tools
+    // Register search_tools and call_tool (MCP-specific implementations)
     registerSearchTools(server);
     registerCallTool(server);
-    registerGetDomains(server);
-    registerDiagnosticTools(server); // Includes run_full_diagnostic
-    registerTriageSessions(server);
-    registerGetUpgradeOptions(server);
+    // Register exposed tools from shared library
+    registerToolWithServer(server, getDomainsTool);
+    registerToolWithServer(server, runFullDiagnosticTool);
+    registerToolWithServer(server, triageSessionsTool);
+    registerToolWithServer(server, getUpgradeOptionsTool);
+    // Register memory tools (MCP-specific, stateful per session)
     registerMemoryTools(server);
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("[MCP] Server running on stdio (11 exposed tools, 38 hidden)");
+    console.error(`[MCP] Server running on stdio (11 exposed tools, ${hiddenTools.length} hidden)`);
+    console.error(`[MCP] Total tools available: ${allTools.length}`);
 }
 main().catch((err) => {
     console.error("[MCP] Fatal error:", err);