<?php
/**
 * Kilo Code (VS Code extension) MCP client.
 *
 * @package AcrossAI_MCP_Manager
 * @subpackage Includes\MCPClients
 */

namespace AcrossAI_MCP_Manager\Includes\MCPClients;

defined( 'ABSPATH' ) || exit;

/**
 * Produces a Kilo Code MCP configuration snippet.
 *
 * Target file: `.kilocode/mcp.json` (project-level; VS Code sidebar UI
 * is the recommended entry point for global config).
 * Top-level key: `mcpServers`
 */
final class KiloCodeClient extends AbstractMCPClient {

	/**
	 * {@inheritDoc}
	 */
	public function get_client_slug(): string {
		return 'kilo-code';
	}

	/**
	 * {@inheritDoc}
	 */
	public function get_client_name(): string {
		return 'Kilo Code';
	}

	/**
	 * {@inheritDoc}
	 *
	 * @param string $server_url Already-sanitised server URL.
	 * @param string $auth_token Already-issued Application Password (may be empty).
	 *
	 * @return array<string, mixed>
	 */
	public function get_config_snippet( string $server_url, string $auth_token ): array {
		return array(
			'mcpServers' => array(
				$this->derive_server_key( $server_url ) => array(
					'command' => 'npx',
					'args'    => array( '-y', '@automattic/mcp-wordpress-remote@latest' ),
					'env'     => $this->build_env( $server_url, $auth_token ),
				),
			),
		);
	}

	/**
	 * {@inheritDoc}
	 */
	public function get_icon(): string {
		return '⚙️';
	}

	/**
	 * {@inheritDoc}
	 */
	public function get_description(): string {
		return __( 'Kilo Code — open-source AI coding agent for VS Code', 'acrossai-mcp-manager' );
	}

	/**
	 * {@inheritDoc}
	 */
	public function get_config_file(): string {
		return '.kilocode/mcp.json';
	}

	/**
	 * {@inheritDoc}
	 *
	 * Workspace-relative (`.kilocode/mcp.json`); identical on every OS. Declared
	 * empty explicitly so a later reader can see this was decided, not missed.
	 *
	 * @since 0.3.9
	 * @return array<string, string>
	 */
	public function get_config_files(): array {
		return array();
	}

	/**
	 * {@inheritDoc}
	 */
	public function get_top_level_key(): string {
		return 'mcpServers';
	}

	/**
	 * {@inheritDoc}
	 */
	public function get_instructions(): string {
		return __( 'Generate a password → copy the JSON → open .kilocode/mcp.json (or use the Kilo Code sidebar → MCP Servers → Configure MCP Servers) → paste under mcpServers.', 'acrossai-mcp-manager' );
	}

	/**
	 * {@inheritDoc}
	 */
	public function get_restart_step_text(): string {
		return __( 'Kilo Code hot-reloads MCP servers — reopen the MCP Servers panel in the Kilo Code sidebar to confirm the new server is listed.', 'acrossai-mcp-manager' );
	}

	/**
	 * {@inheritDoc}
	 */
	public function get_priority(): int {
		return 76;
	}
}