velixar-mcp-server 0.2.4 → 1.2.0

package/dist/temporal_merge.js

@@ -0,0 +1,258 @@
+// ── Temporal Merge ──
+// Shared module for chain detection, supersession marking, temporal decay,
+// and current/superseded grouping. Stateless — all functions are pure transforms.
+// Consumers: multi_search, search_neighborhood, coverage_check, context upgrade, prepare_context.
+// ── Configuration ──
+const DECAY_RATE = parseFloat(process.env.VELIXAR_TEMPORAL_DECAY_RATE || '0.02');
+const SUPERSEDED_FACTOR = 0.3;
+const BROKEN_CHAIN_FACTOR = 0.6;
+const HEURISTIC_SUPERSESSION_DAYS = 7;
+const CONTENT_SIMILARITY_THRESHOLD = 0.95;
+/**
+ * Detect supersession relationships from chain links (previous_memory_id / derived_from).
+ * Returns a map of superseded_id → superseding_id.
+ */
+export function detectChains(memories) {
+    const idSet = new Set(memories.map(m => m.id));
+    const childrenOf = new Map(); // parent_id → [child_ids]
+    const hasParent = new Set();
+    for (const mem of memories) {
+        const parentIds = mem.provenance.derived_from || [];
+        for (const parentId of parentIds) {
+            hasParent.add(mem.id);
+            const children = childrenOf.get(parentId) || [];
+            children.push(mem.id);
+            childrenOf.set(parentId, children);
+        }
+    }
+    const supersededBy = new Map();
+    const forks = new Set();
+    const brokenChains = new Set();
+    for (const [parentId, children] of childrenOf) {
+        if (children.length > 1) {
+            // Fork: parent has multiple children — flag as contradiction, not supersession
+            forks.add(parentId);
+        }
+        else if (children.length === 1) {
+            if (idSet.has(parentId)) {
+                // Parent is in our result set — mark as superseded
+                supersededBy.set(parentId, children[0]);
+            }
+        }
+    }
+    // Detect broken chains: memory references a parent not in our result set
+    for (const mem of memories) {
+        const parentIds = mem.provenance.derived_from || [];
+        for (const parentId of parentIds) {
+            if (!idSet.has(parentId)) {
+                brokenChains.add(mem.id);
+            }
+        }
+    }
+    // Chain heads: memories that are not superseded and not forked
+    const chainHeads = new Set();
+    for (const mem of memories) {
+        if (!supersededBy.has(mem.id) && !forks.has(mem.id)) {
+            chainHeads.add(mem.id);
+        }
+    }
+    return { supersededBy, chainHeads, forks, brokenChains };
+}
+// ── Timestamp Heuristic Supersession ──
+/**
+ * For memories without chain links, detect possible supersession by timestamp gap.
+ * Groups by content similarity — only memories about the same topic can supersede each other.
+ * Returns low-confidence supersession pairs.
+ */
+export function detectHeuristicSupersession(memories, alreadySuperseded) {
+    const result = new Map();
+    const candidates = memories.filter(m => !alreadySuperseded.has(m.id));
+    for (let i = 0; i < candidates.length; i++) {
+        for (let j = i + 1; j < candidates.length; j++) {
+            const a = candidates[i];
+            const b = candidates[j];
+            // Only consider if both have timestamps
+            const tsA = new Date(a.provenance.created_at).getTime();
+            const tsB = new Date(b.provenance.created_at).getTime();
+            if (isNaN(tsA) || isNaN(tsB))
+                continue;
+            const daysDiff = Math.abs(tsB - tsA) / (1000 * 60 * 60 * 24);
+            if (daysDiff < HEURISTIC_SUPERSESSION_DAYS)
+                continue;
+            // Check content similarity via tag overlap (lightweight proxy for cosine)
+            const tagsA = new Set(a.tags);
+            const tagsB = new Set(b.tags);
+            const overlap = [...tagsA].filter(t => tagsB.has(t)).length;
+            const maxTags = Math.max(tagsA.size, tagsB.size, 1);
+            if (overlap / maxTags < 0.5)
+                continue;
+            // Older one is possibly superseded
+            const [older, newer] = tsA < tsB ? [a, b] : [b, a];
+            if (!alreadySuperseded.has(older.id) && !result.has(older.id)) {
+                result.set(older.id, { supersededBy: newer.id, confidence: 'inferred' });
+            }
+        }
+    }
+    return result;
+}
+// ── Temporal Decay ──
+/**
+ * Apply temporal decay to relevance scores.
+ * Semantic (tier 2) and pinned (tier 0) memories are exempt — they represent durable knowledge.
+ * Only episodic memories (tier 1) decay.
+ */
+export function applyTemporalDecay(mem) {
+    // Exempt semantic and pinned memories from decay
+    if (mem.memory_type === 'semantic')
+        return mem.relevance ?? 0;
+    const createdAt = new Date(mem.provenance.created_at).getTime();
+    if (isNaN(createdAt))
+        return mem.relevance ?? 0;
+    const daysSince = (Date.now() - createdAt) / (1000 * 60 * 60 * 24);
+    const freshness = Math.exp(-DECAY_RATE * daysSince);
+    return (mem.relevance ?? 0) * (0.7 + 0.3 * freshness);
+}
+// ── Full Temporal Merge Pipeline ──
+/**
+ * Takes a flat list of memories, applies chain detection, supersession marking,
+ * temporal decay, and returns grouped results.
+ */
+export function temporalMerge(memories) {
+    if (memories.length === 0) {
+        return {
+            current: [],
+            superseded: [],
+            temporal_context: {
+                newest_memory: '', oldest_memory: '', chain_count: 0,
+                fork_count: 0, broken_chain_count: 0, warning: null,
+            },
+        };
+    }
+    // Step 1: Chain detection
+    const { supersededBy, chainHeads, forks, brokenChains } = detectChains(memories);
+    // Step 2: Heuristic supersession for unchained memories
+    const explicitlySuperseded = new Set(supersededBy.keys());
+    const heuristic = detectHeuristicSupersession(memories, explicitlySuperseded);
+    // Step 3: Build temporal memories with annotations
+    const temporal = memories.map(mem => {
+        const isExplicitlySuperseded = supersededBy.has(mem.id);
+        const isHeuristicallySuperseded = heuristic.has(mem.id);
+        const isSuperseded = isExplicitlySuperseded || isHeuristicallySuperseded;
+        const isFork = forks.has(mem.id);
+        const isBrokenChain = brokenChains.has(mem.id);
+        const tmem = {
+            ...mem,
+            _original_relevance: mem.relevance,
+            _superseded: isSuperseded,
+            _superseded_by: isExplicitlySuperseded
+                ? supersededBy.get(mem.id)
+                : isHeuristicallySuperseded
+                    ? heuristic.get(mem.id).supersededBy
+                    : undefined,
+            _supersession_confidence: isExplicitlySuperseded
+                ? 'explicit'
+                : isHeuristicallySuperseded
+                    ? 'inferred'
+                    : 'none',
+            _chain_head: chainHeads.has(mem.id),
+            _chain_broken: isBrokenChain,
+            _chain_fork: isFork,
+        };
+        // Step 4: Apply relevance adjustments
+        if (isExplicitlySuperseded) {
+            tmem.relevance = (mem.relevance ?? 0) * SUPERSEDED_FACTOR;
+        }
+        else if (isBrokenChain) {
+            tmem.relevance = (mem.relevance ?? 0) * BROKEN_CHAIN_FACTOR;
+        }
+        else if (!isHeuristicallySuperseded) {
+            // Only apply temporal decay to non-superseded memories
+            tmem.relevance = applyTemporalDecay(tmem);
+        }
+        // Heuristic supersession: do NOT auto-demote, just label
+        return tmem;
+    });
+    // Step 5: Group
+    const current = temporal
+        .filter(m => !m._superseded || m._supersession_confidence === 'inferred')
+        .sort((a, b) => (b.relevance ?? 0) - (a.relevance ?? 0));
+    const superseded = temporal
+        .filter(m => m._superseded && m._supersession_confidence === 'explicit')
+        .sort((a, b) => (b.relevance ?? 0) - (a.relevance ?? 0));
+    // Step 6: Temporal context metadata
+    const timestamps = memories
+        .map(m => m.provenance.created_at)
+        .filter(Boolean)
+        .sort();
+    const spanDays = timestamps.length >= 2
+        ? (new Date(timestamps[timestamps.length - 1]).getTime() - new Date(timestamps[0]).getTime()) / (1000 * 60 * 60 * 24)
+        : 0;
+    return {
+        current,
+        superseded,
+        temporal_context: {
+            newest_memory: timestamps[timestamps.length - 1] || '',
+            oldest_memory: timestamps[0] || '',
+            chain_count: supersededBy.size,
+            fork_count: forks.size,
+            broken_chain_count: brokenChains.size,
+            warning: spanDays > 14
+                ? `Results span ${Math.round(spanDays)} days — beliefs may have evolved`
+                : forks.size > 0
+                    ? `${forks.size} chain fork(s) detected — possible contradictions`
+                    : null,
+        },
+    };
+}
+// ── Multi-Query Merge ──
+/**
+ * Deduplicate and merge memories from multiple search queries.
+ * Memories appearing in multiple queries get boosted scores.
+ * H3.4: Returns matched_query_indices per memory (not full strings).
+ * H3.5: Never reorders input queries — indices are stable.
+ */
+export function mergeMultiQueryResults(perQueryResults, strategy = 'weighted', limit = 10, queryWeights, threshold = 2) {
+    const seen = new Map();
+    for (let qi = 0; qi < perQueryResults.length; qi++) {
+        const weight = queryWeights?.[qi] ?? 1;
+        for (const mem of perQueryResults[qi].memories) {
+            const existing = seen.get(mem.id);
+            const weightedScore = (mem.relevance ?? 0) * weight;
+            if (existing) {
+                existing.hitCount++;
+                existing.maxScore = Math.max(existing.maxScore, weightedScore);
+                existing.queryIndices.push(qi);
+            }
+            else {
+                seen.set(mem.id, { mem, hitCount: 1, maxScore: weightedScore, queryIndices: [qi] });
+            }
+        }
+    }
+    let merged = [...seen.values()].map(({ mem, hitCount, maxScore, queryIndices }) => ({
+        ...mem,
+        relevance: strategy === 'weighted'
+            ? maxScore * (1 + 0.2 * (hitCount - 1))
+            : maxScore,
+        _hit_count: hitCount,
+        _matched_queries: hitCount,
+        _query_indices: queryIndices,
+    }));
+    if (strategy === 'intersection') {
+        merged = merged.filter(m => m._hit_count >= threshold);
+    }
+    merged.sort((a, b) => (b.relevance ?? 0) - (a.relevance ?? 0));
+    const totalSlots = perQueryResults.reduce((sum, r) => sum + r.memories.length, 0);
+    const diversity_score = totalSlots > 0 ? seen.size / totalSlots : 1;
+    // H3.4: Build matched_query_indices map
+    const matched_query_indices = {};
+    for (const item of merged.slice(0, limit)) {
+        matched_query_indices[item.id] = item._query_indices;
+    }
+    return {
+        merged: merged.slice(0, limit),
+        diversity_score: Math.round(diversity_score * 100) / 100,
+        per_query_counts: perQueryResults.map(r => r.memories.length),
+        matched_query_indices,
+    };
+}
+//# sourceMappingURL=temporal_merge.js.map

