@mweinbach/apple-docs-mcp 1.0.0

package/dist/tools/get-technology-overviews.js

@@ -0,0 +1,306 @@
+import { technologyOverviewsCache, generateUrlCacheKey } from '../utils/cache.js';
+import { APPLE_URLS } from '../utils/constants.js';
+import { httpClient } from '../utils/http-client.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Handle get technology overviews
+ */
+export async function handleGetTechnologyOverviews(category, platform = 'all', searchQuery, includeSubcategories = true, limit = 50) {
+    try {
+        logger.info('Fetching technology overviews...');
+        // Generate cache key
+        const cacheKey = generateUrlCacheKey('technology-overviews', {
+            category,
+            platform,
+            searchQuery,
+            includeSubcategories,
+            limit,
+        });
+        // Try to get from cache first
+        const cachedResult = technologyOverviewsCache.get(cacheKey);
+        if (cachedResult) {
+            logger.debug('Technology overviews cache hit');
+            return cachedResult;
+        }
+        // Fetch both data files
+        const [overviewsData, overviewsIndex] = await Promise.all([
+            httpClient.getJson(APPLE_URLS.TECHNOLOGY_OVERVIEWS_JSON),
+            httpClient.getJson(APPLE_URLS.TECHNOLOGY_OVERVIEWS_INDEX_JSON),
+        ]);
+        // Parse and filter overviews
+        const overviews = parseOverviews(overviewsData, overviewsIndex);
+        const filteredOverviews = applyOverviewsFilters(overviews, {
+            category,
+            platform,
+            searchQuery,
+            includeSubcategories,
+            limit,
+        });
+        // Format output
+        const result = formatOverviewsList(filteredOverviews);
+        // Cache the result
+        technologyOverviewsCache.set(cacheKey, result);
+        return result;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : JSON.stringify(error);
+        logger.error('Error fetching technology overviews:', error);
+        return `Error: Failed to fetch technology overviews: ${errorMessage}`;
+    }
+}
+/**
+ * Parse overviews data
+ */
+function parseOverviews(overviewsData, overviewsIndex) {
+    const overviews = [];
+    // Process main overview sections
+    if (overviewsData.topicSections) {
+        overviewsData.topicSections.forEach(section => {
+            section.identifiers.forEach(identifier => {
+                const reference = overviewsData.references[identifier];
+                if (reference) {
+                    // Construct description from abstract array
+                    let description = '';
+                    if (reference.abstract && Array.isArray(reference.abstract)) {
+                        description = reference.abstract
+                            .map(part => part.text || '')
+                            .join('')
+                            .trim();
+                    }
+                    const overviewItem = {
+                        title: reference.title,
+                        url: reference.url ? `https://developer.apple.com${reference.url}` : '',
+                        description,
+                        category: extractCategoryFromUrl(reference.url),
+                        type: reference.kind ?? 'overview',
+                        identifier,
+                        sectionTitle: section.title,
+                        depth: 0,
+                    };
+                    overviews.push(overviewItem);
+                }
+            });
+        });
+    }
+    // Process index data for hierarchical structure
+    if (overviewsIndex.interfaceLanguages?.swift) {
+        processIndexSection(overviewsIndex.interfaceLanguages.swift, overviews, 0, null);
+    }
+    return overviews;
+}
+/**
+ * Process index section recursively
+ */
+function processIndexSection(sections, overviews, depth, parentSection) {
+    let currentSection = parentSection;
+    sections.forEach(section => {
+        // Track current section from group markers
+        if (section.type === 'groupMarker') {
+            currentSection = section.title;
+            // Process children with same depth but updated section
+            if (section.children) {
+                processIndexSection(section.children, overviews, depth, currentSection);
+            }
+            return;
+        }
+        // Check if this section already exists in overviews
+        const existingOverview = overviews.find(o => o.url.includes(section.path) || o.title === section.title);
+        if (existingOverview) {
+            // Update with additional info
+            existingOverview.path = section.path;
+            existingOverview.depth = depth;
+            existingOverview.type = section.type;
+            if (currentSection && !existingOverview.sectionTitle) {
+                existingOverview.sectionTitle = currentSection;
+            }
+        }
+        else {
+            // Add new overview item
+            const newOverview = {
+                title: section.title,
+                url: `https://developer.apple.com${section.path}`,
+                description: '',
+                category: extractCategoryFromUrl(section.path),
+                type: section.type,
+                identifier: section.path,
+                path: section.path,
+                depth,
+                sectionTitle: currentSection || '',
+            };
+            overviews.push(newOverview);
+        }
+        // Process children
+        if (section.children) {
+            processIndexSection(section.children, overviews, depth + 1, currentSection);
+        }
+    });
+}
+/**
+ * Extract category from URL
+ */
+function extractCategoryFromUrl(url) {
+    const match = url.match(/\/documentation\/technologyoverviews\/([^/]+)/i);
+    return match?.[1] ?? 'general';
+}
+/**
+ * Apply filters to overviews
+ */
+function applyOverviewsFilters(overviews, filters) {
+    let filtered = [...overviews];
+    // Category filter
+    if (filters.category) {
+        const categoryLower = filters.category.toLowerCase();
+        // First, find all items that match the category
+        const categoryItems = overviews.filter(overview => {
+            return overview.category.toLowerCase() === categoryLower ||
+                overview.title.toLowerCase() === categoryLower.replace(/-/g, ' ') ||
+                overview.path?.toLowerCase().includes(`/${categoryLower}`);
+        });
+        // If we found category items, also include their children
+        if (categoryItems.length > 0) {
+            const categoryPaths = categoryItems.map(item => item.path || item.url);
+            filtered = overviews.filter(overview => {
+                // Include the category items themselves
+                if (categoryItems.includes(overview)) {
+                    return true;
+                }
+                // Include children of category items
+                if (overview.path || overview.url) {
+                    const overviewPath = (overview.path || overview.url).replace('https://developer.apple.com', '');
+                    return categoryPaths.some(categoryPath => {
+                        const cleanCategoryPath = categoryPath.replace('https://developer.apple.com', '');
+                        return overviewPath.startsWith(cleanCategoryPath) && overviewPath !== cleanCategoryPath;
+                    });
+                }
+                return false;
+            });
+        }
+        else {
+            // No matching category found
+            filtered = [];
+        }
+    }
+    // Platform filter
+    if (filters.platform && filters.platform !== 'all') {
+        const platformLower = filters.platform.toLowerCase();
+        filtered = filtered.filter(overview => overview.title.toLowerCase().includes(platformLower) ||
+            overview.description.toLowerCase().includes(platformLower) ||
+            overview.path?.toLowerCase().includes(platformLower));
+    }
+    // Search query filter
+    if (filters.searchQuery) {
+        const queryLower = filters.searchQuery.toLowerCase();
+        filtered = filtered.filter(overview => overview.title.toLowerCase().includes(queryLower) ||
+            overview.description.toLowerCase().includes(queryLower));
+    }
+    // If not including subcategories, filter out deep items
+    if (!filters.includeSubcategories) {
+        // Keep only top-level items (depth 0 or 1)
+        filtered = filtered.filter(overview => overview.depth <= 1);
+    }
+    // Apply limit (limit top-level items, but include their children)
+    if (filters.limit && filters.limit > 0) {
+        // Count top-level items
+        let topLevelCount = 0;
+        const limitedResults = [];
+        for (const item of filtered) {
+            if (item.depth === 0) {
+                if (topLevelCount >= filters.limit) {
+                    break;
+                }
+                topLevelCount++;
+            }
+            limitedResults.push(item);
+        }
+        filtered = limitedResults;
+    }
+    return filtered;
+}
+/**
+ * Format overviews list
+ */
+function formatOverviewsList(overviews) {
+    if (overviews.length === 0) {
+        return 'No technology overviews found matching the specified criteria.';
+    }
+    let content = '# Apple Developer Technology Overviews\n\n';
+    content += '*Comprehensive guides for Apple platforms and technologies*\n\n';
+    // Group by category and depth for better organization
+    const grouped = groupOverviewsByCategory(overviews);
+    // Format each category
+    Object.entries(grouped).forEach(([category, items]) => {
+        const categoryTitle = formatCategoryTitle(category);
+        content += `## ${categoryTitle}\n\n`;
+        // Sort items by depth and title
+        items.sort((a, b) => {
+            if (a.depth !== b.depth) {
+                return a.depth - b.depth;
+            }
+            return a.title.localeCompare(b.title);
+        });
+        // Format items with proper indentation
+        items.forEach(item => {
+            const indent = '  '.repeat(item.depth);
+            // Title with link
+            content += `${indent}### [${item.title}](${item.url})\n`;
+            // Type badge
+            if (item.type && item.type !== 'overview') {
+                content += `${indent}*Type: ${formatType(item.type)}*\n`;
+            }
+            // Description
+            if (item.description) {
+                content += `${indent}${item.description}\n`;
+            }
+            content += '\n';
+        });
+    });
+    content += '\n---\n\n[Explore all Technology Overviews](https://developer.apple.com/documentation/technologyoverviews)';
+    return content;
+}
+/**
+ * Group overviews by category
+ */
+function groupOverviewsByCategory(overviews) {
+    return overviews.reduce((acc, overview) => {
+        // Use sectionTitle for top-level items, otherwise use the parent category
+        let groupKey = overview.sectionTitle;
+        // If no section title or it's a nested item, try to group by top-level category
+        if (!groupKey && overview.depth > 0) {
+            // Extract top-level category from the path
+            const pathParts = overview.category.split('-');
+            groupKey = formatCategoryTitle(pathParts[0]);
+        }
+        // Default to formatted category
+        if (!groupKey) {
+            groupKey = formatCategoryTitle(overview.category);
+        }
+        if (!acc[groupKey]) {
+            acc[groupKey] = [];
+        }
+        acc[groupKey].push(overview);
+        return acc;
+    }, {});
+}
+/**
+ * Format category title
+ */
+function formatCategoryTitle(category) {
+    return category
+        .replace(/-/g, ' ')
+        .split(' ')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * Format type
+ */
+function formatType(type) {
+    const typeMap = {
+        'collection': 'Collection',
+        'article': 'Article',
+        'module': 'Module',
+        'groupMarker': 'Group',
+    };
+    return typeMap[type] ?? type;
+}
+//# sourceMappingURL=get-technology-overviews.js.map

package/dist/tools/get-technology-overviews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-technology-overviews.js","sourceRoot":"","sources":["../../src/tools/get-technology-overviews.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAqC5C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,QAAiB,EACjB,WAAmB,KAAK,EACxB,WAAoB,EACpB,uBAAgC,IAAI,EACpC,QAAgB,EAAE;IAElB,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAEhD,qBAAqB;QACrB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,sBAAsB,EAAE;YAC3D,QAAQ;YACR,QAAQ;YACR,WAAW;YACX,oBAAoB;YACpB,KAAK;SACN,CAAC,CAAC;QAEH,8BAA8B;QAC9B,MAAM,YAAY,GAAG,wBAAwB,CAAC,GAAG,CAAS,QAAQ,CAAC,CAAC;QACpE,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC/C,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,wBAAwB;QACxB,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACxD,UAAU,CAAC,OAAO,CAA0B,UAAU,CAAC,yBAAyB,CAAC;YACjF,UAAU,CAAC,OAAO,CAA+B,UAAU,CAAC,+BAA+B,CAAC;SAC7F,CAAC,CAAC;QAEH,6BAA6B;QAC7B,MAAM,SAAS,GAAG,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAChE,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,SAAS,EAAE;YACzD,QAAQ;YACR,QAAQ;YACR,WAAW;YACX,oBAAoB;YACpB,KAAK;SACN,CAAC,CAAC;QAEH,gBAAgB;QAChB,MAAM,MAAM,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;QAEtD,mBAAmB;QACnB,wBAAwB,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAE/C,OAAO,MAAM,CAAC;IAEhB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACpF,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;QAC5D,OAAO,gDAAgD,YAAY,EAAE,CAAC;IACxE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,aAAsC,EAAE,cAA4C;IAC1G,MAAM,SAAS,GAAmB,EAAE,CAAC;IAErC,iCAAiC;IACjC,IAAI,aAAa,CAAC,aAAa,EAAE,CAAC;QAChC,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC5C,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;gBACvC,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBACvD,IAAI,SAAS,EAAE,CAAC;oBACd,4CAA4C;oBAC5C,IAAI,WAAW,GAAG,EAAE,CAAC;oBACrB,IAAI,SAAS,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC5D,WAAW,GAAG,SAAS,CAAC,QAAQ;6BAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;6BAC5B,IAAI,CAAC,EAAE,CAAC;6BACR,IAAI,EAAE,CAAC;oBACZ,CAAC;oBAED,MAAM,YAAY,GAAiB;wBACjC,KAAK,EAAE,SAAS,CAAC,KAAK;wBACtB,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,8BAA8B,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE;wBACvE,WAAW;wBACX,QAAQ,EAAE,sBAAsB,CAAC,SAAS,CAAC,GAAG,CAAC;wBAC/C,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,UAAU;wBAClC,UAAU;wBACV,YAAY,EAAE,OAAO,CAAC,KAAK;wBAC3B,KAAK,EAAE,CAAC;qBACT,CAAC;oBAEF,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gDAAgD;IAChD,IAAI,cAAc,CAAC,kBAAkB,EAAE,KAAK,EAAE,CAAC;QAC7C,mBAAmB,CAAC,cAAc,CAAC,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,QAA2C,EAAE,SAAyB,EAAE,KAAa,EAAE,aAA4B;IAC9I,IAAI,cAAc,GAAG,aAAa,CAAC;IAEnC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACzB,2CAA2C;QAC3C,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACnC,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;YAC/B,uDAAuD;YACvD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,mBAAmB,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;YAC1E,CAAC;YACD,OAAO;QACT,CAAC;QAED,oDAAoD;QACpD,MAAM,gBAAgB,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAC1C,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAC1D,CAAC;QAEF,IAAI,gBAAgB,EAAE,CAAC;YACrB,8BAA8B;YAC9B,gBAAgB,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YACrC,gBAAgB,CAAC,KAAK,GAAG,KAAK,CAAC;YAC/B,gBAAgB,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YACrC,IAAI,cAAc,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,CAAC;gBACrD,gBAAgB,CAAC,YAAY,GAAG,cAAc,CAAC;YACjD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,wBAAwB;YACxB,MAAM,WAAW,GAAiB;gBAChC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,GAAG,EAAE,8BAA8B,OAAO,CAAC,IAAI,EAAE;gBACjD,WAAW,EAAE,EAAE;gBACf,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC;gBAC9C,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,UAAU,EAAE,OAAO,CAAC,IAAI;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK;gBACL,YAAY,EAAE,cAAc,IAAI,EAAE;aACnC,CAAC;YACF,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9B,CAAC;QAED,mBAAmB;QACnB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,mBAAmB,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,GAAW;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC1E,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,SAAyB,EACzB,OAMC;IAED,IAAI,QAAQ,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAE9B,kBAAkB;IAClB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAErD,gDAAgD;QAChD,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;YAChD,OAAO,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,aAAa;gBACjD,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;gBACjE,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,0DAA0D;QAC1D,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;YAEvE,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;gBACrC,wCAAwC;gBACxC,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACrC,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,qCAAqC;gBACrC,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;oBAClC,MAAM,YAAY,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;oBAChG,OAAO,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE;wBACvC,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;wBAClF,OAAO,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,YAAY,KAAK,iBAAiB,CAAC;oBAC1F,CAAC,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,6BAA6B;YAC7B,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QACnD,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACrD,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CACpC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YACpD,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC1D,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CACrD,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QACrD,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CACpC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;YACjD,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CACxD,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;QAClC,2CAA2C;QAC3C,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,kEAAkE;IAClE,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACvC,wBAAwB;QACxB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,MAAM,cAAc,GAAmB,EAAE,CAAC;QAE1C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;gBACrB,IAAI,aAAa,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;oBACnC,MAAM;gBACR,CAAC;gBACD,aAAa,EAAE,CAAC;YAClB,CAAC;YACD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,QAAQ,GAAG,cAAc,CAAC;IAC5B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,SAAyB;IACpD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,gEAAgE,CAAC;IAC1E,CAAC;IAED,IAAI,OAAO,GAAG,4CAA4C,CAAC;IAC3D,OAAO,IAAI,iEAAiE,CAAC;IAE7E,sDAAsD;IACtD,MAAM,OAAO,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAEpD,uBAAuB;IACvB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;QACpD,MAAM,aAAa,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACpD,OAAO,IAAI,MAAM,aAAa,MAAM,CAAC;QAErC,gCAAgC;QAChC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAClB,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxB,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YAC3B,CAAC;YACD,OAAO,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,uCAAuC;QACvC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACnB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEvC,kBAAkB;YAClB,OAAO,IAAI,GAAG,MAAM,QAAQ,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC;YAEzD,aAAa;YACb,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC1C,OAAO,IAAI,GAAG,MAAM,UAAU,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAC3D,CAAC;YAED,cAAc;YACd,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,OAAO,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC;YAC9C,CAAC;YAED,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,4GAA4G,CAAC;IAExH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,SAAyB;IACzD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;QACxC,0EAA0E;QAC1E,IAAI,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC;QAErC,gFAAgF;QAChF,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACpC,2CAA2C;YAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/C,QAAQ,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,gCAAgC;QAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnB,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACrB,CAAC;QACD,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAoC,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,OAAO,QAAQ;SACZ,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACzD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,OAAO,GAA2B;QACtC,YAAY,EAAE,YAAY;QAC1B,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,QAAQ;QAClB,aAAa,EAAE,OAAO;KACvB,CAAC;IACF,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC/B,CAAC"}

package/dist/tools/handlers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tool handlers for Apple Developer Documentation MCP Server
+ * Optimized for agent context windows with compact output support
+ */
+/**
+ * Tool handler function type
+ */
+export type ToolHandler = (args: unknown, server: any) => Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+/**
+ * Map of tool names to their handlers
+ */
+export declare const toolHandlers: Record<string, ToolHandler>;
+/**
+ * Handle tool call with the appropriate handler
+ */
+export declare function handleToolCall(toolName: string, args: unknown, server: any): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuCH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,GAAG,KACR,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA+fpD,CAAC;AAEF;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,GAAG,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAkBhF"}