@mseep/wanderlog-mcp 0.3.1

package/dist/tools/add-place.js

@@ -0,0 +1,151 @@
+import { z } from "zod";
+import { WanderlogError, WanderlogValidationError } from "../errors.js";
+import { resolveDay } from "../resolvers/day.js";
+import { buildPlaceBlock, findDaySectionByDate, findPlacesToVisitSection, findTripCenter, requireUserId, submitOp, } from "./shared.js";
+export const addPlaceInputSchema = {
+    trip_key: z
+        .string()
+        .min(1)
+        .describe("The trip to add to. Use wanderlog_list_trips if you don't know the key."),
+    place: z
+        .string()
+        .min(1)
+        .describe("Name of the place to add. Examples: 'Sensō-ji', 'a ramen place in Shinjuku', 'Louvre'. Will be matched against Google Places near the trip's destination; if multiple match, the top result is used."),
+    day: z
+        .string()
+        .optional()
+        .describe("Optional day to add the place to. Accepts 'day 2', 'May 4', or ISO '2026-05-04'. Omit to add the place to the trip's 'Places to visit' list (unscheduled)."),
+    note: z
+        .string()
+        .optional()
+        .describe("Optional inline note attached directly to this place. Use for practical context: transit directions, what to order, booking tips, time guidance. Appears on the place itself in Wanderlog (not as a separate note block)."),
+    start_time: z
+        .string()
+        .regex(/^\d{2}:\d{2}$/, "must be HH:mm")
+        .optional()
+        .describe("Optional start time in HH:mm format (e.g. '09:00'). Adds a scheduled time to the place."),
+    end_time: z
+        .string()
+        .regex(/^\d{2}:\d{2}$/, "must be HH:mm")
+        .optional()
+        .describe("Optional end time in HH:mm format (e.g. '11:30'). Only used with start_time."),
+};
+export const addPlaceDescription = `
+Adds a place to a Wanderlog trip. Searches for the place near the trip's destination, picks the
+best match, and inserts it into either a specific day or the general "Places to visit" list.
+
+PREFERRED: Use the "note" parameter to attach practical context directly to each place — transit
+directions, what to order, booking tips, time guidance. This is better than a separate
+wanderlog_add_note call because the note lives on the place itself in the itinerary. Use the
+"start_time" and "end_time" parameters to give the place a scheduled time window.
+
+Use standalone wanderlog_add_note only for freestanding commentary between places (neighborhood
+context, multi-stop transit, day-level tips that aren't about a specific place).
+
+Returns a confirmation including the resolved place name and where it was added.
+`.trim();
+export async function addPlace(ctx, args) {
+    try {
+        const userId = requireUserId(ctx);
+        const entry = await ctx.tripCache.getEntry(args.trip_key);
+        const trip = entry.snapshot;
+        // Resolve target section
+        let targetIndex;
+        let targetLabel;
+        if (args.day) {
+            const daySection = resolveDay(trip, args.day);
+            const found = findDaySectionByDate(trip, daySection.date);
+            if (!found) {
+                throw new WanderlogValidationError(`Day ${args.day} not found in trip`);
+            }
+            targetIndex = found.index;
+            targetLabel = `day ${daySection.date}`;
+        }
+        else {
+            const places = findPlacesToVisitSection(trip);
+            if (!places) {
+                throw new WanderlogError("Trip has no 'Places to visit' list", "no_places_section", "This is unexpected — Wanderlog usually creates one automatically. Try adding to a specific day instead.");
+            }
+            targetIndex = places.index;
+            targetLabel = "places to visit";
+        }
+        const center = findTripCenter(trip, entry.geos);
+        if (!center) {
+            throw new WanderlogValidationError(`Cannot add places to "${trip.title}" because no location anchor is available`, "This trip has no associated geo and no existing places. Add a place via the Wanderlog UI first.");
+        }
+        const predictions = await ctx.rest.searchPlacesAutocomplete({
+            input: args.place,
+            sessionToken: crypto.randomUUID(),
+            location: { latitude: center.lat, longitude: center.lng },
+            radius: 15000,
+        });
+        if (predictions.length === 0) {
+            throw new WanderlogError(`No place found matching "${args.place}" near ${trip.title}`, "place_not_found", {
+                hint: "Try a more specific name, or widen the search with wanderlog_search_places first.",
+                followUps: [
+                    `Call wanderlog_search_places with trip_key "${args.trip_key}" and a broader query to see nearby candidates.`,
+                    "Retry wanderlog_add_place with a more specific place name (include the city or neighborhood).",
+                ],
+            });
+        }
+        const topPrediction = predictions[0];
+        const detail = await ctx.rest.getPlaceDetails(topPrediction.place_id);
+        // Build the block WITHOUT timing — timing is set via separate oi ops
+        // to match the Wanderlog UI's two-step pattern (insert block, then set fields).
+        const block = buildPlaceBlock(detail, userId);
+        const section = trip.itinerary.sections[targetIndex];
+        const insertIndex = section.blocks.length;
+        const blockPath = ["itinerary", "sections", targetIndex, "blocks", insertIndex];
+        const ops = [
+            { p: blockPath, li: block },
+        ];
+        await submitOp(ctx, args.trip_key, ops);
+        // Follow-up: set inline note text via rich-text subtype op
+        if (args.note) {
+            const textOps = [
+                {
+                    p: [...blockPath, "text"],
+                    t: "rich-text",
+                    o: [{ insert: `${args.note}\n` }],
+                },
+            ];
+            await submitOp(ctx, args.trip_key, textOps);
+        }
+        // Follow-up: set timing via plain oi ops. The block was inserted without
+        // timing fields, so we use oi (object insert) without od — the key doesn't
+        // exist yet. This matches the Wanderlog UI's two-step pattern.
+        if (args.start_time || args.end_time) {
+            const timeOps = [];
+            if (args.start_time) {
+                timeOps.push({
+                    p: [...blockPath, "startTime"],
+                    oi: args.start_time,
+                });
+            }
+            if (args.end_time) {
+                timeOps.push({
+                    p: [...blockPath, "endTime"],
+                    oi: args.end_time,
+                });
+            }
+            await submitOp(ctx, args.trip_key, timeOps);
+        }
+        const parts = [`Added ${detail.name} to ${targetLabel} in "${trip.title}".`];
+        if (args.start_time) {
+            parts.push(`Scheduled: ${args.start_time}${args.end_time ? `–${args.end_time}` : ""}.`);
+        }
+        if (args.note) {
+            const preview = args.note.length > 60 ? `${args.note.slice(0, 57)}…` : args.note;
+            parts.push(`Note: "${preview}"`);
+        }
+        const text = parts.join(" ");
+        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=add-place.js.map

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

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

package/dist/tools/annotate-place.js

@@ -0,0 +1,114 @@
+import { z } from "zod";
+import { WanderlogError, WanderlogValidationError } from "../errors.js";
+import { resolvePlaceRef } from "../resolvers/place-ref.js";
+import { isPlaceBlock } from "../types.js";
+import { submitOp } from "./shared.js";
+export const annotatePlaceInputSchema = {
+    trip_key: z
+        .string()
+        .min(1)
+        .describe("The trip containing the place."),
+    place: z
+        .string()
+        .min(1)
+        .describe("Natural-language reference to the place. Examples: 'Sensō-ji', 'the hotel', 'Queenstown Gardens on day 2'. Supports ordinals for duplicates: '2nd Starbucks'."),
+    note: z
+        .string()
+        .optional()
+        .describe("Set or replace the inline note on this place. Practical context: transit, tips, timing, what to see."),
+    start_time: z
+        .string()
+        .regex(/^\d{2}:\d{2}$/, "must be HH:mm")
+        .optional()
+        .describe("Set or replace the start time (HH:mm format)."),
+    end_time: z
+        .string()
+        .regex(/^\d{2}:\d{2}$/, "must be HH:mm")
+        .optional()
+        .describe("Set or replace the end time (HH:mm format)."),
+};
+export const annotatePlaceDescription = `
+Updates an existing place in a Wanderlog trip with an inline note, start/end time, or both.
+Use this to enrich places that were already added — set practical context, scheduled times,
+or both in one call.
+
+At least one of note, start_time, or end_time must be provided.
+
+The place is resolved by natural-language reference (same syntax as wanderlog_remove_place).
+If ambiguous, returns a disambiguation list without making changes.
+`.trim();
+export async function annotatePlace(ctx, args) {
+    try {
+        if (!args.note && !args.start_time && !args.end_time) {
+            throw new WanderlogValidationError("At least one of note, start_time, or end_time must be provided");
+        }
+        const entry = await ctx.tripCache.getEntry(args.trip_key);
+        const trip = entry.snapshot;
+        const result = resolvePlaceRef(trip, args.place);
+        if (result.kind === "none") {
+            throw new WanderlogError(`No place matching "${args.place}" found in "${trip.title}"`, "place_ref_not_found", {
+                hint: "Check the place name or use wanderlog_get_trip to see what's in the itinerary.",
+                followUps: [
+                    `Call wanderlog_get_trip with trip_key "${args.trip_key}" to see all places.`,
+                ],
+            });
+        }
+        if (result.kind === "ambiguous") {
+            const lines = result.candidates.map((c, i) => {
+                const name = isPlaceBlock(c.block) ? c.block.place.name : `block #${c.block.id}`;
+                const loc = c.section.date ? `day ${c.section.date}` : c.section.heading || "unscheduled";
+                return `  ${i + 1}. ${name} (${loc})`;
+            });
+            const text = `Multiple places match "${args.place}":\n${lines.join("\n")}\n\nRetry with a more specific reference or an ordinal prefix (e.g. "1st ${args.place}").`;
+            return { content: [{ type: "text", text }] };
+        }
+        const { sectionIndex, blockIndex, block } = result.match;
+        const blockPath = ["itinerary", "sections", sectionIndex, "blocks", blockIndex];
+        const placeName = isPlaceBlock(block) ? block.place.name : `block #${block.id}`;
+        // Set inline note via rich-text subtype op
+        if (args.note) {
+            const textOps = [
+                {
+                    p: [...blockPath, "text"],
+                    t: "rich-text",
+                    o: [{ insert: `${args.note}\n` }],
+                },
+            ];
+            await submitOp(ctx, args.trip_key, textOps);
+        }
+        // Set timing — use od+oi when the field already exists, plain oi when it doesn't
+        if (args.start_time || args.end_time) {
+            const timeOps = [];
+            const existingBlock = block;
+            if (args.start_time) {
+                const op = { p: [...blockPath, "startTime"], oi: args.start_time };
+                if ("startTime" in existingBlock)
+                    op.od = existingBlock.startTime;
+                timeOps.push(op);
+            }
+            if (args.end_time) {
+                const op = { p: [...blockPath, "endTime"], oi: args.end_time };
+                if ("endTime" in existingBlock)
+                    op.od = existingBlock.endTime;
+                timeOps.push(op);
+            }
+            await submitOp(ctx, args.trip_key, timeOps);
+        }
+        const parts = [`Updated ${placeName} in "${trip.title}".`];
+        if (args.start_time) {
+            parts.push(`Time: ${args.start_time}${args.end_time ? `–${args.end_time}` : ""}.`);
+        }
+        if (args.note) {
+            const preview = args.note.length > 60 ? `${args.note.slice(0, 57)}…` : args.note;
+            parts.push(`Note: "${preview}"`);
+        }
+        return { content: [{ type: "text", text: parts.join(" ") }] };
+    }
+    catch (err) {
+        const msg = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: msg }], isError: true };
+    }
+}
+//# sourceMappingURL=annotate-place.js.map

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

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

