@mweinbach/apple-docs-mcp 1.0.0

package/dist/tools/search-parser.js

@@ -0,0 +1,188 @@
+import * as cheerio from 'cheerio';
+import { parseSearchResult } from './search-result-parser.js';
+import { API_LIMITS } from '../utils/constants.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Formats search results for display
+ */
+export function formatSearchResults(results, query, filterType, searchUrl) {
+    let content = '';
+    // Add header
+    content += '# Apple Documentation Search Results\n\n';
+    content += `**Query:** "${query}"\n`;
+    content += `**Filter:** ${filterType}\n`;
+    content += `**Results found:** ${results.length}\n\n`;
+    // Check if query might be video-related
+    const videoSuggestion = getVideoSuggestion(query);
+    if (videoSuggestion) {
+        content += videoSuggestion;
+    }
+    if (results.length === 0) {
+        content += formatNoResultsMessage(query, filterType, searchUrl);
+        return content;
+    }
+    // Group results by type
+    const groupedResults = groupResultsByType(results);
+    // Format each group
+    Object.entries(groupedResults).forEach(([type, typeResults]) => {
+        content += formatResultGroup(type, typeResults);
+    });
+    // Add footer
+    content += formatSearchFooter(searchUrl);
+    return content;
+}
+/**
+ * Format no results message
+ */
+function formatNoResultsMessage(query, filterType, searchUrl) {
+    let content = '## No Results Found\n\n';
+    content += `No ${filterType === 'all' ? '' : filterType + ' '}results found for "${query}".\n\n`;
+    content += '### Suggestions:\n';
+    content += '- Try using different keywords\n';
+    content += '- Check spelling\n';
+    content += '- Use more general terms\n';
+    content += '- Try searching for framework names (e.g., "SwiftUI", "UIKit")\n';
+    // Add video-specific suggestion if applicable
+    const videoSuggestion = getVideoSuggestion(query);
+    if (videoSuggestion) {
+        content += '- For WWDC videos, use the dedicated WWDC tools\n';
+    }
+    content += `\n[View search on Apple Developer](${searchUrl})`;
+    return content;
+}
+/**
+ * Group results by type
+ */
+function groupResultsByType(results) {
+    const groups = {};
+    results.forEach(result => {
+        const displayType = getDisplayType(result.type);
+        if (!groups[displayType]) {
+            groups[displayType] = [];
+        }
+        groups[displayType].push(result);
+    });
+    return groups;
+}
+/**
+ * Get display type for result
+ */
+function getDisplayType(type) {
+    const typeDisplayNames = {
+        'documentation': '📚 API Documentation',
+        'documentation-article': '📄 Articles',
+        'documentation-tutorial': '📖 Tutorials',
+        'sample-code': '💻 Sample Code',
+        'guide': '📋 Guides',
+    };
+    return typeDisplayNames[type] || '📝 Other';
+}
+/**
+ * Format a group of results
+ */
+function formatResultGroup(type, results) {
+    let content = `## ${type}\n\n`;
+    results.forEach((result, index) => {
+        content += formatSingleResult(result, index + 1);
+    });
+    return content;
+}
+/**
+ * Format a single search result
+ */
+function formatSingleResult(result, index) {
+    let content = `### ${index}. ${result.title}`;
+    // Add badges
+    const badges = [];
+    if (result.beta) {
+        badges.push('🧪 Beta');
+    }
+    if (badges.length > 0) {
+        content += ` ${badges.join(' ')}`;
+    }
+    content += '\n\n';
+    // Add metadata
+    if (result.framework) {
+        content += `**Framework:** ${result.framework}\n`;
+    }
+    content += `**Type:** ${result.type.replace(/-/g, ' ')}\n`;
+    // Add description
+    if (result.description) {
+        content += `**Description:** ${result.description}\n`;
+    }
+    // Add URL
+    content += `**URL:** ${result.url}\n\n`;
+    return content;
+}
+/**
+ * Format search footer
+ */
+function formatSearchFooter(searchUrl) {
+    return `---\n\n[View all results on Apple Developer](${searchUrl})`;
+}
+/**
+ * Check if query might be video-related and provide WWDC tool suggestions
+ */
+function getVideoSuggestion(query) {
+    const videoKeywords = [
+        'video', 'wwdc', 'session', 'presentation', 'talk', 'keynote',
+        'demo', 'tutorial', 'walkthrough', 'overview', 'introduction',
+        'deep dive', 'best practices', 'tips', 'tricks',
+    ];
+    const queryLower = query.toLowerCase();
+    const hasVideoKeyword = videoKeywords.some(keyword => queryLower.includes(keyword));
+    // Also check for year patterns (e.g., "2024", "2025", "wwdc24")
+    const hasYearPattern = /\b(20[2-9][0-9]|wwdc[2-9][0-9])\b/i.test(query);
+    if (hasVideoKeyword || hasYearPattern) {
+        return `## 💡 Looking for WWDC Videos?
+
+This search covers documentation and samples, but not WWDC videos. For WWDC content, try these tools:
+
+- **\`list_wwdc_videos\`** - Browse WWDC videos by year, topic, or code availability
+- **\`search_wwdc_content\`** - Search through video transcripts and code examples
+- **\`browse_wwdc_topics\`** - Explore videos organized by topic categories
+
+---
+
+`;
+    }
+    return null;
+}
+/**
+ * Parse search results with reduced complexity
+ */
+export function parseSearchResults(html, query, searchUrl, filterType = 'all') {
+    try {
+        const $ = cheerio.load(html);
+        const results = [];
+        // Parse each search result (with limit)
+        $('.search-result').each((_, element) => {
+            if (results.length >= API_LIMITS.MAX_SEARCH_RESULTS) {
+                return false; // Stop parsing when limit reached
+            }
+            const result = parseSearchResult($(element), filterType);
+            if (result) {
+                results.push(result);
+            }
+            return true; // Continue parsing
+        });
+        // Format results
+        const formattedContent = formatSearchResults(results, query, filterType, searchUrl);
+        return {
+            content: [{
+                    type: 'text',
+                    text: formattedContent,
+                }],
+        };
+    }
+    catch (error) {
+        logger.error('Error parsing search results:', error);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error parsing search results: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                }],
+        };
+    }
+}
+//# sourceMappingURL=search-parser.js.map

