@haivx/tripmind-maps-mcp 0.3.0

package/build/tools/geocode.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { cache } from "../utils/cache.js";
+import { geocode as googleGeocode } from "../utils/google-client.js";
+const TTL_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+export const toolName = "maps_geocode";
+/** Input schema shape for the maps_geocode tool. */
+export const inputSchema = {
+    address: z
+        .string()
+        .optional()
+        .describe("Address or landmark to geocode, e.g. 'Tokyo Tower' or '1-1 Marunouchi, Tokyo'"),
+    latitude: z
+        .number()
+        .optional()
+        .describe("Latitude for reverse geocoding"),
+    longitude: z
+        .number()
+        .optional()
+        .describe("Longitude for reverse geocoding"),
+    language: z
+        .string()
+        .optional()
+        .describe("Response language code, e.g. 'en', 'ja', 'vi'. Default: 'en'"),
+};
+/** Tool registration config for McpServer.registerTool(). */
+export const toolConfig = {
+    title: "Geocode Address",
+    description: "Convert an address or landmark name to GPS coordinates (forward geocoding), or convert coordinates to an address (reverse geocoding). Use this for placing pins on maps or finding where a place is located.",
+    inputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+    },
+};
+/**
+ * Handler for the maps_geocode tool.
+ * Validates that either `address` or both `latitude`+`longitude` are provided,
+ * checks the cache, calls Google Geocoding API on miss, and caches the result.
+ */
+export async function handler(args) {
+    try {
+        const hasAddress = Boolean(args.address);
+        const hasLatLng = args.latitude !== undefined && args.longitude !== undefined;
+        if (!hasAddress && !hasLatLng) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "Provide either `address` for forward geocoding, or both `latitude` and `longitude` for reverse geocoding.",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const cacheKey = hasLatLng
+            ? `geocode:latlng:${args.latitude},${args.longitude}:${args.language ?? "en"}`
+            : `geocode:address:${(args.address ?? "").toLowerCase().trim()}:${args.language ?? "en"}`;
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return {
+                content: [{ type: "text", text: JSON.stringify(cached) }],
+            };
+        }
+        const results = await googleGeocode({
+            address: args.address,
+            latlng: hasLatLng
+                ? { lat: args.latitude, lng: args.longitude }
+                : undefined,
+            language: args.language,
+        });
+        cache.set(cacheKey, results, TTL_MS);
+        return {
+            content: [{ type: "text", text: JSON.stringify(results) }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`[maps_geocode] error: ${message}`);
+        return {
+            content: [
+                { type: "text", text: JSON.stringify({ error: message }) },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=geocode.js.map

package/build/tools/geocode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geocode.js","sourceRoot":"","sources":["../../src/tools/geocode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGrE,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,UAAU;AAEnD,MAAM,CAAC,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEvC,oDAAoD;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+EAA+E,CAChF;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,8MAA8M;IAChN,WAAW;IACX,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,IAAI;KACpB;CACF,CAAC;AASF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,SAAS,GACb,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC;QAE9D,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EACH,2GAA2G;yBAC9G,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS;YACxB,CAAC,CAAC,kBAAkB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE;YAC9E,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;QAE5F,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAkB,QAAQ,CAAC,CAAC;QACpD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC;YAClC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EACJ,SAAS;gBACP,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,QAAS,EAAE,GAAG,EAAE,IAAI,CAAC,SAAU,EAAE;gBAC/C,CAAC,CAAC,SAAS;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QAEH,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAErC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;QAClD,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE;aACpE;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/build/tools/place-details.d.ts

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export declare const toolName = "maps_place_details";
+export declare const inputSchema: {
+    place_id: z.ZodString;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    language: z.ZodOptional<z.ZodString>;
+};
+export declare const toolConfig: {
+    title: string;
+    description: string;
+    inputSchema: {
+        place_id: z.ZodString;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        language: z.ZodOptional<z.ZodString>;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+type PlaceDetailsArgs = {
+    place_id: string;
+    fields?: string[];
+    language?: string;
+};
+export declare function handler(args: PlaceDetailsArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export {};
+//# sourceMappingURL=place-details.d.ts.map

package/build/tools/place-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place-details.d.ts","sourceRoot":"","sources":["../../src/tools/place-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,QAAQ,uBAAuB,CAAC;AAE7C,eAAO,MAAM,WAAW;;;;CASvB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAUtB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE,gBAAgB;;;;;;;;;;;;GA2BnD"}

package/build/tools/place-details.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { cache } from "../utils/cache.js";
+import { placeDetails as googlePlaceDetails } from "../utils/google-client.js";
+const TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+// Map user-friendly field names to Google API field names
+const FIELD_ALIASES = {
+    address: "formatted_address",
+    phone: "international_phone_number",
+    hours: "opening_hours",
+    location: "geometry",
+};
+export const toolName = "maps_place_details";
+export const inputSchema = {
+    place_id: z.string().describe("Google Place ID from a previous search result"),
+    fields: z
+        .array(z.string())
+        .optional()
+        .describe("Specific fields to return. Fewer fields = lower API cost. Available: name, address, phone, website, rating, hours, reviews"),
+    language: z.string().optional().describe("Response language code. Default: 'en'"),
+};
+export const toolConfig = {
+    title: "Place Details",
+    description: "Get detailed information about a specific place using its Google Place ID. Returns opening hours, phone number, website, reviews, and ratings. Use this after search to get more info about a place the user is interested in.",
+    inputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+    },
+};
+export async function handler(args) {
+    try {
+        const resolvedFields = args.fields?.map((f) => FIELD_ALIASES[f] ?? f);
+        const fieldsKey = (resolvedFields ?? []).sort().join(",");
+        const cacheKey = `place-details:${args.place_id}:${fieldsKey}:${args.language ?? "en"}`;
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: JSON.stringify(cached) }] };
+        }
+        const result = await googlePlaceDetails({
+            place_id: args.place_id,
+            fields: resolvedFields,
+            language: args.language,
+        });
+        cache.set(cacheKey, result, TTL_MS);
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`[maps_place_details] error: ${message}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=place-details.js.map

package/build/tools/place-details.js.map

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

package/build/tools/search-places.d.ts

@@ -0,0 +1,50 @@
+import { z } from "zod";
+export declare const toolName = "maps_search_places";
+export declare const inputSchema: {
+    query: z.ZodString;
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    radius: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+};
+export declare const toolConfig: {
+    title: string;
+    description: string;
+    inputSchema: {
+        query: z.ZodString;
+        latitude: z.ZodOptional<z.ZodNumber>;
+        longitude: z.ZodOptional<z.ZodNumber>;
+        radius: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+type SearchPlacesArgs = {
+    query: string;
+    latitude?: number;
+    longitude?: number;
+    radius?: number;
+    type?: string;
+    language?: string;
+};
+export declare function handler(args: SearchPlacesArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export {};
+//# sourceMappingURL=search-places.d.ts.map

package/build/tools/search-places.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-places.d.ts","sourceRoot":"","sources":["../../src/tools/search-places.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,QAAQ,uBAAuB,CAAC;AAE7C,eAAO,MAAM,WAAW;;;;;;;CAavB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;CAUtB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE,gBAAgB;;;;;;;;;;;;GA4BnD"}

package/build/tools/search-places.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { cache } from "../utils/cache.js";
+import { searchPlaces as googleSearchPlaces } from "../utils/google-client.js";
+const TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+export const toolName = "maps_search_places";
+export const inputSchema = {
+    query: z.string().describe("What to search for, e.g. 'sushi restaurants in Ginza'"),
+    latitude: z.number().optional().describe("Latitude to bias results near a location"),
+    longitude: z.number().optional().describe("Longitude to bias results near a location"),
+    radius: z
+        .number()
+        .optional()
+        .describe("Search radius in meters, max 50000. Default: 5000"),
+    type: z
+        .string()
+        .optional()
+        .describe("Place type filter: restaurant, hotel, cafe, tourist_attraction, etc."),
+    language: z.string().optional().describe("Response language code. Default: 'en'"),
+};
+export const toolConfig = {
+    title: "Search Places",
+    description: "Search for places by text query like 'ramen restaurants in Shinjuku' or 'coffee shops near Tokyo Tower'. Returns place names, addresses, ratings, and IDs. Use this when the user asks for recommendations or wants to find places.",
+    inputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+    },
+};
+export async function handler(args) {
+    try {
+        const hasLocation = args.latitude !== undefined && args.longitude !== undefined;
+        const cacheKey = `search:${args.query.toLowerCase().trim()}:${args.latitude ?? ""}:${args.longitude ?? ""}:${args.radius ?? ""}:${args.type ?? ""}:${args.language ?? "en"}`;
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: JSON.stringify(cached) }] };
+        }
+        const results = await googleSearchPlaces({
+            query: args.query,
+            location: hasLocation ? { lat: args.latitude, lng: args.longitude } : undefined,
+            radius: args.radius,
+            type: args.type,
+            language: args.language,
+        });
+        cache.set(cacheKey, results, TTL_MS);
+        return { content: [{ type: "text", text: JSON.stringify(results) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`[maps_search_places] error: ${message}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=search-places.js.map

package/build/tools/search-places.js.map

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

package/build/tools/timezone.d.ts

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export declare const toolName = "maps_timezone";
+export declare const inputSchema: {
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+};
+export declare const toolConfig: {
+    title: string;
+    description: string;
+    inputSchema: {
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        timestamp: z.ZodOptional<z.ZodNumber>;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+type TimezoneArgs = {
+    latitude: number;
+    longitude: number;
+    timestamp?: number;
+};
+export declare function handler(args: TimezoneArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export {};
+//# sourceMappingURL=timezone.d.ts.map

package/build/tools/timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/tools/timezone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,QAAQ,kBAAkB,CAAC;AAExC,eAAO,MAAM,WAAW;;;;CASvB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAUtB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE,YAAY;;;;;;;;;;;;GAwB/C"}

package/build/tools/timezone.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { cache } from "../utils/cache.js";
+import { timezoneInfo } from "../utils/google-client.js";
+const TTL_MS = 90 * 24 * 60 * 60 * 1000; // 90 days
+export const toolName = "maps_timezone";
+export const inputSchema = {
+    latitude: z.number().describe("Latitude of the location"),
+    longitude: z.number().describe("Longitude of the location"),
+    timestamp: z
+        .number()
+        .optional()
+        .describe("Unix timestamp in seconds. Default: current time. Use specific dates to account for daylight saving."),
+};
+export const toolConfig = {
+    title: "Timezone Lookup",
+    description: "Get timezone information for a location by its coordinates. Returns timezone ID, name, and UTC offset. Use this to show local times in trip itineraries or convert between timezones for travel planning.",
+    inputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+    },
+};
+export async function handler(args) {
+    try {
+        // Round to 4 decimal places (~11m precision) for cache key stability
+        const lat = Math.round(args.latitude * 10000) / 10000;
+        const lng = Math.round(args.longitude * 10000) / 10000;
+        const cacheKey = `timezone:${lat},${lng}`;
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return { content: [{ type: "text", text: JSON.stringify(cached) }] };
+        }
+        const result = await timezoneInfo({ lat: args.latitude, lng: args.longitude, timestamp: args.timestamp });
+        cache.set(cacheKey, result, TTL_MS);
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`[maps_timezone] error: ${message}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=timezone.js.map

package/build/tools/timezone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.js","sourceRoot":"","sources":["../../src/tools/timezone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,UAAU;AAEnD,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACzD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC3D,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sGAAsG,CACvG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,2MAA2M;IAC7M,WAAW;IACX,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,IAAI;KACpB;CACF,CAAC;AAQF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAkB;IAC9C,IAAI,CAAC;QACH,qEAAqE;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;QACvD,MAAM,QAAQ,GAAG,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;QAE1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAiB,QAAQ,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAE1G,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YAC9E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/build/types.d.ts

@@ -0,0 +1,107 @@
+/** Latitude/longitude coordinate pair */
+export interface LatLng {
+    lat: number;
+    lng: number;
+}
+/** Normalized geocoding result returned to MCP clients */
+export interface GeocodeResult {
+    formatted_address: string;
+    location: LatLng;
+    place_id: string;
+    types: string[];
+}
+/** Generic cache entry with expiration timestamp */
+export interface CacheEntry<T> {
+    data: T;
+    expires_at: number;
+}
+/** Structured tool error */
+export interface ToolError {
+    error: string;
+    code?: string;
+}
+/** Result from Places Text Search */
+export interface PlaceSearchResult {
+    place_id: string;
+    name: string;
+    formatted_address: string;
+    location: LatLng;
+    rating?: number;
+    types: string[];
+}
+/** Opening hours info returned by Place Details */
+export interface OpeningHours {
+    open_now?: boolean;
+    weekday_text?: string[];
+}
+/** A single user review */
+export interface PlaceReview {
+    author_name: string;
+    rating: number;
+    text: string;
+    time: string;
+}
+/** A single step in a route */
+export interface RouteStep {
+    instruction: string;
+    distance: {
+        text: string;
+        value: number;
+    };
+    duration: {
+        text: string;
+        value: number;
+    };
+}
+/** Result from the Routes API (Compute Route) */
+export interface DirectionsResult {
+    summary: string;
+    distance: {
+        text: string;
+        value: number;
+    };
+    duration: {
+        text: string;
+        value: number;
+    };
+    steps: RouteStep[];
+}
+/** A single cell in the distance matrix */
+export interface MatrixElement {
+    origin: string;
+    destination: string;
+    distance: {
+        text: string;
+        value: number;
+    };
+    duration: {
+        text: string;
+        value: number;
+    };
+    status: string;
+}
+/** Result from the Distance Matrix API */
+export interface DistanceMatrixResult {
+    elements: MatrixElement[];
+}
+/** Result from the Timezone API */
+export interface TimezoneResult {
+    timezone_id: string;
+    timezone_name: string;
+    utc_offset_seconds: number;
+    dst_offset_seconds: number;
+}
+/** Rich place info from Place Details API */
+export interface PlaceDetailsResult {
+    place_id: string;
+    name: string;
+    formatted_address: string;
+    location: LatLng;
+    rating?: number;
+    opening_hours?: OpeningHours;
+    phone?: string;
+    website?: string;
+    reviews?: PlaceReview[];
+    types?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC;IACR,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4BAA4B;AAC5B,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+BAA+B;AAC/B,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/build/utils/cache.d.ts

@@ -0,0 +1,21 @@
+declare class Cache {
+    private store;
+    /**
+     * Retrieve a cached value. Returns null if missing or expired.
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Store a value with a TTL in milliseconds.
+     */
+    set<T>(key: string, data: T, ttl_ms: number): void;
+    /** Check if key exists and has not expired. */
+    has(key: string): boolean;
+    /** Remove a specific key. */
+    delete(key: string): void;
+    /** Clear all cached entries. */
+    clear(): void;
+}
+/** Singleton cache instance shared across all tools. */
+export declare const cache: Cache;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/build/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAEA,cAAM,KAAK;IACT,OAAO,CAAC,KAAK,CAA0C;IAEvD;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAe7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlD,+CAA+C;IAC/C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,6BAA6B;IAC7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,gCAAgC;IAChC,KAAK,IAAI,IAAI;CAGd;AAED,wDAAwD;AACxD,eAAO,MAAM,KAAK,OAAc,CAAC"}

package/build/utils/cache.js

@@ -0,0 +1,41 @@
+class Cache {
+    store = new Map();
+    /**
+     * Retrieve a cached value. Returns null if missing or expired.
+     */
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry) {
+            console.error(`[cache] miss: ${key}`);
+            return null;
+        }
+        if (Date.now() > entry.expires_at) {
+            this.store.delete(key);
+            console.error(`[cache] expired: ${key}`);
+            return null;
+        }
+        console.error(`[cache] hit: ${key}`);
+        return entry.data;
+    }
+    /**
+     * Store a value with a TTL in milliseconds.
+     */
+    set(key, data, ttl_ms) {
+        this.store.set(key, { data, expires_at: Date.now() + ttl_ms });
+    }
+    /** Check if key exists and has not expired. */
+    has(key) {
+        return this.get(key) !== null;
+    }
+    /** Remove a specific key. */
+    delete(key) {
+        this.store.delete(key);
+    }
+    /** Clear all cached entries. */
+    clear() {
+        this.store.clear();
+    }
+}
+/** Singleton cache instance shared across all tools. */
+export const cache = new Cache();
+//# sourceMappingURL=cache.js.map

package/build/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK;IACD,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEvD;;OAEG;IACH,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAA8B,CAAC;QAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,GAAW,EAAE,IAAO,EAAE,MAAc;QACzC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,+CAA+C;IAC/C,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAChC,CAAC;IAED,6BAA6B;IAC7B,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,gCAAgC;IAChC,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC"}