@spec find_executable() :: {:ok, String.t()} | {:error, :not_found}

Attempts to find the Claude CLI executable.

Tries candidates in order (claude-code, then claude) and returns {:ok, path} when found or {:error, :not_found} otherwise.

@spec find_executable!() :: String.t()

Like find_executable/0 but raises when the CLI is not available.

@spec installed?() :: boolean()

Returns true if the Claude CLI is installed and discoverable.

@spec minimum_version() :: String.t()

Returns the minimum supported Claude CLI version.

@spec recommended_version() :: String.t()

Returns the recommended Claude CLI version for this SDK release.

This version is tested and known to work with all SDK features including file checkpointing, streaming control protocol, and partial messages.

@spec resolve_executable(ClaudeAgentSDK.Options.t() | nil) ::
  {:ok, String.t()} | {:error, :not_found}

Resolves the CLI executable, honoring option overrides.

When path_to_claude_code_executable or executable is set on the options, that value is used directly. Otherwise falls back to normal discovery.

@spec resolve_executable!(ClaudeAgentSDK.Options.t() | nil) :: String.t()

Like resolve_executable/1 but raises when the CLI is not available.

@spec version() :: {:ok, String.t()} | {:error, term()}

Returns the installed Claude CLI version as a string.

@spec version_supported?() :: boolean()

True if the installed version meets or exceeds the minimum.

@spec warn_if_outdated() :: :ok

Emits a warning when the installed CLI is below the supported minimum or unknown.