@nifrajs/cli 0.1.0-alpha.1

package/dist/mcp-run.js

@@ -0,0 +1,142 @@
+/**
+ * The `nifra_run` engine + its child-process entry. The MCP server spawns this file fresh on every
+ * `nifra_run` call (`bun mcp-run.ts <cwd>`) so the project's CURRENT backend code is loaded — picking
+ * up the agent's latest edits. {@link runBackend} is the pure-ish core (resolve entry → import → run),
+ * exported so it's unit-testable in-process; the entry below wires it to stdin/stdout.
+ */
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { runApp } from "@nifrajs/runner";
+const ENTRY_CANDIDATES = ["backend.ts", "app.ts", "src/backend.ts", "src/app.ts"];
+const errString = (err) => err instanceof Error ? `${err.name}: ${err.message}` : String(err);
+export async function loadBackend(cwd, entry) {
+    const candidates = entry && entry.length > 0 ? [entry] : ENTRY_CANDIDATES;
+    const found = candidates.map((c) => resolve(cwd, c)).find((p) => existsSync(p));
+    if (!found) {
+        return { error: `no backend entry found in ${cwd} (looked for ${candidates.join(", ")})` };
+    }
+    let mod;
+    try {
+        mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(found).href)));
+    }
+    catch (err) {
+        return { error: errString(err) };
+    }
+    const app = (mod.app ?? mod.backend ?? mod.default);
+    if (!app || typeof app.fetch !== "function") {
+        return {
+            error: `${found} does not export a nifra app (expected \`app\`, \`backend\`, or default).`,
+        };
+    }
+    return { app };
+}
+/**
+ * Resolve the backend entry under `cwd`, import it, and run `requests` through its exported app. Never
+ * throws — every failure (missing/invalid entry, import/compile/runtime error) becomes `{ error }`, so
+ * the caller (and the agent) always gets actionable output. An import error here IS the failure the
+ * agent needs to see and fix.
+ */
+export async function runBackend(cwd, requests, entry) {
+    if (!Array.isArray(requests))
+        return { error: "expected { requests: [...] }" };
+    const loaded = await loadBackend(cwd, entry);
+    if ("error" in loaded)
+        return loaded;
+    try {
+        return { results: await runApp(loaded.app, requests) };
+    }
+    catch (err) {
+        return { error: errString(err) };
+    }
+}
+function redirectConsoleToStderr() {
+    const write = (level, args) => {
+        Bun.stderr.write(`[${level}] ${args.map((arg) => String(arg)).join(" ")}\n`);
+    };
+    console.debug = (...args) => write("debug", args);
+    console.info = (...args) => write("info", args);
+    console.log = (...args) => write("log", args);
+    console.warn = (...args) => write("warn", args);
+    console.error = (...args) => write("error", args);
+}
+async function runWorker(cwd) {
+    redirectConsoleToStderr();
+    const apps = new Map();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    const send = (id, output) => {
+        process.stdout.write(`${JSON.stringify({ id, output })}\n`);
+    };
+    for await (const chunk of Bun.stdin.stream()) {
+        buffer += decoder.decode(chunk, { stream: true });
+        let nl = buffer.indexOf("\n");
+        while (nl !== -1) {
+            const line = buffer.slice(0, nl).trim();
+            buffer = buffer.slice(nl + 1);
+            nl = buffer.indexOf("\n");
+            if (line === "")
+                continue;
+            let message;
+            try {
+                message = JSON.parse(line);
+            }
+            catch {
+                send(null, { error: "invalid worker input: expected JSON line" });
+                continue;
+            }
+            const requests = message.input?.requests;
+            const entry = message.input?.entry;
+            if (!Array.isArray(requests)) {
+                send(message.id, { error: "expected { requests: [...] }" });
+                continue;
+            }
+            const key = entry ?? "";
+            let loaded = apps.get(key);
+            if (loaded === undefined) {
+                loaded = loadBackend(cwd, entry);
+                apps.set(key, loaded);
+            }
+            const app = await loaded;
+            if ("error" in app) {
+                send(message.id, app);
+                continue;
+            }
+            try {
+                send(message.id, {
+                    results: await runApp(app.app, requests),
+                });
+            }
+            catch (err) {
+                send(message.id, { error: errString(err) });
+            }
+        }
+    }
+}
+// Child-process entry: read `{ requests, entry? }` from stdin, run, print JSON to stdout. Guarded so
+// this only executes when run directly (not when imported by a test).
+if (import.meta.main) {
+    const cwd = process.argv[2] ?? process.cwd();
+    if (process.argv.includes("--worker")) {
+        await runWorker(cwd);
+        process.exit(0);
+    }
+    let output;
+    try {
+        const { requests, entry } = JSON.parse(await Bun.stdin.text());
+        output = await runBackend(cwd, requests, entry);
+    }
+    catch {
+        output = { error: "invalid input: expected JSON { requests: [...] }" };
+    }
+    process.stdout.write(JSON.stringify(output, null, 2));
+}
+//# sourceMappingURL=mcp-run.js.map

