@4da/mcp-server 3.2.0

package/dist/llm.js

@@ -0,0 +1,447 @@
+/**
+ * LLM Client for 4DA MCP Server
+ *
+ * Provides intelligence synthesis over raw tool data.
+ * Supports Anthropic Claude, OpenAI, and Ollama (local).
+ *
+ * Features:
+ * - Tiered model selection (use smaller models for simpler tasks)
+ * - Optimized prompts for local models
+ * - Automatic fallback
+ */
+// =============================================================================
+// Model Tiers - Optimized for 16GB VRAM (RTX 4080 Super)
+// =============================================================================
+/**
+ * Default models for different task complexities
+ * Optimized for 16GB VRAM
+ */
+export const DEFAULT_OLLAMA_MODELS = {
+    // Simple tasks: summarization, formatting, basic extraction
+    light: "llama3.1:8b-instruct-q8_0",
+    // Medium tasks: analysis, recommendations
+    medium: "qwen2.5:14b-instruct-q5_K_M",
+    // Complex tasks: reasoning, predictions, pattern recognition
+    heavy: "qwen2.5:14b-instruct-q5_K_M",
+};
+/**
+ * Task complexity by tool
+ */
+export const TOOL_COMPLEXITY = {
+    daily_briefing: "medium", // Needs to synthesize multiple themes
+    score_autopsy: "heavy", // Needs to reason about score correctness
+    trend_analysis: "heavy", // Needs pattern recognition + prediction
+    context_analysis: "medium", // Structured advice
+    topic_connections: "heavy", // Graph reasoning
+};
+// =============================================================================
+// Configuration
+// =============================================================================
+import { readFileSync, existsSync } from "fs";
+import { join, dirname } from "path";
+/**
+ * Find settings.json by looking in common locations
+ */
+function findSettingsFile() {
+    // Check environment variable first
+    const envPath = process.env.FOURDA_SETTINGS_PATH;
+    if (envPath && existsSync(envPath)) {
+        return envPath;
+    }
+    // Check relative to database path
+    const dbPath = process.env.FOURDA_DB_PATH;
+    if (dbPath) {
+        const settingsPath = join(dirname(dbPath), "settings.json");
+        if (existsSync(settingsPath)) {
+            return settingsPath;
+        }
+    }
+    // Check common locations
+    const commonPaths = [
+        "/mnt/d/4da-v3/data/settings.json",
+        join(process.cwd(), "data/settings.json"),
+        join(process.cwd(), "../data/settings.json"),
+    ];
+    for (const path of commonPaths) {
+        if (existsSync(path)) {
+            return path;
+        }
+    }
+    return null;
+}
+/**
+ * Get LLM configuration from settings.json file
+ */
+export function getLLMConfig(_db) {
+    const settingsPath = findSettingsFile();
+    if (!settingsPath) {
+        // Return environment-based config as fallback
+        return {
+            provider: process.env.LLM_PROVIDER || null,
+            anthropic_api_key: process.env.ANTHROPIC_API_KEY,
+            openai_api_key: process.env.OPENAI_API_KEY,
+            ollama_url: process.env.OLLAMA_URL || "http://localhost:11434",
+            model: process.env.LLM_MODEL,
+            model_light: process.env.LLM_MODEL_LIGHT,
+            model_heavy: process.env.LLM_MODEL_HEAVY,
+        };
+    }
+    try {
+        const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+        const llm = settings.llm || {};
+        return {
+            provider: llm.provider,
+            anthropic_api_key: llm.api_key || llm.anthropic_api_key,
+            openai_api_key: llm.openai_api_key,
+            ollama_url: llm.base_url || llm.ollama_url || "http://localhost:11434",
+            model: llm.model,
+            model_light: llm.model_light,
+            model_heavy: llm.model_heavy,
+        };
+    }
+    catch (error) {
+        console.error("Failed to read settings.json:", error);
+        return { provider: null };
+    }
+}
+/**
+ * Check if LLM synthesis is available
+ */
+export function canSynthesize(config) {
+    if (!config.provider)
+        return false;
+    switch (config.provider) {
+        case "anthropic":
+            return !!config.anthropic_api_key;
+        case "openai":
+            return !!config.openai_api_key;
+        case "ollama":
+            return true; // Ollama doesn't need a key
+        default:
+            return false;
+    }
+}
+/**
+ * Get the appropriate model for task complexity
+ */
+function getModelForComplexity(config, complexity) {
+    if (config.provider !== "ollama") {
+        // Cloud providers use the configured model
+        return config.model || (config.provider === "anthropic" ? "claude-3-5-sonnet-20241022" : "gpt-4o");
+    }
+    // Ollama: use tiered models
+    switch (complexity) {
+        case "light":
+            return config.model_light || config.model || DEFAULT_OLLAMA_MODELS.light;
+        case "medium":
+            return config.model || DEFAULT_OLLAMA_MODELS.medium;
+        case "heavy":
+            return config.model_heavy || config.model || DEFAULT_OLLAMA_MODELS.heavy;
+    }
+}
+// =============================================================================
+// Synthesis
+// =============================================================================
+/**
+ * Synthesize insights using LLM
+ */
+export async function synthesize(config, request) {
+    if (!canSynthesize(config)) {
+        throw new Error("LLM not configured - cannot synthesize");
+    }
+    const startTime = Date.now();
+    const complexity = request.complexity || "medium";
+    let result;
+    switch (config.provider) {
+        case "anthropic":
+            result = await synthesizeAnthropic(config, request);
+            break;
+        case "openai":
+            result = await synthesizeOpenAI(config, request);
+            break;
+        case "ollama":
+            result = await synthesizeOllama(config, request, complexity);
+            break;
+        default:
+            throw new Error(`Unknown LLM provider: ${config.provider}`);
+    }
+    result.latency_ms = Date.now() - startTime;
+    return result;
+}
+/**
+ * Anthropic Claude synthesis
+ */
+async function synthesizeAnthropic(config, request) {
+    const model = config.model || "claude-3-5-sonnet-20241022";
+    const maxTokens = request.max_tokens || 1024;
+    const response = await fetch("https://api.anthropic.com/v1/messages", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": config.anthropic_api_key,
+            "anthropic-version": "2023-06-01",
+        },
+        body: JSON.stringify({
+            model,
+            max_tokens: maxTokens,
+            system: request.system,
+            messages: [{ role: "user", content: request.prompt }],
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`Anthropic API error: ${error}`);
+    }
+    const data = (await response.json());
+    return {
+        synthesis: data.content[0]?.text || "",
+        model_used: model,
+        tokens_used: data.usage?.output_tokens,
+    };
+}
+/**
+ * OpenAI synthesis
+ */
+async function synthesizeOpenAI(config, request) {
+    const model = config.model || "gpt-4o";
+    const maxTokens = request.max_tokens || 1024;
+    const response = await fetch("https://api.openai.com/v1/chat/completions", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${config.openai_api_key}`,
+        },
+        body: JSON.stringify({
+            model,
+            max_tokens: maxTokens,
+            messages: [
+                { role: "system", content: request.system },
+                { role: "user", content: request.prompt },
+            ],
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`OpenAI API error: ${error}`);
+    }
+    const data = (await response.json());
+    return {
+        synthesis: data.choices[0]?.message?.content || "",
+        model_used: model,
+        tokens_used: data.usage?.completion_tokens,
+    };
+}
+/**
+ * Ollama synthesis (local) - optimized for local models
+ */
+async function synthesizeOllama(config, request, complexity) {
+    const model = getModelForComplexity(config, complexity);
+    const baseUrl = config.ollama_url || "http://localhost:11434";
+    // Use chat endpoint for better instruction following
+    const response = await fetch(`${baseUrl}/api/chat`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            model,
+            messages: [
+                { role: "system", content: request.system },
+                { role: "user", content: request.prompt },
+            ],
+            stream: false,
+            options: {
+                num_predict: request.max_tokens || 512,
+                temperature: 0.7,
+                top_p: 0.9,
+            },
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`Ollama API error: ${error}`);
+    }
+    const data = (await response.json());
+    return {
+        synthesis: data.message?.content || "",
+        model_used: model,
+        tokens_used: data.eval_count,
+    };
+}
+// =============================================================================
+// Synthesis Prompts - Optimized for Local Models
+// =============================================================================
+/**
+ * Prompts are optimized for:
+ * 1. Clear structure (local models need explicit formatting)
+ * 2. Concise output (fewer tokens = faster inference)
+ * 3. Specific instructions (reduce ambiguity)
+ */
+export const SYNTHESIS_PROMPTS = {
+    /**
+     * Daily Briefing - Executive synthesis
+     * Complexity: MEDIUM
+     */
+    dailyBriefing: {
+        complexity: "medium",
+        system: `You are an intelligence analyst. Synthesize data into actionable briefings.
+
+OUTPUT FORMAT:
+1. One-sentence summary of the day
+2. The single most important thing to review (with reason)
+3. One recommended action
+
+Be direct. No filler. Every word must add value.`,
+        buildPrompt: (data, context) => `
+DATA:
+${JSON.stringify(data, null, 2)}
+
+USER CONTEXT:
+${JSON.stringify(context, null, 2)}
+
+Generate briefing with:
+1. ONE-LINE SUMMARY
+2. TOP PRIORITY (title + why it matters to this user)
+3. RECOMMENDED ACTION`,
+    },
+    /**
+     * Score Autopsy - Explain the reasoning
+     * Complexity: HEAVY (needs to reason about correctness)
+     */
+    scoreAutopsy: {
+        complexity: "heavy",
+        system: `You are a scoring forensics expert. Analyze if relevance scores are correct.
+
+OUTPUT FORMAT:
+1. VERDICT: [ACCURATE / TOO HIGH / TOO LOW]
+2. REASONING: Why you reached this verdict (cite specific data)
+3. KEY FACTOR: The main thing driving this score
+4. SUGGESTION: How to get more/fewer items like this
+
+Be analytical. Cite numbers from the data.`,
+        buildPrompt: (data, context) => `
+SCORE DATA:
+${JSON.stringify(data, null, 2)}
+
+USER INTERESTS:
+${JSON.stringify(context, null, 2)}
+
+Analyze: Is this score correct given the user's interests?`,
+    },
+    /**
+     * Trend Analysis - Predict and explain
+     * Complexity: HEAVY (needs pattern recognition + prediction)
+     */
+    trendAnalysis: {
+        complexity: "heavy",
+        system: `You are a tech trend analyst. Interpret patterns and predict trajectories.
+
+OUTPUT FORMAT:
+1. KEY SIGNAL: The most important trend (one sentence)
+2. WHY IT'S HAPPENING: Brief explanation
+3. PREDICTION: What to expect in the next 1-2 weeks
+4. ACTION: Should the user adjust their focus?
+
+Ground predictions in the data. Don't speculate wildly.`,
+        buildPrompt: (data, context) => `
+TREND DATA:
+${JSON.stringify(data, null, 2)}
+
+USER CONTEXT:
+${JSON.stringify(context, null, 2)}
+
+Interpret: What do these trends mean for this specific user?`,
+    },
+    /**
+     * Context Analysis - Personalized optimization advice
+     * Complexity: MEDIUM (structured recommendations)
+     */
+    contextAnalysis: {
+        complexity: "medium",
+        system: `You are a personalization expert. Help users optimize their content filtering.
+
+OUTPUT FORMAT:
+1. BIGGEST GAP: What's missing from their context?
+2. HIGHEST IMPACT CHANGE: One specific thing to add/remove
+3. QUICK WIN: Something they can do in 30 seconds
+
+Be specific. Give exact examples they can copy-paste.`,
+        buildPrompt: (data) => `
+CONTEXT DATA:
+${JSON.stringify(data, null, 2)}
+
+Provide optimization recommendations. Be specific and actionable.`,
+    },
+    /**
+     * Topic Connections - Explain the knowledge graph
+     * Complexity: HEAVY (needs graph reasoning)
+     */
+    topicConnections: {
+        complexity: "heavy",
+        system: `You are a knowledge graph analyst. Find hidden patterns in topic relationships.
+
+OUTPUT FORMAT:
+1. SURPRISING CONNECTION: A non-obvious relationship and its significance
+2. MISSING LINK: Topics that should connect but don't
+3. EXPLORATION PATH: A topic worth investigating based on the graph
+4. PATTERN: What the graph structure reveals about their interests
+
+Look for insights the user wouldn't notice themselves.`,
+        buildPrompt: (data, context) => `
+GRAPH DATA:
+${JSON.stringify(data, null, 2)}
+
+USER CONTEXT:
+${JSON.stringify(context, null, 2)}
+
+Interpret: What hidden patterns does this graph reveal?`,
+    },
+};
+// =============================================================================
+// Utility: Check Ollama availability
+// =============================================================================
+/**
+ * Check if Ollama is running and has required models
+ */
+export async function checkOllamaStatus(baseUrl = "http://localhost:11434") {
+    try {
+        const response = await fetch(`${baseUrl}/api/tags`, {
+            method: "GET",
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok) {
+            return { available: false, models: [], error: "Ollama not responding" };
+        }
+        const data = (await response.json());
+        const models = data.models?.map(m => m.name) || [];
+        return { available: true, models };
+    }
+    catch (error) {
+        return {
+            available: false,
+            models: [],
+            error: error instanceof Error ? error.message : "Connection failed",
+        };
+    }
+}
+/**
+ * Recommended models for 4DA synthesis tasks
+ */
+export const RECOMMENDED_MODELS = {
+    "16GB_VRAM": {
+        primary: "qwen2.5:14b-instruct-q5_K_M",
+        fallback: "llama3.1:8b-instruct-q8_0",
+        install: "ollama pull qwen2.5:14b-instruct-q5_K_M",
+    },
+    "12GB_VRAM": {
+        primary: "mistral-nemo:12b-instruct-q5_K_M",
+        fallback: "llama3.1:8b-instruct-q6_K",
+        install: "ollama pull mistral-nemo:12b-instruct-q5_K_M",
+    },
+    "8GB_VRAM": {
+        primary: "llama3.1:8b-instruct-q6_K",
+        fallback: "llama3.2:3b-instruct-q8_0",
+        install: "ollama pull llama3.1:8b-instruct-q6_K",
+    },
+};
+//# sourceMappingURL=llm.js.map

package/dist/llm.js.map

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

package/dist/output-manager.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Output Manager for Dynamic Context Discovery
+ *
+ * Reduces token usage by ~80% through:
+ * - Writing full results to files (referenced by path)
+ * - Returning compact summaries inline
+ * - Providing retrieval hints for common queries
+ *
+ * Full results stored at: ~/.local/share/4da/context/results/
+ */
+/**
+ * Compact result format - what gets returned inline to Claude
+ */
+export interface CompactResult<T> {
+    /** 2-3 sentence human-readable summary */
+    summary: string;
+    /** Essential 20% of data inline for immediate use */
+    key_data: T;
+    /** Path to complete JSON file */
+    full_result_path: string;
+    /** Hints for retrieving specific data (jq patterns, grep patterns) */
+    retrieval_hints: string[];
+}
+/**
+ * Get the results directory path (for documentation)
+ */
+export declare function getResultsDir(): string;
+/**
+ * Daily Briefing compact output
+ */
+export interface DailyBriefingKeyData {
+    total_items: number;
+    high_priority: number;
+    top_theme: string;
+    tldr: string;
+    executive_brief?: string;
+}
+export declare function createDailyBriefingCompact(result: {
+    summary: {
+        total_items_analyzed: number;
+        high_relevance_count: number;
+        tldr: string;
+    };
+    themes: {
+        name: string;
+        item_count: number;
+    }[];
+    ai_synthesis?: {
+        executive_brief: string;
+    };
+}): CompactResult<DailyBriefingKeyData>;
+/**
+ * Trend Analysis compact output
+ */
+export interface TrendAnalysisKeyData {
+    total_items: number;
+    volume_trend: string;
+    top_rising: string | null;
+    top_falling: string | null;
+    anomaly_count: number;
+    narrative?: string;
+}
+export declare function createTrendAnalysisCompact(result: {
+    summary: {
+        total_items: number;
+        volume_trend: string;
+        top_rising_topic: string | null;
+        top_falling_topic: string | null;
+    };
+    anomalies: unknown[];
+    ai_interpretation?: {
+        narrative: string;
+    };
+}): CompactResult<TrendAnalysisKeyData>;
+/**
+ * Score Autopsy compact output
+ */
+export interface ScoreAutopsyKeyData {
+    item_title: string;
+    final_score: number;
+    score_assessment?: "accurate" | "too_high" | "too_low" | "uncertain";
+    top_contributor: string;
+    verdict?: string;
+}
+export declare function createScoreAutopsyCompact(result: {
+    item: {
+        title: string;
+    };
+    final_score: number;
+    components: {
+        name: string;
+        contribution: number;
+    }[];
+    ai_analysis?: {
+        score_assessment: "accurate" | "too_high" | "too_low" | "uncertain";
+        verdict: string;
+    };
+}): CompactResult<ScoreAutopsyKeyData>;
+/**
+ * Context Analysis compact output
+ */
+export interface ContextAnalysisKeyData {
+    quality_score: number;
+    interests_count: number;
+    tech_count: number;
+    gap_count: number;
+    top_recommendation: string;
+    personalized_advice?: string;
+}
+export declare function createContextAnalysisCompact(result: {
+    context_summary: {
+        interests_count: number;
+        tech_stack_count: number;
+    };
+    quality_score: {
+        overall: number;
+    };
+    coverage_gaps: unknown[];
+    recommendations: {
+        action: string;
+    }[];
+    ai_advice?: {
+        personalized_recommendations: string;
+    };
+}): CompactResult<ContextAnalysisKeyData>;
+/**
+ * Topic Connections compact output
+ */
+export interface TopicConnectionsKeyData {
+    items_analyzed: number;
+    node_count: number;
+    edge_count: number;
+    central_topics: string[];
+    top_connection: {
+        from: string;
+        to: string;
+        strength: number;
+    } | null;
+    graph_narrative?: string;
+}
+export declare function createTopicConnectionsCompact(result: {
+    analysis_period: {
+        items_analyzed: number;
+    };
+    nodes: unknown[];
+    edges: {
+        from: string;
+        to: string;
+        co_occurrences: number;
+    }[];
+    central_topics: string[];
+    ai_insights?: {
+        graph_narrative: string;
+    };
+}): CompactResult<TopicConnectionsKeyData>;
+//# sourceMappingURL=output-manager.d.ts.map

package/dist/output-manager.d.ts.map

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