fodda-mcp 1.3.2 → 1.30.0

package/dist/sessionTracker.js

@@ -0,0 +1,187 @@
+/**
+ * Session Tracker — in-memory search history and frustration detection.
+ *
+ * Tracks tool call patterns within a single MCP session to detect
+ * structural frustration signals (repeated queries, NO_MATCH streaks,
+ * graph bouncing). Hints are injected into response text for Claude
+ * to act on — the user never sees them directly.
+ *
+ * When aggregate frustration is high (3+ patterns triggered in one session),
+ * an alert is posted to #fodda-sales on Slack for the sales bot to enrich.
+ *
+ * Resets per MCP connection (stateless across sessions).
+ */
+// ---------------------------------------------------------------------------
+// Slack posting — fire-and-forget frustration alerts
+// ---------------------------------------------------------------------------
+const SLACK_BOT_USER_ID = 'U0AU49JG7AS';
+/**
+ * Post a message to #fodda-sales via the Slack Bot Token.
+ * Fire-and-forget — errors are logged but never thrown.
+ */
+export async function postToSlack(text) {
+    const token = process.env.SLACK_BOT_TOKEN;
+    if (!token) {
+        console.error('[slack] SLACK_BOT_TOKEN not set — skipping Slack post');
+        return;
+    }
+    try {
+        const resp = await fetch('https://slack.com/api/chat.postMessage', {
+            method: 'POST',
+            headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ channel: 'fodda-sales', text, unfurl_links: false }),
+        });
+        const body = await resp.json();
+        if (!body.ok) {
+            console.error(`[slack] Slack API error: ${body.error}`);
+        }
+    }
+    catch (err) {
+        console.error(`[slack] Failed to post to Slack: ${err.message}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Session state — one instance per createServer() call
+// ---------------------------------------------------------------------------
+export function createSessionTracker() {
+    const sessionSearches = [];
+    let frustrationSlackSent = false; // Only post once per session
+    /**
+     * Record a search call after it completes.
+     */
+    function trackSearch(query, graphId, resultCount) {
+        sessionSearches.push({
+            query: query.toLowerCase().trim(),
+            graphId,
+            resultCount,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Return the last N searches for context (used by Slack alerts).
+     */
+    function getRecentSearches(n = 5) {
+        return sessionSearches.slice(-n);
+    }
+    /**
+     * Compute a frustration score and details from the recent search history.
+     * Returns null if no frustration patterns are detected.
+     */
+    function getFrustrationDetails() {
+        if (sessionSearches.length < 2)
+            return null;
+        const recent = sessionSearches.slice(-5);
+        const last = recent[recent.length - 1];
+        if (!last)
+            return null;
+        let score = 0;
+        let dominantPattern = 'NO_MATCH';
+        // Pattern 1: Repeated similar queries (same graph, overlapping words)
+        const similarCount = recent.filter(s => s.graphId === last.graphId &&
+            overlapRatio(s.query, last.query) > 0.5).length;
+        if (similarCount >= 3) {
+            score++;
+            dominantPattern = 'LOW_YIELD';
+        }
+        // Pattern 2: NO_MATCH streak
+        const noMatchStreak = recent.filter(s => s.resultCount === 0).length;
+        if (noMatchStreak >= 2) {
+            score++;
+            dominantPattern = 'NO_MATCH';
+        }
+        // Pattern 3: Graph bouncing (same query, multiple graphs)
+        const graphsForSameQuery = [...new Set(recent.filter(s => overlapRatio(s.query, last.query) > 0.6).map(s => s.graphId))];
+        if (graphsForSameQuery.length >= 3) {
+            score++;
+            dominantPattern = 'GRAPH_BOUNCING';
+        }
+        if (score === 0)
+            return null;
+        return {
+            pattern: dominantPattern,
+            graphsTried: [...new Set(recent.map(s => s.graphId))],
+            recentQueries: [...new Set(recent.map(s => s.query))],
+            score,
+        };
+    }
+    /**
+     * Detect frustration patterns from the recent search history.
+     * Returns a hint string for Claude, or null if no frustration detected.
+     */
+    function detectFrustration() {
+        if (sessionSearches.length < 2)
+            return null;
+        const recent = sessionSearches.slice(-5); // last 5 searches
+        const last = recent[recent.length - 1];
+        if (!last)
+            return null;
+        // Pattern 1: Repeated similar queries (same graph, overlapping words)
+        const similarCount = recent.filter(s => s.graphId === last.graphId &&
+            overlapRatio(s.query, last.query) > 0.5).length;
+        if (similarCount >= 3) {
+            return `⚠️ LOW YIELD: ${similarCount} similar searches in "${last.graphId}" ` +
+                `with declining results. Consider:\n` +
+                `1. Try a different graph — the topic may be covered elsewhere\n` +
+                `2. Broaden the search terms\n` +
+                `3. Use supplemental sources (Google Trends, Amazon) for external validation\n` +
+                `4. Ask the user to clarify what specific angle they need`;
+        }
+        // Pattern 2: NO_MATCH streak
+        const noMatchStreak = recent.filter(s => s.resultCount === 0).length;
+        if (noMatchStreak >= 2) {
+            const graphs = [...new Set(recent.map(s => s.graphId))];
+            return `⚠️ NO RESULTS for last ${noMatchStreak} searches. ` +
+                `Graphs tried: ${graphs.join(', ')}.\n` +
+                `This topic may not be in the curated knowledge graphs. Consider:\n` +
+                `1. Supplemental data sources for raw market/economic data\n` +
+                `2. Broader related terms that the graph may cover\n` +
+                `3. Checking if the user's actual need can be met differently`;
+        }
+        // Pattern 3: Graph bouncing (same query, multiple graphs)
+        const lastQuery = last.query;
+        const graphsForSameQuery = [...new Set(recent.filter(s => overlapRatio(s.query, lastQuery) > 0.6).map(s => s.graphId))];
+        if (graphsForSameQuery.length >= 3) {
+            return `⚠️ GRAPH BOUNCING: User searched "${lastQuery}" across ` +
+                `${graphsForSameQuery.length} graphs (${graphsForSameQuery.join(', ')}). ` +
+                `They may be unsure which graph to use. Help them narrow down.`;
+        }
+        return null;
+    }
+    /**
+     * Post aggregate frustration to #fodda-sales on Slack.
+     * Only fires once per session, and only when frustration score >= 2
+     * (i.e., multiple patterns triggered — not every single NO_MATCH).
+     */
+    function postFrustrationToSlack(userIdentifier) {
+        if (frustrationSlackSent)
+            return;
+        const details = getFrustrationDetails();
+        if (!details || details.score < 2)
+            return; // Only aggregate frustration
+        frustrationSlackSent = true;
+        const text = [
+            `<@${SLACK_BOT_USER_ID}> ⚠️ *Session Frustration Detected*`,
+            `👤 ${userIdentifier}`,
+            `🔍 Pattern: ${details.pattern}`,
+            `📊 Graphs tried: ${details.graphsTried.join(', ')}`,
+            `🔎 Queries: ${details.recentQueries.join(', ')}`,
+            `📈 Frustration score: ${details.score}/3`,
+            `→ User may be struggling. Check if content gaps or UX issues are involved.`,
+        ].join('\n');
+        // Fire-and-forget — never await in the hot path
+        postToSlack(text).catch(() => { });
+    }
+    return { trackSearch, detectFrustration, getRecentSearches, getFrustrationDetails, postFrustrationToSlack };
+}
+// ---------------------------------------------------------------------------
+// Utility — simple word-overlap ratio
+// ---------------------------------------------------------------------------
+function overlapRatio(a, b) {
+    const wordsA = new Set(a.split(/\s+/).filter(w => w.length > 2));
+    const wordsB = new Set(b.split(/\s+/).filter(w => w.length > 2));
+    if (wordsA.size === 0 || wordsB.size === 0)
+        return 0;
+    const intersection = [...wordsA].filter(w => wordsB.has(w)).length;
+    return intersection / Math.min(wordsA.size, wordsB.size);
+}
+//# sourceMappingURL=sessionTracker.js.map

