@framers/agentos-ext-deep-research 0.1.0

package/dist/engine/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview Type definitions for the Deep Research Engine.
+ */
+export type ResearchDepth = 'quick' | 'moderate' | 'deep';
+export interface ResearchBudget {
+    maxSearchQueries: number;
+    maxPageExtractions: number;
+    maxLLMCalls: number;
+    maxTotalTimeMs: number;
+    maxOutputTokens: number;
+}
+export declare const BUDGET_DEFAULTS: Record<ResearchDepth, ResearchBudget>;
+export declare const ITERATION_DEFAULTS: Record<ResearchDepth, number>;
+export interface Finding {
+    claim: string;
+    evidence: string;
+    sources: string[];
+    confidence: number;
+    category: string;
+}
+export interface ExtractedContent {
+    url: string;
+    title: string;
+    content: string;
+    wordCount: number;
+    type: 'web' | 'pdf' | 'youtube' | 'wikipedia' | 'academic';
+    extractedAt: string;
+}
+export interface SearchResultItem {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export type NodeStatus = 'pending' | 'searching' | 'extracting' | 'complete' | 'failed';
+export interface ResearchNode {
+    id: string;
+    query: string;
+    parentId: string | null;
+    depth: number;
+    status: NodeStatus;
+    searchResults: SearchResultItem[];
+    extractedContent: ExtractedContent[];
+    findings: Finding[];
+    subQueries: string[];
+    children: string[];
+    confidenceScore: number;
+    gapAnalysis: string[];
+}
+export interface ResearchTree {
+    rootQuery: string;
+    rootId: string;
+    nodes: Record<string, ResearchNode>;
+    maxDepth: number;
+    iterations: number;
+}
+export interface SourceCitation {
+    url: string;
+    title: string;
+    relevance: number;
+    confidence: number;
+    citedInFindings: string[];
+}
+export type ResearchPhase = 'decomposing' | 'searching' | 'extracting' | 'analyzing_gaps' | 'synthesizing' | 'complete';
+export interface ResearchProgressEvent {
+    phase: ResearchPhase;
+    iteration: number;
+    totalIterations: number;
+    currentQuery?: string;
+    findingsCount: number;
+    sourcesCount: number;
+    elapsedMs: number;
+    budget: {
+        searchesUsed: number;
+        extractionsUsed: number;
+        llmCallsUsed: number;
+    };
+}
+export interface DeepResearchInput {
+    query: string;
+    depth?: ResearchDepth;
+    maxIterations?: number;
+    sources?: Array<'web' | 'academic' | 'news' | 'social'>;
+    focusAreas?: string[];
+    budget?: Partial<ResearchBudget>;
+}
+export interface DeepResearchOutput {
+    executiveSummary: string;
+    detailedFindings: Finding[];
+    sources: SourceCitation[];
+    knowledgeGaps: string[];
+    researchTree: ResearchTree;
+    metadata: {
+        query: string;
+        depth: ResearchDepth;
+        totalSearches: number;
+        totalExtractions: number;
+        totalLLMCalls: number;
+        totalTimeMs: number;
+        iterations: number;
+    };
+}
+/** Async function that calls an LLM and returns the text response. */
+export type LLMInvoker = (prompt: string) => Promise<string>;
+export interface DeepResearchEngineConfig {
+    /** Cheap LLM for decomposition & gap analysis (e.g. gpt-4o-mini). */
+    smallInvoker: LLMInvoker;
+    /** Mid-tier LLM for final synthesis (e.g. gpt-4o). */
+    synthesisInvoker: LLMInvoker;
+    /** Optional web search service. Engine creates a minimal one if not provided. */
+    searchFn?: (query: string, maxResults?: number) => Promise<SearchResultItem[]>;
+    /** Optional content extraction function. */
+    extractFn?: (url: string) => Promise<{
+        title: string;
+        content: string;
+        wordCount: number;
+    }>;
+    /** Optional progress callback. */
+    onProgress?: (event: ResearchProgressEvent) => void;
+    /** Firecrawl API key for enhanced content extraction. */
+    firecrawlApiKey?: string;
+    /** Firecrawl configuration. */
+    firecrawl?: {
+        /** Use Firecrawl /scrape instead of raw fetch in iterate phase. Default: true when API key present. */
+        scrapeForIterate?: boolean;
+        /** Enable /crawl for deep research depth. Default: false. */
+        enableCrawl?: boolean;
+        /** Max pages per crawl job. Default: 10. */
+        maxCrawlPages?: number;
+    };
+    /** Optional reranker function — runs on findings before synthesis. */
+    rerankFindingsFn?: (query: string, findings: Finding[]) => Promise<Finding[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/types.d.ts.map

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

package/dist/engine/types.js

@@ -0,0 +1,18 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @fileoverview Type definitions for the Deep Research Engine.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ITERATION_DEFAULTS = exports.BUDGET_DEFAULTS = void 0;
+exports.BUDGET_DEFAULTS = {
+    quick: { maxSearchQueries: 10, maxPageExtractions: 5, maxLLMCalls: 3, maxTotalTimeMs: 30000, maxOutputTokens: 2000 },
+    moderate: { maxSearchQueries: 20, maxPageExtractions: 10, maxLLMCalls: 8, maxTotalTimeMs: 120000, maxOutputTokens: 8000 },
+    deep: { maxSearchQueries: 50, maxPageExtractions: 25, maxLLMCalls: 20, maxTotalTimeMs: 540000, maxOutputTokens: 20000 },
+};
+exports.ITERATION_DEFAULTS = {
+    quick: 1,
+    moderate: 3,
+    deep: 6,
+};
+//# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":";AAAA,cAAc;AACd;;GAEG;;;AAgBU,QAAA,eAAe,GAA0C;IACpE,KAAK,EAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAG,WAAW,EAAE,CAAC,EAAG,cAAc,EAAE,KAAM,EAAG,eAAe,EAAE,IAAK,EAAE;IAC5H,QAAQ,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAG,cAAc,EAAE,MAAO,EAAE,eAAe,EAAE,IAAK,EAAE;IAC5H,IAAI,EAAM,EAAE,gBAAgB,EAAE,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,MAAO,EAAE,eAAe,EAAE,KAAM,EAAE;CAC9H,CAAC;AAEW,QAAA,kBAAkB,GAAkC;IAC/D,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,CAAC;CACR,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Deep Research Extension for AgentOS.
+ *
+ * Provides 5 tools for multi-source investigation, academic search,
+ * content scraping, aggregate search, and trend discovery.
+ *
+ * @module @framers/agentos-ext-deep-research
+ */
+export interface DeepResearchOptions {
+    serperApiKey?: string;
+    braveApiKey?: string;
+    serpApiKey?: string;
+    secrets?: Record<string, string>;
+    /** OpenAI-compatible API key for LLM calls (decomposition, gap analysis, synthesis). */
+    openaiApiKey?: string;
+    /** OpenRouter API key — used as fallback if openaiApiKey is not set. */
+    openrouterApiKey?: string;
+    /** Primary LLM provider: 'openai' | 'openrouter' | 'ollama'. Defaults to 'openai'. */
+    primaryProvider?: string;
+    /** Small model for decomposition/gap analysis (default: gpt-4o-mini). */
+    smallModel?: string;
+    /** Synthesis model (default: gpt-4o). */
+    synthesisModel?: string;
+}
+export interface ExtensionContext {
+    options?: Record<string, unknown>;
+    secrets?: Record<string, string>;
+}
+export interface ExtensionPack {
+    name: string;
+    version: string;
+    descriptors: Array<{
+        id: string;
+        kind: string;
+        priority?: number;
+        payload: unknown;
+    }>;
+    onActivate?: () => Promise<void>;
+    onDeactivate?: () => Promise<void>;
+}
+export declare function createExtensionPack(context: ExtensionContext): ExtensionPack;
+export { ResearchService } from './ResearchService.js';
+export type { ResearchConfig, InvestigationResult, AcademicResult, ScrapeResult, AggregateResult, TrendingResult, } from './ResearchService.js';
+export { ResearchInvestigateTool } from './tools/investigate.js';
+export { ResearchAcademicTool } from './tools/academic.js';
+export { ResearchScrapeTool } from './tools/scrape.js';
+export { ResearchAggregateTool } from './tools/aggregate.js';
+export { ResearchTrendingTool } from './tools/trending.js';
+export { DeepResearchEngine } from './engine/DeepResearchEngine.js';
+export { DeepResearchTool } from './engine/DeepResearchTool.js';
+export { ResearchBudgetTracker } from './engine/ResearchBudgetTracker.js';
+export type { DeepResearchInput, DeepResearchOutput, ResearchDepth, ResearchBudget, LLMInvoker, DeepResearchEngineConfig, } from './engine/types.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":"AACA;;;;;;;GAOG;AAiBH,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA8ED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtF,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAqE5E;AAMD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,UAAU,EACV,wBAAwB,GACzB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,161 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @fileoverview Deep Research Extension for AgentOS.
+ *
+ * Provides 5 tools for multi-source investigation, academic search,
+ * content scraping, aggregate search, and trend discovery.
+ *
+ * @module @framers/agentos-ext-deep-research
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResearchBudgetTracker = exports.DeepResearchTool = exports.DeepResearchEngine = exports.ResearchTrendingTool = exports.ResearchAggregateTool = exports.ResearchScrapeTool = exports.ResearchAcademicTool = exports.ResearchInvestigateTool = exports.ResearchService = void 0;
+exports.createExtensionPack = createExtensionPack;
+const ResearchService_js_1 = require("./ResearchService.js");
+const investigate_js_1 = require("./tools/investigate.js");
+const academic_js_1 = require("./tools/academic.js");
+const scrape_js_1 = require("./tools/scrape.js");
+const aggregate_js_1 = require("./tools/aggregate.js");
+const trending_js_1 = require("./tools/trending.js");
+const DeepResearchEngine_js_1 = require("./engine/DeepResearchEngine.js");
+const DeepResearchTool_js_1 = require("./engine/DeepResearchTool.js");
+// ---------------------------------------------------------------------------
+// Secret Resolution
+// ---------------------------------------------------------------------------
+function resolveConfig(opts, secrets) {
+    return {
+        serperApiKey: opts.serperApiKey ?? secrets['serper.apiKey'] ?? process.env.SERPER_API_KEY ?? '',
+        braveApiKey: opts.braveApiKey ?? secrets['brave.apiKey'] ?? process.env.BRAVE_API_KEY,
+        serpApiKey: opts.serpApiKey ?? secrets['serpapi.apiKey'] ?? process.env.SERPAPI_API_KEY,
+    };
+}
+function buildInvoker(cfg) {
+    return async (prompt) => {
+        const resp = await fetch(`${cfg.baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${cfg.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: cfg.model,
+                messages: [{ role: 'user', content: prompt }],
+                temperature: 0.1,
+                max_tokens: cfg.maxTokens,
+            }),
+        });
+        if (!resp.ok) {
+            throw new Error(`LLM API error ${resp.status}: ${await resp.text().catch(() => 'unknown')}`);
+        }
+        const data = await resp.json();
+        return data.choices?.[0]?.message?.content ?? '';
+    };
+}
+function resolveLLMConfig(opts, secrets) {
+    const provider = opts.primaryProvider ?? 'openai';
+    const apiKey = opts.openaiApiKey ??
+        secrets['openai.apiKey'] ??
+        opts.openrouterApiKey ??
+        secrets['openrouter.apiKey'] ??
+        process.env.OPENAI_API_KEY ??
+        process.env.OPENROUTER_API_KEY ??
+        '';
+    let baseUrl;
+    if (provider === 'openrouter' || (!opts.openaiApiKey && (opts.openrouterApiKey || process.env.OPENROUTER_API_KEY))) {
+        baseUrl = 'https://openrouter.ai/api/v1';
+    }
+    else if (provider === 'ollama') {
+        baseUrl = 'http://localhost:11434/v1';
+    }
+    else {
+        baseUrl = 'https://api.openai.com/v1';
+    }
+    const smallModel = opts.smallModel ?? 'gpt-4o-mini';
+    const synthesisModel = opts.synthesisModel ?? 'gpt-4o';
+    return { apiKey, baseUrl, smallModel, synthesisModel };
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+function createExtensionPack(context) {
+    const opts = (context.options ?? {});
+    const secrets = opts.secrets ?? context.secrets ?? {};
+    const config = resolveConfig(opts, secrets);
+    const service = new ResearchService_js_1.ResearchService(config);
+    const investigateTool = new investigate_js_1.ResearchInvestigateTool(service);
+    const academicTool = new academic_js_1.ResearchAcademicTool(service);
+    const scrapeTool = new scrape_js_1.ResearchScrapeTool(service);
+    const aggregateTool = new aggregate_js_1.ResearchAggregateTool(service);
+    const trendingTool = new trending_js_1.ResearchTrendingTool(service);
+    // ── Deep Research Engine ──
+    const llmConfig = resolveLLMConfig(opts, secrets);
+    const hasLLMKey = llmConfig.apiKey.length > 0;
+    const smallInvoker = hasLLMKey
+        ? buildInvoker({ apiKey: llmConfig.apiKey, baseUrl: llmConfig.baseUrl, model: llmConfig.smallModel, maxTokens: 1000 })
+        : async () => '[]'; // No-op fallback — engine will use raw query
+    const synthesisInvoker = hasLLMKey
+        ? buildInvoker({ apiKey: llmConfig.apiKey, baseUrl: llmConfig.baseUrl, model: llmConfig.synthesisModel, maxTokens: 4000 })
+        : async () => ''; // No-op fallback — engine will use fallbackSynthesis
+    // Wire search function to use the existing SearchProviderService if web-search extension is loaded,
+    // otherwise fall back to engine's built-in DDG scraping
+    const searchFn = async (query, maxResults) => {
+        try {
+            const results = await service.aggregateSearch(query, ['serper', 'brave', 'serpapi'], maxResults ?? 10);
+            return results.flatMap((r) => r.results.map((item) => ({ title: item.title, url: item.url, snippet: item.snippet })));
+        }
+        catch {
+            return []; // Engine will fall back to DDG scraping
+        }
+    };
+    const engine = new DeepResearchEngine_js_1.DeepResearchEngine({
+        smallInvoker,
+        synthesisInvoker,
+        searchFn: config.serperApiKey ? searchFn : undefined, // Only use searchFn if we have API keys
+        onProgress: (event) => {
+            if (process.env.DEBUG) {
+                console.log(`[DeepResearch] ${event.phase} — iteration ${event.iteration}/${event.totalIterations}, findings: ${event.findingsCount}, sources: ${event.sourcesCount}`);
+            }
+        },
+    });
+    const deepResearchTool = new DeepResearchTool_js_1.DeepResearchTool(engine);
+    return {
+        name: '@framers/agentos-ext-deep-research',
+        version: '0.2.0',
+        descriptors: [
+            { id: 'researchInvestigate', kind: 'tool', priority: 50, payload: investigateTool },
+            { id: 'researchAcademic', kind: 'tool', priority: 50, payload: academicTool },
+            { id: 'researchScrape', kind: 'tool', priority: 50, payload: scrapeTool },
+            { id: 'researchAggregate', kind: 'tool', priority: 50, payload: aggregateTool },
+            { id: 'researchTrending', kind: 'tool', priority: 50, payload: trendingTool },
+            { id: 'deepResearch', kind: 'tool', priority: 90, payload: deepResearchTool },
+        ],
+        onActivate: async () => {
+            await service.initialize();
+        },
+        onDeactivate: async () => {
+            await service.shutdown();
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Public exports
+// ---------------------------------------------------------------------------
+var ResearchService_js_2 = require("./ResearchService.js");
+Object.defineProperty(exports, "ResearchService", { enumerable: true, get: function () { return ResearchService_js_2.ResearchService; } });
+var investigate_js_2 = require("./tools/investigate.js");
+Object.defineProperty(exports, "ResearchInvestigateTool", { enumerable: true, get: function () { return investigate_js_2.ResearchInvestigateTool; } });
+var academic_js_2 = require("./tools/academic.js");
+Object.defineProperty(exports, "ResearchAcademicTool", { enumerable: true, get: function () { return academic_js_2.ResearchAcademicTool; } });
+var scrape_js_2 = require("./tools/scrape.js");
+Object.defineProperty(exports, "ResearchScrapeTool", { enumerable: true, get: function () { return scrape_js_2.ResearchScrapeTool; } });
+var aggregate_js_2 = require("./tools/aggregate.js");
+Object.defineProperty(exports, "ResearchAggregateTool", { enumerable: true, get: function () { return aggregate_js_2.ResearchAggregateTool; } });
+var trending_js_2 = require("./tools/trending.js");
+Object.defineProperty(exports, "ResearchTrendingTool", { enumerable: true, get: function () { return trending_js_2.ResearchTrendingTool; } });
+var DeepResearchEngine_js_2 = require("./engine/DeepResearchEngine.js");
+Object.defineProperty(exports, "DeepResearchEngine", { enumerable: true, get: function () { return DeepResearchEngine_js_2.DeepResearchEngine; } });
+var DeepResearchTool_js_2 = require("./engine/DeepResearchTool.js");
+Object.defineProperty(exports, "DeepResearchTool", { enumerable: true, get: function () { return DeepResearchTool_js_2.DeepResearchTool; } });
+var ResearchBudgetTracker_js_1 = require("./engine/ResearchBudgetTracker.js");
+Object.defineProperty(exports, "ResearchBudgetTracker", { enumerable: true, get: function () { return ResearchBudgetTracker_js_1.ResearchBudgetTracker; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/academic.d.ts

@@ -0,0 +1,41 @@
+import type { ResearchService } from '../ResearchService.js';
+export declare class ResearchAcademicTool {
+    private service;
+    readonly id = "researchAcademic";
+    readonly name = "researchAcademic";
+    readonly displayName = "Academic Paper Search";
+    readonly description = "Search academic papers on arXiv, Google Scholar, and Semantic Scholar.";
+    readonly category = "research";
+    readonly version = "0.1.0";
+    readonly hasSideEffects = false;
+    readonly inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            source: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            maxResults: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(service: ResearchService);
+    execute(args: {
+        query: string;
+        source?: 'arxiv' | 'scholar' | 'semantic';
+        maxResults?: number;
+    }): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=academic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"academic.d.ts","sourceRoot":"","sources":["../../src/tools/academic.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,qBAAa,oBAAoB;IAuBnB,OAAO,CAAC,OAAO;IAtB3B,QAAQ,CAAC,EAAE,sBAAsB;IACjC,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,2BAA2B;IAC/C,QAAQ,CAAC,WAAW,4EAA4E;IAChG,QAAQ,CAAC,QAAQ,cAAc;IAC/B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,cAAc,SAAS;IAEhC,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;MAYlB;gBAEkB,OAAO,EAAE,eAAe;IAEtC,OAAO,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;QAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAW9D"}

package/dist/tools/academic.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResearchAcademicTool = void 0;
+class ResearchAcademicTool {
+    constructor(service) {
+        this.service = service;
+        this.id = 'researchAcademic';
+        this.name = 'researchAcademic';
+        this.displayName = 'Academic Paper Search';
+        this.description = 'Search academic papers on arXiv, Google Scholar, and Semantic Scholar.';
+        this.category = 'research';
+        this.version = '0.1.0';
+        this.hasSideEffects = false;
+        this.inputSchema = {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Academic search query (keywords, paper title, author name)' },
+                source: {
+                    type: 'string',
+                    enum: ['arxiv', 'scholar', 'semantic'],
+                    description: 'Academic source to search (default: arxiv)',
+                },
+                maxResults: { type: 'number', description: 'Maximum number of papers to return (default 10)' },
+            },
+            required: ['query'],
+        };
+    }
+    async execute(args) {
+        try {
+            const results = await this.service.searchAcademic(args.query, {
+                source: args.source,
+                maxResults: args.maxResults,
+            });
+            return { success: true, data: results };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+}
+exports.ResearchAcademicTool = ResearchAcademicTool;
+//# sourceMappingURL=academic.js.map

package/dist/tools/academic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"academic.js","sourceRoot":"","sources":["../../src/tools/academic.ts"],"names":[],"mappings":";;;AAGA,MAAa,oBAAoB;IAuB/B,YAAoB,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;QAtBnC,OAAE,GAAG,kBAAkB,CAAC;QACxB,SAAI,GAAG,kBAAkB,CAAC;QAC1B,gBAAW,GAAG,uBAAuB,CAAC;QACtC,gBAAW,GAAG,wEAAwE,CAAC;QACvF,aAAQ,GAAG,UAAU,CAAC;QACtB,YAAO,GAAG,OAAO,CAAC;QAClB,mBAAc,GAAG,KAAK,CAAC;QAEvB,gBAAW,GAAG;YACrB,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4DAA4D,EAAE;gBACpG,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC;oBACtC,WAAW,EAAE,4CAA4C;iBAC1D;gBACD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;aAC/F;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB,CAAC;IAE6C,CAAC;IAEhD,KAAK,CAAC,OAAO,CAAC,IAIb;QACC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE;gBAC5D,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;CACF;AAxCD,oDAwCC"}

package/dist/tools/aggregate.d.ts

@@ -0,0 +1,44 @@
+import type { ResearchService } from '../ResearchService.js';
+export declare class ResearchAggregateTool {
+    private service;
+    readonly id = "researchAggregate";
+    readonly name = "researchAggregate";
+    readonly displayName = "Aggregate Search";
+    readonly description = "Unified search across multiple engines (Serper, Brave, SerpAPI) with merged results.";
+    readonly category = "research";
+    readonly version = "0.1.0";
+    readonly hasSideEffects = false;
+    readonly inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            engines: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+            maxResults: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(service: ResearchService);
+    execute(args: {
+        query: string;
+        engines?: string[];
+        maxResults?: number;
+    }): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=aggregate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../src/tools/aggregate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,qBAAa,qBAAqB;IAuBpB,OAAO,CAAC,OAAO;IAtB3B,QAAQ,CAAC,EAAE,uBAAuB;IAClC,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,sBAAsB;IAC1C,QAAQ,CAAC,WAAW,0FAA0F;IAC9G,QAAQ,CAAC,QAAQ,cAAc;IAC/B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,cAAc,SAAS;IAEhC,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;MAYlB;gBAEkB,OAAO,EAAE,eAAe;IAEtC,OAAO,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAY9D"}

package/dist/tools/aggregate.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResearchAggregateTool = void 0;
+class ResearchAggregateTool {
+    constructor(service) {
+        this.service = service;
+        this.id = 'researchAggregate';
+        this.name = 'researchAggregate';
+        this.displayName = 'Aggregate Search';
+        this.description = 'Unified search across multiple engines (Serper, Brave, SerpAPI) with merged results.';
+        this.category = 'research';
+        this.version = '0.1.0';
+        this.hasSideEffects = false;
+        this.inputSchema = {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query' },
+                engines: {
+                    type: 'array',
+                    items: { type: 'string', enum: ['serper', 'brave', 'serpapi'] },
+                    description: 'Search engines to query (default: serper)',
+                },
+                maxResults: { type: 'number', description: 'Maximum results per engine (default 10)' },
+            },
+            required: ['query'],
+        };
+    }
+    async execute(args) {
+        try {
+            const results = await this.service.aggregateSearch(args.query, args.engines ?? ['serper'], args.maxResults ?? 10);
+            return { success: true, data: results };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+}
+exports.ResearchAggregateTool = ResearchAggregateTool;
+//# sourceMappingURL=aggregate.js.map

package/dist/tools/aggregate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../../src/tools/aggregate.ts"],"names":[],"mappings":";;;AAGA,MAAa,qBAAqB;IAuBhC,YAAoB,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;QAtBnC,OAAE,GAAG,mBAAmB,CAAC;QACzB,SAAI,GAAG,mBAAmB,CAAC;QAC3B,gBAAW,GAAG,kBAAkB,CAAC;QACjC,gBAAW,GAAG,sFAAsF,CAAC;QACrG,aAAQ,GAAG,UAAU,CAAC;QACtB,YAAO,GAAG,OAAO,CAAC;QAClB,mBAAc,GAAG,KAAK,CAAC;QAEvB,gBAAW,GAAG;YACrB,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;gBACtD,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE;oBAC/D,WAAW,EAAE,2CAA2C;iBACzD;gBACD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;aACvF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB,CAAC;IAE6C,CAAC;IAEhD,KAAK,CAAC,OAAO,CAAC,IAIb;QACC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAChD,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,EAC1B,IAAI,CAAC,UAAU,IAAI,EAAE,CACtB,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;CACF;AAzCD,sDAyCC"}

package/dist/tools/investigate.d.ts

@@ -0,0 +1,44 @@
+import type { ResearchService } from '../ResearchService.js';
+export declare class ResearchInvestigateTool {
+    private service;
+    readonly id = "researchInvestigate";
+    readonly name = "researchInvestigate";
+    readonly displayName = "Multi-Source Investigation";
+    readonly description = "Conduct a multi-source investigation with claim verification and cross-referencing across web, academic, social, and news sources.";
+    readonly category = "research";
+    readonly version = "0.1.0";
+    readonly hasSideEffects = false;
+    readonly inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            sources: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+            maxResults: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(service: ResearchService);
+    execute(args: {
+        query: string;
+        sources?: string[];
+        maxResults?: number;
+    }): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=investigate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"investigate.d.ts","sourceRoot":"","sources":["../../src/tools/investigate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,qBAAa,uBAAuB;IAuBtB,OAAO,CAAC,OAAO;IAtB3B,QAAQ,CAAC,EAAE,yBAAyB;IACpC,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,WAAW,gCAAgC;IACpD,QAAQ,CAAC,WAAW,wIAAwI;IAC5J,QAAQ,CAAC,QAAQ,cAAc;IAC/B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,cAAc,SAAS;IAEhC,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;MAYlB;gBAEkB,OAAO,EAAE,eAAe;IAEtC,OAAO,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAY9D"}