@mapbox/mcp-server 0.14.0 → 0.15.1

package/dist/commonjs/tools/place-details-tool/PlaceDetailsTool.js

@@ -6,10 +6,24 @@ exports.PlaceDetailsTool = void 0;
 const MapboxApiBasedTool_js_1 = require("../MapboxApiBasedTool.js");
 const PlaceDetailsTool_input_schema_js_1 = require("./PlaceDetailsTool.input.schema.js");
 const PlaceDetailsTool_output_schema_js_1 = require("./PlaceDetailsTool.output.schema.js");
-// API Documentation: https://docs.mapbox.com/api/search/details/
+// API Documentation: https://docs.mapbox.com/api/search/places/
+//
+// This calls the Places API's Details/Retrieve endpoint, not the older,
+// separate Details API (docs.mapbox.com/api/search/details/) this tool used
+// previously. The Places API is Public Preview: its default quota is 1,000
+// records/month per account and 100 records/sec, and its response contract
+// may change without notice.
+//
+// The Places API only covers POIs. It rejects boundary/administrative
+// mapbox_ids (neighborhoods, cities, regions) with a 422
+// "Invalid mapbox_id format" error — confirmed live against the API with a
+// city's mapbox_id from search_and_geocode_tool. Those IDs, and the
+// enhanced Japan data the legacy API alone provides, still need the legacy
+// Details API, so this tool falls back to it on that specific error rather
+// than losing that capability outright.
 class PlaceDetailsTool extends MapboxApiBasedTool_js_1.MapboxApiBasedTool {
     name = 'place_details_tool';
-    description = 'Retrieve detailed information about a specific place using its Mapbox ID. Use after search_and_geocode_tool, category_search_tool, or reverse_geocode_tool to get additional details such as photos, opening hours, ratings, phone numbers, and website URLs. Requires the mapbox_id field from a previous search result.';
+    description = 'Retrieve detailed information about a specific place using its Mapbox ID. Use after search_and_geocode_tool, category_search_tool, or reverse_geocode_tool to get additional details such as photos, opening hours, phone numbers, and website URLs. Requires the mapbox_id field from a previous search result. Primarily covers points of interest (businesses, addresses, buildings); mapbox_ids for neighborhoods, cities, or other administrative boundaries are also supported but return more limited data (name, address, coordinates — no photos, hours, or contact info). The primary POI lookup is Public Preview with a default quota of 1,000 requests/month; contact Mapbox if you need a higher volume.';
     annotations = {
         title: 'Place Details Tool',
         readOnlyHint: true,
@@ -24,145 +38,114 @@ class PlaceDetailsTool extends MapboxApiBasedTool_js_1.MapboxApiBasedTool {
             httpRequest: params.httpRequest
         });
     }
