axflow/
├── client.py        # AXFlowClient — 검색·인입·그래프 진입점
├── ingest/          # 파일 인입 파이프라인
├── search/          # retriever 호출 래퍼
├── graph/           # 노드·엣지 조회/편집
└── governance/      # 권한·출처 메타 헬퍼

# 개념 예시. 실제 시그니처는 PoC 착수 시 함께 동기화한다.
from axflow import AXFlowClient
 
client = AXFlowClient(
    server="https://<host>",
    client_id="host-agent",
    client_secret="<client-secret>",
    scope="rag:read rag:write",
)
# SDK 가 내부에서 /api/v1/user/auth/token 호출 + access_token 갱신을 자동 처리
 
# 인입
job = client.ingest.upload("/path/to/contract.pdf", labels=["contract"])
client.ingest.wait(job.id)
 
# 검색 (retriever 와 동일 시그니처)
result = client.search.retriever(
    query="2026 1분기 NDA 만료일",
    mode="deep",      # smart | deep
    top_k=10,
)
print(result.content, result.score)
 
# 그래프
node = client.graph.get_entity("KakaoPay")

# 예 — RetrieverRequest 모델 (단일 정의 → 다중 노출면)
class RetrieverRequest(BaseModel):
    query: Annotated[str, Field(min_length=1, description="자연어 질의")]
    mode: Annotated[
        Literal["smart", "deep"],
        Field(description="smart: 균형(~0.9s). deep: 정밀(~3.2s), 재정렬 점수 채움."),
    ] = "smart"
    top_k: Annotated[int, Field(ge=1, le=100, description="그래프 엔티티·관계 최대 수")] = 10
    # ... 이하 2.2 표와 동일