@vinaes/succ 1.3.22 → 1.4.0

package/dist/mcp/tools/web-search.js

@@ -1,10 +1,5 @@
 /**
- * MCP Web Search tools via OpenRouter (Perplexity, Grok, and other search-capable models)
- *
- * - succ_quick_search: Fast, cheap search (default: Perplexity Sonar)
- * - succ_web_search: Quality search (default: Perplexity Sonar Pro)
- * - succ_deep_research: Multi-step deep research (default: Perplexity Sonar Deep Research)
- * - succ_web_search_history: Browse and filter past web search history
+ * MCP Web Search tool — succ_web with actions: quick, search, deep, history
  *
  * Models are configurable via web_search.* config keys. Any OpenRouter model
  * with :online suffix supports web search (e.g., x-ai/grok-3:online).
@@ -13,6 +8,7 @@ import { z } from 'zod';
 import { getWebSearchConfig } from '../../lib/config.js';
 import { isApiConfigured, callOpenRouterSearch, } from '../../lib/llm.js';
 import { projectPathParam, applyProjectPath } from '../helpers.js';
+import { gateAction } from '../profile.js';
 import { recordWebSearch, getTodayWebSearchSpend, getWebSearchHistory, getWebSearchSummary, } from '../../lib/storage/index.js';
 import { logWarn } from '../../lib/fault-logger.js';
 // Approximate pricing per 1M tokens (USD) — OpenRouter models with web search
@@ -77,7 +73,7 @@ async function checkBudget(dailyBudget) {
     try {
         const spent = await getTodayWebSearchSpend();
         if (spent >= dailyBudget) {
-            return `Daily web search budget exceeded ($${spent.toFixed(4)} / $${dailyBudget}). Reset tomorrow or increase with: succ_config_set key="web_search.daily_budget_usd" value="..."`;
+            return `Daily web search budget exceeded ($${spent.toFixed(4)} / $${dailyBudget}). Reset tomorrow or increase with: succ_config(action="set", key="web_search.daily_budget_usd", value="...")`;
         }
     }
     catch (err) {
@@ -146,281 +142,286 @@ async function saveResultToMemory(query, content, citations, toolName, type) {
     }
 }
 export function registerWebSearchTools(server) {
-    // succ_quick_search — cheapest, fastest web search
-    server.tool('succ_quick_search', 'Quick, cheap web search via OpenRouter (default: Perplexity Sonar, ~$1/MTok). Best for simple factual queries: version numbers, release dates, quick lookups. Configure model with web_search.quick_search_model. Requires OPENROUTER_API_KEY.', {
-        query: z
-            .string()
-            .describe('Simple factual query (e.g., "latest Node.js LTS version", "TypeScript 5.8 release date")'),
-        system_prompt: z
-            .string()
-            .optional()
-            .describe('Optional system prompt to guide response format'),
-        max_tokens: z.number().optional().describe('Max response tokens (default: 2000)'),
-        save_to_memory: z
-            .boolean()
-            .optional()
-            .describe('Save result to succ memory (default: from config)'),
-        project_path: projectPathParam,
-    }, async ({ query, system_prompt, max_tokens, save_to_memory, project_path }) => {
-        await applyProjectPath(project_path);
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'API key not configured. Set OPENROUTER_API_KEY environment variable or run:\nsucc_config_set key="llm.api_key" value="sk-or-..."',
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const wsConfig = getWebSearchConfig();
-        if (!wsConfig.enabled) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Web search is disabled. Enable with: succ_config_set key="web_search.enabled" value="true"',
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const budgetError = await checkBudget(wsConfig.daily_budget_usd);
-        if (budgetError)
-            return { content: [{ type: 'text', text: budgetError }], isError: true };
-        try {
-            const messages = [];
-            if (system_prompt) {
-                messages.push({ role: 'system', content: system_prompt });
-            }
-            messages.push({ role: 'user', content: query });
-            const effectiveModel = wsConfig.quick_search_model;
-            const result = await callOpenRouterSearch(messages, effectiveModel, wsConfig.quick_search_timeout_ms, max_tokens || wsConfig.quick_search_max_tokens, wsConfig.temperature);
-            const cost = estimateCost(result.usage, effectiveModel);
-            await recordSearchToDb('succ_quick_search', effectiveModel, query, result.usage, cost, result.citations, false, result.content.length);
-            const todaySpent = wsConfig.daily_budget_usd > 0 ? await getTodayWebSearchSpend() : 0;
-            let text = result.content;
-            text += formatCitations(result.citations, result.search_results);
-            text += formatUsage(result.usage, cost, wsConfig.daily_budget_usd, todaySpent);
-            const shouldSave = save_to_memory ?? wsConfig.save_to_memory;
-            if (shouldSave) {
-                text += await saveResultToMemory(query, result.content, result.citations, 'succ_quick_search', 'observation');
-            }
-            return { content: [{ type: 'text', text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: 'text', text: `Quick search failed: ${error.message}` }],
-                isError: true,
-            };
-        }
-    });
-    // succ_web_search — fast real-time web search
-    server.tool('succ_web_search', 'Web search via OpenRouter (default: Perplexity Sonar Pro). Higher quality than succ_quick_search. Use for complex queries, documentation lookups, multi-faceted questions. Returns answers with citations. Alternatives: x-ai/grok-3:online, google/gemini-2.0-flash-001:online, or any model with :online suffix. Requires OPENROUTER_API_KEY.', {
-        query: z
-            .string()
-            .describe('The search query (e.g., "latest React 19 features", "how to configure nginx reverse proxy")'),
-        model: z
-            .string()
-            .optional()
-            .describe('Override search model. Default from config (perplexity/sonar-pro). Perplexity: sonar, sonar-pro, sonar-reasoning-pro. Grok: x-ai/grok-3:online, x-ai/grok-3-mini:online. Any OpenRouter model with :online suffix supports web search.'),
-        system_prompt: z
-            .string()
-            .optional()
-            .describe('Optional system prompt to guide the response format or focus'),
-        max_tokens: z.number().optional().describe('Max response tokens (default: 4000)'),
-        save_to_memory: z
-            .boolean()
-            .optional()
-            .describe('Save result to succ memory (default: from config)'),
-        project_path: projectPathParam,
-    }, async ({ query, model, system_prompt, max_tokens, save_to_memory, project_path }) => {
-        await applyProjectPath(project_path);
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'API key not configured. Set OPENROUTER_API_KEY environment variable or run:\nsucc_config_set key="llm.api_key" value="sk-or-..."',
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const wsConfig = getWebSearchConfig();
-        if (!wsConfig.enabled) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'Web search is disabled. Enable with: succ_config_set key="web_search.enabled" value="true"',
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const budgetError = await checkBudget(wsConfig.daily_budget_usd);
-        if (budgetError)
-            return { content: [{ type: 'text', text: budgetError }], isError: true };
-        const effectiveModel = model || wsConfig.model;
-        try {
-            const messages = [];
-            if (system_prompt) {
-                messages.push({ role: 'system', content: system_prompt });
-            }
-            messages.push({ role: 'user', content: query });
-            const result = await callOpenRouterSearch(messages, effectiveModel, wsConfig.timeout_ms, max_tokens || wsConfig.max_tokens, wsConfig.temperature);
-            const cost = estimateCost(result.usage, effectiveModel);
-            await recordSearchToDb('succ_web_search', effectiveModel, query, result.usage, cost, result.citations, false, result.content.length);
-            const todaySpent = wsConfig.daily_budget_usd > 0 ? await getTodayWebSearchSpend() : 0;
-            let text = result.content;
-            text += formatCitations(result.citations, result.search_results);
-            text += formatUsage(result.usage, cost, wsConfig.daily_budget_usd, todaySpent);
-            const shouldSave = save_to_memory ?? wsConfig.save_to_memory;
-            if (shouldSave) {
-                text += await saveResultToMemory(query, result.content, result.citations, 'succ_web_search', 'observation');
-            }
-            return { content: [{ type: 'text', text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: 'text', text: `Web search failed: ${error.message}` }],
-                isError: true,
-            };
-        }
-    });
-    // succ_deep_research — expensive multi-step research
-    server.tool('succ_deep_research', 'Deep multi-step web research via OpenRouter (default: Perplexity Sonar Deep Research). Autonomously searches, reads, and synthesizes multiple sources. WARNING: Significantly more expensive and slower than succ_web_search (30-120s, runs 30+ searches). Configure model with web_search.deep_research_model. Requires OPENROUTER_API_KEY.', {
-        query: z
-            .string()
-            .describe('The research question (e.g., "Compare React Server Components vs Astro Islands for e-commerce")'),
-        system_prompt: z
-            .string()
-            .optional()
-            .describe('Optional system prompt to guide research focus or output format'),
-        max_tokens: z.number().optional().describe('Max response tokens (default: 8000)'),
-        include_reasoning: z
-            .boolean()
-            .optional()
-            .describe("Include the model's internal reasoning process (default: false)"),
-        save_to_memory: z
-            .boolean()
-            .optional()
-            .describe('Save result to succ memory (default: from config)'),
-        project_path: projectPathParam,
-    }, async ({ query, system_prompt, max_tokens, include_reasoning, save_to_memory, project_path, }) => {
+    server.registerTool('succ_web', {
+        description: 'Web search via OpenRouter (Perplexity, Grok, Gemini). Supports quick lookups, quality search, deep multi-step research, and search history.\n\nExamples:\n- Quick: succ_web(action="quick", query="Node.js 22 LTS release date")\n- Search: succ_web(query="React 19 best practices")\n- Deep: succ_web(action="deep", query="Compare React vs Astro for e-commerce")\n- History: succ_web(action="history", limit=5)',
+        inputSchema: {
+            action: z
+                .enum(['quick', 'search', 'deep', 'history'])
+                .optional()
+                .default('search')
+                .describe('quick = fast factual lookup (~$1/MTok), search = quality search (Sonar Pro), deep = multi-step research (30-120s, expensive), history = past searches'),
+            query: z.string().optional().describe('Search query (required for quick, search, deep)'),
+            system_prompt: z.string().optional().describe('Optional system prompt to guide response'),
+            max_tokens: z.number().optional().describe('Max response tokens'),
+            save_to_memory: z
+                .boolean()
+                .optional()
+                .describe('Save result to succ memory (default: from config)'),
+            model: z
+                .string()
+                .optional()
+                .describe('Override search model (for search) or filter by model (for history)'),
+            include_reasoning: z
+                .boolean()
+                .optional()
+                .describe("Include model's reasoning process (for deep)"),
+            // history filters
+            tool_name: z
+                .enum(['succ_quick_search', 'succ_web_search', 'succ_deep_research'])
+                .optional()
+                .describe('Filter by original tool name (for history, uses DB column values)'),
+            query_text: z.string().optional().describe('Filter by query substring (for history)'),
+            date_from: z.string().optional().describe('Start date ISO (for history)'),
+            date_to: z.string().optional().describe('End date ISO (for history)'),
+            limit: z.number().optional().describe('Max records (for history, default: 20)'),
+            project_path: projectPathParam,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ action = 'search', query, system_prompt, max_tokens, save_to_memory, model, include_reasoning, tool_name, query_text, date_from, date_to, limit, project_path, }) => {
         await applyProjectPath(project_path);
-        if (!isApiConfigured()) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: 'API key not configured. Set OPENROUTER_API_KEY environment variable or run:\nsucc_config_set key="llm.api_key" value="sk-or-..."',
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const wsConfig = getWebSearchConfig();
-        if (!wsConfig.enabled) {
+        const gated = gateAction('succ_web', action);
+        if (gated)
+            return gated;
+        // Shared validation for search actions
+        if (['quick', 'search', 'deep'].includes(action) && !query) {
             return {
                 content: [
                     {
                         type: 'text',
-                        text: 'Web search is disabled. Enable with: succ_config_set key="web_search.enabled" value="true"',
+                        text: `"query" is required for action="${action}"`,
                     },
                 ],
                 isError: true,
             };
         }
-        const budgetError = await checkBudget(wsConfig.daily_budget_usd);
-        if (budgetError)
-            return { content: [{ type: 'text', text: budgetError }], isError: true };
-        try {
-            const messages = [];
-            if (system_prompt) {
-                messages.push({ role: 'system', content: system_prompt });
-            }
-            messages.push({ role: 'user', content: query });
-            const result = await callOpenRouterSearch(messages, wsConfig.deep_research_model, wsConfig.deep_research_timeout_ms, max_tokens || wsConfig.deep_research_max_tokens, wsConfig.temperature);
-            const cost = estimateCost(result.usage, wsConfig.deep_research_model);
-            await recordSearchToDb('succ_deep_research', wsConfig.deep_research_model, query, result.usage, cost, result.citations, !!result.reasoning, result.content.length);
-            const todaySpent = wsConfig.daily_budget_usd > 0 ? await getTodayWebSearchSpend() : 0;
-            let text = '';
-            if (include_reasoning && result.reasoning) {
-                text += `**Reasoning Process:**\n${result.reasoning}\n\n---\n\n`;
+        switch (action) {
+            case 'quick': {
+                if (!isApiConfigured()) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'API key not configured. Set OPENROUTER_API_KEY environment variable or run:\nsucc_config(action="set", key="llm.api_key", value="sk-or-...")',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const wsConfig = getWebSearchConfig();
+                if (!wsConfig.enabled) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Web search is disabled. Enable with: succ_config(action="set", key="web_search.enabled", value="true")',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const budgetError = await checkBudget(wsConfig.daily_budget_usd);
+                if (budgetError)
+                    return { content: [{ type: 'text', text: budgetError }], isError: true };
+                try {
+                    const messages = [];
+                    if (system_prompt) {
+                        messages.push({ role: 'system', content: system_prompt });
+                    }
+                    messages.push({ role: 'user', content: query });
+                    const effectiveModel = wsConfig.quick_search_model;
+                    const result = await callOpenRouterSearch(messages, effectiveModel, wsConfig.quick_search_timeout_ms, max_tokens || wsConfig.quick_search_max_tokens, wsConfig.temperature);
+                    const cost = estimateCost(result.usage, effectiveModel);
+                    await recordSearchToDb('succ_quick_search', effectiveModel, query, result.usage, cost, result.citations, false, result.content.length);
+                    const todaySpent = wsConfig.daily_budget_usd > 0 ? await getTodayWebSearchSpend() : 0;
+                    let text = result.content;
+                    text += formatCitations(result.citations, result.search_results);
+                    text += formatUsage(result.usage, cost, wsConfig.daily_budget_usd, todaySpent);
+                    const shouldSave = save_to_memory ?? wsConfig.save_to_memory;
+                    if (shouldSave) {
+                        text += await saveResultToMemory(query, result.content, result.citations, 'succ_quick_search', 'observation');
+                    }
+                    return { content: [{ type: 'text', text }] };
+                }
+                catch (error) {
+                    return {
+                        content: [{ type: 'text', text: `Quick search failed: ${error.message}` }],
+                        isError: true,
+                    };
+                }
             }
-            text += result.content;
-            text += formatCitations(result.citations, result.search_results);
-            text += formatUsage(result.usage, cost, wsConfig.daily_budget_usd, todaySpent);
-            const shouldSave = save_to_memory ?? wsConfig.save_to_memory;
-            if (shouldSave) {
-                text += await saveResultToMemory(query, result.content, result.citations, 'succ_deep_research', 'learning');
+            case 'search': {
+                if (!isApiConfigured()) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'API key not configured. Set OPENROUTER_API_KEY environment variable or run:\nsucc_config(action="set", key="llm.api_key", value="sk-or-...")',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const wsConfig = getWebSearchConfig();
+                if (!wsConfig.enabled) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Web search is disabled. Enable with: succ_config(action="set", key="web_search.enabled", value="true")',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const budgetError = await checkBudget(wsConfig.daily_budget_usd);
+                if (budgetError)
+                    return { content: [{ type: 'text', text: budgetError }], isError: true };
+                const effectiveModel = model || wsConfig.model;
+                try {
+                    const messages = [];
+                    if (system_prompt) {
+                        messages.push({ role: 'system', content: system_prompt });
+                    }
+                    messages.push({ role: 'user', content: query });
+                    const result = await callOpenRouterSearch(messages, effectiveModel, wsConfig.timeout_ms, max_tokens || wsConfig.max_tokens, wsConfig.temperature);
+                    const cost = estimateCost(result.usage, effectiveModel);
+                    await recordSearchToDb('succ_web_search', effectiveModel, query, result.usage, cost, result.citations, false, result.content.length);
+                    const todaySpent = wsConfig.daily_budget_usd > 0 ? await getTodayWebSearchSpend() : 0;
+                    let text = result.content;
+                    text += formatCitations(result.citations, result.search_results);
+                    text += formatUsage(result.usage, cost, wsConfig.daily_budget_usd, todaySpent);
+                    const shouldSave = save_to_memory ?? wsConfig.save_to_memory;
+                    if (shouldSave) {
+                        text += await saveResultToMemory(query, result.content, result.citations, 'succ_web_search', 'observation');
+                    }
+                    return { content: [{ type: 'text', text }] };
+                }
+                catch (error) {
+                    return {
+                        content: [{ type: 'text', text: `Web search failed: ${error.message}` }],
+                        isError: true,
+                    };
+                }
             }
-            return { content: [{ type: 'text', text }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: 'text', text: `Deep research failed: ${error.message}` }],
-                isError: true,
-            };
-        }
-    });
-    // succ_web_search_history — view past searches
-    server.tool('succ_web_search_history', 'View web search history with filtering. Shows past searches, costs, and usage statistics. Useful for tracking spend, reviewing past queries, and auditing search usage.', {
-        tool_name: z
-            .enum(['succ_quick_search', 'succ_web_search', 'succ_deep_research'])
-            .optional()
-            .describe('Filter by tool'),
-        model: z.string().optional().describe('Filter by model (e.g., "perplexity/sonar-pro")'),
-        query_text: z.string().optional().describe('Filter by query substring'),
-        date_from: z.string().optional().describe('Start date (ISO, e.g., "2025-01-01")'),
-        date_to: z.string().optional().describe('End date (ISO, e.g., "2025-12-31")'),
-        limit: z.number().optional().describe('Max records to return (default: 20)'),
-        project_path: projectPathParam,
-    }, async ({ tool_name, model, query_text, date_from, date_to, limit, project_path }) => {
-        await applyProjectPath(project_path);
-        try {
-            const [records, summary] = await Promise.all([
-                getWebSearchHistory({ tool_name, model, query_text, date_from, date_to, limit }),
-                getWebSearchSummary(),
-            ]);
-            const lines = [];
-            // Summary section
-            lines.push('## Web Search Summary');
-            lines.push(`Total: ${summary.total_searches} searches, $${summary.total_cost_usd.toFixed(4)}`);
-            lines.push(`Today: ${summary.today_searches} searches, $${summary.today_cost_usd.toFixed(4)}`);
-            if (Object.keys(summary.by_tool).length > 0) {
-                lines.push('');
-                lines.push('**By tool:**');
-                for (const [tool, stats] of Object.entries(summary.by_tool)) {
-                    lines.push(`  ${tool}: ${stats.count} queries, $${stats.cost.toFixed(4)}`);
+            case 'deep': {
+                if (!isApiConfigured()) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'API key not configured. Set OPENROUTER_API_KEY environment variable or run:\nsucc_config(action="set", key="llm.api_key", value="sk-or-...")',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const wsConfig = getWebSearchConfig();
+                if (!wsConfig.enabled) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Web search is disabled. Enable with: succ_config(action="set", key="web_search.enabled", value="true")',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const budgetError = await checkBudget(wsConfig.daily_budget_usd);
+                if (budgetError)
+                    return { content: [{ type: 'text', text: budgetError }], isError: true };
+                try {
+                    const messages = [];
+                    if (system_prompt) {
+                        messages.push({ role: 'system', content: system_prompt });
+                    }
+                    messages.push({ role: 'user', content: query });
+                    const result = await callOpenRouterSearch(messages, wsConfig.deep_research_model, wsConfig.deep_research_timeout_ms, max_tokens || wsConfig.deep_research_max_tokens, wsConfig.temperature);
+                    const cost = estimateCost(result.usage, wsConfig.deep_research_model);
+                    await recordSearchToDb('succ_deep_research', wsConfig.deep_research_model, query, result.usage, cost, result.citations, !!result.reasoning, result.content.length);
+                    const todaySpent = wsConfig.daily_budget_usd > 0 ? await getTodayWebSearchSpend() : 0;
+                    let text = '';
+                    if (include_reasoning && result.reasoning) {
+                        text += `**Reasoning Process:**\n${result.reasoning}\n\n---\n\n`;
+                    }
+                    text += result.content;
+                    text += formatCitations(result.citations, result.search_results);
+                    text += formatUsage(result.usage, cost, wsConfig.daily_budget_usd, todaySpent);
+                    const shouldSave = save_to_memory ?? wsConfig.save_to_memory;
+                    if (shouldSave) {
+                        text += await saveResultToMemory(query, result.content, result.citations, 'succ_deep_research', 'learning');
+                    }
+                    return { content: [{ type: 'text', text }] };
+                }
+                catch (error) {
+                    return {
+                        content: [{ type: 'text', text: `Deep research failed: ${error.message}` }],
+                        isError: true,
+                    };
                 }
             }
-            // Records section
-            if (records.length > 0) {
-                lines.push('');
-                lines.push(`## Recent Searches (${records.length})`);
-                for (const r of records) {
-                    const date = r.created_at.slice(0, 16).replace('T', ' ');
-                    const tokens = r.prompt_tokens + r.completion_tokens;
-                    lines.push(`- **[${date}]** \`${r.tool_name}\` — "${r.query.slice(0, 80)}${r.query.length > 80 ? '...' : ''}"`);
-                    lines.push(`  Model: ${r.model} | Tokens: ${tokens.toLocaleString()} | Cost: $${r.estimated_cost_usd.toFixed(4)}${r.citations_count > 0 ? ` | Citations: ${r.citations_count}` : ''}`);
+            case 'history': {
+                try {
+                    const [records, summary] = await Promise.all([
+                        getWebSearchHistory({ tool_name, model, query_text, date_from, date_to, limit }),
+                        getWebSearchSummary(),
+                    ]);
+                    const lines = [];
+                    // Summary section
+                    lines.push('## Web Search Summary');
+                    lines.push(`Total: ${summary.total_searches} searches, $${summary.total_cost_usd.toFixed(4)}`);
+                    lines.push(`Today: ${summary.today_searches} searches, $${summary.today_cost_usd.toFixed(4)}`);
+                    if (Object.keys(summary.by_tool).length > 0) {
+                        lines.push('');
+                        lines.push('**By tool:**');
+                        for (const [tool, stats] of Object.entries(summary.by_tool)) {
+                            lines.push(`  ${tool}: ${stats.count} queries, $${stats.cost.toFixed(4)}`);
+                        }
+                    }
+                    // Records section
+                    if (records.length > 0) {
+                        lines.push('');
+                        lines.push(`## Recent Searches (${records.length})`);
+                        for (const r of records) {
+                            const date = r.created_at.slice(0, 16).replace('T', ' ');
+                            const tokens = r.prompt_tokens + r.completion_tokens;
+                            lines.push(`- **[${date}]** \`${r.tool_name}\` — "${r.query.slice(0, 80)}${r.query.length > 80 ? '...' : ''}"`);
+                            lines.push(`  Model: ${r.model} | Tokens: ${tokens.toLocaleString()} | Cost: $${r.estimated_cost_usd.toFixed(4)}${r.citations_count > 0 ? ` | Citations: ${r.citations_count}` : ''}`);
+                        }
+                    }
+                    else {
+                        lines.push('\n_No search records found matching filters._');
+                    }
+                    return { content: [{ type: 'text', text: lines.join('\n') }] };
+                }
+                catch (error) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Failed to retrieve search history: ${error.message}`,
+                            },
+                        ],
+                        isError: true,
+                    };
                 }
             }
-            else {
-                lines.push('\n_No search records found matching filters._');
+            default: {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Unknown action "${action}". Valid actions: quick, search, deep, history`,
+                        },
+                    ],
+                    isError: true,
+                };
             }
-            return { content: [{ type: 'text', text: lines.join('\n') }] };
-        }
-        catch (error) {
-            return {
-                content: [
-                    { type: 'text', text: `Failed to retrieve search history: ${error.message}` },
-                ],
-                isError: true,
-            };
         }
     });
 }