@mseep/wanderlog-mcp 0.3.1

package/dist/ot/apply.js

@@ -0,0 +1,282 @@
+import { WanderlogError } from "../errors.js";
+function pathInvalid(path, reason) {
+    const rendered = path.map((p) => JSON.stringify(p)).join(", ");
+    throw new WanderlogError(`JSON0 op path [${rendered}] is invalid: ${reason}`, "ot_path_invalid", "Verify the op path matches the current document shape (parent containers must exist and have the correct type).");
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function navigateParent(doc, path) {
+    let current = doc;
+    for (let i = 0; i < path.length - 1; i++) {
+        const key = path[i];
+        if (Array.isArray(current)) {
+            if (typeof key !== "number") {
+                pathInvalid(path, `expected numeric index at position ${i}, got ${typeof key}`);
+            }
+            if (key < 0 || key >= current.length) {
+                pathInvalid(path, `array index ${key} out of bounds at position ${i}`);
+            }
+            current = current[key];
+        }
+        else if (isObject(current)) {
+            if (typeof key !== "string") {
+                pathInvalid(path, `expected string key at position ${i}, got ${typeof key}`);
+            }
+            if (!(key in current)) {
+                pathInvalid(path, `key "${key}" missing on parent object at position ${i}`);
+            }
+            current = current[key];
+        }
+        else {
+            pathInvalid(path, `cannot traverse into non-container at position ${i}`);
+        }
+    }
+    if (!isObject(current) && !Array.isArray(current)) {
+        pathInvalid(path, "parent of target is not an object or array");
+    }
+    return current;
+}
+/**
+ * Apply a Quill Delta "rich-text" subtype op to a QuillDelta field.
+ *
+ * Quill Delta compose semantics: walk through the incoming ops in order.
+ * `retain(n)` skips n characters, `insert(s)` inserts text, `delete(n)`
+ * removes n characters. We rebuild the delta's plain-text string, then
+ * write back a new `{ops: [{insert: result}]}`.
+ *
+ * This is intentionally simplified — we flatten the existing delta to
+ * plain text, apply the transform, and produce a single-insert delta.
+ * Formatting attributes on the original text are lost, which is acceptable
+ * because our tools only create plain-text notes. Remote rich-text edits
+ * from the UI that carry attributes will lose formatting in our cache, but
+ * the server holds the authoritative version.
+ */
+function applyRichTextOp(parent, key, payload) {
+    const target = Array.isArray(parent)
+        ? parent[key]
+        : parent[key];
+    // Extract current plain text from the QuillDelta
+    let current = "";
+    if (target && typeof target === "object" && "ops" in target) {
+        const ops = target.ops;
+        if (Array.isArray(ops)) {
+            current = ops
+                .map((op) => (typeof op.insert === "string" ? op.insert : ""))
+                .join("");
+        }
+    }
+    // Apply the delta ops to the current text
+    if (!Array.isArray(payload))
+        return;
+    let pos = 0;
+    let result = current;
+    for (const dop of payload) {
+        if (typeof dop.retain === "number") {
+            pos += dop.retain;
+        }
+        else if (typeof dop.insert === "string") {
+            result = result.slice(0, pos) + dop.insert + result.slice(pos);
+            pos += dop.insert.length;
+        }
+        else if (typeof dop.delete === "number") {
+            result = result.slice(0, pos) + result.slice(pos + dop.delete);
+        }
+    }
+    const newDelta = { ops: [{ insert: result }] };
+    if (Array.isArray(parent)) {
+        parent[key] = newDelta;
+    }
+    else {
+        parent[key] = newDelta;
+    }
+}
+function applySingleOp(doc, op) {
+    const { p } = op;
+    if (p.length === 0) {
+        if ("r" in op) {
+            pathInvalid(p, "whole-document replacement at empty path is not supported");
+        }
+        pathInvalid(p, "op path must not be empty");
+    }
+    // ShareDB subtype ops — the `t` field names the subtype, `o` is its payload.
+    // We support "rich-text" (Quill Delta compose); unknown subtypes are skipped
+    // so remote ops from the UI don't crash our cache.
+    if ("t" in op && op.t !== undefined) {
+        const parent = navigateParent(doc, p);
+        const last = p[p.length - 1];
+        if (op.t === "rich-text") {
+            applyRichTextOp(parent, last, op.o);
+        }
+        // Unknown subtypes: silently skip rather than crash.
+        return;
+    }
+    if ("r" in op) {
+        if (p.length === 0) {
+            pathInvalid(p, "replace at empty path is not supported");
+        }
+        const parent = navigateParent(doc, p);
+        const last = p[p.length - 1];
+        if (Array.isArray(parent)) {
+            if (typeof last !== "number") {
+                pathInvalid(p, "expected numeric index for replace on array");
+            }
+            if (last < 0 || last >= parent.length) {
+                pathInvalid(p, `array index ${last} out of bounds for replace`);
+            }
+            parent[last] = op.r;
+        }
+        else {
+            if (typeof last !== "string") {
+                pathInvalid(p, "expected string key for replace on object");
+            }
+            parent[last] = op.r;
+        }
+        return;
+    }
+    if ("na" in op && op.na !== undefined) {
+        const parent = navigateParent(doc, p);
+        const last = p[p.length - 1];
+        const current = Array.isArray(parent)
+            ? typeof last === "number"
+                ? parent[last]
+                : pathInvalid(p, "expected numeric index for na on array")
+            : typeof last === "string"
+                ? parent[last]
+                : pathInvalid(p, "expected string key for na on object");
+        if (typeof current !== "number") {
+            pathInvalid(p, `na target is not a number (got ${typeof current})`);
+        }
+        const next = current + op.na;
+        if (Array.isArray(parent)) {
+            parent[last] = next;
+        }
+        else {
+            parent[last] = next;
+        }
+        return;
+    }
+    if ("si" in op || "sd" in op) {
+        const idx = p[p.length - 1];
+        if (typeof idx !== "number") {
+            pathInvalid(p, "string op requires numeric index as final path element");
+        }
+        if (p.length < 2) {
+            pathInvalid(p, "string op path must contain at least the string key and an index");
+        }
+        const stringKey = p[p.length - 2];
+        const stringParent = navigateParent(doc, p.slice(0, -1));
+        const current = Array.isArray(stringParent)
+            ? typeof stringKey === "number"
+                ? stringParent[stringKey]
+                : pathInvalid(p, "expected numeric index for string container in array")
+            : typeof stringKey === "string"
+                ? stringParent[stringKey]
+                : pathInvalid(p, "expected string key for string container in object");
+        if (typeof current !== "string") {
+            pathInvalid(p, `string op target is not a string (got ${typeof current})`);
+        }
+        let updated = current;
+        if ("sd" in op && op.sd !== undefined) {
+            const slice = updated.slice(idx, idx + op.sd.length);
+            if (slice !== op.sd) {
+                pathInvalid(p, `sd verification failed: expected "${op.sd}" at index ${idx}, found "${slice}"`);
+            }
+            updated = updated.slice(0, idx) + updated.slice(idx + op.sd.length);
+        }
+        if ("si" in op && op.si !== undefined) {
+            updated = updated.slice(0, idx) + op.si + updated.slice(idx);
+        }
+        if (Array.isArray(stringParent)) {
+            stringParent[stringKey] = updated;
+        }
+        else {
+            stringParent[stringKey] = updated;
+        }
+        return;
+    }
+    const parent = navigateParent(doc, p);
+    const last = p[p.length - 1];
+    const hasLd = "ld" in op && op.ld !== undefined;
+    const hasLi = "li" in op && op.li !== undefined;
+    const hasLm = "lm" in op && op.lm !== undefined;
+    const hasOi = "oi" in op && op.oi !== undefined;
+    const hasOd = "od" in op && op.od !== undefined;
+    if (hasLd || hasLi || hasLm) {
+        if (!Array.isArray(parent)) {
+            pathInvalid(p, "list op target parent is not an array");
+        }
+        if (typeof last !== "number") {
+            pathInvalid(p, "list op requires numeric final path element");
+        }
+        if (hasLm) {
+            const from = last;
+            const to = op.lm;
+            if (from < 0 || from >= parent.length) {
+                pathInvalid(p, `lm source index ${from} out of bounds`);
+            }
+            if (to < 0 || to >= parent.length) {
+                pathInvalid(p, `lm destination index ${to} out of bounds`);
+            }
+            const [item] = parent.splice(from, 1);
+            parent.splice(to, 0, item);
+            return;
+        }
+        if (hasLd) {
+            if (last < 0 || last >= parent.length) {
+                pathInvalid(p, `ld index ${last} out of bounds`);
+            }
+            const existing = parent[last];
+            if (op.ld !== null && JSON.stringify(existing) !== JSON.stringify(op.ld)) {
+                throw new WanderlogError(`JSON0 ld verification failed at path [${p.join(", ")}]: existing element does not match provided ld value`, "ot_path_invalid", "The cached document drifted from the server snapshot. Refresh the trip before retrying.");
+            }
+            if (hasLi) {
+                parent[last] = op.li;
+            }
+            else {
+                parent.splice(last, 1);
+            }
+            return;
+        }
+        if (hasLi) {
+            if (last < 0 || last > parent.length) {
+                pathInvalid(p, `li index ${last} out of bounds`);
+            }
+            parent.splice(last, 0, op.li);
+            return;
+        }
+    }
+    if (hasOi || hasOd) {
+        if (!isObject(parent)) {
+            pathInvalid(p, "object op target parent is not an object");
+        }
+        if (typeof last !== "string") {
+            pathInvalid(p, "object op requires string final path element");
+        }
+        if (hasOd) {
+            if (!(last in parent)) {
+                pathInvalid(p, `od key "${last}" missing from parent object`);
+            }
+            if (hasOi) {
+                parent[last] = op.oi;
+            }
+            else {
+                delete parent[last];
+            }
+            return;
+        }
+        if (hasOi) {
+            parent[last] = op.oi;
+            return;
+        }
+    }
+    pathInvalid(p, "op contains no recognized action field");
+}
+export function applyOp(doc, ops) {
+    const next = structuredClone(doc);
+    for (const op of ops) {
+        applySingleOp(next, op);
+    }
+    return next;
+}
+//# sourceMappingURL=apply.js.map

package/dist/ot/apply.js.map

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

package/dist/resolvers/day.js

@@ -0,0 +1,83 @@
+import { WanderlogValidationError } from "../errors.js";
+const MONTHS = {
+    jan: 1, january: 1,
+    feb: 2, february: 2,
+    mar: 3, march: 3,
+    apr: 4, april: 4,
+    may: 5,
+    jun: 6, june: 6,
+    jul: 7, july: 7,
+    aug: 8, august: 8,
+    sep: 9, sept: 9, september: 9,
+    oct: 10, october: 10,
+    nov: 11, november: 11,
+    dec: 12, december: 12,
+};
+/**
+ * Given a trip and a natural-language day reference, returns the section
+ * matching that day. Accepts "day 2", "May 4", "2026-05-04".
+ * Throws WanderlogValidationError with helpful message if unresolvable.
+ */
+export function resolveDay(trip, ref) {
+    const daySections = getDaySections(trip);
+    const trimmed = ref.trim().toLowerCase();
+    if (daySections.length === 0) {
+        throw new WanderlogValidationError(`Trip "${trip.title}" has no day-by-day plan`, "This trip does not yet have per-day sections to target.");
+    }
+    const isoMatch = /^(\d{4})-(\d{2})-(\d{2})$/.exec(trimmed);
+    if (isoMatch) {
+        const iso = trimmed;
+        const section = daySections.find((s) => s.date === iso);
+        if (!section) {
+            throw outOfRange(trip, `no day matches ${iso}`);
+        }
+        return section;
+    }
+    const dayNumMatch = /^day\s*(\d+)$/.exec(trimmed);
+    if (dayNumMatch) {
+        const n = Number.parseInt(dayNumMatch[1], 10);
+        if (n < 1 || n > daySections.length) {
+            throw outOfRange(trip, `you asked for day ${n}`);
+        }
+        return daySections[n - 1];
+    }
+    const plainNum = /^\d+$/.test(trimmed) ? Number.parseInt(trimmed, 10) : null;
+    if (plainNum !== null) {
+        if (plainNum < 1 || plainNum > daySections.length) {
+            throw outOfRange(trip, `you asked for day ${plainNum}`);
+        }
+        return daySections[plainNum - 1];
+    }
+    const monthDayMatch = /^([a-z]+)\s+(\d{1,2})$/.exec(trimmed);
+    if (monthDayMatch) {
+        const monthName = monthDayMatch[1];
+        const day = Number.parseInt(monthDayMatch[2], 10);
+        const month = MONTHS[monthName];
+        if (!month) {
+            throw new WanderlogValidationError(`Unknown month "${monthName}" in day reference "${ref}"`, 'Try a format like "day 2", "May 4", or "2026-05-04".');
+        }
+        const year = new Date(trip.startDate).getUTCFullYear();
+        const iso = `${year}-${pad(month)}-${pad(day)}`;
+        const section = daySections.find((s) => s.date === iso);
+        if (!section) {
+            throw outOfRange(trip, `${monthName} ${day} is not in this trip`);
+        }
+        return section;
+    }
+    throw new WanderlogValidationError(`Could not understand day reference "${ref}"`, 'Try a format like "day 2", "May 4", or "2026-05-04".');
+}
+export function getDaySections(trip) {
+    return trip.itinerary.sections.filter((s) => s.mode === "dayPlan" && s.date);
+}
+function pad(n) {
+    return n < 10 ? `0${n}` : `${n}`;
+}
+function outOfRange(trip, detail) {
+    return new WanderlogValidationError(`Day reference out of range: ${detail}`, {
+        hint: `Trip "${trip.title}" runs ${trip.startDate} to ${trip.endDate} (${trip.days} days).`,
+        followUps: [
+            `Call wanderlog_get_trip with trip_key "${trip.key}" (no day filter) to see the available dates, then retry with a valid day.`,
+        ],
+    });
+}
+//# sourceMappingURL=day.js.map

package/dist/resolvers/day.js.map

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

package/dist/resolvers/place-ref.js

@@ -0,0 +1,194 @@
+import { isPlaceBlock } from "../types.js";
+import { resolveDay } from "./day.js";
+const MAX_AMBIGUOUS_CANDIDATES = 10;
+const HOTEL_KEYWORDS = new Set(["the hotel", "hotel", "my hotel"]);
+const FLIGHT_KEYWORDS = new Set(["the flight", "flight", "my flight"]);
+const TRAIN_KEYWORDS = new Set(["the train", "train", "my train"]);
+const WORD_ORDINALS = {
+    first: 1,
+    second: 2,
+    third: 3,
+    fourth: 4,
+    fifth: 5,
+    sixth: 6,
+    seventh: 7,
+    eighth: 8,
+    ninth: 9,
+    tenth: 10,
+};
+/**
+ * Detects an ordinal prefix on a normalized ref. Returns the 1-based position
+ * (or "last") and the remaining ref with the ordinal stripped. Handles:
+ *   - numeric suffixes: "1st X", "2nd X", "3rd X", "4th X", ...
+ *   - word ordinals: "first X", "second X", ..., "tenth X"
+ *   - "last X"
+ *
+ * Returns null if no ordinal prefix is present.
+ */
+export function parseOrdinal(ref) {
+    if (ref.startsWith("last ")) {
+        const rest = ref.slice(5).trim();
+        if (rest)
+            return { position: "last", rest };
+    }
+    const numMatch = /^(\d+)(?:st|nd|rd|th)\s+(.+)$/.exec(ref);
+    if (numMatch) {
+        const n = Number.parseInt(numMatch[1], 10);
+        if (n >= 1)
+            return { position: n, rest: numMatch[2].trim() };
+    }
+    const wordMatch = /^([a-z]+)\s+(.+)$/.exec(ref);
+    if (wordMatch) {
+        const word = wordMatch[1];
+        const n = WORD_ORDINALS[word];
+        if (n !== undefined)
+            return { position: n, rest: wordMatch[2].trim() };
+    }
+    return null;
+}
+/**
+ * Resolves a free-form natural-language reference to a block in a trip.
+ *
+ * Strategy order (short-circuits on the first stage that yields candidates):
+ *   0. Ordinal prefix ("1st X", "2nd X", "last X", "third X") — strips the
+ *      ordinal, resolves the rest via the normal flow, then picks the N-th
+ *      (or last) candidate from the resulting list. Combines with compound
+ *      refs: "2nd Queenstown Gardens on day 4" is valid.
+ *   1. Compound "<thing> on <context>" — left side resolved by stages 2-4,
+ *      then filtered to candidates whose parent section matches the context
+ *      (currently only day references are understood on the right).
+ *   2. Role keywords ("the hotel", "the flight", "the train") — first block
+ *      in the appropriate role section.
+ *   3. Exact (case-insensitive) match against `block.place.name`.
+ *   4. Substring (case-insensitive) match against `block.place.name`.
+ *
+ * Diacritics are not normalized: "Senso-ji" will not match "Sensō-ji".
+ * Whitespace is collapsed and trimmed before matching.
+ */
+export function resolvePlaceRef(trip, ref) {
+    const normalized = normalize(ref);
+    if (!normalized) {
+        return { kind: "none" };
+    }
+    const sections = trip.itinerary.sections;
+    if (sections.length === 0) {
+        return { kind: "none" };
+    }
+    const ordinal = parseOrdinal(normalized);
+    const body = ordinal ? ordinal.rest : normalized;
+    const compound = splitCompound(body);
+    const candidates = compound
+        ? filterByContext(trip, findByLeftSide(trip, compound.left), compound.right)
+        : findByLeftSide(trip, body);
+    if (ordinal) {
+        if (candidates.length === 0)
+            return { kind: "none" };
+        const index = ordinal.position === "last" ? candidates.length - 1 : ordinal.position - 1;
+        if (index < 0 || index >= candidates.length) {
+            return { kind: "none" };
+        }
+        return { kind: "unique", match: candidates[index] };
+    }
+    return finalize(candidates);
+}
+function findByLeftSide(trip, ref) {
+    const roleMatches = matchRoleKeyword(trip, ref);
+    if (roleMatches.length > 0) {
+        return roleMatches;
+    }
+    const exact = matchPlaceName(trip, ref, "exact");
+    if (exact.length > 0) {
+        return exact;
+    }
+    return matchPlaceName(trip, ref, "substring");
+}
+function matchRoleKeyword(trip, ref) {
+    if (HOTEL_KEYWORDS.has(ref)) {
+        return firstBlockOfSectionType(trip, (s) => s.type === "hotels");
+    }
+    if (FLIGHT_KEYWORDS.has(ref)) {
+        return firstBlockOfSectionType(trip, (s) => s.type === "flights");
+    }
+    if (TRAIN_KEYWORDS.has(ref)) {
+        return firstBlockOfSectionType(trip, (s) => s.type === "transit", (b) => b.type === "train");
+    }
+    return [];
+}
+function firstBlockOfSectionType(trip, sectionPredicate, blockPredicate) {
+    const sections = trip.itinerary.sections;
+    for (let sectionIndex = 0; sectionIndex < sections.length; sectionIndex++) {
+        const section = sections[sectionIndex];
+        if (!sectionPredicate(section))
+            continue;
+        for (let blockIndex = 0; blockIndex < section.blocks.length; blockIndex++) {
+            const block = section.blocks[blockIndex];
+            if (blockPredicate && !blockPredicate(block))
+                continue;
+            return [{ sectionIndex, blockIndex, section, block }];
+        }
+    }
+    return [];
+}
+function matchPlaceName(trip, ref, mode) {
+    const matches = [];
+    const sections = trip.itinerary.sections;
+    for (let sectionIndex = 0; sectionIndex < sections.length; sectionIndex++) {
+        const section = sections[sectionIndex];
+        for (let blockIndex = 0; blockIndex < section.blocks.length; blockIndex++) {
+            const block = section.blocks[blockIndex];
+            if (!isPlaceBlock(block))
+                continue;
+            const name = normalize(block.place.name ?? "");
+            if (!name)
+                continue;
+            const hit = mode === "exact" ? name === ref : name.includes(ref);
+            if (hit) {
+                matches.push({ sectionIndex, blockIndex, section, block });
+            }
+        }
+    }
+    return matches;
+}
+function splitCompound(ref) {
+    const idx = ref.indexOf(" on ");
+    if (idx < 0)
+        return null;
+    const left = ref.slice(0, idx).trim();
+    const right = ref.slice(idx + 4).trim();
+    if (!left || !right)
+        return null;
+    return { left, right };
+}
+function filterByContext(trip, candidates, context) {
+    if (candidates.length === 0)
+        return candidates;
+    const contextSection = tryResolveDay(trip, context);
+    if (contextSection) {
+        return candidates.filter((c) => c.section === contextSection);
+    }
+    return [];
+}
+function tryResolveDay(trip, ref) {
+    try {
+        return resolveDay(trip, ref);
+    }
+    catch {
+        return null;
+    }
+}
+function finalize(candidates) {
+    if (candidates.length === 0)
+        return { kind: "none" };
+    if (candidates.length === 1)
+        return { kind: "unique", match: candidates[0] };
+    return {
+        kind: "ambiguous",
+        candidates: candidates.slice(0, MAX_AMBIGUOUS_CANDIDATES),
+    };
+}
+function normalize(s) {
+    // Collapse runs of whitespace and punctuation dashes (hyphens, en/em-dashes)
+    // so "Roppongi Hills - Tokyo City View" matches "Roppongi Hills Tokyo City View".
+    return s.replace(/[\s\-–—]+/g, " ").trim().toLowerCase();
+}
+//# sourceMappingURL=place-ref.js.map

package/dist/resolvers/place-ref.js.map

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