mindweave 0.0.1 → 2.1.2

package/dist/cli/startupArgs.js

@@ -0,0 +1,96 @@
+/**
+ * startupArgs.ts — the flags handled before the UI exists.
+ *
+ * `mindweave --version` used to ignore the flag, start the whole terminal UI, and
+ * never exit. Piped or run without a TTY it then died on Ink's raw-mode error. That
+ * is the first command anyone runs against a new CLI, and packaging tools run it
+ * unattended, so hanging there is worse than it sounds.
+ *
+ * Parsing is a pure function returning what to print, so it is testable without
+ * spawning a process, and `index.ts` keeps the one side effect: print and exit.
+ *
+ * Deliberately tiny. Mindweave takes no launch CONFIGURATION options — it roots at the
+ * current directory and everything else is set in `~/.mindweave/.env` or in-session, and
+ * inventing flags here would create a second place to configure the same things. What
+ * does belong is the handful of things you ask the command to DO instead of starting a
+ * session: report its version, explain itself, or repair a terminal a previous run left
+ * broken.
+ */
+import { appVersion } from "./version.js";
+/** `mindweave --version` output: the bare version, which is what scripts parse. */
+export function versionText() {
+    const v = appVersion();
+    return v ? `mindweave ${v}` : "mindweave (version unknown)";
+}
+/** `mindweave --help` output. */
+export function helpText() {
+    const v = appVersion();
+    return [
+        `Mindweave 1${v ? ` (v${v})` : ""} — a terminal coding agent that works inside your repository.`,
+        "",
+        "Usage:",
+        "  mindweave                     start a session in the current directory",
+        "  mindweave --help              show this and exit",
+        "  mindweave --version           print the version and exit",
+        "  mindweave --reset-terminal    put a terminal back in order after a crash",
+        "",
+        "If a run ends badly the terminal can be left reporting mouse events, so every",
+        "scroll writes something like ^[[<64;36;23M into your shell. --reset-terminal",
+        "stops that. It is safe to run at any time.",
+        "",
+        "Setup:",
+        "  Put your model API key in ~/.mindweave/.env, for example:",
+        "    DEEPSEEK_API_KEY=your-key-here",
+        "    ANTHROPIC_API_KEY=your-key-here",
+        "  A project .env or an exported shell variable works too.",
+        "",
+        "Once running, type /help for the commands available in a session,",
+        "and press shift+tab to change how much rein the agent has.",
+        "",
+        "Windows only for now. Docs and issues:",
+        "  https://github.com/mindweave-cli/Mindweave",
+    ].join("\n");
+}
+/**
+ * Decide what a launch should do (pure).
+ *
+ * Only exact flags count. A stray argument is NOT an error: the session roots at the
+ * current directory regardless, and refusing to start over an argument nobody
+ * documented would be a worse failure than ignoring it.
+ */
+export function parseStartupArgs(argv) {
+    for (const arg of argv) {
+        if (arg === "--help" || arg === "-h")
+            return { kind: "print", text: helpText() };
+        if (arg === "--version" || arg === "-v")
+            return { kind: "print", text: versionText() };
+        // No short form on purpose: this is typed once in a blue moon, by someone reading it
+        // out of --help, and a one-letter alias for it would be a trap next to -h and -v.
+        if (arg === "--reset-terminal")
+            return { kind: "reset" };
+    }
+    return { kind: "run" };
+}
+/**
+ * Whether there is a terminal to read keystrokes from.
+ *
+ * The UI puts stdin into raw mode to read a keypress. Where stdin is a pipe or a
+ * redirect there is no raw mode to enter, and the failure arrives from inside the
+ * renderer as a stack trace through React internals: it names none of the things a
+ * reader could act on, and the process still exits 0, so a script calling it reads
+ * success. Asked here as a plain question about the stream, so the entry point can
+ * say what is wrong and fail in a way a script can see.
+ */
+export function hasInteractiveInput(stdin) {
+    return stdin.isTTY === true;
+}
+/** Shown when there is no terminal to read from. */
+export const NO_TERMINAL_MESSAGE = [
+    "Mindweave is an interactive terminal application and needs a terminal to read from.",
+    "Its input is a pipe or a redirect, so there is no keyboard to attach to.",
+    "",
+    "Run it in a terminal window, from the folder you want to work in.",
+    "--help and --version work anywhere.",
+    "",
+].join(String.fromCharCode(10));
+//# sourceMappingURL=startupArgs.js.map

