@mapbox/mcp-docs-server 0.2.0 → 0.3.0

package/dist/commonjs/index.js

@@ -9,6 +9,7 @@ const toolConfig_js_1 = require("./config/toolConfig.js");
 const toolRegistry_js_1 = require("./tools/toolRegistry.js");
 const resourceRegistry_js_1 = require("./resources/resourceRegistry.js");
 const versionUtils_js_1 = require("./utils/versionUtils.js");
+const tracing_js_1 = require("./utils/tracing.js");
 // Parse configuration from command-line arguments
 const config = (0, toolConfig_js_1.parseToolConfigFromArgs)();
 // Get and filter tools based on configuration
@@ -35,6 +36,7 @@ resources.forEach((resource) => {
     resource.installTo(server);
 });
 async function main() {
+    await (0, tracing_js_1.initializeTracing)();
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);
     server.server.sendLoggingMessage({
@@ -52,6 +54,7 @@ async function shutdown() {
     catch {
         // Ignore logging errors during shutdown
     }
+    await (0, tracing_js_1.shutdownTracing)();
     process.exit(0);
 }
 function exitWithError(error, code = 1) {

package/dist/commonjs/index.js.map

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

package/dist/commonjs/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.d.ts

@@ -3,12 +3,16 @@ import type { ReadResourceResult, ServerNotification, ServerRequest } from '@mod
 import type { HttpRequest } from '../../utils/types.js';
 import { BaseResource } from '../BaseResource.js';
 /**
- * Resource providing Mapbox API reference documentation
+ * Resource providing Mapbox API reference documentation.
+ * Fetches the aggregated API reference index from docs.mapbox.com/api/llms.txt,
+ * which lists all Mapbox REST API endpoints grouped by service category
+ * (Maps, Navigation, Search, Accounts, etc.) with direct links to each
+ * API reference page.
  */
 export declare class MapboxApiReferenceResource extends BaseResource {
     readonly name = "Mapbox API Reference";
     readonly uri = "resource://mapbox-api-reference";
-    readonly description = "Mapbox REST API reference documentation including endpoints, parameters, rate limits, and authentication for all Mapbox APIs (Geocoding, Directions, Static Images, Tilequery, etc.)";
+    readonly description: string;
     readonly mimeType = "text/markdown";
     private httpRequest;
     constructor(params: {

package/dist/commonjs/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxApiReferenceResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,YAAY;IAC1D,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,GAAG,qCAAqC;IACjD,QAAQ,CAAC,WAAW,0LACqK;IACzL,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA2C/B"}
+{"version":3,"file":"MapboxApiReferenceResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,YAAY;IAC1D,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,GAAG,qCAAqC;IACjD,QAAQ,CAAC,WAAW,SAIkE;IACtF,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CAwB/B"}

package/dist/commonjs/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.js

@@ -3,16 +3,22 @@
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MapboxApiReferenceResource = void 0;
-const docCache_js_1 = require("../../utils/docCache.js");
 const BaseResource_js_1 = require("../BaseResource.js");
-const docParser_js_1 = require("../utils/docParser.js");
+const docFetcher_js_1 = require("../../utils/docFetcher.js");
 /**
- * Resource providing Mapbox API reference documentation
+ * Resource providing Mapbox API reference documentation.
+ * Fetches the aggregated API reference index from docs.mapbox.com/api/llms.txt,
+ * which lists all Mapbox REST API endpoints grouped by service category
+ * (Maps, Navigation, Search, Accounts, etc.) with direct links to each
+ * API reference page.
  */
 class MapboxApiReferenceResource extends BaseResource_js_1.BaseResource {
     name = 'Mapbox API Reference';
     uri = 'resource://mapbox-api-reference';
-    description = 'Mapbox REST API reference documentation including endpoints, parameters, rate limits, and authentication for all Mapbox APIs (Geocoding, Directions, Static Images, Tilequery, etc.)';
+    description = 'Mapbox REST API reference index organized by service (Maps, Navigation, Search, Accounts). ' +
+        'Lists all API endpoints with links to detailed reference pages covering parameters, ' +
+        'rate limits, authentication, and response formats (Geocoding, Directions, Static Images, ' +
+        'Tilequery, Matrix, Isochrone, Optimization, Styles, Uploads, Datasets, and more).';
     mimeType = 'text/markdown';
     httpRequest;
     constructor(params) {
@@ -21,30 +27,13 @@ class MapboxApiReferenceResource extends BaseResource_js_1.BaseResource {
     }
     async readCallback(uri, _extra) {
         try {
-            const LLMS_TXT_URL = 'https://docs.mapbox.com/llms.txt';
-            let content = docCache_js_1.docCache.get(LLMS_TXT_URL);
-            if (!content) {
-                const response = await this.httpRequest(LLMS_TXT_URL, {
-                    headers: {
-                        Accept: 'text/markdown, text/plain;q=0.9, */*;q=0.8'
-                    }
-                });
-                if (!response.ok) {
-                    throw new Error(`Failed to fetch Mapbox documentation: ${response.statusText}`);
-                }
-                content = await response.text();
-                docCache_js_1.docCache.set(LLMS_TXT_URL, content);
-            }
-            // Parse and filter for API sections only
-            const allSections = (0, docParser_js_1.parseDocSections)(content);
-            const apiSections = (0, docParser_js_1.filterSectionsByCategory)(allSections, 'apis');
-            const apiContent = (0, docParser_js_1.sectionsToMarkdown)(apiSections);
+            const content = await (0, docFetcher_js_1.fetchCachedText)('https://docs.mapbox.com/api/llms.txt', this.httpRequest);
             return {
                 contents: [
                     {
                         uri: uri.href,
                         mimeType: this.mimeType,
-                        text: `# Mapbox API Reference\n\n${apiContent}`
+                        text: content
                     }
                 ]
             };

package/dist/commonjs/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxApiReferenceResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AASlC,yDAAmD;AACnD,wDAAkD;AAClD,wDAI+B;AAE/B;;GAEG;AACH,MAAa,0BAA2B,SAAQ,8BAAY;IACjD,IAAI,GAAG,sBAAsB,CAAC;IAC9B,GAAG,GAAG,iCAAiC,CAAC;IACxC,WAAW,GAClB,sLAAsL,CAAC;IAChL,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,kCAAkC,CAAC;YACxD,IAAI,OAAO,GAAG,sBAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;oBACpD,OAAO,EAAE;wBACP,MAAM,EAAE,4CAA4C;qBACrD;iBACF,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,CAAC,UAAU,EAAE,CAC/D,CAAC;gBACJ,CAAC;gBAED,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,sBAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAED,yCAAyC;YACzC,MAAM,WAAW,GAAG,IAAA,+BAAgB,EAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,WAAW,GAAG,IAAA,uCAAwB,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAClE,MAAM,UAAU,GAAG,IAAA,iCAAkB,EAAC,WAAW,CAAC,CAAC;YAEnD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,6BAA6B,UAAU,EAAE;qBAChD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,yCAAyC,YAAY,EAAE,EAAE;gBACvE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AA5DD,gEA4DC"}
+{"version":3,"file":"MapboxApiReferenceResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AASlC,wDAAkD;AAClD,6DAA4D;AAE5D;;;;;;GAMG;AACH,MAAa,0BAA2B,SAAQ,8BAAY;IACjD,IAAI,GAAG,sBAAsB,CAAC;IAC9B,GAAG,GAAG,iCAAiC,CAAC;IACxC,WAAW,GAClB,6FAA6F;QAC7F,sFAAsF;QACtF,2FAA2F;QAC3F,mFAAmF,CAAC;IAC7E,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAA,+BAAe,EACnC,sCAAsC,EACtC,IAAI,CAAC,WAAW,CACjB,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,OAAO;qBACd;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,yCAAyC,YAAY,EAAE,EAAE;gBACvE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AA5CD,gEA4CC"}

package/dist/commonjs/resources/mapbox-examples-resource/MapboxExamplesResource.d.ts

@@ -3,12 +3,14 @@ import type { ReadResourceResult, ServerNotification, ServerRequest } from '@mod
 import type { HttpRequest } from '../../utils/types.js';
 import { BaseResource } from '../BaseResource.js';
 /**
- * Resource providing Mapbox examples and playgrounds
+ * Resource providing links to Mapbox interactive examples and playgrounds.
+ * Extracts the examples/playground/demo sections from the root llms.txt
+ * catalog, which lists API playgrounds, demo apps, and open-code projects.
  */
 export declare class MapboxExamplesResource extends BaseResource {
     readonly name = "Mapbox Examples";
     readonly uri = "resource://mapbox-examples";
-    readonly description = "Mapbox code examples, API playgrounds, and interactive demos for testing and learning";
+    readonly description: string;
     readonly mimeType = "text/markdown";
     private httpRequest;
     constructor(params: {

package/dist/commonjs/resources/mapbox-examples-resource/MapboxExamplesResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxExamplesResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-examples-resource/MapboxExamplesResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,GAAG,gCAAgC;IAC5C,QAAQ,CAAC,WAAW,2FACsE;IAC1F,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA2C/B"}
+{"version":3,"file":"MapboxExamplesResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-examples-resource/MapboxExamplesResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,GAAG,gCAAgC;IAC5C,QAAQ,CAAC,WAAW,SAG2D;IAC/E,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA6B/B"}

package/dist/commonjs/resources/mapbox-examples-resource/MapboxExamplesResource.js

@@ -3,16 +3,20 @@
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MapboxExamplesResource = void 0;
-const docCache_js_1 = require("../../utils/docCache.js");
 const BaseResource_js_1 = require("../BaseResource.js");
+const docFetcher_js_1 = require("../../utils/docFetcher.js");
 const docParser_js_1 = require("../utils/docParser.js");
 /**
- * Resource providing Mapbox examples and playgrounds
+ * Resource providing links to Mapbox interactive examples and playgrounds.
+ * Extracts the examples/playground/demo sections from the root llms.txt
+ * catalog, which lists API playgrounds, demo apps, and open-code projects.
  */
 class MapboxExamplesResource extends BaseResource_js_1.BaseResource {
     name = 'Mapbox Examples';
     uri = 'resource://mapbox-examples';
-    description = 'Mapbox code examples, API playgrounds, and interactive demos for testing and learning';
+    description = 'Mapbox interactive API playgrounds, demo applications, and code examples. ' +
+        'Includes playground URLs for Directions, Search Box, Static Images, ' +
+        'Isochrone, Matrix APIs, and demo apps for real estate, store locator, etc.';
     mimeType = 'text/markdown';
     httpRequest;
     constructor(params) {
@@ -21,21 +25,8 @@ class MapboxExamplesResource extends BaseResource_js_1.BaseResource {
     }
     async readCallback(uri, _extra) {
         try {
-            const LLMS_TXT_URL = 'https://docs.mapbox.com/llms.txt';
-            let content = docCache_js_1.docCache.get(LLMS_TXT_URL);
-            if (!content) {
-                const response = await this.httpRequest(LLMS_TXT_URL, {
-                    headers: {
-                        Accept: 'text/markdown, text/plain;q=0.9, */*;q=0.8'
-                    }
-                });
-                if (!response.ok) {
-                    throw new Error(`Failed to fetch Mapbox documentation: ${response.statusText}`);
-                }
-                content = await response.text();
-                docCache_js_1.docCache.set(LLMS_TXT_URL, content);
-            }
-            // Parse and filter for example sections only
+            const content = await (0, docFetcher_js_1.fetchCachedText)('https://docs.mapbox.com/llms.txt', this.httpRequest);
+            // Extract playground/demo/example sections from the catalog index
             const allSections = (0, docParser_js_1.parseDocSections)(content);
             const exampleSections = (0, docParser_js_1.filterSectionsByCategory)(allSections, 'examples');
             const exampleContent = (0, docParser_js_1.sectionsToMarkdown)(exampleSections);

package/dist/commonjs/resources/mapbox-examples-resource/MapboxExamplesResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxExamplesResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-examples-resource/MapboxExamplesResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AASlC,yDAAmD;AACnD,wDAAkD;AAClD,wDAI+B;AAE/B;;GAEG;AACH,MAAa,sBAAuB,SAAQ,8BAAY;IAC7C,IAAI,GAAG,iBAAiB,CAAC;IACzB,GAAG,GAAG,4BAA4B,CAAC;IACnC,WAAW,GAClB,uFAAuF,CAAC;IACjF,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,kCAAkC,CAAC;YACxD,IAAI,OAAO,GAAG,sBAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;oBACpD,OAAO,EAAE;wBACP,MAAM,EAAE,4CAA4C;qBACrD;iBACF,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,CAAC,UAAU,EAAE,CAC/D,CAAC;gBACJ,CAAC;gBAED,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,sBAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAED,6CAA6C;YAC7C,MAAM,WAAW,GAAG,IAAA,+BAAgB,EAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,eAAe,GAAG,IAAA,uCAAwB,EAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YAC1E,MAAM,cAAc,GAAG,IAAA,iCAAkB,EAAC,eAAe,CAAC,CAAC;YAE3D,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,wBAAwB,cAAc,EAAE;qBAC/C;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,oCAAoC,YAAY,EAAE,EAAE;gBAClE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AA5DD,wDA4DC"}
+{"version":3,"file":"MapboxExamplesResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-examples-resource/MapboxExamplesResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AASlC,wDAAkD;AAClD,6DAA4D;AAC5D,wDAI+B;AAE/B;;;;GAIG;AACH,MAAa,sBAAuB,SAAQ,8BAAY;IAC7C,IAAI,GAAG,iBAAiB,CAAC;IACzB,GAAG,GAAG,4BAA4B,CAAC;IACnC,WAAW,GAClB,4EAA4E;QAC5E,sEAAsE;QACtE,4EAA4E,CAAC;IACtE,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAA,+BAAe,EACnC,kCAAkC,EAClC,IAAI,CAAC,WAAW,CACjB,CAAC;YAEF,kEAAkE;YAClE,MAAM,WAAW,GAAG,IAAA,+BAAgB,EAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,eAAe,GAAG,IAAA,uCAAwB,EAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YAC1E,MAAM,cAAc,GAAG,IAAA,iCAAkB,EAAC,eAAe,CAAC,CAAC;YAE3D,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,wBAAwB,cAAc,EAAE;qBAC/C;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,oCAAoC,YAAY,EAAE,EAAE;gBAClE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAhDD,wDAgDC"}

package/dist/commonjs/resources/mapbox-guides-resource/MapboxGuidesResource.d.ts

@@ -3,12 +3,15 @@ import type { ReadResourceResult, ServerNotification, ServerRequest } from '@mod
 import type { HttpRequest } from '../../utils/types.js';
 import { BaseResource } from '../BaseResource.js';
 /**
- * Resource providing Mapbox guides and tutorials
+ * Resource providing Mapbox guides, tutorials, and help articles.
+ * Fetches from docs.mapbox.com/help/llms.txt which contains the full
+ * Mapbox Help Center index: troubleshooting guides, how-to tutorials,
+ * glossary, account setup, billing, and platform-specific walkthroughs.
  */
 export declare class MapboxGuidesResource extends BaseResource {
     readonly name = "Mapbox Guides";
     readonly uri = "resource://mapbox-guides";
-    readonly description = "Mapbox guides, tutorials, and how-tos including Studio Manual, map design guides, and best practices";
+    readonly description: string;
     readonly mimeType = "text/markdown";
     private httpRequest;
     constructor(params: {

package/dist/commonjs/resources/mapbox-guides-resource/MapboxGuidesResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxGuidesResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-guides-resource/MapboxGuidesResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,GAAG,8BAA8B;IAC1C,QAAQ,CAAC,WAAW,0GACqF;IACzG,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA2C/B"}
+{"version":3,"file":"MapboxGuidesResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-guides-resource/MapboxGuidesResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,GAAG,8BAA8B;IAC1C,QAAQ,CAAC,WAAW,SAGgD;IACpE,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CAwB/B"}

package/dist/commonjs/resources/mapbox-guides-resource/MapboxGuidesResource.js

@@ -3,16 +3,20 @@
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MapboxGuidesResource = void 0;
-const docCache_js_1 = require("../../utils/docCache.js");
 const BaseResource_js_1 = require("../BaseResource.js");
-const docParser_js_1 = require("../utils/docParser.js");
+const docFetcher_js_1 = require("../../utils/docFetcher.js");
 /**
- * Resource providing Mapbox guides and tutorials
+ * Resource providing Mapbox guides, tutorials, and help articles.
+ * Fetches from docs.mapbox.com/help/llms.txt which contains the full
+ * Mapbox Help Center index: troubleshooting guides, how-to tutorials,
+ * glossary, account setup, billing, and platform-specific walkthroughs.
  */
 class MapboxGuidesResource extends BaseResource_js_1.BaseResource {
     name = 'Mapbox Guides';
     uri = 'resource://mapbox-guides';
-    description = 'Mapbox guides, tutorials, and how-tos including Studio Manual, map design guides, and best practices';
+    description = 'Mapbox Help Center documentation: troubleshooting guides, how-to tutorials, ' +
+        'glossary, account and billing setup, and walkthroughs for common developer tasks. ' +
+        'Use this for conceptual guidance and step-by-step instructions.';
     mimeType = 'text/markdown';
     httpRequest;
     constructor(params) {
@@ -21,30 +25,13 @@ class MapboxGuidesResource extends BaseResource_js_1.BaseResource {
     }
     async readCallback(uri, _extra) {
         try {
-            const LLMS_TXT_URL = 'https://docs.mapbox.com/llms.txt';
-            let content = docCache_js_1.docCache.get(LLMS_TXT_URL);
-            if (!content) {
-                const response = await this.httpRequest(LLMS_TXT_URL, {
-                    headers: {
-                        Accept: 'text/markdown, text/plain;q=0.9, */*;q=0.8'
-                    }
-                });
-                if (!response.ok) {
-                    throw new Error(`Failed to fetch Mapbox documentation: ${response.statusText}`);
-                }
-                content = await response.text();
-                docCache_js_1.docCache.set(LLMS_TXT_URL, content);
-            }
-            // Parse and filter for guide sections only
-            const allSections = (0, docParser_js_1.parseDocSections)(content);
-            const guideSections = (0, docParser_js_1.filterSectionsByCategory)(allSections, 'guides');
-            const guideContent = (0, docParser_js_1.sectionsToMarkdown)(guideSections);
+            const content = await (0, docFetcher_js_1.fetchCachedText)('https://docs.mapbox.com/help/llms.txt', this.httpRequest);
             return {
                 contents: [
                     {
                         uri: uri.href,
                         mimeType: this.mimeType,
-                        text: `# Mapbox Guides\n\n${guideContent}`
+                        text: content
                     }
                 ]
             };

package/dist/commonjs/resources/mapbox-guides-resource/MapboxGuidesResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxGuidesResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-guides-resource/MapboxGuidesResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AASlC,yDAAmD;AACnD,wDAAkD;AAClD,wDAI+B;AAE/B;;GAEG;AACH,MAAa,oBAAqB,SAAQ,8BAAY;IAC3C,IAAI,GAAG,eAAe,CAAC;IACvB,GAAG,GAAG,0BAA0B,CAAC;IACjC,WAAW,GAClB,sGAAsG,CAAC;IAChG,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,kCAAkC,CAAC;YACxD,IAAI,OAAO,GAAG,sBAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;oBACpD,OAAO,EAAE;wBACP,MAAM,EAAE,4CAA4C;qBACrD;iBACF,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,CAAC,UAAU,EAAE,CAC/D,CAAC;gBACJ,CAAC;gBAED,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,sBAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAED,2CAA2C;YAC3C,MAAM,WAAW,GAAG,IAAA,+BAAgB,EAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,aAAa,GAAG,IAAA,uCAAwB,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACtE,MAAM,YAAY,GAAG,IAAA,iCAAkB,EAAC,aAAa,CAAC,CAAC;YAEvD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,sBAAsB,YAAY,EAAE;qBAC3C;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,kCAAkC,YAAY,EAAE,EAAE;gBAChE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AA5DD,oDA4DC"}
+{"version":3,"file":"MapboxGuidesResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-guides-resource/MapboxGuidesResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AASlC,wDAAkD;AAClD,6DAA4D;AAE5D;;;;;GAKG;AACH,MAAa,oBAAqB,SAAQ,8BAAY;IAC3C,IAAI,GAAG,eAAe,CAAC;IACvB,GAAG,GAAG,0BAA0B,CAAC;IACjC,WAAW,GAClB,8EAA8E;QAC9E,oFAAoF;QACpF,iEAAiE,CAAC;IAC3D,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAA,+BAAe,EACnC,uCAAuC,EACvC,IAAI,CAAC,WAAW,CACjB,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,OAAO;qBACd;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,kCAAkC,YAAY,EAAE,EAAE;gBAChE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AA3CD,oDA2CC"}

package/dist/commonjs/resources/mapbox-reference-resource/MapboxReferenceResource.d.ts

@@ -3,12 +3,16 @@ import type { ReadResourceResult, ServerNotification, ServerRequest } from '@mod
 import type { HttpRequest } from '../../utils/types.js';
 import { BaseResource } from '../BaseResource.js';
 /**
- * Resource providing Mapbox reference documentation
+ * Resource providing the complete Mapbox documentation catalog.
+ * Fetches the root llms.txt which is now a structured index of every
+ * Mapbox product and documentation section, each with a link to its
+ * own llms.txt file. Use this to discover what documentation is available
+ * and find URLs to pass to get_document_tool for deeper exploration.
  */
 export declare class MapboxReferenceResource extends BaseResource {
     readonly name = "Mapbox Reference";
     readonly uri = "resource://mapbox-reference";
-    readonly description = "Mapbox reference documentation including tilesets, data products, accounts, pricing, and other reference materials";
+    readonly description: string;
     readonly mimeType = "text/markdown";
     private httpRequest;
     constructor(params: {

package/dist/commonjs/resources/mapbox-reference-resource/MapboxReferenceResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxReferenceResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-reference-resource/MapboxReferenceResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,GAAG,iCAAiC;IAC7C,QAAQ,CAAC,WAAW,wHACmG;IACvH,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA8C/B"}
+{"version":3,"file":"MapboxReferenceResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-reference-resource/MapboxReferenceResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,GAAG,iCAAiC;IAC7C,QAAQ,CAAC,WAAW,SAKsD;IAC1E,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CAwB/B"}

package/dist/commonjs/resources/mapbox-reference-resource/MapboxReferenceResource.js

@@ -3,16 +3,23 @@
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MapboxReferenceResource = void 0;
-const docCache_js_1 = require("../../utils/docCache.js");
 const BaseResource_js_1 = require("../BaseResource.js");
-const docParser_js_1 = require("../utils/docParser.js");
+const docFetcher_js_1 = require("../../utils/docFetcher.js");
 /**
- * Resource providing Mapbox reference documentation
+ * Resource providing the complete Mapbox documentation catalog.
+ * Fetches the root llms.txt which is now a structured index of every
+ * Mapbox product and documentation section, each with a link to its
+ * own llms.txt file. Use this to discover what documentation is available
+ * and find URLs to pass to get_document_tool for deeper exploration.
  */
 class MapboxReferenceResource extends BaseResource_js_1.BaseResource {
     name = 'Mapbox Reference';
     uri = 'resource://mapbox-reference';
-    description = 'Mapbox reference documentation including tilesets, data products, accounts, pricing, and other reference materials';
+    description = 'Complete catalog of all Mapbox products and documentation. ' +
+        'Lists every product section (Maps SDKs, Navigation APIs, Search APIs, ' +
+        'Studio, Style Spec, Tilesets, Data products, Help Center, Atlas, Unity, etc.) ' +
+        "with links to each product's own llms.txt index. Use this to discover " +
+        'what documentation exists and find the right URLs to fetch full docs.';
     mimeType = 'text/markdown';
     httpRequest;
     constructor(params) {
@@ -21,30 +28,13 @@ class MapboxReferenceResource extends BaseResource_js_1.BaseResource {
     }
     async readCallback(uri, _extra) {
         try {
-            const LLMS_TXT_URL = 'https://docs.mapbox.com/llms.txt';
-            let content = docCache_js_1.docCache.get(LLMS_TXT_URL);
-            if (!content) {
-                const response = await this.httpRequest(LLMS_TXT_URL, {
-                    headers: {
-                        Accept: 'text/markdown, text/plain;q=0.9, */*;q=0.8'
-                    }
-                });
-                if (!response.ok) {
-                    throw new Error(`Failed to fetch Mapbox documentation: ${response.statusText}`);
-                }
-                content = await response.text();
-                docCache_js_1.docCache.set(LLMS_TXT_URL, content);
-            }
-            // Parse and filter for reference sections only
-            const allSections = (0, docParser_js_1.parseDocSections)(content);
-            const referenceSections = (0, docParser_js_1.filterSectionsByCategory)(allSections, 'reference');
-            const referenceContent = (0, docParser_js_1.sectionsToMarkdown)(referenceSections);
+            const content = await (0, docFetcher_js_1.fetchCachedText)('https://docs.mapbox.com/llms.txt', this.httpRequest);
             return {
                 contents: [
                     {
                         uri: uri.href,
                         mimeType: this.mimeType,
-                        text: `# Mapbox Reference\n\n${referenceContent}`
+                        text: content
                     }
                 ]
             };

package/dist/commonjs/resources/mapbox-reference-resource/MapboxReferenceResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxReferenceResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-reference-resource/MapboxReferenceResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AASlC,yDAAmD;AACnD,wDAAkD;AAClD,wDAI+B;AAE/B;;GAEG;AACH,MAAa,uBAAwB,SAAQ,8BAAY;IAC9C,IAAI,GAAG,kBAAkB,CAAC;IAC1B,GAAG,GAAG,6BAA6B,CAAC;IACpC,WAAW,GAClB,oHAAoH,CAAC;IAC9G,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,kCAAkC,CAAC;YACxD,IAAI,OAAO,GAAG,sBAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;oBACpD,OAAO,EAAE;wBACP,MAAM,EAAE,4CAA4C;qBACrD;iBACF,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,CAAC,UAAU,EAAE,CAC/D,CAAC;gBACJ,CAAC;gBAED,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,sBAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAED,+CAA+C;YAC/C,MAAM,WAAW,GAAG,IAAA,+BAAgB,EAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,iBAAiB,GAAG,IAAA,uCAAwB,EAChD,WAAW,EACX,WAAW,CACZ,CAAC;YACF,MAAM,gBAAgB,GAAG,IAAA,iCAAkB,EAAC,iBAAiB,CAAC,CAAC;YAE/D,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,yBAAyB,gBAAgB,EAAE;qBAClD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,qCAAqC,YAAY,EAAE,EAAE;gBACnE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AA/DD,0DA+DC"}
+{"version":3,"file":"MapboxReferenceResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-reference-resource/MapboxReferenceResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AASlC,wDAAkD;AAClD,6DAA4D;AAE5D;;;;;;GAMG;AACH,MAAa,uBAAwB,SAAQ,8BAAY;IAC9C,IAAI,GAAG,kBAAkB,CAAC;IAC1B,GAAG,GAAG,6BAA6B,CAAC;IACpC,WAAW,GAClB,6DAA6D;QAC7D,wEAAwE;QACxE,gFAAgF;QAChF,wEAAwE;QACxE,uEAAuE,CAAC;IACjE,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAA,+BAAe,EACnC,kCAAkC,EAClC,IAAI,CAAC,WAAW,CACjB,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,OAAO;qBACd;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,qCAAqC,YAAY,EAAE,EAAE;gBACnE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AA7CD,0DA6CC"}

package/dist/commonjs/resources/mapbox-sdk-docs-resource/MapboxSdkDocsResource.d.ts

@@ -3,12 +3,16 @@ import type { ReadResourceResult, ServerNotification, ServerRequest } from '@mod
 import type { HttpRequest } from '../../utils/types.js';
 import { BaseResource } from '../BaseResource.js';
 /**
- * Resource providing Mapbox SDK documentation
+ * Resource providing Mapbox GL JS SDK documentation.
+ * Fetches the Mapbox GL JS llms.txt index which lists all GL JS guides,
+ * API reference pages, and examples with direct links to each page.
+ * GL JS is the primary web mapping SDK; use get_document_tool to fetch
+ * full content of any listed page.
  */
 export declare class MapboxSdkDocsResource extends BaseResource {
     readonly name = "Mapbox SDK Documentation";
     readonly uri = "resource://mapbox-sdk-docs";
-    readonly description = "Mapbox SDK and client library documentation for mobile (iOS, Android, Flutter) and web (Mapbox GL JS, Search JS) platforms";
+    readonly description: string;
     readonly mimeType = "text/markdown";
     private httpRequest;
     constructor(params: {

package/dist/commonjs/resources/mapbox-sdk-docs-resource/MapboxSdkDocsResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxSdkDocsResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-sdk-docs-resource/MapboxSdkDocsResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,GAAG,gCAAgC;IAC5C,QAAQ,CAAC,WAAW,gIAC2G;IAC/H,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA2C/B"}
+{"version":3,"file":"MapboxSdkDocsResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-sdk-docs-resource/MapboxSdkDocsResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,GAAG,gCAAgC;IAC5C,QAAQ,CAAC,WAAW,SAKsB;IAC1C,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CAwB/B"}

package/dist/commonjs/resources/mapbox-sdk-docs-resource/MapboxSdkDocsResource.js

@@ -3,16 +3,23 @@
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MapboxSdkDocsResource = void 0;
-const docCache_js_1 = require("../../utils/docCache.js");
 const BaseResource_js_1 = require("../BaseResource.js");
-const docParser_js_1 = require("../utils/docParser.js");
+const docFetcher_js_1 = require("../../utils/docFetcher.js");
 /**
- * Resource providing Mapbox SDK documentation
+ * Resource providing Mapbox GL JS SDK documentation.
+ * Fetches the Mapbox GL JS llms.txt index which lists all GL JS guides,
+ * API reference pages, and examples with direct links to each page.
+ * GL JS is the primary web mapping SDK; use get_document_tool to fetch
+ * full content of any listed page.
  */
 class MapboxSdkDocsResource extends BaseResource_js_1.BaseResource {
     name = 'Mapbox SDK Documentation';
     uri = 'resource://mapbox-sdk-docs';
-    description = 'Mapbox SDK and client library documentation for mobile (iOS, Android, Flutter) and web (Mapbox GL JS, Search JS) platforms';
+    description = 'Mapbox GL JS documentation index: guides for getting started, adding data, ' +
+        'globe/projections, indoor mapping, gestures, styling layers, and migration. ' +
+        'Also includes links to API reference and code examples. ' +
+        'For mobile/native SDKs (iOS, Android, Flutter), use resource://mapbox-reference ' +
+        'to discover their documentation URLs.';
     mimeType = 'text/markdown';
     httpRequest;
     constructor(params) {
@@ -21,30 +28,13 @@ class MapboxSdkDocsResource extends BaseResource_js_1.BaseResource {
     }
     async readCallback(uri, _extra) {
         try {
-            const LLMS_TXT_URL = 'https://docs.mapbox.com/llms.txt';
-            let content = docCache_js_1.docCache.get(LLMS_TXT_URL);
-            if (!content) {
-                const response = await this.httpRequest(LLMS_TXT_URL, {
-                    headers: {
-                        Accept: 'text/markdown, text/plain;q=0.9, */*;q=0.8'
-                    }
-                });
-                if (!response.ok) {
-                    throw new Error(`Failed to fetch Mapbox documentation: ${response.statusText}`);
-                }
-                content = await response.text();
-                docCache_js_1.docCache.set(LLMS_TXT_URL, content);
-            }
-            // Parse and filter for SDK sections only
-            const allSections = (0, docParser_js_1.parseDocSections)(content);
-            const sdkSections = (0, docParser_js_1.filterSectionsByCategory)(allSections, 'sdks');
-            const sdkContent = (0, docParser_js_1.sectionsToMarkdown)(sdkSections);
+            const content = await (0, docFetcher_js_1.fetchCachedText)('https://docs.mapbox.com/mapbox-gl-js/llms.txt', this.httpRequest);
             return {
                 contents: [
                     {
                         uri: uri.href,
                         mimeType: this.mimeType,
-                        text: `# Mapbox SDK Documentation\n\n${sdkContent}`
+                        text: content
                     }
                 ]
             };

package/dist/commonjs/resources/mapbox-sdk-docs-resource/MapboxSdkDocsResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxSdkDocsResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-sdk-docs-resource/MapboxSdkDocsResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AASlC,yDAAmD;AACnD,wDAAkD;AAClD,wDAI+B;AAE/B;;GAEG;AACH,MAAa,qBAAsB,SAAQ,8BAAY;IAC5C,IAAI,GAAG,0BAA0B,CAAC;IAClC,GAAG,GAAG,4BAA4B,CAAC;IACnC,WAAW,GAClB,4HAA4H,CAAC;IACtH,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,kCAAkC,CAAC;YACxD,IAAI,OAAO,GAAG,sBAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;oBACpD,OAAO,EAAE;wBACP,MAAM,EAAE,4CAA4C;qBACrD;iBACF,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,CAAC,UAAU,EAAE,CAC/D,CAAC;gBACJ,CAAC;gBAED,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,sBAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAED,yCAAyC;YACzC,MAAM,WAAW,GAAG,IAAA,+BAAgB,EAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,WAAW,GAAG,IAAA,uCAAwB,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAClE,MAAM,UAAU,GAAG,IAAA,iCAAkB,EAAC,WAAW,CAAC,CAAC;YAEnD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,iCAAiC,UAAU,EAAE;qBACpD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,oCAAoC,YAAY,EAAE,EAAE;gBAClE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AA5DD,sDA4DC"}
+{"version":3,"file":"MapboxSdkDocsResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-sdk-docs-resource/MapboxSdkDocsResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AASlC,wDAAkD;AAClD,6DAA4D;AAE5D;;;;;;GAMG;AACH,MAAa,qBAAsB,SAAQ,8BAAY;IAC5C,IAAI,GAAG,0BAA0B,CAAC;IAClC,GAAG,GAAG,4BAA4B,CAAC;IACnC,WAAW,GAClB,6EAA6E;QAC7E,8EAA8E;QAC9E,0DAA0D;QAC1D,kFAAkF;QAClF,uCAAuC,CAAC;IACjC,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAA,+BAAe,EACnC,+CAA+C,EAC/C,IAAI,CAAC,WAAW,CACjB,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,OAAO;qBACd;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,oCAAoC,YAAY,EAAE,EAAE;gBAClE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AA7CD,sDA6CC"}

package/dist/commonjs/tools/BaseTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseTool.d.ts","sourceRoot":"","sources":["../../../src/tools/BaseTool.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,SAAS,EACT,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EACL,cAAc,EACd,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEpC,8BAAsB,QAAQ,CAC5B,WAAW,SAAS,UAAU,EAC9B,YAAY,SAAS,UAAU,GAAG,UAAU;IAE5C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAE/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAE9B,MAAM,EAAE;QAClB,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,CAAC,EAAE,YAAY,CAAC;KAC7B;IAKD;;OAEG;IACG,GAAG,CACP,QAAQ,EAAE,OAAO,EAEjB,MAAM,CAAC,EAAE,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAY1B,SAAS,CAAC,QAAQ,CAAC,OAAO,CACxB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc;IAkC5C;;OAEG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAC7C,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,IAAI;CAKR"}
+{"version":3,"file":"BaseTool.d.ts","sourceRoot":"","sources":["../../../src/tools/BaseTool.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,SAAS,EACT,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EACL,cAAc,EACd,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAGpC,8BAAsB,QAAQ,CAC5B,WAAW,SAAS,UAAU,EAC9B,YAAY,SAAS,UAAU,GAAG,UAAU;IAE5C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAE/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAE9B,MAAM,EAAE;QAClB,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,CAAC,EAAE,YAAY,CAAC;KAC7B;IAKD;;OAEG;IACG,GAAG,CACP,QAAQ,EAAE,OAAO,EAEjB,MAAM,CAAC,EAAE,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC;IAmB1B,SAAS,CAAC,QAAQ,CAAC,OAAO,CACxB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc;IAkC5C;;OAEG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAC7C,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,IAAI;CAKR"}

package/dist/commonjs/tools/BaseTool.js

@@ -3,6 +3,7 @@
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseTool = void 0;
+const tracing_js_1 = require("../utils/tracing.js");
 class BaseTool {
     inputSchema;
     outputSchema;
@@ -17,16 +18,23 @@ class BaseTool {
     async run(rawInput, 
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     _extra) {
-        try {
-            const input = this.inputSchema.parse(rawInput);
-            return this.execute(input);
-        }
-        catch (error) {
-            return {
-                isError: true,
-                content: [{ type: 'text', text: error.message }]
-            };
-        }
+        return (0, tracing_js_1.withToolSpan)(this.name, async (span) => {
+            try {
+                const input = this.inputSchema.parse(rawInput);
+                const result = await this.execute(input);
+                if (result.isError) {
+                    span.setAttribute('tool.error', true);
+                }
+                return result;
+            }
+            catch (error) {
+                span.setAttribute('tool.error', true);
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: error.message }]
+                };
+            }
+        });
     }
     /**
      * Installs the tool to the given MCP server.

package/dist/commonjs/tools/BaseTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseTool.js","sourceRoot":"","sources":["../../../src/tools/BaseTool.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAalC,MAAsB,QAAQ;IAQnB,WAAW,CAAc;IACzB,YAAY,CAAgB;IAC3B,MAAM,GAAqB,IAAI,CAAC;IAE1C,YAAY,MAGX;QACC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,QAAiB;IACjB,8DAA8D;IAC9D,MAAsC;QAEtC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;aAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IAMD;;OAEG;IACH,SAAS,CAAC,MAAiB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,MAAM,MAAM,GAQR;YACF,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,8DAA8D;YAC9D,WAAW,EAAG,IAAI,CAAC,WAA2C,CAAC,KAAK;YACpE,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QAEF,+BAA+B;QAC/B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,CAAC,YAAY;gBACjB,8DAA8D;gBAC7D,IAAI,CAAC,YAA4C,CAAC,KAAK,CAAC;QAC7D,CAAC;QAED,OAAO,MAAM,CAAC,YAAY,CACxB,IAAI,CAAC,IAAI,EACT,MAAM;QACN,8DAA8D;QAC9D,CAAC,IAAS,EAAE,KAAU,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CACjD,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,GAAG,CACX,KAA6C,EAC7C,IAAsC;QAEtC,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF;AA3FD,4BA2FC"}
+{"version":3,"file":"BaseTool.js","sourceRoot":"","sources":["../../../src/tools/BaseTool.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAYlC,oDAAmD;AAEnD,MAAsB,QAAQ;IAQnB,WAAW,CAAc;IACzB,YAAY,CAAgB;IAC3B,MAAM,GAAqB,IAAI,CAAC;IAE1C,YAAY,MAGX;QACC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,QAAiB;IACjB,8DAA8D;IAC9D,MAAsC;QAEtC,OAAO,IAAA,yBAAY,EAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC5C,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;gBACxC,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;gBACtC,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;iBAC5D,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAMD;;OAEG;IACH,SAAS,CAAC,MAAiB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,MAAM,MAAM,GAQR;YACF,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,8DAA8D;YAC9D,WAAW,EAAG,IAAI,CAAC,WAA2C,CAAC,KAAK;YACpE,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QAEF,+BAA+B;QAC/B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,CAAC,YAAY;gBACjB,8DAA8D;gBAC7D,IAAI,CAAC,YAA4C,CAAC,KAAK,CAAC;QAC7D,CAAC;QAED,OAAO,MAAM,CAAC,YAAY,CACxB,IAAI,CAAC,IAAI,EACT,MAAM;QACN,8DAA8D;QAC9D,CAAC,IAAS,EAAE,KAAU,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CACjD,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,GAAG,CACX,KAA6C,EAC7C,IAAsC;QAEtC,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF;AAlGD,4BAkGC"}

package/dist/commonjs/tools/search-docs-tool/SearchDocsTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SearchDocsTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/search-docs-tool/SearchDocsTool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAgE1C,qBAAa,cAAe,SAAQ,QAAQ,CAAC,OAAO,gBAAgB,CAAC;IACnE,IAAI,SAA6B;IACjC,WAAW,SAC6L;IACxM,QAAQ,CAAC,WAAW;;;;;;MAMlB;IAEF,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;cAKhC,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CA8CzE"}
+{"version":3,"file":"SearchDocsTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/search-docs-tool/SearchDocsTool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAsB1C,qBAAa,cAAe,SAAQ,QAAQ,CAAC,OAAO,gBAAgB,CAAC;IACnE,IAAI,SAA6B;IACjC,WAAW,SAK2D;IACtE,QAAQ,CAAC,WAAW;;;;;;MAMlB;IAEF,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;cAKhC,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAoBzE"}