feat: Gemini Deep Research client (Task 3)

[codercatdev]

Summary

New service at lib/services/gemini-research.ts that uses the @google/genai Interactions API for autonomous web research, replacing the NotebookLM-based research pipeline.

What Changed

Single new file: lib/services/gemini-research.ts

Exports

Function	Description
submitResearch(topic, config?)	Submit a research query → returns interaction ID
pollResearch(interactionId)	Check status of a research interaction
parseResearchReport(topic, report)	Parse markdown report → structured ResearchPayload
conductGeminiResearch(topic, config?)	Full pipeline: submit → poll → parse

Types (re-exported for backward compat)

• ResearchPayload, ResearchSource, CodeExample, ComparisonData, SceneHint
• New: GeminiResearchConfig, ResearchStatus

SDK API Shape (verified against @google/genai v1.44.0)

The Interactions API uses:

• ai.interactions.create({ agent, input, background: true }) → Interaction
• ai.interactions.get(id) → Interaction
• Interaction.status: 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'incomplete'
• Interaction.outputs: Array<Content> (TextContent with .text field)

Design Decisions

1. All config from Sanity — agent model, prompt template, parsing model all via getConfigValue() with sensible defaults
2. Two-phase parsing — Gemini Flash extracts structured JSON from the report; falls back to regex-based extraction if parsing fails
3. Backward compatible — output matches existing ResearchPayload interface exactly
4. Fallback helpers — includes extractTalkingPoints, extractCodeExamples, classifyScene, generateSceneHints, classifySourceType copied from research.ts for the fallback path

Verification

• ✅ npx tsc --noEmit — zero errors on gemini-research.ts
• ✅ All imports resolve (@google/genai, @/lib/config, @/lib/gemini, ./research)
• ✅ No hardcoded model strings (all from config)
• ✅ No hardcoded prompt text (all from config with fallback defaults)
• ✅ Single file, single commit

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
codingcat-dev	Ignored		Mar 5, 2026 7:19pm