# Theo · Deep Research

> A multi-step research pipeline that plans queries, fetches sources in parallel, deduplicates, and synthesizes a cited markdown report. Built for prompts that demand grounded answers, not hallucinations.

Source of truth: https://hitheo.ai. Last updated: 2026-05-24.

## At a glance
- Pipeline: plan → search → deduplicate → synthesize.
- Plan stage: a fast reasoning model produces 3–6 focused search queries from the operator's topic.
- Search stage: queries run in parallel through a web search backend, advanced depth, ~8 results per query.
- Deduplicate by URL.
- Synthesize: a reasoning model writes a structured markdown report with inline source citations.

## Domain enrichment
When a domain or URL is detected in the user prompt, the research engine optionally enriches with brand / product / styleguide metadata. Mode-aware: code / build / image surfaces request styleguide data; research / reason surfaces request product + scraping context.

## API
- Endpoint: POST /api/v1/completions with mode "research", or rely on the routing engine to promote a research-shaped prompt ("cite sources", "compare", "investigate", "find references for").
- Body fields: prompt (required), depth (basic / advanced; optional), max_sources (optional).
- Response: streaming SSE with progress events ("planning" → "searching" → "synthesizing" → "complete") and a final synthesis artifact.

## Open loops
A research turn writes a chain into the memory graph (kind = "search", outcome = "resolved"). Any unresolved threads land as open loops surfaced on the next conversation. See https://hitheo.ai/llms/memory.txt.

## Related machine-readable files
- https://hitheo.ai/llms.txt — full index of every Theo machine-readable file.
- https://hitheo.ai/llms-full.txt — long-form knowledge bundle (single fetch).
- https://hitheo.ai/humans.txt — team and open-source credits.
- https://hitheo.ai/lawyers.txt — trademark notice and legal contact.
- https://hitheo.ai/.well-known/security.txt — security disclosure contact.