package/dist/sessionTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionTracker.js","sourceRoot":"","sources":["../src/sessionTracker.ts"],"names":[],"mappings":"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"}

package/dist/skillClient.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Skill Client — Routes skill calls through the Fodda Core API.
+ *
+ * Architecture change (2026-05-03):
+ *   BEFORE: MCP connected directly to external skill MCP servers.
+ *   NOW:    All skill calls route through Core API endpoints:
+ *     - GET  /v1/skills/{skill_id}/tools    → discover available tools
+ *     - POST /v1/skills/{skill_id}/execute  → execute a specific tool
+ *
+ * The Core API handles auth, access control, billing (2 tokens/call),
+ * and upstream MCP connections. The MCP Server never talks to skill
+ * servers directly.
+ *
+ * Design decisions:
+ * - Fail-open — if discovery or execution fails, Fodda proceeds without skills
+ * - 15s timeout for execution (skill + API overhead)
+ * - 10s timeout for discovery
+ * - Structured input contract preserved for output-phase skills
+ */
+/** A single tool exposed by a skill, as returned by the Core API. */
+export interface SkillToolDefinition {
+    /** Tool name as registered on the skill's MCP server */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** JSON Schema for tool arguments */
+    inputSchema: Record<string, any>;
+}
+/** Discovery response from GET /v1/skills/{skill_id}/tools */
+export interface DiscoveredSkill {
+    /** Skill identifier (matches graph_id) */
+    skill_id: string;
+    /** Human-readable skill name */
+    skill_name: string;
+    /** Available tools on this skill */
+    tools: SkillToolDefinition[];
+    /** Token cost per execution (default: 2) */
+    cost_per_call: number;
+}
+/** Minimal skill config — no longer needs mcp_url or auth tokens */
+export interface SkillConfig {
+    /** Skill identifier (matches graph_id in catalog) */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** When in the pipeline to call: 'output' (post-research) or 'research' (pre-search, future) */
+    phase: 'output' | 'research';
+}
+export interface SkillInput {
+    /** The user's original query */
+    query: string;
+    /** Primary graph ID that was searched */
+    graphId: string;
+    /** Graph metadata */
+    context: {
+        graphName: string;
+        curatorName: string;
+        domain: string;
+    };
+    /** Trend results from graph search */
+    trends: Array<{
+        name: string;
+        summary?: string;
+        signal_score?: number;
+        trendLifecycle?: string;
+        momentum?: string;
+        evidence_count?: number;
+        graphName?: string;
+    }>;
+    /** Evidence articles from graph search */
+    evidence: Array<{
+        title: string;
+        sourceUrl?: string;
+        brandNames?: string[];
+        place?: string;
+        snippet?: string;
+    }>;
+    /** Supplemental data (Google Trends, Census, etc.) */
+    supplemental?: Record<string, any> | undefined;
+}
+export interface SkillResult {
+    /** Skill identifier */
+    skillId: string;
+    /** Human-readable skill name */
+    skillName: string;
+    /** Whether the skill executed successfully */
+    success: boolean;
+    /** Transformed output from the skill (markdown or JSON string) */
+    output?: string;
+    /** Error message if the skill failed */
+    error?: string;
+    /** How long the skill took to execute */
+    durationMs: number;
+}
+/**
+ * Discover available tools for a skill by calling the Core API.
+ *
+ * GET /v1/skills/{skill_id}/tools
+ *
+ * Returns null on failure (fail-open — skill is silently skipped).
+ */
+export declare function discoverSkillTools(skillId: string, apiKey: string): Promise<DiscoveredSkill | null>;
+/**
+ * Execute a specific tool on a skill via the Core API.
+ *
+ * POST /v1/skills/{skill_id}/execute
+ * Body: { tool: "tool_name", arguments: {...} }
+ *
+ * Returns the result text, or throws on error.
+ */
+export declare function executeSkillTool(skillId: string, toolName: string, args: Record<string, any>, apiKey: string, userId: string): Promise<{
+    output: string;
+    durationMs: number;
+}>;
+/**
+ * Map a skill execution error to a user-friendly message.
+ * Returns null if the error should be handled by the standard error path
+ * (e.g. CREDITS_EXHAUSTED).
+ */
+export declare function mapSkillError(err: any): string | null;
+/**
+ * Call a skill's output-phase processing via the Core API.
+ *
+ * This wraps executeSkillTool() with the Fodda output data contract
+ * and returns a SkillResult for backward compatibility with the
+ * search_graph pipeline.
+ *
+ * Fail-open: returns a result with success=false on any error.
+ */
+export declare function callSkill(skill: SkillConfig, input: SkillInput, apiKey: string, userId: string): Promise<SkillResult>;
+/**
+ * Call all enabled output-phase skills in parallel via the Core API.
+ * Returns results for all skills (success or failure).
+ * Never throws — individual failures are captured in the result objects.
+ */
+export declare function callOutputSkills(skills: SkillConfig[], input: SkillInput, apiKey: string, userId: string): Promise<SkillResult[]>;
+/**
+ * Package Fodda search results into the standard skill input format.
+ * Call this after search_graph results are enriched but before widget rendering.
+ */
+export declare function buildSkillInput(query: string, data: any, effectiveGraphId: string, primaryGraphName: string, supplemental?: Record<string, any>): SkillInput;
+//# sourceMappingURL=skillClient.d.ts.map

