fodda-mcp 1.32.0 → 1.38.0

package/dist/deepResearch.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Deep Research Pipeline — extracted core logic.
+ *
+ * Pure async function: no job tracking, no billing, no MCP logging.
+ * Callers (MCP tool, A2A handler) own their own job state, billing
+ * gates, and progress reporting.
+ *
+ * One implementation, two callers — no pipeline duplication.
+ */
+import type { FoddaRequestFn, WaverunnerRequestFn } from './types.js';
+export interface DeepResearchOpts {
+    query: string;
+    subThemes?: string[] | undefined;
+    apiKey: string;
+    userId: string;
+    depth?: 'light' | 'heavy';
+    graphId?: string | undefined;
+    foddaRequest: FoddaRequestFn;
+    waverunnerRequest: WaverunnerRequestFn;
+    /** Optional progress callback — callers use this for MCP logging messages, console logs, etc. */
+    onProgress?: (msg: string) => void;
+}
+export interface DeepResearchResult {
+    /** Full markdown report with header + sources section */
+    report: string;
+    /** Source routing plan — every candidate selected and why */
+    source_plan: Record<string, any>[];
+    /** Graph IDs that were searched */
+    graphs_searched: string[];
+    /** Sub-themes generated or passed and addressed */
+    sub_themes_used: string[];
+    /** Whether earnings data was included */
+    earnings_included: boolean;
+    /** Whether supplemental/macro data was included */
+    supplemental_included: boolean;
+    /** Duration in seconds (string, 1 decimal) */
+    duration_sec: string;
+}
+export declare function extractRoutingTopic(q: string): string;
+export declare function cleanResearchQuery(q: string): string;
+export declare function fallbackSubThemes(topic: string, isHeavy: boolean): string[];
+export declare function runDeepResearch(opts: DeepResearchOpts): Promise<DeepResearchResult>;
+//# sourceMappingURL=deepResearch.d.ts.map

package/dist/deepResearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepResearch.d.ts","sourceRoot":"","sources":["../src/deepResearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAUtE,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,YAAY,EAAE,cAAc,CAAC;IAC7B,iBAAiB,EAAE,mBAAmB,CAAC;IACvC,iGAAiG;IACjG,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IAC/B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IACnC,mCAAmC;IACnC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mDAAmD;IACnD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,yCAAyC;IACzC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mDAAmD;IACnD,qBAAqB,EAAE,OAAO,CAAC;IAC/B,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;CACxB;AAkBD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASrD;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAkB3E;AA4CD,wBAAsB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAydzF"}

package/dist/deepResearch.js

