mcp-omnisearch/dist/providers/enhancement/jina_grounding/index.js

MCP server for integrating Omnisearch with LLMs

import { http_json } from '../../../common/http.js';
import { ErrorType, ProviderError, } from '../../../common/types.js';
import { handle_provider_error, retry_with_backoff, validate_api_key, } from '../../../common/utils.js';
import { config } from '../../../config/env.js';
export class JinaGroundingProvider {
    constructor() {
        this.name = 'jina_grounding';
        this.description = 'Real-time fact verification against web knowledge. Reduces hallucinations and improves content integrity through statement verification.';
    }
    async enhance_content(content) {
        const api_key = validate_api_key(config.enhancement.jina_grounding.api_key, this.name);
        const ground_request = async () => {
            try {
                const data = await http_json(this.name, 'https://g.jina.ai', {
                    method: 'POST',
                    headers: {
                        'Content-Type': 'application/json',
                        Authorization: `Bearer ${api_key}`,
                    },
                    body: JSON.stringify({ statement: content }),
                    signal: AbortSignal.timeout(config.enhancement.jina_grounding.timeout),
                });
                if (!data?.data) {
                    throw new ProviderError(ErrorType.API_ERROR, 'Unexpected response: missing data from Jina Grounding', this.name);
                }
                // Format references into a readable string
                const references_text = data.data.references
                    .map((ref) => `${ref.is_supportive ? '✓' : '✗'} ${ref.key_quote} (${ref.url})`)
                    .join('\n\n');
                return {
                    original_content: content,
                    enhanced_content: `Factuality Score: ${data.data.factuality}\nVerdict: ${data.data.result ? 'True' : 'False'}\n\nReasoning: ${data.data.reason}\n\nReferences:\n${references_text}`,
                    enhancements: [
                        {
                            type: 'fact_verification',
                            description: 'Verified factual accuracy against real-time web knowledge',
                        },
                    ],
                    sources: data.data.references.map((ref) => ({
                        title: ref.key_quote,
                        url: ref.url,
                    })),
                    source_provider: this.name,
                    meta: {
                        factuality: data.data.factuality,
                        result: data.data.result,
                        token_usage: data.data.usage.tokens,
                    },
                };
            }
            catch (error) {
                handle_provider_error(error, this.name, 'ground content');
            }
        };
        return retry_with_backoff(ground_request);
    }
}