@mapbox/mcp-server 0.13.0 → 0.15.0

package/dist/esm/tools/ground-location-tool/GroundLocationTool.output.schema.js

@@ -7,7 +7,15 @@ export const PoiSchema = z.object({
     longitude: z.number(),
     latitude: z.number(),
     category: z.string().optional(),
-    distance_meters: z.number().optional()
+    distance_meters: z.number().optional(),
+    mapbox_id: z
+        .string()
+        .optional()
+        .describe('Mapbox id for this place. Pass it to place_details_tool to retrieve ratings, popularity, opening hours, and phone number.'),
+    external_ids: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe('Upstream supplier ids for this place, keyed by supplier (e.g. dataplor, tripadvisor). Use to attribute where the record came from.')
 });
 export const IsochroneSummarySchema = z.object({
     profile: z.string(),

package/dist/esm/tools/ground-location-tool/GroundLocationTool.output.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"GroundLocationTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/ground-location-tool/GroundLocationTool.output.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACzE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,SAAS,CAAC;SAChB,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACnD,kCAAkC,CACnC;IACD,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CAAC,oDAAoD,CAAC;IACjE,YAAY,EAAE,eAAe,CAAC,QAAQ,EAAE;CACzC,CAAC;KACD,WAAW,EAAE,CAAC"}
+{"version":3,"file":"GroundLocationTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/ground-location-tool/GroundLocationTool.output.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,2HAA2H,CAC5H;IACH,YAAY,EAAE,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,QAAQ,EAAE;SACV,QAAQ,CACP,oIAAoI,CACrI;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACzE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,SAAS,CAAC;SAChB,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACnD,kCAAkC,CACnC;IACD,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CAAC,oDAAoD,CAAC;IACjE,YAAY,EAAE,eAAe,CAAC,QAAQ,EAAE;CACzC,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/esm/tools/isochrone-tool/IsochroneTool.js

@@ -8,7 +8,7 @@ import { IsochroneResponseSchema } from './IsochroneTool.output.schema.js';
 import { temporaryResourceManager } from '../../utils/temporaryResourceManager.js';
 import { renderHint } from '../../utils/storeMapPayload.js';
 import { buildSelfFetchRef } from '../../utils/selfFetchRef.js';
-import { getUserNameFromToken } from '../../utils/jwtUtils.js';
+import { getOwnerKeyFromToken } from '../../utils/jwtUtils.js';
 export class IsochroneTool extends MapboxApiBasedTool {
     name = 'isochrone_tool';
     description = `Computes areas that are reachable within a specified amount of time from a location, and returns the reachable regions as contours of Polygons or LineStrings in GeoJSON format that you can display on a map.
@@ -124,7 +124,7 @@ export class IsochroneTool extends MapboxApiBasedTool {
                 uri: resourceUri,
                 data,
                 metadata: { toolName: this.name, size: responseSize },
-                owner: getUserNameFromToken(accessToken)
+                owner: getOwnerKeyFromToken(accessToken)
             });
             const contourCount = data.features?.length ?? 0;
             const summaryText = `Isochrone computed: ${contourCount} contour${contourCount !== 1 ? 's' : ''}\n\n⚠️ Full response (${Math.round(responseSize / 1024)}KB) exceeds context limit.\n\nFull GeoJSON stored as temporary resource.\nResource URI: ${resourceUri}\nTTL: 30 minutes\n\nUse the MCP resource API to retrieve full GeoJSON if needed.`;

package/dist/esm/tools/place-details-tool/PlaceDetailsTool.d.ts

@@ -18,8 +18,18 @@ export declare class PlaceDetailsTool extends MapboxApiBasedTool<typeof PlaceDet
     constructor(params: {
         httpRequest: HttpRequest;
     });
-    private formatOpenHours;
+    /** `opening_hours` is an OSM opening_hours string, e.g. "Mo 09:00-23:45; Tu 09:00-23:45; ...". */
+    private formatOpeningHours;
     private formatDetailsToText;
+    private errorResult;
+    private successResult;
+    /** Maps a legacy Details API `Feature` onto the flat Places API output shape. */
+    private normalizeLegacyFeature;
+    /**
+     * Calls the legacy Details API, the only way to resolve boundary/
+     * administrative mapbox_ids (and the source of enhanced Japan data).
+     */
+    private fetchLegacyDetails;
     protected execute(input: z.infer<typeof PlaceDetailsInputSchema>, accessToken: string, _context: ToolExecutionContext): Promise<CallToolResult>;
 }
 //# sourceMappingURL=PlaceDetailsTool.d.ts.map

package/dist/esm/tools/place-details-tool/PlaceDetailsTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlaceDetailsTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/place-details-tool/PlaceDetailsTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EACL,wBAAwB,EAEzB,MAAM,qCAAqC,CAAC;AAI7C,qBAAa,gBAAiB,SAAQ,kBAAkB,CACtD,OAAO,uBAAuB,EAC9B,OAAO,wBAAwB,CAChC;IACC,IAAI,SAAwB;IAC5B,WAAW,SACmT;IAC9T,WAAW;;;;;;MAMT;gBAEU,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAQhD,OAAO,CAAC,eAAe;IA0DvB,OAAO,CAAC,mBAAmB;cAiGX,OAAO,CACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,EAC9C,WAAW,EAAE,MAAM,EAEnB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC;CA2C3B"}
+{"version":3,"file":"PlaceDetailsTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/place-details-tool/PlaceDetailsTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EACL,wBAAwB,EAIzB,MAAM,qCAAqC,CAAC;AAkB7C,qBAAa,gBAAiB,SAAQ,kBAAkB,CACtD,OAAO,uBAAuB,EAC9B,OAAO,wBAAwB,CAChC;IACC,IAAI,SAAwB;IAC5B,WAAW,SACgrB;IAC3rB,WAAW;;;;;;MAMT;gBAEU,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAQhD,kGAAkG;IAClG,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,mBAAmB;IA6D3B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,aAAa;IAQrB,iFAAiF;IACjF,OAAO,CAAC,sBAAsB;IAiC9B;;;OAGG;YACW,kBAAkB;cAqChB,OAAO,CACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,EAC9C,WAAW,EAAE,MAAM,EAEnB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC;CA4B3B"}

package/dist/esm/tools/place-details-tool/PlaceDetailsTool.input.schema.js

@@ -11,14 +11,14 @@ export const PlaceDetailsInputSchema = z.object({
     attribute_sets: z
         .array(z.enum(['basic', 'photos', 'visit', 'venue']))
         .optional()
-        .describe('Which attribute sets to include in the response. Options: "basic" (address/coordinates, always included), "photos" (place photo URLs), "visit" (opening hours, rating, price level, popularity), "venue" (phone number, website URL, social media links). When not specified, only basic attributes are returned.'),
+        .describe('Only used when mapbox_id resolves via the legacy Details API fallback (boundaries, neighborhoods, cities, regions — see mapbox_id\'s description). Which attribute sets to include in that response. Options: "basic" (name/address/coordinates — always requested regardless of whether you list it here), "photos" (place photo URLs), "visit" (opening hours, rating, price level, popularity), "venue" (phone number, website URL, social media links). Ignored for POI lookups, which go through the Places API and have no equivalent parameter.'),
     language: z
         .string()
         .optional()
-        .describe('BCP 47 language tag for localized results (e.g. "en", "fr", "de", "ja"). Affects place names and address formatting.'),
+        .describe('Only used when mapbox_id resolves via the legacy Details API fallback (see attribute_sets). BCP 47 language tag for localized results (e.g. "en", "fr", "de", "ja"). Affects place names and address formatting. Ignored for POI lookups.'),
     worldview: z
         .enum(['ar', 'cn', 'in', 'jp', 'ma', 'ru', 'tr', 'us'])
         .optional()
-        .describe('Worldview for geopolitically sensitive content such as disputed borders. Options: "ar" (Argentina), "cn" (China), "in" (India), "jp" (Japan), "ma" (Morocco), "ru" (Russia), "tr" (Turkey), "us" (United States, default).')
+        .describe('Only used when mapbox_id resolves via the legacy Details API fallback (see attribute_sets). Worldview for geopolitically sensitive content such as disputed borders. Options: "ar" (Argentina), "cn" (China), "in" (India), "jp" (Japan), "ma" (Morocco), "ru" (Russia), "tr" (Turkey), "us" (United States, default). Ignored for POI lookups.')
 });
 //# sourceMappingURL=PlaceDetailsTool.input.schema.js.map

package/dist/esm/tools/place-details-tool/PlaceDetailsTool.input.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlaceDetailsTool.input.schema.js","sourceRoot":"","sources":["../../../../src/tools/place-details-tool/PlaceDetailsTool.input.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CACP,0MAA0M,CAC3M;IACH,cAAc,EAAE,CAAC;SACd,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;SACpD,QAAQ,EAAE;SACV,QAAQ,CACP,mTAAmT,CACpT;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sHAAsH,CACvH;IACH,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;SACtD,QAAQ,EAAE;SACV,QAAQ,CACP,4NAA4N,CAC7N;CACJ,CAAC,CAAC"}
+{"version":3,"file":"PlaceDetailsTool.input.schema.js","sourceRoot":"","sources":["../../../../src/tools/place-details-tool/PlaceDetailsTool.input.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CACP,0MAA0M,CAC3M;IACH,cAAc,EAAE,CAAC;SACd,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;SACpD,QAAQ,EAAE;SACV,QAAQ,CACP,whBAAwhB,CACzhB;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,2OAA2O,CAC5O;IACH,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;SACtD,QAAQ,EAAE;SACV,QAAQ,CACP,iVAAiV,CAClV;CACJ,CAAC,CAAC"}

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

@@ -2,11 +2,25 @@
 // Licensed under the MIT License.
 import { MapboxApiBasedTool } from '../MapboxApiBasedTool.js';
 import { PlaceDetailsInputSchema } from './PlaceDetailsTool.input.schema.js';
-import { PlaceDetailsOutputSchema } from './PlaceDetailsTool.output.schema.js';
-// API Documentation: https://docs.mapbox.com/api/search/details/
+import { PlaceDetailsOutputSchema, LegacyPlaceDetailsFeatureSchema } from './PlaceDetailsTool.output.schema.js';
+// 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.
 export class PlaceDetailsTool extends 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,
@@ -21,143 +35,116 @@ export class PlaceDetailsTool extends 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.mapboxApiEndpoint}search/details/v1/retrieve/${encodeURIComponent(input.mapbox_id)}`);
         url.searchParams.append('access_token', accessToken);
-        if (input.attribute_sets && input.attribute_sets.length > 0) {
-            url.searchParams.append('attribute_sets', input.attribute_sets.join(','));
-        }
+        // "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) {
             url.searchParams.append('language', input.language);
         }
@@ -166,24 +153,32 @@ export class PlaceDetailsTool extends 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 = 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.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));
     }
 }
 //# sourceMappingURL=PlaceDetailsTool.js.map

