Guided first task: context-aware onboarding prompt after setup completes

[kovtcharov]

Summary

After setup completes, don't drop the user at a blank prompt. Offer a guided first experience tailored to what was just installed, ensuring the user's first interaction is successful and demonstrates GAIA's value.

Design

Context-Aware First Tasks

Installed Agents	Suggested First Task
Chat + RAG	"Drop a PDF here and ask a question about it" + sample PDF link
Code	"Describe a small program — try: 'Build a Python script that converts CSV to JSON'"
Chat + Talk	"Click the mic button and say 'Hello, what can you do?'"
Docker	"I can see your running containers. Try: 'Show me my Docker containers'"
Jira	"Try: 'Show me my open Jira tickets'"
Blender	"Try: 'Create a 3D scene with a red cube and blue sphere'"
SD	"Try: 'Generate an image of a sunset over mountains'"
Minimal	"Try: 'What is GAIA?' — then explore `gaia setup` for more capabilities"

Implementation

def get_first_task_suggestions(installed_agents: List[str]) -> List[dict]:
    """Generate contextual first-task suggestions based on installed agents."""
    suggestions = []
    for agent_name in installed_agents:
        manifest = registry.get(agent_name)
        suggestions.append({
            "agent": agent_name,
            "prompt": manifest.first_task_prompt,
            "description": manifest.first_task_description,
            "demo_file": manifest.demo_file_url,  # Optional sample document
        })
    return suggestions[:4]  # Show top 4 most relevant

Manifest Extension

Add optional `first_task` section to agent manifest:

first_task:
  prompt: "Summarize this document for me"
  description: "Drop a PDF and ask questions about it"
  demo_file: "https://amd-gaia.ai/samples/sample-report.pdf"

Files to Modify

• `src/gaia/agents/base/manifest.py` (MODIFY) — Add `first_task` field
• `src/gaia/agents/*/agent.yml` (MODIFY) — Add first_task to each manifest
• `src/gaia/apps/chat/webui/src/components/WelcomeScreen.tsx` (MODIFY) — Dynamic suggestions
• `src/gaia/apps/chat/webui/src/components/onboarding/CompleteStep.tsx` (MODIFY) — Show first tasks

Acceptance Criteria

• First-task suggestions match installed agents
• Each suggestion is actionable and demonstrates core capability
• Chat UI displays suggestions as clickable cards
• Clicking a suggestion pre-fills the prompt
• CLI mode prints suggestions after setup
• At least 1 suggestion works out-of-the-box without additional user setup

Depends On

• Issue NPU Linux support #9 (Chat UI Wizard)