@vinaes/succ 1.3.19

package/dist/mcp/tools/search.js

@@ -0,0 +1,279 @@
+/**
+ * MCP Search tools
+ *
+ * - succ_search: Hybrid search in brain vault (BM25 + semantic)
+ * - succ_search_code: Search indexed source code
+ */
+import { z } from 'zod';
+import { hybridSearchCode, hybridSearchDocs, getRecentDocuments, closeDb, } from '../../lib/storage/index.js';
+import { isGlobalOnlyMode, getReadinessGateConfig } from '../../lib/config.js';
+import { getEmbedding } from '../../lib/embeddings.js';
+import { assessReadiness, formatReadinessHeader } from '../../lib/readiness.js';
+import { trackTokenSavings, projectPathParam, applyProjectPath } from '../helpers.js';
+export function registerSearchTools(server) {
+    // Tool: succ_search - Hybrid search in brain vault (BM25 + semantic)
+    server.tool('succ_search', 'Search the project knowledge base using hybrid search (BM25 + semantic). Returns relevant chunks from indexed documentation. Output modes: full (default), lean (file+lines only, saves tokens). In projects without .succ/, returns a hint to initialize or use global memory.', {
+        query: z.string().describe('The search query'),
+        limit: z.number().optional().default(5).describe('Maximum number of results (default: 5)'),
+        threshold: z
+            .number()
+            .optional()
+            .default(0.2)
+            .describe('Similarity threshold 0-1 (default: 0.2)'),
+        output: z
+            .enum(['full', 'lean'])
+            .optional()
+            .default('full')
+            .describe('Output mode: full (content blocks), lean (file+lines only, saves tokens)'),
+        project_path: projectPathParam,
+    }, async ({ query, limit, threshold, output, project_path }) => {
+        await applyProjectPath(project_path);
+        // Check if project is initialized
+        if (isGlobalOnlyMode()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Project not initialized (no .succ/ directory). Run \`succ init\` to enable project-local search.\n\nTip: Use succ_recall for global memories that work across all projects.`,
+                    },
+                ],
+            };
+        }
+        try {
+            // Special case: "*" means "show recent documents" (no semantic search)
+            const isWildcard = query === '*' || query === '**' || query.trim() === '';
+            if (isWildcard) {
+                const recentDocs = await getRecentDocuments(limit);
+                if (recentDocs.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'No documents indexed. Run `succ index` to index documentation.',
+                            },
+                        ],
+                    };
+                }
+                const formatted = recentDocs
+                    .map((r, i) => {
+                    return `### ${i + 1}. ${r.file_path}:${r.start_line}-${r.end_line}\n\n${r.content}`;
+                })
+                    .join('\n\n---\n\n');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Found ${recentDocs.length} recent documents:\n\n${formatted}`,
+                        },
+                    ],
+                };
+            }
+            const queryEmbedding = await getEmbedding(query);
+            // Use hybrid search for docs
+            const results = await hybridSearchDocs(query, queryEmbedding, limit, threshold);
+            if (results.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No results found for "${query}" (threshold: ${threshold})`,
+                        },
+                    ],
+                };
+            }
+            // Track token savings
+            await trackTokenSavings('search', query, results);
+            let formatted;
+            if (output === 'lean') {
+                formatted = results
+                    .map((r, i) => {
+                    const score = (r.similarity * 100).toFixed(1);
+                    return `${i + 1}. ${r.file_path}:${r.start_line}-${r.end_line} (${score}%)`;
+                })
+                    .join('\n');
+            }
+            else {
+                formatted = results
+                    .map((r, i) => {
+                    const score = (r.similarity * 100).toFixed(1);
+                    return `### ${i + 1}. ${r.file_path}:${r.start_line}-${r.end_line} (${score}%)\n\n${r.content}`;
+                })
+                    .join('\n\n---\n\n');
+            }
+            // Readiness gate: assess result confidence
+            const gateConfig = getReadinessGateConfig();
+            let readinessHeader = '';
+            if (gateConfig.enabled) {
+                const assessment = assessReadiness(results, 'docs', gateConfig);
+                readinessHeader = formatReadinessHeader(assessment);
+                if (readinessHeader)
+                    readinessHeader += '\n\n';
+            }
+            const modeLabel = output !== 'full' ? ` [${output}]` : '';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `${readinessHeader}Found ${results.length} results for "${query}"${modeLabel}:\n\n${formatted}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error searching: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            closeDb();
+        }
+    });
+    // Tool: succ_search_code - Search indexed code (hybrid BM25 + vector)
+    server.tool('succ_search_code', 'Search indexed source code using hybrid search (BM25 + semantic). Find functions, classes, and code patterns. Supports regex pre-filter and symbol_type filter. Output modes: full (default), lean (file+lines only), signatures (symbol names+signatures).', {
+        query: z
+            .string()
+            .describe('What to search for (e.g., "useGlobalHooks", "authentication logic")'),
+        limit: z.number().optional().default(5).describe('Maximum number of results (default: 5)'),
+        threshold: z
+            .number()
+            .optional()
+            .default(0.25)
+            .describe('Similarity threshold 0-1 (default: 0.25)'),
+        regex: z
+            .string()
+            .optional()
+            .describe('Regex filter — only return results whose content matches this pattern'),
+        symbol_type: z
+            .enum(['function', 'method', 'class', 'interface', 'type_alias'])
+            .optional()
+            .describe('Filter by AST symbol type (e.g., "function", "class")'),
+        output: z
+            .enum(['full', 'lean', 'signatures'])
+            .optional()
+            .default('full')
+            .describe('Output mode: full (code blocks), lean (file+lines, saves tokens), signatures (symbol info only)'),
+        project_path: projectPathParam,
+    }, async ({ query, limit, threshold, regex, symbol_type, output, project_path }) => {
+        await applyProjectPath(project_path);
+        // Check if project is initialized
+        if (isGlobalOnlyMode()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Project not initialized (no .succ/ directory). Run \`succ init\` to enable code search.`,
+                    },
+                ],
+            };
+        }
+        try {
+            const queryEmbedding = await getEmbedding(query);
+            // Build filters from optional params
+            const filters = regex || symbol_type ? { regex, symbolType: symbol_type } : undefined;
+            // Hybrid search: BM25 + vector with RRF fusion
+            const codeResults = await hybridSearchCode(query, queryEmbedding, limit, threshold, undefined, filters);
+            if (codeResults.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No code found matching "${query}". Run succ_index_code first to index the codebase.`,
+                        },
+                    ],
+                };
+            }
+            // Track token savings
+            await trackTokenSavings('search_code', query, codeResults);
+            let formatted;
+            if (output === 'lean') {
+                // Lean mode: file paths + line ranges + symbol info (saves tokens)
+                formatted = codeResults
+                    .map((r, i) => {
+                    const score = (r.similarity * 100).toFixed(1);
+                    const filePath = r.file_path.replace(/^code:/, '');
+                    const sym = r.symbol_name ? ` [${r.symbol_type ?? 'symbol'}: ${r.symbol_name}]` : '';
+                    return `${i + 1}. ${filePath}:${r.start_line}-${r.end_line} (${score}%)${sym}`;
+                })
+                    .join('\n');
+            }
+            else if (output === 'signatures') {
+                // Signatures mode: symbol metadata (minimal tokens)
+                formatted = codeResults
+                    .map((r, i) => {
+                    const score = (r.similarity * 100).toFixed(1);
+                    const filePath = r.file_path.replace(/^code:/, '');
+                    let sym;
+                    if (r.symbol_name) {
+                        sym = `${r.symbol_type ?? 'symbol'} ${r.symbol_name}`;
+                    }
+                    else {
+                        // Fallback: find first meaningful line (skip doc comments, blank lines)
+                        const firstLine = r.content
+                            .split('\n')
+                            .map((l) => l.trim())
+                            .find((l) => l &&
+                            !l.startsWith('/**') &&
+                            !l.startsWith('*') &&
+                            !l.startsWith('*/') &&
+                            !l.startsWith('//')) ?? r.content.split('\n')[0].trim();
+                        sym = firstLine;
+                    }
+                    return `${i + 1}. ${filePath}:${r.start_line} (${score}%) — ${sym}`;
+                })
+                    .join('\n');
+            }
+            else {
+                // Full mode: code blocks with symbol header (default)
+                formatted = codeResults
+                    .map((r, i) => {
+                    const score = (r.similarity * 100).toFixed(1);
+                    const filePath = r.file_path.replace(/^code:/, '');
+                    const sym = r.symbol_name
+                        ? ` — ${r.symbol_type ?? 'symbol'} \`${r.symbol_name}\``
+                        : '';
+                    return `### ${i + 1}. ${filePath}:${r.start_line}-${r.end_line} (${score}%)${sym}\n\n\`\`\`\n${r.content}\n\`\`\``;
+                })
+                    .join('\n\n---\n\n');
+            }
+            // Readiness gate: assess result confidence
+            const codeGateConfig = getReadinessGateConfig();
+            let codeReadinessHeader = '';
+            if (codeGateConfig.enabled) {
+                const assessment = assessReadiness(codeResults, 'code', codeGateConfig);
+                codeReadinessHeader = formatReadinessHeader(assessment);
+                if (codeReadinessHeader)
+                    codeReadinessHeader += '\n\n';
+            }
+            const modeLabel = output !== 'full' ? ` [${output}]` : '';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `${codeReadinessHeader}Found ${codeResults.length} code matches for "${query}"${modeLabel}:\n\n${formatted}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error searching code: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            closeDb();
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/mcp/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/status.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Status tools
+ *
+ * - succ_status: Get index status, memory stats, daemon statuses
+ * - succ_stats: Get token savings statistics
+ * - succ_score: Get AI-readiness score
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerStatusTools(server: McpServer): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/mcp/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QA8VpD"}

package/dist/mcp/tools/status.js

@@ -0,0 +1,296 @@
+/**
+ * MCP Status tools
+ *
+ * - succ_status: Get index status, memory stats, daemon statuses
+ * - succ_stats: Get token savings statistics
+ * - succ_score: Get AI-readiness score
+ */
+import { getStats, getRecentGlobalMemories, getMemoryStats, getAllMemoriesForRetention, getStaleFileCount, getTokenStatsAggregated, getWebSearchSummary, getStorageDispatcher, closeDb, } from '../../lib/storage/index.js';
+import { getDaemonStatuses, isGlobalOnlyMode, getIdleReflectionConfig, getRetentionConfig, getProjectRoot, } from '../../lib/config.js';
+import { formatTokens, compressionPercent } from '../../lib/token-counter.js';
+import { analyzeRetention } from '../../lib/retention.js';
+import { projectPathParam, applyProjectPath } from '../helpers.js';
+export function registerStatusTools(server) {
+    // Tool: succ_status - Get index status
+    server.tool('succ_status', 'Get the current status of succ (indexed files, memories, last update, daemon statuses). Shows global-only mode if project not initialized.', {
+        project_path: projectPathParam,
+    }, async ({ project_path }) => {
+        await applyProjectPath(project_path);
+        const globalOnlyMode = isGlobalOnlyMode();
+        try {
+            // In global-only mode, show limited status with debug info
+            if (globalOnlyMode) {
+                const globalMemStats = await getRecentGlobalMemories(1);
+                const globalCount = globalMemStats.length > 0 ? 'available' : 'empty';
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `## Mode\n  Global-only (no .succ/ in this project)\n  Run \`succ init\` to enable full features\n\n## Global Memory\n  Status: ${globalCount}\n  Use succ_recall and succ_remember for cross-project memories\n\nTip: Pass project_path to succ tools to access project-local data.`,
+                        },
+                    ],
+                };
+            }
+            const stats = await getStats();
+            const memStats = await getMemoryStats();
+            const daemons = await getDaemonStatuses();
+            // Format type breakdown
+            const typeBreakdown = Object.entries(memStats.by_type)
+                .map(([type, count]) => `    ${type}: ${count}`)
+                .join('\n');
+            // Format daemon statuses
+            const daemonLines = daemons
+                .map((d) => {
+                const statusIcon = d.running ? '🟢' : '⚫';
+                const pidInfo = d.running && d.pid ? ` (PID: ${d.pid})` : '';
+                return `  ${statusIcon} ${d.name}: ${d.running ? 'running' : 'stopped'}${pidInfo}`;
+            })
+                .join('\n');
+            const status = [
+                '## Documents',
+                `  Files indexed: ${stats.total_files}`,
+                `  Total chunks: ${stats.total_documents}`,
+                `  Last indexed: ${stats.last_indexed || 'Never'}`,
+                '',
+                '## Memories',
+                `  Total: ${memStats.total_memories}`,
+                typeBreakdown ? `  By type:\n${typeBreakdown}` : '',
+                memStats.oldest_memory
+                    ? `  Oldest: ${new Date(memStats.oldest_memory).toLocaleDateString()}`
+                    : '',
+                memStats.newest_memory
+                    ? `  Newest: ${new Date(memStats.newest_memory).toLocaleDateString()}`
+                    : '',
+                memStats.stale_count > 0
+                    ? `  ⚠ Stale (>30 days): ${memStats.stale_count} - consider cleanup with succ_forget`
+                    : '',
+            ];
+            // Index freshness (only show if stale files detected)
+            try {
+                const projectRoot = getProjectRoot();
+                const freshness = await getStaleFileCount(projectRoot);
+                if (freshness.stale > 0 || freshness.deleted > 0) {
+                    status.push('', '## Index Freshness', `  Indexed files: ${freshness.total}`, freshness.stale > 0 ? `  Stale (modified since indexing): ${freshness.stale}` : '', freshness.deleted > 0
+                        ? `  Missing (deleted since indexing): ${freshness.deleted}`
+                        : '', '  Run `succ reindex` to refresh');
+                }
+            }
+            catch {
+                // Skip freshness check if it fails
+            }
+            // Retention health (lightweight analysis)
+            try {
+                const retentionMemories = await getAllMemoriesForRetention();
+                if (retentionMemories.length > 0) {
+                    const retConfig = getRetentionConfig();
+                    const analysis = analyzeRetention(retentionMemories, {
+                        use_temporal_decay: retConfig.use_temporal_decay,
+                        keep_threshold: retConfig.keep_threshold,
+                        delete_threshold: retConfig.delete_threshold,
+                    });
+                    const retStats = analysis.stats;
+                    status.push('', '## Retention Health', `  Keep: ${retStats.keepCount} | Warn: ${retStats.warnCount} | Cleanup: ${retStats.deleteCount}`, `  Avg effective score: ${retStats.avgEffectiveScore}`);
+                    if (retStats.deleteCount > 0) {
+                        status.push(`  ⚠ ${retStats.deleteCount} memories below threshold - run \`succ retention --auto-cleanup --dry-run\``);
+                    }
+                }
+            }
+            catch {
+                // Skip retention health if it fails
+            }
+            // Session counters (in-memory, no DB query)
+            try {
+                const d = await getStorageDispatcher();
+                const sc = d.getSessionCounters();
+                const totalOps = sc.memoriesCreated +
+                    sc.globalMemoriesCreated +
+                    sc.memoriesDuplicated +
+                    sc.recallQueries +
+                    sc.searchQueries +
+                    sc.codeSearchQueries;
+                if (totalOps > 0) {
+                    const typesList = Object.entries(sc.typesCreated)
+                        .map(([t, n]) => `${t} (${n})`)
+                        .join(', ');
+                    status.push('', '## Current Session', `  Memories created: ${sc.memoriesCreated + sc.globalMemoriesCreated}${sc.memoriesCreated > 0 && sc.globalMemoriesCreated > 0 ? ` (${sc.memoriesCreated} local, ${sc.globalMemoriesCreated} global)` : ''}`, sc.memoriesDuplicated > 0 ? `  Duplicates skipped: ${sc.memoriesDuplicated}` : '', `  Recall queries: ${sc.recallQueries}`, `  Search queries: ${sc.searchQueries}`, sc.codeSearchQueries > 0 ? `  Code search queries: ${sc.codeSearchQueries}` : '', sc.webSearchQueries > 0
+                        ? `  Web searches: ${sc.webSearchQueries} ($${(sc.webSearchCostUsd || 0).toFixed(4)})`
+                        : '', typesList ? `  Types: ${typesList}` : '', `  Session started: ${new Date(sc.startedAt).toLocaleTimeString()}`);
+                }
+            }
+            catch {
+                /* ignore */
+            }
+            // Web search history
+            try {
+                const wsSummary = await getWebSearchSummary();
+                if (wsSummary.total_searches > 0) {
+                    status.push('', '## Web Searches', `  Total: ${wsSummary.total_searches} ($${wsSummary.total_cost_usd.toFixed(4)})`, `  Today: ${wsSummary.today_searches} ($${wsSummary.today_cost_usd.toFixed(4)})`);
+                }
+            }
+            catch {
+                /* ignore */
+            }
+            status.push('', '## Daemons', daemonLines);
+            const statusText = status.filter(Boolean).join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: statusText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting status: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            closeDb();
+        }
+    });
+    // Tool: succ_stats - Get token savings statistics
+    server.tool('succ_stats', 'Get token savings statistics. Shows how many tokens were saved by using RAG search instead of loading full files.', {
+        project_path: projectPathParam,
+    }, async ({ project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const idleConfig = getIdleReflectionConfig();
+            const summaryEnabled = idleConfig.operations?.session_summary ?? true;
+            const aggregated = await getTokenStatsAggregated();
+            const lines = ['## Token Savings\n'];
+            // Session Summaries
+            const sessionStats = aggregated.find((s) => s.event_type === 'session_summary');
+            lines.push('### Session Summaries');
+            if (!summaryEnabled) {
+                lines.push('  Status: disabled');
+            }
+            else if (sessionStats) {
+                lines.push(`  Sessions: ${sessionStats.query_count}`);
+                lines.push(`  Transcript: ${formatTokens(sessionStats.total_full_source_tokens)} tokens`);
+                lines.push(`  Summary: ${formatTokens(sessionStats.total_returned_tokens)} tokens`);
+                lines.push(`  Compression: ${compressionPercent(sessionStats.total_full_source_tokens, sessionStats.total_returned_tokens)}`);
+                lines.push(`  Saved: ${formatTokens(sessionStats.total_savings_tokens)} tokens`);
+            }
+            else {
+                lines.push('  No session summaries recorded yet.');
+            }
+            // RAG Queries
+            lines.push('\n### RAG Queries');
+            const ragTypes = ['recall', 'search', 'search_code'];
+            let hasRagStats = false;
+            let ragTotalQueries = 0;
+            let ragTotalReturned = 0;
+            let ragTotalSaved = 0;
+            for (const type of ragTypes) {
+                const stat = aggregated.find((s) => s.event_type === type);
+                if (stat) {
+                    hasRagStats = true;
+                    ragTotalQueries += stat.query_count;
+                    ragTotalReturned += stat.total_returned_tokens;
+                    if (stat.total_savings_tokens > 0) {
+                        ragTotalSaved += stat.total_savings_tokens;
+                        lines.push(`  ${type.padEnd(12)}: ${stat.query_count} queries, ${formatTokens(stat.total_returned_tokens)} returned, ${formatTokens(stat.total_savings_tokens)} saved`);
+                    }
+                    else {
+                        lines.push(`  ${type.padEnd(12)}: ${stat.query_count} queries, ${formatTokens(stat.total_returned_tokens)} returned`);
+                    }
+                }
+            }
+            if (!hasRagStats) {
+                lines.push('  No RAG queries recorded yet.');
+            }
+            // Web Searches
+            try {
+                const wsSummary = await getWebSearchSummary();
+                if (wsSummary.total_searches > 0) {
+                    lines.push('\n### Web Searches');
+                    for (const [tool, stats] of Object.entries(wsSummary.by_tool)) {
+                        const shortName = tool.replace('succ_', '');
+                        lines.push(`  ${shortName.padEnd(16)}: ${stats.count} queries, $${stats.cost.toFixed(4)}`);
+                    }
+                    lines.push(`  Today: ${wsSummary.today_searches} searches, $${wsSummary.today_cost_usd.toFixed(4)}`);
+                }
+            }
+            catch {
+                /* ignore */
+            }
+            // Total — compute from aggregated data (same logic as CLI stats.ts)
+            const sessionSaved = sessionStats?.total_savings_tokens || 0;
+            const totalSaved = sessionSaved + ragTotalSaved;
+            lines.push('\n### Total');
+            if (totalSaved > 0) {
+                lines.push(`  Total saved: ${formatTokens(totalSaved)} tokens`);
+            }
+            else if (ragTotalQueries > 0) {
+                lines.push(`  Queries: ${ragTotalQueries}, ${formatTokens(ragTotalReturned)} returned`);
+                lines.push("  No token savings yet (recall-only queries don't compute savings).");
+            }
+            else {
+                lines.push('  No stats recorded yet.');
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: lines.join('\n'),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting stats: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            closeDb();
+        }
+    });
+    // Tool: succ_score - Get AI-readiness score
+    server.tool('succ_score', 'Get the AI-readiness score for the project. Shows how well-prepared the project is for AI collaboration, with metrics for brain vault, memories, code index, and more.', {
+        project_path: projectPathParam,
+    }, async ({ project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const { calculateAIReadinessScore, formatAIReadinessScore } = await import('../../lib/ai-readiness.js');
+            const result = await calculateAIReadinessScore();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formatAIReadinessScore(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error calculating score: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            closeDb();
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/mcp/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/mcp/tools/status.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/web-fetch.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP tool: succ_fetch
+ *
+ * Fetches any URL and converts to clean Markdown via md.succ.ai.
+ * Replaces built-in WebFetch with better content extraction (Readability),
+ * JS rendering (Playwright), and no content summarization/truncation.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerWebFetchTools(server: McpServer): void;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/mcp/tools/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/web-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QA8HtD"}