package/dist/mcp-run.js.map

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

package/dist/mcp-ws.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The `nifra_ws` engine + child-process entry. The MCP server spawns this file fresh on every
+ * WebSocket verification so the project's current backend code loads, then this module starts the
+ * app on an ephemeral localhost port, connects with Bun's WebSocket client, and returns structured
+ * evidence. It intentionally only targets the current app; this is a verification tool, not a
+ * general-purpose network client.
+ */
+interface CloseInfo {
+    readonly code: number;
+    readonly reason: string;
+    readonly wasClean: boolean;
+}
+export interface WebSocketVerificationResult {
+    readonly ok: boolean;
+    readonly opened: boolean;
+    readonly path: string;
+    readonly sent: readonly string[];
+    readonly received: readonly string[];
+    readonly durationMs: number;
+    readonly url?: string;
+    readonly close?: CloseInfo;
+    readonly error?: string;
+}
+export declare function runWebSocket(cwd: string, args: unknown): Promise<WebSocketVerificationResult>;
+export {};
+//# sourceMappingURL=mcp-ws.d.ts.map

package/dist/mcp-ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-ws.d.ts","sourceRoot":"","sources":["../src/mcp-ws.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4BH,UAAU,SAAS;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAsID,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,2BAA2B,CAAC,CAqHtC"}

package/dist/mcp-ws.js