package/dist/cli/startupArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startupArgs.js","sourceRoot":"","sources":["../../src/cli/startupArgs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAY1C,mFAAmF;AACnF,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,6BAA6B,CAAC;AAC9D,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,QAAQ;IACtB,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,OAAO;QACL,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,+DAA+D;QAChG,EAAE;QACF,QAAQ;QACR,0EAA0E;QAC1E,oDAAoD;QACpD,4DAA4D;QAC5D,4EAA4E;QAC5E,EAAE;QACF,+EAA+E;QAC/E,8EAA8E;QAC9E,4CAA4C;QAC5C,EAAE;QACF,QAAQ;QACR,6DAA6D;QAC7D,oCAAoC;QACpC,qCAAqC;QACrC,2DAA2D;QAC3D,EAAE;QACF,mEAAmE;QACnE,4DAA4D;QAC5D,EAAE;QACF,wCAAwC;QACxC,8CAA8C;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;QACjF,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;QACvF,qFAAqF;QACrF,kFAAkF;QAClF,IAAI,GAAG,KAAK,kBAAkB;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA0B;IAC5D,OAAO,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;AAC9B,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,qFAAqF;IACrF,0EAA0E;IAC1E,EAAE;IACF,mEAAmE;IACnE,qCAAqC;IACrC,EAAE;CACH,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/cli/terminalRestore.js

@@ -0,0 +1,34 @@
+/**
+ * terminalRestore.ts — the escape sequences that put a terminal back the way we found it.
+ *
+ * Owned in one place because two callers write them and they must not drift: the app's
+ * own exit path (`altScreen.ts`), and `mindweave --reset-terminal`, which exists for the
+ * case where that exit path never ran.
+ *
+ * That case is real, and it cannot be handled from inside the process it happens to. A
+ * V8 fatal out-of-memory calls `abort()`, and `abort` runs no exit handler, no signal
+ * handler and no `finally` block; the same is true of SIGKILL and of a force-quit from
+ * the task manager. The process simply stops, mid-frame, with wheel reporting still
+ * switched on. From then on every scroll and click writes `^[[<64;36;23M` into whichever
+ * shell comes next, and closing the app does not help because the app is already gone.
+ * The terminal is waiting for a byte that nobody is left to send, so it has to be sent
+ * later, by hand.
+ */
+/** Wheel reporting off: the SGR encoding (1006) first, then reporting itself (1000). */
+export const MOUSE_OFF = "\x1b[?1006l\x1b[?1000l";
+/** Leave the alternate screen buffer, revealing the shell scrollback underneath. */
+export const ALT_SCREEN_OFF = "\x1b[?1049l";
+/** Show the cursor again. */
+export const SHOW_CURSOR = "\x1b[?25h";
+/**
+ * Everything the app switches on, switched back off, in the order a half-dead terminal
+ * wants it: stop the reporting that is actively producing garbage, then restore the
+ * screen buffer, then the cursor.
+ *
+ * Every sequence here is idempotent, so sending the lot to a terminal that was never
+ * broken costs three dozen bytes and changes nothing. That is what makes it safe to send
+ * without first working out which parts are actually needed — and there is no way to
+ * work that out anyway, since the terminal will not tell us what modes it is in.
+ */
+export const TERMINAL_RESTORE = MOUSE_OFF + ALT_SCREEN_OFF + SHOW_CURSOR;
+//# sourceMappingURL=terminalRestore.js.map

package/dist/cli/terminalRestore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalRestore.js","sourceRoot":"","sources":["../../src/cli/terminalRestore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,wFAAwF;AACxF,MAAM,CAAC,MAAM,SAAS,GAAG,wBAAwB,CAAC;AAElD,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;AAE5C,6BAA6B;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,GAAG,cAAc,GAAG,WAAW,CAAC"}

package/dist/cli/toolDisplay.js

