@auxiora/research 1.0.0

package/dist/engine.js

@@ -0,0 +1,204 @@
+import { nanoid } from 'nanoid';
+import { BraveSearchClient } from './brave-search.js';
+import { CredibilityScorer } from './credibility.js';
+import { CitationTracker } from './citation.js';
+export class ResearchEngine {
+    config;
+    braveClient;
+    provider;
+    credibilityScorer = new CredibilityScorer();
+    constructor(config) {
+        const apiKey = config?.braveApiKey ?? process.env.AUXIORA_RESEARCH_BRAVE_API_KEY;
+        if (!apiKey) {
+            throw new Error('Research engine requires a Brave Search API key (braveApiKey or AUXIORA_RESEARCH_BRAVE_API_KEY)');
+        }
+        this.config = {
+            maxConcurrentSources: config?.maxConcurrentSources ?? 5,
+            defaultDepth: config?.defaultDepth ?? 'standard',
+            searchTimeout: config?.searchTimeout ?? 10_000,
+            fetchTimeout: config?.fetchTimeout ?? 15_000,
+        };
+        this.braveClient = new BraveSearchClient({
+            apiKey,
+            searchTimeout: this.config.searchTimeout,
+            fetchTimeout: this.config.fetchTimeout,
+        });
+        this.provider = config?.provider;
+    }
+    async research(query) {
+        const startTime = Date.now();
+        const depth = query.depth ?? this.config.defaultDepth;
+        const maxSources = query.maxSources ?? this.getMaxSources(depth);
+        const searchQueries = this.planResearch(query.topic, depth, query.focusAreas);
+        const tracker = new CitationTracker();
+        const findings = [];
+        // Execute searches in parallel, limited to maxSources total results
+        const searchPromises = searchQueries.map((q) => this.braveClient.search(q, 3));
+        const searchResults = await Promise.all(searchPromises);
+        // Flatten and deduplicate by URL, cap at maxSources
+        const seenUrls = new Set();
+        const uniqueResults = [];
+        for (let i = 0; i < searchResults.length; i++) {
+            for (const result of searchResults[i]) {
+                if (!seenUrls.has(result.url) && uniqueResults.length < maxSources) {
+                    seenUrls.add(result.url);
+                    uniqueResults.push({
+                        query: searchQueries[i],
+                        url: result.url,
+                        title: result.title,
+                        snippet: result.description,
+                    });
+                }
+            }
+        }
+        // Fetch pages in parallel
+        const fetchPromises = uniqueResults.map((r) => this.braveClient.fetchPage(r.url));
+        const pageContents = await Promise.all(fetchPromises);
+        // Process each result
+        for (let i = 0; i < uniqueResults.length; i++) {
+            const r = uniqueResults[i];
+            const credibility = this.credibilityScorer.score(r.url, {
+                isHttps: r.url.startsWith('https'),
+            });
+            const source = tracker.addSource(r.url, r.title, credibility);
+            const content = pageContents[i];
+            if (this.provider && content) {
+                // AI-powered extraction
+                const extracted = await this.extractFindings(r.query, content, r.title);
+                for (const text of extracted) {
+                    tracker.addFinding(text, source.id, credibility, 'general');
+                }
+            }
+            else {
+                // Fallback: use search snippet + first paragraph from fetched content
+                let text = r.snippet;
+                if (content) {
+                    const firstParagraph = content.split('\n\n').find((p) => p.trim().length > 50);
+                    if (firstParagraph) {
+                        text += ' ' + firstParagraph.trim();
+                    }
+                }
+                tracker.addFinding(text, source.id, credibility, 'general');
+            }
+        }
+        const allFindings = tracker.getFindings();
+        const deduplicated = this.deduplicateFindings(allFindings);
+        const sources = tracker.getSources();
+        // Synthesize summary
+        let executiveSummary;
+        if (this.provider && deduplicated.length > 0) {
+            executiveSummary = await this.synthesizeWithAI(query.topic, deduplicated, sources);
+        }
+        else {
+            executiveSummary = this.synthesize(deduplicated);
+        }
+        return {
+            id: nanoid(),
+            query,
+            findings: deduplicated,
+            executiveSummary,
+            sources,
+            confidence: Math.min(deduplicated.length / maxSources, 1),
+            generatedAt: Date.now(),
+            durationMs: Date.now() - startTime,
+        };
+    }
+    planResearch(topic, depth, focusAreas) {
+        let queries;
+        switch (depth) {
+            case 'quick':
+                queries = [topic];
+                break;
+            case 'standard':
+                queries = [topic, `${topic} overview`, `${topic} analysis`];
+                break;
+            case 'deep':
+                queries = [
+                    topic,
+                    `${topic} overview`,
+                    `${topic} analysis`,
+                    `${topic} comparison`,
+                    `${topic} best practices`,
+                    `${topic} research papers`,
+                ];
+                break;
+        }
+        if (focusAreas?.length) {
+            for (const area of focusAreas) {
+                queries.push(`${topic} ${area}`);
+            }
+        }
+        return queries;
+    }
+    synthesize(findings) {
+        const sourceIds = new Set(findings.map((f) => f.sourceId));
+        const topFindings = findings
+            .sort((a, b) => b.relevance - a.relevance)
+            .slice(0, 3)
+            .map((f) => f.content);
+        return `Based on ${findings.length} findings from ${sourceIds.size} sources: ${topFindings.join('. ')}`;
+    }
+    deduplicateFindings(findings) {
+        const seen = new Set();
+        return findings.filter((f) => {
+            if (seen.has(f.content)) {
+                return false;
+            }
+            seen.add(f.content);
+            return true;
+        });
+    }
+    async extractFindings(query, content, title) {
+        if (!this.provider)
+            return [];
+        try {
+            const result = await this.provider.complete([{ role: 'user', content: `Extract key findings from this source about "${query}".\n\nSource: ${title}\n\nContent:\n${content.slice(0, 8000)}` }], {
+                systemPrompt: 'You are a research assistant. Extract 2-4 distinct factual findings from the source. Return each finding on a separate line, prefixed with "- ". Be concise and factual.',
+                maxTokens: 500,
+                temperature: 0.1,
+            });
+            return result.content
+                .split('\n')
+                .filter((line) => line.startsWith('- '))
+                .map((line) => line.slice(2).trim())
+                .filter((line) => line.length > 10);
+        }
+        catch {
+            return [];
+        }
+    }
+    async synthesizeWithAI(topic, findings, sources) {
+        if (!this.provider)
+            return this.synthesize(findings);
+        try {
+            const findingsText = findings
+                .sort((a, b) => b.relevance - a.relevance)
+                .slice(0, 10)
+                .map((f, i) => `${i + 1}. ${f.content}`)
+                .join('\n');
+            const sourcesText = sources
+                .map((s) => `- ${s.title} (${s.domain}, credibility: ${s.credibilityScore.toFixed(2)})`)
+                .join('\n');
+            const result = await this.provider.complete([{ role: 'user', content: `Synthesize these research findings about "${topic}" into a concise executive summary.\n\nFindings:\n${findingsText}\n\nSources:\n${sourcesText}` }], {
+                systemPrompt: 'You are a research analyst. Write a concise executive summary (2-4 paragraphs) synthesizing the findings. Mention source credibility where relevant. Be factual and balanced.',
+                maxTokens: 800,
+                temperature: 0.3,
+            });
+            return result.content;
+        }
+        catch {
+            return this.synthesize(findings);
+        }
+    }
+    getMaxSources(depth) {
+        switch (depth) {
+            case 'quick':
+                return 3;
+            case 'standard':
+                return 5;
+            case 'deep':
+                return 10;
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { ResearchDepth, ResearchQuery, ResearchResult, Finding, Source, CredibilityFactors, KnowledgeEntity, KnowledgeRelation, ResearchProvider, BraveWebResult, BraveSearchResponse, } from './types.js';
+export { ResearchEngine, type ResearchEngineConfig } from './engine.js';
+export { BraveSearchClient, type BraveSearchOptions } from './brave-search.js';
+export { CredibilityScorer } from './credibility.js';
+export { CitationTracker } from './citation.js';
+export { KnowledgeGraph } from './knowledge-graph.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,OAAO,EACP,MAAM,EACN,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { ResearchEngine } from './engine.js';
+export { BraveSearchClient } from './brave-search.js';
+export { CredibilityScorer } from './credibility.js';
+export { CitationTracker } from './citation.js';
+export { KnowledgeGraph } from './knowledge-graph.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAA6B,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAA2B,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/knowledge-graph.d.ts

@@ -0,0 +1,22 @@
+import type { KnowledgeEntity, KnowledgeRelation } from './types.js';
+export declare class KnowledgeGraph {
+    private entities;
+    private relations;
+    addEntity(name: string, type: string, properties?: Record<string, string>): KnowledgeEntity;
+    getEntity(id: string): KnowledgeEntity | undefined;
+    findByName(name: string): KnowledgeEntity | undefined;
+    findByType(type: string): KnowledgeEntity[];
+    addRelation(fromId: string, toId: string, relation: string): void;
+    getRelated(entityId: string): Array<{
+        entity: KnowledgeEntity;
+        relation: string;
+        direction: 'from' | 'to';
+    }>;
+    removeEntity(id: string): boolean;
+    toJSON(): {
+        entities: KnowledgeEntity[];
+        relations: KnowledgeRelation[];
+    };
+    clear(): void;
+}
+//# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/knowledge-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../src/knowledge-graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,SAAS,CAA2B;IAE5C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe;IAY3F,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIlD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IASrD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IAU3C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIjE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,MAAM,EAAE,eAAe,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAqB5G,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQjC,MAAM,IAAI;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;QAAC,SAAS,EAAE,iBAAiB,EAAE,CAAA;KAAE;IAOzE,KAAK,IAAI,IAAI;CAId"}

package/dist/knowledge-graph.js

@@ -0,0 +1,74 @@
+import { nanoid } from 'nanoid';
+export class KnowledgeGraph {
+    entities = new Map();
+    relations = [];
+    addEntity(name, type, properties) {
+        const entity = {
+            id: nanoid(),
+            name,
+            type,
+            properties: properties ?? {},
+        };
+        this.entities.set(entity.id, entity);
+        return entity;
+    }
+    getEntity(id) {
+        return this.entities.get(id);
+    }
+    findByName(name) {
+        for (const entity of this.entities.values()) {
+            if (entity.name === name) {
+                return entity;
+            }
+        }
+        return undefined;
+    }
+    findByType(type) {
+        const result = [];
+        for (const entity of this.entities.values()) {
+            if (entity.type === type) {
+                result.push(entity);
+            }
+        }
+        return result;
+    }
+    addRelation(fromId, toId, relation) {
+        this.relations.push({ fromId, toId, relation });
+    }
+    getRelated(entityId) {
+        const result = [];
+        for (const rel of this.relations) {
+            if (rel.fromId === entityId) {
+                const entity = this.entities.get(rel.toId);
+                if (entity) {
+                    result.push({ entity, relation: rel.relation, direction: 'from' });
+                }
+            }
+            if (rel.toId === entityId) {
+                const entity = this.entities.get(rel.fromId);
+                if (entity) {
+                    result.push({ entity, relation: rel.relation, direction: 'to' });
+                }
+            }
+        }
+        return result;
+    }
+    removeEntity(id) {
+        const deleted = this.entities.delete(id);
+        if (deleted) {
+            this.relations = this.relations.filter((r) => r.fromId !== id && r.toId !== id);
+        }
+        return deleted;
+    }
+    toJSON() {
+        return {
+            entities: Array.from(this.entities.values()),
+            relations: [...this.relations],
+        };
+    }
+    clear() {
+        this.entities.clear();
+        this.relations = [];
+    }
+}
+//# sourceMappingURL=knowledge-graph.js.map

package/dist/knowledge-graph.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+export type ResearchDepth = 'quick' | 'standard' | 'deep';
+export interface ResearchQuery {
+    topic: string;
+    depth: ResearchDepth;
+    maxSources?: number;
+    focusAreas?: string[];
+}
+export interface ResearchResult {
+    id: string;
+    query: ResearchQuery;
+    findings: Finding[];
+    executiveSummary: string;
+    sources: Source[];
+    confidence: number;
+    generatedAt: number;
+    durationMs: number;
+}
+export interface Finding {
+    id: string;
+    content: string;
+    sourceId: string;
+    relevance: number;
+    category: string;
+}
+export interface Source {
+    id: string;
+    url: string;
+    title: string;
+    domain: string;
+    accessedAt: number;
+    credibilityScore: number;
+}
+export interface CredibilityFactors {
+    domainReputation: number;
+    hasAuthor: boolean;
+    hasDate: boolean;
+    isHttps: boolean;
+    crossReferenced: boolean;
+}
+export interface KnowledgeEntity {
+    id: string;
+    name: string;
+    type: string;
+    properties: Record<string, string>;
+}
+export interface KnowledgeRelation {
+    fromId: string;
+    toId: string;
+    relation: string;
+}
+/** Minimal provider interface — avoids hard dep on @auxiora/providers */
+export interface ResearchProvider {
+    complete(messages: {
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }[], options?: {
+        systemPrompt?: string;
+        maxTokens?: number;
+        temperature?: number;
+    }): Promise<{
+        content: string;
+    }>;
+}
+export interface BraveWebResult {
+    title: string;
+    url: string;
+    description: string;
+    extra_snippets?: string[];
+}
+export interface BraveSearchResponse {
+    web?: {
+        results: BraveWebResult[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CACN,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,EACtE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5E,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE;QACJ,OAAO,EAAE,cAAc,EAAE,CAAC;KAC3B,CAAC;CACH"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@auxiora/research",
+  "version": "1.0.0",
+  "description": "Deep multi-source research agent with citation tracking and knowledge graph",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "nanoid": "^5.1.2",
+    "@auxiora/audit": "1.0.0",
+    "@auxiora/logger": "1.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/brave-search.ts

@@ -0,0 +1,130 @@
+import type { BraveSearchResponse, BraveWebResult } from './types.js';
+
+const BRAVE_SEARCH_URL = 'https://api.search.brave.com/res/v1/web/search';
+const USER_AGENT = 'Auxiora/1.0 (Research Engine)';
+
+export interface BraveSearchOptions {
+  apiKey: string;
+  searchTimeout?: number;
+  fetchTimeout?: number;
+}
+
+export class BraveSearchClient {
+  private readonly apiKey: string;
+  private readonly searchTimeout: number;
+  private readonly fetchTimeout: number;
+
+  constructor(options: BraveSearchOptions) {
+    this.apiKey = options.apiKey;
+    this.searchTimeout = options.searchTimeout ?? 10_000;
+    this.fetchTimeout = options.fetchTimeout ?? 15_000;
+  }
+
+  async search(query: string, count = 5): Promise<BraveWebResult[]> {
+    const url = new URL(BRAVE_SEARCH_URL);
+    url.searchParams.set('q', query);
+    url.searchParams.set('count', String(count));
+
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.searchTimeout);
+
+    try {
+      const response = await fetch(url.toString(), {
+        headers: {
+          'Accept': 'application/json',
+          'X-Subscription-Token': this.apiKey,
+          'User-Agent': USER_AGENT,
+        },
+        signal: controller.signal,
+      });
+
+      if (!response.ok) {
+        throw new Error(`Brave Search API error: ${response.status} ${response.statusText}`);
+      }
+
+      const data = (await response.json()) as BraveSearchResponse;
+      return (data.web?.results ?? []).map((r) => ({
+        ...r,
+        description: stripHtml(r.description),
+        extra_snippets: r.extra_snippets?.map(stripHtml),
+      }));
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+
+  async fetchPage(url: string): Promise<string> {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.fetchTimeout);
+
+    try {
+      const response = await fetch(url, {
+        headers: { 'User-Agent': USER_AGENT },
+        signal: controller.signal,
+        redirect: 'follow',
+      });
+
+      if (!response.ok) {
+        return '';
+      }
+
+      const contentType = response.headers.get('content-type') ?? '';
+      if (!contentType.includes('text/html') && !contentType.includes('text/plain')) {
+        return '';
+      }
+
+      const html = await response.text();
+      const maxLength = 15_000;
+      return htmlToMarkdown(html).slice(0, maxLength);
+    } catch {
+      return '';
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+}
+
+/** Strip HTML tags and decode entities from short text (e.g. Brave snippets). */
+function stripHtml(text: string): string {
+  return text
+    .replace(/<[^>]+>/g, '')
+    .replace(/&nbsp;/g, ' ')
+    .replace(/&amp;/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;/g, "'")
+    .trim();
+}
+
+/**
+ * Simple HTML to markdown conversion.
+ * Local copy to avoid circular dependency with @auxiora/tools.
+ */
+function htmlToMarkdown(html: string): string {
+  let text = html.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '');
+  text = text.replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '');
+
+  text = text.replace(/<h1[^>]*>(.*?)<\/h1>/gi, '\n# $1\n');
+  text = text.replace(/<h2[^>]*>(.*?)<\/h2>/gi, '\n## $1\n');
+  text = text.replace(/<h3[^>]*>(.*?)<\/h3>/gi, '\n### $1\n');
+
+  text = text.replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi, '[$2]($1)');
+  text = text.replace(/<li[^>]*>(.*?)<\/li>/gi, '- $1\n');
+  text = text.replace(/<p[^>]*>(.*?)<\/p>/gi, '$1\n\n');
+  text = text.replace(/<br\s*\/?>/gi, '\n');
+
+  text = text.replace(/<[^>]+>/g, '');
+
+  text = text.replace(/&nbsp;/g, ' ');
+  text = text.replace(/&amp;/g, '&');
+  text = text.replace(/&lt;/g, '<');
+  text = text.replace(/&gt;/g, '>');
+  text = text.replace(/&quot;/g, '"');
+  text = text.replace(/&#39;/g, "'");
+
+  text = text.replace(/\n{3,}/g, '\n\n');
+  text = text.replace(/[ \t]{2,}/g, ' ');
+
+  return text.trim();
+}