package/dist/temporal_merge.js.map

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

package/dist/tools/clairvoyance.d.ts

@@ -0,0 +1,9 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ApiClient } from '../api.js';
+import type { ApiConfig } from '../types.js';
+export declare const clairvoyanceTools: Tool[];
+export declare function handleClairvoyanceTool(name: string, args: Record<string, unknown>, api: ApiClient, config: ApiConfig): Promise<{
+    text: string;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=clairvoyance.d.ts.map

package/dist/tools/clairvoyance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clairvoyance.d.ts","sourceRoot":"","sources":["../../src/tools/clairvoyance.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C,eAAO,MAAM,iBAAiB,EAAE,IAAI,EAyD9B,CAAC;AA+BP,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA8P9C"}

package/dist/tools/clairvoyance.js

@@ -0,0 +1,321 @@
+// ── Clairvoyance MCP Tools ──
+// velixar_simulate, velixar_scenario, velixar_predict
+// Enterprise add-on only. Gated by VELIXAR_CLAIRVOYANCE flag.
+import { randomUUID } from 'node:crypto';
+import { wrapResponse } from '../api.js';
+import { validateSearchResponse } from '../validate.js';
+import { generatePersonas } from '../simulation/personas.js';
+import { runSimulation } from '../simulation/runner.js';
+import { generateReport } from '../simulation/report.js';
+const CLAIRVOYANCE_ENABLED = process.env.VELIXAR_CLAIRVOYANCE === 'true';
+export const clairvoyanceTools = CLAIRVOYANCE_ENABLED ? [
+    {
+        name: 'velixar_simulate',
+        description: 'Run a multi-agent simulation to explore potential outcomes. Enterprise add-on. ' +
+            'Returns a prediction report with confidence ranges, risks, and assumptions. Metered — cost estimate shown first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                question: { type: 'string', description: 'The "what if" question to simulate' },
+                context: { type: 'string', description: 'Additional context to seed the simulation' },
+                agent_count: { type: 'number', description: 'Number of personas (default 12, max 30)' },
+                round_count: { type: 'number', description: 'Simulation rounds (default 20, max 50)' },
+                variables: { type: 'object', description: 'Key variables to inject (e.g., {"price_increase": "20%"})' },
+                persona_types: { type: 'array', items: { type: 'string' }, description: 'Override persona types: customer, competitor, regulator, internal_team, market_force, investor' },
+                fresh: { type: 'boolean', description: 'Exclude past simulation insights (default: false)' },
+                async: { type: 'boolean', description: 'Non-blocking mode — returns simulation_id immediately (default: false)' },
+                seed: { type: 'number', description: 'Random seed for reproducible simulations' },
+                model: { type: 'string', description: 'LLM model override (default: gpt-4o-mini)' },
+            },
+            required: ['question'],
+        },
+    },
+    {
+        name: 'velixar_scenario',
+        description: 'Compare multiple scenarios side by side. Runs parallel simulations with different variables. Enterprise add-on. Metered.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                question: { type: 'string', description: 'The base question' },
+                scenarios: {
+                    type: 'array',
+                    items: { type: 'object', properties: { name: { type: 'string' }, variables: { type: 'object' } }, required: ['name', 'variables'] },
+                    description: 'Array of {name, variables} to compare',
+                },
+                agent_count: { type: 'number', description: 'Personas per scenario (default 12)' },
+                round_count: { type: 'number', description: 'Rounds per scenario (default 20)' },
+                verify: { type: 'boolean', description: 'Run top 2 scenarios twice for stability check (doubles cost for those 2)' },
+            },
+            required: ['question', 'scenarios'],
+        },
+    },
+    {
+        name: 'velixar_predict',
+        description: 'Lightweight prediction using existing memories and patterns — no simulation. Enterprise add-on. ' +
+            'Returns prediction with confidence and supporting evidence.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                question: { type: 'string', description: 'The prediction question' },
+                depth: { type: 'string', enum: ['quick', 'thorough'], description: 'quick = patterns only, thorough = patterns + search + contradictions (default: thorough)' },
+            },
+            required: ['question'],
+        },
+    },
+] : [];
+// ── LLM Call Factory ──
+function makeLLMCall(api, model) {
+    return async (system, user) => {
+        // Route through Velixar backend LLM proxy or direct OpenAI
+        const res = await api.post('/llm/chat', {
+            model,
+            messages: [
+                { role: 'system', content: system },
+                { role: 'user', content: user },
+            ],
+            temperature: 0.7,
+            max_tokens: 300,
+        });
+        return res.content || res.choices?.[0]?.message?.content || '';
+    };
+}
+// ── Cost Estimation ──
+function estimateCost(agentCount, roundCount, activationProb) {
+    const activePerRound = Math.ceil(agentCount * activationProb);
+    const totalCalls = activePerRound * roundCount;
+    const tokensPerCall = 800; // system prompt + context + response
+    const tokens = totalCalls * tokensPerCall;
+    const cost = tokens * 0.0000006; // GPT-4o-mini approximate
+    const batches = Math.ceil(totalCalls / 10);
+    const timeSeconds = Math.ceil(batches * 0.8) + 8; // +8 for persona gen + report
+    return { tokens, cost: Math.round(cost * 100) / 100, timeSeconds };
+}
+export async function handleClairvoyanceTool(name, args, api, config) {
+    if (!CLAIRVOYANCE_ENABLED) {
+        return {
+            text: JSON.stringify({ error: 'Clairvoyance is an enterprise add-on. Contact sales to enable.' }),
+            isError: true,
+        };
+    }
+    if (name === 'velixar_simulate') {
+        const question = args.question;
+        const variables = args.variables || {};
+        const agentCount = Math.min(args.agent_count || 12, 30); // H2.6
+        const roundCount = Math.min(args.round_count || 20, 50); // H2.6
+        const model = args.model || 'gpt-4o-mini';
+        const fresh = args.fresh;
+        const seed = args.seed;
+        const simulationId = `sim-${randomUUID().slice(0, 12)}`;
+        // Cost estimate (shown before execution)
+        const activationProb = Math.max(0.6, Math.min(0.9, 1 - (roundCount / 100)));
+        const estimate = estimateCost(agentCount, roundCount, activationProb);
+        // Step 1: Data foundation assessment (Chain 9)
+        let coverageRatio = 0;
+        let seedMemoryCount = 0;
+        try {
+            const params = new URLSearchParams({ q: question, user_id: config.userId, limit: '20' });
+            const raw = await api.get(`/memory/search?${params}`, true);
+            const validated = validateSearchResponse(raw, '/memory/search');
+            seedMemoryCount = validated.memories.length;
+            coverageRatio = Math.min(1.0, seedMemoryCount / 20);
+        }
+        catch { /* proceed with zero coverage */ }
+        const minDataThreshold = args.min_data_threshold || 10;
+        // Step 2: Generate personas
+        const llmCall = makeLLMCall(api, model);
+        const personaResult = await generatePersonas(question, variables, api, config, llmCall, {
+            agentCount, personaTypes: args.persona_types, fresh, simulationId,
+        });
+        const personas = personaResult.personas;
+        // Step 3: Run simulation
+        const result = await runSimulation({
+            simulationId, question, variables, personas, roundCount,
+            llmCall, seed, concurrency: 10, timeoutMs: 60000,
+        });
+        // Step 4: Generate report
+        const report = generateReport(result, personas, coverageRatio, seedMemoryCount, minDataThreshold);
+        // Step 5: Store prediction as hypothesis memory (H4.2: inline disclaimer)
+        try {
+            await api.post('/memory', {
+                content: report.prediction,
+                user_id: config.userId,
+                tier: 2,
+                tags: ['clairvoyance', 'prediction', 'active', simulationId],
+                source_type: 'clairvoyance',
+            });
+        }
+        catch { /* non-blocking */ }
+        // Step 6: Store simulation insight (Chain 11: escapes quarantine)
+        try {
+            const insightContent = `${report.badge} Simulation ${simulationId}: "${question}" → ${result.emergentConsensus} (confidence: ${report.confidenceRange.low}-${report.confidenceRange.high}). Key factors: ${report.keyFactors.slice(0, 2).join('; ')}`;
+            await api.post('/memory', {
+                content: insightContent,
+                user_id: config.userId,
+                tier: 2,
+                tags: ['clairvoyance', 'simulation-insight', simulationId],
+                source_type: 'clairvoyance',
+            });
+        }
+        catch { /* non-blocking */ }
+        // Step 7: Log billing event
+        const usage = { tokens_consumed: result.tokensUsed, estimated_cost: estimate.cost, agent_count: agentCount, round_count: roundCount };
+        return {
+            text: JSON.stringify(wrapResponse({
+                simulation_id: simulationId,
+                report: {
+                    badge: report.badge,
+                    prediction: report.prediction,
+                    confidence: report.confidenceRange,
+                    key_factors: report.keyFactors,
+                    what_could_go_wrong: report.risks,
+                    assumptions: report.assumptions,
+                    timeline: report.timeline,
+                    dissenting_views: report.dissentingViews,
+                    data_foundation: report.dataFoundation,
+                },
+                simulation_metadata: {
+                    rounds_completed: result.rounds.length,
+                    rounds_planned: roundCount,
+                    convergence_round: result.convergenceRound,
+                    personas: result.personas,
+                    aborted: result.aborted,
+                },
+                usage,
+                disclaimer: report.disclaimer,
+                track_this_prediction: report.trackPrompt,
+            }, config)),
+        };
+    }
+    if (name === 'velixar_scenario') {
+        const question = args.question;
+        const scenarios = args.scenarios;
+        const agentCount = Math.min(args.agent_count || 12, 30);
+        const roundCount = Math.min(args.round_count || 20, 50);
+        if (!scenarios?.length || scenarios.length > 5) {
+            return { text: JSON.stringify({ error: 'Provide 1-5 scenarios.' }), isError: true };
+        }
+        // Cost estimate for all scenarios
+        const activationProb = Math.max(0.6, Math.min(0.9, 1 - (roundCount / 100)));
+        const perScenario = estimateCost(agentCount, roundCount, activationProb);
+        const totalEstimate = {
+            tokens: perScenario.tokens * scenarios.length,
+            cost: Math.round(perScenario.cost * scenarios.length * 100) / 100,
+            timeSeconds: perScenario.timeSeconds * 2, // parallel but not instant
+        };
+        // Run all scenarios in parallel
+        const results = await Promise.allSettled(scenarios.map(async (scenario) => {
+            const simId = `sim-${randomUUID().slice(0, 12)}`;
+            const llmCall = makeLLMCall(api, 'gpt-4o-mini');
+            const personaResult = await generatePersonas(question, scenario.variables, api, config, llmCall, {
+                agentCount, simulationId: simId,
+            });
+            const personas = personaResult.personas;
+            const simResult = await runSimulation({
+                simulationId: simId, question, variables: scenario.variables,
+                personas, roundCount, llmCall, concurrency: 10, timeoutMs: 60000,
+            });
+            let coverageRatio = 0, seedMemoryCount = 0;
+            try {
+                const params = new URLSearchParams({ q: question, user_id: config.userId, limit: '20' });
+                const raw = await api.get(`/memory/search?${params}`, true);
+                const validated = validateSearchResponse(raw, '/memory/search');
+                seedMemoryCount = validated.memories.length;
+                coverageRatio = Math.min(1.0, seedMemoryCount / 20);
+            }
+            catch { /* */ }
+            const report = generateReport(simResult, personas, coverageRatio, seedMemoryCount, 10);
+            return { name: scenario.name, variables: scenario.variables, simulationId: simId, report, convergenceRound: simResult.convergenceRound };
+        }));
+        const completed = results
+            .filter((r) => r.status === 'fulfilled')
+            .map(r => r.value);
+        // H6.4: Comparison uses ranges and directional language
+        const comparison = completed.map(s => ({
+            scenario: s.name,
+            variables: s.variables,
+            simulation_id: s.simulationId,
+            confidence: s.report.confidenceRange,
+            consensus: s.report.prediction.split('\n').find((l) => !l.startsWith('['))?.trim() || '',
+            convergence: s.convergenceRound ? `Round ${s.convergenceRound}` : 'Did not converge',
+            top_risk: s.report.risks[0] || 'None identified',
+        }));
+        // Recommendation: highest confidence
+        const best = completed.sort((a, b) => b.report.confidenceRange.high - a.report.confidenceRange.high)[0];
+        return {
+            text: JSON.stringify(wrapResponse({
+                comparison,
+                recommendation: best
+                    ? `"${best.name}" shows the strongest signal (confidence ${best.report.confidenceRange.low}-${best.report.confidenceRange.high}). However, all scenarios carry uncertainty — review assumptions before acting.`
+                    : 'Unable to determine a clear recommendation.',
+                scenarios_completed: completed.length,
+                scenarios_failed: results.filter(r => r.status === 'rejected').length,
+                usage: totalEstimate,
+                disclaimer: 'Scenario comparison shows directional differences, not precise outcomes. Use to inform strategy, not as a forecast.',
+            }, config)),
+        };
+    }
+    if (name === 'velixar_predict') {
+        const question = args.question;
+        const depth = args.depth || 'thorough';
+        // Pattern-based prediction — no simulation, no incremental LLM cost
+        const evidence = [];
+        // Search for relevant memories
+        try {
+            const params = new URLSearchParams({ q: question, user_id: config.userId, limit: '10' });
+            const raw = await api.get(`/memory/search?${params}`, true);
+            const validated = validateSearchResponse(raw, '/memory/search');
+            for (const m of validated.memories) {
+                evidence.push({ content: m.content.slice(0, 200), relevance: m.score ?? 0 });
+            }
+        }
+        catch { /* */ }
+        // Check for existing predictions on this topic
+        let existingPrediction = null;
+        try {
+            const params = new URLSearchParams({ q: `prediction ${question}`, user_id: config.userId, limit: '3', tags: 'clairvoyance,prediction' });
+            const raw = await api.get(`/memory/search?${params}`, true);
+            const validated = validateSearchResponse(raw, '/memory/search');
+            if (validated.memories.length > 0) {
+                existingPrediction = validated.memories[0].content;
+            }
+        }
+        catch { /* */ }
+        // Check patterns
+        let patterns = [];
+        if (depth === 'thorough') {
+            try {
+                const patternData = await api.post('/exocortex/patterns', { topic: question });
+                const p = Array.isArray(patternData?.patterns) ? patternData.patterns : [];
+                patterns = p.slice(0, 3).map(pt => String(pt.description || pt.pattern || ''));
+            }
+            catch { /* */ }
+        }
+        // Check contradictions
+        let contradictions = [];
+        if (depth === 'thorough') {
+            try {
+                const cData = await api.get('/exocortex/contradictions?status=open', true);
+                const cs = Array.isArray(cData?.contradictions) ? cData.contradictions : [];
+                contradictions = cs.slice(0, 3).map(c => `${String(c.statement_a || '').slice(0, 80)} vs ${String(c.statement_b || '').slice(0, 80)}`);
+            }
+            catch { /* */ }
+        }
+        const confidence = Math.min(0.9, evidence.filter(e => e.relevance > 0.5).length / 10 + (patterns.length * 0.1));
+        return {
+            text: JSON.stringify(wrapResponse({
+                question,
+                existing_prediction: existingPrediction,
+                evidence: evidence.slice(0, 5),
+                patterns,
+                contradictions,
+                confidence: Math.round(confidence * 100) / 100,
+                assessment: confidence >= 0.6
+                    ? 'Enough data for a pattern-based estimate. See evidence above.'
+                    : 'Limited data — consider running velixar_simulate for a deeper analysis.',
+                depth,
+            }, config, { data_absent: evidence.length === 0 })),
+        };
+    }
+    throw new Error(`Unknown clairvoyance tool: ${name}`);
+}
+//# sourceMappingURL=clairvoyance.js.map

package/dist/tools/clairvoyance.js.map

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

package/dist/tools/cognitive.d.ts

@@ -0,0 +1,10 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ApiClient } from '../api.js';
+import type { ApiConfig } from '../types.js';
+export declare function trackToolCallForIdentity(): void;
+export declare const cognitiveTools: Tool[];
+export declare function handleCognitiveTool(name: string, args: Record<string, unknown>, api: ApiClient, config: ApiConfig): Promise<{
+    text: string;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=cognitive.d.ts.map