@callback append_file(session_id :: String.t(), path :: String.t(), content :: String.t()) ::
  :ok | {:error, term()}

@callback exists?(session_id :: String.t(), path :: String.t()) ::
  {:ok, boolean()} | {:error, term()}

@callback mkdir(session_id :: String.t(), path :: String.t(), recursive :: boolean()) ::
  :ok | {:error, term()}

@callback read_file(session_id :: String.t(), path :: String.t()) ::
  {:ok, String.t()} | {:error, term()}

@callback readdir(session_id :: String.t(), path :: String.t()) ::
  {:ok, [String.t()]} | {:error, term()}

@callback readdir_with_types(session_id :: String.t(), path :: String.t()) ::
  {:ok, [Copilot.Types.SessionFsFileInfo.t()]} | {:error, term()}

@callback rename(session_id :: String.t(), old_path :: String.t(), new_path :: String.t()) ::
  :ok | {:error, term()}

@callback rm(session_id :: String.t(), path :: String.t(), recursive :: boolean()) ::
  :ok | {:error, term()}

@callback stat(session_id :: String.t(), path :: String.t()) ::
  {:ok, Copilot.Types.SessionFsFileInfo.t()} | {:error, term()}

@callback write_file(session_id :: String.t(), path :: String.t(), content :: String.t()) ::
  :ok | {:error, term()}