@get-technology-inc/jamf-docs-mcp-server 0.0.1 → 1.1.0

package/dist/tools/get-toc.js

@@ -0,0 +1,202 @@
+/**
+ * jamf_docs_get_toc tool
+ * Get the table of contents for a Jamf product's documentation.
+ */
+import { GetTocInputSchema } from '../schemas/index.js';
+import { ResponseFormat, OutputMode, JAMF_PRODUCTS, TOKEN_CONFIG } from '../constants.js';
+import { fetchTableOfContents } from '../services/scraper.js';
+import { getAvailableVersions } from '../services/metadata.js';
+/**
+ * Render a single TOC entry as markdown
+ */
+function renderTocEntry(entry, depth = 0, compact = false) {
+    const indent = '  '.repeat(depth);
+    let result = `${indent}- [${entry.title}](${entry.url})\n`;
+    if (!compact && entry.children !== undefined && entry.children.length > 0) {
+        for (const child of entry.children) {
+            result += renderTocEntry(child, depth + 1, compact);
+        }
+    }
+    return result;
+}
+/**
+ * Format TOC as compact markdown
+ */
+function formatTocCompact(productName, toc, pagination) {
+    let markdown = `## ${productName} TOC (${pagination.totalItems} entries)\n\n`;
+    for (const entry of toc) {
+        markdown += renderTocEntry(entry, 0, true);
+    }
+    markdown += `\n---\n*Page ${pagination.page}/${pagination.totalPages}`;
+    if (pagination.hasNext) {
+        markdown += ` | page=${pagination.page + 1} for more`;
+    }
+    markdown += '*\n';
+    return markdown;
+}
+/**
+ * Format TOC as full markdown
+ */
+function formatTocFull(productName, version, toc, pagination, tokenInfo) {
+    let markdown = `# ${productName} Documentation\n\n`;
+    markdown += `**Version**: ${version} | **Page ${pagination.page} of ${pagination.totalPages}** | ${tokenInfo.tokenCount.toLocaleString()} tokens\n\n`;
+    markdown += '---\n\n';
+    markdown += '## Table of Contents\n\n';
+    for (const entry of toc) {
+        markdown += renderTocEntry(entry);
+    }
+    markdown += '\n---\n\n';
+    markdown += `**Page ${pagination.page} of ${pagination.totalPages}** (${tokenInfo.tokenCount.toLocaleString()} tokens, ${pagination.totalItems} total entries)`;
+    if (pagination.hasNext) {
+        markdown += ` | Use \`page=${pagination.page + 1}\` for more`;
+    }
+    if (tokenInfo.truncated) {
+        markdown += '\n*TOC truncated due to token limit. Use `page` parameter or increase `maxTokens`.*';
+    }
+    markdown += '\n\n*Use `jamf_docs_get_article` with any URL above to read the full content.*\n';
+    return markdown;
+}
+const TOOL_NAME = 'jamf_docs_get_toc';
+const TOOL_DESCRIPTION = `Get the table of contents for a Jamf product's documentation.
+
+This tool retrieves the navigation structure for a specific Jamf product,
+allowing you to browse available documentation topics.
+
+Args:
+  - product (string, required): Product ID - one of: jamf-pro, jamf-school, jamf-connect, jamf-protect
+  - version (string, optional): Specific version (defaults to latest)
+  - page (number, optional): Page number for pagination 1-100 (default: 1)
+  - maxTokens (number, optional): Maximum tokens in response 100-20000 (default: 5000)
+  - outputMode ('full' | 'compact'): Output detail level (default: 'full'). Use 'compact' for flat list without nested children
+  - responseFormat ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  For JSON format:
+  {
+    "product": string,
+    "version": string,
+    "toc": [...],
+    "tokenInfo": {
+      "tokenCount": number,
+      "truncated": boolean,
+      "maxTokens": number
+    },
+    "pagination": {
+      "page": number,
+      "pageSize": number,
+      "totalPages": number,
+      "totalItems": number,
+      "hasNext": boolean,
+      "hasPrev": boolean
+    }
+  }
+
+  For Markdown format:
+  A hierarchical list of documentation topics with pagination and token info.
+
+Examples:
+  - Browse Jamf Pro documentation: product="jamf-pro"
+  - Get page 2 of TOC: product="jamf-pro", page=2
+  - Limit response size: product="jamf-pro", maxTokens=2000
+
+Errors:
+  - "Invalid product ID" if the product is not recognized
+  - "Version not found" if the specified version doesn't exist
+
+Note: Use this to discover what topics are available before searching
+or retrieving specific articles. Large TOCs are paginated.`;
+export function registerGetTocTool(server) {
+    server.registerTool(TOOL_NAME, {
+        title: 'Get Documentation Table of Contents',
+        description: TOOL_DESCRIPTION,
+        inputSchema: GetTocInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (args) => {
+        // Parse and validate input
+        const parseResult = GetTocInputSchema.safeParse(args);
+        if (!parseResult.success) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Invalid input: ${parseResult.error.message}` }]
+            };
+        }
+        const params = parseResult.data;
+        try {
+            // Validate product
+            if (!(params.product in JAMF_PRODUCTS)) {
+                return {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Invalid product ID: "${params.product}".\n\nValid options:\n${Object.entries(JAMF_PRODUCTS).map(([id, p]) => `- \`${id}\`: ${p.name}`).join('\n')}`
+                        }]
+                };
+            }
+            const productId = params.product;
+            const productInfo = JAMF_PRODUCTS[productId];
+            // Get available versions dynamically
+            const availableVersions = await getAvailableVersions(productId);
+            const version = params.version ?? 'current';
+            // Validate version if specified
+            if (params.version !== undefined && params.version !== '' && params.version !== 'current') {
+                if (availableVersions.length > 0 && !availableVersions.includes(params.version)) {
+                    return {
+                        isError: true,
+                        content: [{
+                                type: 'text',
+                                text: `Version "${params.version}" not found for ${productInfo.name}.\n\nAvailable versions: ${availableVersions.length > 0 ? availableVersions.join(', ') : 'current'}`
+                            }]
+                    };
+                }
+            }
+            const tocResult = await fetchTableOfContents(productId, version, {
+                ...(params.page !== undefined && { page: params.page }),
+                maxTokens: params.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS
+            });
+            const { toc, pagination, tokenInfo } = tocResult;
+            // Build response
+            const response = {
+                product: productInfo.name,
+                version,
+                toc,
+                tokenInfo,
+                pagination
+            };
+            // Format output
+            if (params.responseFormat === ResponseFormat.JSON) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                };
+            }
+            // Format as markdown (compact or full)
+            const markdown = params.outputMode === OutputMode.COMPACT
+                ? formatTocCompact(productInfo.name, toc, pagination)
+                : formatTocFull(productInfo.name, version, toc, pagination, tokenInfo);
+            return {
+                content: [{
+                        type: 'text',
+                        text: markdown
+                    }]
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                isError: true,
+                content: [{
+                        type: 'text',
+                        text: `Error fetching table of contents: ${errorMessage}`
+                    }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-toc.js.map

package/dist/tools/get-toc.js.map

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

package/dist/tools/list-products.d.ts

@@ -0,0 +1,7 @@
+/**
+ * jamf_docs_list_products tool
+ * Lists all available Jamf products and their documentation versions.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerListProductsTool(server: McpServer): void;
+//# sourceMappingURL=list-products.d.ts.map

package/dist/tools/list-products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-products.d.ts","sourceRoot":"","sources":["../../src/tools/list-products.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyCzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4HhE"}

package/dist/tools/list-products.js

@@ -0,0 +1,150 @@
+/**
+ * jamf_docs_list_products tool
+ * Lists all available Jamf products and their documentation versions.
+ */
+import { ListProductsInputSchema } from '../schemas/index.js';
+import { JAMF_PRODUCTS, JAMF_TOPICS, ResponseFormat, OutputMode, TOKEN_CONFIG } from '../constants.js';
+import { estimateTokens, createTokenInfo } from '../services/tokenizer.js';
+const TOOL_NAME = 'jamf_docs_list_products';
+const TOOL_DESCRIPTION = `List all available Jamf products, topics, and their documentation versions.
+
+This tool returns information about all Jamf products with available documentation,
+including Jamf Pro, Jamf School, Jamf Connect, and Jamf Protect. Also lists available
+topic filters for search.
+
+Args:
+  - maxTokens (number, optional): Maximum tokens in response 100-20000 (default: 5000)
+  - outputMode ('full' | 'compact'): Output detail level (default: 'full'). Use 'compact' for brief list
+  - responseFormat ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  For JSON format:
+  {
+    "products": [...],
+    "topics": [...],
+    "tokenInfo": {
+      "tokenCount": number,
+      "truncated": boolean,
+      "maxTokens": number
+    }
+  }
+
+  For Markdown format:
+  A formatted list of products and topics with their details.
+
+Examples:
+  - "What Jamf products are available?" → use this tool
+  - "List all Jamf documentation" → use this tool
+  - "What topics can I filter by?" → use this tool
+
+Note: This is a read-only operation that does not modify any state.`;
+export function registerListProductsTool(server) {
+    server.registerTool(TOOL_NAME, {
+        title: 'List Jamf Products',
+        description: TOOL_DESCRIPTION,
+        inputSchema: ListProductsInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false
+        }
+    }, (args) => {
+        // Parse and validate input
+        const parseResult = ListProductsInputSchema.safeParse(args);
+        if (!parseResult.success) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Invalid input: ${parseResult.error.message}` }]
+            };
+        }
+        const params = parseResult.data;
+        const maxTokens = params.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS;
+        try {
+            // Build product list
+            const products = Object.values(JAMF_PRODUCTS).map(product => ({
+                id: product.id,
+                name: product.name,
+                description: product.description,
+                currentVersion: product.latestVersion,
+                availableVersions: [...product.versions]
+            }));
+            // Build topics list
+            const topics = Object.entries(JAMF_TOPICS).map(([id, topic]) => ({
+                id,
+                name: topic.name,
+                keywords: topic.keywords
+            }));
+            // Format output based on requested format
+            if (params.responseFormat === ResponseFormat.JSON) {
+                const jsonOutput = JSON.stringify({
+                    products,
+                    topics,
+                    tokenInfo: createTokenInfo(JSON.stringify({ products, topics }), maxTokens)
+                }, null, 2);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: jsonOutput
+                        }]
+                };
+            }
+            // Compact mode: minimal output
+            if (params.outputMode === OutputMode.COMPACT) {
+                let markdown = '## Products\n';
+                for (const product of products) {
+                    markdown += `- \`${product.id}\`: ${product.name}\n`;
+                }
+                markdown += '\n## Topics\n';
+                for (const topic of topics) {
+                    markdown += `- \`${topic.id}\`: ${topic.name}\n`;
+                }
+                return {
+                    content: [{
+                            type: 'text',
+                            text: markdown
+                        }]
+                };
+            }
+            // Full markdown format
+            let markdown = '# Jamf Documentation Products\n\n';
+            for (const product of products) {
+                markdown += `## ${product.name}\n\n`;
+                markdown += `- **ID**: \`${product.id}\`\n`;
+                markdown += `- **Description**: ${product.description}\n`;
+                markdown += `- **Current Version**: ${product.currentVersion}\n`;
+                markdown += `- **Available Versions**: ${product.availableVersions.join(', ')}\n\n`;
+            }
+            markdown += '---\n\n';
+            markdown += '# Available Topics for Filtering\n\n';
+            markdown += 'Use these topic IDs with the `topic` parameter in `jamf_docs_search`:\n\n';
+            for (const topic of topics) {
+                markdown += `- **\`${topic.id}\`**: ${topic.name}\n`;
+                markdown += `  *Keywords: ${topic.keywords.slice(0, 4).join(', ')}${topic.keywords.length > 4 ? '...' : ''}*\n`;
+            }
+            markdown += '\n---\n\n';
+            // Token info
+            const tokenCount = estimateTokens(markdown);
+            markdown += `*${tokenCount.toLocaleString()} tokens*\n\n`;
+            markdown += '*Use `jamf_docs_search` to search within these products, ';
+            markdown += 'or `jamf_docs_get_toc` to browse the table of contents.*\n';
+            return {
+                content: [{
+                        type: 'text',
+                        text: markdown
+                    }]
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                isError: true,
+                content: [{
+                        type: 'text',
+                        text: `Error listing products: ${errorMessage}`
+                    }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-products.js.map

package/dist/tools/list-products.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,7 @@
+/**
+ * jamf_docs_search tool
+ * Search Jamf documentation for articles matching a query.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSearchTool(server: McpServer): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8KzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwI1D"}

package/dist/tools/search.js

@@ -0,0 +1,252 @@
+/**
+ * jamf_docs_search tool
+ * Search Jamf documentation for articles matching a query.
+ */
+import { SearchInputSchema } from '../schemas/index.js';
+import { ResponseFormat, OutputMode, JAMF_PRODUCTS, JAMF_TOPICS, TOKEN_CONFIG } from '../constants.js';
+import { searchDocumentation } from '../services/scraper.js';
+import { generateSearchSuggestions, formatSearchSuggestions } from '../services/search-suggestions.js';
+function formatFiltersLine(filters) {
+    const parts = [];
+    if (filters.product !== undefined) {
+        parts.push(`product: ${filters.product}`);
+    }
+    if (filters.topic !== undefined) {
+        parts.push(`topic: ${filters.topic}`);
+    }
+    if (filters.version !== undefined) {
+        parts.push(`version: ${filters.version}`);
+    }
+    return parts.length > 0 ? `\n*Filtered by: ${parts.join(', ')}*` : '';
+}
+function formatSearchResult(result) {
+    let output = `### [${result.title}](${result.url})\n\n`;
+    output += `> ${result.snippet}\n\n`;
+    if (result.product !== '' || result.version !== undefined) {
+        const meta = [];
+        if (result.product !== '') {
+            meta.push(`**Product**: ${result.product}`);
+        }
+        if (result.version !== undefined) {
+            meta.push(`**Version**: ${result.version}`);
+        }
+        output += `${meta.join(' | ')}\n\n`;
+    }
+    output += '---\n\n';
+    return output;
+}
+function formatPaginationFooter(pagination, tokenInfo, compact = false) {
+    if (compact) {
+        let footer = `\n---\n*Page ${pagination.page}/${pagination.totalPages}`;
+        if (pagination.hasNext) {
+            footer += ` | page=${pagination.page + 1} for more`;
+        }
+        footer += '*\n';
+        return footer;
+    }
+    let footer = `**Page ${pagination.page} of ${pagination.totalPages}** (${tokenInfo.tokenCount.toLocaleString()} tokens)`;
+    if (pagination.hasNext) {
+        footer += ` | Use \`page=${pagination.page + 1}\` for more results`;
+    }
+    if (tokenInfo.truncated) {
+        footer += '\n*Results truncated due to token limit. Use a smaller `limit` or increase `maxTokens`.*';
+    }
+    footer += '\n\n*Use `jamf_docs_get_article` with any URL above to read the full article.*\n';
+    return footer;
+}
+/**
+ * Format search result in compact mode (single line)
+ */
+function formatSearchResultCompact(result, index) {
+    // Truncate snippet for compact display
+    const snippetPreview = result.snippet.length > 80
+        ? `${result.snippet.slice(0, 77)}...`
+        : result.snippet;
+    return `${index}. [${result.title}](${result.url}) - ${snippetPreview}\n`;
+}
+/**
+ * Format search results as compact markdown
+ */
+function formatSearchResultsAsCompact(query, results, filters, pagination, tokenInfo) {
+    let markdown = `## "${query}" (${pagination.totalItems} results)\n`;
+    markdown += formatFiltersLine(filters);
+    markdown += '\n\n';
+    results.forEach((result, idx) => {
+        markdown += formatSearchResultCompact(result, (pagination.page - 1) * pagination.pageSize + idx + 1);
+    });
+    markdown += formatPaginationFooter(pagination, tokenInfo, true);
+    return markdown;
+}
+function formatSearchResultsAsMarkdown(query, results, filters, pagination, tokenInfo) {
+    let markdown = `# Search Results for "${query}"\n\n`;
+    markdown += `Found ${pagination.totalItems} result(s) | **Page ${pagination.page} of ${pagination.totalPages}** | ${tokenInfo.tokenCount.toLocaleString()} tokens`;
+    markdown += formatFiltersLine(filters);
+    markdown += '\n\n---\n\n';
+    for (const result of results) {
+        markdown += formatSearchResult(result);
+    }
+    markdown += formatPaginationFooter(pagination, tokenInfo);
+    return markdown;
+}
+const TOOL_NAME = 'jamf_docs_search';
+const TOOL_DESCRIPTION = `Search Jamf documentation for articles matching your query.
+
+This tool searches across all Jamf product documentation including Jamf Pro,
+Jamf School, Jamf Connect, and Jamf Protect. Results include article titles,
+snippets, and direct links.
+
+Args:
+  - query (string, required): Search keywords (2-200 characters)
+  - product (string, optional): Filter by product ID (jamf-pro, jamf-school, jamf-connect, jamf-protect)
+  - topic (string, optional): Filter by topic (enrollment, profiles, security, inventory, policies, smart-groups, apps, identity, api, network)
+  - version (string, optional): Filter by version (e.g., "11.5.0", "10.x")
+  - limit (number, optional): Maximum results per page 1-50 (default: 10)
+  - page (number, optional): Page number for pagination 1-100 (default: 1)
+  - maxTokens (number, optional): Maximum tokens in response 100-20000 (default: 5000)
+  - outputMode ('full' | 'compact'): Output detail level (default: 'full'). Use 'compact' for brief, token-efficient output
+  - responseFormat ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  For JSON format:
+  {
+    "total": number,
+    "query": string,
+    "results": [...],
+    "tokenInfo": {
+      "tokenCount": number,
+      "truncated": boolean,
+      "maxTokens": number
+    },
+    "pagination": {
+      "page": number,
+      "pageSize": number,
+      "totalPages": number,
+      "totalItems": number,
+      "hasNext": boolean,
+      "hasPrev": boolean
+    }
+  }
+
+  For Markdown format:
+  A formatted list of search results with pagination and token info.
+
+Examples:
+  - "How to configure SSO" → query="SSO configuration"
+  - "MDM enrollment steps" → query="MDM enrollment", topic="enrollment"
+  - "Jamf Pro configuration profiles" → query="configuration profile", product="jamf-pro", topic="profiles"
+  - Get page 2 of results → query="policy", page=2
+
+Errors:
+  - "No results found" if search returns empty
+  - "Invalid product ID" if product parameter is not recognized
+
+Note: Results are ranked by relevance. Use filters and pagination to navigate large result sets.`;
+export function registerSearchTool(server) {
+    server.registerTool(TOOL_NAME, {
+        title: 'Search Jamf Documentation',
+        description: TOOL_DESCRIPTION,
+        inputSchema: SearchInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (args) => {
+        // Parse and validate input
+        const parseResult = SearchInputSchema.safeParse(args);
+        if (!parseResult.success) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Invalid input: ${parseResult.error.message}` }]
+            };
+        }
+        const params = parseResult.data;
+        try {
+            // Validate product if provided
+            if (params.product !== undefined && !(params.product in JAMF_PRODUCTS)) {
+                return {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Invalid product ID: "${params.product}". Valid options: ${Object.keys(JAMF_PRODUCTS).join(', ')}`
+                        }]
+                };
+            }
+            // Validate topic if provided
+            if (params.topic !== undefined && !(params.topic in JAMF_TOPICS)) {
+                return {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Invalid topic ID: "${params.topic}". Valid options: ${Object.keys(JAMF_TOPICS).join(', ')}`
+                        }]
+                };
+            }
+            // Perform search with new parameters
+            const searchResult = await searchDocumentation({
+                query: params.query,
+                product: params.product,
+                topic: params.topic,
+                version: params.version,
+                limit: params.limit,
+                page: params.page,
+                maxTokens: params.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS
+            });
+            const { results, pagination, tokenInfo } = searchResult;
+            // Build response
+            const response = {
+                total: pagination.totalItems,
+                query: params.query,
+                results,
+                filters: {
+                    ...(params.product !== undefined ? { product: params.product } : {}),
+                    ...(params.version !== undefined ? { version: params.version } : {}),
+                    ...(params.topic !== undefined ? { topic: params.topic } : {})
+                },
+                tokenInfo,
+                pagination
+            };
+            // Handle no results with suggestions
+            if (results.length === 0 && pagination.totalItems === 0) {
+                const suggestions = generateSearchSuggestions(params.query, params.product !== undefined, params.topic !== undefined);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: formatSearchSuggestions(params.query, suggestions)
+                        }]
+                };
+            }
+            // Format output
+            if (params.responseFormat === ResponseFormat.JSON) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2)
+                        }]
+                };
+            }
+            // Markdown format (full or compact)
+            const markdown = params.outputMode === OutputMode.COMPACT
+                ? formatSearchResultsAsCompact(params.query, results, response.filters ?? {}, pagination, tokenInfo)
+                : formatSearchResultsAsMarkdown(params.query, results, response.filters ?? {}, pagination, tokenInfo);
+            return {
+                content: [{
+                        type: 'text',
+                        text: markdown
+                    }]
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                isError: true,
+                content: [{
+                        type: 'text',
+                        text: `Search error: ${errorMessage}\n\nPlease try again or use different search terms.`
+                    }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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