mcp-researchpowerpack 3.6.9

package/dist/clients/search.js

@@ -0,0 +1,219 @@
+/**
+ * Web Search Client
+ * Generic interface for web search via Google (Serper implementation)
+ * Implements robust error handling that NEVER crashes
+ */
+import { parseEnv } from '../config/index.js';
+import { classifyError, fetchWithTimeout, sleep, ErrorCode, } from '../utils/errors.js';
+import { pMap } from '../utils/concurrency.js';
+import { mcpLog } from '../utils/logger.js';
+// Search retry configuration
+const SEARCH_RETRY_CONFIG = {
+    maxRetries: 2,
+    baseDelayMs: 1000,
+    maxDelayMs: 10000,
+    timeoutMs: 30000,
+};
+const RETRYABLE_SEARCH_CODES = new Set([429, 500, 502, 503, 504]);
+// Pre-compiled regex patterns for Reddit search
+const REDDIT_SITE_REGEX = /site:\s*reddit\.com/i;
+const REDDIT_SUBREDDIT_SUFFIX_REGEX = / : r\/\w+$/;
+const REDDIT_SUFFIX_REGEX = / - Reddit$/;
+export class SearchClient {
+    apiKey;
+    baseURL = 'https://google.serper.dev';
+    constructor(apiKey) {
+        const env = parseEnv();
+        this.apiKey = apiKey || env.SEARCH_API_KEY || '';
+        if (!this.apiKey) {
+            throw new Error('SERPER_API_KEY is required for search functionality');
+        }
+    }
+    /**
+     * Calculate backoff delay
+     */
+    calculateBackoff(attempt) {
+        const exponentialDelay = SEARCH_RETRY_CONFIG.baseDelayMs * Math.pow(2, attempt);
+        const jitter = Math.random() * 0.3 * exponentialDelay;
+        return Math.min(exponentialDelay + jitter, SEARCH_RETRY_CONFIG.maxDelayMs);
+    }
+    /**
+     * Check if error is retryable
+     */
+    isRetryable(status, error) {
+        if (status && RETRYABLE_SEARCH_CODES.has(status))
+            return true;
+        const message = error?.message?.toLowerCase() || '';
+        return message.includes('timeout') || message.includes('rate limit') || message.includes('connection');
+    }
+    /**
+     * Search multiple keywords in parallel
+     * NEVER throws - always returns a valid response
+     */
+    async searchMultiple(keywords) {
+        const startTime = Date.now();
+        if (keywords.length === 0) {
+            return {
+                searches: [],
+                totalKeywords: 0,
+                executionTime: 0,
+                error: { code: ErrorCode.INVALID_INPUT, message: 'No keywords provided', retryable: false },
+            };
+        }
+        let lastError;
+        for (let attempt = 0; attempt <= SEARCH_RETRY_CONFIG.maxRetries; attempt++) {
+            try {
+                if (attempt > 0) {
+                    mcpLog('warning', `Retry attempt ${attempt}/${SEARCH_RETRY_CONFIG.maxRetries}`, 'search');
+                }
+                const searchQueries = keywords.map(keyword => ({ q: keyword }));
+                const response = await fetchWithTimeout(`${this.baseURL}/search`, {
+                    method: 'POST',
+                    headers: {
+                        'X-API-KEY': this.apiKey,
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(searchQueries),
+                    timeoutMs: SEARCH_RETRY_CONFIG.timeoutMs,
+                });
+                if (!response.ok) {
+                    const errorText = await response.text().catch(() => '');
+                    lastError = classifyError({ status: response.status, message: errorText });
+                    if (this.isRetryable(response.status) && attempt < SEARCH_RETRY_CONFIG.maxRetries) {
+                        const delayMs = this.calculateBackoff(attempt);
+                        mcpLog('warning', `API returned ${response.status}, retrying in ${delayMs}ms...`, 'search');
+                        await sleep(delayMs);
+                        continue;
+                    }
+                    // Return partial result with error
+                    return {
+                        searches: [],
+                        totalKeywords: keywords.length,
+                        executionTime: Date.now() - startTime,
+                        error: lastError,
+                    };
+                }
+                // Parse response safely
+                let data;
+                try {
+                    data = await response.json();
+                }
+                catch (parseError) {
+                    return {
+                        searches: [],
+                        totalKeywords: keywords.length,
+                        executionTime: Date.now() - startTime,
+                        error: { code: ErrorCode.PARSE_ERROR, message: 'Failed to parse search response', retryable: false },
+                    };
+                }
+                const responses = Array.isArray(data) ? data : [data];
+                const searches = responses.map((resp, index) => {
+                    try {
+                        const organic = (resp.organic || []);
+                        const results = organic.map((item, idx) => ({
+                            title: item.title || 'No title',
+                            link: item.link || '#',
+                            snippet: item.snippet || '',
+                            date: item.date,
+                            position: item.position || idx + 1,
+                        }));
+                        const searchInfo = resp.searchInformation;
+                        const totalResults = searchInfo?.totalResults
+                            ? parseInt(String(searchInfo.totalResults).replace(/,/g, ''), 10)
+                            : results.length;
+                        const relatedSearches = (resp.relatedSearches || []);
+                        const related = relatedSearches.map((r) => r.query || '');
+                        return { keyword: keywords[index] || '', results, totalResults, related };
+                    }
+                    catch {
+                        // Return empty result for this keyword on parse error
+                        return { keyword: keywords[index] || '', results: [], totalResults: 0, related: [] };
+                    }
+                });
+                return { searches, totalKeywords: keywords.length, executionTime: Date.now() - startTime };
+            }
+            catch (error) {
+                lastError = classifyError(error);
+                if (this.isRetryable(undefined, error) && attempt < SEARCH_RETRY_CONFIG.maxRetries) {
+                    const delayMs = this.calculateBackoff(attempt);
+                    mcpLog('warning', `${lastError.code}: ${lastError.message}, retrying in ${delayMs}ms...`, 'search');
+                    await sleep(delayMs);
+                    continue;
+                }
+                break;
+            }
+        }
+        // All retries failed
+        return {
+            searches: [],
+            totalKeywords: keywords.length,
+            executionTime: Date.now() - startTime,
+            error: lastError || { code: ErrorCode.UNKNOWN_ERROR, message: 'Search failed', retryable: false },
+        };
+    }
+    /**
+     * Search Reddit via Google (adds site:reddit.com automatically)
+     * NEVER throws - returns empty array on failure
+     */
+    async searchReddit(query, dateAfter) {
+        if (!query?.trim()) {
+            return [];
+        }
+        let q = REDDIT_SITE_REGEX.test(query) ? query : `${query} site:reddit.com`;
+        if (dateAfter) {
+            q += ` after:${dateAfter}`;
+        }
+        for (let attempt = 0; attempt <= SEARCH_RETRY_CONFIG.maxRetries; attempt++) {
+            try {
+                const res = await fetchWithTimeout(`${this.baseURL}/search`, {
+                    method: 'POST',
+                    headers: { 'X-API-KEY': this.apiKey, 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ q, num: 10 }),
+                    timeoutMs: SEARCH_RETRY_CONFIG.timeoutMs,
+                });
+                if (!res.ok) {
+                    if (this.isRetryable(res.status) && attempt < SEARCH_RETRY_CONFIG.maxRetries) {
+                        const delayMs = this.calculateBackoff(attempt);
+                        mcpLog('warning', `Reddit search ${res.status}, retrying in ${delayMs}ms...`, 'search');
+                        await sleep(delayMs);
+                        continue;
+                    }
+                    mcpLog('error', `Reddit search failed with status ${res.status}`, 'search');
+                    return [];
+                }
+                const data = await res.json();
+                return (data.organic || []).map((r) => ({
+                    title: (r.title || '').replace(REDDIT_SUBREDDIT_SUFFIX_REGEX, '').replace(REDDIT_SUFFIX_REGEX, ''),
+                    url: r.link || '',
+                    snippet: r.snippet || '',
+                    date: r.date,
+                }));
+            }
+            catch (error) {
+                const err = classifyError(error);
+                if (this.isRetryable(undefined, error) && attempt < SEARCH_RETRY_CONFIG.maxRetries) {
+                    const delayMs = this.calculateBackoff(attempt);
+                    mcpLog('warning', `Reddit search ${err.code}, retrying in ${delayMs}ms...`, 'search');
+                    await sleep(delayMs);
+                    continue;
+                }
+                mcpLog('error', `Reddit search failed: ${err.message}`, 'search');
+                return [];
+            }
+        }
+        return [];
+    }
+    /**
+     * Search Reddit with multiple queries (bounded concurrency)
+     * NEVER throws - searchReddit never throws, pMap preserves order
+     */
+    async searchRedditMultiple(queries, dateAfter) {
+        if (queries.length === 0) {
+            return new Map();
+        }
+        // Limit to 8 concurrent Serper API calls to prevent CPU spikes & rate limits
+        const results = await pMap(queries, q => this.searchReddit(q, dateAfter), 8);
+        return new Map(queries.map((q, i) => [q, results[i] || []]));
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/clients/search.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Consolidated configuration
+ * All environment variables, constants, and LLM config in one place
+ */
+interface EnvConfig {
+    SCRAPER_API_KEY: string;
+    SEARCH_API_KEY: string | undefined;
+    REDDIT_CLIENT_ID: string | undefined;
+    REDDIT_CLIENT_SECRET: string | undefined;
+}
+export declare function parseEnv(): EnvConfig;
+export declare const RESEARCH: {
+    readonly BASE_URL: string;
+    readonly MODEL: string;
+    readonly FALLBACK_MODEL: string;
+    readonly API_KEY: string;
+    readonly TIMEOUT_MS: number;
+    readonly REASONING_EFFORT: "low" | "medium" | "high";
+    readonly MAX_URLS: number;
+};
+export declare const SERVER: {
+    readonly NAME: string;
+    readonly VERSION: string;
+    readonly DESCRIPTION: string;
+};
+export interface Capabilities {
+    reddit: boolean;
+    search: boolean;
+    scraping: boolean;
+    deepResearch: boolean;
+    llmExtraction: boolean;
+}
+export declare function getCapabilities(): Capabilities;
+export declare function getMissingEnvMessage(capability: keyof Capabilities): string;
+export declare const SCRAPER: {
+    readonly MAX_CONCURRENT: 30;
+    readonly BATCH_SIZE: 30;
+    readonly MAX_TOKENS_BUDGET: 32000;
+    readonly MIN_URLS: 3;
+    readonly MAX_URLS: 50;
+    readonly RETRY_COUNT: 3;
+    readonly RETRY_DELAYS: readonly [2000, 4000, 8000];
+    readonly EXTRACTION_SUFFIX: "Try to answer this information as comprehensive as possible while keeping info density super high without adding unnecessary words but satisfy the scope defined by previous instructions even more.";
+};
+export declare const REDDIT: {
+    readonly MAX_CONCURRENT: 10;
+    readonly BATCH_SIZE: 10;
+    readonly MAX_COMMENT_BUDGET: 1000;
+    readonly MAX_COMMENTS_PER_POST: 200;
+    readonly MIN_POSTS: 2;
+    readonly MAX_POSTS: 50;
+    readonly RETRY_COUNT: 5;
+    readonly RETRY_DELAYS: readonly [2000, 4000, 8000, 16000, 32000];
+};
+export declare const CTR_WEIGHTS: Record<number, number>;
+export declare const LLM_EXTRACTION: {
+    readonly MODEL: string;
+    readonly MAX_TOKENS: 8000;
+    readonly ENABLE_REASONING: boolean;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoDH,UAAU,SAAS;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAID,wBAAgB,QAAQ,IAAI,SAAS,CASpC;AAMD,eAAO,MAAM,QAAQ;;;;;;;;CAUX,CAAC;AAQX,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAMX,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,eAAe,IAAI,YAAY,CAS9C;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,YAAY,GAAG,MAAM,CAS3E;AAMD,eAAO,MAAM,OAAO;;;;;;;;;CASV,CAAC;AAMX,eAAO,MAAM,MAAM;;;;;;;;;CAST,CAAC;AAMX,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWrC,CAAC;AAMX,eAAO,MAAM,cAAc;;;;CAIjB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,142 @@
+/**
+ * Consolidated configuration
+ * All environment variables, constants, and LLM config in one place
+ */
+import { VERSION, PACKAGE_NAME, PACKAGE_DESCRIPTION } from '../version.js';
+// Import version utilities (not re-exported - use directly from version.ts if needed externally)
+// ============================================================================
+// Safe Integer Parsing Helper
+// ============================================================================
+/**
+ * Safely parse an integer from environment variable with bounds checking
+ * @param value - The string value to parse (from process.env)
+ * @param defaultVal - Default value if parsing fails or value is undefined
+ * @param min - Minimum allowed value (clamped if below)
+ * @param max - Maximum allowed value (clamped if above)
+ * @returns Parsed integer within bounds, or default value
+ */
+function safeParseInt(value, defaultVal, min, max) {
+    if (!value) {
+        return defaultVal;
+    }
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed)) {
+        console.warn(`[Config] Invalid number "${value}", using default ${defaultVal}`);
+        return defaultVal;
+    }
+    if (parsed < min) {
+        console.warn(`[Config] Value ${parsed} below minimum ${min}, clamping to ${min}`);
+        return min;
+    }
+    if (parsed > max) {
+        console.warn(`[Config] Value ${parsed} above maximum ${max}, clamping to ${max}`);
+        return max;
+    }
+    return parsed;
+}
+let cachedEnv = null;
+export function parseEnv() {
+    if (cachedEnv)
+        return cachedEnv;
+    cachedEnv = {
+        SCRAPER_API_KEY: process.env.SCRAPEDO_API_KEY || '',
+        SEARCH_API_KEY: process.env.SERPER_API_KEY || undefined,
+        REDDIT_CLIENT_ID: process.env.REDDIT_CLIENT_ID || undefined,
+        REDDIT_CLIENT_SECRET: process.env.REDDIT_CLIENT_SECRET || undefined,
+    };
+    return cachedEnv;
+}
+// ============================================================================
+// Research API Configuration
+// ============================================================================
+export const RESEARCH = {
+    BASE_URL: process.env.OPENROUTER_BASE_URL || 'https://openrouter.ai/api/v1',
+    MODEL: process.env.RESEARCH_MODEL || 'x-ai/grok-4-fast',
+    FALLBACK_MODEL: process.env.RESEARCH_FALLBACK_MODEL || 'google/gemini-2.5-flash',
+    API_KEY: process.env.OPENROUTER_API_KEY || '',
+    // Timeout: min 1s, max 1hr, default 30min
+    TIMEOUT_MS: safeParseInt(process.env.API_TIMEOUT_MS, 1800000, 1000, 3600000),
+    REASONING_EFFORT: process.env.DEFAULT_REASONING_EFFORT || 'high',
+    // Max URLs in search results: min 10, max 200, default 100
+    MAX_URLS: safeParseInt(process.env.DEFAULT_MAX_URLS, 100, 10, 200),
+};
+// ============================================================================
+// MCP Server Configuration
+// ============================================================================
+// Version is now automatically read from package.json via version.ts
+// No need to manually update version strings anymore!
+export const SERVER = {
+    NAME: PACKAGE_NAME,
+    VERSION: VERSION,
+    DESCRIPTION: PACKAGE_DESCRIPTION,
+};
+export function getCapabilities() {
+    const env = parseEnv();
+    return {
+        reddit: !!(env.REDDIT_CLIENT_ID && env.REDDIT_CLIENT_SECRET),
+        search: !!env.SEARCH_API_KEY,
+        scraping: !!env.SCRAPER_API_KEY,
+        deepResearch: !!RESEARCH.API_KEY,
+        llmExtraction: !!RESEARCH.API_KEY, // Reuses OPENROUTER for LLM extraction
+    };
+}
+export function getMissingEnvMessage(capability) {
+    const messages = {
+        reddit: '❌ **Reddit tools unavailable.** Set `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` to enable.\n\n👉 Create a Reddit app at: https://www.reddit.com/prefs/apps (select "script" type)',
+        search: '❌ **Search unavailable.** Set `SERPER_API_KEY` to enable web search and Reddit search.\n\n👉 Get your free API key at: https://serper.dev (2,500 free queries)',
+        scraping: '❌ **Web scraping unavailable.** Set `SCRAPEDO_API_KEY` to enable URL content extraction.\n\n👉 Sign up at: https://scrape.do (1,000 free credits)',
+        deepResearch: '❌ **Deep research unavailable.** Set `OPENROUTER_API_KEY` to enable AI-powered research.\n\n👉 Get your API key at: https://openrouter.ai/keys',
+        llmExtraction: '⚠️ **AI extraction disabled.** The `use_llm` and `what_to_extract` features require `OPENROUTER_API_KEY`.\n\nScraping will work but without intelligent content filtering.',
+    };
+    return messages[capability];
+}
+// ============================================================================
+// Scraper Configuration (Scrape.do implementation)
+// ============================================================================
+export const SCRAPER = {
+    MAX_CONCURRENT: 30,
+    BATCH_SIZE: 30,
+    MAX_TOKENS_BUDGET: 32000,
+    MIN_URLS: 3,
+    MAX_URLS: 50,
+    RETRY_COUNT: 3,
+    RETRY_DELAYS: [2000, 4000, 8000],
+    EXTRACTION_SUFFIX: 'Try to answer this information as comprehensive as possible while keeping info density super high without adding unnecessary words but satisfy the scope defined by previous instructions even more.',
+};
+// ============================================================================
+// Reddit Configuration
+// ============================================================================
+export const REDDIT = {
+    MAX_CONCURRENT: 10,
+    BATCH_SIZE: 10,
+    MAX_COMMENT_BUDGET: 1000,
+    MAX_COMMENTS_PER_POST: 200,
+    MIN_POSTS: 2,
+    MAX_POSTS: 50,
+    RETRY_COUNT: 5,
+    RETRY_DELAYS: [2000, 4000, 8000, 16000, 32000],
+};
+// ============================================================================
+// CTR Weights for URL Ranking (inspired from CTR research)
+// ============================================================================
+export const CTR_WEIGHTS = {
+    1: 100.00,
+    2: 60.00,
+    3: 48.89,
+    4: 33.33,
+    5: 28.89,
+    6: 26.44,
+    7: 24.44,
+    8: 17.78,
+    9: 13.33,
+    10: 12.56,
+};
+// ============================================================================
+// LLM Extraction Model (uses OPENROUTER for scrape_links AI extraction)
+// ============================================================================
+export const LLM_EXTRACTION = {
+    MODEL: process.env.LLM_EXTRACTION_MODEL || 'openai/gpt-oss-120b:nitro',
+    MAX_TOKENS: 8000,
+    ENABLE_REASONING: process.env.LLM_ENABLE_REASONING !== 'false', // Default true, can be disabled with 'false'
+};
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,40 @@
+/**
+ * YAML Configuration Loader
+ * Loads tools.yaml and generates MCP-compatible tool definitions
+ */
+import { z } from 'zod';
+import type { YamlConfig, YamlToolConfig, YamlParameter, McpTool, LoadedTool } from './types.js';
+/**
+ * Recursively convert YAML parameter to Zod schema
+ */
+declare function yamlParamToZod(param: YamlParameter): z.ZodTypeAny;
+/**
+ * Convert YAML parameters to Zod object schema
+ */
+declare function yamlParamsToZodSchema(params: Record<string, YamlParameter>): z.ZodObject<Record<string, z.ZodTypeAny>>;
+/**
+ * Load and parse tools.yaml
+ */
+export declare function loadYamlConfig(): YamlConfig;
+/**
+ * Load all tools from YAML configuration
+ */
+export declare function loadToolsFromYaml(): LoadedTool[];
+/**
+ * Get tool configuration by name
+ */
+export declare function getToolConfig(name: string): YamlToolConfig | undefined;
+/**
+ * Get schema descriptions for a tool (for injecting into existing Zod schemas)
+ */
+export declare function getSchemaDescriptions(name: string): Record<string, string> | undefined;
+/**
+ * Get Zod schema by reference name
+ */
+export declare function getZodSchemaByRef(ref: string): z.ZodTypeAny | undefined;
+/**
+ * Generate complete MCP tools list with all schemas resolved
+ */
+export declare function generateMcpTools(): McpTool[];
+export { yamlParamsToZodSchema, yamlParamToZod };
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,aAAa,EAEb,OAAO,EACP,UAAU,EACX,MAAM,YAAY,CAAC;AA8DpB;;GAEG;AACH,iBAAS,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,CAAC,CAAC,UAAU,CAqE1D;AAED;;GAEG;AACH,iBAAS,qBAAqB,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACpC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAU3C;AAyBD;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAM3C;AAwCD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CAYhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAGtF;AAmBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,UAAU,GAAG,SAAS,CAEvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,EAAE,CA+B5C;AAMD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,CAAC"}