How navinsreejithprep/pib-rag-agent works
The repository contains two user-facing products: Executive Media Intelligence, which turns a question into a verified, cited executive brief, and DocQuery, which indexes uploaded PDFs for document Q&A. The media product’s fixed pipeline and bounded autonomous research mode share downstream synthesis and verification; PDF evidence can also enter media research. The graph follows documented and indexed module relationships; some UI-to-endpoint and unsampled subsystem links rely on README descriptions rather than inspected route bodies.
Main entry points: media/orchestrator.ts Fixed orchestrator · agent/orchestrator.ts Agent orchestrator · route.ts PIB ingestion API · rag.ts Document retrieval and Q&A
Components 24
Media intelligence
- Media dashboard
components/media-dashboard.tsx - Media query API
app/api/media/query/route.ts - Fixed orchestrator
lib/media/orchestrator.ts - Query understanding
lib/media/tools/intent.ts - Evidence search
lib/media/tools/search.ts - Event clustering
lib/media/tools/cluster.ts - Source comparison
lib/media/tools/compare.ts - Impact analysis
lib/media/tools/impact.ts - Brief generation
lib/media/tools/brief.ts - Citation verification
lib/media/tools/verify.ts
Autonomous research
- Agent API
app/api/media/agent/route.ts - Agent orchestrator
lib/media/agent/orchestrator.ts - Research loop
lib/media/agent/loop.ts
Evidence ingestion
- Media evidence store
lib/media/store.ts - PIB releases
lib/media/sources/pib.ts - PIB ingestion API
app/api/media/ingest-pib/route.ts
DocQuery
- DocQuery interface
components/rag-app.tsx - PDF ingestion API
app/api/ingest/route.ts - Document store
lib/store.ts - Document retrieval and Q&A
lib/rag.ts
Shared services
- OpenAI client
lib/openai.ts
Other components
- Analyst
- OpenAI
- Executive brief
Connections 32
- Analyst → Media dashboard: asks question
- Media dashboard → Media query API: submits query
- Media query API → Fixed orchestrator: runs pipeline
app/api/media/query/route.ts - Fixed orchestrator → Query understanding: classifies query
lib/media/orchestrator.ts - Fixed orchestrator → Evidence search: searches evidence
lib/media/orchestrator.ts - Fixed orchestrator → Event clustering: clusters results
lib/media/orchestrator.ts - Fixed orchestrator → Source comparison: compares sources
lib/media/orchestrator.ts - Fixed orchestrator → Impact analysis: analyzes impact
lib/media/orchestrator.ts - Fixed orchestrator → Brief generation: generates brief
lib/media/orchestrator.ts - Fixed orchestrator → Citation verification: verifies citations
lib/media/orchestrator.ts - Fixed orchestrator → Executive brief: streams result
- Evidence search → Media evidence store: searches items
lib/media/tools/search.ts - Evidence search → Document retrieval and Q&A: searches PDFs
lib/media/tools/search.ts - PIB ingestion API → PIB releases: fetches releases
app/api/media/ingest-pib/route.ts - PIB ingestion API → OpenAI client: embeds text
app/api/media/ingest-pib/route.ts - PIB ingestion API → Media evidence store: seeds evidence
app/api/media/ingest-pib/route.ts - Media dashboard → PIB ingestion API: triggers pull
app/api/media/ingest-pib/route.ts - Analyst → Agent API: requests research
- Agent API → Agent orchestrator: runs agent flow
app/api/media/agent/route.ts - Agent orchestrator → Research loop: gathers evidence
lib/media/agent/orchestrator.ts - Agent orchestrator → Event clustering: clusters results
lib/media/agent/orchestrator.ts - Agent orchestrator → Source comparison: compares sources
lib/media/agent/orchestrator.ts - Agent orchestrator → Impact analysis: analyzes impact
lib/media/agent/orchestrator.ts - Agent orchestrator → Brief generation: generates brief
lib/media/agent/orchestrator.ts - Agent orchestrator → Citation verification: verifies citations
lib/media/agent/orchestrator.ts - DocQuery interface → PDF ingestion API: uploads PDF
- PDF ingestion API → OpenAI client: embeds chunks
app/api/ingest/route.ts - PDF ingestion API → Document store: stores chunks
app/api/ingest/route.ts - DocQuery interface → Document retrieval and Q&A: asks document question
- Document retrieval and Q&A → Document store: retrieves chunks
lib/rag.ts - Document retrieval and Q&A → OpenAI client: embeds and answers
lib/rag.ts - OpenAI client → OpenAI: calls models
lib/openai.ts