package/dist/tools/search-parser.js.map

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

package/dist/tools/search-result-parser.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Search result parsing utilities
+ */
+import type * as cheerio from 'cheerio';
+export interface SearchResult {
+    title: string;
+    url: string;
+    type: string;
+    description: string;
+    framework?: string;
+    beta?: boolean;
+}
+/**
+ * Type mapping for search filters
+ */
+export declare const typeMapping: Record<string, string[]>;
+/**
+ * Extract search result type from element classes
+ */
+export declare function extractResultType(element: cheerio.Cheerio<any>): string;
+/**
+ * Check if result type is supported
+ */
+export declare function isResultTypeSupported(resultType: string, filterType: string): boolean;
+/**
+ * Extract result title and URL
+ */
+export declare function extractTitleAndUrl(resultItem: cheerio.Cheerio<any>): {
+    title: string;
+    url: string;
+};
+/**
+ * Check if URL is supported
+ */
+export declare function isUrlSupported(url: string): boolean;
+/**
+ * Extract result description
+ */
+export declare function extractDescription(resultItem: cheerio.Cheerio<any>): string;
+/**
+ * Extract framework information
+ */
+export declare function extractFramework(resultItem: cheerio.Cheerio<any>, url: string): string | undefined;
+/**
+ * Extract beta status
+ */
+export declare function extractBetaStatus(resultItem: cheerio.Cheerio<any>): boolean;
+/**
+ * Parse a single search result
+ */
+export declare function parseSearchResult(element: cheerio.Cheerio<any>, filterType: string): SearchResult | null;
+//# sourceMappingURL=search-result-parser.d.ts.map

package/dist/tools/search-result-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-result-parser.d.ts","sourceRoot":"","sources":["../../src/tools/search-result-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAIhD,CAAC;AAOF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAUvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAarF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAYnG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAqBnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAG3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoBlG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAK3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAC7B,UAAU,EAAE,MAAM,GACjB,YAAY,GAAG,IAAI,CAyBrB"}

package/dist/tools/search-result-parser.js