package/dist/skillClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillClient.d.ts","sourceRoot":"","sources":["../src/skillClient.ts"],"names":[],"mappings":"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"}

package/dist/skillClient.js

@@ -0,0 +1,256 @@
+/**
+ * Skill Client — Routes skill calls through the Fodda Core API.
+ *
+ * Architecture change (2026-05-03):
+ *   BEFORE: MCP connected directly to external skill MCP servers.
+ *   NOW:    All skill calls route through Core API endpoints:
+ *     - GET  /v1/skills/{skill_id}/tools    → discover available tools
+ *     - POST /v1/skills/{skill_id}/execute  → execute a specific tool
+ *
+ * The Core API handles auth, access control, billing (2 tokens/call),
+ * and upstream MCP connections. The MCP Server never talks to skill
+ * servers directly.
+ *
+ * Design decisions:
+ * - Fail-open — if discovery or execution fails, Fodda proceeds without skills
+ * - 15s timeout for execution (skill + API overhead)
+ * - 10s timeout for discovery
+ * - Structured input contract preserved for output-phase skills
+ */
+import axios from 'axios';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const API_BASE_URL = process.env.FODDA_API_URL || 'https://api.fodda.ai';
+const DISCOVERY_TIMEOUT_MS = 10_000;
+const EXECUTION_TIMEOUT_MS = 15_000;
+// ---------------------------------------------------------------------------
+// Discovery: Get available tools for a skill via Core API
+// ---------------------------------------------------------------------------
+/**
+ * Discover available tools for a skill by calling the Core API.
+ *
+ * GET /v1/skills/{skill_id}/tools
+ *
+ * Returns null on failure (fail-open — skill is silently skipped).
+ */
+export async function discoverSkillTools(skillId, apiKey) {
+    try {
+        const url = `${API_BASE_URL}/v1/skills/${encodeURIComponent(skillId)}/tools`;
+        const response = await axios.get(url, {
+            headers: {
+                'X-API-Key': apiKey,
+            },
+            timeout: DISCOVERY_TIMEOUT_MS,
+        });
+        const data = response.data;
+        if (!data || !Array.isArray(data.tools)) {
+            console.error(`[skillClient] Discovery for ${skillId}: invalid response shape`);
+            return null;
+        }
+        console.error(`[skillClient] Discovered ${data.tools.length} tool(s) for ${data.skill_name || skillId}`);
+        return {
+            skill_id: data.skill_id || skillId,
+            skill_name: data.skill_name || skillId,
+            tools: data.tools,
+            cost_per_call: data.cost_per_call ?? 2,
+        };
+    }
+    catch (err) {
+        const status = err.response?.status;
+        const code = err.response?.data?.error?.code;
+        if (status === 404) {
+            console.error(`[skillClient] Skill "${skillId}" not found or not available (${code || '404'})`);
+        }
+        else if (status === 403) {
+            console.error(`[skillClient] Skill "${skillId}" access denied (${code || '403'}) — may be disabled or draft`);
+        }
+        else {
+            console.error(`[skillClient] Discovery failed for ${skillId}: ${err.message}`);
+        }
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Execution: Call a skill tool via Core API
+// ---------------------------------------------------------------------------
+/**
+ * Execute a specific tool on a skill via the Core API.
+ *
+ * POST /v1/skills/{skill_id}/execute
+ * Body: { tool: "tool_name", arguments: {...} }
+ *
+ * Returns the result text, or throws on error.
+ */
+export async function executeSkillTool(skillId, toolName, args, apiKey, userId) {
+    const startTime = Date.now();
+    const url = `${API_BASE_URL}/v1/skills/${encodeURIComponent(skillId)}/execute`;
+    const response = await axios.post(url, {
+        tool: toolName,
+        arguments: args,
+    }, {
+        headers: {
+            'X-API-Key': apiKey,
+            'X-User-Id': userId,
+            'X-Fodda-Billing': 'mcp-orchestrated',
+            'Content-Type': 'application/json',
+        },
+        timeout: EXECUTION_TIMEOUT_MS,
+    });
+    const durationMs = Date.now() - startTime;
+    const data = response.data;
+    // Extract text from response — the API may return { result: "..." } or { result: { content: [...] } }
+    let output = '';
+    if (typeof data.result === 'string') {
+        output = data.result;
+    }
+    else if (data.result?.content) {
+        const contentArr = Array.isArray(data.result.content) ? data.result.content : [];
+        output = contentArr
+            .map((c) => (c.type === 'text' ? c.text : JSON.stringify(c)))
+            .join('\n');
+    }
+    else if (data.result) {
+        output = JSON.stringify(data.result);
+    }
+    console.error(`[skillClient] ${skillId}/${toolName} executed in ${durationMs}ms (${output.length} chars)`);
+    return { output, durationMs };
+}
+// ---------------------------------------------------------------------------
+// Error mapping — Convert API error codes to user-friendly messages
+// ---------------------------------------------------------------------------
+/**
+ * Map a skill execution error to a user-friendly message.
+ * Returns null if the error should be handled by the standard error path
+ * (e.g. CREDITS_EXHAUSTED).
+ */
+export function mapSkillError(err) {
+    const status = err.response?.status;
+    const code = err.response?.data?.error?.code;
+    const message = err.response?.data?.error?.message;
+    switch (code) {
+        case 'GRAPH_DISABLED':
+            return '⚠️ This skill is currently disabled in your dashboard. Re-enable it at app.fodda.ai/graphs.';
+        case 'SKILL_NOT_FOUND':
+            return '⚠️ This skill is not currently available on the Fodda platform.';
+        case 'SKILL_NOT_AVAILABLE':
+            return '⚠️ This skill is not currently available — it may be in development.';
+        case 'SKILL_UPSTREAM_ERROR':
+            return '⚠️ The skill server encountered an error. Please try again in a moment.';
+        case 'CREDITS_EXHAUSTED':
+            return null; // Let the standard credit exhaustion handler deal with this
+        default:
+            if (status === 403) {
+                return `⚠️ Access denied: ${message || 'You may not have access to this skill.'}`;
+            }
+            if (status === 404) {
+                return '⚠️ This skill is not currently available.';
+            }
+            return null; // Unknown error — let caller handle
+    }
+}
+// ---------------------------------------------------------------------------
+// Core: Call a single output-phase skill via Core API
+// ---------------------------------------------------------------------------
+/**
+ * Call a skill's output-phase processing via the Core API.
+ *
+ * This wraps executeSkillTool() with the Fodda output data contract
+ * and returns a SkillResult for backward compatibility with the
+ * search_graph pipeline.
+ *
+ * Fail-open: returns a result with success=false on any error.
+ */
+export async function callSkill(skill, input, apiKey, userId) {
+    const startTime = Date.now();
+    try {
+        const { output, durationMs } = await executeSkillTool(skill.id, 'process', // output-phase skills use a standard 'process' tool
+        {
+            fodda_output: input,
+            query: input.query,
+            trends: input.trends,
+            evidence: input.evidence,
+        }, apiKey, userId);
+        return {
+            skillId: skill.id,
+            skillName: skill.name,
+            success: true,
+            output,
+            durationMs,
+        };
+    }
+    catch (err) {
+        const durationMs = Date.now() - startTime;
+        const friendlyMsg = mapSkillError(err);
+        const errorMsg = friendlyMsg || err.response?.data?.error?.message || err.message;
+        console.error(`[skillClient] ${skill.name} failed after ${durationMs}ms: ${errorMsg}`);
+        return {
+            skillId: skill.id,
+            skillName: skill.name,
+            success: false,
+            error: errorMsg,
+            durationMs,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Batch: Call multiple output-phase skills in parallel
+// ---------------------------------------------------------------------------
+/**
+ * Call all enabled output-phase skills in parallel via the Core API.
+ * Returns results for all skills (success or failure).
+ * Never throws — individual failures are captured in the result objects.
+ */
+export async function callOutputSkills(skills, input, apiKey, userId) {
+    const outputSkills = skills.filter(s => s.phase === 'output');
+    if (outputSkills.length === 0)
+        return [];
+    console.error(`[skillClient] Calling ${outputSkills.length} output skill(s): ${outputSkills.map(s => s.name).join(', ')}`);
+    const results = await Promise.allSettled(outputSkills.map(skill => callSkill(skill, input, apiKey, userId)));
+    return results.map(r => r.status === 'fulfilled'
+        ? r.value
+        : {
+            skillId: 'unknown',
+            skillName: 'unknown',
+            success: false,
+            error: r.reason?.message || 'Unknown error',
+            durationMs: 0,
+        });
+}
+// ---------------------------------------------------------------------------
+// Helpers: Build skill input from search results
+// ---------------------------------------------------------------------------
+/**
+ * Package Fodda search results into the standard skill input format.
+ * Call this after search_graph results are enriched but before widget rendering.
+ */
+export function buildSkillInput(query, data, effectiveGraphId, primaryGraphName, supplemental) {
+    const rows = data?.rows || [];
+    return {
+        query,
+        graphId: effectiveGraphId,
+        context: {
+            graphName: primaryGraphName,
+            curatorName: rows[0]?.curator || '',
+            domain: rows[0]?.domain || '',
+        },
+        trends: rows.map((r) => ({
+            name: r.trendName || r.display || r.name || r.title || '',
+            summary: r.summary || r.description || r.trendDescription || '',
+            signal_score: r.signal_score || r.score || 0,
+            trendLifecycle: r.trendLifecycle || 'unknown',
+            momentum: r.momentum || 'unknown',
+            evidence_count: r.evidence_count || r.evidenceCount || 0,
+            graphName: r.graphName || '',
+        })),
+        evidence: rows.flatMap((r) => (r.evidence || []).map((e) => ({
+            title: e.title || e.articleTitle || '',
+            sourceUrl: e.sourceUrl || e.url || '',
+            brandNames: e.brandNames || [],
+            place: e.place || e.geographical_region || '',
+            snippet: e.snippet || e.summary || '',
+        }))).slice(0, 50), // Cap evidence to avoid oversized payloads
+        supplemental: supplemental || undefined,
+    };
+}
+//# sourceMappingURL=skillClient.js.map

package/dist/skillClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillClient.js","sourceRoot":"","sources":["../src/skillClient.ts"],"names":[],"mappings":"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"}