@@ -0,0 +1,258 @@
+/**
+ * The `nifra_ws` engine + child-process entry. The MCP server spawns this file fresh on every
+ * WebSocket verification so the project's current backend code loads, then this module starts the
+ * app on an ephemeral localhost port, connects with Bun's WebSocket client, and returns structured
+ * evidence. It intentionally only targets the current app; this is a verification tool, not a
+ * general-purpose network client.
+ */
+import { loadBackend } from "./mcp-run.js";
+const DEFAULT_TIMEOUT_MS = 3_000;
+const MAX_TIMEOUT_MS = 30_000;
+const MAX_MESSAGES = 50;
+const MAX_MESSAGE_BYTES = 64 * 1024;
+const MAX_PATH_LENGTH = 2_048;
+const ENCODER = new TextEncoder();
+const errString = (err) => err instanceof Error ? `${err.name}: ${err.message}` : String(err);
+function hasControlCharacter(value) {
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        if (code < 0x20 || code === 0x7f)
+            return true;
+    }
+    return false;
+}
+function fail(path, sent, startedAt, error, extra = {}) {
+    return {
+        ok: false,
+        opened: extra.opened ?? false,
+        path,
+        sent,
+        received: extra.received ?? [],
+        durationMs: Math.round(performance.now() - startedAt),
+        error,
+        ...(extra.url === undefined ? {} : { url: extra.url }),
+        ...(extra.close === undefined ? {} : { close: extra.close }),
+    };
+}
+function normalizeInput(args) {
+    if (args === null || typeof args !== "object") {
+        return { error: 'expected JSON { "path": "/..." }', path: "" };
+    }
+    const input = args;
+    const path = input.path;
+    if (typeof path !== "string" || path.length === 0) {
+        return { error: 'expected "path" to be a non-empty string starting with "/"', path: "" };
+    }
+    if (!path.startsWith("/") || path.startsWith("//")) {
+        return { error: 'expected "path" to be an app-local path such as "/ws"', path };
+    }
+    if (path.length > MAX_PATH_LENGTH) {
+        return { error: `"path" is too long (max ${MAX_PATH_LENGTH} characters)`, path };
+    }
+    if (hasControlCharacter(path)) {
+        return { error: '"path" must not contain control characters', path };
+    }
+    if (path.includes("#"))
+        return { error: '"path" must not include a fragment', path };
+    const messagesValue = input.messages;
+    const messages = messagesValue === undefined ? [] : Array.isArray(messagesValue) ? messagesValue : undefined;
+    if (messages === undefined)
+        return { error: '"messages" must be an array of strings', path };
+    if (messages.length > MAX_MESSAGES) {
+        return { error: `"messages" can include at most ${MAX_MESSAGES} frames`, path };
+    }
+    const strings = [];
+    for (const [index, message] of messages.entries()) {
+        if (typeof message !== "string") {
+            return { error: `"messages[${index}]" must be a string`, path };
+        }
+        if (ENCODER.encode(message).byteLength > MAX_MESSAGE_BYTES) {
+            return { error: `"messages[${index}]" is too large (max ${MAX_MESSAGE_BYTES} bytes)`, path };
+        }
+        strings.push(message);
+    }
+    const expectRaw = input.expectMessages;
+    const expectMessages = expectRaw === undefined
+        ? strings.length > 0
+            ? strings.length
+            : 1
+        : typeof expectRaw === "number" && Number.isInteger(expectRaw)
+            ? expectRaw
+            : undefined;
+    if (expectMessages === undefined || expectMessages < 0 || expectMessages > MAX_MESSAGES) {
+        return { error: `"expectMessages" must be an integer from 0 to ${MAX_MESSAGES}`, path };
+    }
+    const timeoutRaw = input.timeoutMs;
+    const timeoutMs = timeoutRaw === undefined
+        ? DEFAULT_TIMEOUT_MS
+        : typeof timeoutRaw === "number" && Number.isFinite(timeoutRaw)
+            ? Math.trunc(timeoutRaw)
+            : undefined;
+    if (timeoutMs === undefined || timeoutMs <= 0) {
+        return { error: '"timeoutMs" must be a positive number', path };
+    }
+    const entry = input.entry;
+    if (entry !== undefined && typeof entry !== "string") {
+        return { error: '"entry" must be a string when provided', path };
+    }
+    return {
+        path,
+        messages: strings,
+        expectMessages,
+        timeoutMs: Math.min(Math.max(timeoutMs, 250), MAX_TIMEOUT_MS),
+        ...(entry === undefined || entry.length === 0 ? {} : { entry }),
+    };
+}
+async function dataToString(data) {
+    if (typeof data === "string")
+        return data;
+    if (data instanceof ArrayBuffer)
+        return new TextDecoder().decode(data);
+    if (ArrayBuffer.isView(data)) {
+        return new TextDecoder().decode(new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
+    }
+    if (typeof Blob !== "undefined" && data instanceof Blob)
+        return data.text();
+    return String(data);
+}
+function closeInfo(event) {
+    return { code: event.code, reason: event.reason, wasClean: event.wasClean };
+}
+function redirectConsoleToStderr() {
+    const write = (level, args) => {
+        Bun.stderr.write(`[${level}] ${args.map((arg) => String(arg)).join(" ")}\n`);
+    };
+    console.debug = (...args) => write("debug", args);
+    console.info = (...args) => write("info", args);
+    console.log = (...args) => write("log", args);
+    console.warn = (...args) => write("warn", args);
+    console.error = (...args) => write("error", args);
+}
+export async function runWebSocket(cwd, args) {
+    const startedAt = performance.now();
+    const normalized = normalizeInput(args);
+    if ("error" in normalized)
+        return fail(normalized.path, [], startedAt, normalized.error);
+    const loaded = await loadBackend(cwd, normalized.entry);
+    if ("error" in loaded)
+        return fail(normalized.path, [], startedAt, loaded.error);
+    const app = loaded.app;
+    if (typeof app.listen !== "function") {
+        return fail(normalized.path, [], startedAt, "backend app does not expose listen(); WebSocket verification requires a Bun-listenable nifra app.");
+    }
+    let running;
+    let socket;
+    try {
+        running = app.listen(0);
+        const url = `ws://127.0.0.1:${running.port}${normalized.path}`;
+        socket = new WebSocket(url);
+        socket.binaryType = "arraybuffer";
+        return await new Promise((resolve) => {
+            const received = [];
+            const sent = [];
+            let opened = false;
+            let close;
+            let settled = false;
+            let timer;
+            const settle = (ok, error, extra = {}) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                if (extra.close !== undefined)
+                    close = extra.close;
+                resolve({
+                    ok,
+                    opened,
+                    path: normalized.path,
+                    url,
+                    sent,
+                    received,
+                    durationMs: Math.round(performance.now() - startedAt),
+                    ...(close === undefined ? {} : { close }),
+                    ...(error === undefined ? {} : { error }),
+                });
+            };
+            timer = setTimeout(() => {
+                settle(false, `timed out after ${normalized.timeoutMs}ms waiting for ${normalized.expectMessages} message(s); received ${received.length}`, close === undefined ? {} : { close });
+            }, normalized.timeoutMs);
+            socket?.addEventListener("open", () => {
+                opened = true;
+                try {
+                    for (const message of normalized.messages) {
+                        socket?.send(message);
+                        sent.push(message);
+                    }
+                }
+                catch (err) {
+                    settle(false, errString(err));
+                    return;
+                }
+                if (normalized.expectMessages === 0)
+                    settle(true);
+            });
+            socket?.addEventListener("message", (event) => {
+                void dataToString(event.data)
+                    .then((text) => {
+                    received.push(text);
+                    if (received.length >= normalized.expectMessages)
+                        settle(true);
+                })
+                    .catch((err) => settle(false, errString(err)));
+            });
+            socket?.addEventListener("error", () => {
+                settle(false, opened ? "websocket error" : "websocket failed before open");
+            });
+            socket?.addEventListener("close", (event) => {
+                close = closeInfo(event);
+                if (!settled && received.length < normalized.expectMessages) {
+                    settle(false, opened
+                        ? `websocket closed before ${normalized.expectMessages} message(s); received ${received.length}`
+                        : "websocket closed before open", { close });
+                }
+            });
+        });
+    }
+    catch (err) {
+        return fail(normalized.path, [], startedAt, errString(err));
+    }
+    finally {
+        try {
+            if (socket !== undefined && socket.readyState < WebSocket.CLOSING)
+                socket.close();
+        }
+        catch {
+            // Cleanup is best effort; the structured verification result above is the important signal.
+        }
+        try {
+            running?.stop(true);
+        }
+        catch {
+            // Same as socket.close(): do not mask the verification result with teardown noise.
+        }
+    }
+}
+// Child-process entry: read `{ path, messages?, expectMessages?, timeoutMs?, entry? }` from stdin,
+// verify, and print JSON to stdout. Console output from the project is redirected so agents receive
+// parseable JSON even when the app logs during import or request handling.
+if (import.meta.main) {
+    redirectConsoleToStderr();
+    const cwd = process.argv[2] ?? process.cwd();
+    let output;
+    try {
+        output = await runWebSocket(cwd, JSON.parse(await Bun.stdin.text()));
+    }
+    catch {
+        output = {
+            ok: false,
+            opened: false,
+            path: "",
+            sent: [],
+            received: [],
+            durationMs: 0,
+            error: 'invalid input: expected JSON { "path": "/..." }',
+        };
+    }
+    process.stdout.write(JSON.stringify(output, null, 2));
+}
+//# sourceMappingURL=mcp-ws.js.map

