@mseep/wanderlog-mcp 0.3.1

package/dist/tools/get-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-guide.js","sourceRoot":"","sources":["../../src/tools/get-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,2FAA2F,CAC5F;IACH,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,kFAAkF,CACnF;IACH,eAAe,EAAE,CAAC;SACf,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;SAC7B,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CACP,uGAAuG,CACxG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;CAKlC,CAAC,IAAI,EAAE,CAAC;AAQT,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAe,EACf,IAAkB;IAElB,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,wBAAwB,CAAC,uBAAuB,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,IAAI,SAAS,EAAE,GAAG,CAAC,CAAC;QACtE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GACL,GAAG,YAAY,cAAc;YAC3B,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE;YACrB,CAAC,CAAC,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/tools/get-trip-url.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { WanderlogError } from "../errors.js";
+export const getTripUrlInputSchema = {
+    trip_key: z
+        .string()
+        .min(1)
+        .describe("The trip key from wanderlog_list_trips."),
+    mode: z
+        .enum(["edit", "view", "suggest"])
+        .default("edit")
+        .describe("Which link variant to return. 'edit' (default) is the primary link with full permissions. 'view' is a read-only share link. 'suggest' is a suggest-mode share link where collaborators can propose changes."),
+};
+export const getTripUrlDescription = `
+Returns the wanderlog.com URL for a trip so the user can open it in a browser.
+
+Three link variants are available via the mode parameter:
+  - edit    (default) — full-permission link for the owner
+  - view    — read-only link that's safe to share with anyone
+  - suggest — suggest-mode link where collaborators can propose changes
+
+If you don't know which mode the user wants, default to edit.
+`.trim();
+export function pickKey(trip, mode) {
+    if (mode === "view")
+        return trip.viewKey ?? trip.editKey ?? trip.key;
+    if (mode === "suggest")
+        return trip.suggestKey ?? trip.editKey ?? trip.key;
+    return trip.editKey ?? trip.key;
+}
+export function buildTripUrl(trip, mode, baseUrl = "https://wanderlog.com") {
+    return `${baseUrl}/plan/${pickKey(trip, mode)}`;
+}
+export async function getTripUrl(ctx, args) {
+    try {
+        const trip = await ctx.tripCache.get(args.trip_key);
+        const mode = args.mode ?? "edit";
+        const url = buildTripUrl(trip, mode, ctx.config.baseUrl);
+        const suffix = mode === "view"
+            ? "\n(Read-only link — safe to share.)"
+            : mode === "suggest"
+                ? "\n(Suggest-mode link — collaborators can propose changes.)"
+                : "";
+        return { content: [{ type: "text", text: `${url}${suffix}` }] };
+    }
+    catch (err) {
+        const msg = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: msg }], isError: true };
+    }
+}
+//# sourceMappingURL=get-trip-url.js.map

package/dist/tools/get-trip-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trip-url.js","sourceRoot":"","sources":["../../src/tools/get-trip-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,yCAAyC,CAAC;IACtD,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;SACjC,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CACP,6MAA6M,CAC9M;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;CASpC,CAAC,IAAI,EAAE,CAAC;AAOT,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,IAAiC;IACvE,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC;IACrE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC;IAC3E,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAc,EACd,IAAiC,EACjC,OAAO,GAAG,uBAAuB;IAEjC,OAAO,GAAG,OAAO,SAAS,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAe,EACf,IAAU;IAEV,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC;QACjC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEzD,MAAM,MAAM,GACV,IAAI,KAAK,MAAM;YACb,CAAC,CAAC,qCAAqC;YACvC,CAAC,CAAC,IAAI,KAAK,SAAS;gBAClB,CAAC,CAAC,4DAA4D;gBAC9D,CAAC,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;IAClE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GACP,GAAG,YAAY,cAAc;YAC3B,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE;YACrB,CAAC,CAAC,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/tools/get-trip.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { WanderlogError } from "../errors.js";
+import { formatTrip } from "../formatters/trip-summary.js";
+import { resolveDay } from "../resolvers/day.js";
+export const getTripInputSchema = {
+    trip_key: z
+        .string()
+        .min(1)
+        .describe("The unique trip key from wanderlog_list_trips (e.g. 'vzyrsyhgxvonvxcz'). Required."),
+    day: z
+        .string()
+        .optional()
+        .describe("Optional filter to a single day. Accepts 'day 2', 'May 4', or ISO '2026-05-04'. Omit to return the whole trip."),
+    response_format: z
+        .enum(["concise", "detailed"])
+        .default("concise")
+        .describe("Output verbosity. 'concise' (default) is a readable summary grouped by day; 'detailed' adds addresses, phone numbers, ratings, and check-in dates."),
+};
+export const getTripDescription = `
+Returns the itinerary for one Wanderlog trip: the hotels list, the "places to visit" list, and
+each day's scheduled places.
+
+Use concise format for summarizing or answering questions about a trip in natural language.
+Use detailed format when the user asks for specific info like addresses, phone numbers, or
+hotel check-in/out dates.
+
+If you don't know the trip_key, call wanderlog_list_trips first to find it.
+`.trim();
+export async function getTrip(ctx, args) {
+    try {
+        const trip = await ctx.tripCache.get(args.trip_key);
+        const daySection = args.day ? resolveDay(trip, args.day) : undefined;
+        const text = formatTrip(trip, args.response_format ?? "concise", daySection);
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        const e = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: e }], isError: true };
+    }
+}
+//# sourceMappingURL=get-trip.js.map

