클라이언트의 루트 요청하기

루트가 존재한다는 것을 아는 것이 첫 번째 단계입니다. 두 번째 단계는 클라이언트에 현재 목록을 실제로 요청하여 서버가 어디에서 읽거나 쓸지 결정하도록 하는 것입니다. 📨

여기서는 방향이 뒤바뀝니다. 서버가 요청을 보내고 클라이언트가 응답합니다. 서버가 호출하는 메서드는 roots/list이며, 클라이언트가 현재 제공하는 모든 항목을 요청합니다.

Python SDK에서는 원시 JSON을 직접 작성하지 않습니다. 도구에 전달된 요청 컨텍스트 객체를 사용합니다. 이 객체는 클라이언트와의 활성 세션을 감싸고 있습니다.

해당 컨텍스트에서 list_roots()를 호출하고 결과를 기다립니다. SDK가 대신 roots/list를 전송하고, 클라이언트의 응답을 지정된 형식의 결과로 반환합니다.

응답에는 루트 목록이 들어 있습니다. 각 항목에는 URI와 선택적 이름이 있으며, 앞에서 본 간단한 구조와 정확히 같습니다. 이제 이 목록을 순회하면 됩니다.

유효한 응답으로 빈 목록이 반환될 수도 있습니다. 이는 현재 클라이언트가 제공하는 루트가 없다는 뜻이므로, 폴더가 있다고 가정하지 말고 적절한 대체 방법을 준비해야 합니다.

클라이언트가 루트를 지원할 때만 list_roots를 호출하는 것이 의미가 있습니다. 예의 바른 서버는 요청하기 전에 선언된 기능을 확인하여, 해당 기능이 없는 호스트에서 오류가 발생하지 않도록 합니다.

파일 도구를 시작할 때처럼 필요할 때 루트를 가져오세요. 지연해서 요청하면 사용자가 그 후에 다른 폴더를 열었더라도 최신 상태를 유지할 수 있습니다.

루트의 URI는 file:///home/ada와 같은 문자열입니다. 이를 사용하려면 파일을 열기 전에 file:// URI를 실제 파일 시스템 경로로 구문 분석해야 합니다.

클라이언트가 이 기능을 지원한다면 루트가 변경될 때 알림을 보낼 수 있습니다. 이를 받아 목록을 다시 가져오면 오래된 정보를 기준으로 작업하는 일을 피할 수 있습니다.

요청이 실패하거나 시간이 초과될 수도 있습니다. 호출을 감싸서 응답이 없더라도 도구가 충돌하는 대신 명확한 메시지를 표시하도록 하세요. 🛟

세션에서 list_roots()의 결과를 기다리고, 반환된 루트를 순회하며, 각 file:// URI를 구문 분석하고, 비어 있거나 실패한 응답을 처리합니다. 루트가 변경되면 다시 요청하세요. ✅