@weavelogic/knowledge-graph-agent 0.2.0 → 0.4.0

package/dist/agents/tester-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tester-agent.js","sources":["../../src/agents/tester-agent.ts"],"sourcesContent":["/**\n * Tester Agent\n *\n * Specialized agent for test generation, coverage analysis, and test improvement.\n * Extends BaseAgent with support for vitest/jest testing frameworks.\n *\n * @module agents/tester-agent\n */\n\nimport * as path from 'path';\nimport { BaseAgent } from './base-agent.js';\nimport {\n  AgentType,\n  type AgentTask,\n  type AgentResult,\n  type TesterAgentConfig,\n  type ResultArtifact,\n} from './types.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Test framework type\n */\nexport type TestFramework = 'vitest' | 'jest';\n\n/**\n * Test type\n */\nexport type TestType = 'unit' | 'integration' | 'e2e' | 'snapshot';\n\n/**\n * Test generation request\n */\nexport interface TestGenerationRequest {\n  /** Source code to test */\n  sourceCode: string;\n  /** Source file path */\n  sourcePath: string;\n  /** Target test framework */\n  framework: TestFramework;\n  /** Types of tests to generate */\n  testTypes?: TestType[];\n  /** Include edge cases */\n  includeEdgeCases?: boolean;\n  /** Include error scenarios */\n  includeErrorCases?: boolean;\n  /** Coverage target percentage */\n  coverageTarget?: number;\n}\n\n/**\n * Generated test suite\n */\nexport interface GeneratedTestSuite {\n  /** Test file content */\n  code: string;\n  /** Test file path */\n  path: string;\n  /** Number of test cases */\n  testCount: number;\n  /** Estimated coverage */\n  estimatedCoverage: number;\n  /** Test categories */\n  categories: string[];\n  /** Import statements */\n  imports: string[];\n}\n\n/**\n * Test case definition\n */\nexport interface TestCase {\n  /** Test name/description */\n  name: string;\n  /** Test type */\n  type: TestType;\n  /** Test category */\n  category: string;\n  /** Test code */\n  code: string;\n  /** Setup required */\n  setup?: string;\n  /** Assertions */\n  assertions: string[];\n}\n\n/**\n * Coverage metrics\n */\nexport interface CoverageMetrics {\n  /** Line coverage percentage */\n  lines: number;\n  /** Branch coverage percentage */\n  branches: number;\n  /** Function coverage percentage */\n  functions: number;\n  /** Statement coverage percentage */\n  statements: number;\n  /** Uncovered lines */\n  uncoveredLines: number[];\n  /** Uncovered functions */\n  uncoveredFunctions: string[];\n}\n\n/**\n * Coverage analysis result\n */\nexport interface CoverageAnalysis {\n  /** Source file */\n  sourceFile: string;\n  /** Test file */\n  testFile?: string;\n  /** Coverage metrics */\n  metrics: CoverageMetrics;\n  /** Coverage gaps */\n  gaps: CoverageGap[];\n  /** Recommendations */\n  recommendations: string[];\n}\n\n/**\n * Coverage gap identification\n */\nexport interface CoverageGap {\n  /** Type of gap */\n  type: 'function' | 'branch' | 'line' | 'edge-case';\n  /** Location in source */\n  location: { start: number; end: number };\n  /** Description of what's not covered */\n  description: string;\n  /** Priority (1-10) */\n  priority: number;\n  /** Suggested test to add */\n  suggestedTest?: string;\n}\n\n/**\n * Test suggestion\n */\nexport interface TestSuggestion {\n  /** Suggestion type */\n  type: 'add' | 'improve' | 'remove' | 'refactor';\n  /** Target test or function */\n  target: string;\n  /** Description */\n  description: string;\n  /** Priority (1-10) */\n  priority: number;\n  /** Sample code */\n  sampleCode?: string;\n}\n\n/**\n * Tester task type\n */\nexport type TesterTaskType = 'generate' | 'coverage' | 'suggest' | 'analyze';\n\n// ============================================================================\n// Tester Agent\n// ============================================================================\n\n/**\n * Tester Agent\n *\n * Capabilities:\n * - Test generation from source code\n * - Coverage analysis and gap detection\n * - Test improvement suggestions\n * - Support for vitest and jest\n *\n * @example\n * ```typescript\n * const tester = new TesterAgent({\n *   name: 'tester-agent',\n *   type: AgentType.TESTER,\n *   testFramework: 'vitest',\n * });\n *\n * const result = await tester.execute({\n *   id: 'task-1',\n *   description: 'Generate tests for UserService',\n *   priority: TaskPriority.MEDIUM,\n *   input: {\n *     data: {\n *       sourceCode: '...',\n *       sourcePath: 'src/user-service.ts',\n *       framework: 'vitest',\n *       includeEdgeCases: true\n *     }\n *   },\n *   createdAt: new Date()\n * });\n * ```\n */\nexport class TesterAgent extends BaseAgent {\n  constructor(config: Partial<TesterAgentConfig> & { name: string }) {\n    super({\n      type: AgentType.TESTER,\n      taskTimeout: 180000, // 3 minutes\n      capabilities: ['test-generation', 'coverage-analysis'],\n      ...config,\n    });\n  }\n\n  // ==========================================================================\n  // Task Execution\n  // ==========================================================================\n\n  /**\n   * Execute tester task\n   */\n  protected async executeTask(task: AgentTask): Promise<AgentResult> {\n    const startTime = new Date();\n    const taskType = (task.input?.parameters?.taskType as TesterTaskType) || 'generate';\n\n    switch (taskType) {\n      case 'generate':\n        return this.handleGenerateTask(task, startTime);\n      case 'coverage':\n        return this.handleCoverageTask(task, startTime);\n      case 'suggest':\n        return this.handleSuggestTask(task, startTime);\n      case 'analyze':\n        return this.handleAnalyzeTask(task, startTime);\n      default:\n        return this.createErrorResult(\n          'INVALID_TASK_TYPE',\n          `Unknown task type: ${taskType}`,\n          startTime\n        );\n    }\n  }\n\n  // ==========================================================================\n  // Public Methods\n  // ==========================================================================\n\n  /**\n   * Generate tests from source code\n   */\n  async generateTests(request: TestGenerationRequest): Promise<GeneratedTestSuite> {\n    this.logger.info('Generating tests', {\n      file: request.sourcePath,\n      framework: request.framework,\n    });\n\n    const analysis = this.analyzeSourceCode(request.sourceCode);\n    const testCases: TestCase[] = [];\n\n    for (const func of analysis.functions) {\n      testCases.push(...this.generateFunctionTests(func, request));\n    }\n\n    for (const cls of analysis.classes) {\n      testCases.push(...this.generateClassTests(cls, request));\n    }\n\n    if (request.includeEdgeCases) {\n      testCases.push(...this.generateEdgeCaseTests(analysis, request));\n    }\n\n    if (request.includeErrorCases) {\n      testCases.push(...this.generateErrorCaseTests(analysis, request));\n    }\n\n    return this.buildTestSuite(testCases, request);\n  }\n\n  /**\n   * Analyze test coverage\n   */\n  async analyzeTestCoverage(\n    sourceCode: string,\n    sourcePath: string,\n    testCode?: string\n  ): Promise<CoverageAnalysis> {\n    this.logger.info('Analyzing test coverage', { file: sourcePath });\n\n    const analysis = this.analyzeSourceCode(sourceCode);\n    const gaps: CoverageGap[] = [];\n    const recommendations: string[] = [];\n\n    let testedFunctions = 0;\n    let testedBranches = 0;\n    let testedLines = 0;\n\n    if (testCode) {\n      for (const func of analysis.functions) {\n        if (testCode.includes(func.name) || testCode.includes(`'${func.name}'`)) {\n          testedFunctions++;\n        } else {\n          gaps.push({\n            type: 'function',\n            location: { start: func.line, end: func.line },\n            description: `Function '${func.name}' is not tested`,\n            priority: 8,\n            suggestedTest: this.generateTestStub(func.name, 'function'),\n          });\n        }\n      }\n\n      for (const branch of analysis.branches) {\n        if (testCode.includes(branch.condition)) {\n          testedBranches++;\n        } else {\n          gaps.push({\n            type: 'branch',\n            location: { start: branch.line, end: branch.line },\n            description: `Branch '${branch.type}' at line ${branch.line} needs testing`,\n            priority: 6,\n          });\n        }\n      }\n\n      testedLines = Math.min(\n        analysis.lines,\n        Math.round((testedFunctions / Math.max(1, analysis.functions.length)) * analysis.lines)\n      );\n    } else {\n      for (const func of analysis.functions) {\n        gaps.push({\n          type: 'function',\n          location: { start: func.line, end: func.line },\n          description: `Function '${func.name}' is not tested`,\n          priority: 8,\n          suggestedTest: this.generateTestStub(func.name, 'function'),\n        });\n      }\n      recommendations.push('Create a test file for this source file');\n    }\n\n    const metrics: CoverageMetrics = {\n      lines: analysis.lines > 0 ? Math.round((testedLines / analysis.lines) * 100) : 0,\n      branches: analysis.branches.length > 0\n        ? Math.round((testedBranches / analysis.branches.length) * 100)\n        : 100,\n      functions: analysis.functions.length > 0\n        ? Math.round((testedFunctions / analysis.functions.length) * 100)\n        : 100,\n      statements: analysis.lines > 0 ? Math.round((testedLines / analysis.lines) * 100) : 0,\n      uncoveredLines: [],\n      uncoveredFunctions: analysis.functions\n        .filter(f => !testCode?.includes(f.name))\n        .map(f => f.name),\n    };\n\n    if (metrics.functions < 80) {\n      recommendations.push(\n        `Increase function coverage from ${metrics.functions}% to at least 80%`\n      );\n    }\n    if (metrics.branches < 70) {\n      recommendations.push(\n        `Improve branch coverage from ${metrics.branches}% to at least 70%`\n      );\n    }\n    if (gaps.length > 0) {\n      recommendations.push(\n        `Address ${gaps.length} coverage gap(s) identified`\n      );\n    }\n\n    return {\n      sourceFile: sourcePath,\n      testFile: testCode ? sourcePath.replace(/\\.ts$/, '.test.ts') : undefined,\n      metrics,\n      gaps: gaps.sort((a, b) => b.priority - a.priority),\n      recommendations,\n    };\n  }\n\n  /**\n   * Suggest test improvements\n   */\n  async suggestTestCases(\n    sourceCode: string,\n    testCode: string,\n    sourcePath: string\n  ): Promise<TestSuggestion[]> {\n    this.logger.info('Analyzing tests for improvements', { file: sourcePath });\n\n    const suggestions: TestSuggestion[] = [];\n    const sourceAnalysis = this.analyzeSourceCode(sourceCode);\n    const testAnalysis = this.analyzeTestCode(testCode);\n\n    for (const func of sourceAnalysis.functions) {\n      const hasTest = testAnalysis.testedItems.includes(func.name);\n      if (!hasTest) {\n        suggestions.push({\n          type: 'add',\n          target: func.name,\n          description: `Add tests for function '${func.name}'`,\n          priority: 8,\n          sampleCode: this.generateTestStub(func.name, 'function'),\n        });\n      }\n    }\n\n    for (const func of sourceAnalysis.functions) {\n      const hasEdgeTests = testAnalysis.edgeCases.some(\n        ec => ec.includes(func.name)\n      );\n      if (!hasEdgeTests && func.hasParameters) {\n        suggestions.push({\n          type: 'add',\n          target: func.name,\n          description: `Add edge case tests for '${func.name}' (null, undefined, empty values)`,\n          priority: 6,\n          sampleCode: this.generateEdgeCaseStub(func.name),\n        });\n      }\n    }\n\n    for (const func of sourceAnalysis.functions) {\n      const hasErrorTests = testAnalysis.errorTests.some(\n        et => et.includes(func.name)\n      );\n      if (!hasErrorTests && func.hasErrorHandling) {\n        suggestions.push({\n          type: 'add',\n          target: func.name,\n          description: `Add error handling tests for '${func.name}'`,\n          priority: 7,\n          sampleCode: this.generateErrorTestStub(func.name),\n        });\n      }\n    }\n\n    for (const test of testAnalysis.tests) {\n      if (test.assertions === 0) {\n        suggestions.push({\n          type: 'improve',\n          target: test.name,\n          description: `Test '${test.name}' has no assertions`,\n          priority: 9,\n        });\n      }\n      if (test.assertions === 1) {\n        suggestions.push({\n          type: 'improve',\n          target: test.name,\n          description: `Consider adding more assertions to '${test.name}'`,\n          priority: 4,\n        });\n      }\n    }\n\n    const testNames = testAnalysis.tests.map(t => t.name);\n    const duplicates = testNames.filter(\n      (name, index) => testNames.indexOf(name) !== index\n    );\n    for (const dup of [...new Set(duplicates)]) {\n      suggestions.push({\n        type: 'remove',\n        target: dup,\n        description: `Remove duplicate test '${dup}'`,\n        priority: 5,\n      });\n    }\n\n    return suggestions.sort((a, b) => b.priority - a.priority);\n  }\n\n  // ==========================================================================\n  // Private Task Handlers\n  // ==========================================================================\n\n  private async handleGenerateTask(\n    task: AgentTask,\n    startTime: Date\n  ): Promise<AgentResult<GeneratedTestSuite>> {\n    const request = task.input?.data as TestGenerationRequest | undefined;\n\n    if (!request?.sourceCode) {\n      return this.createErrorResult(\n        'VALIDATION_ERROR',\n        'Test generation request with source code is required',\n        startTime\n      ) as AgentResult<GeneratedTestSuite>;\n    }\n\n    try {\n      const suite = await this.generateTests(request);\n      const artifacts: ResultArtifact[] = [{\n        type: 'code',\n        name: path.basename(suite.path),\n        content: suite.code,\n        mimeType: 'text/typescript',\n      }];\n\n      return this.createSuccessResult(suite, startTime, artifacts);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return this.createErrorResult('GENERATION_ERROR', `Test generation failed: ${message}`, startTime) as AgentResult<GeneratedTestSuite>;\n    }\n  }\n\n  private async handleCoverageTask(\n    task: AgentTask,\n    startTime: Date\n  ): Promise<AgentResult<CoverageAnalysis>> {\n    const input = task.input?.data as {\n      sourceCode: string;\n      sourcePath: string;\n      testCode?: string;\n    } | undefined;\n\n    if (!input?.sourceCode) {\n      return this.createErrorResult(\n        'VALIDATION_ERROR',\n        'Source code and path are required for coverage analysis',\n        startTime\n      ) as AgentResult<CoverageAnalysis>;\n    }\n\n    try {\n      const analysis = await this.analyzeTestCoverage(\n        input.sourceCode,\n        input.sourcePath,\n        input.testCode\n      );\n      return this.createSuccessResult(analysis, startTime);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return this.createErrorResult('COVERAGE_ERROR', `Coverage analysis failed: ${message}`, startTime) as AgentResult<CoverageAnalysis>;\n    }\n  }\n\n  private async handleSuggestTask(\n    task: AgentTask,\n    startTime: Date\n  ): Promise<AgentResult<TestSuggestion[]>> {\n    const input = task.input?.data as {\n      sourceCode: string;\n      testCode: string;\n      sourcePath: string;\n    } | undefined;\n\n    if (!input?.sourceCode || !input?.testCode) {\n      return this.createErrorResult(\n        'VALIDATION_ERROR',\n        'Source code and test code are required',\n        startTime\n      ) as AgentResult<TestSuggestion[]>;\n    }\n\n    try {\n      const suggestions = await this.suggestTestCases(\n        input.sourceCode,\n        input.testCode,\n        input.sourcePath\n      );\n      return this.createSuccessResult(suggestions, startTime);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return this.createErrorResult('SUGGESTION_ERROR', `Test suggestion failed: ${message}`, startTime) as AgentResult<TestSuggestion[]>;\n    }\n  }\n\n  private async handleAnalyzeTask(\n    task: AgentTask,\n    startTime: Date\n  ): Promise<AgentResult<{ coverage: CoverageAnalysis; suggestions: TestSuggestion[] }>> {\n    const input = task.input?.data as {\n      sourceCode: string;\n      sourcePath: string;\n      testCode?: string;\n    } | undefined;\n\n    if (!input?.sourceCode) {\n      return this.createErrorResult(\n        'VALIDATION_ERROR',\n        'Source code is required for analysis',\n        startTime\n      ) as AgentResult<{ coverage: CoverageAnalysis; suggestions: TestSuggestion[] }>;\n    }\n\n    try {\n      const coverage = await this.analyzeTestCoverage(\n        input.sourceCode,\n        input.sourcePath,\n        input.testCode\n      );\n\n      const suggestions = input.testCode\n        ? await this.suggestTestCases(input.sourceCode, input.testCode, input.sourcePath)\n        : [];\n\n      return this.createSuccessResult({ coverage, suggestions }, startTime);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return this.createErrorResult('ANALYSIS_ERROR', `Test analysis failed: ${message}`, startTime) as AgentResult<{ coverage: CoverageAnalysis; suggestions: TestSuggestion[] }>;\n    }\n  }\n\n  // ==========================================================================\n  // Source Code Analysis\n  // ==========================================================================\n\n  private analyzeSourceCode(code: string): {\n    functions: Array<{\n      name: string;\n      line: number;\n      params: string[];\n      hasParameters: boolean;\n      hasErrorHandling: boolean;\n      isAsync: boolean;\n    }>;\n    classes: Array<{\n      name: string;\n      line: number;\n      methods: string[];\n    }>;\n    branches: Array<{\n      type: 'if' | 'switch' | 'ternary';\n      line: number;\n      condition: string;\n    }>;\n    lines: number;\n  } {\n    const lines = code.split('\\n');\n    const functions: Array<{\n      name: string;\n      line: number;\n      params: string[];\n      hasParameters: boolean;\n      hasErrorHandling: boolean;\n      isAsync: boolean;\n    }> = [];\n    const classes: Array<{\n      name: string;\n      line: number;\n      methods: string[];\n    }> = [];\n    const branches: Array<{\n      type: 'if' | 'switch' | 'ternary';\n      line: number;\n      condition: string;\n    }> = [];\n\n    const funcRegex = /(?:export\\s+)?(?:async\\s+)?function\\s+(\\w+)\\s*\\(([^)]*)\\)/g;\n    const arrowRegex = /(?:export\\s+)?(?:const|let)\\s+(\\w+)\\s*=\\s*(?:async\\s+)?\\(([^)]*)\\)\\s*=>/g;\n    const methodRegex = /(?:async\\s+)?(\\w+)\\s*\\(([^)]*)\\)\\s*(?::\\s*[^{]+)?\\s*\\{/g;\n\n    let match;\n    while ((match = funcRegex.exec(code)) !== null) {\n      const lineNum = code.slice(0, match.index).split('\\n').length;\n      const params = match[2].split(',').map(p => p.trim()).filter(p => p);\n      const funcBody = this.extractFunctionBody(code, match.index);\n\n      functions.push({\n        name: match[1],\n        line: lineNum,\n        params,\n        hasParameters: params.length > 0,\n        hasErrorHandling: /try\\s*\\{/.test(funcBody),\n        isAsync: match[0].includes('async'),\n      });\n    }\n\n    while ((match = arrowRegex.exec(code)) !== null) {\n      const lineNum = code.slice(0, match.index).split('\\n').length;\n      const params = match[2].split(',').map(p => p.trim()).filter(p => p);\n      const funcBody = this.extractFunctionBody(code, match.index);\n\n      functions.push({\n        name: match[1],\n        line: lineNum,\n        params,\n        hasParameters: params.length > 0,\n        hasErrorHandling: /try\\s*\\{/.test(funcBody),\n        isAsync: match[0].includes('async'),\n      });\n    }\n\n    const classRegex = /(?:export\\s+)?class\\s+(\\w+)/g;\n    while ((match = classRegex.exec(code)) !== null) {\n      const lineNum = code.slice(0, match.index).split('\\n').length;\n      const classBody = this.extractClassBody(code, match.index);\n      const methods: string[] = [];\n\n      let methodMatch;\n      while ((methodMatch = methodRegex.exec(classBody)) !== null) {\n        if (!['constructor', 'if', 'while', 'for', 'switch'].includes(methodMatch[1])) {\n          methods.push(methodMatch[1]);\n        }\n      }\n\n      classes.push({\n        name: match[1],\n        line: lineNum,\n        methods,\n      });\n    }\n\n    const ifRegex = /if\\s*\\(([^)]+)\\)/g;\n    while ((match = ifRegex.exec(code)) !== null) {\n      const lineNum = code.slice(0, match.index).split('\\n').length;\n      branches.push({\n        type: 'if',\n        line: lineNum,\n        condition: match[1],\n      });\n    }\n\n    const switchRegex = /switch\\s*\\(([^)]+)\\)/g;\n    while ((match = switchRegex.exec(code)) !== null) {\n      const lineNum = code.slice(0, match.index).split('\\n').length;\n      branches.push({\n        type: 'switch',\n        line: lineNum,\n        condition: match[1],\n      });\n    }\n\n    return {\n      functions,\n      classes,\n      branches,\n      lines: lines.filter(l => l.trim().length > 0).length,\n    };\n  }\n\n  private analyzeTestCode(code: string): {\n    tests: Array<{ name: string; assertions: number }>;\n    testedItems: string[];\n    edgeCases: string[];\n    errorTests: string[];\n  } {\n    const tests: Array<{ name: string; assertions: number }> = [];\n    const testedItems: string[] = [];\n    const edgeCases: string[] = [];\n    const errorTests: string[] = [];\n\n    const testRegex = /(?:it|test)\\s*\\(\\s*['\"`]([^'\"`]+)['\"`]/g;\n    let match;\n\n    while ((match = testRegex.exec(code)) !== null) {\n      const testName = match[1];\n      const testBody = this.extractTestBody(code, match.index);\n      const assertions = (testBody.match(/expect\\s*\\(/g) || []).length;\n\n      tests.push({ name: testName, assertions });\n\n      const identifiers = testBody.match(/\\b[a-zA-Z_]\\w*\\b/g) || [];\n      testedItems.push(...identifiers);\n\n      if (\n        testName.toLowerCase().includes('edge') ||\n        testName.toLowerCase().includes('empty') ||\n        testName.toLowerCase().includes('null') ||\n        testName.toLowerCase().includes('undefined') ||\n        testBody.includes('null') ||\n        testBody.includes('undefined') ||\n        testBody.includes('[]') ||\n        testBody.includes(\"''\")\n      ) {\n        edgeCases.push(testName);\n      }\n\n      if (\n        testName.toLowerCase().includes('error') ||\n        testName.toLowerCase().includes('throw') ||\n        testName.toLowerCase().includes('fail') ||\n        testBody.includes('toThrow') ||\n        testBody.includes('rejects')\n      ) {\n        errorTests.push(testName);\n      }\n    }\n\n    return {\n      tests,\n      testedItems: [...new Set(testedItems)],\n      edgeCases,\n      errorTests,\n    };\n  }\n\n  // ==========================================================================\n  // Test Generation Methods\n  // ==========================================================================\n\n  private generateFunctionTests(\n    func: { name: string; params: string[]; isAsync: boolean; hasErrorHandling: boolean },\n    request: TestGenerationRequest\n  ): TestCase[] {\n    const testCases: TestCase[] = [];\n\n    testCases.push({\n      name: `should execute ${func.name} successfully`,\n      type: 'unit',\n      category: 'happy-path',\n      code: this.generateHappyPathTest(func),\n      assertions: ['expect(result).toBeDefined()'],\n    });\n\n    if (func.params.length > 0) {\n      for (const param of func.params) {\n        testCases.push({\n          name: `should handle ${param} parameter correctly`,\n          type: 'unit',\n          category: 'parameter-validation',\n          code: this.generateParamTest(func.name, param),\n          assertions: [`expect result for ${param}`],\n        });\n      }\n    }\n\n    return testCases;\n  }\n\n  private generateClassTests(\n    cls: { name: string; methods: string[] },\n    request: TestGenerationRequest\n  ): TestCase[] {\n    const testCases: TestCase[] = [];\n\n    testCases.push({\n      name: `should create ${cls.name} instance`,\n      type: 'unit',\n      category: 'instantiation',\n      code: `    const instance = new ${cls.name}();\\n    expect(instance).toBeInstanceOf(${cls.name});`,\n      setup: `let instance: ${cls.name};`,\n      assertions: [`expect(instance).toBeInstanceOf(${cls.name})`],\n    });\n\n    for (const method of cls.methods) {\n      testCases.push({\n        name: `should call ${method} method`,\n        type: 'unit',\n        category: 'method',\n        code: this.generateMethodTest(cls.name, method),\n        assertions: [`expect(result).toBeDefined()`],\n      });\n    }\n\n    return testCases;\n  }\n\n  private generateEdgeCaseTests(\n    analysis: ReturnType<typeof this.analyzeSourceCode>,\n    request: TestGenerationRequest\n  ): TestCase[] {\n    const testCases: TestCase[] = [];\n\n    for (const func of analysis.functions) {\n      if (func.hasParameters) {\n        testCases.push({\n          name: `should handle null input for ${func.name}`,\n          type: 'unit',\n          category: 'edge-case',\n          code: this.generateNullTest(func.name),\n          assertions: ['expect behavior with null'],\n        });\n\n        testCases.push({\n          name: `should handle empty input for ${func.name}`,\n          type: 'unit',\n          category: 'edge-case',\n          code: this.generateEmptyTest(func.name),\n          assertions: ['expect behavior with empty'],\n        });\n      }\n    }\n\n    return testCases;\n  }\n\n  private generateErrorCaseTests(\n    analysis: ReturnType<typeof this.analyzeSourceCode>,\n    request: TestGenerationRequest\n  ): TestCase[] {\n    const testCases: TestCase[] = [];\n\n    for (const func of analysis.functions) {\n      if (func.hasErrorHandling) {\n        testCases.push({\n          name: `should handle errors in ${func.name}`,\n          type: 'unit',\n          category: 'error-handling',\n          code: this.generateErrorTest(func.name, func.isAsync),\n          assertions: ['expect error handling'],\n        });\n      }\n    }\n\n    return testCases;\n  }\n\n  // ==========================================================================\n  // Test Code Generation Helpers\n  // ==========================================================================\n\n  private generateHappyPathTest(\n    func: { name: string; isAsync: boolean }\n  ): string {\n    if (func.isAsync) {\n      return `    const result = await ${func.name}();\\n    expect(result).toBeDefined();`;\n    }\n    return `    const result = ${func.name}();\\n    expect(result).toBeDefined();`;\n  }\n\n  private generateParamTest(funcName: string, param: string): string {\n    return `    const testValue = 'test-${param}';\\n    const result = ${funcName}(testValue);\\n    expect(result).toBeDefined();`;\n  }\n\n  private generateMethodTest(className: string, method: string): string {\n    return `    const instance = new ${className}();\\n    const result = instance.${method}();\\n    expect(result).toBeDefined();`;\n  }\n\n  private generateNullTest(funcName: string): string {\n    return `    expect(() => ${funcName}(null)).not.toThrow();`;\n  }\n\n  private generateEmptyTest(funcName: string): string {\n    return `    const result = ${funcName}('');\\n    expect(result).toBeDefined();`;\n  }\n\n  private generateErrorTest(funcName: string, isAsync: boolean): string {\n    if (isAsync) {\n      return `    await expect(${funcName}(invalidInput)).rejects.toThrow();`;\n    }\n    return `    expect(() => ${funcName}(invalidInput)).toThrow();`;\n  }\n\n  private generateTestStub(name: string, type: 'function' | 'class'): string {\n    if (type === 'function') {\n      return `  it('should test ${name}', () => {\\n    const result = ${name}();\\n    expect(result).toBeDefined();\\n  });`;\n    }\n    return `  it('should create ${name} instance', () => {\\n    const instance = new ${name}();\\n    expect(instance).toBeInstanceOf(${name});\\n  });`;\n  }\n\n  private generateEdgeCaseStub(funcName: string): string {\n    return `  it('should handle edge cases for ${funcName}', () => {\\n    expect(${funcName}(null)).toBeDefined();\\n    expect(${funcName}(undefined)).toBeDefined();\\n    expect(${funcName}('')).toBeDefined();\\n  });`;\n  }\n\n  private generateErrorTestStub(funcName: string): string {\n    return `  it('should handle errors in ${funcName}', () => {\\n    expect(() => ${funcName}(invalidInput)).toThrow();\\n  });`;\n  }\n\n  // ==========================================================================\n  // Test Suite Building\n  // ==========================================================================\n\n  private buildTestSuite(\n    testCases: TestCase[],\n    request: TestGenerationRequest\n  ): GeneratedTestSuite {\n    const isVitest = request.framework === 'vitest';\n    const moduleName = path.basename(request.sourcePath, path.extname(request.sourcePath));\n    const imports = this.buildImports(request, moduleName);\n\n    let code = '';\n    code += imports.join('\\n') + '\\n\\n';\n\n    const byCategory = new Map<string, TestCase[]>();\n    for (const test of testCases) {\n      if (!byCategory.has(test.category)) {\n        byCategory.set(test.category, []);\n      }\n      byCategory.get(test.category)!.push(test);\n    }\n\n    code += `describe('${moduleName}', () => {\\n`;\n\n    for (const [category, tests] of byCategory) {\n      code += `  describe('${category}', () => {\\n`;\n\n      for (const test of tests) {\n        if (test.setup) {\n          code += `    ${test.setup}\\n\\n`;\n        }\n\n        code += `    it('${test.name}', ${test.code.includes('await') ? 'async ' : ''}() => {\\n`;\n        code += test.code.split('\\n').map(l => `  ${l}`).join('\\n') + '\\n';\n        code += `    });\\n\\n`;\n      }\n\n      code += `  });\\n\\n`;\n    }\n\n    code += '});\\n';\n\n    const estimatedCoverage = Math.min(\n      100,\n      Math.round((testCases.length / Math.max(1, testCases.length)) * 80)\n    );\n\n    return {\n      code,\n      path: request.sourcePath.replace(/\\.(ts|tsx|js|jsx)$/, `.test.$1`),\n      testCount: testCases.length,\n      estimatedCoverage,\n      categories: [...byCategory.keys()],\n      imports,\n    };\n  }\n\n  private buildImports(request: TestGenerationRequest, moduleName: string): string[] {\n    const imports: string[] = [];\n    const isVitest = request.framework === 'vitest';\n\n    if (isVitest) {\n      imports.push(\"import { describe, it, expect, beforeEach, afterEach } from 'vitest';\");\n    } else {\n      imports.push(\"import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';\");\n    }\n\n    imports.push(`import { /* exports */ } from './${moduleName}';`);\n\n    return imports;\n  }\n\n  // ==========================================================================\n  // Utility Methods\n  // ==========================================================================\n\n  private extractFunctionBody(code: string, startIndex: number): string {\n    let braceCount = 0;\n    let inBody = false;\n    let bodyStart = startIndex;\n    let bodyEnd = startIndex;\n\n    for (let i = startIndex; i < code.length; i++) {\n      if (code[i] === '{') {\n        if (!inBody) {\n          bodyStart = i;\n          inBody = true;\n        }\n        braceCount++;\n      } else if (code[i] === '}') {\n        braceCount--;\n        if (inBody && braceCount === 0) {\n          bodyEnd = i + 1;\n          break;\n        }\n      }\n    }\n\n    return code.slice(bodyStart, bodyEnd);\n  }\n\n  private extractClassBody(code: string, startIndex: number): string {\n    return this.extractFunctionBody(code, startIndex);\n  }\n\n  private extractTestBody(code: string, startIndex: number): string {\n    let parenCount = 0;\n    let inTest = false;\n    let bodyStart = startIndex;\n\n    for (let i = startIndex; i < code.length; i++) {\n      if (code[i] === '(') {\n        parenCount++;\n        inTest = true;\n      } else if (code[i] === ')') {\n        parenCount--;\n        if (inTest && parenCount === 0) {\n          return code.slice(bodyStart, i + 1);\n        }\n      }\n    }\n\n    return code.slice(bodyStart, Math.min(bodyStart + 500, code.length));\n  }\n}\n\n"],"names":[],"mappings":"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"}

