오케스트레이션

이 계층이 담당하는 것

agentic 루프가 일반적인 while-tool-use 기본 단위라면, 오케스트레이션은 도메인 특화 파이프라인을 위한 구조화된 그래프 계층입니다. 외부 도메인 플러그인의 분석, 멀티 에이전트 검증, 병렬 fan-out 모두 이곳에서 StateGraph로 연결됩니다.

파일

• core/orchestration/. StateGraph 조합 계층
• core/graph.py. 최상위 StateGraph 빌더 진입점
• core/state.py. GeodeState TypedDict (모든 노드가 받는 상태 형상)

파이프라인 형태

User input
    │
    ▼
Router (decompose)
    │
    ▼
[ Send API parallel fan-out ]
    │
    ├─► Analyst × N (parallel, identical state)
    │
    ▼
[ Reducer merge results ]
    │
    ▼
Evaluator → Verify → Synthesizer
    │
    ▼
Output

Send API 병렬화

LangGraph의 Send 기본 단위는 단일 노드가 격리된 상태로 여러 병렬 브랜치를 dispatch할 수 있게 해 줍니다. GEODE는 이를 analyst fan-out (플러그인 파이프라인의 analyst 병렬 실행)에 사용합니다.

Conditional edge

라우팅 결정은 노드가 아니라 엣지 위에 있습니다. verification 노드는 통과 시 synthesizer로 진행하고, 실패 시 해당 analyst로 되돌아갑니다.

Reducer

병렬 브랜치에 걸쳐 누적되는 state 필드 (analyst 결과, error 로그)는 reducer를 통해 병합됩니다. 이전 값과 새 값을 받아 결합된 값을 반환하는 타입화된 함수입니다.core/state.py가 필드별 reducer 타입을 선언합니다.