지정한 폴더를 재귀적으로 훑어 트리, 확장자별 통계를 돌려준다.

파일 분석의 출발점입니다. 여기서 폴더 규모를 먼저 파악한 뒤, list_supported_files로 실제로 읽을 수 있는 파일만 추리세요.

Args: folder_path: 분석할 폴더 경로. max_depth: 트리 최대 깊이 (기본 5). max_entries: 트리에 나열할 최대 항목 수 (기본 2000).

Returns: FolderStructureResponse: tree_text에 들여쓰기된 트리, extension_stats에 확장자별 개수/용량, truncated에 상한 초과 여부.

폴더 안에서 pdf/docx/pptx/svg/png 파일만 골라 경로 목록으로 돌려준다.

각 항목의 absolute_path를 read_pdf/read_docx/read_pptx/read_svg/read_image에 그대로 넘기면 됩니다.

Args: folder_path: 분석할 폴더 경로. max_depth: 탐색 최대 깊이 (기본 5). max_entries: 탐색할 최대 항목 수 (기본 2000).

Returns: SupportedFilesResponse: files[]에 relative_path/absolute_path/extension/bytes.

PDF에서 페이지별 텍스트를 추출한다.

긴 PDF는 컨텍스트를 아끼기 위해 page_start/page_end로 범위를 지정해 나눠 읽으세요. page_end를 생략하면 기본 상한(30페이지)까지만 읽고, 그 이상은 truncated 여부 대신 total_pages와 end_page 차이로 알 수 있습니다.

Args: file_path: PDF 파일 경로. page_start: 시작 페이지 (기본 1). page_end: 끝 페이지. 생략 시 최대 30페이지. ocr: 텍스트 레이어가 없는 페이지를 OCR로 보강할지 여부 (기본 False, 느립니다). ocr_lang: OCR 언어 코드 (기본 'kor+eng').

Returns: ReadPdfResponse: pages[]에 페이지별 text와 text_source ('extracted'/'ocr'/'empty'). likely_scanned가 True면 원래 텍스트 레이어가 없는 스캔본 — ocr=True로 다시 호출하면 내용을 읽을 수 있습니다.

Raises: ToolFailure: PATH_NOT_FOUND / NOT_A_FILE / FILE_TOO_LARGE / UNSUPPORTED_EXTENSION / OCR_ENGINE_NOT_FOUND.

Word(.docx) 문서의 본문 문단, 제목, 표를 추출한다.

옛 형식(.doc)은 지원하지 않습니다 — Word에서 '다른 이름으로 저장 > .docx'로 변환한 뒤 다시 시도하세요.

Args: file_path: docx 파일 경로. max_chars: 본문 최대 글자 수 (기본 60000).

Returns: ReadDocxResponse: text(본문), headings(제목 스타일 문단), tables(행 단위 셀 텍스트).

Raises: ToolFailure: PATH_NOT_FOUND / NOT_A_FILE / FILE_TOO_LARGE / UNSUPPORTED_EXTENSION.

PowerPoint(.pptx)에서 슬라이드별 제목, 본문, 스피커 노트를 추출한다.

옛 형식(.ppt)은 지원하지 않습니다. 슬라이드가 많으면 slide_start/slide_end로 나눠 읽으세요.

Args: file_path: pptx 파일 경로. slide_start: 시작 슬라이드 (기본 1). slide_end: 끝 슬라이드. 생략 시 최대 60장.

Returns: ReadPptxResponse: slides[]에 slide_number/title/text/notes.

Raises: ToolFailure: PATH_NOT_FOUND / NOT_A_FILE / FILE_TOO_LARGE / UNSUPPORTED_EXTENSION.

SVG의 크기, 태그별 구조 통계, 텍스트 요소를 추출한다.

SVG는 XML이라 별도 렌더링 없이 구조 파악이 가능합니다. 단, 이 도구는 벡터를 래스터화(이미지로 렌더링)하지 않으므로, 텍스트가 거의 없고 순수 도형으로만 이루어진 다이어그램은 element_counts로 복잡도만 짐작할 수 있습니다.

Args: file_path: svg 파일 경로.

Returns: ReadSvgResponse: element_counts(태그별 개수), text_content(text 요소 모음), title/description(/ 값).

Raises: ToolFailure: PATH_NOT_FOUND / NOT_A_FILE / FILE_TOO_LARGE / UNSUPPORTED_EXTENSION.

PNG 이미지를 읽어 메타데이터와 이미지 콘텐츠를 함께 돌려준다.

이 도구는 이미지를 요약하지 않는다. 반환된 이미지를 직접 보고 내용을 설명/요약하는 것은 호출자(당신)의 역할입니다.

Args: file_path: png 파일 경로.

Returns: list: [메타데이터(JSON), 이미지 콘텐츠] 두 항목. 메타데이터에는 width/height/mime_type이 담깁니다.

Raises: ToolFailure: PATH_NOT_FOUND / NOT_A_FILE / FILE_TOO_LARGE / UNSUPPORTED_EXTENSION.