HostApi — 플러그인이 호스트와 대화하는 단일 통로

호스트가 플러그인에 제공하는 능력

플러그인은 어디에서 실행되나

예전에는 모든 플러그인이 호스트와 같은 프로세스 안에서 실행됐습니다. 지금은 플러그인을 별도의 자식 프로세스에 가두는 경로 가 만들어져 있고, 그 경로로 실제로 실행되는 플러그인이 하나씩 늘어나는 중입니다. 오늘 시점에 이 경로를 타는 것은 work-assistant 한 개입니다 (src/plugins/isolation/out-of-process-plugins.ts).

• 어느 플러그인이 격리되는지는 플러그인이 정하지 않습니다. 설정 값도, 환경 변수도, 매니페스트 필드도 이 목록을 읽지 않습니다. 목록은 소스에 고정되어 있고, 바뀌려면 코드 변경이 리뷰를 통과해야 합니다.
• 자식이 실패하면 호출도 실패합니다. 같은 호출을 호스트 프로세스 안에서 다시 시도하는 우회 경로는 없습니다.
• 통로의 모양은 그대로입니다. 저장소 · 설정 · 이벤트 구독 · LLM 호출 · 인증 창 · 비밀값 조회 모두 경계 너머로 전달됩니다. 플러그인 입장에서 달라지는 것은 위 “비밀값 조회” 처럼 응답을 기다려야 하는 호출이 있다는 점입니다.

단일 통로의 효과

• 플러그인은 호스트의 내부 구현을 알지 못합니다. 호스트가 내부를 바꿔도 플러그인은 영향을 받지 않습니다.
• 위험한 동작 (메일 발송, 외부 호출, 파일 삭제) 은 모두 같은 권한 흐름을 거치므로 사용자 입장에서 일관된 경험을 받습니다.
• 새 플러그인이 들어와도 호스트 코드를 고치지 않습니다. 플러그인 자체에 자기 능력을 선언해 두면 됩니다.
• 플러그인이 만들어내는 모든 작업은 호스트의 감사 기록에 남습니다.