@spec build_env(AntigravityCliSdk.Options.t()) :: map()

@spec build_invocation(keyword()) ::
  {:ok, CliSubprocessCore.Command.t()} | {:error, term()}

@spec build_session_options(String.t(), AntigravityCliSdk.Options.t(), keyword()) ::
  keyword()

@spec capabilities() :: [atom()]

@spec close(pid()) :: :ok

@spec command_args(CliSubprocessCore.CommandSpec.t(), [String.t()]) :: [String.t()]

@spec end_input(pid()) :: :ok | {:error, term()}

@spec info(pid()) :: map()

@spec interrupt(pid()) :: :ok | {:error, term()}

@spec project_event(CliSubprocessCore.Event.t(), map()) ::
  {[AntigravityCliSdk.Types.stream_event()], map()}

@spec resolve(keyword()) ::
  {:ok, CliSubprocessCore.CommandSpec.t()}
  | {:error, AntigravityCliSdk.Error.t()}

@spec send_input(pid(), iodata(), keyword()) :: :ok | {:error, term()}

@spec session_event_tag() :: atom()

@spec start_session(keyword()) ::
  {:ok, pid(),
   %{info: map(), projection_state: map(), temp_dir: String.t() | nil}}
  | {:error, term()}

@spec subscribe(pid(), pid(), reference()) :: :ok | {:error, term()}