@@ -0,0 +1,137 @@
+/**
+ * Search result parsing utilities
+ */
+/**
+ * Type mapping for search filters
+ */
+export const typeMapping = {
+    all: ['documentation', 'documentation-article', 'documentation-tutorial', 'sample-code'],
+    documentation: ['documentation', 'documentation-article'],
+    sample: ['sample-code'],
+};
+/**
+ * Unsupported document types
+ */
+const UNSUPPORTED_TYPES = ['general', 'video', 'forums', 'news'];
+/**
+ * Extract search result type from element classes
+ */
+export function extractResultType(element) {
+    const classes = element.attr('class')?.split(' ') ?? [];
+    for (const className of classes) {
+        if (className !== 'search-result' && className.trim()) {
+            return className;
+        }
+    }
+    return 'other';
+}
+/**
+ * Check if result type is supported
+ */
+export function isResultTypeSupported(resultType, filterType) {
+    // Apply type filter
+    const allowedTypes = typeMapping[filterType] ?? typeMapping['all'];
+    if (!allowedTypes.includes(resultType)) {
+        return false;
+    }
+    // Exclude known unsupported types
+    if (UNSUPPORTED_TYPES.includes(resultType)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Extract result title and URL
+ */
+export function extractTitleAndUrl(resultItem) {
+    const titleElement = resultItem.find('.result-title');
+    const title = titleElement.text().trim();
+    const urlElement = titleElement.find('a');
+    let url = urlElement.attr('href') ?? '';
+    if (url && url.startsWith('/')) {
+        url = `https://developer.apple.com${url}`;
+    }
+    return { title, url };
+}
+/**
+ * Check if URL is supported
+ */
+export function isUrlSupported(url) {
+    if (!url) {
+        return false;
+    }
+    // Skip non-documentation URLs
+    if (!url.includes('/documentation/')) {
+        return false;
+    }
+    // Skip download links and zip files
+    if (url.includes('download.apple.com') || url.includes('.zip')) {
+        return false;
+    }
+    // Skip human interface guidelines
+    if (url.includes('/design/human-interface-guidelines/')) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Extract result description
+ */
+export function extractDescription(resultItem) {
+    const descriptionElement = resultItem.find('.result-description');
+    return descriptionElement.text().trim();
+}
+/**
+ * Extract framework information
+ */
+export function extractFramework(resultItem, url) {
+    // Try to extract from link text
+    const linkText = resultItem.find('.result-link').text().trim();
+    const frameworkMatch = linkText.match(/^([A-Z][a-zA-Z]+(?:\s+[A-Z][a-zA-Z]+)*)\s+[>›]/);
+    if (frameworkMatch) {
+        return frameworkMatch[1];
+    }
+    // Try to extract from URL
+    const urlMatch = url.match(/\/documentation\/([^\/]+)/);
+    if (urlMatch) {
+        const framework = urlMatch[1];
+        // Convert underscore to space and capitalize
+        return framework.split('_')
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    return undefined;
+}
+/**
+ * Extract beta status
+ */
+export function extractBetaStatus(resultItem) {
+    const titleText = resultItem.find('.result-title').text();
+    const descriptionText = resultItem.find('.result-description').text();
+    return titleText.includes('Beta') || descriptionText.includes('Beta');
+}
+/**
+ * Parse a single search result
+ */
+export function parseSearchResult(element, filterType) {
+    const resultType = extractResultType(element);
+    if (!isResultTypeSupported(resultType, filterType)) {
+        return null;
+    }
+    const { title, url } = extractTitleAndUrl(element);
+    if (!isUrlSupported(url)) {
+        return null;
+    }
+    const description = extractDescription(element);
+    const framework = extractFramework(element, url);
+    const beta = extractBetaStatus(element);
+    return {
+        title,
+        url,
+        type: resultType,
+        description,
+        framework,
+        beta,
+    };
+}
+//# sourceMappingURL=search-result-parser.js.map

package/dist/tools/search-result-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-result-parser.js","sourceRoot":"","sources":["../../src/tools/search-result-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAA6B;IACnD,GAAG,EAAE,CAAC,eAAe,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,aAAa,CAAC;IACxF,aAAa,EAAE,CAAC,eAAe,EAAE,uBAAuB,CAAC;IACzD,MAAM,EAAE,CAAC,aAAa,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA6B;IAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAExD,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;QAChC,IAAI,SAAS,KAAK,eAAe,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YACtD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,UAAkB;IAC1E,oBAAoB;IACpB,MAAM,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;IACnE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kCAAkC;IAClC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAgC;IACjE,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAEzC,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAExC,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,GAAG,GAAG,8BAA8B,GAAG,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oCAAoC;IACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kCAAkC;IAClC,IAAI,GAAG,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAgC;IACjE,MAAM,kBAAkB,GAAG,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClE,OAAO,kBAAkB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAgC,EAAE,GAAW;IAC5E,gCAAgC;IAChC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAC/D,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAExF,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACxD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC9B,6CAA6C;QAC7C,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;aACxB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aACzD,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAgC;IAChE,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,IAAI,EAAE,CAAC;IAEtE,OAAO,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA6B,EAC7B,UAAkB;IAElB,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE9C,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEnD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAExC,OAAO;QACL,KAAK;QACL,GAAG;QACH,IAAI,EAAE,UAAU;QAChB,WAAW;QACX,SAAS;QACT,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/tools/tools-guide.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Tool Selection Guide for Apple Docs MCP
+ *
+ * This guide helps AI assistants choose the right tool for each task
+ * and understand tool relationships and best practices.
+ */
+/**
+ * Tool Categories and Primary Use Cases
+ */
+export declare const TOOL_CATEGORIES: {
+    /**
+     * Search and Discovery Tools
+     * Use these to find information
+     */
+    SEARCH: {
+        tools: string[];
+        description: string;
+        whenToUse: string[];
+    };
+    /**
+     * Browse and Explore Tools
+     * Use these to discover what's available
+     */
+    BROWSE: {
+        tools: string[];
+        description: string;
+        whenToUse: string[];
+    };
+    /**
+     * Deep Dive Tools
+     * Use these to get detailed information
+     */
+    DETAILS: {
+        tools: string[];
+        description: string;
+        whenToUse: string[];
+    };
+    /**
+     * Analysis Tools
+     * Use these to understand relationships and compatibility
+     */
+    ANALYSIS: {
+        tools: string[];
+        description: string;
+        whenToUse: string[];
+    };
+    /**
+     * Stay Current Tools
+     * Use these to track updates and changes
+     */
+    UPDATES: {
+        tools: string[];
+        description: string;
+        whenToUse: string[];
+    };
+};
+/**
+ * Recommended Tool Workflows
+ */
+export declare const TOOL_WORKFLOWS: {
+    /**
+     * Learning a New Framework
+     */
+    LEARN_FRAMEWORK: {
+        steps: {
+            tool: string;
+            purpose: string;
+        }[];
+    };
+    /**
+     * Understanding an API
+     */
+    UNDERSTAND_API: {
+        steps: {
+            tool: string;
+            purpose: string;
+        }[];
+    };
+    /**
+     * Finding Code Examples
+     */
+    FIND_EXAMPLES: {
+        steps: {
+            tool: string;
+            purpose: string;
+        }[];
+    };
+    /**
+     * WWDC Content Discovery
+     */
+    WWDC_DISCOVERY: {
+        steps: {
+            tool: string;
+            purpose: string;
+        }[];
+    };
+};
+/**
+ * Tool Selection Decision Tree
+ */
+export declare function selectToolForQuery(query: string): string[];
+/**
+ * Common Tool Combinations
+ */
+export declare const TOOL_COMBINATIONS: {
+    SEARCH_AND_READ: string[];
+    FRAMEWORK_EXPLORE: string[];
+    WWDC_EXPLORE: string[];
+    API_ANALYSIS: string[];
+    CODE_EXAMPLES: string[];
+};
+/**
+ * Tool Usage Tips
+ */
+export declare const USAGE_TIPS: {
+    PERFORMANCE: string[];
+    ACCURACY: string[];
+    EFFICIENCY: string[];
+};
+/**
+ * Handle get_tool_guide request
+ */
+export declare function handleGetToolGuide(task: string): string;
+//# sourceMappingURL=tools-guide.d.ts.map

package/dist/tools/tools-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-guide.d.ts","sourceRoot":"","sources":["../../src/tools/tools-guide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;;OAGG;;;;;;IAWH;;;OAGG;;;;;;IAWH;;;OAGG;;;;;;IAWH;;;OAGG;;;;;;IAWH;;;OAGG;;;;;;CAUJ,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;;;;;;;IAWH;;OAEG;;;;;;;IAWH;;OAEG;;;;;;;IAUH;;OAEG;;;;;;;CAUJ,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA2C1D;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;CAe7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU;;;;CAuBtB,CAAC;AAqKF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiCvD"}