wanderlog-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shaikhspeare
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,256 @@
+# wanderlog-mcp
+
+[![npm](https://img.shields.io/npm/v/wanderlog-mcp)](https://www.npmjs.com/package/wanderlog-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/wanderlog-mcp)](https://www.npmjs.com/package/wanderlog-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://nodejs.org/)
+
+An MCP server that lets Claude (or any MCP-compatible agent) view and build [Wanderlog](https://wanderlog.com) trip itineraries through conversation.
+
+Instead of clicking through the Wanderlog UI to plan a trip, you just ask:
+
+> *"Create a 14-day Japan Golden Route trip — Tokyo, Hakone, Kyoto, Nara, and Osaka."*
+
+The agent calls the tools, interleaves places and notes for each day, adds hotel blocks and checklists, and you end up with a fully populated Wanderlog trip in a few minutes.
+
+**See a real example:** [14-day Japan Golden Route](https://wanderlog.com/view/dmvegdhqsa/japan-golden-route--tokyo--hakone--kyoto--nara--osaka) — built entirely by an AI agent using this MCP server.
+
+## What's New in v0.1.0
+
+- Full itinerary building: places, notes, hotels, and checklists in a single conversation
+- `wanderlog_search_places` — find real-world places near any destination using Wanderlog's place database
+- `wanderlog_add_note` — interleave transit tips, booking info, and local advice between places
+- `wanderlog_add_checklist` — pre-trip and per-day checklists (visa, currency, timed-entry tickets)
+- MCP server instructions injected at startup so Claude builds complete itineraries automatically
+- Startup auth probe — catches expired cookies immediately instead of failing mid-conversation
+
+## Example Prompts
+
+```
+"What trips do I have in Wanderlog?"
+```
+```
+"Create a 7-day itinerary for Lisbon starting June 1 — include restaurants, day trips,
+and a hotel near the waterfront."
+```
+```
+"Add a day trip to Sintra on day 3 of my Lisbon trip."
+```
+```
+"I'm spending 5 days in Tokyo — build me a full itinerary with museum visits, ramen spots,
+and a ryokan in Shinjuku."
+```
+```
+"Look at my Barcelona trip and add practical notes for getting between each place."
+```
+```
+"Add a pre-trip checklist to my Paris trip — visa, currency, offline maps, travel insurance."
+```
+```
+"Move my Rome trip back by two weeks."
+```
+```
+"Give me the shareable link to my Kyoto itinerary."
+```
+```
+"Remove the Colosseum from day 2 of my Rome trip."
+```
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `wanderlog_list_trips` | List trips in your account |
+| `wanderlog_get_trip` | View a full itinerary, or filter to a single day |
+| `wanderlog_get_trip_url` | Get a shareable wanderlog.com link |
+| `wanderlog_search_places` | Find real-world places near a trip's destination |
+| `wanderlog_create_trip` | Create a new trip with destination + date range |
+| `wanderlog_add_place` | Add a place to a specific day or general list |
+| `wanderlog_add_note` | Add a note (transit tips, booking info, local advice) |
+| `wanderlog_add_hotel` | Add a hotel booking with check-in/check-out dates |
+| `wanderlog_add_checklist` | Add a pre-trip or per-day checklist |
+| `wanderlog_remove_place` | Remove a place by natural-language reference |
+| `wanderlog_update_trip_dates` | Change a trip's date range |
+
+## Prerequisites
+
+- **Node.js 22 or newer**
+- **A [Wanderlog](https://wanderlog.com) account**
+- An MCP-compatible client: Claude Code, Claude Desktop, OpenAI Codex, Cursor, VS Code, or any stdio MCP host
+
+## Setup
+
+### Step 1 — Get your Wanderlog session cookie
+
+Wanderlog doesn't have a public API, so wanderlog-mcp authenticates using your browser session cookie (`connect.sid`). It's valid for roughly a year and never leaves your machine.
+
+**Treat it like a password** — it grants the same access you have in the Wanderlog UI.
+
+#### Chrome / Edge
+
+1. Go to [wanderlog.com](https://wanderlog.com) and log in
+2. Press `F12` to open DevTools
+3. Click the **Application** tab
+4. In the left sidebar expand **Storage → Cookies → https://wanderlog.com**
+5. Find the row where **Name** is `connect.sid`
+6. Click the row, then double-click the **Value** cell and copy the full string — it starts with `s%3A` and is ~100 characters long
+
+#### Firefox
+
+1. Go to [wanderlog.com](https://wanderlog.com) and log in
+2. Press `F12` to open DevTools
+3. Click the **Storage** tab
+4. In the left sidebar expand **Cookies → https://wanderlog.com**
+5. Find `connect.sid` in the table, click it, and copy the **Value**
+
+> **Why can't I use `document.cookie` in the console?**
+> Wanderlog sets `connect.sid` with the `HttpOnly` flag, which deliberately blocks JavaScript from reading it (XSS protection). DevTools bypasses this restriction — that's why it works and the console doesn't.
+
+### Step 2 — Configure your MCP client
+
+#### Claude Code
+
+```bash
+claude mcp add wanderlog-mcp npx wanderlog-mcp \
+  --env WANDERLOG_COOKIE="s%3A...your value here..."
+```
+
+#### Claude Desktop
+
+Edit `claude_desktop_config.json`:
+
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux:** `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "wanderlog": {
+      "command": "npx",
+      "args": ["wanderlog-mcp"],
+      "env": {
+        "WANDERLOG_COOKIE": "s%3A...your value here..."
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop after saving.
+
+#### Cursor
+
+Settings → MCP → Add server, or edit `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "wanderlog": {
+      "command": "npx",
+      "args": ["wanderlog-mcp"],
+      "env": {
+        "WANDERLOG_COOKIE": "s%3A...your value here..."
+      }
+    }
+  }
+}
+```
+
+#### VS Code (GitHub Copilot)
+
+Add to your workspace `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "wanderlog": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["wanderlog-mcp"],
+      "env": {
+        "WANDERLOG_COOKIE": "s%3A...your value here..."
+      }
+    }
+  }
+}
+```
+
+#### OpenAI Codex
+
+Edit `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.wanderlog]
+command = "npx"
+args = ["wanderlog-mcp"]
+
+[mcp_servers.wanderlog.env]
+WANDERLOG_COOKIE = "s%3A...your value here..."
+```
+
+Run `/mcp` inside Codex to confirm the server loaded.
+
+#### Smithery (one-click install)
+
+```bash
+npx @smithery/cli install wanderlog-mcp --client claude
+```
+
+### Step 3 — Verify
+
+Ask your agent: *"What trips do I have in Wanderlog?"*
+
+It should call `wanderlog_list_trips` and return your account's trips. If it fails, see [Troubleshooting](#troubleshooting) below.
+
+## Refreshing your cookie
+
+The cookie lasts about a year but can die sooner if you log out of wanderlog.com, change your password, or Wanderlog revokes the session. When that happens every tool call returns:
+
+> **Wanderlog session invalid or expired** — Capture a fresh connect.sid cookie from wanderlog.com DevTools and update WANDERLOG_COOKIE in your MCP config.
+
+Repeat Step 1 above, update your config, and restart your MCP client.
+
+## Troubleshooting
+
+**Server starts but list_trips returns an auth error**
+Your cookie is expired or wrong. Re-capture it from DevTools and update your config.
+
+**`npx wanderlog-mcp` hangs or does nothing**
+The server speaks stdio MCP — it's designed to be launched by an MCP host, not run directly in a terminal. Run it through Claude Code or Claude Desktop as described above.
+
+**Tools work but the agent ignores notes/checklists**
+The server injects instructions into the MCP `initialize` response that tell the agent to interleave places and notes and add checklists. This works reliably with Claude. Other clients may vary.
+
+## Security
+
+- The cookie is stored only in your MCP client config, never committed or logged
+- wanderlog-mcp runs entirely on your machine — there's no relay server
+- The startup auth probe validates your cookie without printing its value
+- To revoke access: log out of wanderlog.com (invalidates all sessions), then re-capture
+
+## Contributing
+
+Pull requests are welcome. Before submitting:
+
+```bash
+npm run build && npm run test
+```
+
+For changes to transport or tool code, also run:
+
+```bash
+npm run test:integration
+```
+
+## Disclaimer
+
+wanderlog-mcp is an unofficial third-party tool, not affiliated with or endorsed by Wanderlog. It works by calling Wanderlog's private web-client API, which may change without notice. Use at your own risk.
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+
+---
+
+Made by [shaikhspeare](https://github.com/shaikhspeare)

package/dist/cache/trip-cache.js

@@ -0,0 +1,87 @@
+import { applyOp } from "../ot/apply.js";
+/**
+ * Live trip cache. On first access, validates the trip exists via REST
+ * (fast 404 path for bad keys), then subscribes via ShareDBPool for live
+ * updates. Incoming remote ops are applied to the cached doc so reads stay
+ * current without refetching.
+ *
+ * Callers can read `entry.snapshot` and `entry.version` to prepare submit
+ * ops with the correct version vector.
+ */
+export class TripCache {
+    rest;
+    pool;
+    entries = new Map();
+    subscribing = new Map();
+    constructor(rest, pool) {
+        this.rest = rest;
+        this.pool = pool;
+    }
+    async get(tripKey) {
+        const entry = await this.ensureEntry(tripKey);
+        return entry.snapshot;
+    }
+    async getEntry(tripKey) {
+        return this.ensureEntry(tripKey);
+    }
+    async ensureEntry(tripKey) {
+        const existing = this.entries.get(tripKey);
+        if (existing)
+            return existing;
+        const pending = this.subscribing.get(tripKey);
+        if (pending)
+            return pending;
+        const promise = this.subscribeAndCache(tripKey);
+        this.subscribing.set(tripKey, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            this.subscribing.delete(tripKey);
+        }
+    }
+    async subscribeAndCache(tripKey) {
+        // REST pre-check: fails fast with 404 → WanderlogNotFoundError.
+        // Without this, a bogus trip key hangs on the WS subscribe timeout.
+        // The response also gives us the trip's associated geos, which the
+        // WebSocket snapshot doesn't include — we store them for search biasing.
+        const { geos } = await this.rest.getTripWithResources(tripKey);
+        const client = this.pool.get(tripKey);
+        const snapshot = await client.subscribe();
+        const entry = { snapshot, version: client.version, geos };
+        this.entries.set(tripKey, entry);
+        client.on("remoteOp", (ops, version) => {
+            const current = this.entries.get(tripKey);
+            if (!current)
+                return;
+            try {
+                current.snapshot = applyOp(current.snapshot, ops);
+                current.version = version;
+            }
+            catch {
+                // If a remote op fails to apply to our snapshot, our view is stale.
+                // Drop the entry; next get() re-subscribes from a fresh snapshot.
+                this.entries.delete(tripKey);
+            }
+        });
+        return entry;
+    }
+    /**
+     * Called after submitting an op ourselves. Applies the op locally and
+     * bumps the version so the cache matches what the server just accepted.
+     */
+    applyLocalOp(tripKey, ops, newVersion) {
+        const entry = this.entries.get(tripKey);
+        if (!entry)
+            return;
+        entry.snapshot = applyOp(entry.snapshot, ops);
+        entry.version = newVersion;
+    }
+    invalidate(tripKey) {
+        this.entries.delete(tripKey);
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=trip-cache.js.map

package/dist/cache/trip-cache.js.map

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

package/dist/config.js

@@ -0,0 +1,38 @@
+import { WanderlogValidationError } from "./errors.js";
+const DEFAULT_USER_AGENT = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36";
+/**
+ * Normalizes a cookie value into a valid Cookie header.
+ *
+ * Accepts:
+ *   - `s%3A...`                           → wraps as `connect.sid=s%3A...`
+ *   - `connect.sid=s%3A...`               → passes through
+ *   - `connect.sid=s%3A...; other=x`      → passes through
+ *
+ * Rejects empty strings and obviously malformed values.
+ */
+export function normalizeCookie(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) {
+        throw new WanderlogValidationError("WANDERLOG_COOKIE is empty", "Set WANDERLOG_COOKIE to the connect.sid cookie value from wanderlog.com.");
+    }
+    if (trimmed.includes("connect.sid=")) {
+        return trimmed;
+    }
+    if (trimmed.startsWith("s%3A") || trimmed.startsWith("s:")) {
+        return `connect.sid=${trimmed}`;
+    }
+    throw new WanderlogValidationError("WANDERLOG_COOKIE does not look like a connect.sid cookie", "Expected a value starting with 's%3A' or 'connect.sid=s%3A'. Copy the exact value from DevTools → Application → Cookies → wanderlog.com → connect.sid.");
+}
+export function loadConfig(env = process.env) {
+    const raw = env.WANDERLOG_COOKIE;
+    if (!raw) {
+        throw new WanderlogValidationError("WANDERLOG_COOKIE environment variable is not set", "Set WANDERLOG_COOKIE in your MCP config. See README for how to capture the cookie.");
+    }
+    return {
+        cookieHeader: normalizeCookie(raw),
+        baseUrl: env.WANDERLOG_BASE_URL ?? "https://wanderlog.com",
+        wsBaseUrl: env.WANDERLOG_WS_BASE_URL ?? "wss://wanderlog.com",
+        userAgent: env.WANDERLOG_USER_AGENT ?? DEFAULT_USER_AGENT,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AASvD,MAAM,kBAAkB,GACtB,uGAAuG,CAAC;AAE1G;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,wBAAwB,CAChC,2BAA2B,EAC3B,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,OAAO,eAAe,OAAO,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,IAAI,wBAAwB,CAChC,0DAA0D,EAC1D,wJAAwJ,CACzJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,wBAAwB,CAChC,kDAAkD,EAClD,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,YAAY,EAAE,eAAe,CAAC,GAAG,CAAC;QAClC,OAAO,EAAE,GAAG,CAAC,kBAAkB,IAAI,uBAAuB;QAC1D,SAAS,EAAE,GAAG,CAAC,qBAAqB,IAAI,qBAAqB;QAC7D,SAAS,EAAE,GAAG,CAAC,oBAAoB,IAAI,kBAAkB;KAC1D,CAAC;AACJ,CAAC"}

package/dist/context.js

@@ -0,0 +1,12 @@
+import { TripCache } from "./cache/trip-cache.js";
+import { loadConfig } from "./config.js";
+import { RestClient } from "./transport/rest.js";
+import { ShareDBPool } from "./transport/sharedb.js";
+export function createContext() {
+    const config = loadConfig();
+    const rest = new RestClient(config);
+    const pool = new ShareDBPool(config);
+    const tripCache = new TripCache(rest, pool);
+    return { config, rest, pool, tripCache };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAWrD,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC3C,CAAC"}

package/dist/errors.js

@@ -0,0 +1,86 @@
+export class WanderlogError extends Error {
+    code;
+    hint;
+    followUps;
+    constructor(message, code, hintOrOptions) {
+        super(message);
+        this.name = "WanderlogError";
+        this.code = code;
+        if (typeof hintOrOptions === "string") {
+            this.hint = hintOrOptions;
+        }
+        else if (hintOrOptions) {
+            this.hint = hintOrOptions.hint;
+            this.followUps = hintOrOptions.followUps;
+        }
+    }
+    /**
+     * Render the error for the calling agent. Includes the hint (human advice)
+     * and a "Next steps" list of suggested follow-up tool calls when present.
+     * Follow-ups are phrased as concrete actions the model can take without
+     * asking the user for more information.
+     */
+    toUserMessage() {
+        const parts = [this.message];
+        if (this.hint)
+            parts.push("", this.hint);
+        if (this.followUps && this.followUps.length > 0) {
+            parts.push("", "Next steps:");
+            for (const step of this.followUps) {
+                parts.push(`• ${step}`);
+            }
+        }
+        return parts.join("\n");
+    }
+}
+export class WanderlogAuthError extends WanderlogError {
+    constructor(message = "Wanderlog session invalid or expired") {
+        super(message, "auth_expired", {
+            hint: "Capture a fresh connect.sid cookie from wanderlog.com DevTools (Application → Cookies) and update WANDERLOG_COOKIE in your MCP config.",
+            followUps: [
+                "Ask the user to refresh WANDERLOG_COOKIE in the MCP config, then restart the server.",
+            ],
+        });
+        this.name = "WanderlogAuthError";
+    }
+}
+export class WanderlogNotFoundError extends WanderlogError {
+    constructor(resource, identifier) {
+        const id = identifier ? ` '${identifier}'` : "";
+        const res = resource.toLowerCase();
+        const options = res === "trip"
+            ? {
+                hint: "Use wanderlog_list_trips to see available trips.",
+                followUps: [
+                    "Call wanderlog_list_trips to find the correct trip_key, then retry this tool with that key.",
+                ],
+            }
+            : res === "place"
+                ? {
+                    hint: "Try a more specific name or use wanderlog_search_places to find the exact place.",
+                    followUps: [
+                        "Call wanderlog_search_places with a broader query to see candidates.",
+                        "Retry this tool with a more specific place name (include the city or neighborhood).",
+                    ],
+                }
+                : {};
+        super(`${resource}${id} not found`, "not_found", options);
+        this.name = "WanderlogNotFoundError";
+    }
+}
+export class WanderlogValidationError extends WanderlogError {
+    constructor(message, hintOrOptions) {
+        super(message, "validation", hintOrOptions);
+        this.name = "WanderlogValidationError";
+    }
+}
+export class WanderlogNetworkError extends WanderlogError {
+    constructor(message) {
+        super(message, "network", {
+            hint: "Check your internet connection and that wanderlog.com is reachable.",
+            followUps: ["Retry the same tool call in a moment."],
+        });
+        this.name = "WanderlogNetworkError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAS;IACb,IAAI,CAAU;IACd,SAAS,CAAY;IAE9B,YACE,OAAe,EACf,IAAY,EACZ,aAAqC;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC5B,CAAC;aAAM,IAAI,aAAa,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;YAC/B,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,aAAa;QACX,MAAM,KAAK,GAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD,YAAY,OAAO,GAAG,sCAAsC;QAC1D,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE;YAC7B,IAAI,EAAE,wIAAwI;YAC9I,SAAS,EAAE;gBACT,sFAAsF;aACvF;SACF,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IACxD,YAAY,QAAgB,EAAE,UAAmB;QAC/C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,OAAO,GACX,GAAG,KAAK,MAAM;YACZ,CAAC,CAAC;gBACE,IAAI,EAAE,kDAAkD;gBACxD,SAAS,EAAE;oBACT,6FAA6F;iBAC9F;aACF;YACH,CAAC,CAAC,GAAG,KAAK,OAAO;gBACf,CAAC,CAAC;oBACE,IAAI,EAAE,kFAAkF;oBACxF,SAAS,EAAE;wBACT,sEAAsE;wBACtE,qFAAqF;qBACtF;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,QAAQ,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAC1D,YAAY,OAAe,EAAE,aAAqC;QAChE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IACvD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE;YACxB,IAAI,EAAE,qEAAqE;YAC3E,SAAS,EAAE,CAAC,uCAAuC,CAAC;SACrD,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}