@mapbox/mcp-server 0.9.2-dev → 0.12.3-dev

package/dist/commonjs/tools/static-map-image-tool/StaticMapImageTool.js

@@ -4,10 +4,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StaticMapImageTool = void 0;
 const node_crypto_1 = require("node:crypto");
-const server_1 = require("@mcp-ui/server");
 const MapboxApiBasedTool_js_1 = require("../MapboxApiBasedTool.js");
 const StaticMapImageTool_input_schema_js_1 = require("./StaticMapImageTool.input.schema.js");
-const toolConfig_js_1 = require("../../config/toolConfig.js");
+const temporaryResourceManager_js_1 = require("../../utils/temporaryResourceManager.js");
+const jwtUtils_js_1 = require("../../utils/jwtUtils.js");
+// Images larger than this threshold are stored as temporary resources instead
+// of being inlined as base64, to avoid exceeding Claude Desktop's 1MB tool
+// result limit. base64 adds ~33% overhead, so 700KB raw ≈ 933KB encoded.
+const IMAGE_INLINE_THRESHOLD = 700 * 1024; // 700KB
 class StaticMapImageTool extends MapboxApiBasedTool_js_1.MapboxApiBasedTool {
     name = 'static_map_image_tool';
     description = 'Generates a static map image from Mapbox Static Images API. Supports center coordinates, zoom level (0-22), image size (up to 1280x1280), various Mapbox styles, and overlays (markers, paths, GeoJSON). Returns PNG for vector styles, JPEG for raster-only styles.';
@@ -18,15 +22,6 @@ class StaticMapImageTool extends MapboxApiBasedTool_js_1.MapboxApiBasedTool {
         idempotentHint: true,
         openWorldHint: true
     };
-    meta = {
-        ui: {
-            resourceUri: 'ui://mapbox/static-map/index.html',
-            csp: {
-                connectDomains: ['https://api.mapbox.com'],
-                resourceDomains: ['https://api.mapbox.com']
-            }
-        }
-    };
     constructor(params) {
         super({
             inputSchema: StaticMapImageTool_input_schema_js_1.StaticMapImageInputSchema,
@@ -85,8 +80,13 @@ class StaticMapImageTool extends MapboxApiBasedTool_js_1.MapboxApiBasedTool {
             overlayString = encodedOverlays.join(',') + '/';
         }
         const density = input.highDensity ? '@2x' : '';
-        const url = `${MapboxApiBasedTool_js_1.MapboxApiBasedTool.mapboxApiEndpoint}styles/v1/${input.style}/static/${overlayString}${lng},${lat},${input.zoom}/${width}x${height}${density}?access_token=${accessToken}`;
-        // Fetch and encode image as base64 for clients without MCP Apps support
+        const encodedStyle = input.style
+            .split('/')
+            .map(encodeURIComponent)
+            .join('/');
+        const publicUrl = `${MapboxApiBasedTool_js_1.MapboxApiBasedTool.mapboxApiEndpoint}styles/v1/${encodedStyle}/static/${overlayString}${lng},${lat},${input.zoom}/${width}x${height}${density}`;
+        const url = `${publicUrl}?access_token=${accessToken}`;
+        // Fetch image
         const response = await this.httpRequest(url);
         if (!response.ok) {
             const errorMessage = await this.getErrorMessage(response);
@@ -96,35 +96,28 @@ class StaticMapImageTool extends MapboxApiBasedTool_js_1.MapboxApiBasedTool {
             };
         }
         const buffer = await response.arrayBuffer();
-        const base64Data = Buffer.from(buffer).toString('base64');
         const isRasterStyle = input.style.includes('satellite');
         const mimeType = isRasterStyle ? 'image/jpeg' : 'image/png';
         // content[0] MUST be the URL text — MCP Apps UI finds it via content.find(c => c.type === 'text')
+        // Use public URL (without credentials) to avoid leaking the access token
         const content = [
-            {
-                type: 'text',
-                text: url
-            },
-            {
-                type: 'image',
-                data: base64Data,
-                mimeType
-            }
+            { type: 'text', text: publicUrl }
         ];
-        // Conditionally add MCP-UI resource if enabled (backward compatibility)
-        if ((0, toolConfig_js_1.isMcpUiEnabled)()) {
-            const uiResource = (0, server_1.createUIResource)({
-                uri: `ui://mapbox/static-map/${input.style}/${lng},${lat},${input.zoom}`,
-                content: {
-                    type: 'externalUrl',
-                    iframeUrl: url
-                },
-                encoding: 'text',
-                uiMetadata: {
-                    'preferred-frame-size': [`${width}px`, `${height}px`]
-                }
+        if (buffer.byteLength > IMAGE_INLINE_THRESHOLD) {
+            // Image is too large to inline safely — store as temporary resource
+            const resourceId = (0, node_crypto_1.randomBytes)(16).toString('hex');
+            const resourceUri = `mapbox://temp/static-map-${resourceId}`;
+            const base64Data = Buffer.from(buffer).toString('base64');
+            temporaryResourceManager_js_1.temporaryResourceManager.create(resourceId, resourceUri, base64Data, { toolName: this.name, size: buffer.byteLength }, undefined, mimeType, (0, jwtUtils_js_1.getUserNameFromToken)(accessToken));
+            content.push({
+                type: 'text',
+                text: `⚠️ Image (${Math.round(buffer.byteLength / 1024)}KB) stored as temporary resource.\nResource URI: ${resourceUri}\nTTL: 30 minutes`
             });
-            content.push(uiResource);
+        }
+        else {
+            // Image is small enough to inline as base64
+            const base64Data = Buffer.from(buffer).toString('base64');
+            content.push({ type: 'image', data: base64Data, mimeType });
         }
         return {
             content,

package/dist/commonjs/tools/static-map-image-tool/StaticMapImageTool.js.map

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

package/dist/commonjs/tools/toolRegistry.d.ts

@@ -1,3 +1,13 @@
+import { GroundLocationTool } from './ground-location-tool/GroundLocationTool.js';
+import { PointsWithinPolygonTool } from './points-within-polygon-tool/PointsWithinPolygonTool.js';
+import { UnionTool } from './union-tool/UnionTool.js';
+import { NearestPointTool } from './nearest-point-tool/NearestPointTool.js';
+import { IntersectTool } from './intersect-tool/IntersectTool.js';
+import { DifferenceTool } from './difference-tool/DifferenceTool.js';
+import { DestinationTool } from './destination-tool/DestinationTool.js';
+import { LengthTool } from './length-tool/LengthTool.js';
+import { NearestPointOnLineTool } from './nearest-point-on-line-tool/NearestPointOnLineTool.js';
+import { ConvexTool } from './convex-tool/ConvexTool.js';
 import { PlaceDetailsTool } from './place-details-tool/PlaceDetailsTool.js';
 import { SimplifyTool } from './simplify-tool/SimplifyTool.js';
 import { BoundingBoxTool } from './bounding-box-tool/BoundingBoxTool.js';
@@ -6,7 +16,6 @@ import { MidpointTool } from './midpoint-tool/MidpointTool.js';
 import { BearingTool } from './bearing-tool/BearingTool.js';
 import { AreaTool } from './area-tool/AreaTool.js';
 import { BufferTool } from './buffer-tool/BufferTool.js';
-import { PointInPolygonTool } from './point-in-polygon-tool/PointInPolygonTool.js';
 import { DistanceTool } from './distance-tool/DistanceTool.js';
 import { CategoryListTool } from './category-list-tool/CategoryListTool.js';
 import { CategorySearchTool } from './category-search-tool/CategorySearchTool.js';
@@ -23,7 +32,7 @@ import { SearchAndGeocodeTool } from './search-and-geocode-tool/SearchAndGeocode
  * Core tools that work in all MCP clients without requiring special capabilities
  * These tools are registered immediately during server startup
  */
-export declare const CORE_TOOLS: readonly [PlaceDetailsTool, SimplifyTool, BoundingBoxTool, CentroidTool, MidpointTool, BearingTool, AreaTool, BufferTool, PointInPolygonTool, DistanceTool, CategorySearchTool, DirectionsTool, IsochroneTool, MapMatchingTool, MatrixTool, OptimizationTool, ReverseGeocodeTool, StaticMapImageTool, SearchAndGeocodeTool];
+export declare const CORE_TOOLS: readonly [GroundLocationTool, PointsWithinPolygonTool, UnionTool, NearestPointTool, IntersectTool, DifferenceTool, DestinationTool, LengthTool, NearestPointOnLineTool, ConvexTool, PlaceDetailsTool, SimplifyTool, BoundingBoxTool, CentroidTool, MidpointTool, BearingTool, AreaTool, BufferTool, DistanceTool, CategorySearchTool, DirectionsTool, IsochroneTool, MapMatchingTool, MatrixTool, OptimizationTool, ReverseGeocodeTool, StaticMapImageTool, SearchAndGeocodeTool];
 /**
  * Tools that require elicitation capability for optimal functionality
  * These tools use elicitInput() for secure token management
@@ -53,7 +62,7 @@ export declare const RESOURCE_FALLBACK_TOOLS: readonly [ResourceReaderTool, Cate
 /**
  * All tools combined (for backward compatibility and testing)
  */
-export declare const ALL_TOOLS: readonly [PlaceDetailsTool, SimplifyTool, BoundingBoxTool, CentroidTool, MidpointTool, BearingTool, AreaTool, BufferTool, PointInPolygonTool, DistanceTool, CategorySearchTool, DirectionsTool, IsochroneTool, MapMatchingTool, MatrixTool, OptimizationTool, ReverseGeocodeTool, StaticMapImageTool, SearchAndGeocodeTool, ResourceReaderTool, CategoryListTool];
+export declare const ALL_TOOLS: readonly [GroundLocationTool, PointsWithinPolygonTool, UnionTool, NearestPointTool, IntersectTool, DifferenceTool, DestinationTool, LengthTool, NearestPointOnLineTool, ConvexTool, PlaceDetailsTool, SimplifyTool, BoundingBoxTool, CentroidTool, MidpointTool, BearingTool, AreaTool, BufferTool, DistanceTool, CategorySearchTool, DirectionsTool, IsochroneTool, MapMatchingTool, MatrixTool, OptimizationTool, ReverseGeocodeTool, StaticMapImageTool, SearchAndGeocodeTool, ResourceReaderTool, CategoryListTool];
 export type ToolInstance = (typeof ALL_TOOLS)[number];
 /**
  * Get all tools (for backward compatibility)

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

@@ -1 +1 @@
-{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../../src/tools/toolRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAGzF;;;GAGG;AACH,eAAO,MAAM,UAAU,6TAqBb,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,aAAc,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,iDAG1B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS,mWAIZ,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,WAAW,IAAI,SAAS,YAAY,EAAE,CAErD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,YAAY,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,YAAY,EAAE,CAE7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,SAAS,YAAY,EAAE,CAElE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpE"}
+{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../../src/tools/toolRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAClG,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAGzF;;;GAGG;AACH,eAAO,MAAM,UAAU,mdA8Bb,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,aAAc,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,iDAG1B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS,yfAIZ,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,WAAW,IAAI,SAAS,YAAY,EAAE,CAErD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,YAAY,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,YAAY,EAAE,CAE7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,SAAS,YAAY,EAAE,CAElE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpE"}

package/dist/commonjs/tools/toolRegistry.js

@@ -9,6 +9,16 @@ exports.getElicitationTools = getElicitationTools;
 exports.getResourceFallbackTools = getResourceFallbackTools;
 exports.getToolByName = getToolByName;
 // INSERT NEW TOOL IMPORT HERE
+const GroundLocationTool_js_1 = require("./ground-location-tool/GroundLocationTool.js");
+const PointsWithinPolygonTool_js_1 = require("./points-within-polygon-tool/PointsWithinPolygonTool.js");
+const UnionTool_js_1 = require("./union-tool/UnionTool.js");
+const NearestPointTool_js_1 = require("./nearest-point-tool/NearestPointTool.js");
+const IntersectTool_js_1 = require("./intersect-tool/IntersectTool.js");
+const DifferenceTool_js_1 = require("./difference-tool/DifferenceTool.js");
+const DestinationTool_js_1 = require("./destination-tool/DestinationTool.js");
+const LengthTool_js_1 = require("./length-tool/LengthTool.js");
+const NearestPointOnLineTool_js_1 = require("./nearest-point-on-line-tool/NearestPointOnLineTool.js");
+const ConvexTool_js_1 = require("./convex-tool/ConvexTool.js");
 const PlaceDetailsTool_js_1 = require("./place-details-tool/PlaceDetailsTool.js");
 const SimplifyTool_js_1 = require("./simplify-tool/SimplifyTool.js");
 const BoundingBoxTool_js_1 = require("./bounding-box-tool/BoundingBoxTool.js");
@@ -17,7 +27,6 @@ const MidpointTool_js_1 = require("./midpoint-tool/MidpointTool.js");
 const BearingTool_js_1 = require("./bearing-tool/BearingTool.js");
 const AreaTool_js_1 = require("./area-tool/AreaTool.js");
 const BufferTool_js_1 = require("./buffer-tool/BufferTool.js");
-const PointInPolygonTool_js_1 = require("./point-in-polygon-tool/PointInPolygonTool.js");
 const DistanceTool_js_1 = require("./distance-tool/DistanceTool.js");
 const CategoryListTool_js_1 = require("./category-list-tool/CategoryListTool.js");
 const CategorySearchTool_js_1 = require("./category-search-tool/CategorySearchTool.js");
@@ -37,6 +46,16 @@ const httpPipeline_js_1 = require("../utils/httpPipeline.js");
  */
 exports.CORE_TOOLS = [
     // INSERT NEW TOOL INSTANCE HERE
+    new GroundLocationTool_js_1.GroundLocationTool({ httpRequest: httpPipeline_js_1.httpRequest }),
+    new PointsWithinPolygonTool_js_1.PointsWithinPolygonTool(),
+    new UnionTool_js_1.UnionTool(),
+    new NearestPointTool_js_1.NearestPointTool(),
+    new IntersectTool_js_1.IntersectTool(),
+    new DifferenceTool_js_1.DifferenceTool(),
+    new DestinationTool_js_1.DestinationTool(),
+    new LengthTool_js_1.LengthTool(),
+    new NearestPointOnLineTool_js_1.NearestPointOnLineTool(),
+    new ConvexTool_js_1.ConvexTool(),
     new PlaceDetailsTool_js_1.PlaceDetailsTool({ httpRequest: httpPipeline_js_1.httpRequest }),
     new SimplifyTool_js_1.SimplifyTool(),
     new BoundingBoxTool_js_1.BoundingBoxTool(),
@@ -45,7 +64,6 @@ exports.CORE_TOOLS = [
     new BearingTool_js_1.BearingTool(),
     new AreaTool_js_1.AreaTool(),
     new BufferTool_js_1.BufferTool(),
-    new PointInPolygonTool_js_1.PointInPolygonTool(),
     new DistanceTool_js_1.DistanceTool(),
     new CategorySearchTool_js_1.CategorySearchTool({ httpRequest: httpPipeline_js_1.httpRequest }),
     new DirectionsTool_js_1.DirectionsTool({ httpRequest: httpPipeline_js_1.httpRequest }),

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

@@ -1 +1 @@
-{"version":3,"file":"toolRegistry.js","sourceRoot":"","sources":["../../../src/tools/toolRegistry.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAmGlC,kCAEC;AAKD,oCAEC;AAKD,kDAEC;AAKD,4DAEC;AAED,sCAEC;AA5HD,8BAA8B;AAC9B,kFAA4E;AAC5E,qEAA+D;AAC/D,+EAAyE;AACzE,qEAA+D;AAC/D,qEAA+D;AAC/D,kEAA4D;AAC5D,yDAAmD;AACnD,+DAAyD;AACzD,yFAAmF;AACnF,qEAA+D;AAC/D,kFAA4E;AAC5E,wFAAkF;AAClF,2EAAqE;AACrE,wEAAkE;AAClE,+EAAyE;AACzE,+DAAyD;AACzD,iFAA2E;AAC3E,wFAAkF;AAClF,wFAAkF;AAClF,yFAAmF;AACnF,+FAAyF;AACzF,8DAAuD;AAEvD;;;GAGG;AACU,QAAA,UAAU,GAAG;IACxB,gCAAgC;IAChC,IAAI,sCAAgB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IACrC,IAAI,8BAAY,EAAE;IAClB,IAAI,oCAAe,EAAE;IACrB,IAAI,8BAAY,EAAE;IAClB,IAAI,8BAAY,EAAE;IAClB,IAAI,4BAAW,EAAE;IACjB,IAAI,sBAAQ,EAAE;IACd,IAAI,0BAAU,EAAE;IAChB,IAAI,0CAAkB,EAAE;IACxB,IAAI,8BAAY,EAAE;IAClB,IAAI,0CAAkB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IACvC,IAAI,kCAAc,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IACnC,IAAI,gCAAa,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IAClC,IAAI,oCAAe,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IACpC,IAAI,0BAAU,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IAC/B,IAAI,sCAAgB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IACrC,IAAI,0CAAkB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IACvC,IAAI,0CAAkB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IACvC,IAAI,8CAAoB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;CACjC,CAAC;AAEX;;;;;;;GAOG;AACU,QAAA,iBAAiB,GAAG,EAAW,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACU,QAAA,uBAAuB,GAAG;IACrC,IAAI,0CAAkB,EAAE;IACxB,IAAI,sCAAgB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;CAC7B,CAAC;AAEX;;GAEG;AACU,QAAA,SAAS,GAAG;IACvB,GAAG,kBAAU;IACb,GAAG,yBAAiB;IACpB,GAAG,+BAAuB;CAClB,CAAC;AAIX;;;GAGG;AACH,SAAgB,WAAW;IACzB,OAAO,iBAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,kBAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB;IACjC,OAAO,yBAAiB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB;IACtC,OAAO,+BAAuB,CAAC;AACjC,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,iBAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"toolRegistry.js","sourceRoot":"","sources":["../../../src/tools/toolRegistry.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/tools/union-tool/UnionTool.d.ts

@@ -0,0 +1,18 @@
+import { BaseTool } from '../BaseTool.js';
+import { UnionInputSchema } from './UnionTool.input.schema.js';
+import { UnionOutputSchema } from './UnionTool.output.schema.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare class UnionTool extends BaseTool<typeof UnionInputSchema, typeof UnionOutputSchema> {
+    readonly name = "union_tool";
+    readonly description: string;
+    readonly annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    constructor();
+    run(rawInput: unknown): Promise<CallToolResult>;
+}
+//# sourceMappingURL=UnionTool.d.ts.map

package/dist/commonjs/tools/union-tool/UnionTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnionTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EACL,iBAAiB,EAElB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,qBAAa,SAAU,SAAQ,QAAQ,CACrC,OAAO,gBAAgB,EACvB,OAAO,iBAAiB,CACzB;IACC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,SAIiB;IAErC,QAAQ,CAAC,WAAW;;;;;;MAMlB;;IAMI,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;CAmDtD"}

package/dist/commonjs/tools/union-tool/UnionTool.input.schema.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export declare const UnionInputSchema: z.ZodObject<{
+    polygons: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodArray<z.ZodNumber>>>>;
+}, z.core.$strip>;
+export type UnionInput = z.infer<typeof UnionInputSchema>;
+//# sourceMappingURL=UnionTool.input.schema.d.ts.map

package/dist/commonjs/tools/union-tool/UnionTool.input.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnionTool.input.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.input.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,gBAAgB;;iBAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/commonjs/tools/union-tool/UnionTool.input.schema.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnionInputSchema = void 0;
+const zod_1 = require("zod");
+const polygonSchema_js_1 = require("../shared/polygonSchema.js");
+exports.UnionInputSchema = zod_1.z.object({
+    polygons: zod_1.z
+        .array(polygonSchema_js_1.PolygonSchema)
+        .min(2)
+        .describe('Array of polygons to merge into a single union geometry')
+});
+//# sourceMappingURL=UnionTool.input.schema.js.map

package/dist/commonjs/tools/union-tool/UnionTool.input.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnionTool.input.schema.js","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.input.schema.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,6BAAwB;AACxB,iEAA2D;AAE9C,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,OAAC;SACR,KAAK,CAAC,gCAAa,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC,CAAC"}

package/dist/commonjs/tools/union-tool/UnionTool.js

@@ -0,0 +1,72 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnionTool = void 0;
+const turf_1 = require("@turf/turf");
+const api_1 = require("@opentelemetry/api");
+const tracing_js_1 = require("../../utils/tracing.js");
+const BaseTool_js_1 = require("../BaseTool.js");
+const UnionTool_input_schema_js_1 = require("./UnionTool.input.schema.js");
+const UnionTool_output_schema_js_1 = require("./UnionTool.output.schema.js");
+class UnionTool extends BaseTool_js_1.BaseTool {
+    name = 'union_tool';
+    description = 'Merge two or more polygons into a single unified geometry. ' +
+        'Useful for combining service areas, delivery zones, isochrones, or coverage regions. ' +
+        'Returns a Polygon or MultiPolygon if the inputs do not overlap. ' +
+        'Works offline without API calls.';
+    annotations = {
+        title: 'Union Polygons',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+    };
+    constructor() {
+        super({ inputSchema: UnionTool_input_schema_js_1.UnionInputSchema, outputSchema: UnionTool_output_schema_js_1.UnionOutputSchema });
+    }
+    async run(rawInput) {
+        const toolContext = (0, tracing_js_1.createLocalToolExecutionContext)(this.name, 0);
+        return await api_1.context.with(api_1.trace.setSpan(api_1.context.active(), toolContext.span), async () => {
+            try {
+                const input = UnionTool_input_schema_js_1.UnionInputSchema.parse(rawInput);
+                const polys = input.polygons.map((rings) => (0, turf_1.polygon)(rings));
+                // Union all polygons by passing them as a FeatureCollection
+                const merged = (0, turf_1.union)((0, turf_1.featureCollection)(polys));
+                if (!merged)
+                    throw new Error('Union operation returned null');
+                const output = {
+                    geometry: merged.geometry,
+                    type: merged.geometry.type
+                };
+                const validated = this.validateOutput(output);
+                const text = `Union of ${input.polygons.length} polygons computed.\n` +
+                    `Result type: ${validated.type}\n` +
+                    `GeoJSON geometry:\n${JSON.stringify(validated.geometry, null, 2)}`;
+                toolContext.span.setStatus({ code: api_1.SpanStatusCode.OK });
+                toolContext.span.end();
+                return {
+                    content: [{ type: 'text', text }],
+                    structuredContent: validated,
+                    isError: false
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                toolContext.span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: errorMessage
+                });
+                toolContext.span.end();
+                return {
+                    content: [
+                        { type: 'text', text: `UnionTool: ${errorMessage}` }
+                    ],
+                    isError: true
+                };
+            }
+        });
+    }
+}
+exports.UnionTool = UnionTool;
+//# sourceMappingURL=UnionTool.js.map

package/dist/commonjs/tools/union-tool/UnionTool.js.map

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

package/dist/commonjs/tools/union-tool/UnionTool.output.schema.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const UnionOutputSchema: z.ZodObject<{
+    geometry: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    type: z.ZodString;
+}, z.core.$strip>;
+export type UnionOutput = z.infer<typeof UnionOutputSchema>;
+//# sourceMappingURL=UnionTool.output.schema.d.ts.map

package/dist/commonjs/tools/union-tool/UnionTool.output.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnionTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;iBAO5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/commonjs/tools/union-tool/UnionTool.output.schema.js

@@ -0,0 +1,13 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnionOutputSchema = void 0;
+const zod_1 = require("zod");
+exports.UnionOutputSchema = zod_1.z.object({
+    geometry: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.unknown())
+        .describe('GeoJSON geometry of the merged polygon (Polygon or MultiPolygon)'),
+    type: zod_1.z.string().describe('Geometry type: Polygon or MultiPolygon')
+});
+//# sourceMappingURL=UnionTool.output.schema.js.map

package/dist/commonjs/tools/union-tool/UnionTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnionTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/union-tool/UnionTool.output.schema.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,6BAAwB;AAEX,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,OAAC;SACR,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,CACP,kEAAkE,CACnE;IACH,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CACpE,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"validateOutput.d.ts","sourceRoot":"","sources":["../../../src/tools/validateOutput.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,SAAS,UAAU,EACvE,MAAM,EAAE,cAAc,EACtB,YAAY,CAAC,EAAE,YAAY,EAC3B,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc,CAoDhB"}
+{"version":3,"file":"validateOutput.d.ts","sourceRoot":"","sources":["../../../src/tools/validateOutput.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,SAAS,UAAU,EACvE,MAAM,EAAE,cAAc,EACtB,YAAY,CAAC,EAAE,YAAY,EAC3B,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc,CAqDhB"}

package/dist/commonjs/tools/validateOutput.js

@@ -26,6 +26,7 @@ function validateAndSanitizeOutput(result, outputSchema, toolName) {
         // If successful, return the result with validated structured content
         return {
             ...result,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             structuredContent: parsed
         };
     }

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

@@ -1 +1 @@
-{"version":3,"file":"validateOutput.js","sourceRoot":"","sources":["../../../src/tools/validateOutput.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;AAalC,8DAwDC;AAhED;;;;;;;GAOG;AACH,SAAgB,yBAAyB,CACvC,MAAsB,EACtB,YAA2B,EAC3B,QAAiB;IAEjB,+CAA+C;IAC/C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sEAAsE;IACtE,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,sDAAsD;QACtD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAE5D,qEAAqE;QACrE,OAAO;YACL,GAAG,MAAM;YACT,iBAAiB,EAAE,MAAM;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,eAAe,EAAE,CAAC;QACzB,uEAAuE;QACvE,qEAAqE;QACrE,MAAM,YAAY,GAChB,eAAe,YAAY,KAAK;YAC9B,CAAC,CAAC,eAAe,CAAC,OAAO;YACzB,CAAC,CAAC,0BAA0B,CAAC;QAEjC,OAAO,CAAC,IAAI,CACV,qCAAqC,QAAQ,IAAI,SAAS,KAAK,YAAY,EAAE,CAC9E,CAAC;QAEF,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAEnE,2DAA2D;QAC3D,yCAAyC;QACzC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,MAAM;wBAClC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;wBACxB,CAAC,CAAC,QAAQ;iBACf;aACF;YACD,0DAA0D;YAC1D,kDAAkD;YAClD,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"validateOutput.js","sourceRoot":"","sources":["../../../src/tools/validateOutput.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;AAalC,8DAyDC;AAjED;;;;;;;GAOG;AACH,SAAgB,yBAAyB,CACvC,MAAsB,EACtB,YAA2B,EAC3B,QAAiB;IAEjB,+CAA+C;IAC/C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sEAAsE;IACtE,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,sDAAsD;QACtD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAE5D,qEAAqE;QACrE,OAAO;YACL,GAAG,MAAM;YACT,8DAA8D;YAC9D,iBAAiB,EAAE,MAAa;SACjC,CAAC;IACJ,CAAC;IAAC,OAAO,eAAe,EAAE,CAAC;QACzB,uEAAuE;QACvE,qEAAqE;QACrE,MAAM,YAAY,GAChB,eAAe,YAAY,KAAK;YAC9B,CAAC,CAAC,eAAe,CAAC,OAAO;YACzB,CAAC,CAAC,0BAA0B,CAAC;QAEjC,OAAO,CAAC,IAAI,CACV,qCAAqC,QAAQ,IAAI,SAAS,KAAK,YAAY,EAAE,CAC9E,CAAC;QAEF,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAEnE,2DAA2D;QAC3D,yCAAyC;QACzC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,MAAM;wBAClC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;wBACxB,CAAC,CAAC,QAAQ;iBACf;aACF;YACD,0DAA0D;YAC1D,kDAAkD;YAClD,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commonjs/utils/jwtUtils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extract the Mapbox username from a JWT access token.
+ *
+ * Mapbox tokens are JWTs whose payload contains the username under the `u` key.
+ * Returns undefined if the token is malformed or missing the `u` field — callers
+ * can decide whether to surface an error or fall back to another auth path.
+ */
+export declare function getUserNameFromToken(token: string): string | undefined;
+//# sourceMappingURL=jwtUtils.d.ts.map

package/dist/commonjs/utils/jwtUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwtUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/jwtUtils.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWtE"}

package/dist/commonjs/utils/jwtUtils.js

@@ -0,0 +1,25 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserNameFromToken = getUserNameFromToken;
+/**
+ * Extract the Mapbox username from a JWT access token.
+ *
+ * Mapbox tokens are JWTs whose payload contains the username under the `u` key.
+ * Returns undefined if the token is malformed or missing the `u` field — callers
+ * can decide whether to surface an error or fall back to another auth path.
+ */
+function getUserNameFromToken(token) {
+    const parts = token.split('.');
+    if (parts.length !== 3)
+        return undefined;
+    try {
+        const payload = JSON.parse(Buffer.from(parts[1], 'base64').toString('utf-8'));
+        return typeof payload.u === 'string' ? payload.u : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=jwtUtils.js.map

package/dist/commonjs/utils/jwtUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwtUtils.js","sourceRoot":"","sources":["../../../src/utils/jwtUtils.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;AASlC,oDAWC;AAlBD;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAAC,KAAa;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CACxB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC/B,CAAC;QACrB,OAAO,OAAO,OAAO,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/commonjs/utils/mapboxPublicToken.d.ts

@@ -0,0 +1,25 @@
+import type { HttpRequest } from './types.js';
+/**
+ * Resolve a public (pk.*) Mapbox token suitable for embedding in client-side
+ * HTML (e.g. an MCP App iframe that initializes Mapbox GL JS).
+ *
+ * Resolution order:
+ * 1. If the access token is already a pk.* token, use it directly.
+ * 2. Reuse a cached pk.* token while it has >5 min TTL remaining.
+ * 3. If the access token is an sk.* token, call
+ *    GET /tokens/v2/{user}?default=true to fetch the user's default public
+ *    token (requires `tokens:read` scope on the bearer).
+ * 4. Fall back to the MAPBOX_PUBLIC_TOKEN env var.
+ *
+ * Returns undefined if none of the above produces a pk.* token.
+ */
+export declare function resolveMapboxPublicToken(params: {
+    accessToken: string;
+    apiEndpoint: string;
+    httpRequest: HttpRequest;
+}): Promise<string | undefined>;
+/**
+ * Reset the cached public token. For tests only.
+ */
+export declare function __resetMapboxPublicTokenCache(): void;
+//# sourceMappingURL=mapboxPublicToken.d.ts.map

package/dist/commonjs/utils/mapboxPublicToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapboxPublicToken.d.ts","sourceRoot":"","sources":["../../../src/utils/mapboxPublicToken.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgB9C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkD9B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/commonjs/utils/mapboxPublicToken.js

@@ -0,0 +1,73 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveMapboxPublicToken = resolveMapboxPublicToken;
+exports.__resetMapboxPublicTokenCache = __resetMapboxPublicTokenCache;
+const jwtUtils_js_1 = require("./jwtUtils.js");
+const PUBLIC_TOKEN_TTL_MS = 60 * 60 * 1000; // 1h
+let cachedPublicToken = null;
+/**
+ * Resolve a public (pk.*) Mapbox token suitable for embedding in client-side
+ * HTML (e.g. an MCP App iframe that initializes Mapbox GL JS).
+ *
+ * Resolution order:
+ * 1. If the access token is already a pk.* token, use it directly.
+ * 2. Reuse a cached pk.* token while it has >5 min TTL remaining.
+ * 3. If the access token is an sk.* token, call
+ *    GET /tokens/v2/{user}?default=true to fetch the user's default public
+ *    token (requires `tokens:read` scope on the bearer).
+ * 4. Fall back to the MAPBOX_PUBLIC_TOKEN env var.
+ *
+ * Returns undefined if none of the above produces a pk.* token.
+ */
+async function resolveMapboxPublicToken(params) {
+    const { accessToken, apiEndpoint, httpRequest } = params;
+    if (accessToken.startsWith('pk.')) {
+        return accessToken;
+    }
+    const now = Date.now();
+    if (cachedPublicToken && cachedPublicToken.expiresAt - now > 5 * 60 * 1000) {
+        return cachedPublicToken.token;
+    }
+    if (accessToken.startsWith('sk.')) {
+        const username = (0, jwtUtils_js_1.getUserNameFromToken)(accessToken);
+        if (username) {
+            try {
+                const tokensUrl = new URL(`${apiEndpoint}tokens/v2/${username}`);
+                tokensUrl.searchParams.set('default', 'true');
+                tokensUrl.searchParams.set('access_token', accessToken);
+                const response = await httpRequest(tokensUrl.toString());
+                if (response.ok) {
+                    const body = (await response.json());
+                    const entries = Array.isArray(body)
+                        ? body
+                        : (body?.tokens ?? []);
+                    const defaultPk = entries.find((entry) => entry?.usage === 'pk' && typeof entry.token === 'string');
+                    if (defaultPk?.token) {
+                        cachedPublicToken = {
+                            token: defaultPk.token,
+                            expiresAt: now + PUBLIC_TOKEN_TTL_MS
+                        };
+                        return defaultPk.token;
+                    }
+                }
+            }
+            catch (err) {
+                // Network failures and JSON parse errors land here. Surface a warning
+                // so the cause is diagnosable from logs rather than masked behind the
+                // generic env-var fallback path.
+                console.warn(`resolveMapboxPublicToken: Tokens API call failed, falling back to MAPBOX_PUBLIC_TOKEN env var: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    const envFallback = process.env.MAPBOX_PUBLIC_TOKEN;
+    return envFallback && envFallback.startsWith('pk.') ? envFallback : undefined;
+}
+/**
+ * Reset the cached public token. For tests only.
+ */
+function __resetMapboxPublicTokenCache() {
+    cachedPublicToken = null;
+}
+//# sourceMappingURL=mapboxPublicToken.js.map

package/dist/commonjs/utils/mapboxPublicToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapboxPublicToken.js","sourceRoot":"","sources":["../../../src/utils/mapboxPublicToken.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;AAiClC,4DAsDC;AAKD,sEAEC;AA5FD,+CAAqD;AAcrD,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,KAAK;AACjD,IAAI,iBAAiB,GAAuB,IAAI,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,wBAAwB,CAAC,MAI9C;IACC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAEzD,IAAI,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,SAAS,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QAC3E,OAAO,iBAAiB,CAAC,KAAK,CAAC;IACjC,CAAC;IAED,IAAI,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAA,kCAAoB,EAAC,WAAW,CAAC,CAAC;QACnD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,WAAW,aAAa,QAAQ,EAAE,CAAC,CAAC;gBACjE,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC9C,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;gBAExD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACzD,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAChB,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAY,CAAC;oBAChD,MAAM,OAAO,GAAqB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;wBACnD,CAAC,CAAE,IAAyB;wBAC5B,CAAC,CAAC,CAAE,IAAsC,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;oBAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAC5B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CACpE,CAAC;oBACF,IAAI,SAAS,EAAE,KAAK,EAAE,CAAC;wBACrB,iBAAiB,GAAG;4BAClB,KAAK,EAAE,SAAS,CAAC,KAAK;4BACtB,SAAS,EAAE,GAAG,GAAG,mBAAmB;yBACrC,CAAC;wBACF,OAAO,SAAS,CAAC,KAAK,CAAC;oBACzB,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,sEAAsE;gBACtE,sEAAsE;gBACtE,iCAAiC;gBACjC,OAAO,CAAC,IAAI,CACV,kGAAkG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACrJ,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACpD,OAAO,WAAW,IAAI,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED;;GAEG;AACH,SAAgB,6BAA6B;IAC3C,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC"}