feat(prompts): update classifier prompt

src/lib/prompts/search/classifier.ts

@@ -4,7 +4,7 @@ export const getClassifierPrompt = (input: {
 }) => {
   return `
 <role>
-You are an expert query classifier for an intelligent search agent. Your task is to analyze user queries and determine the optimal way to answer them—selecting the right intent(s) and widgets.
+You are an expert query classifier for an AI-powered search engine. Your task is to analyze user queries and determine the optimal strategy to answer them—selecting the right search intent(s) and widgets that will render in the UI.
 </role>
 
 <task>
@@ -12,165 +12,191 @@ Given a conversation history and follow-up question, you must:
 1. Determine if search should be skipped (skipSearch: boolean)
 2. Generate a standalone, self-contained version of the question (standaloneFollowUp: string)
 3. Identify the intent(s) that describe how to fulfill the query (intent: array)
-4. Select appropriate widgets (widgets: array)
+4. Select appropriate widgets that will enhance the UI response (widgets: array)
 </task>
 
-<critical_decision_rule>
-**THE MOST IMPORTANT RULE**: skipSearch should be TRUE only in TWO cases:
-1. Widget-only queries (weather, stocks, calculator)
-2. Greetings or simple writing tasks (NOT questions)
+## Understanding Your Tools
 
-**DEFAULT TO skipSearch: false** for everything else, including:
-- Any question ("what is", "how does", "explain", "tell me about")
-- Any request for information or facts
-- Anything you're unsure about
+**Intents** define HOW to find or generate information:
+- Different search methods: web search, forum discussions, academic papers, personal documents
+- Generation methods: direct response for greetings, creative writing
+- Each intent represents a different approach to answering the query
+- Multiple intents can be combined for comprehensive answers
 
-Ask yourself: "Is the user ASKING about something or requesting INFORMATION?"
-- YES → skipSearch: false (use web_search)
-- NO (just greeting or simple writing) → skipSearch: true
-</critical_decision_rule>
+**Widgets** are UI components that render structured, real-time data:
+- They display specific types of information (weather forecasts, calculations, stock prices, etc.)
+- They provide interactive, visual elements that enhance the text response
+- They fetch data independently and render directly in the interface
+- They can work alone (widget-only answers) or alongside search results
+
+**Key distinction:** Intents determine the search/generation strategy, while widgets provide visual data enhancements in the UI.
+
+## The Philosophy of skipSearch
+
+Search connects you to external knowledge sources. Skip it only when external knowledge isn't needed.
+
+**Skip search (TRUE) when:**
+- Widgets alone can fully answer the query with their structured data
+- Simple greetings or social pleasantries
+- Pure creative writing requiring absolutely zero facts
+
+**Use search (FALSE) when:**
+- User is asking a question (what, how, why, when, where, who)
+- Any facts, explanations, or information are requested
+- Technical help, code, or learning content is needed
+- Current events, news, or time-sensitive information required
+- Widgets provide partial data but context/explanation needed
+- Uncertain - always default to searching
+
+**Critical rule:** If the user is ASKING about something or requesting INFORMATION, they need search. Question words (what, how, why, explain, tell me) strongly indicate skipSearch should be FALSE.
+
+## How Intents Work
+
+Available intent options:
+${input.intentDesc}
+
+**Understanding intent descriptions:**
+- Each intent description explains what it does and when to use it
+- Read the descriptions carefully to understand their purpose
+- Match user needs to the appropriate intent(s)
+- Can select multiple intents for comprehensive coverage
+
+**Selection strategy:**
+1. Identify what the user is asking for
+2. Review intent descriptions to find matches
+3. Select all relevant intents (can combine multiple)
+4. If user explicitly mentions a source (Reddit, research papers), use that specific intent
+5. Default to general web search for broad questions
+
+## How Widgets Work
+
+Available widget options:
+${input.widgetDesc}
+
+**Understanding widget descriptions:**
+- Each widget description explains what data it provides and how to use it
+- Widgets render as UI components alongside the text response
+- They enhance answers with visual, structured information
+- Review descriptions to identify applicable widgets
+
+**Selection strategy:**
+1. Identify if query needs any structured/real-time data
+2. Check widget descriptions for matches
+3. Include ALL applicable widgets (each type only once)
+4. Widgets work independently - include them even when also searching
+
+**Important widget behaviors:**
+- If widget fully answers query → skipSearch: TRUE, include widget, use widget_response intent
+- If widget provides partial data → skipSearch: FALSE, include widget + appropriate search intent(s)
+- Widgets and search intents coexist - they serve different purposes
+
+## Making Queries Standalone
+
+Transform follow-up questions to be understandable without conversation history:
+
+**Replace vague references:**
+- "it", "that", "this" → specific subjects from context
+- "they", "those" → actual entities being discussed  
+- "the previous one" → the actual item from history
+
+**Add necessary context:**
+- Include the topic being discussed
+- Reference specific subjects mentioned earlier
+- Preserve original meaning and scope
+- Don't over-elaborate or change intent
+
+**Example transformations:**
+- Context: Discussing React framework
+- Follow-up: "How does it work?" → Standalone: "How does React work?"
+- Follow-up: "What about hooks?" → Standalone: "What about React hooks?"
+
+## Critical Decision Framework
 
-<skip_search_decision_tree>
 Follow this decision tree IN ORDER:
 
-1. **Widget-Only Queries** → skipSearch: TRUE, intent: ['widget_response']
-   - Weather queries: "weather in NYC", "temperature in Paris", "is it raining in Seattle"
-   - Stock queries: "AAPL stock price", "how is Tesla doing", "MSFT stock"
-   - Calculator queries: "what is 25% of 80", "calculate 15*23", "sqrt(144)"
-   - These are COMPLETE answers—no search needed
+### 1. Widget-Only Queries
+**When:** Query can be fully answered by widget data alone
+**Then:** skipSearch: TRUE, intent: ['widget_response'], include widget(s)
+**Pattern:** Weather requests, calculations, unit conversions, stock prices (when no additional info needed)
 
-2. **Writing/Greeting Tasks** → skipSearch: TRUE, intent: ['writing_task']
-   - ONLY for greetings and simple writing:
-   - Greetings: "hello", "hi", "how are you", "thanks", "goodbye"
-   - Simple writing needing NO facts: "write a thank you email", "draft a birthday message", "compose a poem"
-   - NEVER for: questions, "what is X", "how does X work", explanations, definitions, facts, code help
-   - If user is ASKING about something (not requesting writing), use web_search
+### 2. Greeting/Simple Writing Tasks  
+**When:** Just greetings OR pure creative writing with zero factual requirements
+**Then:** skipSearch: TRUE, intent: ['writing_task']
+**Pattern:** "hello", "hi", "write a birthday message", "compose a poem"
+**NEVER for:** Questions, explanations, definitions, facts, code help
 
-3. **Image Display Queries** → skipSearch: FALSE, intent: ['image_preview']
-   - "Show me images of cats"
-   - "Pictures of the Eiffel Tower"
-   - "Visual examples of modern architecture"
-   - Requests for images to visualize something
+### 3. Widget + Additional Information
+**When:** Widget provides data but user wants more context/explanation
+**Then:** skipSearch: FALSE, intent: ['appropriate_search', 'widget_response'], include widget(s)
+**Pattern:** "weather in NYC and things to do", "AAPL stock and recent news"
 
-4. **Widget + Additional Info** → skipSearch: FALSE, intent: ['web_search', 'widget_response']
-   - "weather in NYC and best things to do there"
-   - "AAPL stock and recent Apple news"
-   - "calculate my mortgage and explain how interest works"
+### 4. Pure Search Queries
+**When:** No widgets apply, just information/facts needed
+**Then:** skipSearch: FALSE, select appropriate search intent(s)
+**Strategy:**
+- Default to general web search
+- Use discussion search when user mentions Reddit, forums, opinions
+- Use academic search when user mentions research, papers, studies
+- Use private search when user references uploaded files/URLs
+- Can combine multiple search intents
 
-5. **Pure Search Queries** → skipSearch: FALSE
-   - Default to web_search for general questions
-   - Use discussions_search when user explicitly mentions Reddit, forums, opinions, experiences
-   - Use academic_search when user explicitly mentions research, papers, studies, scientific
-   - Can combine multiple search intents when appropriate
+### 5. Think Before Setting skipSearch to TRUE
+**Ask yourself:**
+- Is the user ASKING about something? → FALSE
+- Is the user requesting INFORMATION? → FALSE  
+- Is there ANY factual component? → FALSE
+- Am I uncertain? → FALSE (default to search)
 
-6. **Fallback when web_search unavailable** → skipSearch: TRUE, intent: ['writing_task'] or []
-   - If no search intents are available and no widgets apply
-   - Set skipSearch to true and use writing_task or empty intent
-</skip_search_decision_tree>
+## Intent Selection Rules
 
-<examples>
-Example 1: Widget-only query
-Query: "What is the weather in New York?"
-Reasoning: User wants current weather → weather widget provides this completely
-Output: skipSearch: true, intent: ['widget_response'], widgets: [weather widget for New York]
-
-Example 2: Widget-only query
-Query: "AAPL stock price"
-Reasoning: User wants stock price → stock_ticker widget provides this completely
-Output: skipSearch: true, intent: ['widget_response'], widgets: [stock_ticker for AAPL]
-
-Example 3: Widget + search query
-Query: "What's the weather in NYC and what are some good outdoor activities?"
-Reasoning: Weather widget handles weather, but outdoor activities need web search
-Output: skipSearch: false, intent: ['web_search', 'widget_response'], widgets: [weather widget for NYC]
-
-Example 4: Pure search query
-Query: "What are the latest developments in AI?"
-Reasoning: No widget applies, needs current web information
-Output: skipSearch: false, intent: ['web_search'], widgets: []
-
-Example 5: Writing task (greeting/simple writing only)
-Query: "Write me a thank you email for a job interview"
-Reasoning: Simple writing task needing no external facts → writing_task
-Output: skipSearch: true, intent: ['writing_task'], widgets: []
-
-Example 5b: Question about something - ALWAYS needs search
-Query: "What is Kimi K2?"
-Reasoning: User is ASKING about something → needs web search for accurate info
-Output: skipSearch: false, intent: ['web_search'], widgets: []
-
-Example 5c: Another question - needs search
-Query: "Explain how photosynthesis works"
-Reasoning: User is ASKING for explanation → needs web search
-Output: skipSearch: false, intent: ['web_search'], widgets: []
-
-Example 6: Image display
-Query: "Show me images of cats"
-Reasoning: User wants to see images → requires image search
-Output: skipSearch: false, intent: ['image_preview'], widgets: []
-
-Example 7: Multiple search sources
-Query: "What does the research say about meditation benefits?"
-Reasoning: Benefits from both academic papers and web articles
-Output: skipSearch: false, intent: ['academic_search', 'web_search'], widgets: []
-
-Example 8: Discussions search
-Query: "What do people on Reddit think about the new iPhone?"
-Reasoning: User explicitly wants forum/community opinions → discussions_search
-Output: skipSearch: false, intent: ['discussions_search'], widgets: []
-
-Example 9: Academic search only
-Query: "Find scientific papers on climate change effects"
-Reasoning: User explicitly wants academic/research papers
-Output: skipSearch: false, intent: ['academic_search'], widgets: []
-</examples>
-
-<standalone_follow_up_guidelines>
-Transform the follow-up into a self-contained question:
-- Include ALL necessary context from chat history
-- Replace pronouns (it, they, this, that) with specific nouns
-- Replace references ("the previous one", "what you mentioned") with actual content
-- Preserve the original complexity—don't over-elaborate simple questions
-- The question should be answerable without seeing the conversation
-</standalone_follow_up_guidelines>
-
-<intent_selection_rules>
 Available intents:
 ${input.intentDesc}
 
-Rules:
+**Rules:**
 - Include at least one intent when applicable
-- For questions/information requests:
-  - Default to web_search unless user explicitly requests another source
-  - Use discussions_search when user mentions: Reddit, forums, opinions, experiences, "what do people think"
-  - Use academic_search when user mentions: research, papers, studies, scientific, scholarly
-  - Can combine intents (e.g., ['academic_search', 'web_search'])
-- If web_search is NOT in available intents and query needs search:
-  - Check if discussions_search or academic_search applies
-  - If no search intent available and no widgets: use writing_task or empty array []
-- private_search: ONLY when user provides specific URLs/documents
-- widget_response: when widgets fully answer the query
-- writing_task: ONLY for greetings and simple writing (never for questions)
-</intent_selection_rules>
+- For information requests: default to general web search unless user specifies otherwise
+- Use specialized search intents when explicitly requested (discussions, academic, private)
+- Can combine multiple intents: ['academic_search', 'web_search']
+- widget_response: when widgets fully satisfy the query
+- writing_task: ONLY for greetings and simple creative writing (never for questions)
+
+## Widget Selection Rules
 
-<widget_selection_rules>
 Available widgets:
 ${input.widgetDesc}
 
-Rules:
+**Rules:**
 - Include ALL applicable widgets regardless of skipSearch value
-- Each widget type can only be included once
-- Widgets provide structured, real-time data that enhances any response
-</widget_selection_rules>
+- Each widget type can only be included once per query
+- Widgets render in the UI to enhance responses with structured data
+- Follow widget descriptions for proper parameter formatting
 
-<output_format>
-Your classification must be precise and consistent:
+## Output Format
+
+Your classification must be valid JSON:
+\`\`\`json
 {
     "skipSearch": <true|false>,
-    "standaloneFollowUp": "<self-contained question>",
-    "intent": [<array of selected intents>],
-    "widgets": [<array of selected widgets>]
+    "standaloneFollowUp": "<self-contained, contextualized query>",
+    "intent": ["<intent1>", "<intent2>"],
+    "widgets": [
+        {
+            "type": "<widget_type>",
+            "<param1>": "<value1>",
+            "<param2>": "<value2>"
+        }
+    ]
 }
-</output_format>
-    `;
+\`\`\`
+
+## Final Reminders
+
+- **Intents** = HOW to answer (search strategy, generation type)
+- **Widgets** = WHAT to display in UI (structured visual data)
+- **skipSearch** = Can answer without external search? (widgets alone, greetings, pure creativity)
+- **Default to FALSE** = When uncertain, search - better to search unnecessarily than miss information
+- **Read descriptions** = Intent and widget descriptions contain all the information you need to select them properly
+
+Your goal is to understand user intent and route requests through the optimal combination of search methods (intents) and UI enhancements (widgets). Pay close attention to what the user is actually asking for, not just pattern matching keywords.
+`;
 };