Project Hive X

배경

• 에이전트가 도구를 호출할 때 현재는 호출 내용을 텍스트 중심으로만 인지하게 되어, 사용자가 어떤 종류의 작업이 실행되는지 빠르게 파악하기 어렵다.
• Codex App 스타일에 맞춰 도구 호출 항목의 앞쪽에 작은 아이콘을 표시하고, 도구 유형에 따라 아이콘을 다르게 보여준다.

목표

• 도구 호출 row 또는 timeline 항목을 볼 때 “읽기/쓰기/탐색/명령 실행” 같은 작업 성격이 한눈에 구분되도록 한다.
• 아이콘은 장식이 아니라 도구 호출의 의미를 보조하는 정보로 사용한다.
• 기존 레이아웃 밀도와 정렬을 해치지 않고, Codex App처럼 절제된 시각 신호로 표시한다.

표시 위치

• 각 도구 호출 항목의 가장 앞쪽에 아이콘을 표시한다.
• 아이콘 뒤에는 기존 도구명, 요약 문구, 상태 텍스트가 이어진다.
• 여러 도구 호출이 연속으로 표시될 때도 아이콘 컬럼의 폭과 정렬이 일정해야 한다.

도구 유형 예시

• 읽기(read): 파일 열기, 파일 내용 조회, 설정/문서 읽기, 로그 읽기 등 읽기 전용 작업
• 쓰기(write): 파일 생성/수정/삭제, 패치 적용, 설정 변경 등 상태를 바꾸는 작업
• 탐색(search/explore): 파일 검색, 텍스트 검색, 목록 조회, 프로젝트 구조 탐색 등 위치나 대상을 찾는 작업
• 명령 실행(command/terminal): 터미널 명령, 빌드, 테스트, 스크립트 실행 등 프로세스를 실행하는 작업
• 네트워크/외부 조회(network/web): 외부 문서 조회, 웹 검색, 원격 API 확인 등 네트워크성 작업
• 기타/알 수 없음(unknown): 분류되지 않은 도구 호출에 대한 기본 아이콘

구현 방향

• 가능하면 도구 호출 이벤트의 metadata나 tool name을 기준으로 유형을 분류한다.
• 분류 로직은 UI 곳곳에 흩어지지 않게 한 곳에서 관리한다.
• app-server/shared 이벤트에 명확한 tool type 필드가 이미 있거나 추가 가능하면 그것을 우선 사용한다.
• metadata가 부족한 경우에는 renderer에서 알려진 tool name을 최소한의 매핑 테이블로 분류하되, 임의 문자열 파싱이 과도하게 늘어나지 않게 한다.
• 아이콘은 기존 UI 아이콘 체계가 있으면 그 컴포넌트를 사용하고, 없으면 프로젝트에서 사용 중인 아이콘 라이브러리 기준으로 추가한다.

UI 요구사항

• 아이콘 크기는 도구 호출 텍스트보다 튀지 않는 작은 크기로 유지한다.
• 읽기/쓰기/탐색 등의 차이는 아이콘 형태로 먼저 구분하고, 색상은 보조적으로만 사용한다.
• 실패/진행/완료 같은 상태 표시는 기존 상태 UI와 충돌하지 않아야 한다.
• hover/focus/접힘 상태에서도 아이콘이 잘 정렬되어야 한다.
• 도구 호출 목록이 길어져도 아이콘 때문에 행 높이나 간격이 과하게 커지면 안 된다.

완료 기준

• 도구 호출 항목 앞에 유형별 아이콘이 표시된다.
• 읽기, 쓰기, 탐색 도구는 서로 다른 아이콘으로 구분된다.
• 명령 실행, 네트워크/외부 조회, 알 수 없는 도구에 대한 fallback도 정의되어 있다.
• 아이콘 표시가 기존 도구 호출 텍스트, 상태, 스트리밍 표시를 깨뜨리지 않는다.
• 분류 로직이 한 곳에 정리되어 새 도구 유형을 추가하기 쉽다.
• Codex App 스타일의 밀도와 절제된 시각 톤을 유지한다.