@ai-coders/context 0.4.0 → 0.5.0

package/dist/services/ai/agents/documentationAgent.js

@@ -0,0 +1,243 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentationAgent = void 0;
+const ai_1 = require("ai");
+const providerFactory_1 = require("../providerFactory");
+const tools_1 = require("../tools");
+const schemas_1 = require("../schemas");
+const agentEvents_1 = require("../agentEvents");
+const semantic_1 = require("../../semantic");
+const contentSanitizer_1 = require("../../../utils/contentSanitizer");
+const SYSTEM_PROMPT = `You are a technical documentation expert. Your task is to analyze code and generate comprehensive documentation.
+
+You have access to tools for:
+- Reading file contents (readFile)
+- Listing files in the repository (listFiles)
+- Analyzing code symbols like classes, functions, interfaces (analyzeSymbols)
+- Getting repository structure (getFileStructure)
+- Searching for code patterns (searchCode)
+
+Use these tools to gather context about the codebase before generating documentation.
+
+When analyzing, focus on:
+1. Understanding the file's purpose and main exports
+2. Identifying dependencies and relationships
+3. Finding usage examples in tests or other files
+4. Discovering patterns and conventions
+
+Generate documentation that is:
+- Clear and concise
+- Practical for developers
+- Includes code examples where helpful
+- Cross-references related files
+
+IMPORTANT OUTPUT FORMAT:
+- Output ONLY the final documentation content in Markdown format
+- Do NOT include your reasoning, planning, or analysis process
+- Do NOT start with phrases like "I will...", "Let me...", "First, I need to..."
+- Begin directly with the documentation title or YAML front matter
+- Your response will be saved directly to a file`;
+class DocumentationAgent {
+    constructor(config) {
+        this.config = config;
+        this.providerResult = (0, providerFactory_1.createProvider)(config);
+        this.tools = (0, tools_1.getCodeAnalysisTools)();
+    }
+    /**
+     * Generate documentation using tools for context gathering
+     */
+    async generateDocumentation(options) {
+        const { repoPath, targetFile, context, maxSteps = 15, maxOutputTokens = 8000, callbacks, useSemanticContext = true, useLSP = false } = options;
+        // Emit agent start event
+        callbacks?.onAgentStart?.({ agent: 'documentation', target: targetFile });
+        // Use semantic context mode for token efficiency
+        if (useSemanticContext) {
+            return this.generateWithSemanticContext(repoPath, targetFile, context, maxOutputTokens, callbacks, useLSP);
+        }
+        // Tool-based mode for thorough analysis
+        return this.generateWithTools(repoPath, targetFile, context, maxSteps, maxOutputTokens, callbacks);
+    }
+    /**
+     * Generate documentation using pre-computed semantic context (more token efficient)
+     */
+    async generateWithSemanticContext(repoPath, targetFile, context, maxOutputTokens, callbacks, useLSP = false) {
+        callbacks?.onToolCall?.({
+            agent: 'documentation',
+            toolName: useLSP ? 'semanticAnalysis+LSP' : 'semanticAnalysis',
+            args: { repoPath, targetFile, useLSP }
+        });
+        // Create context builder with LSP option
+        const contextBuilder = new semantic_1.SemanticContextBuilder({ useLSP });
+        // Pre-compute semantic context
+        const semanticContext = await contextBuilder.buildDocumentationContext(repoPath, targetFile);
+        // Cleanup LSP servers if enabled
+        await contextBuilder.shutdown();
+        const toolName = useLSP ? 'semanticAnalysis+LSP' : 'semanticAnalysis';
+        callbacks?.onToolResult?.({
+            agent: 'documentation',
+            toolName,
+            success: true,
+            summary: `Analyzed codebase${useLSP ? ' with LSP' : ''}: ${semanticContext.length} chars of context`
+        });
+        const userPrompt = `Generate comprehensive documentation for: ${targetFile}
+
+Repository root: ${repoPath}
+
+${semanticContext}
+
+${context ? `Additional context:\n${context}` : ''}
+
+Generate clear, practical documentation that is helpful for developers.`;
+        const { provider, modelId } = this.providerResult;
+        const result = await (0, ai_1.generateText)({
+            model: provider(modelId),
+            system: SYSTEM_PROMPT,
+            prompt: userPrompt,
+            maxOutputTokens
+        });
+        // Emit agent complete event
+        callbacks?.onAgentComplete?.({ agent: 'documentation', toolsUsed: [toolName], steps: 1 });
+        return {
+            text: (0, contentSanitizer_1.sanitizeAIResponse)(result.text, { preserveFrontMatter: true }),
+            toolsUsed: [toolName],
+            steps: 1
+        };
+    }
+    /**
+     * Generate documentation using multi-step tool-based exploration (more thorough)
+     */
+    async generateWithTools(repoPath, targetFile, context, maxSteps, maxOutputTokens, callbacks) {
+        const userPrompt = `Generate comprehensive documentation for: ${targetFile}
+
+Repository root: ${repoPath}
+${context ? `Additional context:\n${context}` : ''}
+
+First, use the available tools to analyze the file and gather context, then generate the documentation.`;
+        const { provider, modelId } = this.providerResult;
+        let stepCount = 0;
+        const result = await (0, ai_1.generateText)({
+            model: provider(modelId),
+            system: SYSTEM_PROMPT,
+            prompt: userPrompt,
+            tools: this.tools,
+            stopWhen: (0, ai_1.stepCountIs)(maxSteps),
+            maxOutputTokens,
+            onStepFinish: (step) => {
+                stepCount++;
+                callbacks?.onAgentStep?.({ agent: 'documentation', step: stepCount });
+                // Report tool calls
+                for (const toolCall of step.toolCalls || []) {
+                    callbacks?.onToolCall?.({
+                        agent: 'documentation',
+                        toolName: toolCall.toolName,
+                        args: 'args' in toolCall ? toolCall.args : undefined
+                    });
+                    // Find the result for this tool call
+                    const toolResult = step.toolResults?.find((r) => 'toolCallId' in r && r.toolCallId === toolCall.toolCallId);
+                    if (toolResult && 'result' in toolResult) {
+                        callbacks?.onToolResult?.({
+                            agent: 'documentation',
+                            toolName: toolCall.toolName,
+                            success: true,
+                            summary: (0, agentEvents_1.summarizeToolResult)(toolCall.toolName, toolResult.result)
+                        });
+                    }
+                }
+            }
+        });
+        // Extract tool names used
+        const toolsUsed = new Set();
+        for (const step of result.steps || []) {
+            for (const toolCall of step.toolCalls || []) {
+                toolsUsed.add(toolCall.toolName);
+            }
+        }
+        const toolsUsedArray = Array.from(toolsUsed);
+        const totalSteps = result.steps?.length || 1;
+        // Emit agent complete event
+        callbacks?.onAgentComplete?.({ agent: 'documentation', toolsUsed: toolsUsedArray, steps: totalSteps });
+        return {
+            text: (0, contentSanitizer_1.sanitizeAIResponse)(result.text, { preserveFrontMatter: true }),
+            toolsUsed: toolsUsedArray,
+            steps: totalSteps
+        };
+    }
+    /**
+     * Generate structured documentation output
+     */
+    async generateStructuredDocumentation(options) {
+        const { repoPath, targetFile, context, maxSteps = 10, maxOutputTokens = 8000, callbacks } = options;
+        // Emit agent start event
+        callbacks?.onAgentStart?.({ agent: 'documentation', target: targetFile });
+        const analysisPrompt = `Analyze ${targetFile} in ${repoPath}.
+1. Read the file
+2. Analyze its symbols
+3. Find related files
+4. Search for usage patterns
+${context ? `\nAdditional context: ${context}` : ''}`;
+        const { provider, modelId } = this.providerResult;
+        let stepCount = 0;
+        // First gather context using tools
+        const analysisResult = await (0, ai_1.generateText)({
+            model: provider(modelId),
+            system: 'You are a code analyst. Use the tools to analyze the file and its context.',
+            prompt: analysisPrompt,
+            tools: this.tools,
+            stopWhen: (0, ai_1.stepCountIs)(maxSteps),
+            maxOutputTokens: Math.floor(maxOutputTokens / 2),
+            onStepFinish: (step) => {
+                stepCount++;
+                callbacks?.onAgentStep?.({ agent: 'documentation', step: stepCount });
+                for (const toolCall of step.toolCalls || []) {
+                    callbacks?.onToolCall?.({
+                        agent: 'documentation',
+                        toolName: toolCall.toolName,
+                        args: 'args' in toolCall ? toolCall.args : undefined
+                    });
+                    const toolResult = step.toolResults?.find((r) => 'toolCallId' in r && r.toolCallId === toolCall.toolCallId);
+                    if (toolResult && 'result' in toolResult) {
+                        callbacks?.onToolResult?.({
+                            agent: 'documentation',
+                            toolName: toolCall.toolName,
+                            success: true,
+                            summary: (0, agentEvents_1.summarizeToolResult)(toolCall.toolName, toolResult.result)
+                        });
+                    }
+                }
+            }
+        });
+        // Extract tool names used
+        const toolsUsed = new Set();
+        for (const step of analysisResult.steps || []) {
+            for (const toolCall of step.toolCalls || []) {
+                toolsUsed.add(toolCall.toolName);
+            }
+        }
+        // Then generate structured output
+        const documentation = await (0, ai_1.generateObject)({
+            model: provider(modelId),
+            schema: schemas_1.DocumentationOutputSchema,
+            system: 'Generate structured documentation based on the analysis.',
+            prompt: `Based on this analysis:\n${analysisResult.text}\n\nGenerate structured documentation for ${targetFile}`,
+            maxOutputTokens: Math.floor(maxOutputTokens / 2)
+        });
+        const toolsUsedArray = Array.from(toolsUsed);
+        // Emit agent complete event
+        callbacks?.onAgentComplete?.({ agent: 'documentation', toolsUsed: toolsUsedArray, steps: stepCount });
+        return {
+            documentation: documentation.object,
+            toolsUsed: toolsUsedArray
+        };
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return {
+            provider: this.config.provider,
+            model: this.providerResult.modelId
+        };
+    }
+}
+exports.DocumentationAgent = DocumentationAgent;
+//# sourceMappingURL=documentationAgent.js.map