package/dist/mcp-ws.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `nifra mcp` — a Model Context Protocol server (stdio) that lets a coding agent (Claude, Cursor, …)
+ * act on a nifra project, not just read about it:
+ *
+ *   - `nifra_context` — this project's API routes + page routes + conventions (see {@link describeProject}).
+ *   - `nifra_run`     — run HTTP requests through the project's backend and return structured results
+ *     (status, body, errors). The write → run → see-the-failure → fix loop, powered by `@nifrajs/runner`.
+ *     Each call runs the backend in a FRESH subprocess, so it reflects the agent's latest edits.
+ *   - `nifra_render`  — SSR a page route through the project's web app; returns the rendered HTML (the
+ *     page half of `nifra_run`). Fresh subprocess per call; no build needed.
+ *   - `nifra_ws`      — verify a WebSocket route with a real Bun WebSocket round-trip.
+ *   - `nifra_docs`    — keyword-search the framework docs; returns only the matching sections.
+ *   - `nifra_example` — a verified, copy-pasteable snippet for a task (typechecked against the live API,
+ *     so it can't hallucinate a drifted nifra API).
+ *   - `nifra_scaffold`— map a URL path to the correct `routes/` file + a contract-correct page stub.
+ *   - `nifra_check`   — the drift gate (typecheck + lints, each with a structured fix), for an agent to fix against.
+ *   - `nifra_doctor`  — package.json dependency drift detector, with safe local-version auto-fix.
+ *
+ * Wire it into a client (e.g. Claude Desktop / Cursor) as: command `nifra`, args `["mcp"]`, run in the
+ * project root. The protocol is hand-rolled (newline-delimited JSON-RPC 2.0 over stdio), including
+ * standard MCP progress notifications and request cancellation — no SDK dependency, the same
+ * minimal-surface choice as the rest of nifra. The pure dispatch lives in `./mcp-protocol.ts`; this
+ * module is the I/O shell (stdin loop, tool wiring, the run subprocess).
+ */
+import type { LoadAppOptions, LoadedApp } from "./load.js";
+import { type McpPrompt, type McpResource, type McpServerFeatures, type McpTool } from "./mcp-protocol.js";
+type LoadAppForCache = (cwd: string, outDirName?: string, options?: LoadAppOptions) => Promise<LoadedApp>;
+export interface CachedAppLoaderOptions {
+    readonly loadApp?: LoadAppForCache;
+    readonly fingerprint?: (cwd: string) => Promise<string>;
+}
+/** Cache LoadedApp inside one MCP server process, invalidating when config/backend mtimes change. */
+export declare function createCachedAppLoader(cwd: string, options?: CachedAppLoaderOptions): (outDirName?: string) => Promise<LoadedApp>;
+export declare function projectResources(cwd: string, loadAppCached?: (outDirName?: string) => Promise<LoadedApp>): McpResource[];
+export declare function projectPrompts(): McpPrompt[];
+export declare function projectFeatures(cwd: string, loadAppCached?: (outDirName?: string) => Promise<LoadedApp>): McpServerFeatures;
+/** Build the project-scoped tools for `cwd`. */
+export declare function projectTools(cwd: string, loadAppCached?: (outDirName?: string) => Promise<LoadedApp>): McpTool[];
+/** Run the stdio MCP server: read newline-delimited JSON-RPC from stdin, write responses to stdout. */
+export declare function runMcpServer(cwd: string, version: string): Promise<void>;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1D,OAAO,EAML,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EAGb,MAAM,mBAAmB,CAAA;AAgQ1B,KAAK,eAAe,GAAG,CACrB,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC,SAAS,CAAC,CAAA;AAEvB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACxD;AAmCD,qGAAqG;AACrG,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAA2B,GACnC,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CA+B7C;AAyCD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAA8B,GACtF,WAAW,EAAE,CAmCf;AAED,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAkE5C;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAA8B,GACtF,iBAAiB,CAEnB;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAA8B,GACtF,OAAO,EAAE,CAsRX;AAED,uGAAuG;AACvG,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC9E"}