@mweinbach/apple-docs-mcp 1.0.0

package/dist/constants/browser-headers.js

@@ -0,0 +1,166 @@
+/**
+ * Browser-specific HTTP header templates for authentic browser simulation
+ *
+ * Based on real browser behavior analysis for different browser types.
+ * These templates ensure requests look authentic and reduce detection risk.
+ */
+/**
+ * Browser-specific header templates
+ *
+ * Each template is crafted to match real browser behavior:
+ * - Accept headers reflect browser's format support
+ * - Sec-Fetch-* headers match browser security policies
+ * - Language preferences follow browser defaults
+ */
+export const BROWSER_HEADERS = {
+    chrome: {
+        'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8',
+        'Accept-Encoding': 'gzip, deflate, br',
+        'Accept-Language': 'en-US,en;q=0.9',
+        'DNT': '1',
+        'Sec-CH-UA': '"Not A(Brand";v="99", "Google Chrome";v="121", "Chromium";v="121"',
+        'Sec-CH-UA-Mobile': '?0',
+        'Sec-CH-UA-Platform': '"macOS"',
+        'Sec-Fetch-Dest': 'document',
+        'Sec-Fetch-Mode': 'navigate',
+        'Sec-Fetch-Site': 'none',
+        'Sec-Fetch-User': '?1',
+        'Upgrade-Insecure-Requests': '1',
+        'Cache-Control': 'max-age=0',
+    },
+    firefox: {
+        'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8',
+        'Accept-Encoding': 'gzip, deflate, br',
+        'Accept-Language': 'en-US,en;q=0.5',
+        'DNT': '1',
+        'Upgrade-Insecure-Requests': '1',
+        'Cache-Control': 'max-age=0',
+    },
+    safari: {
+        'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+        'Accept-Encoding': 'gzip, deflate, br',
+        'Accept-Language': 'en-us',
+        'DNT': '1',
+        'Cache-Control': 'max-age=0',
+    },
+    edge: {
+        'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8',
+        'Accept-Encoding': 'gzip, deflate, br',
+        'Accept-Language': 'en-US,en;q=0.9',
+        'DNT': '1',
+        'Sec-CH-UA': '"Not A(Brand";v="99", "Microsoft Edge";v="121", "Chromium";v="121"',
+        'Sec-CH-UA-Mobile': '?0',
+        'Sec-CH-UA-Platform': '"macOS"',
+        'Sec-Fetch-Dest': 'document',
+        'Sec-Fetch-Mode': 'navigate',
+        'Sec-Fetch-Site': 'none',
+        'Sec-Fetch-User': '?1',
+        'Upgrade-Insecure-Requests': '1',
+        'Cache-Control': 'max-age=0',
+    },
+};
+/**
+ * Simplified header templates for basic compatibility mode
+ */
+export const SIMPLE_BROWSER_HEADERS = {
+    chrome: {
+        'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+        'Accept-Encoding': 'gzip, deflate',
+        'Accept-Language': 'en-US,en;q=0.9',
+    },
+    firefox: {
+        'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+        'Accept-Encoding': 'gzip, deflate',
+        'Accept-Language': 'en-US,en;q=0.5',
+    },
+    safari: {
+        'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+        'Accept-Encoding': 'gzip, deflate',
+        'Accept-Language': 'en-us',
+    },
+    edge: {
+        'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+        'Accept-Encoding': 'gzip, deflate',
+        'Accept-Language': 'en-US,en;q=0.9',
+    },
+};
+/**
+ * Language preference pools for rotation
+ */
+export const LANGUAGE_PREFERENCES = [
+    // English variations
+    [
+        { language: 'en-US', quality: 1.0 },
+        { language: 'en', quality: 0.9 },
+    ],
+    [
+        { language: 'en-GB', quality: 1.0 },
+        { language: 'en', quality: 0.9 },
+    ],
+    [
+        { language: 'en-CA', quality: 1.0 },
+        { language: 'en', quality: 0.9 },
+    ],
+    [
+        { language: 'en-AU', quality: 1.0 },
+        { language: 'en', quality: 0.9 },
+    ],
+    // English + other languages
+    [
+        { language: 'en-US', quality: 1.0 },
+        { language: 'en', quality: 0.9 },
+        { language: 'es', quality: 0.5 },
+    ],
+    [
+        { language: 'en-US', quality: 1.0 },
+        { language: 'en', quality: 0.9 },
+        { language: 'fr', quality: 0.4 },
+    ],
+    [
+        { language: 'en-US', quality: 1.0 },
+        { language: 'en', quality: 0.9 },
+        { language: 'de', quality: 0.3 },
+    ],
+    [
+        { language: 'en-US', quality: 1.0 },
+        { language: 'en', quality: 0.9 },
+        { language: 'zh-CN', quality: 0.8 },
+        { language: 'zh', quality: 0.7 },
+    ],
+];
+/**
+ * Platform-specific Sec-CH-UA-Platform values
+ */
+export const PLATFORM_VALUES = {
+    macOS: ['"macOS"'],
+    windows: ['"Windows"'],
+    linux: ['"Linux"'],
+};
+/**
+ * Browser version strings for Sec-CH-UA headers
+ */
+export const BROWSER_VERSIONS = {
+    chrome: [
+        '"Not A(Brand";v="99", "Google Chrome";v="121", "Chromium";v="121"',
+        '"Not A(Brand";v="99", "Google Chrome";v="120", "Chromium";v="120"',
+        '"Not A(Brand";v="99", "Google Chrome";v="119", "Chromium";v="119"',
+    ],
+    edge: [
+        '"Not A(Brand";v="99", "Microsoft Edge";v="121", "Chromium";v="121"',
+        '"Not A(Brand";v="99", "Microsoft Edge";v="120", "Chromium";v="120"',
+        '"Not A(Brand";v="99", "Microsoft Edge";v="119", "Chromium";v="119"',
+    ],
+};
+/**
+ * DNT (Do Not Track) values for privacy preference simulation
+ */
+export const DNT_VALUES = ['1', '0'];
+/**
+ * Cache-Control values for different request types
+ */
+export const CACHE_CONTROL_VALUES = [
+    'max-age=0',
+    'no-cache',
+    'max-age=0, no-cache',
+];
+//# sourceMappingURL=browser-headers.js.map