package/dist/services/ai/agents/documentationAgent.js.map

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

package/dist/services/ai/agents/index.d.ts

@@ -0,0 +1,7 @@
+export { DocumentationAgent } from './documentationAgent';
+export type { DocumentationAgentOptions, DocumentationAgentResult } from './documentationAgent';
+export { PlaybookAgent } from './playbookAgent';
+export type { PlaybookAgentOptions, PlaybookAgentResult } from './playbookAgent';
+export { PlanAgent } from './planAgent';
+export type { PlanAgentOptions, PlanAgentResult } from './planAgent';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/ai/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/ai/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/services/ai/agents/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanAgent = exports.PlaybookAgent = exports.DocumentationAgent = void 0;
+var documentationAgent_1 = require("./documentationAgent");
+Object.defineProperty(exports, "DocumentationAgent", { enumerable: true, get: function () { return documentationAgent_1.DocumentationAgent; } });
+var playbookAgent_1 = require("./playbookAgent");
+Object.defineProperty(exports, "PlaybookAgent", { enumerable: true, get: function () { return playbookAgent_1.PlaybookAgent; } });
+var planAgent_1 = require("./planAgent");
+Object.defineProperty(exports, "PlanAgent", { enumerable: true, get: function () { return planAgent_1.PlanAgent; } });
+//# sourceMappingURL=index.js.map