@@ -0,0 +1,219 @@
+/**
+ * toolDisplay.ts — map a Mindweave tool call to its display name + argument.
+ *
+ * A compact tool header: a bold verb-noun name and the one telling
+ * argument in parens — `Update(home.html)`, `Search(refreshToken)`, `Run(npm
+ * test)`. Pure, display-only (never sent to a model), and deterministic from the
+ * tool name + parsed args.
+ */
+/** Raw tool name → the bold display name shown in the row. */
+const DISPLAY_NAME = {
+    read_file: "Read",
+    read_symbol: "Read",
+    edit: "Update",
+    write_file: "Write",
+    search: "Search",
+    run_command: "Run",
+    outline: "Map",
+    definition: "Map",
+    references: "Map",
+    relevant: "Map",
+    diagnostics: "Check",
+    web_fetch: "Fetch",
+    web_search: "WebSearch",
+    screenshot: "WindowCapture",
+    use_skill: "Skill",
+    create_skill: "Skill",
+    todo_write: "Todo",
+    add_directory: "Add",
+    link_workspace: "Link",
+    remember_rule: "Rule",
+    forbid_path: "Forbid",
+    spawn_subagent: "Subagent",
+    shells: "Shell",
+    // Tools the redesign originally missed. Without an entry each fell through to the
+    // capitalize-the-raw-name fallback and rendered as `Replace_symbol_body` —
+    // snake_case in a UI that has none anywhere else. TOOL_DISPLAY_COVERAGE in
+    // toolDisplay.test.ts now fails the build if a registered tool is missing here.
+    replace_symbol_body: "Update",
+    save_memory: "Remember",
+    sessions: "Session",
+    workspace: "Workspace",
+    kill_shell: "Shell",
+    add_mcp_server: "MCP",
+    mcp_resource: "MCP",
+    // "Tools", not "MCP". It searches BOTH pools — the deferred native tools and any MCP
+    // catalog — and the row was reading "MCP(sessions)" for a search that loaded three of
+    // Mindweave's own tools and never touched a server.
+    find_tools: "Tools",
+    governor: "Governor",
+    exit_plan: "Plan",
+    ask_user: "Ask",
+    web: "Web",
+};
+/** What an unrecognized tool name renders as. A model can call a tool that does not
+ *  exist (a hallucinated `index_results`, say). The row still has to appear — the call
+ *  happened and it failed — but it renders under a plain English name with the raw
+ *  name as its argument, rather than title-casing whatever the model invented. */
+export const UNKNOWN_TOOL = "Unknown tool";
+// Consecutive calls to these fold into ONE row (see ToolGroup) rather than
+// stacking a line each — a burst of reads is "Read 9 files" with the files
+// listed under it.
+//
+// Deliberately narrow. `search` is not here, and does not render at all — like the
+// code-intel lookups (outline/definition/references/relevant), it is how the agent
+// finds its way around rather than work done to the project, and the user asked for
+// it to stay out of the stream. `todo_write` is silent for the same reason: its
+// reader is the model, not the user. Mutating tools (edit/write/run) were never
+// grouped and still keep their own row with the diff/output.
+const GROUPABLE = new Set([
+    "read_file",
+    "read_symbol",
+    // Background-shell status checks: silent, and a model tends to POLL them in a loop
+    // while waiting on a build — so they fold into the group and their repeats collapse
+    // (see collapseAdjacent) instead of stacking a row per poll. kill_shell mutates → stays.
+    "shells",
+]);
+// `diagnostics` was here, and grouping it was the wrong answer to the right problem.
+// A burst of them after an edit did stack a wall of rows — but folding them into the
+// group threw away the caret block each one carries (a group row shows a label, never
+// a detail), so the one case worth seeing, an actual compiler error with its source
+// line and squiggle, was the case that got hidden. It now stays ungrouped and reports
+// nothing at all when it finds nothing (`quiet`), which removes the wall outright.
+/** Whether a tool call should fold into the discovery group rather than its own row. */
+export function isGroupable(name) {
+    return GROUPABLE.has(name);
+}
+const TOOL_KIND = {
+    read_file: "read",
+    read_symbol: "read",
+    search: "search",
+    outline: "search",
+    definition: "search",
+    references: "search",
+    relevant: "search",
+    edit: "edit",
+    replace_symbol_body: "edit",
+    write_file: "write",
+    run_command: "run",
+    diagnostics: "check",
+    spawn_subagent: "agent",
+    shells: "run",
+    // web_fetch and web_search are both "reaching out to the web" — same family,
+    // distinct from codebase "search". Was mislabeled "search" before.
+    web_fetch: "websearch",
+    web_search: "websearch",
+    web: "websearch",
+    screenshot: "screenshot",
+    kill_shell: "run",
+    governor: "governor",
+    // The MCP family: finding an external server's tools, reading its data, adding one.
+    // Pink like the servers' own tools, since that is what they are all about.
+    find_tools: "mcp",
+    mcp_resource: "mcp",
+    add_mcp_server: "mcp",
+    // everything else (todo, skills, rules, workspace) → "meta"
+};
+/** The action category for a raw tool name — an MCP call (`mcp__server__tool`) is
+ *  detected by prefix rather than a static map entry, since the tool name is
+ *  generated per-server (see src/mcp/manager.ts). Defaults to bookkeeping "meta". */
+export function toolKind(name) {
+    if (name.startsWith("mcp__"))
+        return "mcp";
+    return TOOL_KIND[name] ?? "meta";
+}
+/** Terminal colour per action kind — a blue family, truecolor hex (terminals that
+ *  can't render it downsample gracefully). Red is reserved for the error state. */
+export const KIND_COLOR = {
+    read: "#7cc4ff", // light blue — looking at code
+    search: "#4a90d9", // blue — searching / mapping the codebase
+    edit: "#3b82f6", // vivid blue — changing code
+    write: "#38bdf8", // sky — creating a file
+    run: "#6366f1", // indigo — running a command
+    check: "#22d3ee", // cyan — diagnostics / verifying
+    agent: "#a78bfa", // violet — a spawned sub-agent (set apart from the blue tool family)
+    websearch: "#2dd4bf", // teal — reaching outside the machine (web search / fetch)
+    screenshot: "#facc15", // amber — a capture, set apart since it's visual not textual
+    mcp: "#f472b6", // pink — an external server's own tool, not one of ours
+    checkpoint: "#94a3b8", // slate — housekeeping you'd want to notice (a rollback)
+    governor: "#fb923c", // orange — a policy decision, not an ordinary tool result
+    meta: "#60a5fa", // soft blue — bookkeeping (todo, skills, rules)
+};
+/** The dot colour for a failed tool / failed test. */
+export const ERROR_COLOR = "#ff5f56";
+/** Build the `Name(arg)` display parts for a tool call. */
+export function toolDisplay(name, args) {
+    const kind = toolKind(name);
+    // mcp__<server>__<tool> has no static DISPLAY_NAME entry (the name is generated
+    // per-server, see src/mcp/manager.ts) — parse it back into "MCPServer(server)"
+    // the way the tool header for everything else reads.
+    if (name.startsWith("mcp__")) {
+        const [, server] = name.split("__");
+        return { name: "MCPServer", arg: server || undefined, kind };
+    }
+    // Every REGISTERED tool has an entry above (enforced by test), so reaching the
+    // fallback means the model named a tool that does not exist.
+    const known = DISPLAY_NAME[name];
+    if (!known)
+        return { name: UNKNOWN_TOOL, arg: name, kind: "meta" };
+    const display = known;
+    // `search` is quiet and never renders, but it still resolves a name/arg for the
+    // sub-agent rail and for any future surface — and it takes either argument.
+    if (name === "search") {
+        return { name: display, arg: str(args.pattern) || str(args.files) || str(args.path) || undefined, kind };
+    }
+    if (name === "run_command") {
+        // The command goes in the HEADER, like every other row's subject: `Run(npm test)`
+        // beside `Write(app.ts)` and `Read(index.ts)`. It used to be a bare title —
+        // "Executed shell command" — with the command on a `$` row below it, which read as
+        // a sentence in a column of verb-noun names and took three rows to say what the
+        // others say in one.
+        //
+        // Passed WHOLE, not clipped. The old 48-character clip here is what forced the
+        // command onto its own row in the first place; ToolLine fits the header to the
+        // real terminal width and only trims when it genuinely does not fit, and the `$`
+        // row comes back for exactly that case.
+        //
+        // The timeout marker appears only when the model asked for one. A marker on every
+        // command would say nothing; this exists to explain a row allowed to take longer.
+        const t = typeof args.timeout === "number" && Number.isFinite(args.timeout) ? args.timeout : undefined;
+        return {
+            name: display,
+            arg: str(args.command) || undefined,
+            kind,
+            ...(t ? { meta: `[Timeout: ${Math.round(t / 1000)}s]` } : {}),
+        };
+    }
+    if (name === "web_fetch")
+        return { name: display, arg: clip(str(args.url), 48) || undefined, kind };
+    if (name === "web_search")
+        return { name: display, arg: clip(str(args.query), 48) || undefined, kind };
+    if (name === "screenshot")
+        return { name: display, arg: str(args.window) || undefined, kind };
+    if (name === "spawn_subagent")
+        return { name: display, arg: clip(str(args.task), 48) || undefined, kind };
+    // `paths` is a LIST — read_file takes several files in one call, and the row has to
+    // say which. One file reads as its name; several read as a count, because four
+    // basenames do not fit a header and the group below already lists them.
+    const many = Array.isArray(args.paths) ? args.paths.filter((v) => typeof v === "string") : [];
+    const path = many.length > 0 ? (many.length === 1 ? (many[0] ?? "") : "") : str(args.path);
+    const detail = many.length > 1
+        ? `${many.length} files`
+        : path
+            ? base(path)
+            : str(args.symbol) || str(args.name) || str(args.query) || str(args.label);
+    return { name: display, arg: detail || undefined, kind };
+}
+function str(v) {
+    return typeof v === "string" ? v : "";
+}
+/** A path's last segment, so rows stay short: `src/a/session.ts` → `session.ts`. */
+function base(p) {
+    const parts = p.split(/[\\/]/).filter(Boolean);
+    return parts.length > 0 ? parts[parts.length - 1] : p;
+}
+function clip(s, max) {
+    const flat = s.replace(/\s+/g, " ").trim();
+    return flat.length <= max ? flat : flat.slice(0, max - 1) + "…";
+}
+//# sourceMappingURL=toolDisplay.js.map

