using System.Collections.Generic;
namespace MCPForUnity.Editor.Services.Server
{
/// <summary>
/// Interface for platform-specific process inspection operations.
/// Provides methods to detect MCP server processes, query process command lines,
/// and find processes listening on specific ports.
/// </summary>
public interface IProcessDetector
{
/// <summary>
/// Determines if a process looks like an MCP server process based on its command line.
/// Checks for indicators like uvx, python, mcp-for-unity, uvicorn, etc.
/// </summary>
/// <param name="pid">The process ID to check</param>
/// <returns>True if the process appears to be an MCP server</returns>
bool LooksLikeMcpServerProcess(int pid);
/// <summary>
/// Attempts to get the command line arguments for a Unix process.
/// </summary>
/// <param name="pid">The process ID</param>
/// <param name="argsLower">Output: normalized (lowercase, whitespace removed) command line args</param>
/// <returns>True if the command line was retrieved successfully</returns>
bool TryGetProcessCommandLine(int pid, out string argsLower);
/// <summary>
/// Gets the process IDs of all processes listening on a specific TCP port.
/// </summary>
/// <param name="port">The port number to check</param>
/// <returns>List of process IDs listening on the port</returns>
List<int> GetListeningProcessIdsForPort(int port);
/// <summary>
/// Gets the current Unity Editor process ID safely.
/// </summary>
/// <returns>The current process ID, or -1 if it cannot be determined</returns>
int GetCurrentProcessId();
/// <summary>
/// Checks if a process exists on Unix systems.
/// </summary>
/// <param name="pid">The process ID to check</param>
/// <returns>True if the process exists</returns>
bool ProcessExists(int pid);
/// <summary>
/// Normalizes a string for matching by removing whitespace and converting to lowercase.
/// </summary>
/// <param name="input">The input string</param>
/// <returns>Normalized string for matching</returns>
string NormalizeForMatch(string input);
}
}
