Skip to content

File Reference

Jump to bottom
Danny edited this page Apr 11, 2026 · 1 revision

File Reference

"이 기능을 고치려면 어떤 파일의 어떤 함수부터 보면 되는가" 에 답하는 포인터 맵이다. 모든 인용은 file:line 형식이고, 주요 변경 시 깨질 수 있으니 리팩터링 후에는 이 페이지도 갱신 대상이다.

Main Agent

관심사 파일 라인
Runtime bootstrap / topology 분기 src/coding_agent/runtime.py 17-58
Main Supervisor 조립 src/coding_agent/agent.py 298 (create_deep_agent 호출)
Main Agent middleware 순서 src/coding_agent/agent.py 302-307
System prompt 빌드 src/coding_agent/agent.py build_system_prompt(...)
Startup prewarm src/coding_agent/agent.py prewarm_coding_agent(...)
CLI 진입점 (Streamlit 실행) src/coding_agent/__main__.py 31-61

SubAgents

관심사 파일 라인
10개 기본 역할 정의 src/coding_agent/async_subagent_manager.py 32-160 (DEFAULT_ASYNC_SUBAGENTS)
Remember SubAgent system prompt src/coding_agent/async_subagent_manager.py 108-147
Config.toml 로딩 + 확장 src/coding_agent/async_subagent_manager.py 235 (load_async_subagents)
LocalAsyncSubagentManager.__init__ src/coding_agent/async_subagent_manager.py 337-348
Lazy spawn middleware src/coding_agent/middleware/lazy_async_subagents.py 74-90 (wrap_tool_call/awrap_tool_call)
start_async_task 식별 src/coding_agent/middleware/lazy_async_subagents.py 26
ensure_started 호출 src/coding_agent/middleware/lazy_async_subagents.py 53
Per-SubAgent create_deep_agent src/coding_agent/async_subagent_server.py 243-253
SubAgent 수명주기 middleware src/coding_agent/middleware/subagent_lifecycle.py —

Memory + HITL

관심사 파일 라인
LongTermMemoryMiddleware (auto inject) src/coding_agent/middleware/long_term_memory.py 67-77 (wrap_model_call)
memory_store tool src/coding_agent/middleware/long_term_memory.py 191
memory_correct tool src/coding_agent/middleware/long_term_memory.py 218
memory_search tool src/coding_agent/middleware/long_term_memory.py 242
CODE_PATTERNS → project/context 매핑 src/coding_agent/middleware/long_term_memory.py 88
ChromaDB 저장 src/coding_agent/memory/store.py 45-80
4개 카테고리 enum src/coding_agent/memory/categories.py 6-12
3계층 상수 src/coding_agent/state/store.py 15-19
DurableStateStore 진입점 src/coding_agent/state/store.py 22
memory_records 테이블 src/coding_agent/state/store.py 35
subagent_records 테이블 src/coding_agent/state/store.py 48
subagent_events 테이블 src/coding_agent/state/store.py 65
loop_runs 테이블 src/coding_agent/state/store.py 73
HITL: 후보 파싱 src/coding_agent/webui/_pages/chat.py 402 (_parse_remember_candidates_from_history)
HITL: 리뷰 폼 렌더링 src/coding_agent/webui/_pages/chat.py 502 (_render_remember_review_form)
HITL: 승인 후 저장 src/coding_agent/webui/_pages/chat.py 728 (_store_approved_memory_files)

Resilience / Model Fallback

관심사 파일 라인
POLICIES dict src/coding_agent/resilience.py 18-67
get_policy src/coding_agent/resilience.py 70
model_timeout policy src/coding_agent/resilience.py 19
no_progress_loop policy src/coding_agent/resilience.py 27
tool_call_error policy src/coding_agent/resilience.py 35
subagent_failure policy src/coding_agent/resilience.py 43
external_api_error policy src/coding_agent/resilience.py 51
safe_stop policy src/coding_agent/resilience.py 59
Model fallback middleware 등록 src/coding_agent/agent.py 302 (Main), async_subagent_server.py:243-253 (SubAgent)

WebUI + 질의 처리

관심사 파일 라인
Streamlit 앱 엔트리 src/coding_agent/webui/app.py —
Chat 페이지 (주요 오케스트레이션) src/coding_agent/webui/_pages/chat.py _stream_response, _resume_async_monitoring
Mermaid / 이벤트 타임라인 렌더링 src/coding_agent/webui/_pages/chat.py —
Workspace zip 다운로드 src/coding_agent/webui/_pages/chat.py —

LangGraph 원격 배포 (single topology)

관심사 파일 라인
Graph 엔트리 선언 langgraph.json (루트)
Graph 팩토리 src/coding_agent/graphs.py 64 (create_supervisor_graph), 92-96 (5개 export)
Remote adapter src/coding_agent/langgraph_remote.py —

테스트

관심사 파일
Runtime topology 분기 ETC/tests/test_runtime.py
System message helper ETC/tests/test_system_message_helper.py
SubAgent manager ETC/tests/test_async_subagent_manager.py
SubAgent server ETC/tests/test_async_subagent_server.py
Lazy spawn middleware ETC/tests/test_lazy_async_subagents.py
Code review workflow middleware ETC/tests/test_code_review_workflow.py
Resilience policies ETC/tests/test_resilience.py
State store ETC/tests/test_state_store.py
LangGraph registry sync ETC/tests/test_langgraph_registry.py

설정 / 환경

관심사 파일
패키지 메타 / 의존성 / dev extras pyproject.toml
환경변수 템플릿 .env.example
Docker 이미지 스펙 Dockerfile
Docker compose 서비스 docker-compose.yml
이미지에서 제외할 경로 .dockerignore
Streamlit 설정 .streamlit/config.toml

탐색 힌트 (자주 찾게 되는 심볼)

검색어 어디 있는지
create_deep_agent( Main: agent.py:298, SubAgent: async_subagent_server.py:243-253
start_async_task 정의는 DeepAgents 의존성 / 가로채기는 middleware/lazy_async_subagents.py:26
DurableStateStore state/store.py:22
ModelFallbackMiddleware Main 등록 agent.py:302, SubAgent 등록 async_subagent_server.py:243-253
POLICIES resilience.py:18
DEFAULT_ASYNC_SUBAGENTS async_subagent_manager.py:32-160
`user/profile project/context

Danny's Coding AI Agent

External

Clone this wiki locally