Code Organization

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/.