/** * DeepResearchAgent - Agent for comprehensive research tasks */ export interface Citation { title: string; url: string; snippet?: string; } export interface ReasoningStep { step: number; thought: string; action?: string; result?: string; } export interface ResearchResponse { answer: string; citations: Citation[]; reasoning: ReasoningStep[]; confidence: number; } /** * Python parity: DeepResearchResponse with additional fields */ export interface DeepResearchResponse extends ResearchResponse { /** Query that was researched */ query: string; /** Total iterations performed */ iterations: number; /** Time taken in seconds */ duration?: number; /** Model used */ model?: string; } /** * Python parity: Code execution step in research */ export interface CodeExecutionStep { /** Code that was executed */ code: string; /** Language of the code */ language: string; /** Output from execution */ output?: string; /** Error if execution failed */ error?: string; /** Whether execution succeeded */ success: boolean; } /** * Python parity: File search call during research */ export interface FileSearchCall { /** Query used for file search */ query: string; /** Files that matched */ files: string[]; /** Snippets from matched files */ snippets?: Array<{ file: string; content: string; line?: number; }>; } /** * Python parity: MCP (Model Context Protocol) call during research */ export interface MCPCall { /** Server name */ server: string; /** Tool name */ tool: string; /** Arguments passed */ arguments: Record; /** Result from the call */ result?: any; /** Error if call failed */ error?: string; } /** * Python parity: Web search call during research */ export interface WebSearchCall { /** Search query */ query: string; /** Search engine used */ engine?: string; /** Results returned */ results: Citation[]; /** Number of results */ count: number; } /** * Supported Deep Research providers. * * Python parity: praisonaiagents/agent/deep_research_agent.py `class Provider(Enum)` * (OPENAI = "openai", GEMINI = "gemini", LITELLM = "litellm"). * * Exposed as a const object plus a string-literal union so that both * `Provider.OPENAI` (value) and `Provider` (type) work, mirroring the enum. */ export declare const Provider: { readonly OPENAI: "openai"; readonly GEMINI: "gemini"; readonly LITELLM: "litellm"; }; export type Provider = (typeof Provider)[keyof typeof Provider]; export interface DeepResearchConfig { name?: string; llm?: string; maxIterations?: number; searchTool?: (query: string) => Promise; verbose?: boolean; } /** * DeepResearchAgent - Comprehensive research with citations */ export declare class DeepResearchAgent { readonly name: string; private provider; private providerPromise; private llmModel; private maxIterations; private searchTool?; private verbose; constructor(config?: DeepResearchConfig); private getProvider; /** * Conduct deep research on a topic */ research(query: string): Promise; private generateSearchQueries; private synthesizeAnswer; /** * Set search tool */ setSearchTool(tool: (query: string) => Promise): void; } /** * Create a DeepResearchAgent */ export declare function createDeepResearchAgent(config?: DeepResearchConfig): DeepResearchAgent;