@type stderr_mode() :: :separate | :stdout

@type t() :: %CliSubprocessCore.Command.Options{
  boundary_class: atom() | String.t() | nil,
  close_stdin: boolean(),
  governed_authority: CliSubprocessCore.GovernedAuthority.t() | nil,
  invocation: CliSubprocessCore.Command.t() | nil,
  lease_ref: String.t() | nil,
  observability: map(),
  profile: module() | nil,
  provider: atom() | nil,
  provider_options: keyword(),
  registry: pid() | atom(),
  stderr: stderr_mode(),
  stdin: term(),
  surface_kind: atom(),
  surface_ref: String.t() | nil,
  target_id: String.t() | nil,
  timeout: timeout(),
  transport_options: keyword()
}

@type validation_error() ::
  :missing_provider
  | {:invalid_command, term()}
  | {:invalid_args, term()}
  | {:invalid_cwd, term()}
  | {:invalid_env, term()}
  | {:invalid_clear_env, term()}
  | {:invalid_user, term()}
  | {:invalid_provider, term()}
  | {:invalid_profile, term()}
  | {:provider_profile_mismatch, atom(), atom()}
  | {:invalid_registry, term()}
  | {:unsupported_option, :transport_selector}
  | {:unsupported_option, :simulation_selector}
  | {:invalid_timeout, term()}
  | {:invalid_stderr, term()}
  | {:invalid_close_stdin, term()}
  | {:invalid_surface_kind, term()}
  | {:invalid_transport_options, term()}
  | {:invalid_target_id, term()}
  | {:invalid_lease_ref, term()}
  | {:invalid_surface_ref, term()}
  | {:invalid_boundary_class, term()}
  | {:invalid_observability, term()}
  | CliSubprocessCore.GovernedAuthority.validation_error()
  | {:governed_launch_smuggling, atom()}
  | {:governed_launch_smuggling, atom(), term()}
  | CliSubprocessCore.ProviderRuntimeProfile.resolve_error()