package/dist/services/ai/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/ai/agents/index.ts"],"names":[],"mappings":";;;AAAA,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAM3B,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAGtB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA"}

package/dist/services/ai/agents/planAgent.d.ts

@@ -0,0 +1,68 @@
+import type { LLMConfig } from '../../../types';
+import type { DevelopmentPlan } from '../schemas';
+import type { AgentEventCallbacks } from '../agentEvents';
+export interface PlanAgentOptions {
+    repoPath: string;
+    planName: string;
+    summary?: string;
+    existingPlanContent?: string;
+    docsIndex?: string;
+    agentsIndex?: string;
+    referencedDocs?: Array<{
+        path: string;
+        content: string;
+    }>;
+    referencedAgents?: Array<{
+        path: string;
+        content: string;
+    }>;
+    maxSteps?: number;
+    maxOutputTokens?: number;
+    callbacks?: AgentEventCallbacks;
+    /** Use pre-computed semantic context instead of tool-based exploration (more token efficient) */
+    useSemanticContext?: boolean;
+    /** Enable LSP for deeper semantic analysis (type info, references, implementations) */
+    useLSP?: boolean;
+}
+export interface PlanAgentResult {
+    text: string;
+    toolsUsed: string[];
+    steps: number;
+}
+export declare class PlanAgent {
+    private config;
+    private providerResult;
+    private tools;
+    constructor(config: LLMConfig);
+    /**
+     * Generate a new development plan using tools for context gathering
+     */
+    generatePlan(options: PlanAgentOptions): Promise<PlanAgentResult>;
+    /**
+     * Update an existing plan with fresh context
+     */
+    updatePlan(options: PlanAgentOptions): Promise<PlanAgentResult>;
+    /**
+     * Update plan using pre-computed semantic context (more token efficient)
+     */
+    private updatePlanWithSemanticContext;
+    /**
+     * Update plan using multi-step tool-based exploration (more thorough)
+     */
+    private updatePlanWithTools;
+    /**
+     * Generate a structured development plan
+     */
+    generateStructuredPlan(options: PlanAgentOptions): Promise<{
+        plan: DevelopmentPlan;
+        toolsUsed: string[];
+    }>;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): {
+        provider: string;
+        model: string;
+    };
+}
+//# sourceMappingURL=planAgent.d.ts.map

package/dist/services/ai/agents/planAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planAgent.d.ts","sourceRoot":"","sources":["../../../../src/services/ai/agents/planAgent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAK1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,iGAAiG;IACjG,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uFAAuF;IACvF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAuDD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,KAAK,CAAU;gBAEX,MAAM,EAAE,SAAS;IAM7B;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAuGvE;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsDrE;;OAEG;YACW,6BAA6B;IAyF3C;;OAEG;YACW,mBAAmB;IAoGjC;;OAEG;IACG,sBAAsB,CAC1B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC;QACT,IAAI,EAAE,eAAe,CAAC;QACtB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IA4FF;;OAEG;IACH,SAAS,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAMjD"}