@@ -0,0 +1,498 @@
+/**
+ * Deep Research Pipeline — extracted core logic.
+ *
+ * Pure async function: no job tracking, no billing, no MCP logging.
+ * Callers (MCP tool, A2A handler) own their own job state, billing
+ * gates, and progress reporting.
+ *
+ * One implementation, two callers — no pipeline duplication.
+ */
+import crypto from 'crypto';
+import { getRelevantSources, getGraphDetails } from './catalogCache.js';
+import { buildResearcherInstruction } from './agents/fodda-researcher/index.js';
+// ---------------------------------------------------------------------------
+// Helpers & Sub-Theme Expansion
+// ---------------------------------------------------------------------------
+async function withTimeout(promise, ms, label) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`${label} timed out after ${ms / 1000}s`)), ms);
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export function extractRoutingTopic(q) {
+    if (!q)
+        return q;
+    let s = q;
+    s = s.replace(/^(run|do|execute|start|launch|create|generate|write|give\s+me|provide|show\s+me|research|explore|synthesize|analyze|what\s+are|tell\s+me|can\s+you)(\s+a|\s+an|\s+the|\s+me|\s+us)?\s+(fodda\s+)?(deep\s+research\s+project|deep\s+research|strategic\s+breakdown|strategic\s+analysis|report|briefing|session|analysis|overview|breakdown|key\s+trends|trends|deep\s+dive)?(\s+about|\s+on|\s+for|\s+regarding|\s+in|\s+of)?/i, '');
+    const clauses = s.split(/\n|\?|\.|;|diagnos|troubleshoot|conversation|system message|user request/i)
+        .map(c => c.trim())
+        .filter(c => c.length > 2);
+    const topicClause = clauses[0] || s;
+    return topicClause.replace(/^[?\s,.:]+|[?\s,.:]+$/g, '').trim() || q;
+}
+export function cleanResearchQuery(q) {
+    return extractRoutingTopic(q);
+}
+export function fallbackSubThemes(topic, isHeavy) {
+    let cleanTopic = extractRoutingTopic(topic).trim();
+    if (cleanTopic.length > 40) {
+        const lastSpace = cleanTopic.lastIndexOf(' ', 40);
+        cleanTopic = lastSpace > 0 ? cleanTopic.slice(0, lastSpace) : cleanTopic.slice(0, 40);
+    }
+    cleanTopic = cleanTopic.replace(/[\s,.:;]+$/, '').trim();
+    const themes = [
+        `category sizing and growth forecasts for ${cleanTopic}`,
+        `key players, brands and challengers in ${cleanTopic}`,
+        `consumer behavior shifts and demand drivers for ${cleanTopic}`,
+        `channel dynamics: DTC, wholesale and marketplace for ${cleanTopic}`,
+    ];
+    if (isHeavy) {
+        themes.push(`moderation, premiumization and lifestyle trends impacting ${cleanTopic}`);
+    }
+    return themes;
+}
+async function generateSubThemes(routingTopic, isHeavy, waverunnerRequest, apiKey, userId) {
+    const count = isHeavy ? 5 : 4;
+    try {
+        const payload = {
+            model: 'gemini-2.0-flash',
+            system_instruction: `You are a senior research strategist. Given a topic, generate exactly ${count} specific, distinct research sub-themes. Each sub-theme MUST name a concrete angle relevant to the specific topic (e.g. category sizing with forecasts, key competitive players/brands, channel dynamics like DTC vs wholesale, consumer behavior or moderation shifts, technology and format innovation). Output ONLY a JSON array of ${count} short strings (5-12 words each). Do NOT repeat the full query phrase verbatim in every string.`,
+            input: [{ type: 'text', text: routingTopic }],
+            response_mime_type: 'application/json',
+        };
+        const result = await withTimeout(waverunnerRequest('deep_dive', 0, apiKey, userId, payload), 10000, 'Sub-theme expansion');
+        const text = result?.outputs?.[0]?.text || '';
+        const match = text.match(/\[[\s\S]*\]/);
+        if (match) {
+            const parsed = JSON.parse(match[0]);
+            if (Array.isArray(parsed) && parsed.length >= 3) {
+                const cleaned = parsed.slice(0, count).map((s) => String(s).trim()).filter(Boolean);
+                if (cleaned.length >= 3) {
+                    console.error(`[deep_research] LLM sub-theme expansion succeeded (${cleaned.length} themes):`, cleaned);
+                    return cleaned;
+                }
+            }
+        }
+    }
+    catch (err) {
+        console.error(`[deep_research] Sub-theme LLM generation failed:`, err?.stack || err?.message || err);
+    }
+    return fallbackSubThemes(routingTopic, isHeavy);
+}
+// ---------------------------------------------------------------------------
+// Main Pipeline
+// ---------------------------------------------------------------------------
+export async function runDeepResearch(opts) {
+    const { query: rawQuery, subThemes: clientSubThemes, apiKey, userId, foddaRequest, waverunnerRequest, depth = 'light', graphId, onProgress = () => { }, } = opts;
+    const routingTopic = extractRoutingTopic(rawQuery);
+    const researchBrief = rawQuery.trim();
+    const isHeavy = depth === 'heavy';
+    const tokenCost = isHeavy ? 3 : 2;
+    const maxGraphs = isHeavy ? 15 : 8;
+    const startTime = Date.now();
+    // ── Phase 1: Planning & Sub-Themes ──
+    onProgress(`📋 Phase 1/5: Planning research approach for "${routingTopic.slice(0, 80)}"...`);
+    console.error(`[deep_research] Starting ${isHeavy ? 'heavy' : 'light'} research for topic: "${routingTopic}" (brief length: ${researchBrief.length} chars)`);
+    const effectiveSubThemes = (clientSubThemes && clientSubThemes.length > 0)
+        ? clientSubThemes.slice(0, isHeavy ? 5 : 4)
+        : await generateSubThemes(routingTopic, isHeavy, waverunnerRequest, apiKey, userId);
+    console.error(`[deep_research] Using ${effectiveSubThemes.length} sub-themes:`, effectiveSubThemes);
+    const sourceCandidates = graphId ? [] : getRelevantSources(routingTopic, { minGraphs: isHeavy ? 6 : 4, maxGraphs });
+    const graphCandidates = sourceCandidates
+        .filter((c) => c.kind === 'graph')
+        .slice(0, maxGraphs);
+    const graphIds = graphId ? [graphId] : graphCandidates.map(c => c.graphId);
+    const earningsCandidate = sourceCandidates.find((c) => c.kind === 'earnings');
+    const supplementalCandidates = sourceCandidates.filter((c) => c.kind === 'supplemental');
+    const supplementalToFetch = supplementalCandidates
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 2);
+    const supplementalHintOnly = supplementalCandidates.slice(supplementalToFetch.length);
+    const sourcePlan = [
+        ...(graphId
+            ? [{ kind: 'graph', id: graphId, reason: 'explicitly requested via graphId' }]
+            : graphCandidates.map(c => ({ kind: 'graph', id: c.graphId, reason: c.reason }))),
+        ...(earningsCandidate ? [{
+                kind: 'earnings',
+                ...(earningsCandidate.ticker ? { ticker: earningsCandidate.ticker } : {}),
+                ...(earningsCandidate.brand ? { brand: earningsCandidate.brand } : {}),
+                ...(earningsCandidate.sector ? { sector: earningsCandidate.sector } : {}),
+                reason: earningsCandidate.reason,
+            }] : []),
+        ...supplementalToFetch.map(c => ({
+            kind: 'supplemental',
+            category: c.category,
+            reason: `${c.reason} — auto-fetched and folded into research context`,
+        })),
+        ...supplementalHintOnly.map(c => ({
+            kind: 'supplemental',
+            category: c.category,
+            reason: `${c.reason} — not auto-fetched (beyond top-2 cap); targeted tool available: get_supplemental_context`,
+        })),
+    ];
+    // ── Phase 2: Tiered Two-Pass Retrieval ──
+    onProgress(`🔍 Phase 2/5: Broad discovery search across ${graphIds.length} knowledge graph${graphIds.length !== 1 ? 's' : ''}...`);
+    // Pass 1: Broad discovery — routingTopic against ALL graphs (limit 3, 8s per-call timeout)
+    const broadSearchPromises = graphIds.map(async (gid) => {
+        try {
+            const searchBody = { query: routingTopic, limit: 3, use_semantic: true, include_evidence: true };
+            const res = await withTimeout(foddaRequest('POST', `/v1/graphs/${encodeURIComponent(gid)}/search`, apiKey, userId, searchBody), 8000, `Graph search ${gid}`);
+            const rows = res?.rows || [];
+            return { graphId: gid, rows, evidence: rows.flatMap((r) => r.evidence || []) };
+        }
+        catch (err) {
+            console.error(`[deep_research] Pass 1 graph search for ${gid} failed/timed out: ${err?.message}`);
+            return { graphId: gid, rows: [], evidence: [] };
+        }
+    });
+    const earningsPromise = earningsCandidate
+        ? (async () => {
+            try {
+                const params = new URLSearchParams();
+                if (earningsCandidate.ticker)
+                    params.set('ticker', earningsCandidate.ticker);
+                if (earningsCandidate.brand)
+                    params.set('brand', earningsCandidate.brand);
+                if (earningsCandidate.sector)
+                    params.set('sector', earningsCandidate.sector);
+                if (earningsCandidate.search)
+                    params.set('search', earningsCandidate.search);
+                params.set('limit', '10');
+                return await withTimeout(foddaRequest('GET', `/v1/supplemental/earnings/snapshot?${params.toString()}`, apiKey, userId), 15000, 'Earnings snapshot');
+            }
+            catch (err) {
+                console.error(`[deep_research] Earnings snapshot failed (non-fatal): ${err?.message}`);
+                return null;
+            }
+        })()
+        : Promise.resolve(null);
+    const supplementalPromise = supplementalToFetch.length > 0
+        ? (async () => {
+            try {
+                const body = { query: researchBrief };
+                const categoryHint = supplementalToFetch.map(c => c.category).join(', ');
+                body.domain = categoryHint;
+                return await withTimeout(foddaRequest('POST', '/v1/supplemental/context', apiKey, userId, body), 15000, 'Supplemental context');
+            }
+            catch (err) {
+                console.error(`[deep_research] Supplemental context failed (non-fatal): ${err?.message}`);
+                return null;
+            }
+        })()
+        : Promise.resolve(null);
+    const [broadResults, earningsData, supplementalData] = await Promise.all([
+        Promise.all(broadSearchPromises),
+        earningsPromise,
+        supplementalPromise,
+    ]);
+    // Rank Pass 1 results by relevance (max row score + router score tiebreak)
+    const getGraphRelevanceScore = (g) => {
+        if (!g.rows || g.rows.length === 0)
+            return 0;
+        const maxRowScore = Math.max(...g.rows.map(r => Number(r.signal_score ?? r.score ?? r.similarity ?? 0.5)));
+        const routerCandidate = graphCandidates.find(c => c.graphId === g.graphId);
+        const routerScore = routerCandidate?.score ?? 0;
+        return maxRowScore * 10 + routerScore;
+    };
+    const topGraphIds = broadResults
+        .filter(g => g.rows.length > 0)
+        .sort((a, b) => getGraphRelevanceScore(b) - getGraphRelevanceScore(a))
+        .slice(0, isHeavy ? 5 : 4)
+        .map(g => g.graphId);
+    onProgress(`🎯 Phase 2b: Deep sub-theme search on top ${topGraphIds.length} graph${topGraphIds.length !== 1 ? 's' : ''}...`);
+    // Pass 2: Deep search — sub-themes against top-hit graphs only (limit 5, 8s per-call timeout)
+    const deepSearchPromises = [];
+    for (const gid of topGraphIds) {
+        for (const st of effectiveSubThemes) {
+            deepSearchPromises.push((async () => {
+                try {
+                    const searchBody = { query: st, limit: isHeavy ? 5 : 3, use_semantic: true, include_evidence: true };
+                    const res = await withTimeout(foddaRequest('POST', `/v1/graphs/${encodeURIComponent(gid)}/search`, apiKey, userId, searchBody), 8000, `Deep search ${gid}:${st}`);
+                    const rows = res?.rows || [];
+                    return { graphId: gid, subTheme: st, rows, evidence: rows.flatMap((r) => r.evidence || []) };
+                }
+                catch (err) {
+                    console.error(`[deep_research] Pass 2 deep search for ${gid}:${st} failed/timed out: ${err?.message}`);
+                    return { graphId: gid, subTheme: st, rows: [], evidence: [] };
+                }
+            })());
+        }
+    }
+    const deepResults = await Promise.all(deepSearchPromises);
+    const trendMap = new Map();
+    // Process deepResults FIRST so subTheme attribution takes priority over broad hits
+    for (const r of [...deepResults, ...broadResults]) {
+        const st = r.subTheme;
+        for (const row of r.rows) {
+            const trendName = String(row.title || row.trendName || row.name || '').trim();
+            if (!trendName)
+                continue;
+            const key = `${r.graphId}::${trendName.toLowerCase()}`;
+            const existing = trendMap.get(key);
+            if (existing) {
+                if (st)
+                    existing.subThemes.add(st);
+            }
+            else {
+                const subThemes = new Set();
+                if (st)
+                    subThemes.add(st);
+                trendMap.set(key, {
+                    graphId: r.graphId,
+                    trendName,
+                    summary: String(row.summary || row.description || '').substring(0, 600),
+                    signalScore: row.signal_score || row.score || 0.5,
+                    lifecycle: row.trendLifecycle || row.lifecycle || 'growing',
+                    evidence: (row.evidence || []).slice(0, 3).map((e) => ({
+                        title: String(e.title || '').substring(0, 150),
+                        snippet: String(e.snippet || e.summary || '').substring(0, 400),
+                        source_url: e.sourceUrl || e.url,
+                        category: e.category || e.type,
+                    })),
+                    subThemes,
+                });
+            }
+        }
+    }
+    // Group curated trends by graphId for Gemini context
+    const curatedGraphsMap = new Map();
+    let totalTrends = 0;
+    let totalEvidence = 0;
+    for (const trend of trendMap.values()) {
+        totalTrends++;
+        totalEvidence += trend.evidence.length;
+        const list = curatedGraphsMap.get(trend.graphId) || [];
+        if (list.length < (isHeavy ? 6 : 4)) {
+            list.push({
+                name: trend.trendName,
+                sub_themes_supported: Array.from(trend.subThemes),
+                summary: trend.summary,
+                signal_score: trend.signalScore,
+                lifecycle: trend.lifecycle,
+                evidence: trend.evidence,
+            });
+            curatedGraphsMap.set(trend.graphId, list);
+        }
+    }
+    const structuredGraphResults = Array.from(curatedGraphsMap.entries()).map(([gid, trends]) => ({
+        graph_id: gid,
+        trends,
+    }));
+    const searchedGraphIds = Array.from(new Set([...graphIds, ...topGraphIds]));
+    const activeGraphs = structuredGraphResults.filter(g => g.trends.length > 0);
+    if (activeGraphs.length === 0) {
+        console.error(`[deep_research] All graph searches returned no curated results — proceeding with web-only research`);
+        onProgress(`⚠️ Knowledge graph search returned no results — proceeding with web-only research...`);
+    }
+    else {
+        onProgress(`📊 Curated ${totalTrends} trend${totalTrends !== 1 ? 's' : ''} and ${totalEvidence} evidence pieces across ${activeGraphs.length} active graph${activeGraphs.length !== 1 ? 's' : ''}. Launching deep analysis...`);
+    }
+    // ── Phase 3: Deep Analysis via Gemini ──
+    onProgress(`🧠 Phase 3/5: Deep analysis with web research — this takes 1-3 minutes...`);
+    const graphContext = {
+        graphResults: JSON.stringify(structuredGraphResults, null, 2),
+        graphsSearched: searchedGraphIds,
+        totalTrends,
+        totalEvidence,
+        focusGraphId: graphId,
+        subThemesUsed: effectiveSubThemes,
+        ...(earningsData ? { earningsResults: JSON.stringify(earningsData).substring(0, 15000) } : {}),
+        ...(supplementalData ? { supplementalResults: JSON.stringify(supplementalData).substring(0, 15000) } : {}),
+    };
+    const systemInstruction = buildResearcherInstruction(researchBrief, graphContext);
+    const geminiModel = isHeavy ? 'gemini-2.5-pro' : 'gemini-2.5-flash';
+    const subThemesInstruction = effectiveSubThemes
+        .map((st, i) => `${i + 1}. ${st}`)
+        .join('\n');
+    const interactionPayload = {
+        model: geminiModel,
+        system_instruction: systemInstruction,
+        input: [
+            {
+                type: 'text',
+                text: `Full Research Brief:\n${researchBrief}\n\n## Mandatory Research Sub-Themes (you MUST address ALL of these in the report):\n${subThemesInstruction}\n\nProduce a comprehensive research report addressing EVERY requirement in the research brief and EVERY sub-theme above. Write in editorial narrative style — like a senior strategist briefing a CMO.\n\nCRITICAL MANDATE: You MUST actively leverage your web search tool to find and integrate quantitative market sizing data (dollar market values, projected CAGRs, category growth rates, and volume vs value figures), competitive brand players, and channel dynamics for all key categories in the brief. Combine curated knowledge graph trends with live web evidence to deliver a complete, highly specific brief.\n\nIMPORTANT: At the end of the report, you MUST include a "## Sources" section listing all the source URLs you used from the provided context.`,
+            },
+        ],
+        tools: [
+            { type: 'google_search' },
+            { type: 'url_context' },
+        ],
+    };
+    // Call Gemini with capacity fallback
+    let result;
+    try {
+        result = await waverunnerRequest('deep_dive', tokenCost, apiKey, userId, interactionPayload);
+    }
+    catch (primaryErr) {
+        const errMsg = primaryErr?.response?.data?.error?.message || primaryErr?.message || '';
+        const isCapacity = errMsg.includes('high demand') || errMsg.includes('overloaded') || errMsg.includes('503');
+        if (isCapacity && geminiModel !== 'gemini-2.5-flash') {
+            console.error(`[deep_research] ${geminiModel} capacity error — retrying with gemini-2.5-flash`);
+            interactionPayload.model = 'gemini-2.5-flash';
+            result = await waverunnerRequest('deep_dive', tokenCost, apiKey, userId, interactionPayload);
+        }
+        else {
+            throw primaryErr;
+        }
+    }
+    // ── Extract report text ──
+    const outputs = result?.outputs || [];
+    const textParts = outputs
+        .filter((o) => o.type === 'text')
+        .map((o) => o.text);
+    let reportText = textParts.join('\n\n');
+    // Strip/unwrap grounding API redirect links embedded in markdown text by Gemini
+    reportText = reportText.replace(/\[([^\]]+)\]\(https?:\/\/(?:vertexaisearch\.cloud\.google\.com|www\.google\.com\/url)[^\)]+\)/gi, '$1');
+    reportText = reportText.replace(/https?:\/\/vertexaisearch\.cloud\.google\.com\/[^\s\)]+/gi, '');
+    // Diagnostic logging for citation payloads
+    console.error(`[deep_research] Raw annotations payload:`, JSON.stringify(outputs.flatMap((o) => o.annotations || [])));
+    console.error(`[deep_research] Raw groundingChunks count:`, (result?.groundingMetadata?.groundingChunks || []).length);
+    // ── Extract URLs ──
+    const normalizeUrl = (rawUrl) => {
+        if (!rawUrl)
+            return null;
+        let u = rawUrl.trim();
+        // Strip inner spaces/newlines in URL (e.g. "funded- startups-in-wine")
+        u = u.replace(/\s+/g, '');
+        // Fix scheme typos (httpss:// -> https://)
+        u = u.replace(/^httpss:\/\//i, 'https://');
+        u = u.replace(/^https?:\/\/\//i, 'https://');
+        // Extract real destination from google redirect URLs if present
+        if (u.includes('google.com/url?') || u.includes('google.com/url&')) {
+            const match = u.match(/[?&](?:url|q)=(https?%3A%2F%2F[^&]+|https?:\/\/[^&]+)/i);
+            if (match && match[1]) {
+                u = decodeURIComponent(match[1]);
+            }
+        }
+        // Fix typos where :// was replaced by dot (e.g., https.www.domain.com -> https://www.domain.com)
+        if (/^https?\.[a-z0-9]/i.test(u)) {
+            u = u.replace(/^(https?)\./i, '$1://');
+        }
+        try {
+            const parsed = new URL(u);
+            if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+                return null;
+            if (!parsed.hostname || !parsed.hostname.includes('.'))
+                return null;
+            // Reject hostname missing real domain (e.g., "https.com")
+            if (parsed.hostname === 'https.com' || parsed.hostname === 'http.com')
+                return null;
+            return parsed.toString();
+        }
+        catch {
+            return null;
+        }
+    };
+    const isInternalOrSearchUrl = (url) => {
+        if (!url)
+            return true;
+        const u = url.toLowerCase();
+        return u.includes('vertexaisearch.cloud.google.com') ||
+            u.includes('fodda.ai') ||
+            u.includes('localhost') ||
+            u.includes('google.com/search') ||
+            u.includes('google.com/url') ||
+            u.includes('googleusercontent.com');
+    };
+    const isFabricatedUrl = (url) => {
+        if (!url)
+            return true;
+        if (/YOUR_\w+/i.test(url))
+            return true;
+        return false;
+    };
+    const seenUrls = new Set();
+    const sourceUrls = [];
+    // ── Harvest Graph Provenance Sources (P2) ──
+    for (const gId of searchedGraphIds) {
+        const g = getGraphDetails(gId);
+        const graphTitle = g?.name || gId;
+        const curatorAttr = g ? [g.curator, g.company].filter(Boolean).join(' / ') : '';
+        const titleText = curatorAttr ? `${graphTitle} (${curatorAttr})` : graphTitle;
+        const graphTrends = curatedGraphsMap.get(gId) || [];
+        let hasEvidenceUrl = false;
+        // 1. Evidence item formatted_citation / sourceUrl (real external links)
+        for (const t of graphTrends) {
+            for (const ev of (t.evidence || [])) {
+                const rawEvUrl = typeof ev === 'string' ? ev : (ev?.sourceUrl || ev?.formatted_citation || '');
+                const normEv = normalizeUrl(rawEvUrl);
+                if (normEv && !isInternalOrSearchUrl(normEv) && !isFabricatedUrl(normEv) && !seenUrls.has(normEv)) {
+                    seenUrls.add(normEv);
+                    sourceUrls.push({ title: titleText, url: normEv });
+                    hasEvidenceUrl = true;
+                }
+            }
+        }
+        // 2. Fallback: Graph webpage_url from catalog ONLY (never construct fodda.ai/graphs/${gId})
+        const deepLink = normalizeUrl(g?.webpage_url || '') || normalizeUrl(g?.source_url || '');
+        if (deepLink && !seenUrls.has(deepLink)) {
+            seenUrls.add(deepLink);
+            sourceUrls.push({
+                title: curatorAttr ? `${graphTitle} — Curated by ${curatorAttr}` : graphTitle,
+                url: deepLink
+            });
+        }
+        else if (!hasEvidenceUrl && !deepLink) {
+            // 3. Fallback when no URL exists: emit clean curator attribution text
+            const textEntry = curatorAttr ? `${graphTitle} — Curated by ${curatorAttr}` : graphTitle;
+            if (!seenUrls.has(textEntry)) {
+                seenUrls.add(textEntry);
+                sourceUrls.push({
+                    title: textEntry,
+                    url: ''
+                });
+            }
+        }
+    }
+    // Harvest Web Grounding URLs
+    for (const output of outputs) {
+        if (output.type === 'text' && Array.isArray(output.annotations)) {
+            for (const ann of output.annotations) {
+                const norm = normalizeUrl(ann.url);
+                if (ann.type === 'url_citation' && norm && !isInternalOrSearchUrl(norm) && !isFabricatedUrl(norm) && !seenUrls.has(norm)) {
+                    seenUrls.add(norm);
+                    sourceUrls.push({ title: ann.title || '', url: norm });
+                }
+            }
+        }
+    }
+    const groundingChunks = result?.groundingMetadata?.groundingChunks || [];
+    for (const chunk of groundingChunks) {
+        const uri = chunk?.web?.uri;
+        const norm = normalizeUrl(uri);
+        if (norm && !isInternalOrSearchUrl(norm) && !isFabricatedUrl(norm) && !seenUrls.has(norm)) {
+            seenUrls.add(norm);
+            sourceUrls.push({ title: chunk?.web?.title || '', url: norm });
+        }
+    }
+    // ALWAYS strip any self-generated Sources / References section from Gemini
+    const sourcesRegex = /(#+\s*(?:sources|references)[\s\S]*$)/i;
+    reportText = reportText.replace(sourcesRegex, '').trim();
+    if (sourceUrls.length > 0) {
+        reportText += '\n\n## Sources & References\n' + sourceUrls.map(s => s.url ? `- [${s.title}](${s.url})` : `- ${s.title}`).join('\n');
+    }
+    if (!reportText) {
+        throw new Error('Research agent returned no output.');
+    }
+    const durationSec = ((Date.now() - startTime) / 1000).toFixed(1);
+    const header = [
+        `_Research by Fodda Research Agent • ${activeGraphs.length} graph${activeGraphs.length !== 1 ? 's' : ''} searched • ${totalTrends} trends analyzed${earningsData ? ' • earnings intelligence included' : ''}${supplementalData ? ' • supplemental macro data included' : ''} • ${durationSec}s_`,
+        '',
+    ].join('\n');
+    return {
+        report: header + reportText,
+        source_plan: sourcePlan,
+        graphs_searched: searchedGraphIds,
+        sub_themes_used: effectiveSubThemes,
+        earnings_included: !!earningsData,
+        supplemental_included: !!supplementalData,
+        duration_sec: durationSec,
+    };
+}
+//# sourceMappingURL=deepResearch.js.map

package/dist/deepResearch.js.map

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

package/dist/errorHandling.d.ts

@@ -20,7 +20,7 @@ export declare function classifyAccessError(err: any): 'forbidden' | 'disabled'
  * GRAPH_DISABLED → mention it so the user knows they opted out
  * CREDITS → trial-aware handling (auto-upgrade or prompt for email)
  */
-export declare function handleAccessError(err: any, toolName: string): Promise<{
+export declare function handleAccessError(err: any, toolName: string, userId?: string, apiKey?: string): Promise<{
     isError: boolean;
     content: {
         type: 'text';

package/dist/errorHandling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorHandling.d.ts","sourceRoot":"","sources":["../src/errorHandling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwDH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAyB5G;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CA8D5I;AAyCD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,2BAA2B,CAC7C,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CA2IjF"}
+{"version":3,"file":"errorHandling.d.ts","sourceRoot":"","sources":["../src/errorHandling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwDH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAyB5G;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAgF9K;AAyCD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,2BAA2B,CAC7C,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CA4IjF"}