프로젝트 소개

core-agent는 Google의 Agent Development Kit(ADK) 위에 구축된 멀티턴 LLM 에이전트용 프로덕션급 Go 기반입니다. 프로바이더, MCP, 스킬, 권한, 영구 세션, 원격 attach, 인프로세스 Bubble Tea TUI, 헤드리스 CLI 등 기반 배선을 제공하므로 다운스트림 프로젝트는 자체 도구와 제품 로직에 집중할 수 있습니다. **런타임**: ADK 러너를 통한 멀티턴 대화와 병렬 도구 호출 디스패치를 지원합니다. 기본 TTY 표면으로 인프로세스 Bubble Tea TUI, --no-tui 라인 REPL 폴백, TUI 트리를 제거하는 슬림 빌드 태그를 포함합니다. 자율 모드는 턴/토큰/비용/월클록 예산, 모델 주도 종료, 영구 체크포인트를 통한 크래시 복구를 갖춘 무인 워커를 지원합니다. 장기 세션 생존성은 약 85% 사용률에서의 자동 턴 후 컨텍스트 압축, 대량 도구 출력을 부모 컨텍스트 밖으로 유지하는 에이전트 도구 래퍼가 있는 서브태스크, 태스크 경계 체크포인트를 제공합니다. **프로바이더**: Gemini API와 Vertex AI(서버 측 GoogleSearch 및 URLContext 포함), api.anthropic.com을 통한 Anthropic Claude 및 Vertex AI를 통한 네이티브 모델 어댑터를 지원합니다. 목 프로바이더(echo, 스크립트 JSONL 재생, 세션 녹화)는 자격 증명 없는 테스트를 가능하게 합니다. 서버 측 내장 도구(web_search, url_context, code_execution)를 위한 프로바이더 중립적 삼상태 게이팅 시스템은 인터넷 도달성 태세가 프로바이더 전환 후에도 유지되도록 합니다. **지침, 도구, MCP, 스킬**: AGENTS.md 기본 지침과 오버레이 디렉터리, 다중 파일 구성을 위한 @include 지시문, 세 가지 스코프(user, user-home, project)와 CLAUDE.md/GEMINI.md 폴백을 제공합니다. 내장 도구 카탈로그는 파일 작업(read, write, edit, delete, outline), 검색(glob, grep), 데이터/네트워크(json_query, fetch_url), 셸(bash), 계획(todo, record_plan), 검증(wait_and_verify), 대화형 프롬프트(ask_user)를 포함합니다. mcp.json에 선언된 MCP 서버는 stdio 및 Streamable HTTP 전송, 네임스페이스 도구, 권한 게이트 라우팅을 지원합니다. Claude 호환 스킬은 SKILL.md 파일에서 자동 검색되며 요구 사항 선언(예: shell, kubectl, gcloud)이 충족되지 않으면 시작 시 보류됩니다. **권한**: ask/allow/yolo 모드와 패턴 기반 허용/거부 목록, 파일 도구에 대한 경로 범위 적용, fetch_url에 대한 URL 범위 허용 목록, 재정의 불가능한 bash 거부 목록을 제공합니다. 계획 우선 적용은 변경 도구 호출 전에 기록된 계획을 요구하거나(필수 모드) 차단 없이 계획을 기록할 수 있습니다(무인 실행용 권고 모드). 플러그 가능한 Prompter 인터페이스는 TTY, 헤드리스, TUI 또는 사용자 정의 웹 프런트엔드 전반에서 작동합니다. **영속성 및 관찰성**: SQLite(순수 Go, CGO 불필요), Postgres 또는 MySQL을 통한 영구 세션과 감사 로그로 단조 seq, 재생, 라이브 테일 감시, 크래시 안전 다중 프로세스 재개를 위한 세션 잠금을 제공합니다. 선택적 OpenTelemetry 내보내기(콘솔/OTLP, 기본 비활성). 계층화된 가격 책정(일일 LiteLLM 새로 고침, 구성별 재정의)을 통한 모델별 토큰 및 비용 추적. **원격 Attach 및 운영자 표면**: mTLS + 베어러 인증을 통한 HTTP + SSE 라이브 테일과 inject/wake 엔드포인트. 진행 중 턴 취소 및 루프 파킹을 위한 운영자 보류/중단/일시 정지 제어. 전체 슬래시 명령 패리티, 턴별 비용 푸터, 라이브 도구 승인 모달, 세션 전환을 갖춘 원격 TUI 클라이언트(별도 버전 관리 바이너리). 호출자별 ID, ACL(Owner/Viewers/Contributors), 권한 부여, 지침 오버레이, 감사 귀속을 갖춘 다중 세션 데몬으로 세션은 데몬 재시작 후에도 유지됩니다. A2A AgentCard 형태의 /.well-known/agent-card.json을 통한 에이전트 카드 검색. 허브 앤 스포크 플릿 검색을 위한 피어 등록. **서브에이전트**: agent.WithSubagents를 통한 인프로세스 동기 위임, spawn_agent/stop_agent를 통한 백그라운드 서브에이전트로 결과는 Background 보고서로 푸시됩니다. gRPC, K8s Jobs 또는 Cloud Run을 위한 소비자 제공 RemoteAgentSpawner를 통한 원격 스폰. 서브에이전트 이벤트는 Branch 레이블 아래 부모의 감사 로그로 스트리밍됩니다. **Kubernetes 트리아지 사이드카**: lookout-watch는 Kubernetes Events를 감시하고 필터링 및 중복 제거하며, 일치하는 인시던트를 인시던트별 세션에 주입하여 GKE MCP를 통한 진단-수정-검증 루프를 수행하며 계획 우선 적용으로 게이트됩니다. **설치**: Go install(Go 1.26+ 필요), 사전 빌드된 Sigstore 서명 바이너리(linux/darwin × amd64/arm64), 멀티 아키텍처 distroless 컨테이너 이미지(전체 데몬+TUI, 슬림 헤드리스, TUI 클라이언트 전용). 라이선스 Apache-2.0.