package/dist/tools/create-trip.js

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { WanderlogError, WanderlogValidationError } from "../errors.js";
+export const createTripInputSchema = {
+    destination: z
+        .string()
+        .min(1)
+        .describe("City or region name to plan the trip around (e.g. 'Lisbon', 'Tokyo', 'Banff'). Resolved via Wanderlog's geo autocomplete — the top-ranked result is used."),
+    start_date: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "must be YYYY-MM-DD")
+        .describe("First day of the trip, YYYY-MM-DD."),
+    end_date: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "must be YYYY-MM-DD")
+        .describe("Last day of the trip, YYYY-MM-DD."),
+    title: z
+        .string()
+        .optional()
+        .describe("Optional custom title. If omitted, Wanderlog auto-generates one like 'Trip to Lisbon'."),
+    privacy: z
+        .enum(["private", "friends", "public"])
+        .default("private")
+        .describe("Trip visibility. 'private' is the safe default."),
+};
+export const createTripDescription = `
+Creates a new Wanderlog trip for the given destination and date range. The trip is created
+empty (no places yet) with one pre-generated day section per day in the range.
+
+After creating a trip, populate each day using ALL of these tools together — places alone
+make a flat list, but notes and checklists are what make an itinerary actually useful:
+
+1. wanderlog_add_place — add attractions, restaurants, and activities
+2. wanderlog_add_note — add between places for transit directions, practical tips, time
+   warnings, or local recommendations (e.g. "Walk 10 min south along the river to the next
+   stop" or "Closed Mondays — check hours before visiting")
+3. wanderlog_add_hotel — add accommodation with check-in/check-out dates
+4. wanderlog_add_checklist — add a packing list to the trip, or per-day task lists
+   (e.g. "Day 1 prep: print tickets, charge camera, pack umbrella")
+
+A good itinerary has notes after most places — think of them as the connective tissue that
+turns a list of pins on a map into a real travel plan.
+
+Returns the new trip key so you can reference it in subsequent tool calls.
+`.trim();
+export async function createTrip(ctx, args) {
+    try {
+        if (args.end_date < args.start_date) {
+            throw new WanderlogValidationError(`end_date (${args.end_date}) is before start_date (${args.start_date})`);
+        }
+        const geos = await ctx.rest.geoAutocomplete(args.destination);
+        if (geos.length === 0) {
+            throw new WanderlogError(`No location found for "${args.destination}"`, "geo_not_found", "Try a more specific or well-known place name.");
+        }
+        const top = geos[0];
+        const result = await ctx.rest.createTrip({
+            geoIds: [top.id],
+            startDate: args.start_date,
+            endDate: args.end_date,
+            title: args.title ?? null,
+            privacy: args.privacy ?? "private",
+        });
+        const locationLabel = top.stateName
+            ? `${top.name}, ${top.stateName}, ${top.countryName}`
+            : `${top.name}, ${top.countryName ?? ""}`.trim().replace(/,\s*$/, "");
+        const days = result.key ? Math.round((new Date(args.end_date).getTime() - new Date(args.start_date).getTime()) / 86_400_000) + 1 : 0;
+        const text = [
+            `Created "${result.title}" for ${locationLabel}. Dates: ${args.start_date} → ${args.end_date} (${days} days). Key: ${result.key}`,
+            ``,
+            `Now build the itinerary. For each day, follow this pattern:`,
+            `  1. wanderlog_add_place — add 3-5 places (attractions, food, activities)`,
+            `  2. wanderlog_add_note — add a note after each place with transit directions, practical tips, or local advice`,
+            `  3. wanderlog_add_checklist — add a day-specific task list if useful (e.g. "bring cash", "book ahead")`,
+            `Also call wanderlog_add_hotel for accommodation, and wanderlog_add_checklist (no day) for a packing list.`,
+            `A great itinerary interleaves places and notes — don't add all places first and skip the notes.`,
+        ].join("\n");
+        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=create-trip.js.map

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

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

package/dist/tools/edit-note.js

@@ -0,0 +1,217 @@
+import { z } from "zod";
+import { WanderlogError, WanderlogNotFoundError } from "../errors.js";
+import { resolveDay } from "../resolvers/day.js";
+import { isChecklistBlock, isPlaceBlock } from "../types.js";
+import { findDaySectionByDate, submitOp } from "./shared.js";
+import { extractDeltaText } from "./remove-note.js";
+export const editNoteInputSchema = {
+    trip_key: z.string().min(1).describe("The trip to edit."),
+    old_text: z
+        .string()
+        .min(1)
+        .describe("Substring to find and replace (case-insensitive)."),
+    new_text: z.string().describe("Replacement text."),
+    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 editNoteDescription = `
+Edits note content in a Wanderlog trip by finding and replacing a substring.
+
+Searches across freestanding notes, place annotations, and checklist titles and items.
+The match is case-insensitive. If exactly one match is found, the replacement is made in place.
+If no matches are found, an error is returned. If multiple matches are found, a numbered list
+of previews is returned — call again with a more specific substring.
+
+Use the optional 'day' filter to limit the search to a specific day.
+`.trim();
+function previewText(text) {
+    const flat = text.replace(/\n/g, " ").trim();
+    return flat.length > 60 ? `${flat.slice(0, 57)}…` : flat;
+}
+function matchInDelta(delta, query) {
+    const ops = delta?.ops ?? [];
+    const lowerQuery = query.toLowerCase();
+    const boundaries = [];
+    let plainText = "";
+    for (const op of ops) {
+        boundaries.push(plainText.length);
+        plainText += typeof op.insert === "string" ? op.insert : "";
+    }
+    const lowerText = plainText.toLowerCase();
+    const matchStart = lowerText.indexOf(lowerQuery);
+    if (matchStart === -1)
+        return null;
+    const matchEnd = matchStart + lowerQuery.length;
+    const crossesBoundary = boundaries.some((b) => b > matchStart && b < matchEnd);
+    return { offset: matchStart, matchedLen: lowerQuery.length, crossesBoundary };
+}
+export function findEditTargets(trip, query, day) {
+    const sections = trip.itinerary.sections;
+    const targets = [];
+    const lowerQuery = query.toLowerCase();
+    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 si of sectionIndices) {
+        const section = sections[si];
+        for (let bi = 0; bi < section.blocks.length; bi++) {
+            const block = section.blocks[bi];
+            const blockBase = ["itinerary", "sections", si, "blocks", bi];
+            if (block.type === "note") {
+                const delta = block.text;
+                const m = matchInDelta(delta, query);
+                if (m) {
+                    targets.push({
+                        kind: "rich-text",
+                        label: "note",
+                        preview: `Note: "${previewText(extractDeltaText(delta))}"`,
+                        sectionIndex: si,
+                        blockIndex: bi,
+                        fieldPath: [...blockBase, "text"],
+                        offset: m.offset,
+                        matchedLen: m.matchedLen,
+                        crossesBoundary: m.crossesBoundary,
+                    });
+                }
+            }
+            else if (isPlaceBlock(block)) {
+                const delta = block.text;
+                if (delta) {
+                    const m = matchInDelta(delta, query);
+                    if (m) {
+                        targets.push({
+                            kind: "rich-text",
+                            label: `"${block.place.name}" annotation`,
+                            preview: `"${block.place.name}" annotation: "${previewText(extractDeltaText(delta))}"`,
+                            sectionIndex: si,
+                            blockIndex: bi,
+                            fieldPath: [...blockBase, "text"],
+                            offset: m.offset,
+                            matchedLen: m.matchedLen,
+                            crossesBoundary: m.crossesBoundary,
+                        });
+                    }
+                }
+            }
+            else if (isChecklistBlock(block)) {
+                const cb = block;
+                // Checklist title (plain string)
+                const title = cb.title ?? "";
+                if (title && title.toLowerCase().includes(lowerQuery)) {
+                    const offset = title.toLowerCase().indexOf(lowerQuery);
+                    targets.push({
+                        kind: "plain",
+                        label: "checklist title",
+                        preview: `Checklist title: "${previewText(title)}"`,
+                        sectionIndex: si,
+                        blockIndex: bi,
+                        fieldPath: [...blockBase, "title"],
+                        oldValue: title,
+                        offset,
+                        matchedLen: query.length,
+                    });
+                }
+                // Checklist items
+                for (let ii = 0; ii < cb.items.length; ii++) {
+                    const item = cb.items[ii];
+                    const m = matchInDelta(item.text, query);
+                    if (m) {
+                        targets.push({
+                            kind: "rich-text",
+                            label: "checklist item",
+                            preview: `Checklist item: "${previewText(extractDeltaText(item.text))}"`,
+                            sectionIndex: si,
+                            blockIndex: bi,
+                            fieldPath: [...blockBase, "items", ii, "text"],
+                            offset: m.offset,
+                            matchedLen: m.matchedLen,
+                            crossesBoundary: m.crossesBoundary,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return targets;
+}
+export async function editNote(ctx, args) {
+    try {
+        const trip = await ctx.tripCache.get(args.trip_key);
+        const targets = findEditTargets(trip, args.old_text, args.day);
+        if (targets.length === 0) {
+            throw new WanderlogNotFoundError("Note", args.old_text);
+        }
+        if (targets.length > 1) {
+            const lines = targets
+                .slice(0, 5)
+                .map((t, i) => `  ${i + 1}. ${t.preview}`)
+                .join("\n");
+            const suffix = targets.length > 5 ? `\n  (${targets.length - 5} more…)` : "";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `"${args.old_text}" matches ${targets.length} notes:\n${lines}${suffix}\n\nCall again with a more specific substring to identify the one you want.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const target = targets[0];
+        if (target.kind === "rich-text" && target.crossesBoundary) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Cannot replace "${args.old_text}": the match crosses a formatting boundary (e.g. a link or bold section). Use a more specific substring that stays within one formatting run.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        let ops;
+        if (target.kind === "rich-text") {
+            const deltaOps = [];
+            if (target.offset > 0)
+                deltaOps.push({ retain: target.offset });
+            deltaOps.push({ delete: target.matchedLen });
+            if (args.new_text)
+                deltaOps.push({ insert: args.new_text });
+            ops = [{ p: target.fieldPath, t: "rich-text", o: deltaOps }];
+        }
+        else {
+            const newValue = target.oldValue.slice(0, target.offset) +
+                args.new_text +
+                target.oldValue.slice(target.offset + target.matchedLen);
+            ops = [{ p: target.fieldPath, od: target.oldValue, oi: newValue }];
+        }
+        await submitOp(ctx, args.trip_key, ops);
+        const oldPreview = previewText(args.old_text);
+        const newPreview = previewText(args.new_text || "(empty)");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Updated ${target.label} in "${trip.title}". Changed "${oldPreview}" → "${newPreview}".`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: msg }], isError: true };
+    }
+}
+//# sourceMappingURL=edit-note.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit-note.js","sourceRoot":"","sources":["../../src/tools/edit-note.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACzD,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,mDAAmD,CAAC;IAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAClD,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,wGAAwG,CACzG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;CASlC,CAAC,IAAI,EAAE,CAAC;AAmCT,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,SAAS,YAAY,CACnB,KAA6B,EAC7B,KAAa;IAEb,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAClC,SAAS,IAAI,OAAO,EAAE,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;IAChD,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC/E,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAc,EAAE,KAAa,EAAE,GAAY;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;IACzC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEvC,IAAI,cAAwB,CAAC;IAC7B,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAK,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QACtB,cAAc,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAE,CAAC;QAC9B,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC;YAClC,MAAM,SAAS,GAAwB,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YAEnF,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAI,KAAmB,CAAC,IAAI,CAAC;gBACxC,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACrC,IAAI,CAAC,EAAE,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,WAAW;wBACjB,KAAK,EAAE,MAAM;wBACb,OAAO,EAAE,UAAU,WAAW,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG;wBAC1D,YAAY,EAAE,EAAE;wBAChB,UAAU,EAAE,EAAE;wBACd,SAAS,EAAE,CAAC,GAAG,SAAS,EAAE,MAAM,CAAC;wBACjC,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,UAAU,EAAE,CAAC,CAAC,UAAU;wBACxB,eAAe,EAAE,CAAC,CAAC,eAAe;qBACnC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;gBACzB,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;oBACrC,IAAI,CAAC,EAAE,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC;4BACX,IAAI,EAAE,WAAW;4BACjB,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,cAAc;4BACzC,OAAO,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,kBAAkB,WAAW,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG;4BACtF,YAAY,EAAE,EAAE;4BAChB,UAAU,EAAE,EAAE;4BACd,SAAS,EAAE,CAAC,GAAG,SAAS,EAAE,MAAM,CAAC;4BACjC,MAAM,EAAE,CAAC,CAAC,MAAM;4BAChB,UAAU,EAAE,CAAC,CAAC,UAAU;4BACxB,eAAe,EAAE,CAAC,CAAC,eAAe;yBACnC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnC,MAAM,EAAE,GAAG,KAAuB,CAAC;gBACnC,iCAAiC;gBACjC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC7B,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBACtD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBACvD,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,iBAAiB;wBACxB,OAAO,EAAE,qBAAqB,WAAW,CAAC,KAAK,CAAC,GAAG;wBACnD,YAAY,EAAE,EAAE;wBAChB,UAAU,EAAE,EAAE;wBACd,SAAS,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,CAAC;wBAClC,QAAQ,EAAE,KAAK;wBACf,MAAM;wBACN,UAAU,EAAE,KAAK,CAAC,MAAM;qBACzB,CAAC,CAAC;gBACL,CAAC;gBACD,kBAAkB;gBAClB,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;oBAC5C,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAE,CAAC;oBAC3B,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBACzC,IAAI,CAAC,EAAE,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC;4BACX,IAAI,EAAE,WAAW;4BACjB,KAAK,EAAE,gBAAgB;4BACvB,OAAO,EAAE,oBAAoB,WAAW,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG;4BACxE,YAAY,EAAE,EAAE;4BAChB,UAAU,EAAE,EAAE;4BACd,SAAS,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC;4BAC9C,MAAM,EAAE,CAAC,CAAC,MAAM;4BAChB,UAAU,EAAE,CAAC,CAAC,UAAU;4BACxB,eAAe,EAAE,CAAC,CAAC,eAAe;yBACnC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAe,EACf,IAAU;IAEV,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAE/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,OAAO;iBAClB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBACzC,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,aAAa,OAAO,CAAC,MAAM,YAAY,KAAK,GAAG,MAAM,6EAA6E;qBAC1J;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAE3B,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC1D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,mBAAmB,IAAI,CAAC,QAAQ,+IAA+I;qBACtL;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,GAAc,CAAC;QACnB,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAmC,EAAE,CAAC;YACpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC,QAAQ;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC5D,GAAG,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;gBACvC,IAAI,CAAC,QAAQ;gBACb,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;YAC3D,GAAG,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAExC,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC;QAC3D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,WAAW,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,eAAe,UAAU,QAAQ,UAAU,IAAI;iBAC/F;aACF;SACF,CAAC;IACJ,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-guide.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { WanderlogError, WanderlogValidationError } from "../errors.js";
+import { formatTrip } from "../formatters/trip-summary.js";
+import { resolveDay } from "../resolvers/day.js";
+export const getGuideInputSchema = {
+    guide_key: z
+        .string()
+        .min(1)
+        .describe("Guide's viewKey (the 'guide_key' returned by wanderlog_search_guides, e.g. 'hejurejdks')."),
+    day: z
+        .string()
+        .optional()
+        .describe("Optional day filter — pass a day heading or date to scope the output to one day."),
+    response_format: z
+        .enum(["concise", "detailed"])
+        .default("concise")
+        .describe("Output verbosity. 'concise' is a readable summary; 'detailed' adds addresses, phone numbers, ratings."),
+};
+export const getGuideDescription = `
+Fetches the full content of a public Wanderlog guide — sections, places, and notes — and
+renders it as readable text. Pass the guide_key from a wanderlog_search_guides response.
+
+For your own trips, use wanderlog_get_trip instead.
+`.trim();
+export async function getGuide(ctx, args) {
+    try {
+        if (!args.guide_key || args.guide_key.trim().length === 0) {
+            throw new WanderlogValidationError("guide_key is required");
+        }
+        const trip = await ctx.rest.getGuideContent(args.guide_key);
+        const day = args.day ? resolveDay(trip, args.day) : undefined;
+        const text = formatTrip(trip, args.response_format ?? "concise", day);
+        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-guide.js.map