@debugmcp/mcp-debugger/src/interfaces/command-finder.ts

Run-time step-through debugging for LLM agents.

/**
 * Interface for finding executable commands in the system PATH
 */
export interface CommandFinder {
  /**
   * Find the full path to an executable command
   * @param command The command name to find
   * @returns The full path to the executable
   * @throws CommandNotFoundError if the command is not found
   */
  find(command: string): Promise<string>;
}

/**
 * Error thrown when a command cannot be found in the system PATH
 */
export class CommandNotFoundError extends Error {
  constructor(public readonly command: string) {
    super(`Command not found: ${command}`);
    this.name = 'CommandNotFoundError';
  }
}