vibecodingmachine-core 2026.2.20-438 → 2026.2.26-1739

package/src/agents/AgentAdditionService.js

@@ -0,0 +1,311 @@
+/**
+ * Agent Addition Service
+ * 
+ * Handles adding new agents to the system.
+ * Follows constitutional requirements: <555 lines, test-first approach.
+ */
+
+const ConfigValidator = require('./config/ConfigValidator');
+const AgentConfigManager = require('./config/AgentConfigManager');
+const AgentLogger = require('./logging/AgentLogger');
+
+/**
+ * Agent Addition Service class
+ */
+class AgentAdditionService {
+  /**
+   * Create agent addition service instance
+   * @param {Object} options - Service options
+   */
+  constructor(options = {}) {
+    this.configManager = options.configManager || new AgentConfigManager();
+    this.validator = options.validator || new ConfigValidator();
+    this.logger = options.logger || new AgentLogger();
+    this.configPath = options.configPath || 'config/agents.json';
+  }
+
+  /**
+   * Add a new agent to the system
+   * @param {Object} agentConfig - Agent configuration
+   * @returns {Object} - Addition result
+   */
+  async addAgent(agentConfig) {
+    try {
+      this.logger.info(`Adding agent: ${agentConfig.id || 'unknown'}`);
+
+      // Validate agent configuration
+      const validation = this.validator.validateAgent(agentConfig);
+      if (!validation.valid) {
+        const error = `Agent validation failed: ${validation.errors.join(', ')}`;
+        this.logger.error(error);
+        return {
+          success: false,
+          error,
+          validation
+        };
+      }
+
+      // Check if agent already exists
+      const existingAgents = await this.configManager.loadAgents();
+      if (existingAgents[agentConfig.id]) {
+        const error = `Agent ${agentConfig.id} already exists`;
+        this.logger.error(error);
+        return {
+          success: false,
+          error,
+          agentId: agentConfig.id
+        };
+      }
+
+      // Add agent to configuration
+      const updatedAgents = {
+        ...existingAgents,
+        [agentConfig.id]: {
+          ...agentConfig,
+          enabled: agentConfig.enabled !== false, // Default to enabled
+          status: 'NOT_INSTALLED',
+          lastChecked: null,
+          lastVerified: null
+        }
+      };
+
+      // Save updated configuration
+      await this.configManager.saveAgents(updatedAgents);
+
+      this.logger.info(`Successfully added agent: ${agentConfig.id}`);
+
+      return {
+        success: true,
+        agentId: agentConfig.id,
+        agent: updatedAgents[agentConfig.id],
+        validation
+      };
+
+    } catch (error) {
+      this.logger.error(`Failed to add agent: ${error.message}`);
+      return {
+        success: false,
+        error: error.message,
+        agentId: agentConfig.id
+      };
+    }
+  }
+
+  /**
+   * Remove an agent from the system
+   * @param {string} agentId - Agent ID to remove
+   * @returns {Object} - Removal result
+   */
+  async removeAgent(agentId) {
+    try {
+      this.logger.info(`Removing agent: ${agentId}`);
+
+      // Check if agent exists
+      const existingAgents = await this.configManager.loadAgents();
+      if (!existingAgents[agentId]) {
+        const error = `Agent ${agentId} not found`;
+        this.logger.error(error);
+        return {
+          success: false,
+          error,
+          agentId
+        };
+      }
+
+      // Remove agent from configuration
+      const { [agentId]: removed, ...remainingAgents } = existingAgents;
+
+      // Save updated configuration
+      await this.configManager.saveAgents(remainingAgents);
+
+      this.logger.info(`Successfully removed agent: ${agentId}`);
+
+      return {
+        success: true,
+        agentId,
+        removedAgent: removed
+      };
+
+    } catch (error) {
+      this.logger.error(`Failed to remove agent: ${error.message}`);
+      return {
+        success: false,
+        error: error.message,
+        agentId
+      };
+    }
+  }
+
+  /**
+   * Update an existing agent configuration
+   * @param {string} agentId - Agent ID to update
+   * @param {Object} updates - Configuration updates
+   * @returns {Object} - Update result
+   */
+  async updateAgent(agentId, updates) {
+    try {
+      this.logger.info(`Updating agent: ${agentId}`);
+
+      // Check if agent exists
+      const existingAgents = await this.configManager.loadAgents();
+      if (!existingAgents[agentId]) {
+        const error = `Agent ${agentId} not found`;
+        this.logger.error(error);
+        return {
+          success: false,
+          error,
+          agentId
+        };
+      }
+
+      // Merge updates with existing configuration
+      const updatedConfig = {
+        ...existingAgents[agentId],
+        ...updates,
+        id: agentId // Preserve ID
+      };
+
+      // Validate updated configuration
+      const validation = this.validator.validateAgent(updatedConfig);
+      if (!validation.valid) {
+        const error = `Agent validation failed: ${validation.errors.join(', ')}`;
+        this.logger.error(error);
+        return {
+          success: false,
+          error,
+          validation
+        };
+      }
+
+      // Update agent in configuration
+      const updatedAgents = {
+        ...existingAgents,
+        [agentId]: updatedConfig
+      };
+
+      // Save updated configuration
+      await this.configManager.saveAgents(updatedAgents);
+
+      this.logger.info(`Successfully updated agent: ${agentId}`);
+
+      return {
+        success: true,
+        agentId,
+        agent: updatedConfig,
+        validation
+      };
+
+    } catch (error) {
+      this.logger.error(`Failed to update agent: ${error.message}`);
+      return {
+        success: false,
+        error: error.message,
+        agentId
+      };
+    }
+  }
+
+  /**
+   * Enable or disable an agent
+   * @param {string} agentId - Agent ID
+   * @param {boolean} enabled - Whether to enable the agent
+   * @returns {Object} - Update result
+   */
+  async setAgentEnabled(agentId, enabled) {
+    return this.updateAgent(agentId, { enabled });
+  }
+
+  /**
+   * Get list of available agents
+   * @returns {Object} - List of agents
+   */
+  async getAgents() {
+    try {
+      const agents = await this.configManager.loadAgents();
+      return {
+        success: true,
+        agents: Object.keys(agents).map(id => ({
+          id,
+          ...agents[id]
+        }))
+      };
+    } catch (error) {
+      this.logger.error(`Failed to get agents: ${error.message}`);
+      return {
+        success: false,
+        error: error.message
+      };
+    }
+  }
+
+  /**
+   * Get specific agent details
+   * @param {string} agentId - Agent ID
+   * @returns {Object} - Agent details
+   */
+  async getAgent(agentId) {
+    try {
+      const agents = await this.configManager.loadAgents();
+      const agent = agents[agentId];
+
+      if (!agent) {
+        return {
+          success: false,
+          error: `Agent ${agentId} not found`,
+          agentId
+        };
+      }
+
+      return {
+        success: true,
+        agent: {
+          id: agentId,
+          ...agent
+        }
+      };
+    } catch (error) {
+      this.logger.error(`Failed to get agent: ${error.message}`);
+      return {
+        success: false,
+        error: error.message,
+        agentId
+      };
+    }
+  }
+
+  /**
+   * Validate agent configuration without adding it
+   * @param {Object} agentConfig - Agent configuration to validate
+   * @returns {Object} - Validation result
+   */
+  validateAgentConfig(agentConfig) {
+    return this.validator.validateAgent(agentConfig);
+  }
+
+  /**
+   * Check if agent ID is available
+   * @param {string} agentId - Agent ID to check
+   * @returns {Object} - Availability result
+   */
+  async isAgentIdAvailable(agentId) {
+    try {
+      const agents = await this.configManager.loadAgents();
+      const available = !agents[agentId];
+
+      return {
+        success: true,
+        available,
+        agentId
+      };
+    } catch (error) {
+      this.logger.error(`Failed to check agent ID availability: ${error.message}`);
+      return {
+        success: false,
+        error: error.message,
+        agentId
+      };
+    }
+  }
+}
+
+module.exports = AgentAdditionService;