package/dist/cli/toolDisplay.js.map

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

package/dist/cli/toolItems.js

@@ -0,0 +1,65 @@
+// Present-continuous verb for a block that belongs to the turn still in progress,
+// so a row reads "Reading home.html" while Mindweave works and becomes "Read
+// home.html" when the turn ends. The block itself never changes shape — the verb
+// is the only thing that moves, in place (see activeForm / the `live` flag).
+//
+// Only names with a natural continuous form are listed. Anything else falls back
+// to itself, which keeps the rule honest: a header may stay identical, but it may
+// never mutate into a DIFFERENT word or grow a body.
+export const ACTIVE_FORM = {
+    Read: "Reading",
+    Update: "Updating",
+    Write: "Writing",
+    Search: "Searching",
+    Glob: "Finding",
+    List: "Listing",
+    Run: "Running",
+    Map: "Mapping",
+    Fetch: "Fetching",
+    Shell: "Checking",
+    Check: "Checking",
+    Add: "Adding",
+    Link: "Linking",
+};
+/** The verb a tool row shows: present-continuous while its turn is live, the
+ *  plain display name once the turn has ended. */
+export function activeForm(name, live) {
+    return live ? ACTIVE_FORM[name] ?? name : name;
+}
+/** What a discovery/rail item shows: while it runs, a present-tense line ("Reading
+ *  home.html"); once it resolves, its tool-authored result ("Read home.html (1747
+ *  lines)"), capitalized for the list. Falls back to name + argument if there's no
+ *  result. */
+export function itemLabel(it) {
+    if (it.status === "running") {
+        const verb = ACTIVE_FORM[it.name] ?? it.name;
+        return it.arg ? `${verb} ${it.arg}` : verb;
+    }
+    if (it.note)
+        return it.note.charAt(0).toUpperCase() + it.note.slice(1);
+    return it.arg ? `${it.name} ${it.arg}` : it.name;
+}
+/**
+ * Fold consecutive items with the SAME label into one row carrying a count. Adjacent
+ * only — a different call in between breaks the run — so this never hides distinct
+ * work, it only silences a repeated poll/read. The representative keeps the latest
+ * item (so status reflects the most recent), and any error in the run is remembered.
+ */
+export function collapseAdjacent(items) {
+    const out = [];
+    for (const it of items) {
+        const label = itemLabel(it);
+        const last = out[out.length - 1];
+        if (last && last.label === label) {
+            last.count += 1;
+            last.item = it;
+            if (it.status === "error")
+                last.anyError = true;
+        }
+        else {
+            out.push({ item: it, label, count: 1, anyError: it.status === "error" });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=toolItems.js.map

package/dist/cli/toolItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolItems.js","sourceRoot":"","sources":["../../src/cli/toolItems.ts"],"names":[],"mappings":"AAgBA,kFAAkF;AAClF,6EAA6E;AAC7E,iFAAiF;AACjF,6EAA6E;AAC7E,EAAE;AACF,iFAAiF;AACjF,kFAAkF;AAClF,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,SAAS;CAChB,CAAC;AAEF;kDACkD;AAClD,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAa;IACpD,OAAO,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED;;;cAGc;AACd,MAAM,UAAU,SAAS,CAAC,EAAiB;IACzC,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC;QAC7C,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IACD,IAAI,EAAE,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;AACnD,CAAC;AAWD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;YAChB,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;YACf,IAAI,EAAE,CAAC,MAAM,KAAK,OAAO;gBAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}