Agenvoy@v0.24.13 - 파일 도구를 위한 에이전트 폴백(fallback) 처리 및 거부된 경로(denied-path) 추적 추가

pardnchiu/Agenvoy

v0.24.12 -> v0.24.13

요약 (Summary)

에이전트 결정(Agent resolution) 과정에서 멀티 에이전트 장애 조치(multi-agent failover) 경로를 복구했습니다. 이제 디스패처 라우팅(dispatcher routing)이 재시도 횟수를 모두 소진하면, 즉시 에러를 반환하는 대신 디스패처를 'dead'로 표시하고 레지스트리 순서(registry order)로 넘어가(fall through) 다른 등록된 에이전트들이 시도될 수 있도록 합니다. 등록된 에이전트가 하나뿐인 경우에는 디스패처를 완전히 건너뜁니다. 파일 도구(File tools)는 세션별로 권한 거부(permission-denied)된 루트를 기억하며, 동일한 서브트리(subtree)에 대한 후속 호출을 단락(short-circuit) 처리합니다.

변경 사항 (Changes)

기능 (FEAT)

• 파일 도구를 위한 에이전트 폴백(fallback) 처리 및 거부된 경로(denied-path) 추적 추가 [22594db]

• SelectAgentNames 디스패처의 3회 재시도가 모두 실패할 경우, 「dead[bot.Name()]=true 표시 + 경고 + 레지스트리 순서로 넘어가기」 방식으로 변경되었습니다 (v0.24.12의 return error 방식은 멀티 에이전트 설정 시 정상적인 에이전트까지 함께 중단시키는 문제가 있어 철회되었습니다). len(registry.Entries)==1인 경우 디스패처 LLM 호출을 완전히 건너뛰는 조기 반환(early return)을 추가했습니다 (엔트리가 하나뿐이면 라우팅 결정이 필요 없기 때문). internal/tools/file/denied/ 패키지를 신규 추가했습니다 (세션별 sync.Map, 경로 구성 요소 경계(path-component-boundary) 접두사 비교, Hit/Register/IsPermission API 포함). 6개의 파일 도구(list/read/write/patch/glob/search) 핸들러 입구에 denied.Hit 가드(guard)를 적용하였으며, 작업 실패 시 IsPermission(err) → Register를 통해 EACCES 경로를 기록합니다. list_files는 go-pkg reader의 IgnoreWalkError:true 설정이 루트 EACCES를 빈 결과로 삼켜버리는 것을 방지하기 위해 os.Open을 통한 추가 사전 테스트를 수행합니다.

범위 (Scope)

• internal/agents/exec/selectAgent.go — 업데이트 (디스패처 폴스루(fall-through) 복구, 단일 엔트리 건너뛰기)
• internal/tools/file/denied/denied.go — 기능 추가 (새로운 세션별 EACCES 캐시 패키지)
• internal/tools/file/ — 업데이트 (list_files, read_file, write_file, patch_file, glob_files, search_files — 6개 도구 모두 거부 캐시 가드 연결 및 EACCES 발생 시 등록 기능 적용)

SKILL에 의해 생성됨