-    formatOpenHours(openHours) {
-        const DAY_NAMES = [
-            'Sunday',
-            'Monday',
-            'Tuesday',
-            'Wednesday',
-            'Thursday',
-            'Friday',
-            'Saturday'
-        ];
-        // Use weekday_text if the API provides it — already formatted per day
-        if (Array.isArray(openHours['weekday_text'])) {
-            const lines = openHours['weekday_text']
-                .map((line) => `  ${line}`)
-                .join('\n');
-            return `Hours:\n${lines}`;
-        }
-        // Fall back to parsing periods array
-        if (!Array.isArray(openHours['periods']))
+    /** `opening_hours` is an OSM opening_hours string, e.g. "Mo 09:00-23:45; Tu 09:00-23:45; ...". */
+    formatOpeningHours(openingHours) {
+        const parts = openingHours
+            .split(';')
+            .map((part) => part.trim())
+            .filter(Boolean);
+        if (parts.length === 0)
             return '';
-        const formatTime = (hhmm) => {
-            const h = parseInt(hhmm.slice(0, 2), 10);
-            const m = hhmm.slice(2);
-            const period = h < 12 ? 'AM' : 'PM';
-            const hour = h % 12 || 12;
-            return m === '00' ? `${hour} ${period}` : `${hour}:${m} ${period}`;
-        };
-        // Group periods by open day
-        const byDay = new Map();
-        for (const period of openHours['periods']) {
-            const day = period.open.day;
-            const open = formatTime(period.open.time);
-            const close = period.close ? formatTime(period.close.time) : 'midnight';
-            const range = `${open} – ${close}`;
-            const existing = byDay.get(day);
-            if (existing) {
-                existing.push(range);
-            }
-            else {
-                byDay.set(day, [range]);
-            }
-        }
-        const dayLines = DAY_NAMES.map((name, i) => {
-            const ranges = byDay.get(i);
-            return `  ${name}: ${ranges ? ranges.join(', ') : 'Closed'}`;
-        });
-        return `Hours:\n${dayLines.join('\n')}`;
+        const lines = parts.map((part) => `  ${part}`).join('\n');
+        return `Hours:\n${lines}`;
     }
     formatDetailsToText(data) {
-        const props = data.properties;
         const lines = [];
-        // Name
-        lines.push(`Name: ${props.name}`);
-        // Address
-        if (props.full_address) {
-            lines.push(`Address: ${props.full_address}`);
+        lines.push(`Name: ${data.name}`);
+        if (data.full_address) {
+            lines.push(`Address: ${data.full_address}`);
         }
-        else if (props.place_formatted) {
-            lines.push(`Address: ${props.place_formatted}`);
+        if (data.coordinates) {
+            lines.push(`Coordinates: ${data.coordinates.latitude}, ${data.coordinates.longitude}`);
         }
-        else if (props.address) {
-            lines.push(`Address: ${props.address}`);
+        if (data.primary_category) {
+            lines.push(`Type: ${data.primary_category}`);
         }
-        // Coordinates from geometry
-        if (data.geometry?.coordinates) {
-            const [lng, lat] = data.geometry.coordinates;
-            lines.push(`Coordinates: ${lat}, ${lng}`);
+        else if (data.feature_type) {
+            lines.push(`Type: ${data.feature_type}`);
         }
-        // Feature type and categories
-        if (props.feature_type) {
-            lines.push(`Type: ${props.feature_type}`);
+        if (data.categories && data.categories.length > 0) {
+            lines.push(`Category: ${data.categories.join(', ')}`);
         }
-        if (props.poi_category && props.poi_category.length > 0) {
-            lines.push(`Category: ${props.poi_category.join(', ')}`);
+        if (data.brand) {
+            lines.push(`Brand: ${data.brand}`);
         }
-        // Brand
-        if (props.brand && props.brand.length > 0) {
-            lines.push(`Brand: ${props.brand.join(', ')}`);
+        if (data.phone) {
+            lines.push(`Phone: ${data.phone}`);
         }
-        // Venue attributes (phone, website, social media)
-        const metadata = props.metadata;
-        if (metadata) {
-            if (metadata['phone']) {
-                lines.push(`Phone: ${metadata['phone']}`);
-            }
-            if (metadata['website']) {
-                lines.push(`Website: ${metadata['website']}`);
-            }
-            if (metadata['social_media'] &&
-                typeof metadata['social_media'] === 'object') {
-                const social = metadata['social_media'];
-                const socialLinks = Object.entries(social)
-                    .map(([k, v]) => `${k}: ${v}`)
-                    .join(', ');
-                if (socialLinks)
-                    lines.push(`Social: ${socialLinks}`);
-            }
-            // Visit attributes (hours, rating, price)
-            if (metadata['price']) {
-                lines.push(`Price: ${metadata['price']}`);
-            }
-            if (metadata['rating'] !== undefined) {
-                lines.push(`Rating: ${metadata['rating']}`);
-            }
-            if (metadata['review_count'] !== undefined) {
-                lines.push(`Reviews: ${metadata['review_count']}`);
-            }
-            if (metadata['popularity'] !== undefined) {
-                lines.push(`Popularity: ${Math.round(metadata['popularity'] * 100)}%`);
-            }
-            if (metadata['open_hours'] &&
-                typeof metadata['open_hours'] === 'object') {
-                const formatted = this.formatOpenHours(metadata['open_hours']);
-                if (formatted)
-                    lines.push(formatted);
-            }
-            // Photos
-            if (Array.isArray(metadata['primary_photo'])) {
-                const photos = metadata['primary_photo'];
-                const photoUrls = photos
-                    .map((p) => p['url'] || p['thumb_url'])
-                    .filter(Boolean);
-                if (photoUrls.length > 0) {
-                    lines.push(`Photos: ${photoUrls.join(', ')}`);
-                }
+        if (data.website) {
+            lines.push(`Website: ${data.website}`);
+        }
+        if (data.score?.popularity !== undefined &&
+            data.score?.popularity !== null) {
+            lines.push(`Popularity: ${Math.round(data.score.popularity * 100)}%`);
+        }
+        if (data.permanently_closed) {
+            lines.push('Status: Permanently closed');
+        }
+        if (data.opening_hours) {
+            const formatted = this.formatOpeningHours(data.opening_hours);
+            if (formatted)
+                lines.push(formatted);
+        }
+        if (data.photos && data.photos.length > 0) {
+            const urls = data.photos.map((photo) => photo.url).filter(Boolean);
+            if (urls.length > 0) {
+                lines.push(`Photos: ${urls.join(', ')}`);
             }
         }
         return lines.join('\n');
     }
-    async execute(input, accessToken, 
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    _context) {
+    errorResult(message) {
+        return {
+            content: [{ type: 'text', text: `Place Details API error: ${message}` }],
+            isError: true
+        };
+    }
+    successResult(data) {
+        return {
+            content: [{ type: 'text', text: this.formatDetailsToText(data) }],
+            structuredContent: data,
+            isError: false
+        };
+    }
+    /** Maps a legacy Details API `Feature` onto the flat Places API output shape. */
+    normalizeLegacyFeature(feature) {
+        const props = feature.properties;
+        const metadata = props.metadata;
+        return this.validateOutput({
+            mapbox_id: props.mapbox_id,
+            name: props.name,
+            full_address: props.full_address ?? props.place_formatted ?? props.address,
+            feature_type: props.feature_type,
+            coordinates: props.coordinates ??
+                (feature.geometry?.coordinates
+                    ? {
+                        longitude: feature.geometry.coordinates[0],
+                        latitude: feature.geometry.coordinates[1]
+                    }
+                    : undefined),
+            bbox: props.bbox,
+            context: props.context,
+            categories: props.poi_category,
+            brand: props.brand && props.brand.length > 0
+                ? props.brand.join(', ')
+                : undefined,
+            phone: metadata?.['phone'],
+            website: metadata?.['website'],
+            metadata
+        });
+    }
+    /**
+     * Calls the legacy Details API, the only way to resolve boundary/
+     * administrative mapbox_ids (and the source of enhanced Japan data).
+     */
+    async fetchLegacyDetails(input, accessToken) {
         const url = new URL(`${MapboxApiBasedTool_js_1.MapboxApiBasedTool.mapboxApiEndpoint}search/details/v1/retrieve/${encodeURIComponent(input.mapbox_id)}`);
         url.searchParams.append('access_token', accessToken);
-        // "basic" (name, feature_type, address, coordinates) is what the
-        // Details API calls its default attribute set, and this tool's output
-        // schema requires `properties.name`/`properties.feature_type` — so it
-        // must always be requested, even if the caller's attribute_sets omits
-        // it, or the API response fails output validation.
+        // "basic" (name, feature_type, address, coordinates) must always be
+        // requested — normalizeLegacyFeature() depends on those fields, even if
+        // the caller's attribute_sets omits it.
         const attributeSets = new Set(['basic', ...(input.attribute_sets ?? [])]);
         url.searchParams.append('attribute_sets', Array.from(attributeSets).join(','));
         if (input.language) {
@@ -173,24 +156,32 @@ class PlaceDetailsTool extends MapboxApiBasedTool_js_1.MapboxApiBasedTool {
         }
         const response = await this.httpRequest(url.toString());
         if (!response.ok) {
-            const errorMessage = await this.getErrorMessage(response);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Place Details API error: ${errorMessage}`
-                    }
-                ],
-                isError: true
-            };
+            return { ok: false, errorMessage: await this.getErrorMessage(response) };
         }
-        const rawData = await response.json();
-        const data = this.validateOutput(rawData);
-        return {
-            content: [{ type: 'text', text: this.formatDetailsToText(data) }],
-            structuredContent: data,
-            isError: false
-        };
+        const rawFeature = PlaceDetailsTool_output_schema_js_1.LegacyPlaceDetailsFeatureSchema.parse(await response.json());
+        return { ok: true, data: this.normalizeLegacyFeature(rawFeature) };
+    }
+    async execute(input, accessToken, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _context) {
+        const url = new URL(`${MapboxApiBasedTool_js_1.MapboxApiBasedTool.mapboxApiEndpoint}places/v1/details/retrieve/${encodeURIComponent(input.mapbox_id)}`);
+        url.searchParams.append('access_token', accessToken);
+        const response = await this.httpRequest(url.toString());
+        if (response.ok) {
+            const data = this.validateOutput(await response.json());
+            return this.successResult(data);
+        }
+        // The Places API rejects non-POI mapbox_ids (boundaries/neighborhoods/
+        // cities/regions) with 422 "Invalid mapbox_id format" — fall back to the
+        // legacy Details API, which still resolves those, instead of erroring.
+        if (response.status === 422) {
+            const legacyResult = await this.fetchLegacyDetails(input, accessToken);
+            if (legacyResult.ok) {
+                return this.successResult(legacyResult.data);
+            }
+            return this.errorResult(legacyResult.errorMessage);
+        }
+        return this.errorResult(await this.getErrorMessage(response));
     }
 }
 exports.PlaceDetailsTool = PlaceDetailsTool;

package/dist/commonjs/tools/place-details-tool/PlaceDetailsTool.js.map

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

package/dist/commonjs/tools/place-details-tool/PlaceDetailsTool.output.schema.d.ts

@@ -2,11 +2,77 @@ import { z } from 'zod';
 /**
  * Output schema for PlaceDetailsTool
  *
- * Models the GeoJSON Feature returned by the Mapbox Details API.
- * Uses passthrough() to allow additional fields from optional attribute_sets
- * (photos, visit, venue) to pass through without validation errors.
+ * Models the flat Place record returned by the Mapbox Places API's Details
+ * endpoint (`places/v1/details/retrieve`), currently in Public Preview.
+ * Nearly every field beyond `mapbox_id`/`name` is optional and every nested
+ * object uses .passthrough() — live responses observed during development
+ * varied in which fields were present (e.g. `building` and `opening_hours`
+ * only appear on some places), and a Public Preview API's contract can add
+ * fields without notice, so this schema is deliberately permissive rather
+ * than risk an output-validation failure like the one fixed for the
+ * previous Details API (see CHANGELOG).
+ *
+ * `feature_type`, `bbox`, `context`, and `metadata` are never populated by
+ * the Places API itself — they're only present when `mapbox_id` resolved via
+ * the legacy Details API fallback (boundaries/neighborhoods/cities/regions,
+ * which the Places API rejects). See `PlaceDetailsTool.ts`'s
+ * `normalizeLegacyFeature`.
  */
 export declare const PlaceDetailsOutputSchema: z.ZodObject<{
+    mapbox_id: z.ZodString;
+    name: z.ZodString;
+    full_address: z.ZodOptional<z.ZodString>;
+    brand: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    primary_category: z.ZodOptional<z.ZodString>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    feature_type: z.ZodOptional<z.ZodString>;
+    bbox: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    context: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    metadata: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    opening_hours: z.ZodOptional<z.ZodString>;
+    permanently_closed: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    phone: z.ZodOptional<z.ZodString>;
+    website: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    updated_at: z.ZodOptional<z.ZodString>;
+    score: z.ZodOptional<z.ZodObject<{
+        closed: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        reality: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        popularity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>;
+    coordinates: z.ZodOptional<z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        source: z.ZodOptional<z.ZodString>;
+        routable_points: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            latitude: z.ZodNumber;
+            longitude: z.ZodNumber;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+    address: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+    building: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    photos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    telemetry: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$loose>;
+/**
+ * Type inference for PlaceDetailsOutput
+ */
+export type PlaceDetailsOutput = z.infer<typeof PlaceDetailsOutputSchema>;
+/**
+ * Raw GeoJSON `Feature` returned by the legacy Details API
+ * (`search/details/v1/retrieve`). Only used for the fallback path — see
+ * `PlaceDetailsTool.ts`'s `normalizeLegacyFeature`, which maps this into
+ * `PlaceDetailsOutput`.
+ */
+export declare const LegacyPlaceDetailsFeatureSchema: z.ZodObject<{
     type: z.ZodLiteral<"Feature">;
     geometry: z.ZodObject<{
         type: z.ZodLiteral<"Point">;
@@ -25,18 +91,13 @@ export declare const PlaceDetailsOutputSchema: z.ZodObject<{
             latitude: z.ZodNumber;
         }, z.core.$loose>>;
         bbox: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
-        language: z.ZodOptional<z.ZodString>;
-        maki: z.ZodOptional<z.ZodString>;
         poi_category: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        poi_category_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
         brand: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        brand_id: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        external_ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         metadata: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
     }, z.core.$loose>;
 }, z.core.$loose>;
 /**
- * Type inference for PlaceDetailsOutput
+ * Type inference for LegacyPlaceDetailsFeature
  */
-export type PlaceDetailsOutput = z.infer<typeof PlaceDetailsOutputSchema>;
+export type LegacyPlaceDetailsFeature = z.infer<typeof LegacyPlaceDetailsFeatureSchema>;
 //# sourceMappingURL=PlaceDetailsTool.output.schema.d.ts.map

package/dist/commonjs/tools/place-details-tool/PlaceDetailsTool.output.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlaceDetailsTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/place-details-tool/PlaceDetailsTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwCrB,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"PlaceDetailsTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/place-details-tool/PlaceDetailsTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmErB,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;iBAkC5B,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC"}

package/dist/commonjs/tools/place-details-tool/PlaceDetailsTool.output.schema.js

@@ -2,16 +2,98 @@
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlaceDetailsOutputSchema = void 0;
+exports.LegacyPlaceDetailsFeatureSchema = exports.PlaceDetailsOutputSchema = void 0;
 const zod_1 = require("zod");
 /**
  * Output schema for PlaceDetailsTool
  *
- * Models the GeoJSON Feature returned by the Mapbox Details API.
- * Uses passthrough() to allow additional fields from optional attribute_sets
- * (photos, visit, venue) to pass through without validation errors.
+ * Models the flat Place record returned by the Mapbox Places API's Details
+ * endpoint (`places/v1/details/retrieve`), currently in Public Preview.
+ * Nearly every field beyond `mapbox_id`/`name` is optional and every nested
+ * object uses .passthrough() — live responses observed during development
+ * varied in which fields were present (e.g. `building` and `opening_hours`
+ * only appear on some places), and a Public Preview API's contract can add
+ * fields without notice, so this schema is deliberately permissive rather
+ * than risk an output-validation failure like the one fixed for the
+ * previous Details API (see CHANGELOG).
+ *
+ * `feature_type`, `bbox`, `context`, and `metadata` are never populated by
+ * the Places API itself — they're only present when `mapbox_id` resolved via
+ * the legacy Details API fallback (boundaries/neighborhoods/cities/regions,
+ * which the Places API rejects). See `PlaceDetailsTool.ts`'s
+ * `normalizeLegacyFeature`.
  */
 exports.PlaceDetailsOutputSchema = zod_1.z
+    .object({
+    mapbox_id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    full_address: zod_1.z.string().optional(),
+    brand: zod_1.z.string().nullable().optional(),
+    primary_category: zod_1.z.string().optional(),
+    categories: zod_1.z.array(zod_1.z.string()).optional(),
+    // Legacy Details API fallback only (see doc comment above).
+    feature_type: zod_1.z.string().optional(),
+    bbox: zod_1.z.tuple([zod_1.z.number(), zod_1.z.number(), zod_1.z.number(), zod_1.z.number()]).optional(),
+    context: zod_1.z.object({}).passthrough().optional(),
+    metadata: zod_1.z.object({}).passthrough().optional(),
+    // OSM opening_hours syntax, e.g. "Mo 09:00-23:45; Tu 09:00-23:45; ...".
+    opening_hours: zod_1.z.string().optional(),
+    permanently_closed: zod_1.z.boolean().nullable().optional(),
+    phone: zod_1.z.string().optional(),
+    website: zod_1.z.string().optional(),
+    status: zod_1.z.string().optional(),
+    created_at: zod_1.z.string().optional(),
+    updated_at: zod_1.z.string().optional(),
+    score: zod_1.z
+        .object({
+        closed: zod_1.z.number().nullable().optional(),
+        reality: zod_1.z.number().nullable().optional(),
+        popularity: zod_1.z.number().nullable().optional()
+    })
+        .passthrough()
+        .optional(),
+    coordinates: zod_1.z
+        .object({
+        latitude: zod_1.z.number(),
+        longitude: zod_1.z.number(),
+        source: zod_1.z.string().optional(),
+        routable_points: zod_1.z
+            .array(zod_1.z
+            .object({
+            name: zod_1.z.string().optional(),
+            latitude: zod_1.z.number(),
+            longitude: zod_1.z.number()
+        })
+            .passthrough())
+            .optional()
+    })
+        .passthrough()
+        .optional(),
+    address: zod_1.z.object({}).passthrough().optional(),
+    attributes: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.union([zod_1.z.string(), zod_1.z.boolean(), zod_1.z.number()]))
+        .optional(),
+    building: zod_1.z.object({}).passthrough().optional(),
+    photos: zod_1.z
+        .array(zod_1.z
+        .object({
+        url: zod_1.z.string(),
+        width: zod_1.z.number().nullable().optional(),
+        height: zod_1.z.number().nullable().optional(),
+        source: zod_1.z.string().optional()
+    })
+        .passthrough())
+        .optional(),
+    telemetry: zod_1.z.object({}).passthrough().optional()
+})
+    .passthrough();
+/**
+ * Raw GeoJSON `Feature` returned by the legacy Details API
+ * (`search/details/v1/retrieve`). Only used for the fallback path — see
+ * `PlaceDetailsTool.ts`'s `normalizeLegacyFeature`, which maps this into
+ * `PlaceDetailsOutput`.
+ */
+exports.LegacyPlaceDetailsFeatureSchema = zod_1.z
     .object({
     type: zod_1.z.literal('Feature'),
     geometry: zod_1.z
@@ -39,14 +121,8 @@ exports.PlaceDetailsOutputSchema = zod_1.z
         bbox: zod_1.z
             .tuple([zod_1.z.number(), zod_1.z.number(), zod_1.z.number(), zod_1.z.number()])
             .optional(),
-        language: zod_1.z.string().optional(),
-        maki: zod_1.z.string().optional(),
         poi_category: zod_1.z.array(zod_1.z.string()).optional(),
-        poi_category_ids: zod_1.z.array(zod_1.z.string()).optional(),
         brand: zod_1.z.array(zod_1.z.string()).optional(),
-        brand_id: zod_1.z.array(zod_1.z.string()).optional(),
-        external_ids: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
-        // metadata contains attribute_set fields (photos, visit, venue)
         metadata: zod_1.z.object({}).passthrough().optional()
     })
         .passthrough()

package/dist/commonjs/tools/place-details-tool/PlaceDetailsTool.output.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlaceDetailsTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/place-details-tool/PlaceDetailsTool.output.schema.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,6BAAwB;AAExB;;;;;;GAMG;AACU,QAAA,wBAAwB,GAAG,OAAC;KACtC,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,OAAC;SACR,MAAM,CAAC;QACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC;KAC/C,CAAC;SACD,WAAW,EAAE;IAChB,UAAU,EAAE,OAAC;SACV,MAAM,CAAC;QACN,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;QAChB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;QACrB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACtC,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;QAC9C,WAAW,EAAE,OAAC;aACX,MAAM,CAAC;YACN,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;YACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;SACrB,CAAC;aACD,WAAW,EAAE;aACb,QAAQ,EAAE;QACb,IAAI,EAAE,OAAC;aACJ,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC;aACvD,QAAQ,EAAE;QACb,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC5C,gBAAgB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QAChD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACrC,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACxC,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACzD,gEAAgE;QAChE,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;KAChD,CAAC;SACD,WAAW,EAAE;CACjB,CAAC;KACD,WAAW,EAAE,CAAC"}
+{"version":3,"file":"PlaceDetailsTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/place-details-tool/PlaceDetailsTool.output.schema.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/tools/render-map-tool/RenderMapTool.d.ts

@@ -1,5 +1,6 @@
 import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import { BaseTool } from '../BaseTool.js';
+import { type MapAppCsp } from '../../resources/ui-apps/mapAppCsp.js';
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { RenderMapInputSchema, type RenderMapInput } from './RenderMapTool.input.schema.js';
 import { RenderMapOutputSchema } from './RenderMapTool.output.schema.js';
@@ -33,10 +34,7 @@ export declare class RenderMapTool extends BaseTool<typeof RenderMapInputSchema,
     readonly meta: {
         ui: {
             resourceUri: string;
-            csp: {
-                connectDomains: string[];
-                resourceDomains: string[];
-            };
+            csp: MapAppCsp;
         };
     };
     private readonly httpRequest;