package/dist/esm/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":"AAAA,6BAA6B;AAC7B,kCAAkC;AAGlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAI9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EACL,wBAAwB,EAEzB,MAAM,qCAAqC,CAAC;AAE7C,iEAAiE;AAEjE,MAAM,OAAO,gBAAiB,SAAQ,kBAGrC;IACC,IAAI,GAAG,oBAAoB,CAAC;IAC5B,WAAW,GACT,2TAA2T,CAAC;IAC9T,WAAW,GAAG;QACZ,KAAK,EAAE,oBAAoB;QAC3B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB,CAAC;IAEF,YAAY,MAAoC;QAC9C,KAAK,CAAC;YACJ,WAAW,EAAE,uBAAuB;YACpC,YAAY,EAAE,wBAAwB;YACtC,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC,CAAC;IACL,CAAC;IAEO,eAAe,CAAC,SAAkC;QACxD,MAAM,SAAS,GAAG;YAChB,QAAQ;YACR,QAAQ;YACR,SAAS;YACT,WAAW;YACX,UAAU;YACV,QAAQ;YACR,UAAU;SACX,CAAC;QAEF,sEAAsE;QACtE,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAI,SAAS,CAAC,cAAc,CAAc;iBAClD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;iBAC1B,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,WAAW,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,qCAAqC;QACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAOpD,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;YAC1C,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACpC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;QACrE,CAAC,CAAC;QAEF,4BAA4B;QAC5B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC1C,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,SAAS,CAAa,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;YAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YACxE,MAAM,KAAK,GAAG,GAAG,IAAI,MAAM,KAAK,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACzC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5B,OAAO,KAAK,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC1C,CAAC;IAEO,mBAAmB,CAAC,IAAwB;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,OAAO;QACP,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAElC,UAAU;QACV,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/C,CAAC;aAAM,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,4BAA4B;QAC5B,IAAI,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,8BAA8B;QAC9B,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,QAAQ;QACR,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,kDAAkD;QAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAA+C,CAAC;QACvE,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,UAAU,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,IACE,QAAQ,CAAC,cAAc,CAAC;gBACxB,OAAO,QAAQ,CAAC,cAAc,CAAC,KAAK,QAAQ,EAC5C,CAAC;gBACD,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAA2B,CAAC;gBAClE,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;qBACvC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;qBAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,IAAI,WAAW;oBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,WAAW,EAAE,CAAC,CAAC;YACxD,CAAC;YAED,0CAA0C;YAC1C,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,UAAU,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,IAAI,QAAQ,CAAC,cAAc,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,IAAI,QAAQ,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,CAAC;gBACzC,KAAK,CAAC,IAAI,CACR,eAAe,IAAI,CAAC,KAAK,CAAE,QAAQ,CAAC,YAAY,CAAY,GAAG,GAAG,CAAC,GAAG,CACvE,CAAC;YACJ,CAAC;YACD,IACE,QAAQ,CAAC,YAAY,CAAC;gBACtB,OAAO,QAAQ,CAAC,YAAY,CAAC,KAAK,QAAQ,EAC1C,CAAC;gBACD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CACpC,QAAQ,CAAC,YAAY,CAA4B,CAClD,CAAC;gBACF,IAAI,SAAS;oBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC;YAED,SAAS;YACT,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;gBAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,CAEtC,CAAC;gBACF,MAAM,SAAS,GAAG,MAAM;qBACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC;qBACtC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACnB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,KAAK,CAAC,IAAI,CAAC,WAAW,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAES,KAAK,CAAC,OAAO,CACrB,KAA8C,EAC9C,WAAmB;IACnB,6DAA6D;IAC7D,QAA8B;QAE9B,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,GAAG,kBAAkB,CAAC,iBAAiB,8BAA8B,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAC3G,CAAC;QAEF,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAErD,IAAI,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAExD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC1D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,4BAA4B,YAAY,EAAE;qBACjD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAqB,OAAO,CAAC,CAAC;QAE9D,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YACjE,iBAAiB,EAAE,IAA0C;YAC7D,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"PlaceDetailsTool.js","sourceRoot":"","sources":["../../../../src/tools/place-details-tool/PlaceDetailsTool.ts"],"names":[],"mappings":"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"}

package/dist/esm/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/esm/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"}