@tyroneross/bookmark 0.2.0 → 0.3.2

package/dist/mcp/server.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * Bookmark MCP Server
+ *
+ * JSON-RPC 2.0 over stdio (MCP protocol).
+ * Exposes context snapshot tools: snapshot, restore, status, list, show.
+ */
+import { createInterface } from "readline";
+import { TOOLS, handleToolCall } from "./tools.js";
+// --- JSON-RPC transport over stdio ---
+const rl = createInterface({ input: process.stdin, terminal: false });
+let buffer = "";
+rl.on("line", (line) => {
+    buffer += line;
+    try {
+        const msg = JSON.parse(buffer);
+        buffer = "";
+        handleMessage(msg);
+    }
+    catch {
+        // Incomplete JSON, keep buffering
+    }
+});
+function send(msg) {
+    process.stdout.write(JSON.stringify(msg) + "\n");
+}
+function sendResult(id, result) {
+    send({ jsonrpc: "2.0", id, result });
+}
+function sendError(id, code, message) {
+    send({ jsonrpc: "2.0", id, error: { code, message } });
+}
+// --- MCP Protocol ---
+const SERVER_INFO = {
+    name: "bookmark",
+    version: "0.3.2",
+};
+const CAPABILITIES = {
+    tools: {},
+};
+// --- Message handler ---
+async function handleMessage(msg) {
+    if (msg.jsonrpc !== "2.0")
+        return;
+    const { id, method, params } = msg;
+    try {
+        switch (method) {
+            case "initialize": {
+                sendResult(id, {
+                    protocolVersion: "2025-11-25",
+                    serverInfo: SERVER_INFO,
+                    capabilities: CAPABILITIES,
+                });
+                break;
+            }
+            case "notifications/initialized": {
+                // Client acknowledged — no response needed
+                break;
+            }
+            case "tools/list": {
+                sendResult(id, { tools: TOOLS });
+                break;
+            }
+            case "tools/call": {
+                const { name, arguments: args } = params;
+                const result = await handleToolCall(name, args || {});
+                sendResult(id, result);
+                break;
+            }
+            default: {
+                if (id !== undefined) {
+                    sendError(id, -32601, `Method not found: ${method}`);
+                }
+            }
+        }
+    }
+    catch (err) {
+        if (id !== undefined) {
+            sendError(id, -32000, err instanceof Error ? err.message : "Internal error");
+        }
+    }
+}
+// Log to stderr so it doesn't interfere with the protocol
+process.stderr.write("Bookmark MCP server started\n");
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnD,wCAAwC;AAExC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACtE,IAAI,MAAM,GAAG,EAAE,CAAC;AAEhB,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;IACrB,MAAM,IAAI,IAAI,CAAC;IACf,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,GAAG,EAAE,CAAC;QACZ,aAAa,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,SAAS,IAAI,CAAC,GAAY;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,UAAU,CAAC,EAAmB,EAAE,MAAe;IACtD,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,SAAS,CAAC,EAAmB,EAAE,IAAY,EAAE,OAAe;IACnE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,uBAAuB;AAEvB,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,MAAM,YAAY,GAAG;IACnB,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,0BAA0B;AAE1B,KAAK,UAAU,aAAa,CAAC,GAK5B;IACC,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO;IAElC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAEnC,IAAI,CAAC;QACH,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,UAAU,CAAC,EAAG,EAAE;oBACd,eAAe,EAAE,YAAY;oBAC7B,UAAU,EAAE,WAAW;oBACvB,YAAY,EAAE,YAAY;iBAC3B,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YAED,KAAK,2BAA2B,CAAC,CAAC,CAAC;gBACjC,2CAA2C;gBAC3C,MAAM;YACR,CAAC;YAED,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,UAAU,CAAC,EAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClC,MAAM;YACR,CAAC;YAED,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAGjC,CAAC;gBACF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;gBACtD,UAAU,CAAC,EAAG,EAAE,MAAM,CAAC,CAAC;gBACxB,MAAM;YACR,CAAC;YAED,OAAO,CAAC,CAAC,CAAC;gBACR,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;oBACrB,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,qBAAqB,MAAM,EAAE,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,SAAS,CACP,EAAE,EACF,CAAC,KAAK,EACN,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CACtD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC"}

