Deep Research workflow

Research runs on the main agent loop with the deep-research skill preloaded. The shared directive in apps/agent/src/deep-research/index.ts binds explicit research turns to the workflow and requires a report file. The stages are scope, plan, collect, analyze, synthesize and deliver; evidence can lead the agent to revisit earlier stages.

Deep Research adjusts collection depth to the question's complexity, evidence gaps and intended use. It checks sources, counter-evidence, comparisons and uncertainty. The number of research goals, chapters and useful visuals follows the task; there are no fixed quotas. A brief answer can still require extensive verification.

Use the Deep Research control in Chat, or enter /deep <topic> for one research turn. /deep-research and /dr are aliases. Without a topic, these commands toggle Deep Research on or off for ordinary turns. No depth selection is needed.

minara research "BTC ETF flows this quarter"

Chat requests enable research with deep_research: { enabled: true }; omit it for an ordinary turn. Per-session settings store deepResearchEnabled, and session_mode.deep_research_enabled carries the composer toggle. Turn metadata preserves the research state for Retry. Plan Mode and Deep Research are mutually exclusive.

{ "message": "Compare gold and BTC", "deep_research": { "enabled": true } }

POST /v1/research:

{ "topic": "BTC ETF flows this quarter" }

The skill writes the report source to a file and uses render_report for rendered formats. It preserves the requested language, length and format. Research using the playbook through ordinary skill routing can finish with a cited chat answer; an explicit Deep Research entry point requires a report file.

The workflow lives in apps/agent/src/skills/builtin/deep-research/SKILL.md. The compact references/research-guidance.md covers evidence planning and review, with separate domain references read only when relevant. Report structure and rendering live in references/report-shape.md. There is no separate depth profile or fixed collection budget.