package/dist/tools/get-trip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trip.js","sourceRoot":"","sources":["../../src/tools/get-trip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,oFAAoF,CACrF;IACH,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,gHAAgH,CACjH;IACH,eAAe,EAAE,CAAC;SACf,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;SAC7B,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CACP,oJAAoJ,CACrJ;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;CASjC,CAAC,IAAI,EAAE,CAAC;AAQT,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAe,EACf,IAAU;IAEV,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,IAAI,SAAS,EAAE,UAAU,CAAC,CAAC;QAC7E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GACL,GAAG,YAAY,cAAc;YAC3B,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE;YACrB,CAAC,CAAC,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/tools/list-trips.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { WanderlogError } from "../errors.js";
+import { formatTripList } from "../formatters/trip-summary.js";
+export const listTripsInputSchema = {
+    response_format: z
+        .enum(["concise", "detailed"])
+        .default("concise")
+        .describe("Output verbosity. 'concise' (default) gives a one-line summary per trip; 'detailed' includes key, owner, and last-edited time."),
+};
+export const listTripsDescription = `
+Lists all Wanderlog trips in the authenticated user's account (owned and shared-with-you).
+
+Returns a compact list with title, dates, place count, and trip_key. Use this tool first when
+the user mentions a trip by name but you don't have its trip_key yet — the key is required by
+wanderlog_get_trip and wanderlog_search_places.
+
+Each line includes a [key: ...] suffix — extract that key for downstream tool calls.
+`.trim();
+export async function listTrips(ctx, args) {
+    try {
+        const trips = await ctx.rest.listTrips();
+        const text = formatTripList(trips, args.response_format ?? "concise");
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        const e = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: e }], isError: true };
+    }
+}
+//# sourceMappingURL=list-trips.js.map

