Swift Actor 기반 BackgroundManager 도입으로 에이전트 루프 Non-blocking 구현

Context

기존 에이전트 루프가 모든 Tool Call을 동기적으로 처리함에 따라 발생하는 Blocking 문제 분석. 특히 빌드, 설치, 테스트 스위트와 같은 장시간 실행 작업 시 루프 전체가 유휴 상태가 되어 전체 시스템 처리 효율이 저하되는 병목 지점 식별.

Technical Solution

• BackgroundManager를 시스템 내 유일한 Actor로 설계하여 공유 상태(jobs, notifications)에 대한 동시성 접근 제어 및 Data Race 방지
• 느린 커맨드를 Worker에 위임하고 Job ID를 즉시 반환하는 비동기 실행 레이어 구축
• 실행 완료 결과를 Notification Queue에 적재하고, 매 API 호출 전 루프에서 이를 Drain 하여 컨텍스트에 주입하는 Notification Injection 패턴 적용
• ShellExecutor를 Sendable Struct로 구현하여 Actor 격리 경계를 안전하게 교차하는 데이터 전송 구조 설계
• 루프의 핵심 커널(API 호출-결과 처리-반복)은 유지하되, 주위로 기능을 확장하는 Injection Point 중심의 아키텍처 유지