package/dist/agents/types.d.ts

@@ -0,0 +1,425 @@
+/**
+ * Agent System Types
+ *
+ * Core type definitions for the agent system including agent types,
+ * statuses, configurations, tasks, and message formats.
+ *
+ * @module agents/types
+ */
+/**
+ * Agent specialization types
+ *
+ * Each type represents a specific role in the multi-agent system.
+ */
+export declare enum AgentType {
+    /** Research agent - gathers information and analyzes requirements */
+    RESEARCHER = "researcher",
+    /** Coder agent - implements features and writes code */
+    CODER = "coder",
+    /** Tester agent - writes and runs tests */
+    TESTER = "tester",
+    /** Analyst agent - analyzes data and patterns */
+    ANALYST = "analyst",
+    /** Architect agent - designs system architecture */
+    ARCHITECT = "architect",
+    /** Reviewer agent - reviews code and provides feedback */
+    REVIEWER = "reviewer",
+    /** Coordinator agent - orchestrates multi-agent workflows */
+    COORDINATOR = "coordinator",
+    /** Optimizer agent - optimizes performance and resources */
+    OPTIMIZER = "optimizer",
+    /** Documenter agent - generates documentation */
+    DOCUMENTER = "documenter",
+    /** Custom agent - user-defined specialization */
+    CUSTOM = "custom"
+}
+/**
+ * Agent execution status
+ */
+export declare enum AgentStatus {
+    /** Agent is idle and ready to accept tasks */
+    IDLE = "idle",
+    /** Agent is currently executing a task */
+    RUNNING = "running",
+    /** Agent has completed its task successfully */
+    COMPLETED = "completed",
+    /** Agent has failed to complete its task */
+    FAILED = "failed",
+    /** Agent is paused and can be resumed */
+    PAUSED = "paused",
+    /** Agent has been terminated */
+    TERMINATED = "terminated"
+}
+/**
+ * Task priority levels
+ */
+export declare enum TaskPriority {
+    LOW = "low",
+    MEDIUM = "medium",
+    HIGH = "high",
+    CRITICAL = "critical"
+}
+/**
+ * Message types for agent communication
+ */
+export declare enum MessageType {
+    /** Request for agent to perform an action */
+    REQUEST = "request",
+    /** Response to a request */
+    RESPONSE = "response",
+    /** Notification/event broadcast */
+    NOTIFICATION = "notification",
+    /** Error message */
+    ERROR = "error",
+    /** Status update */
+    STATUS = "status",
+    /** Coordination message between agents */
+    COORDINATION = "coordination"
+}
+/**
+ * Base agent configuration interface
+ */
+export interface AgentConfig {
+    /** Unique agent identifier */
+    id?: string;
+    /** Agent display name */
+    name: string;
+    /** Agent type/specialization */
+    type: AgentType;
+    /** Agent description */
+    description?: string;
+    /** Agent capabilities */
+    capabilities?: string[];
+    /** Maximum concurrent tasks */
+    maxConcurrentTasks?: number;
+    /** Task timeout in milliseconds */
+    taskTimeout?: number;
+    /** Retry configuration */
+    retry?: {
+        maxRetries: number;
+        backoffMs: number;
+        backoffMultiplier?: number;
+    };
+    /** Claude-flow integration settings */
+    claudeFlow?: {
+        enabled: boolean;
+        namespace?: string;
+        hooks?: {
+            preTask?: boolean;
+            postTask?: boolean;
+            postEdit?: boolean;
+        };
+    };
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Extended configuration for specific agent types
+ */
+export interface ResearcherAgentConfig extends AgentConfig {
+    type: AgentType.RESEARCHER;
+    searchDepth?: number;
+    sources?: string[];
+}
+export interface CoderAgentConfig extends AgentConfig {
+    type: AgentType.CODER;
+    language?: string;
+    framework?: string;
+    codeStyle?: string;
+}
+export interface TesterAgentConfig extends AgentConfig {
+    type: AgentType.TESTER;
+    testFramework?: string;
+    coverageThreshold?: number;
+}
+export interface AnalystAgentConfig extends AgentConfig {
+    type: AgentType.ANALYST;
+    analysisType?: 'code' | 'data' | 'performance' | 'security';
+}
+export interface ArchitectAgentConfig extends AgentConfig {
+    type: AgentType.ARCHITECT;
+    patterns?: string[];
+    constraints?: string[];
+}
+/**
+ * Union type for all agent configurations
+ */
+export type SpecializedAgentConfig = ResearcherAgentConfig | CoderAgentConfig | TesterAgentConfig | AnalystAgentConfig | ArchitectAgentConfig | AgentConfig;
+/**
+ * Task input definition
+ */
+export interface TaskInput {
+    /** Input data */
+    data?: unknown;
+    /** Input files/paths */
+    files?: string[];
+    /** Context from previous tasks */
+    context?: Record<string, unknown>;
+    /** Parameters for the task */
+    parameters?: Record<string, unknown>;
+}
+/**
+ * Task definition for agents
+ */
+export interface AgentTask {
+    /** Unique task identifier */
+    id: string;
+    /** Human-readable task description */
+    description: string;
+    /** Task priority */
+    priority: TaskPriority;
+    /** Task input data */
+    input: TaskInput;
+    /** Expected output format */
+    expectedOutput?: {
+        type: 'file' | 'data' | 'message' | 'action';
+        schema?: Record<string, unknown>;
+    };
+    /** Task dependencies (IDs of tasks that must complete first) */
+    dependencies?: string[];
+    /** Task timeout in milliseconds */
+    timeout?: number;
+    /** Task metadata */
+    metadata?: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Deadline timestamp */
+    deadline?: Date;
+}
+/**
+ * Standard result format for agent operations
+ */
+export interface AgentResult<T = unknown> {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Result data */
+    data?: T;
+    /** Error if operation failed */
+    error?: AgentError;
+    /** Execution metrics */
+    metrics?: ExecutionMetrics;
+    /** Output artifacts (files, logs, etc.) */
+    artifacts?: ResultArtifact[];
+    /** Result metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Agent error structure
+ */
+export interface AgentError {
+    /** Error code */
+    code: string;
+    /** Human-readable message */
+    message: string;
+    /** Additional error details */
+    details?: Record<string, unknown>;
+    /** Stack trace if available */
+    stack?: string;
+    /** Whether the error is retryable */
+    retryable?: boolean;
+}
+/**
+ * Execution metrics for tracking performance
+ */
+export interface ExecutionMetrics {
+    /** Start time */
+    startTime: Date;
+    /** End time */
+    endTime: Date;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Memory usage in bytes */
+    memoryUsage?: number;
+    /** Number of retries */
+    retries?: number;
+    /** Token usage (for LLM operations) */
+    tokenUsage?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+}
+/**
+ * Result artifact (file, log, etc.)
+ */
+export interface ResultArtifact {
+    /** Artifact type */
+    type: 'file' | 'log' | 'report' | 'code' | 'data';
+    /** Artifact name */
+    name: string;
+    /** Artifact path or content */
+    content: string;
+    /** MIME type */
+    mimeType?: string;
+    /** Artifact metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Base message interface for agent communication
+ */
+export interface AgentMessage {
+    /** Message ID */
+    id: string;
+    /** Message type */
+    type: MessageType;
+    /** Sender agent ID */
+    from: string;
+    /** Recipient agent ID (or 'broadcast' for all) */
+    to: string;
+    /** Message timestamp */
+    timestamp: Date;
+    /** Message payload */
+    payload: unknown;
+    /** Correlation ID for request/response matching */
+    correlationId?: string;
+    /** Message metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Request message for task delegation
+ */
+export interface TaskRequestMessage extends AgentMessage {
+    type: MessageType.REQUEST;
+    payload: {
+        task: AgentTask;
+        urgent?: boolean;
+    };
+}
+/**
+ * Response message for completed tasks
+ */
+export interface TaskResponseMessage extends AgentMessage {
+    type: MessageType.RESPONSE;
+    payload: {
+        taskId: string;
+        result: AgentResult;
+    };
+}
+/**
+ * Status update message
+ */
+export interface StatusMessage extends AgentMessage {
+    type: MessageType.STATUS;
+    payload: {
+        agentId: string;
+        status: AgentStatus;
+        currentTask?: string;
+        progress?: number;
+    };
+}
+/**
+ * Error message
+ */
+export interface ErrorMessage extends AgentMessage {
+    type: MessageType.ERROR;
+    payload: {
+        error: AgentError;
+        taskId?: string;
+        recoverable?: boolean;
+    };
+}
+/**
+ * Coordination message for multi-agent workflows
+ */
+export interface CoordinationMessage extends AgentMessage {
+    type: MessageType.COORDINATION;
+    payload: {
+        action: 'sync' | 'handoff' | 'merge' | 'split' | 'barrier';
+        data: unknown;
+    };
+}
+/**
+ * Union type for all message types
+ */
+export type AgentMessageUnion = TaskRequestMessage | TaskResponseMessage | StatusMessage | ErrorMessage | CoordinationMessage;
+/**
+ * Agent runtime state
+ */
+export interface AgentState {
+    /** Agent ID */
+    id: string;
+    /** Current status */
+    status: AgentStatus;
+    /** Current task being executed */
+    currentTask?: AgentTask;
+    /** Queued tasks */
+    taskQueue: AgentTask[];
+    /** Completed task history */
+    completedTasks: string[];
+    /** Last activity timestamp */
+    lastActivity: Date;
+    /** Error count */
+    errorCount: number;
+    /** Custom state data */
+    custom?: Record<string, unknown>;
+}
+/**
+ * Agent factory function type
+ */
+export type AgentFactory<T extends AgentConfig = AgentConfig> = (config: T) => Promise<AgentInstance>;
+/**
+ * Agent instance interface
+ */
+export interface AgentInstance {
+    /** Agent configuration */
+    readonly config: AgentConfig;
+    /** Agent state */
+    readonly state: AgentState;
+    /** Execute a task */
+    execute(task: AgentTask): Promise<AgentResult>;
+    /** Pause the agent */
+    pause(): Promise<void>;
+    /** Resume the agent */
+    resume(): Promise<void>;
+    /** Terminate the agent */
+    terminate(): Promise<void>;
+    /** Get agent status */
+    getStatus(): AgentStatus;
+    /** Send a message to another agent */
+    sendMessage?(message: AgentMessage): Promise<void>;
+    /** Receive and process a message */
+    receiveMessage?(message: AgentMessage): Promise<void>;
+}
+/**
+ * Agent capability descriptor
+ */
+export interface AgentCapability {
+    /** Capability name */
+    name: string;
+    /** Capability description */
+    description: string;
+    /** Required for this agent type */
+    required?: boolean;
+    /** Capability version */
+    version?: string;
+}
+/**
+ * Agent health check result
+ */
+export interface AgentHealthCheck {
+    /** Agent ID */
+    agentId: string;
+    /** Health status */
+    healthy: boolean;
+    /** Status details */
+    status: AgentStatus;
+    /** Last heartbeat */
+    lastHeartbeat: Date;
+    /** Error message if unhealthy */
+    error?: string;
+    /** Metrics snapshot */
+    metrics?: Partial<ExecutionMetrics>;
+}
+/**
+ * Helper function to create a unique message ID
+ */
+export declare function createMessageId(): string;
+/**
+ * Helper function to create a unique task ID
+ */
+export declare function createTaskId(): string;
+/**
+ * Helper function to create a unique agent ID
+ */
+export declare function createAgentId(type: AgentType): string;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/agents/types.js

@@ -0,0 +1,57 @@
+var AgentType = /* @__PURE__ */ ((AgentType2) => {
+  AgentType2["RESEARCHER"] = "researcher";
+  AgentType2["CODER"] = "coder";
+  AgentType2["TESTER"] = "tester";
+  AgentType2["ANALYST"] = "analyst";
+  AgentType2["ARCHITECT"] = "architect";
+  AgentType2["REVIEWER"] = "reviewer";
+  AgentType2["COORDINATOR"] = "coordinator";
+  AgentType2["OPTIMIZER"] = "optimizer";
+  AgentType2["DOCUMENTER"] = "documenter";
+  AgentType2["CUSTOM"] = "custom";
+  return AgentType2;
+})(AgentType || {});
+var AgentStatus = /* @__PURE__ */ ((AgentStatus2) => {
+  AgentStatus2["IDLE"] = "idle";
+  AgentStatus2["RUNNING"] = "running";
+  AgentStatus2["COMPLETED"] = "completed";
+  AgentStatus2["FAILED"] = "failed";
+  AgentStatus2["PAUSED"] = "paused";
+  AgentStatus2["TERMINATED"] = "terminated";
+  return AgentStatus2;
+})(AgentStatus || {});
+var TaskPriority = /* @__PURE__ */ ((TaskPriority2) => {
+  TaskPriority2["LOW"] = "low";
+  TaskPriority2["MEDIUM"] = "medium";
+  TaskPriority2["HIGH"] = "high";
+  TaskPriority2["CRITICAL"] = "critical";
+  return TaskPriority2;
+})(TaskPriority || {});
+var MessageType = /* @__PURE__ */ ((MessageType2) => {
+  MessageType2["REQUEST"] = "request";
+  MessageType2["RESPONSE"] = "response";
+  MessageType2["NOTIFICATION"] = "notification";
+  MessageType2["ERROR"] = "error";
+  MessageType2["STATUS"] = "status";
+  MessageType2["COORDINATION"] = "coordination";
+  return MessageType2;
+})(MessageType || {});
+function createMessageId() {
+  return `msg_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+function createTaskId() {
+  return `task_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+function createAgentId(type) {
+  return `${type}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+export {
+  AgentStatus,
+  AgentType,
+  MessageType,
+  TaskPriority,
+  createAgentId,
+  createMessageId,
+  createTaskId
+};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../src/agents/types.ts"],"sourcesContent":["/**\n * Agent System Types\n *\n * Core type definitions for the agent system including agent types,\n * statuses, configurations, tasks, and message formats.\n *\n * @module agents/types\n */\n\n// ============================================================================\n// Agent Type Enumerations\n// ============================================================================\n\n/**\n * Agent specialization types\n *\n * Each type represents a specific role in the multi-agent system.\n */\nexport enum AgentType {\n  /** Research agent - gathers information and analyzes requirements */\n  RESEARCHER = 'researcher',\n\n  /** Coder agent - implements features and writes code */\n  CODER = 'coder',\n\n  /** Tester agent - writes and runs tests */\n  TESTER = 'tester',\n\n  /** Analyst agent - analyzes data and patterns */\n  ANALYST = 'analyst',\n\n  /** Architect agent - designs system architecture */\n  ARCHITECT = 'architect',\n\n  /** Reviewer agent - reviews code and provides feedback */\n  REVIEWER = 'reviewer',\n\n  /** Coordinator agent - orchestrates multi-agent workflows */\n  COORDINATOR = 'coordinator',\n\n  /** Optimizer agent - optimizes performance and resources */\n  OPTIMIZER = 'optimizer',\n\n  /** Documenter agent - generates documentation */\n  DOCUMENTER = 'documenter',\n\n  /** Custom agent - user-defined specialization */\n  CUSTOM = 'custom',\n}\n\n/**\n * Agent execution status\n */\nexport enum AgentStatus {\n  /** Agent is idle and ready to accept tasks */\n  IDLE = 'idle',\n\n  /** Agent is currently executing a task */\n  RUNNING = 'running',\n\n  /** Agent has completed its task successfully */\n  COMPLETED = 'completed',\n\n  /** Agent has failed to complete its task */\n  FAILED = 'failed',\n\n  /** Agent is paused and can be resumed */\n  PAUSED = 'paused',\n\n  /** Agent has been terminated */\n  TERMINATED = 'terminated',\n}\n\n/**\n * Task priority levels\n */\nexport enum TaskPriority {\n  LOW = 'low',\n  MEDIUM = 'medium',\n  HIGH = 'high',\n  CRITICAL = 'critical',\n}\n\n/**\n * Message types for agent communication\n */\nexport enum MessageType {\n  /** Request for agent to perform an action */\n  REQUEST = 'request',\n\n  /** Response to a request */\n  RESPONSE = 'response',\n\n  /** Notification/event broadcast */\n  NOTIFICATION = 'notification',\n\n  /** Error message */\n  ERROR = 'error',\n\n  /** Status update */\n  STATUS = 'status',\n\n  /** Coordination message between agents */\n  COORDINATION = 'coordination',\n}\n\n// ============================================================================\n// Agent Configuration\n// ============================================================================\n\n/**\n * Base agent configuration interface\n */\nexport interface AgentConfig {\n  /** Unique agent identifier */\n  id?: string;\n\n  /** Agent display name */\n  name: string;\n\n  /** Agent type/specialization */\n  type: AgentType;\n\n  /** Agent description */\n  description?: string;\n\n  /** Agent capabilities */\n  capabilities?: string[];\n\n  /** Maximum concurrent tasks */\n  maxConcurrentTasks?: number;\n\n  /** Task timeout in milliseconds */\n  taskTimeout?: number;\n\n  /** Retry configuration */\n  retry?: {\n    maxRetries: number;\n    backoffMs: number;\n    backoffMultiplier?: number;\n  };\n\n  /** Claude-flow integration settings */\n  claudeFlow?: {\n    enabled: boolean;\n    namespace?: string;\n    hooks?: {\n      preTask?: boolean;\n      postTask?: boolean;\n      postEdit?: boolean;\n    };\n  };\n\n  /** Custom metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Extended configuration for specific agent types\n */\nexport interface ResearcherAgentConfig extends AgentConfig {\n  type: AgentType.RESEARCHER;\n  searchDepth?: number;\n  sources?: string[];\n}\n\nexport interface CoderAgentConfig extends AgentConfig {\n  type: AgentType.CODER;\n  language?: string;\n  framework?: string;\n  codeStyle?: string;\n}\n\nexport interface TesterAgentConfig extends AgentConfig {\n  type: AgentType.TESTER;\n  testFramework?: string;\n  coverageThreshold?: number;\n}\n\nexport interface AnalystAgentConfig extends AgentConfig {\n  type: AgentType.ANALYST;\n  analysisType?: 'code' | 'data' | 'performance' | 'security';\n}\n\nexport interface ArchitectAgentConfig extends AgentConfig {\n  type: AgentType.ARCHITECT;\n  patterns?: string[];\n  constraints?: string[];\n}\n\n/**\n * Union type for all agent configurations\n */\nexport type SpecializedAgentConfig =\n  | ResearcherAgentConfig\n  | CoderAgentConfig\n  | TesterAgentConfig\n  | AnalystAgentConfig\n  | ArchitectAgentConfig\n  | AgentConfig;\n\n// ============================================================================\n// Agent Task Types\n// ============================================================================\n\n/**\n * Task input definition\n */\nexport interface TaskInput {\n  /** Input data */\n  data?: unknown;\n\n  /** Input files/paths */\n  files?: string[];\n\n  /** Context from previous tasks */\n  context?: Record<string, unknown>;\n\n  /** Parameters for the task */\n  parameters?: Record<string, unknown>;\n}\n\n/**\n * Task definition for agents\n */\nexport interface AgentTask {\n  /** Unique task identifier */\n  id: string;\n\n  /** Human-readable task description */\n  description: string;\n\n  /** Task priority */\n  priority: TaskPriority;\n\n  /** Task input data */\n  input: TaskInput;\n\n  /** Expected output format */\n  expectedOutput?: {\n    type: 'file' | 'data' | 'message' | 'action';\n    schema?: Record<string, unknown>;\n  };\n\n  /** Task dependencies (IDs of tasks that must complete first) */\n  dependencies?: string[];\n\n  /** Task timeout in milliseconds */\n  timeout?: number;\n\n  /** Task metadata */\n  metadata?: Record<string, unknown>;\n\n  /** Creation timestamp */\n  createdAt: Date;\n\n  /** Deadline timestamp */\n  deadline?: Date;\n}\n\n// ============================================================================\n// Agent Result Types\n// ============================================================================\n\n/**\n * Standard result format for agent operations\n */\nexport interface AgentResult<T = unknown> {\n  /** Whether the operation succeeded */\n  success: boolean;\n\n  /** Result data */\n  data?: T;\n\n  /** Error if operation failed */\n  error?: AgentError;\n\n  /** Execution metrics */\n  metrics?: ExecutionMetrics;\n\n  /** Output artifacts (files, logs, etc.) */\n  artifacts?: ResultArtifact[];\n\n  /** Result metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Agent error structure\n */\nexport interface AgentError {\n  /** Error code */\n  code: string;\n\n  /** Human-readable message */\n  message: string;\n\n  /** Additional error details */\n  details?: Record<string, unknown>;\n\n  /** Stack trace if available */\n  stack?: string;\n\n  /** Whether the error is retryable */\n  retryable?: boolean;\n}\n\n/**\n * Execution metrics for tracking performance\n */\nexport interface ExecutionMetrics {\n  /** Start time */\n  startTime: Date;\n\n  /** End time */\n  endTime: Date;\n\n  /** Duration in milliseconds */\n  durationMs: number;\n\n  /** Memory usage in bytes */\n  memoryUsage?: number;\n\n  /** Number of retries */\n  retries?: number;\n\n  /** Token usage (for LLM operations) */\n  tokenUsage?: {\n    input: number;\n    output: number;\n    total: number;\n  };\n}\n\n/**\n * Result artifact (file, log, etc.)\n */\nexport interface ResultArtifact {\n  /** Artifact type */\n  type: 'file' | 'log' | 'report' | 'code' | 'data';\n\n  /** Artifact name */\n  name: string;\n\n  /** Artifact path or content */\n  content: string;\n\n  /** MIME type */\n  mimeType?: string;\n\n  /** Artifact metadata */\n  metadata?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Agent Message Types\n// ============================================================================\n\n/**\n * Base message interface for agent communication\n */\nexport interface AgentMessage {\n  /** Message ID */\n  id: string;\n\n  /** Message type */\n  type: MessageType;\n\n  /** Sender agent ID */\n  from: string;\n\n  /** Recipient agent ID (or 'broadcast' for all) */\n  to: string;\n\n  /** Message timestamp */\n  timestamp: Date;\n\n  /** Message payload */\n  payload: unknown;\n\n  /** Correlation ID for request/response matching */\n  correlationId?: string;\n\n  /** Message metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Request message for task delegation\n */\nexport interface TaskRequestMessage extends AgentMessage {\n  type: MessageType.REQUEST;\n  payload: {\n    task: AgentTask;\n    urgent?: boolean;\n  };\n}\n\n/**\n * Response message for completed tasks\n */\nexport interface TaskResponseMessage extends AgentMessage {\n  type: MessageType.RESPONSE;\n  payload: {\n    taskId: string;\n    result: AgentResult;\n  };\n}\n\n/**\n * Status update message\n */\nexport interface StatusMessage extends AgentMessage {\n  type: MessageType.STATUS;\n  payload: {\n    agentId: string;\n    status: AgentStatus;\n    currentTask?: string;\n    progress?: number;\n  };\n}\n\n/**\n * Error message\n */\nexport interface ErrorMessage extends AgentMessage {\n  type: MessageType.ERROR;\n  payload: {\n    error: AgentError;\n    taskId?: string;\n    recoverable?: boolean;\n  };\n}\n\n/**\n * Coordination message for multi-agent workflows\n */\nexport interface CoordinationMessage extends AgentMessage {\n  type: MessageType.COORDINATION;\n  payload: {\n    action: 'sync' | 'handoff' | 'merge' | 'split' | 'barrier';\n    data: unknown;\n  };\n}\n\n/**\n * Union type for all message types\n */\nexport type AgentMessageUnion =\n  | TaskRequestMessage\n  | TaskResponseMessage\n  | StatusMessage\n  | ErrorMessage\n  | CoordinationMessage;\n\n// ============================================================================\n// Agent State Types\n// ============================================================================\n\n/**\n * Agent runtime state\n */\nexport interface AgentState {\n  /** Agent ID */\n  id: string;\n\n  /** Current status */\n  status: AgentStatus;\n\n  /** Current task being executed */\n  currentTask?: AgentTask;\n\n  /** Queued tasks */\n  taskQueue: AgentTask[];\n\n  /** Completed task history */\n  completedTasks: string[];\n\n  /** Last activity timestamp */\n  lastActivity: Date;\n\n  /** Error count */\n  errorCount: number;\n\n  /** Custom state data */\n  custom?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Agent Factory Types\n// ============================================================================\n\n/**\n * Agent factory function type\n */\nexport type AgentFactory<T extends AgentConfig = AgentConfig> = (\n  config: T\n) => Promise<AgentInstance>;\n\n/**\n * Agent instance interface\n */\nexport interface AgentInstance {\n  /** Agent configuration */\n  readonly config: AgentConfig;\n\n  /** Agent state */\n  readonly state: AgentState;\n\n  /** Execute a task */\n  execute(task: AgentTask): Promise<AgentResult>;\n\n  /** Pause the agent */\n  pause(): Promise<void>;\n\n  /** Resume the agent */\n  resume(): Promise<void>;\n\n  /** Terminate the agent */\n  terminate(): Promise<void>;\n\n  /** Get agent status */\n  getStatus(): AgentStatus;\n\n  /** Send a message to another agent */\n  sendMessage?(message: AgentMessage): Promise<void>;\n\n  /** Receive and process a message */\n  receiveMessage?(message: AgentMessage): Promise<void>;\n}\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Agent capability descriptor\n */\nexport interface AgentCapability {\n  /** Capability name */\n  name: string;\n\n  /** Capability description */\n  description: string;\n\n  /** Required for this agent type */\n  required?: boolean;\n\n  /** Capability version */\n  version?: string;\n}\n\n/**\n * Agent health check result\n */\nexport interface AgentHealthCheck {\n  /** Agent ID */\n  agentId: string;\n\n  /** Health status */\n  healthy: boolean;\n\n  /** Status details */\n  status: AgentStatus;\n\n  /** Last heartbeat */\n  lastHeartbeat: Date;\n\n  /** Error message if unhealthy */\n  error?: string;\n\n  /** Metrics snapshot */\n  metrics?: Partial<ExecutionMetrics>;\n}\n\n/**\n * Helper function to create a unique message ID\n */\nexport function createMessageId(): string {\n  return `msg_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n}\n\n/**\n * Helper function to create a unique task ID\n */\nexport function createTaskId(): string {\n  return `task_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n}\n\n/**\n * Helper function to create a unique agent ID\n */\nexport function createAgentId(type: AgentType): string {\n  return `${type}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n}\n"],"names":["AgentType","AgentStatus","TaskPriority","MessageType"],"mappings":"AAkBO,IAAK,8BAAAA,eAAL;AAELA,aAAA,YAAA,IAAa;AAGbA,aAAA,OAAA,IAAQ;AAGRA,aAAA,QAAA,IAAS;AAGTA,aAAA,SAAA,IAAU;AAGVA,aAAA,WAAA,IAAY;AAGZA,aAAA,UAAA,IAAW;AAGXA,aAAA,aAAA,IAAc;AAGdA,aAAA,WAAA,IAAY;AAGZA,aAAA,YAAA,IAAa;AAGbA,aAAA,QAAA,IAAS;AA7BC,SAAAA;AAAA,GAAA,aAAA,CAAA,CAAA;AAmCL,IAAK,gCAAAC,iBAAL;AAELA,eAAA,MAAA,IAAO;AAGPA,eAAA,SAAA,IAAU;AAGVA,eAAA,WAAA,IAAY;AAGZA,eAAA,QAAA,IAAS;AAGTA,eAAA,QAAA,IAAS;AAGTA,eAAA,YAAA,IAAa;AAjBH,SAAAA;AAAA,GAAA,eAAA,CAAA,CAAA;AAuBL,IAAK,iCAAAC,kBAAL;AACLA,gBAAA,KAAA,IAAM;AACNA,gBAAA,QAAA,IAAS;AACTA,gBAAA,MAAA,IAAO;AACPA,gBAAA,UAAA,IAAW;AAJD,SAAAA;AAAA,GAAA,gBAAA,CAAA,CAAA;AAUL,IAAK,gCAAAC,iBAAL;AAELA,eAAA,SAAA,IAAU;AAGVA,eAAA,UAAA,IAAW;AAGXA,eAAA,cAAA,IAAe;AAGfA,eAAA,OAAA,IAAQ;AAGRA,eAAA,QAAA,IAAS;AAGTA,eAAA,cAAA,IAAe;AAjBL,SAAAA;AAAA,GAAA,eAAA,CAAA,CAAA;AA4eL,SAAS,kBAA0B;AACxC,SAAO,OAAO,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,UAAU,GAAG,CAAC,CAAC;AACxE;AAKO,SAAS,eAAuB;AACrC,SAAO,QAAQ,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,UAAU,GAAG,CAAC,CAAC;AACzE;AAKO,SAAS,cAAc,MAAyB;AACrD,SAAO,GAAG,IAAI,IAAI,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,UAAU,GAAG,CAAC,CAAC;AAC5E;"}