@weavelogic/knowledge-graph-agent 0.2.0 → 0.4.0

package/dist/agents/researcher-agent.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Researcher Agent
+ *
+ * Specialized agent for codebase research, pattern analysis, and documentation research.
+ * Extends BaseAgent with research-specific capabilities and knowledge graph integration.
+ *
+ * @module agents/researcher-agent
+ */
+import { BaseAgent } from './base-agent.js';
+import { type AgentTask, type AgentResult, type ResearcherAgentConfig } from './types.js';
+import { KnowledgeGraphManager } from '../core/graph.js';
+/**
+ * Research query type
+ */
+export type ResearchQueryType = 'codebase' | 'pattern' | 'documentation' | 'reference' | 'general';
+/**
+ * Research query input
+ */
+export interface ResearchQuery {
+    /** Query string */
+    query: string;
+    /** Type of research */
+    type: ResearchQueryType;
+    /** Scope of research (file paths, directories, or patterns) */
+    scope?: string[];
+    /** Include code snippets in results */
+    includeCode?: boolean;
+    /** Maximum results to return */
+    maxResults?: number;
+}
+/**
+ * Code reference found during research
+ */
+export interface CodeReference {
+    /** File path */
+    file: string;
+    /** Line number */
+    line: number;
+    /** Code snippet */
+    code: string;
+    /** Context around the reference */
+    context?: string;
+    /** Relevance score (0-1) */
+    relevance: number;
+}
+/**
+ * Detected pattern
+ */
+export interface DetectedPattern {
+    /** Pattern name */
+    name: string;
+    /** Pattern category */
+    category: string;
+    /** Description of the pattern */
+    description: string;
+    /** Files where pattern is found */
+    locations: string[];
+    /** Frequency/occurrence count */
+    frequency: number;
+    /** Whether this is a recommended pattern */
+    recommended: boolean;
+    /** Related patterns */
+    relatedPatterns?: string[];
+}
+/**
+ * Research finding
+ */
+export interface ResearchFinding {
+    /** Finding title */
+    title: string;
+    /** Finding description */
+    description: string;
+    /** Relevance score (0-1) */
+    relevance: number;
+    /** Source of the finding */
+    source: 'code' | 'documentation' | 'knowledge-graph';
+    /** Related code references */
+    references?: CodeReference[];
+    /** Related patterns */
+    patterns?: DetectedPattern[];
+    /** Related knowledge nodes */
+    relatedNodes?: string[];
+}
+/**
+ * Research result data
+ */
+export interface ResearchResultData {
+    /** Query that was executed */
+    query: ResearchQuery;
+    /** Findings from the research */
+    findings: ResearchFinding[];
+    /** Summary of findings */
+    summary: string;
+    /** Total files analyzed */
+    filesAnalyzed: number;
+    /** Patterns detected */
+    patterns: DetectedPattern[];
+    /** Recommendations */
+    recommendations: string[];
+}
+/**
+ * Researcher Agent
+ *
+ * Capabilities:
+ * - Codebase research and exploration
+ * - Pattern detection and analysis
+ * - Documentation research
+ * - Reference finding across the codebase
+ *
+ * @example
+ * ```typescript
+ * const researcher = new ResearcherAgent({
+ *   name: 'research-agent',
+ *   type: AgentType.RESEARCHER,
+ * });
+ *
+ * const result = await researcher.execute({
+ *   id: 'task-1',
+ *   description: 'Research authentication patterns',
+ *   priority: TaskPriority.MEDIUM,
+ *   input: {
+ *     data: {
+ *       query: 'authentication',
+ *       type: 'pattern',
+ *       scope: ['src/auth']
+ *     }
+ *   },
+ *   createdAt: new Date()
+ * });
+ * ```
+ */
+export declare class ResearcherAgent extends BaseAgent {
+    /** File type patterns for analysis */
+    private readonly codePatterns;
+    /** Documentation patterns */
+    private readonly docPatterns;
+    /** Knowledge graph reference */
+    private knowledgeGraph;
+    constructor(config: Partial<ResearcherAgentConfig> & {
+        name: string;
+    });
+    /**
+     * Set knowledge graph for context-aware research
+     */
+    setKnowledgeGraph(graph: KnowledgeGraphManager): void;
+    /**
+     * Execute research task
+     */
+    protected executeTask(task: AgentTask): Promise<AgentResult<ResearchResultData>>;
+    /**
+     * Perform research based on query
+     */
+    research(query: ResearchQuery, projectRoot: string): Promise<ResearchResultData>;
+    /**
+     * Analyze patterns in the codebase
+     */
+    analyzePatterns(query: string, projectRoot: string): Promise<DetectedPattern[]>;
+    /**
+     * Find references across the codebase
+     */
+    findReferences(searchTerm: string, projectRoot: string, options?: {
+        maxResults?: number;
+        filePatterns?: string[];
+    }): Promise<CodeReference[]>;
+    /**
+     * Summarize research findings
+     */
+    summarizeFindings(findings: ResearchFinding[]): string;
+    /**
+     * Get relevant nodes from knowledge graph
+     */
+    private getRelevantNodes;
+    /**
+     * Research from knowledge graph
+     */
+    private researchKnowledgeGraph;
+    /**
+     * Research from codebase
+     */
+    private researchCodebase;
+    /**
+     * Research from documentation
+     */
+    private researchDocumentation;
+    /**
+     * Detect code patterns
+     */
+    private detectCodePatterns;
+    /**
+     * Find files matching patterns
+     */
+    private findFiles;
+    /**
+     * Get context around a line
+     */
+    private getContext;
+    /**
+     * Calculate relevance of a match
+     */
+    private calculateRelevance;
+    /**
+     * Calculate node relevance
+     */
+    private calculateNodeRelevance;
+    /**
+     * Calculate content relevance
+     */
+    private calculateContentRelevance;
+    /**
+     * Extract title from documentation
+     */
+    private extractDocTitle;
+    /**
+     * Extract description from documentation
+     */
+    private extractDocDescription;
+    /**
+     * Generate summary from findings
+     */
+    private generateSummary;
+    /**
+     * Generate recommendations from research
+     */
+    private generateRecommendations;
+}
+//# sourceMappingURL=researcher-agent.d.ts.map

package/dist/agents/researcher-agent.d.ts.map

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