package/dist/constants/browser-headers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+export default class AppleDeveloperDocsMCPServer {
+    private server;
+    /**
+     * Helper method to handle async operations with consistent error handling
+     */
+    private handleAsyncOperation;
+    constructor();
+    private setupTools;
+    searchAppleDocs(query: string, type?: string): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+    getAppleDocContent(url: string, includeRelatedApis?: boolean, includeReferences?: boolean, includeSimilarApis?: boolean, includePlatformAnalysis?: boolean): Promise<any>;
+    listTechnologies(category?: string, language?: string, includeBeta?: boolean, limit?: number): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+    searchFrameworkSymbols(framework: string, symbolType?: string, namePattern?: string, language?: string, limit?: number): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+    getRelatedApis(apiUrl: string, includeInherited?: boolean, includeConformance?: boolean, includeSeeAlso?: boolean): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+    resolveReferencesBatch(sourceUrl: string, maxReferences?: number, filterByType?: string): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+    getPlatformCompatibility(apiUrl: string, compareMode?: string, includeRelated?: boolean): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+    findSimilarApis(apiUrl: string, searchDepth?: string, filterByCategory?: string, includeAlternatives?: boolean): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+    getDocumentationUpdates(category?: string, technology?: string, year?: string, searchQuery?: string, includeBeta?: boolean, limit?: number): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+    getTechnologyOverviews(category?: string, platform?: string, searchQuery?: string, includeSubcategories?: boolean, limit?: number): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+    getSampleCode(framework?: string, beta?: 'include' | 'exclude' | 'only', searchQuery?: string, limit?: number): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+    private setupErrorHandling;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { parseSearchResults } from './tools/search-parser.js';
+import { fetchAppleDocJson } from './tools/doc-fetcher.js';
+import { handleListTechnologies } from './tools/list-technologies.js';
+import { searchFrameworkSymbols } from './tools/search-framework-symbols.js';
+import { toolDefinitions } from './tools/definitions.js';
+import { handleToolCall } from './tools/handlers.js';
+import { handleGetRelatedApis } from './tools/get-related-apis.js';
+import { handleResolveReferencesBatch } from './tools/resolve-references-batch.js';
+import { handleGetPlatformCompatibility } from './tools/get-platform-compatibility.js';
+import { handleFindSimilarApis } from './tools/find-similar-apis.js';
+import { handleGetDocumentationUpdates } from './tools/get-documentation-updates.js';
+import { handleGetTechnologyOverviews } from './tools/get-technology-overviews.js';
+import { handleGetSampleCode } from './tools/get-sample-code.js';
+import { APPLE_URLS } from './utils/constants.js';
+import { isValidAppleDeveloperUrl } from './utils/url-converter.js';
+import { validateInput, ErrorType, createStandardErrorResponse, createToolErrorResponse } from './utils/error-handler.js';
+import { httpClient } from './utils/http-client.js';
+import { preloadPopularFrameworks } from './utils/preloader.js';
+import { warmUpCaches, schedulePeriodicCacheRefresh } from './utils/cache-warmer.js';
+import { logger } from './utils/logger.js';
+import { API_LIMITS } from './utils/constants.js';
+export default class AppleDeveloperDocsMCPServer {
+    server;
+    /**
+     * Helper method to handle async operations with consistent error handling
+     */
+    async handleAsyncOperation(operation, operationName) {
+        try {
+            const result = await operation();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: result,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            // If error is already an AppError, use tool-specific suggestions
+            if (error && typeof error === 'object' && 'type' in error) {
+                return createToolErrorResponse(error, operationName);
+            }
+            return createStandardErrorResponse(error, operationName);
+        }
+    }
+    constructor() {
+        this.server = new Server({
+            name: 'apple-docs-mcp',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupTools();
+        this.setupErrorHandling();
+    }
+    setupTools() {
+        // const cacheStatsSchema = z.object({});
+        // 处理工具列表请求
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: toolDefinitions,
+            };
+        });
+        // 处理工具调用请求
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                return await handleToolCall(name, args, this);
+            }
+            catch (error) {
+                const appError = error instanceof Error
+                    ? { type: 'UNKNOWN', message: error.message, originalError: error }
+                    : { type: 'UNKNOWN', message: 'An unknown error occurred' };
+                logger.error(`Tool ${name} failed:`, appError);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: ${appError.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    async searchAppleDocs(query, type = 'all') {
+        try {
+            // 输入验证
+            const queryValidation = validateInput(query, 'Search query');
+            if (queryValidation) {
+                return createToolErrorResponse(queryValidation, 'search_apple_docs');
+            }
+            // 创建 Apple Developer Documentation 搜索 URL
+            const searchUrl = `${APPLE_URLS.SEARCH}?q=${encodeURIComponent(query)}`;
+            logger.info(`Searching Apple docs for: ${query}`);
+            // 获取搜索结果页面
+            const html = await httpClient.getText(searchUrl);
+            // 解析并返回搜索结果，传递type参数进行过滤
+            return parseSearchResults(html, query, searchUrl, type);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'type' in error) {
+                return createToolErrorResponse(error, 'search_apple_docs');
+            }
+            return createStandardErrorResponse(error, 'search_apple_docs');
+        }
+    }
+    async getAppleDocContent(url, includeRelatedApis = false, includeReferences = false, includeSimilarApis = false, includePlatformAnalysis = false) {
+        try {
+            // 输入验证
+            const urlValidation = validateInput(url, 'URL');
+            if (urlValidation) {
+                return createToolErrorResponse(urlValidation, 'get_apple_doc_content');
+            }
+            // 验证是否为有效的Apple Developer URL
+            if (!isValidAppleDeveloperUrl(url)) {
+                return createToolErrorResponse({
+                    type: ErrorType.INVALID_INPUT,
+                    message: 'URL must be from developer.apple.com',
+                }, 'get_apple_doc_content');
+            }
+            // fetchAppleDocJson 已经返回正确的MCP响应格式，直接返回
+            return await fetchAppleDocJson(url, {
+                includeRelatedApis,
+                includeReferences,
+                includeSimilarApis,
+                includePlatformAnalysis,
+            });
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'type' in error) {
+                return createToolErrorResponse(error, 'get_apple_doc_content');
+            }
+            return createStandardErrorResponse(error, 'get_apple_doc_content');
+        }
+    }
+    async listTechnologies(category, language, includeBeta = true, limit = API_LIMITS.DEFAULT_TECHNOLOGIES_LIMIT) {
+        return this.handleAsyncOperation(() => handleListTechnologies(category, language, includeBeta, limit), 'listTechnologies');
+    }
+    async searchFrameworkSymbols(framework, symbolType = 'all', namePattern, language = 'swift', limit = API_LIMITS.DEFAULT_FRAMEWORK_SYMBOLS_LIMIT) {
+        return this.handleAsyncOperation(() => searchFrameworkSymbols(framework, symbolType, namePattern, language, limit), 'searchFrameworkSymbols');
+    }
+    async getRelatedApis(apiUrl, includeInherited = true, includeConformance = true, includeSeeAlso = true) {
+        return this.handleAsyncOperation(() => handleGetRelatedApis(apiUrl, includeInherited, includeConformance, includeSeeAlso), 'getRelatedApis');
+    }
+    async resolveReferencesBatch(sourceUrl, maxReferences = API_LIMITS.DEFAULT_REFERENCES_LIMIT, filterByType = 'all') {
+        return this.handleAsyncOperation(() => handleResolveReferencesBatch(sourceUrl, maxReferences, filterByType), 'resolveReferencesBatch');
+    }
+    async getPlatformCompatibility(apiUrl, compareMode = 'single', includeRelated = false) {
+        return this.handleAsyncOperation(() => handleGetPlatformCompatibility(apiUrl, compareMode, includeRelated), 'getPlatformCompatibility');
+    }
+    async findSimilarApis(apiUrl, searchDepth = 'medium', filterByCategory, includeAlternatives = true) {
+        return this.handleAsyncOperation(() => handleFindSimilarApis(apiUrl, searchDepth, filterByCategory, includeAlternatives), 'findSimilarApis');
+    }
+    async getDocumentationUpdates(category = 'all', technology, year, searchQuery, includeBeta = true, limit = API_LIMITS.DEFAULT_DOCUMENTATION_UPDATES_LIMIT) {
+        return this.handleAsyncOperation(() => handleGetDocumentationUpdates(category, technology, year, searchQuery, includeBeta, limit), 'getDocumentationUpdates');
+    }
+    async getTechnologyOverviews(category, platform = 'all', searchQuery, includeSubcategories = true, limit = API_LIMITS.DEFAULT_TECHNOLOGY_OVERVIEWS_LIMIT) {
+        return this.handleAsyncOperation(() => handleGetTechnologyOverviews(category, platform, searchQuery, includeSubcategories, limit), 'getTechnologyOverviews');
+    }
+    async getSampleCode(framework, beta = 'include', searchQuery, limit = API_LIMITS.DEFAULT_SAMPLE_CODE_LIMIT) {
+        return this.handleAsyncOperation(() => handleGetSampleCode(framework, beta, searchQuery, limit), 'getSampleCode');
+    }
+    setupErrorHandling() {
+        // 处理 SIGINT 以优雅关闭服务器
+        process.on('SIGINT', () => {
+            process.exit(0);
+        });
+        process.on('SIGTERM', () => {
+            process.exit(0);
+        });
+        process.on('unhandledRejection', (reason) => {
+            logger.error('Unhandled Rejection, reason:', reason);
+            process.exit(1);
+        });
+        process.on('uncaughtException', (error) => {
+            logger.error('Uncaught Exception:', error);
+            process.exit(1);
+        });
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        logger.info('Apple Developer Docs MCP server running on stdio');
+        logger.info('WWDC Data: Using bundled data from npm package');
+        logger.info('Cache system initialized with TTL: API(30m), Index(1h), Technologies(2h)');
+        logger.info('Note: Search results are not cached to ensure real-time accuracy');
+        // Start framework preloading and cache warming in background
+        Promise.all([
+            preloadPopularFrameworks(),
+            warmUpCaches(),
+        ]).catch(error => {
+            logger.error('Background initialization failed:', error);
+        });
+        // Schedule periodic cache refresh (every 30 minutes)
+        schedulePeriodicCacheRefresh();
+    }
+}
+// Run server (only in non-test environment)
+if (process.env.NODE_ENV !== 'test') {
+    const server = new AppleDeveloperDocsMCPServer();
+    void server.run().catch((error) => {
+        logger.error('Fatal error in main():', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/schemas/analyze-api.schema.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Unified API analysis schema - consolidates get_related_apis, find_similar_apis, resolve_references_batch
+ */
+import { z } from 'zod';
+export declare const analyzeApiSchema: z.ZodObject<{
+    apiUrl: z.ZodString;
+    analysis: z.ZodEnum<["related", "similar", "references", "all"]>;
+    includeInherited: z.ZodOptional<z.ZodBoolean>;
+    includeConformance: z.ZodOptional<z.ZodBoolean>;
+    includeSeeAlso: z.ZodOptional<z.ZodBoolean>;
+    searchDepth: z.ZodOptional<z.ZodEnum<["shallow", "medium", "deep"]>>;
+    filterByCategory: z.ZodOptional<z.ZodString>;
+    includeAlternatives: z.ZodOptional<z.ZodBoolean>;
+    maxReferences: z.ZodOptional<z.ZodNumber>;
+    filterByType: z.ZodOptional<z.ZodEnum<["all", "symbol", "collection", "article", "protocol", "class", "struct", "enum"]>>;
+    compact: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    compact: boolean;
+    analysis: "all" | "related" | "references" | "similar";
+    apiUrl: string;
+    includeInherited?: boolean | undefined;
+    includeConformance?: boolean | undefined;
+    includeSeeAlso?: boolean | undefined;
+    searchDepth?: "shallow" | "medium" | "deep" | undefined;
+    filterByCategory?: string | undefined;
+    maxReferences?: number | undefined;
+    filterByType?: "symbol" | "all" | "class" | "enum" | "struct" | "protocol" | "article" | "collection" | undefined;
+    includeAlternatives?: boolean | undefined;
+}, {
+    analysis: "all" | "related" | "references" | "similar";
+    apiUrl: string;
+    compact?: boolean | undefined;
+    includeInherited?: boolean | undefined;
+    includeConformance?: boolean | undefined;
+    includeSeeAlso?: boolean | undefined;
+    searchDepth?: "shallow" | "medium" | "deep" | undefined;
+    filterByCategory?: string | undefined;
+    maxReferences?: number | undefined;
+    filterByType?: "symbol" | "all" | "class" | "enum" | "struct" | "protocol" | "article" | "collection" | undefined;
+    includeAlternatives?: boolean | undefined;
+}>;
+//# sourceMappingURL=analyze-api.schema.d.ts.map

package/dist/schemas/analyze-api.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-api.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/analyze-api.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB3B,CAAC"}

package/dist/schemas/analyze-api.schema.js

@@ -0,0 +1,23 @@
+/**
+ * Unified API analysis schema - consolidates get_related_apis, find_similar_apis, resolve_references_batch
+ */
+import { z } from 'zod';
+import { API_LIMITS } from '../utils/constants.js';
+export const analyzeApiSchema = z.object({
+    apiUrl: z.string().describe('Apple documentation URL to analyze'),
+    analysis: z.enum(['related', 'similar', 'references', 'all']).describe('Type of analysis: related (inheritance/protocols), similar (alternatives), references (type resolution), all (comprehensive)'),
+    // Options from get_related_apis
+    includeInherited: z.boolean().optional().describe('Include inherited APIs (for related analysis)'),
+    includeConformance: z.boolean().optional().describe('Include protocol conformances (for related analysis)'),
+    includeSeeAlso: z.boolean().optional().describe('Include "See Also" section (for related analysis)'),
+    // Options from find_similar_apis
+    searchDepth: z.enum(['shallow', 'medium', 'deep']).optional().describe('Search depth (for similar analysis)'),
+    filterByCategory: z.string().optional().describe('Filter by category (for similar analysis)'),
+    includeAlternatives: z.boolean().optional().describe('Include alternatives (for similar analysis)'),
+    // Options from resolve_references_batch
+    maxReferences: z.number().min(1).max(API_LIMITS.MAX_REFERENCES_LIMIT).optional().describe('Max references to resolve (for references analysis)'),
+    filterByType: z.enum(['all', 'symbol', 'collection', 'article', 'protocol', 'class', 'struct', 'enum']).optional().describe('Filter references by type'),
+    // Common options
+    compact: z.boolean().default(false).describe('Return minimal output (titles + URLs only). Recommended for discovery.'),
+});
+//# sourceMappingURL=analyze-api.schema.js.map

package/dist/schemas/analyze-api.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-api.schema.js","sourceRoot":"","sources":["../../src/schemas/analyze-api.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACjE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,8HAA8H,CAAC;IACtM,gCAAgC;IAChC,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAClG,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAC3G,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACpG,iCAAiC;IACjC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC7G,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC7F,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACnG,wCAAwC;IACxC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IAChJ,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACxJ,iBAAiB;IACjB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,wEAAwE,CAAC;CACvH,CAAC,CAAC"}

package/dist/schemas/apple-docs.schema.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Unified Apple Docs router schema
+ */
+import { z } from 'zod';
+export declare const appleDocsSchema: z.ZodObject<{
+    query: z.ZodString;
+    intent: z.ZodDefault<z.ZodEnum<["auto", "search", "docs", "wwdc", "samples", "technologies"]>>;
+    compact: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    compact: boolean;
+    query: string;
+    intent: "wwdc" | "search" | "technologies" | "samples" | "auto" | "docs";
+}, {
+    query: string;
+    compact?: boolean | undefined;
+    intent?: "wwdc" | "search" | "technologies" | "samples" | "auto" | "docs" | undefined;
+}>;
+//# sourceMappingURL=apple-docs.schema.d.ts.map

package/dist/schemas/apple-docs.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-docs.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/apple-docs.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC"}

package/dist/schemas/apple-docs.schema.js

@@ -0,0 +1,10 @@
+/**
+ * Unified Apple Docs router schema
+ */
+import { z } from 'zod';
+export const appleDocsSchema = z.object({
+    query: z.string().describe('Natural language query (e.g., "SwiftUI List docs", "WWDC async/await videos", "https://developer.apple.com/...")'),
+    intent: z.enum(['auto', 'search', 'docs', 'wwdc', 'samples', 'technologies']).default('auto').describe('Optional routing hint. Default: auto-detect from query'),
+    compact: z.boolean().default(false).describe('Return minimal output. Recommended for discovery.'),
+});
+//# sourceMappingURL=apple-docs.schema.js.map

package/dist/schemas/apple-docs.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-docs.schema.js","sourceRoot":"","sources":["../../src/schemas/apple-docs.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kHAAkH,CAAC;IAC9I,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IAChK,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CAClG,CAAC,CAAC"}

package/dist/schemas/doc-content.schema.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const getAppleDocContentSchema: z.ZodObject<{
+    url: z.ZodString;
+    includeRelatedApis: z.ZodDefault<z.ZodBoolean>;
+    includeReferences: z.ZodDefault<z.ZodBoolean>;
+    includeSimilarApis: z.ZodDefault<z.ZodBoolean>;
+    includePlatformAnalysis: z.ZodDefault<z.ZodBoolean>;
+    compact: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    includeRelatedApis: boolean;
+    includeReferences: boolean;
+    includeSimilarApis: boolean;
+    includePlatformAnalysis: boolean;
+    compact: boolean;
+}, {
+    url: string;
+    includeRelatedApis?: boolean | undefined;
+    includeReferences?: boolean | undefined;
+    includeSimilarApis?: boolean | undefined;
+    includePlatformAnalysis?: boolean | undefined;
+    compact?: boolean | undefined;
+}>;
+//# sourceMappingURL=doc-content.schema.d.ts.map

package/dist/schemas/doc-content.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-content.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/doc-content.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAOnC,CAAC"}