package/dist/tools/list-trips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-trips.js","sourceRoot":"","sources":["../../src/tools/list-trips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,eAAe,EAAE,CAAC;SACf,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;SAC7B,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CACP,gIAAgI,CACjI;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;CAQnC,CAAC,IAAI,EAAE,CAAC;AAIT,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAe,EACf,IAAU;IAEV,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,IAAI,SAAS,CAAC,CAAC;QACtE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAAG,YAAY,cAAc;YACrC,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE;YACrB,CAAC,CAAC,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/tools/remove-note.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { WanderlogError, WanderlogNotFoundError } from "../errors.js";
+import { resolveDay } from "../resolvers/day.js";
+import { findDaySectionByDate, submitOp } from "./shared.js";
+export const removeNoteInputSchema = {
+    trip_key: z.string().min(1).describe("The trip to remove from."),
+    text: z
+        .string()
+        .min(1)
+        .describe("Substring to match against note content (case-insensitive)."),
+    day: z
+        .string()
+        .optional()
+        .describe("Optional day to search. Accepts 'day 2', 'May 4', or ISO '2026-05-04'. Omit to search the entire trip."),
+};
+export const removeNoteDescription = `
+Removes a note block from a Wanderlog trip by matching a substring of its text content.
+
+The match is case-insensitive. If exactly one note matches, it is deleted. If no notes match,
+an error is returned. If multiple notes match, a list of previews is returned — supply a more
+specific substring to narrow to one.
+
+Use the optional 'day' filter to limit the search to a specific day.
+`.trim();
+export function extractDeltaText(delta) {
+    const ops = delta?.ops ?? [];
+    return ops.map((op) => (typeof op.insert === "string" ? op.insert : "")).join("");
+}
+export function extractPlainText(block) {
+    return extractDeltaText(block.text);
+}
+export function findNoteMatches(trip, query, day) {
+    const lowerQuery = query.toLowerCase();
+    const sections = trip.itinerary.sections;
+    const matches = [];
+    let sectionIndices;
+    if (day) {
+        const resolved = resolveDay(trip, day);
+        const found = findDaySectionByDate(trip, resolved.date);
+        if (!found)
+            return [];
+        sectionIndices = [found.index];
+    }
+    else {
+        sectionIndices = Array.from({ length: sections.length }, (_, i) => i);
+    }
+    for (const sectionIndex of sectionIndices) {
+        const section = sections[sectionIndex];
+        for (let blockIndex = 0; blockIndex < section.blocks.length; blockIndex++) {
+            const block = section.blocks[blockIndex];
+            if (block.type !== "note")
+                continue;
+            const noteBlock = block;
+            const plainText = extractPlainText(noteBlock);
+            if (plainText.toLowerCase().includes(lowerQuery)) {
+                matches.push({ sectionIndex, blockIndex, plainText, block: noteBlock });
+            }
+        }
+    }
+    return matches;
+}
+function notePreview(plainText) {
+    const flat = plainText.replace(/\n/g, " ").trim();
+    return flat.length > 60 ? `${flat.slice(0, 57)}…` : flat;
+}
+export async function removeNote(ctx, args) {
+    try {
+        const trip = await ctx.tripCache.get(args.trip_key);
+        const matches = findNoteMatches(trip, args.text, args.day);
+        if (matches.length === 0) {
+            throw new WanderlogNotFoundError("Note", args.text);
+        }
+        if (matches.length > 1) {
+            const lines = matches
+                .slice(0, 5)
+                .map((m, i) => `  ${i + 1}. "${notePreview(m.plainText)}"`)
+                .join("\n");
+            const suffix = matches.length > 5 ? `\n  (${matches.length - 5} more…)` : "";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `"${args.text}" matches ${matches.length} notes:\n${lines}${suffix}\n\nCall again with a more specific substring to identify the one you want.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { sectionIndex, blockIndex, block, plainText } = matches[0];
+        const ops = [
+            {
+                p: ["itinerary", "sections", sectionIndex, "blocks", blockIndex],
+                ld: block,
+            },
+        ];
+        await submitOp(ctx, args.trip_key, ops);
+        const text = `Removed note "${notePreview(plainText)}" from "${trip.title}".`;
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        const msg = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: msg }], isError: true };
+    }
+}
+//# sourceMappingURL=remove-note.js.map

package/dist/tools/remove-note.js.map

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

package/dist/tools/remove-place.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import { WanderlogError, WanderlogNotFoundError } from "../errors.js";
+import { resolvePlaceRef } from "../resolvers/place-ref.js";
+import { isPlaceBlock } from "../types.js";
+import { submitOp } from "./shared.js";
+export const removePlaceInputSchema = {
+    trip_key: z.string().min(1).describe("The trip to remove from."),
+    place_ref: z
+        .string()
+        .min(1)
+        .describe("Natural-language reference to the place you want to remove. Examples: 'Queenstown Gardens', 'the hotel', 'the sushi place on day 3'. Supports ordinal prefixes for duplicates: '1st Queenstown Gardens', 'second Queenstown Gardens', 'last Queenstown Gardens'. Supports day filters via ' on ': 'Queenstown Gardens on May 4'. Ordinals and day filters can be combined: '2nd Queenstown Gardens on May 4'."),
+};
+export const removePlaceDescription = `
+Removes a place (or flight, train, hotel — any block) from a Wanderlog trip based on a
+natural-language reference.
+
+Supported reference forms:
+  - Exact or partial name: "Queenstown Gardens", "Gardens"
+  - Role keywords: "the hotel", "the flight", "the train"
+  - Day filter: "Queenstown Gardens on May 4" or "... on day 3"
+  - Ordinal prefix (for duplicates): "1st Queenstown Gardens", "second X", "last X"
+  - Combined: "2nd Queenstown Gardens on May 4"
+
+If the reference is ambiguous (multiple places match), the tool returns a numbered list of
+candidates and does NOT make any change. Re-call with an ordinal prefix ("1st X", "2nd X") or
+a more specific filter to pick the one you want.
+`.trim();
+export async function removePlace(ctx, args) {
+    try {
+        const trip = await ctx.tripCache.get(args.trip_key);
+        const result = resolvePlaceRef(trip, args.place_ref);
+        if (result.kind === "none") {
+            throw new WanderlogNotFoundError("Place", args.place_ref);
+        }
+        if (result.kind === "ambiguous") {
+            const lines = result.candidates
+                .slice(0, 10)
+                .map((c, i) => {
+                const name = isPlaceBlock(c.block)
+                    ? c.block.place.name
+                    : `${c.block.type} block`;
+                const where = formatLocation(c.section);
+                const ordinal = ordinalLabel(i + 1);
+                return `  ${i + 1}. ${name} — ${where} (${ordinal})`;
+            })
+                .join("\n");
+            const firstCandidateName = isPlaceBlock(result.candidates[0].block)
+                ? result.candidates[0].block.place.name
+                : "the block";
+            const retryHint = `Call this tool again with an ordinal to pick one, e.g. place_ref: "1st ${firstCandidateName}" or "last ${firstCandidateName}". You can also combine with a day filter, e.g. "2nd ${firstCandidateName} on day 2".`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `"${args.place_ref}" matches ${result.candidates.length} places:\n${lines}\n\n${retryHint}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { sectionIndex, blockIndex, block, section } = result.match;
+        const ops = [
+            {
+                p: ["itinerary", "sections", sectionIndex, "blocks", blockIndex],
+                ld: block,
+            },
+        ];
+        await submitOp(ctx, args.trip_key, ops);
+        const removedName = isPlaceBlock(block)
+            ? block.place.name
+            : `${block.type} block`;
+        const text = `Removed ${removedName} from ${formatLocation(section)} in "${trip.title}".`;
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        const msg = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: msg }], isError: true };
+    }
+}
+function formatLocation(section) {
+    if (section.mode === "dayPlan" && section.date) {
+        return `day ${section.date}`;
+    }
+    if (section.heading)
+        return `"${section.heading}"`;
+    return `"${section.type ?? "section"}"`;
+}
+function ordinalLabel(n) {
+    const suffix = ["th", "st", "nd", "rd"];
+    const v = n % 100;
+    return `${n}${suffix[(v - 20) % 10] ?? suffix[v] ?? suffix[0]}`;
+}
+//# sourceMappingURL=remove-place.js.map