package/dist/mcp/tools.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Bookmark MCP Tool Definitions
+ *
+ * Each tool maps to existing Bookmark programmatic APIs.
+ * Responses are formatted as concise text for LLM consumption.
+ */
+export declare const TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            trigger: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            snapshot_id?: undefined;
+            limit?: undefined;
+        };
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            snapshot_id: {
+                type: string;
+                description: string;
+            };
+            trigger?: undefined;
+            limit?: undefined;
+        };
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            trigger?: undefined;
+            snapshot_id?: undefined;
+            limit?: undefined;
+        };
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            limit: {
+                type: string;
+                description: string;
+            };
+            trigger?: undefined;
+            snapshot_id?: undefined;
+        };
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+})[];
+export declare function handleToolCall(name: string, args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgDH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwGjB,CAAC;AAIF,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAqBhF"}

package/dist/mcp/tools.js

@@ -0,0 +1,304 @@
+/**
+ * Bookmark MCP Tool Definitions
+ *
+ * Each tool maps to existing Bookmark programmatic APIs.
+ * Responses are formatted as concise text for LLM consumption.
+ */
+import { loadConfig, getStoragePath } from "../config.js";
+import { resolveProjectName } from "../registry.js";
+import { captureSnapshot } from "../snapshot/capture.js";
+import { compressToMarkdown } from "../snapshot/compress.js";
+import { loadSnapshot, loadLatestSnapshot, listSnapshots, getSnapshotCount, } from "../snapshot/storage.js";
+import { restoreContext } from "../restore/index.js";
+import { loadState } from "../threshold/state.js";
+import { readContextMd } from "../trails/reader.js";
+import { parseIdentity, validateRepoIdentity } from "../trails/identity.js";
+/**
+ * If the bookmark.context.md at `storagePath` declares a different repo_path
+ * than the current CWD, return a one-line warning to prepend to MCP output.
+ * Returns null when no bookmark file exists, no identity block is present,
+ * or the identity matches.
+ */
+function identityMismatchWarning(storagePath, cwd) {
+    const raw = readContextMd(storagePath);
+    if (!raw)
+        return null;
+    const { identity } = parseIdentity(raw);
+    if (!identity)
+        return null;
+    return validateRepoIdentity(identity, cwd);
+}
+function prefixWarning(warning, body) {
+    return warning ? `${warning}\n\n${body}` : body;
+}
+// --- Response helpers ---
+function textResponse(text) {
+    return { content: [{ type: "text", text }] };
+}
+function errorResponse(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}
+// --- Tool definitions ---
+export const TOOLS = [
+    {
+        name: "snapshot",
+        description: "Capture a context snapshot of the current session. Extracts decisions, open items, file changes, and progress from the transcript. Use before major refactors, before ending a session, or when you want to preserve current context.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                trigger: {
+                    type: "string",
+                    enum: ["manual", "pre_refactor"],
+                    description: "Why the snapshot is being taken (default: 'manual')",
+                },
+            },
+        },
+        annotations: {
+            title: "Capture Snapshot",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "restore",
+        description: "Restore context from the latest or a specific snapshot. Returns the session context including intent, progress, decisions, and open items. Use to recover context after compaction or when resuming work.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                snapshot_id: {
+                    type: "string",
+                    description: "Specific snapshot ID to restore from (default: latest)",
+                },
+            },
+        },
+        annotations: {
+            title: "Restore Context",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "status",
+        description: "Snapshot stats — count, last capture time, freshness, and storage info. Quick overview of the snapshot inventory.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        annotations: {
+            title: "Snapshot Status",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "list",
+        description: "List all snapshots with timestamps, triggers, and context remaining percentage. Most recent first.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    description: "Maximum number of snapshots to return (default: 10)",
+                },
+            },
+        },
+        annotations: {
+            title: "List Snapshots",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: "show",
+        description: "Show full snapshot content — decisions, progress, open items, file changes, and errors. Provides the complete context from a specific or the latest snapshot.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                snapshot_id: {
+                    type: "string",
+                    description: "Snapshot ID to show (default: latest)",
+                },
+            },
+        },
+        annotations: {
+            title: "Show Snapshot",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+];
+// --- Tool handlers ---
+export async function handleToolCall(name, args) {
+    try {
+        switch (name) {
+            case "snapshot":
+                return await handleSnapshot(args);
+            case "restore":
+                return await handleRestore(args);
+            case "status":
+                return await handleStatus();
+            case "list":
+                return await handleList(args);
+            case "show":
+                return await handleShow(args);
+            default:
+                return errorResponse(`Unknown tool: ${name}`);
+        }
+    }
+    catch (err) {
+        return errorResponse(err instanceof Error ? err.message : "Tool execution failed");
+    }
+}
+async function handleSnapshot(args) {
+    const cwd = process.cwd();
+    const trigger = args.trigger || "manual";
+    // Find the transcript file — look in standard Claude Code location
+    const transcriptDir = process.env.CLAUDE_TRANSCRIPT_DIR;
+    const sessionId = process.env.CLAUDE_SESSION_ID || "unknown";
+    if (!transcriptDir) {
+        return errorResponse("Cannot capture snapshot: CLAUDE_TRANSCRIPT_DIR not available. Snapshots require an active Claude Code session with transcript access.");
+    }
+    const fs = await import("fs");
+    const path = await import("path");
+    // Find the most recent transcript file
+    let transcriptPath = "";
+    try {
+        const files = fs.readdirSync(transcriptDir)
+            .filter((f) => f.endsWith(".jsonl"))
+            .sort()
+            .reverse();
+        if (files.length > 0) {
+            transcriptPath = path.join(transcriptDir, files[0]);
+        }
+    }
+    catch {
+        // Fall back to environment variable
+    }
+    if (!transcriptPath) {
+        return errorResponse("No transcript file found. Snapshots require an active session transcript.");
+    }
+    const snapshot = await captureSnapshot({
+        trigger,
+        transcriptPath,
+        cwd,
+        sessionId,
+    });
+    return textResponse([
+        `Snapshot captured: ${snapshot.snapshot_id}`,
+        `Trigger: ${trigger}`,
+        `Files tracked: ${snapshot.files_changed.length}`,
+        `Tools: ${Object.keys(snapshot.tools_summary).length}`,
+    ]
+        .join("\n"));
+}
+async function handleRestore(args) {
+    const cwd = process.cwd();
+    const snapshotId = args.snapshot_id;
+    if (snapshotId) {
+        // Load specific snapshot and compress to markdown
+        const config = loadConfig(cwd);
+        const storagePath = getStoragePath(cwd, config);
+        const snapshot = loadSnapshot(storagePath, snapshotId);
+        if (!snapshot) {
+            return errorResponse(`Snapshot "${snapshotId}" not found.`);
+        }
+        const warning = identityMismatchWarning(storagePath, cwd);
+        const markdown = compressToMarkdown(snapshot);
+        return textResponse(prefixWarning(warning, markdown));
+    }
+    // Restore latest context using the standard restoration logic
+    const result = restoreContext({
+        cwd,
+        format: "markdown",
+    });
+    if (result.systemMessage) {
+        return textResponse(result.systemMessage);
+    }
+    return textResponse("No snapshots found to restore from.");
+}
+async function handleStatus() {
+    const cwd = process.cwd();
+    const config = loadConfig(cwd);
+    const storagePath = getStoragePath(cwd, config);
+    const count = getSnapshotCount(storagePath);
+    const state = loadState(storagePath);
+    const latest = loadLatestSnapshot(storagePath);
+    const warning = identityMismatchWarning(storagePath, cwd);
+    const lines = [`Snapshot inventory: ${count} snapshots`];
+    lines.push(`Storage: ${storagePath}`);
+    if (latest) {
+        const age = Date.now() - latest.timestamp;
+        const ageStr = age < 60000
+            ? "< 1 minute ago"
+            : age < 3600000
+                ? `${Math.round(age / 60000)} minutes ago`
+                : `${Math.round(age / 3600000)} hours ago`;
+        lines.push(`Last snapshot: ${ageStr} (${latest.snapshot_id})`);
+        lines.push(`Last trigger: ${latest.trigger}`);
+    }
+    else {
+        lines.push("No snapshots captured yet.");
+    }
+    lines.push(`Compaction count: ${state.compaction_count}`);
+    lines.push(`New-session threshold: ${config.tokenThresholds.map(value => `${Math.round(value * 100)}% used`).join(', ')} when limit is known`);
+    if (state.latest_context_used_pct !== undefined) {
+        lines.push(`Latest context usage: ${Math.round(state.latest_context_used_pct * 100)}%`);
+        if (state.latest_model)
+            lines.push(`Active model: ${state.latest_model}`);
+    }
+    else if (state.latest_model && state.latest_context_tokens !== undefined) {
+        lines.push(`Latest context usage: ${state.latest_context_tokens} tokens; context limit unknown`);
+        lines.push(`Active model: ${state.latest_model}`);
+        lines.push('Required action: bookmark config --context-limit <tokens>');
+    }
+    lines.push(`Snapshot interval: ${state.snapshot_interval_minutes} minutes`);
+    return textResponse(prefixWarning(warning, lines.join("\n")));
+}
+async function handleList(args) {
+    const cwd = process.cwd();
+    const config = loadConfig(cwd);
+    const storagePath = getStoragePath(cwd, config);
+    const limit = args.limit || 10;
+    const snapshots = listSnapshots(storagePath, limit);
+    const warning = identityMismatchWarning(storagePath, cwd);
+    if (snapshots.length === 0) {
+        return textResponse(prefixWarning(warning, `No snapshots found in ${storagePath}.`));
+    }
+    const projectName = resolveProjectName(cwd);
+    const lines = [`Snapshots (${snapshots.length}, most recent first) in ${storagePath}:`];
+    for (const s of snapshots) {
+        const date = new Date(s.timestamp).toISOString().replace("T", " ").slice(0, 19);
+        const ctx = s.context_remaining_pct
+            ? ` | ${Math.round(s.context_remaining_pct * 100)}% ctx`
+            : "";
+        lines.push(`- ${s.id} | ${date} | ${s.trigger}${ctx} | ${projectName}`);
+    }
+    return textResponse(prefixWarning(warning, lines.join("\n")));
+}
+async function handleShow(args) {
+    const cwd = process.cwd();
+    const config = loadConfig(cwd);
+    const storagePath = getStoragePath(cwd, config);
+    const snapshotId = args.snapshot_id;
+    const snapshot = snapshotId
+        ? loadSnapshot(storagePath, snapshotId)
+        : loadLatestSnapshot(storagePath);
+    if (!snapshot) {
+        return errorResponse(snapshotId
+            ? `Snapshot "${snapshotId}" not found.`
+            : "No snapshots found.");
+    }
+    const warning = identityMismatchWarning(storagePath, cwd);
+    return textResponse(prefixWarning(warning, compressToMarkdown(snapshot)));
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,40 @@
+import type { Snapshot, SnapshotTrigger } from './types.js';
+/**
+ * Resolve a human-readable project name from a directory path.
+ *
+ * Resolution order:
+ * 1. package.json "name" field in cwd
+ * 2. basename of git repo root (walk up until .git is found)
+ * 3. basename of cwd — unless it's the home directory
+ * 4. Fallback: basename(cwd) regardless
+ */
+export declare function resolveProjectName(cwd: string): string;
+export interface RegistryEntry {
+    id: string;
+    timestamp: number;
+    trigger: SnapshotTrigger;
+    project_path: string;
+    project_name: string;
+    canonical_file: string;
+    files_changed_count: number;
+}
+export interface LastProject {
+    path: string;
+    name: string;
+    last_activity_at: number;
+}
+export interface Registry {
+    version: string;
+    last_updated: number;
+    last_project?: LastProject;
+    snapshots: RegistryEntry[];
+}
+export declare function getRegistryPath(): string;
+export declare function loadRegistry(): Registry;
+export declare function appendToRegistry(snapshot: Snapshot, canonicalFile: string): void;
+export declare function touchLastProject(projectPath: string): void;
+export declare function findById(id: string): RegistryEntry | null;
+export declare function getLastProject(): LastProject | null;
+/** Prune entries whose canonical_file is missing. Lazy cleanup on read paths. */
+export declare function pruneStale(): Registry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAK5D;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkCtD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAOD,wBAAgB,YAAY,IAAI,QAAQ,CAYvC;AAQD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CA6BhF;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAY1D;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAGzD;AAED,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED,iFAAiF;AACjF,wBAAgB,UAAU,IAAI,QAAQ,CAQrC"}