High-level layout (refer to Architecture Overview for component roles):
src/aiq_agent/
├── agents/ # Chat researcher, shallow/deep research, clarifier
│ ├── chat_researcher/ # Orchestrator, orchestration node (intent + meta + depth), nodes
│ ├── shallow_researcher/
│ ├── deep_researcher/ # See src/aiq_agent/agents/deep_researcher/README.md
│ └── clarifier/
├── common/ # LLM provider, callbacks, prompt utils, data_sources
├── knowledge/ # Schema, factory, base retriever/ingestor, summary store
├── observability/ # OpenTelemetry header redaction exporter
├── auth/ # Auth utilities
└── fastapi_extensions/ # API route extensions
Configs live in configs/; refer to the Customization guide for configuration options. Frontends: frontends/cli, frontends/aiq_api, frontends/debug, frontends/ui. Benchmarks: frontends/benchmarks/. Data sources and Knowledge Layer: sources/.