@react-native-nitro-device-info/mcp-server 1.0.0

package/dist/tools/get-api.js

@@ -0,0 +1,229 @@
+"use strict";
+/**
+ * get_api MCP Tool
+ *
+ * Retrieve detailed information about a specific API method or property.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApiInputSchema = void 0;
+exports.executeGetApi = executeGetApi;
+const zod_1 = require("zod");
+const search_js_1 = require("../indexer/search.js");
+/**
+ * Input schema for get_api tool
+ */
+exports.getApiInputSchema = zod_1.z.object({
+    name: zod_1.z
+        .string()
+        .min(1, 'API name cannot be empty')
+        .max(100, 'API name exceeds maximum length')
+        .describe("API method or property name (e.g., 'getBatteryLevel', 'deviceId'). Case-insensitive lookup with exact-match boost."),
+});
+/**
+ * Format platform support table
+ */
+function formatPlatformSupport(platform) {
+    const lines = [];
+    lines.push('| Platform | Support |');
+    lines.push('|----------|---------|');
+    switch (platform.type) {
+        case 'both':
+            lines.push('| iOS | ✅ Full support |');
+            lines.push('| Android | ✅ Full support |');
+            break;
+        case 'ios':
+            lines.push(`| iOS | ✅ ${platform.minVersion ? `iOS ${platform.minVersion}+` : 'Full support'} |`);
+            lines.push('| Android | ✅ Full support |');
+            break;
+        case 'android':
+            lines.push('| iOS | ✅ Full support |');
+            lines.push(`| Android | ✅ ${platform.minApiLevel ? `API ${platform.minApiLevel}+` : 'Full support'} |`);
+            break;
+        case 'ios-only':
+            lines.push(`| iOS | ✅ ${platform.minVersion ? `iOS ${platform.minVersion}+` : 'Full support'} |`);
+            lines.push('| Android | ❌ Not supported |');
+            break;
+        case 'android-only':
+            lines.push('| iOS | ❌ Not supported |');
+            lines.push(`| Android | ✅ ${platform.minApiLevel ? `API ${platform.minApiLevel}+` : 'Full support'} |`);
+            break;
+    }
+    return lines.join('\n');
+}
+/**
+ * Format parameters table
+ */
+function formatParameters(api) {
+    if (api.parameters.length === 0) {
+        return '*No parameters.*';
+    }
+    const lines = [];
+    lines.push('| Name | Type | Required | Description |');
+    lines.push('|------|------|----------|-------------|');
+    for (const param of api.parameters) {
+        const required = param.optional ? 'No' : 'Yes';
+        lines.push(`| ${param.name} | \`${param.type}\` | ${required} | ${param.description || '-'} |`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format related APIs section
+ */
+function formatRelatedApis(relatedApis) {
+    if (relatedApis.length === 0) {
+        return '';
+    }
+    const lines = [];
+    lines.push('## Related APIs');
+    lines.push('');
+    for (const api of relatedApis) {
+        lines.push(`- \`${api}()\``);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format examples section
+ */
+function formatExamples(examples) {
+    if (examples.length === 0) {
+        return '*No examples documented.*';
+    }
+    const lines = [];
+    for (const example of examples) {
+        // Check if example already has code fence
+        if (example.includes('```')) {
+            lines.push(example);
+        }
+        else {
+            lines.push('```typescript');
+            lines.push(example);
+            lines.push('```');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format complete API documentation
+ */
+function formatApiDocumentation(api) {
+    const lines = [];
+    // Title
+    lines.push(`# ${api.name}`);
+    lines.push('');
+    // Description
+    lines.push(api.description);
+    lines.push('');
+    // Signature
+    lines.push('## Signature');
+    lines.push('');
+    lines.push('```typescript');
+    lines.push(api.signature);
+    lines.push('```');
+    lines.push('');
+    // Parameters
+    lines.push('## Parameters');
+    lines.push('');
+    lines.push(formatParameters(api));
+    lines.push('');
+    // Returns
+    lines.push('## Returns');
+    lines.push('');
+    lines.push(`\`${api.returnType}\``);
+    lines.push('');
+    if (api.isAsync) {
+        lines.push('*This is an async method that returns a Promise.*');
+        lines.push('');
+    }
+    // Platform Support
+    lines.push('## Platform Support');
+    lines.push('');
+    lines.push(formatPlatformSupport(api.platform));
+    lines.push('');
+    // Example
+    lines.push('## Example');
+    lines.push('');
+    lines.push(formatExamples(api.examples));
+    lines.push('');
+    // Import suggestion
+    lines.push('## Import');
+    lines.push('');
+    lines.push('```typescript');
+    lines.push("import { NitroModules } from 'react-native-nitro-modules';");
+    lines.push("import type { DeviceInfo } from 'react-native-nitro-device-info';");
+    lines.push('');
+    lines.push("const deviceInfo = NitroModules.createHybridObject<DeviceInfo>('DeviceInfo');");
+    lines.push('');
+    if (api.kind === 'method') {
+        if (api.isAsync) {
+            lines.push(`const result = await deviceInfo.${api.name}(${api.parameters.map(p => p.name).join(', ')});`);
+        }
+        else {
+            lines.push(`const result = deviceInfo.${api.name}(${api.parameters.map(p => p.name).join(', ')});`);
+        }
+    }
+    else {
+        lines.push(`const result = deviceInfo.${api.name};`);
+    }
+    lines.push('```');
+    lines.push('');
+    // Related APIs
+    const relatedSection = formatRelatedApis(api.relatedApis);
+    if (relatedSection) {
+        lines.push(relatedSection);
+    }
+    return lines.join('\n').trim();
+}
+/**
+ * Format error response with suggestions
+ */
+function formatNotFoundError(name, suggestions) {
+    const lines = [];
+    lines.push(`Error: API '${name}' not found.`);
+    lines.push('');
+    if (suggestions.length > 0) {
+        lines.push('Did you mean:');
+        for (const api of suggestions) {
+            lines.push(`- \`${api.name}\` - ${api.description.slice(0, 60)}${api.description.length > 60 ? '...' : ''}`);
+        }
+        lines.push('');
+    }
+    lines.push('Use `list_apis` to see all available APIs.');
+    return lines.join('\n');
+}
+/**
+ * Execute get_api tool
+ */
+function executeGetApi(index, input) {
+    try {
+        const { name } = input;
+        const nameLower = name.toLowerCase();
+        // Try case-insensitive lookup
+        let api;
+        for (const [apiName, apiDef] of index.apis) {
+            if (apiName.toLowerCase() === nameLower) {
+                api = apiDef;
+                break;
+            }
+        }
+        // If found, return documentation
+        if (api) {
+            return {
+                content: formatApiDocumentation(api),
+                isError: false,
+            };
+        }
+        // Not found - try fuzzy matching
+        const suggestions = (0, search_js_1.findSimilarApis)(name, index.apis, 3, 3);
+        return {
+            content: formatNotFoundError(name, suggestions),
+            isError: true,
+        };
+    }
+    catch (error) {
+        return {
+            content: `Error retrieving API: ${error instanceof Error ? error.message : String(error)}`,
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=get-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-api.js","sourceRoot":"","sources":["../../src/tools/get-api.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAwNH,sCAsCC;AA5PD,6BAAwB;AAExB,oDAAuD;AAEvD;;GAEG;AACU,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;SAClC,GAAG,CAAC,GAAG,EAAE,iCAAiC,CAAC;SAC3C,QAAQ,CAAC,oHAAoH,CAAC;CAClI,CAAC,CAAC;AAIH;;GAEG;AACH,SAAS,qBAAqB,CAAC,QAAkB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAErC,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,MAAM;YACT,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC3C,MAAM;QACR,KAAK,KAAK;YACR,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC;YAClG,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC3C,MAAM;QACR,KAAK,SAAS;YACZ,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC;YACxG,MAAM;QACR,KAAK,UAAU;YACb,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC;YAClG,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC5C,MAAM;QACR,KAAK,cAAc;YACjB,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC;YACxG,MAAM;IACV,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,GAAkB;IAC1C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAEvD,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,QAAQ,MAAM,KAAK,CAAC,WAAW,IAAI,GAAG,IAAI,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,WAAqB;IAC9C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,QAAkB;IACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,0CAA0C;QAC1C,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,GAAkB;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,QAAQ;IACR,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,cAAc;IACd,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,YAAY;IACZ,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,aAAa;IACb,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,UAAU;IACV,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,UAAU;IACV,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,oBAAoB;IACpB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IACzE,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,mCAAmC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5G,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,6BAA6B,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,6BAA6B,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IACvD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,eAAe;IACf,MAAM,cAAc,GAAG,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1D,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAAY,EAAE,WAA4B;IACrE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,cAAc,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/G,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAEzD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAC3B,KAAkB,EAClB,KAAkB;IAElB,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAErC,8BAA8B;QAC9B,IAAI,GAA8B,CAAC;QACnC,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3C,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC;gBACxC,GAAG,GAAG,MAAM,CAAC;gBACb,MAAM;YACR,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,IAAI,GAAG,EAAE,CAAC;YACR,OAAO;gBACL,OAAO,EAAE,sBAAsB,CAAC,GAAG,CAAC;gBACpC,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,MAAM,WAAW,GAAG,IAAA,2BAAe,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5D,OAAO;YACL,OAAO,EAAE,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC;YAC/C,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAC1F,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * list_apis MCP Tool
+ *
+ * List all available API methods and properties with optional filtering.
+ */
+import { z } from 'zod';
+import type { SearchIndex } from '../types/index.js';
+/**
+ * Input schema for list_apis tool
+ */
+export declare const listApisInputSchema: z.ZodObject<{
+    category: z.ZodDefault<z.ZodEnum<["all", "device-info", "battery", "memory", "storage", "network", "capabilities", "application", "platform-specific", "display", "audio", "location", "identification"]>>;
+    platform: z.ZodDefault<z.ZodEnum<["all", "ios", "android", "both"]>>;
+    kind: z.ZodDefault<z.ZodEnum<["all", "method", "property"]>>;
+}, "strip", z.ZodTypeAny, {
+    category: "device-info" | "battery" | "memory" | "storage" | "network" | "capabilities" | "application" | "platform-specific" | "display" | "audio" | "location" | "identification" | "all";
+    kind: "method" | "property" | "all";
+    platform: "both" | "ios" | "android" | "all";
+}, {
+    category?: "device-info" | "battery" | "memory" | "storage" | "network" | "capabilities" | "application" | "platform-specific" | "display" | "audio" | "location" | "identification" | "all" | undefined;
+    kind?: "method" | "property" | "all" | undefined;
+    platform?: "both" | "ios" | "android" | "all" | undefined;
+}>;
+export type ListApisInput = z.infer<typeof listApisInputSchema>;
+/**
+ * Execute list_apis tool
+ */
+export declare function executeListApis(index: SearchIndex, input: ListApisInput): {
+    content: string;
+    isError: boolean;
+};
+//# sourceMappingURL=list-apis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-apis.d.ts","sourceRoot":"","sources":["../../src/tools/list-apis.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAA8B,MAAM,mBAAmB,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EA2B9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AA0FhE;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,aAAa,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAmGvC"}

package/dist/tools/list-apis.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * list_apis MCP Tool
+ *
+ * List all available API methods and properties with optional filtering.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listApisInputSchema = void 0;
+exports.executeListApis = executeListApis;
+const zod_1 = require("zod");
+/**
+ * Input schema for list_apis tool
+ */
+exports.listApisInputSchema = zod_1.z.object({
+    category: zod_1.z
+        .enum([
+        'all',
+        'device-info',
+        'battery',
+        'memory',
+        'storage',
+        'network',
+        'capabilities',
+        'application',
+        'platform-specific',
+        'display',
+        'audio',
+        'location',
+        'identification',
+    ])
+        .default('all')
+        .describe('Filter by API category'),
+    platform: zod_1.z
+        .enum(['all', 'ios', 'android', 'both'])
+        .default('all')
+        .describe("Filter by platform support: 'ios' = iOS only, 'android' = Android only, 'both' = must support both, 'all' = any platform"),
+    kind: zod_1.z
+        .enum(['all', 'method', 'property'])
+        .default('all')
+        .describe("Filter by API kind: 'method' = functions with (), 'property' = readonly getters"),
+});
+/**
+ * Category display names
+ */
+const CATEGORY_NAMES = {
+    'device-info': 'Device Info',
+    'battery': 'Battery & Power',
+    'memory': 'Memory',
+    'storage': 'Storage',
+    'network': 'Network',
+    'capabilities': 'Capabilities',
+    'application': 'Application',
+    'platform-specific': 'Platform-Specific',
+    'display': 'Display',
+    'audio': 'Audio',
+    'location': 'Location',
+    'identification': 'Identification',
+};
+/**
+ * Format platform info for table
+ */
+function formatPlatformShort(api) {
+    const platform = api.platform;
+    switch (platform.type) {
+        case 'both':
+            return 'iOS, Android';
+        case 'ios':
+            return platform.minVersion ? `iOS ${platform.minVersion}+` : 'iOS';
+        case 'android':
+            return platform.minApiLevel ? `API ${platform.minApiLevel}+` : 'Android';
+        case 'ios-only':
+            return 'iOS only';
+        case 'android-only':
+            return 'Android only';
+        default:
+            return 'iOS, Android';
+    }
+}
+/**
+ * Check if API matches platform filter
+ */
+function matchesPlatform(api, filter) {
+    const platformType = api.platform.type;
+    switch (filter) {
+        case 'all':
+            return true;
+        case 'ios':
+            return platformType === 'ios' || platformType === 'ios-only' || platformType === 'both';
+        case 'android':
+            return platformType === 'android' || platformType === 'android-only' || platformType === 'both';
+        case 'both':
+            return platformType === 'both';
+        default:
+            return true;
+    }
+}
+/**
+ * Format API list by category
+ */
+function formatApisByCategory(apis, category) {
+    const lines = [];
+    const displayName = CATEGORY_NAMES[category] || category;
+    lines.push(`## ${displayName}`);
+    lines.push('');
+    lines.push('| API | Kind | Platform | Description |');
+    lines.push('|-----|------|----------|-------------|');
+    for (const api of apis) {
+        const name = api.kind === 'method' ? `\`${api.name}()\`` : `\`${api.name}\``;
+        const kind = api.kind;
+        const platform = formatPlatformShort(api);
+        const description = api.description.length > 50
+            ? api.description.slice(0, 50) + '...'
+            : api.description;
+        lines.push(`| ${name} | ${kind} | ${platform} | ${description} |`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Execute list_apis tool
+ */
+function executeListApis(index, input) {
+    try {
+        const { category, platform, kind } = input;
+        // Filter APIs
+        const filteredApis = [];
+        for (const [, api] of index.apis) {
+            // Category filter
+            if (category !== 'all' && api.category !== category) {
+                continue;
+            }
+            // Platform filter
+            if (!matchesPlatform(api, platform)) {
+                continue;
+            }
+            // Kind filter
+            if (kind !== 'all' && api.kind !== kind) {
+                continue;
+            }
+            filteredApis.push(api);
+        }
+        // Handle no results
+        if (filteredApis.length === 0) {
+            const lines = [];
+            lines.push('No APIs found matching filters:');
+            lines.push(`- Category: ${category}`);
+            lines.push(`- Platform: ${platform}`);
+            lines.push(`- Kind: ${kind}`);
+            lines.push('');
+            lines.push('Try broadening your filters or use `search_docs` for natural language search.');
+            return {
+                content: lines.join('\n'),
+                isError: false,
+            };
+        }
+        // Group by category
+        const byCategory = new Map();
+        for (const api of filteredApis) {
+            const cat = api.category;
+            if (!byCategory.has(cat)) {
+                byCategory.set(cat, []);
+            }
+            byCategory.get(cat).push(api);
+        }
+        // Sort APIs within each category
+        for (const [, apis] of byCategory) {
+            apis.sort((a, b) => a.name.localeCompare(b.name));
+        }
+        // Format output
+        const lines = [];
+        lines.push('# Available APIs');
+        lines.push('');
+        lines.push(`**Filters**: Category: ${category} | Platform: ${platform} | Kind: ${kind}`);
+        lines.push(`**Total**: ${filteredApis.length} APIs`);
+        lines.push('');
+        // Define category order
+        const categoryOrder = [
+            'device-info',
+            'battery',
+            'memory',
+            'storage',
+            'network',
+            'capabilities',
+            'application',
+            'platform-specific',
+            'display',
+            'audio',
+            'location',
+            'identification',
+        ];
+        // Output categories in order
+        for (const cat of categoryOrder) {
+            const apis = byCategory.get(cat);
+            if (apis && apis.length > 0) {
+                lines.push(formatApisByCategory(apis, cat));
+                lines.push('');
+            }
+        }
+        return {
+            content: lines.join('\n').trim(),
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: `Error listing APIs: ${error instanceof Error ? error.message : String(error)}`,
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=list-apis.js.map

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

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

package/dist/tools/search-docs.d.ts

@@ -0,0 +1,32 @@
+/**
+ * search_docs MCP Tool
+ *
+ * Search documentation using natural language queries with BM25 ranking.
+ */
+import { z } from 'zod';
+import type { SearchIndex } from '../types/index.js';
+/**
+ * Input schema for search_docs tool
+ */
+export declare const searchDocsInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    type: z.ZodDefault<z.ZodEnum<["all", "api", "guide"]>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+    type: "api" | "guide" | "all";
+}, {
+    query: string;
+    limit?: number | undefined;
+    type?: "api" | "guide" | "all" | undefined;
+}>;
+export type SearchDocsInput = z.infer<typeof searchDocsInputSchema>;
+/**
+ * Execute search_docs tool
+ */
+export declare function executeSearchDocs(index: SearchIndex, input: SearchDocsInput): {
+    content: string;
+    isError: boolean;
+};
+//# sourceMappingURL=search-docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-docs.d.ts","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAqC,MAAM,mBAAmB,CAAC;AAGxF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAiBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAmFpE;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,eAAe,GACrB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA+CvC"}