@mweinbach/apple-docs-mcp 1.0.0

package/dist/tools/tools-guide.js

@@ -0,0 +1,389 @@
+/**
+ * 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 const TOOL_CATEGORIES = {
+    /**
+     * Search and Discovery Tools
+     * Use these to find information
+     */
+    SEARCH: {
+        tools: ['search_apple_docs', 'search_wwdc_content'],
+        description: 'Primary tools for finding APIs, documentation, and video content',
+        whenToUse: [
+            'User asks about a specific API or framework',
+            'User wants to find documentation on a topic',
+            'User is looking for code examples or implementations',
+        ],
+    },
+    /**
+     * Browse and Explore Tools
+     * Use these to discover what's available
+     */
+    BROWSE: {
+        tools: ['list_technologies', 'search_framework_symbols', 'get_sample_code', 'list_wwdc_videos', 'browse_wwdc_topics'],
+        description: 'Tools for exploring available frameworks, APIs, and content',
+        whenToUse: [
+            'User wants to know what frameworks are available',
+            'User wants to explore APIs in a specific framework',
+            'User is browsing for examples or learning materials',
+        ],
+    },
+    /**
+     * Deep Dive Tools
+     * Use these to get detailed information
+     */
+    DETAILS: {
+        tools: ['get_apple_doc_content', 'get_wwdc_video'],
+        description: 'Tools for reading full documentation or video content',
+        whenToUse: [
+            'After finding content with search tools',
+            'User wants complete API documentation',
+            'User wants to read WWDC session transcript',
+        ],
+    },
+    /**
+     * Analysis Tools
+     * Use these to understand relationships and compatibility
+     */
+    ANALYSIS: {
+        tools: ['get_related_apis', 'resolve_references_batch', 'get_platform_compatibility', 'find_similar_apis', 'find_related_wwdc_videos'],
+        description: 'Tools for analyzing API relationships, compatibility, and alternatives',
+        whenToUse: [
+            'User needs to understand API inheritance or protocols',
+            'User wants to check platform/version compatibility',
+            'User is looking for alternative or better APIs',
+        ],
+    },
+    /**
+     * Stay Current Tools
+     * Use these to track updates and changes
+     */
+    UPDATES: {
+        tools: ['get_documentation_updates', 'get_technology_overviews'],
+        description: 'Tools for staying up-to-date with Apple platform changes',
+        whenToUse: [
+            'User wants to know what\'s new',
+            'User is tracking API changes',
+            'User wants overview of technology areas',
+        ],
+    },
+};
+/**
+ * Recommended Tool Workflows
+ */
+export const TOOL_WORKFLOWS = {
+    /**
+     * Learning a New Framework
+     */
+    LEARN_FRAMEWORK: {
+        steps: [
+            { tool: 'list_technologies', purpose: 'Find the framework identifier' },
+            { tool: 'search_framework_symbols', purpose: 'Explore available APIs' },
+            { tool: 'get_technology_overviews', purpose: 'Read conceptual guides' },
+            { tool: 'get_sample_code', purpose: 'Find example projects' },
+            { tool: 'list_wwdc_videos', purpose: 'Find relevant sessions' },
+        ],
+    },
+    /**
+     * Understanding an API
+     */
+    UNDERSTAND_API: {
+        steps: [
+            { tool: 'search_apple_docs', purpose: 'Find the API' },
+            { tool: 'get_apple_doc_content', purpose: 'Read full documentation' },
+            { tool: 'get_related_apis', purpose: 'Understand relationships' },
+            { tool: 'get_platform_compatibility', purpose: 'Check availability' },
+            { tool: 'find_similar_apis', purpose: 'Find alternatives' },
+        ],
+    },
+    /**
+     * Finding Code Examples
+     */
+    FIND_EXAMPLES: {
+        steps: [
+            { tool: 'search_apple_docs', purpose: 'Find code snippets in docs' },
+            { tool: 'get_sample_code', purpose: 'Find complete sample projects' },
+            { tool: 'search_wwdc_content', purpose: 'Search WWDC code examples' },
+            { tool: 'get_wwdc_code_examples', purpose: 'Browse all WWDC code' },
+        ],
+    },
+    /**
+     * WWDC Content Discovery
+     */
+    WWDC_DISCOVERY: {
+        steps: [
+            { tool: 'list_wwdc_videos', purpose: 'Browse available sessions' },
+            { tool: 'browse_wwdc_topics', purpose: 'Explore by topic' },
+            { tool: 'search_wwdc_content', purpose: 'Search specific content' },
+            { tool: 'get_wwdc_video', purpose: 'Read full transcript' },
+            { tool: 'find_related_wwdc_videos', purpose: 'Find related sessions' },
+        ],
+    },
+};
+/**
+ * Tool Selection Decision Tree
+ */
+export function selectToolForQuery(query) {
+    const queryLower = query.toLowerCase();
+    const recommendedTools = [];
+    // Search queries
+    if (queryLower.includes('search') || queryLower.includes('find')) {
+        if (queryLower.includes('video') || queryLower.includes('wwdc')) {
+            recommendedTools.push('search_wwdc_content');
+        }
+        else {
+            recommendedTools.push('search_apple_docs');
+        }
+    }
+    // Browse/list queries
+    if (queryLower.includes('list') || queryLower.includes('browse') || queryLower.includes('show all')) {
+        if (queryLower.includes('framework') || queryLower.includes('technolog')) {
+            recommendedTools.push('list_technologies');
+        }
+        else if (queryLower.includes('video') || queryLower.includes('wwdc')) {
+            recommendedTools.push('list_wwdc_videos');
+        }
+        else if (queryLower.includes('sample') || queryLower.includes('example')) {
+            recommendedTools.push('get_sample_code');
+        }
+    }
+    // API analysis queries
+    if (queryLower.includes('inherit') || queryLower.includes('protocol') || queryLower.includes('conform')) {
+        recommendedTools.push('get_related_apis');
+    }
+    if (queryLower.includes('platform') || queryLower.includes('compatibility') || queryLower.includes('available')) {
+        recommendedTools.push('get_platform_compatibility');
+    }
+    if (queryLower.includes('alternative') || queryLower.includes('similar') || queryLower.includes('instead')) {
+        recommendedTools.push('find_similar_apis');
+    }
+    // Update queries
+    if (queryLower.includes('new') || queryLower.includes('update') || queryLower.includes('change')) {
+        recommendedTools.push('get_documentation_updates');
+    }
+    return recommendedTools;
+}
+/**
+ * Common Tool Combinations
+ */
+export const TOOL_COMBINATIONS = {
+    // Search then read pattern
+    SEARCH_AND_READ: ['search_apple_docs', 'get_apple_doc_content'],
+    // Framework exploration pattern
+    FRAMEWORK_EXPLORE: ['list_technologies', 'search_framework_symbols'],
+    // WWDC discovery pattern
+    WWDC_EXPLORE: ['list_wwdc_videos', 'get_wwdc_video'],
+    // API analysis pattern
+    API_ANALYSIS: ['get_related_apis', 'get_platform_compatibility', 'find_similar_apis'],
+    // Code example pattern
+    CODE_EXAMPLES: ['search_apple_docs', 'get_sample_code', 'get_wwdc_code_examples'],
+};
+/**
+ * Tool Usage Tips
+ */
+export const USAGE_TIPS = {
+    // Performance tips
+    PERFORMANCE: [
+        'Use specific search queries to get better results',
+        'Set appropriate limits to avoid overwhelming output',
+        'Use type filters when searching for specific kinds of APIs',
+        'Use compact: true for discovery (reduces token usage by ~80%)',
+    ],
+    // Accuracy tips
+    ACCURACY: [
+        'Framework names are case-sensitive in some tools',
+        'Use list_technologies to get exact framework identifiers',
+        'WWDC tools have offline data from 2020-2025',
+    ],
+    // Efficiency tips
+    EFFICIENCY: [
+        'Start with search/browse tools before detailed reads',
+        'Use boolean flags to include only needed information',
+        'Combine related tools in sequence for comprehensive results',
+        'Use unified tools (apple_docs, wwdc, analyze_api) for simpler workflows',
+    ],
+};
+const workflows = [
+    {
+        name: 'Learning a Framework',
+        pattern: /learn|getting started|tutorial|beginner|introduction|basics/i,
+        description: 'Start with overview content, then dive into specific APIs',
+        tools: [
+            { tool: 'get_technology_overviews', purpose: 'Get high-level guides and best practices' },
+            { tool: 'list_technologies', purpose: 'Discover framework structure' },
+            { tool: 'get_sample_code', purpose: 'Find working examples' },
+            { tool: 'wwdc', purpose: 'Watch educational sessions (action: search)' },
+        ],
+    },
+    {
+        name: 'Finding WWDC Content',
+        pattern: /wwdc|video|session|keynote|watch|presentation/i,
+        description: 'Use the unified wwdc tool for all WWDC content',
+        tools: [
+            { tool: 'wwdc', purpose: 'Unified access to all WWDC content' },
+        ],
+    },
+    {
+        name: 'API Reference Lookup',
+        pattern: /api|class|struct|protocol|method|property|function|documentation|docs/i,
+        description: 'Search then get detailed documentation',
+        tools: [
+            { tool: 'search_apple_docs', purpose: 'Find API documentation' },
+            { tool: 'get_apple_doc_content', purpose: 'Get full documentation details' },
+            { tool: 'analyze_api', purpose: 'Understand relationships and alternatives' },
+        ],
+    },
+    {
+        name: 'Platform Compatibility',
+        pattern: /ios \d+|macos \d+|platform|availability|deprecated|version|minimum|requirement/i,
+        description: 'Check API availability across platforms',
+        tools: [
+            { tool: 'get_platform_compatibility', purpose: 'Check version requirements' },
+            { tool: 'get_apple_doc_content', purpose: 'With includePlatformAnalysis: true' },
+        ],
+    },
+    {
+        name: 'Code Examples',
+        pattern: /code|example|sample|implementation|how to|snippet/i,
+        description: 'Find code examples from samples and WWDC',
+        tools: [
+            { tool: 'get_sample_code', purpose: 'Complete sample projects from Apple' },
+            { tool: 'wwdc', purpose: 'Code examples from sessions (action: code)' },
+            { tool: 'search_apple_docs', purpose: 'Search with type: "sample"' },
+        ],
+    },
+    {
+        name: 'Finding Alternatives',
+        pattern: /alternative|similar|replace|deprecated|modern|equivalent|instead/i,
+        description: 'Find alternative or modern APIs',
+        tools: [
+            { tool: 'analyze_api', purpose: 'With analysis: "similar"' },
+            { tool: 'get_related_apis', purpose: 'Find See Also recommendations' },
+        ],
+    },
+    {
+        name: 'Framework Exploration',
+        pattern: /explore|browse|discover|list|what|available/i,
+        description: 'Browse available frameworks and symbols',
+        tools: [
+            { tool: 'list_technologies', purpose: 'Browse all frameworks' },
+            { tool: 'search_framework_symbols', purpose: 'Explore symbols in a framework' },
+        ],
+    },
+    {
+        name: 'Updates and News',
+        pattern: /new|update|latest|release|announcement|change/i,
+        description: 'Find recent updates and changes',
+        tools: [
+            { tool: 'get_documentation_updates', purpose: 'Track API updates and announcements' },
+            { tool: 'wwdc', purpose: 'Latest WWDC sessions (action: list, year: "2025")' },
+        ],
+    },
+];
+/**
+ * Get tool description for guide
+ */
+function getToolDescriptionForGuide(tool) {
+    const descriptions = {
+        'apple_docs': 'Universal entry point - routes to appropriate tool automatically',
+        'wwdc': 'Unified WWDC access - list, search, get details, code examples',
+        'analyze_api': 'API analysis - related APIs, alternatives, references',
+        'get_tool_guide': 'This tool - get recommendations',
+        'search_apple_docs': 'Search documentation by keywords',
+        'get_apple_doc_content': 'Get full documentation from URL',
+        'list_technologies': 'Browse all Apple frameworks',
+        'search_framework_symbols': 'Explore symbols within a framework',
+        'get_sample_code': 'Browse complete sample projects',
+        'get_documentation_updates': 'Track API updates and announcements',
+        'get_technology_overviews': 'High-level guides and tutorials',
+        'get_platform_compatibility': 'Check API availability across platforms',
+        'get_related_apis': 'Find inheritance and protocol relationships',
+        'find_similar_apis': 'Discover alternative APIs',
+        'resolve_references_batch': 'Resolve all referenced types',
+    };
+    return descriptions[tool] || 'Documentation tool';
+}
+/**
+ * Find matching workflows for a task
+ */
+function findMatchingWorkflows(task) {
+    return workflows.filter(w => w.pattern.test(task));
+}
+/**
+ * Select recommended tools based on query
+ */
+function selectToolsForTask(task) {
+    const taskLower = task.toLowerCase();
+    const tools = [];
+    // Check for URL - direct to get_apple_doc_content
+    if (taskLower.includes('developer.apple.com')) {
+        tools.push('get_apple_doc_content');
+        return tools;
+    }
+    // Check patterns
+    if (/wwdc|video|session/.test(taskLower)) {
+        tools.push('wwdc');
+    }
+    if (/search|find|look/.test(taskLower) && !/wwdc|video/.test(taskLower)) {
+        tools.push('search_apple_docs');
+    }
+    if (/api|class|struct|protocol/.test(taskLower)) {
+        tools.push('get_apple_doc_content', 'analyze_api');
+    }
+    if (/sample|example|code/.test(taskLower)) {
+        tools.push('get_sample_code');
+    }
+    if (/learn|tutorial|getting started/.test(taskLower)) {
+        tools.push('get_technology_overviews');
+    }
+    if (/platform|availability|ios|macos/.test(taskLower)) {
+        tools.push('get_platform_compatibility');
+    }
+    if (/framework|list|browse/.test(taskLower)) {
+        tools.push('list_technologies');
+    }
+    // Default recommendation
+    if (tools.length === 0) {
+        tools.push('apple_docs');
+    }
+    return [...new Set(tools)];
+}
+/**
+ * Handle get_tool_guide request
+ */
+export function handleGetToolGuide(task) {
+    const recommendedTools = selectToolsForTask(task);
+    const matchingWorkflows = findMatchingWorkflows(task);
+    let guide = '# Tool Recommendation\n\n';
+    guide += `**Task:** ${task}\n\n`;
+    // Recommended tools
+    guide += '## Recommended Tools\n\n';
+    if (recommendedTools.length > 0) {
+        recommendedTools.forEach(tool => {
+            guide += `- **${tool}**: ${getToolDescriptionForGuide(tool)}\n`;
+        });
+    }
+    // Matching workflows
+    if (matchingWorkflows.length > 0) {
+        guide += '\n## Suggested Workflow\n\n';
+        const workflow = matchingWorkflows[0];
+        guide += `**${workflow.name}**: ${workflow.description}\n\n`;
+        workflow.tools.forEach((step, i) => {
+            guide += `${i + 1}. \`${step.tool}\` - ${step.purpose}\n`;
+        });
+    }
+    // Quick tips
+    guide += '\n## Quick Tips\n\n';
+    guide += '- Use `compact: true` for discovery (returns titles + URLs only)\n';
+    guide += '- Use `apple_docs` if unsure - it auto-routes your query\n';
+    guide += '- Use `wwdc` for all WWDC content (replaces 7 individual tools)\n';
+    guide += '- Use `analyze_api` for deep API analysis (replaces 3 tools)\n';
+    return guide;
+}
+//# sourceMappingURL=tools-guide.js.map

package/dist/tools/tools-guide.js.map

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

package/dist/tools/wwdc/content-extractor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * WWDC video content extractor
+ */
+import type { WWDCVideo } from '../../types/wwdc.js';
+/**
+ * Extract complete content for a single WWDC video
+ */
+export declare function extractVideoContent(videoUrl: string, videoId: string, year: string, knownTopics?: string[]): Promise<WWDCVideo>;
+//# sourceMappingURL=content-extractor.d.ts.map

package/dist/tools/wwdc/content-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-extractor.d.ts","sourceRoot":"","sources":["../../../src/tools/wwdc/content-extractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,SAAS,EAOV,MAAM,qBAAqB,CAAC;AAG7B;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,SAAS,CAAC,CAsEpB"}