package/dist/tools/remove-place.js.map

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

package/dist/tools/rename-day.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+import { WanderlogError, WanderlogValidationError } from "../errors.js";
+import { resolveDay } from "../resolvers/day.js";
+import { findDaySectionByDate, submitOp } from "./shared.js";
+export const renameDayInputSchema = {
+    trip_key: z.string().min(1).describe("The trip containing the day to rename."),
+    day: z
+        .string()
+        .min(1)
+        .describe('Which day to rename. Accepts "day 3", "May 4", or "2026-05-04".'),
+    heading: z
+        .string()
+        .describe('New heading for the day. Use "" (empty string) to clear the heading back to the auto-generated default.'),
+};
+export const renameDayDescription = `
+Renames the heading/subheading of a specific day in a Wanderlog trip.
+
+Day headings appear in the itinerary as the title for each day section (e.g. "Barcelona",
+"Ronda + Malaga"). Use this tool to replace them with more descriptive titles.
+
+Pass an empty string for "heading" to reset the day back to Wanderlog's auto-generated heading.
+`.trim();
+export async function renameDay(ctx, args) {
+    try {
+        const entry = await ctx.tripCache.getEntry(args.trip_key);
+        const trip = entry.snapshot;
+        const daySection = resolveDay(trip, args.day);
+        const found = findDaySectionByDate(trip, daySection.date);
+        if (!found) {
+            throw new WanderlogValidationError(`Day ${args.day} not found in trip`);
+        }
+        const oldHeading = found.section.heading;
+        const newHeading = args.heading;
+        if (oldHeading === newHeading) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Day ${daySection.date} heading is already "${newHeading}" — no change made.`,
+                    },
+                ],
+            };
+        }
+        const ops = [
+            {
+                p: ["itinerary", "sections", found.index, "heading"],
+                od: oldHeading,
+                oi: newHeading,
+            },
+        ];
+        await submitOp(ctx, args.trip_key, ops);
+        const oldLabel = oldHeading || "(auto-generated)";
+        const newLabel = newHeading || "(auto-generated)";
+        const text = `Renamed day ${daySection.date} in "${trip.title}": "${oldLabel}" → "${newLabel}"`;
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        const msg = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: msg }], isError: true };
+    }
+}
+//# sourceMappingURL=rename-day.js.map

package/dist/tools/rename-day.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-day.js","sourceRoot":"","sources":["../../src/tools/rename-day.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC9E,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,iEAAiE,CAClE;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CACP,yGAAyG,CAC1G;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;CAOnC,CAAC,IAAI,EAAE,CAAC;AAQT,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAe,EACf,IAAU;IAEV,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;QAE5B,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,IAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,wBAAwB,CAAC,OAAO,IAAI,CAAC,GAAG,oBAAoB,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;QAEhC,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,OAAO,UAAU,CAAC,IAAI,wBAAwB,UAAU,qBAAqB;qBACpF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAc;YACrB;gBACE,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC;gBACpD,EAAE,EAAE,UAAU;gBACd,EAAE,EAAE,UAAU;aACf;SACF,CAAC;QAEF,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAExC,MAAM,QAAQ,GAAG,UAAU,IAAI,kBAAkB,CAAC;QAClD,MAAM,QAAQ,GAAG,UAAU,IAAI,kBAAkB,CAAC;QAClD,MAAM,IAAI,GAAG,eAAe,UAAU,CAAC,IAAI,QAAQ,IAAI,CAAC,KAAK,OAAO,QAAQ,QAAQ,QAAQ,GAAG,CAAC;QAChG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GACP,GAAG,YAAY,cAAc;YAC3B,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE;YACrB,CAAC,CAAC,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/tools/search-guides.js

@@ -0,0 +1,172 @@
+import { z } from "zod";
+import { WanderlogError, WanderlogNotFoundError, WanderlogValidationError, } from "../errors.js";
+export const searchGuidesInputSchema = {
+    destination: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Free-text destination (e.g. 'Vietnam', 'Kyoto'). Resolved via geoAutocomplete; multi-match auto-picks the highest-popularity geo and surfaces up to 2 candidates in 'alternative_geos'."),
+    geo_id: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Explicit Wanderlog geo id (from a prior response's 'geo' or 'alternative_geos')."),
+    response_format: z
+        .enum(["concise", "detailed"])
+        .default("concise")
+        .describe("Output verbosity. 'concise' (default) returns guide_key, title, author, place_count, view_count. 'detailed' adds blurb, like_count, edited_at, distinction, profile_picture_url, header_image_url."),
+};
+export const searchGuidesDescription = `
+Lists user-written Wanderlog travel guides for a destination — long-form recommendations and
+itineraries other travellers have published. Use this when the user asks for inspiration, an
+itinerary they can copy, or "what guides exist for X".
+
+Specify exactly one of destination or geo_id. For free-text destinations the highest-popularity
+match is picked; up to 2 candidates appear in 'alternative_geos' as a soft hint. When the
+destination has no curated guides yet, the response carries 'alternative_geos_with_guides'
+with the top 5 nearby destinations that do.
+
+Pass the returned guide_key to wanderlog_get_guide to read the full content of one guide.
+`.trim();
+export function validateArgs(args) {
+    const modesSet = [args.destination !== undefined, args.geo_id !== undefined].filter(Boolean).length;
+    if (modesSet !== 1) {
+        throw new WanderlogValidationError("Pass exactly one of destination or geo_id.");
+    }
+    return { ...args, response_format: args.response_format ?? "concise" };
+}
+export async function resolveGeo(ctx, args) {
+    if (args.geo_id !== undefined) {
+        // Trust the caller's geo_id. The canonical name/country/subcategory will
+        // be filled in by getGuidesForGeo's embedded geo (or left as a stub if
+        // the geo has no guides at all).
+        return {
+            geo: {
+                geo_id: args.geo_id,
+                name: "",
+                country: null,
+                subcategory: null,
+            },
+            alternative_geos: [],
+        };
+    }
+    const candidates = await ctx.rest.geoAutocomplete(args.destination);
+    if (candidates.length === 0) {
+        throw new WanderlogError(`No geo found matching "${args.destination}"`, "destination_not_found", {
+            hint: "Try a more specific name (include the country) or pass an explicit geo_id from a prior search.",
+            followUps: [
+                "Retry wanderlog_search_guides with a more specific destination (include the country or region).",
+            ],
+        });
+    }
+    const ranked = [...candidates].sort((a, b) => (b.popularity ?? 0) - (a.popularity ?? 0));
+    const top = ranked[0];
+    const alternatives = ranked.slice(1, 3).map((c) => ({
+        geo_id: c.id,
+        name: c.name,
+        country: c.countryName ?? null,
+        subcategory: null,
+    }));
+    return {
+        geo: {
+            geo_id: top.id,
+            name: top.name,
+            country: top.countryName ?? null,
+            subcategory: null,
+        },
+        alternative_geos: alternatives,
+    };
+}
+const IMAGE_BASE = "https://wanderlog.com/image/upload";
+let cachedGoodGuides = null;
+export function __resetCacheForTests() {
+    cachedGoodGuides = null;
+}
+export function loadGoodGuides(ctx) {
+    if (!cachedGoodGuides) {
+        cachedGoodGuides = ctx.rest.listGoodGuides().catch((err) => {
+            cachedGoodGuides = null;
+            throw err;
+        });
+    }
+    return cachedGoodGuides;
+}
+function imageUrl(key) {
+    return key ? `${IMAGE_BASE}/${key}` : null;
+}
+export function projectGuide(g, format) {
+    const base = {
+        guide_key: g.key,
+        title: g.title,
+        author: g.user.username,
+        place_count: g.placeCount ?? null,
+        view_count: g.viewCount ?? null,
+        like_count: g.likeCount ?? null,
+        blurb: g.authorBlurb ?? null,
+        url: `https://wanderlog.com/view/${g.key}`,
+        edited_at: g.editedAt ?? null,
+    };
+    if (format === "concise")
+        return base;
+    return {
+        ...base,
+        author_name: g.user.name,
+        profile_picture_url: imageUrl(g.user.profilePictureKey),
+        distinction: g.distinction ?? null,
+        header_image_url: imageUrl(g.headerImageKey),
+    };
+}
+export function geoRef(g) {
+    return {
+        geo_id: g.id,
+        name: g.name,
+        country: g.countryName ?? null,
+        subcategory: g.subcategory ?? null,
+    };
+}
+export async function searchGuides(ctx, args) {
+    try {
+        const norm = validateArgs(args);
+        const { geo: stub, alternative_geos } = await resolveGeo(ctx, norm);
+        let guidesResp = null;
+        try {
+            guidesResp = await ctx.rest.getGuidesForGeo(stub.geo_id);
+        }
+        catch (err) {
+            if (!(err instanceof WanderlogNotFoundError))
+                throw err;
+        }
+        if (!guidesResp || guidesResp.guides.length === 0) {
+            const good = await loadGoodGuides(ctx);
+            const top5 = [...good]
+                .sort((a, b) => (b.popularity ?? 0) - (a.popularity ?? 0))
+                .slice(0, 5)
+                .map(geoRef);
+            const resolved_geo = guidesResp?.geo ? geoRef(guidesResp.geo) : stub;
+            const body = {
+                kind: "no_guides",
+                resolved_geo,
+                alternative_geos_with_guides: top5,
+            };
+            return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
+        }
+        const projected = guidesResp.guides.map((g) => projectGuide(g, norm.response_format));
+        const body = {
+            kind: "guides",
+            geo: geoRef(guidesResp.geo),
+            alternative_geos,
+            returned: projected.length,
+            total: projected.length,
+            guides: projected,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
+    }
+    catch (err) {
+        const e = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: e }], isError: true };
+    }
+}
+//# sourceMappingURL=search-guides.js.map

package/dist/tools/search-guides.js.map

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