Merge pull request #29 from laravel/ai-53-cleaner-agentide-management-in-installcommand-pair

refactor: simplify InstallCommand by consolidating CodeEnvironment handling and removing legacy agents

Author: ashleyhindle

src/Console/InstallCommand.php

@@ -4,10 +4,29 @@
 
 namespace Laravel\Boost\Contracts;
 
-// We give Agents AI Rules
+/**
+ * Agent contract for AI coding assistants that receive guidelines.
+ */
 interface Agent
 {
+    /**
+     * Get the display name of the Agent.
+     *
+     * @return string|null
+     */
+    public function agentName(): ?string;
+
+    /**
+     * Get the file path where AI guidelines should be written.
+     *
+     * @return string The relative or absolute path to the guideline file
+     */
     public function guidelinesPath(): string;
 
+    /**
+     * Determine if the guideline file requires frontmatter.
+     *
+     * @return bool
+     */
     public function frontmatter(): bool;
 }

src/Contracts/Agent.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Laravel\Boost\Contracts;
+
+/**
+ * Contract for code editors that support MCP (Model Context Protocol).
+ */
+interface McpClient
+{
+    /**
+     * Get the display name of the MCP (Model Context Protocol) client.
+     *
+     * @return string|null
+     */
+    public function mcpClientName(): ?string;
+
+    /**
+     * Install an MCP server configuration in this IDE.
+     *
+     * @param string $key Server identifier/name
+     * @param string $command Executable command to run the MCP server
+     * @param array<int, string> $args Command line arguments
+     * @param array<string, string> $env Environment variables
+     * @return bool True if installation succeeded, false otherwise
+     */
+    public function installMcp(string $key, string $command, array $args = [], array $env = []): bool;
+}