@apollo/mcp-impostor-host 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Apollo GraphQL
+
+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/bin/serve-impostor-host.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/sandbox/server.js";

package/dist/core/Host.d.ts

@@ -0,0 +1,16 @@
+import { HostConnection } from "./HostConnection.js";
+import { Logger } from "../utilities/index.js";
+export declare namespace Host {
+    interface Config {
+        logLevel?: Logger.Level;
+    }
+    interface ConnectOptions {
+        url: string;
+    }
+}
+export declare class Host {
+    #private;
+    constructor(config?: Host.Config);
+    connect(options: Host.ConnectOptions): Promise<HostConnection>;
+}
+//# sourceMappingURL=Host.d.ts.map

package/dist/core/Host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Host.d.ts","sourceRoot":"","sources":["../../src/core/Host.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAa,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,UAAiB,MAAM;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC;KACzB;IAED,UAAiB,cAAc;QAC7B,GAAG,EAAE,MAAM,CAAC;KACb;CACF;AAED,qBAAa,IAAI;;gBAKH,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM;IAW1B,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc;CAoD3C"}

package/dist/core/Host.js

@@ -0,0 +1,56 @@
+import { UI_EXTENSION_CAPABILITIES } from "@mcp-ui/client";
+import { Client } from "@modelcontextprotocol/sdk/client";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
+import pkg from "#package.json" with { type: "json " };
+import { HostConnection } from "./HostConnection.js";
+import { invariant, Logger } from "../utilities/index.js";
+export class Host {
+    #client;
+    #logger;
+    #connected = false;
+    constructor(config) {
+        this.#client = new Client({
+            name: "@apollo/mcp-impostor-host",
+            version: pkg.version,
+        }, { capabilities: { extensions: UI_EXTENSION_CAPABILITIES } });
+        this.#logger = new Logger({ level: config?.logLevel });
+    }
+    async connect(options) {
+        invariant(!this.#connected, "Host only supports one connection at a time. Call `close` on the connection before connecting again.");
+        const transport = new StreamableHTTPClientTransport(new URL(options.url));
+        await this.#client.connect(transport);
+        this.#connected = true;
+        const [tools, resources] = await Promise.all([
+            this.#fetchAllTools(),
+            this.#fetchAllResources(),
+        ]);
+        const connection = new HostConnection(this.#client, {
+            tools,
+            resources,
+            logger: this.#logger,
+        });
+        connection.addEventListener("close", () => {
+            this.#connected = false;
+        });
+        return connection;
+    }
+    async #fetchAllTools() {
+        const fetchTools = async (cursor) => {
+            const { tools, nextCursor } = await this.#client.listTools({ cursor });
+            return nextCursor ? tools.concat(await fetchTools(nextCursor)) : tools;
+        };
+        return fetchTools();
+    }
+    async #fetchAllResources() {
+        const fetchResources = async (cursor) => {
+            const { resources, nextCursor } = await this.#client.listResources({
+                cursor,
+            });
+            return nextCursor ?
+                resources.concat(await fetchResources(nextCursor))
+                : resources;
+        };
+        return fetchResources();
+    }
+}
+//# sourceMappingURL=Host.js.map

package/dist/core/Host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Host.js","sourceRoot":"","sources":["../../src/core/Host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,iDAAiD,CAAC;AAGhG,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAY1D,MAAM,OAAO,IAAI;IACf,OAAO,CAAS;IAChB,OAAO,CAAS;IAChB,UAAU,GAAG,KAAK,CAAC;IAEnB,YAAY,MAAoB;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CACvB;YACE,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,EACD,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,yBAAyB,EAAE,EAAE,CAC5D,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAA4B;QACxC,SAAS,CACP,CAAC,IAAI,CAAC,UAAU,EAChB,sGAAsG,CACvG,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1E,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEtC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAEvB,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,IAAI,CAAC,cAAc,EAAE;YACrB,IAAI,CAAC,kBAAkB,EAAE;SAC1B,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE;YAClD,KAAK;YACL,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;QAEH,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACxC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,UAAU,GAAG,KAAK,EAAE,MAAe,EAAmB,EAAE;YAC5D,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YAEvE,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC;QAEF,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,MAAM,cAAc,GAAG,KAAK,EAAE,MAAe,EAAuB,EAAE;YACpE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;gBACjE,MAAM;aACP,CAAC,CAAC;YAEH,OAAO,UAAU,CAAC,CAAC;gBACf,SAAS,CAAC,MAAM,CAAC,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;gBACpD,CAAC,CAAC,SAAS,CAAC;QAChB,CAAC,CAAC;QAEF,OAAO,cAAc,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/core/HostConnection.d.ts

@@ -0,0 +1,71 @@
+import { type McpUiResourceCsp, type McpUiResourcePermissions } from "@modelcontextprotocol/ext-apps/app-bridge";
+import type { Client } from "@modelcontextprotocol/sdk/client";
+import type { CallToolResult, Resource, Tool } from "@modelcontextprotocol/sdk/types";
+import { Logger, TypedEventTarget } from "../utilities/index.js";
+export declare namespace HostConnection {
+    interface Options {
+        tools: Tool[];
+        resources: Resource[];
+        logger: Logger;
+    }
+    interface UiResource {
+        html: string;
+        csp: McpUiResourceCsp | undefined;
+        permissions: McpUiResourcePermissions | undefined;
+    }
+    interface Event {
+        close: CustomEvent<never>;
+    }
+    interface ToolExecution {
+        tool: Tool;
+        input: Record<string, unknown> | undefined;
+        resultPromise: Promise<CallToolResult>;
+    }
+}
+export declare class HostConnection extends TypedEventTarget<HostConnection.Event> {
+    #private;
+    private toolsByName;
+    private resourcesByUri;
+    constructor(client: Client, options: HostConnection.Options);
+    /** @internal */
+    get client(): Client<{
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    get closed(): boolean;
+    get logger(): Logger;
+    callTool(name: string, args?: Record<string, unknown>): HostConnection.ToolExecution;
+    close(): Promise<void>;
+    getUiResource(uri: string): Promise<HostConnection.UiResource>;
+}
+//# sourceMappingURL=HostConnection.d.ts.map

package/dist/core/HostConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostConnection.d.ts","sourceRoot":"","sources":["../../src/core/HostConnection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,wBAAwB,EAE9B,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,IAAI,EACL,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAa,MAAM,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC,UAAiB,OAAO;QACtB,KAAK,EAAE,IAAI,EAAE,CAAC;QACd,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;KAChB;IAED,UAAiB,UAAU;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAAC;QAClC,WAAW,EAAE,wBAAwB,GAAG,SAAS,CAAC;KACnD;IAED,UAAiB,KAAK;QACpB,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;KAC3B;IAED,UAAiB,aAAa;QAC5B,IAAI,EAAE,IAAI,CAAC;QACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC3C,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;KACxC;CACF;AAED,qBAAa,cAAe,SAAQ,gBAAgB,CAAC,cAAc,CAAC,KAAK,CAAC;;IAExE,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,cAAc,CAA+B;gBAKzC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO;IAc3D,gBAAgB;IAChB,IAAI,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAET;IAED,IAAI,MAAM,YAET;IAED,IAAI,MAAM,WAET;IAED,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,cAAc,CAAC,aAAa;IAazB,KAAK;IAML,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC;CA8BrE"}

package/dist/core/HostConnection.js

@@ -0,0 +1,57 @@
+import { RESOURCE_MIME_TYPE, } from "@modelcontextprotocol/ext-apps/app-bridge";
+import { invariant, Logger, TypedEventTarget } from "../utilities/index.js";
+export class HostConnection extends TypedEventTarget {
+    #client;
+    toolsByName = new Map();
+    resourcesByUri = new Map();
+    #logger;
+    #closed = false;
+    constructor(client, options) {
+        super();
+        this.#client = client;
+        this.#logger = options.logger;
+        for (const tool of options.tools) {
+            this.toolsByName.set(tool.name, tool);
+        }
+        for (const resource of options.resources) {
+            this.resourcesByUri.set(resource.uri, resource);
+        }
+    }
+    /** @internal */
+    get client() {
+        return this.#client;
+    }
+    get closed() {
+        return this.#closed;
+    }
+    get logger() {
+        return this.#logger;
+    }
+    callTool(name, args) {
+        const tool = this.toolsByName.get(name);
+        invariant(tool, `Tool not found: '${name}'.`);
+        const resultPromise = this.#client.callTool({
+            name,
+            arguments: args,
+        });
+        return { tool, input: args, resultPromise };
+    }
+    async close() {
+        await this.#client.close();
+        this.#closed = true;
+        this.dispatchTypedEvent("close", new CustomEvent("close"));
+    }
+    async getUiResource(uri) {
+        invariant(uri.startsWith("ui://"), `Expected a UI resource URI (ui:// scheme). Got: '${uri}'`);
+        const resource = await this.#client.readResource({ uri });
+        invariant(resource, `Resource not found: '${uri}'.`);
+        invariant(resource.contents.length === 1, `Expected resource to contain exactly 1 content item. Got ${resource.contents.length}.`);
+        const content = resource.contents[0];
+        invariant(content.mimeType === RESOURCE_MIME_TYPE, `Unexpected mime type for resource: '${content.mimeType}'.`);
+        const html = "blob" in content ? atob(content.blob) : content.text;
+        const resourceDef = this.resourcesByUri.get(uri);
+        const meta = (content._meta?.ui ?? resourceDef?._meta?.ui);
+        return { html, csp: meta?.csp, permissions: meta?.permissions };
+    }
+}
+//# sourceMappingURL=HostConnection.js.map

package/dist/core/HostConnection.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,3 @@
+export { Host } from "./Host.js";
+export type { HostConnection } from "./HostConnection.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,2 @@
+export { Host } from "./Host.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/playwright/fixture.d.ts

@@ -0,0 +1,24 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types";
+import { type FrameLocator } from "@playwright/test";
+import type { McpHost } from "./types.js";
+import type { Host } from "../core/index.js";
+declare global {
+    interface Window {
+        __mcpHost: McpHost;
+    }
+}
+export interface CallToolResponse {
+    result: CallToolResult;
+    input: Record<string, unknown> | undefined;
+    appFrame: FrameLocator;
+}
+export interface McpHostConnection {
+    callTool(name: string, args?: Record<string, unknown>): Promise<CallToolResponse>;
+}
+export interface McpHostFixture {
+    connect(options: Host.ConnectOptions): Promise<McpHostConnection>;
+}
+export declare const test: import("playwright/test").TestType<import("playwright/test").PlaywrightTestArgs & import("playwright/test").PlaywrightTestOptions & {
+    mcpHost: McpHostFixture;
+}, import("playwright/test").PlaywrightWorkerArgs & import("playwright/test").PlaywrightWorkerOptions>;
+//# sourceMappingURL=fixture.d.ts.map

package/dist/playwright/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../src/playwright/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,EAAE,OAAO,CAAC;KACpB;CACF;AAID,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC3C,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnE;AAED,eAAO,MAAM,IAAI;aAA0B,cAAc;sGAmCvD,CAAC"}

package/dist/playwright/fixture.js

@@ -0,0 +1,27 @@
+import { test as base } from "@playwright/test";
+const DEFAULT_HARNESS_URL = "http://localhost:8080/";
+export const test = base.extend({
+    mcpHost: async ({ page }, use) => {
+        await page.goto(DEFAULT_HARNESS_URL);
+        const fixture = {
+            async connect(options) {
+                await page.evaluate((url) => window.__mcpHost.connect(url), options.url);
+                return {
+                    async callTool(name, args) {
+                        const response = await page.evaluate(({ name, args }) => window.__mcpHost.callTool(name, args), { name, args });
+                        const appFrame = page
+                            .locator("iframe")
+                            .contentFrame()
+                            .locator("iframe")
+                            .contentFrame();
+                        return { ...response, appFrame };
+                    },
+                };
+            },
+        };
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        await use(fixture);
+        await page.evaluate(() => window.__mcpHost.teardown()).catch(() => { });
+    },
+});
+//# sourceMappingURL=fixture.js.map

package/dist/playwright/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../src/playwright/fixture.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,IAAI,IAAI,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAWnE,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AAmBrD,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAA8B;IAC3D,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE;QAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAErC,MAAM,OAAO,GAAmB;YAC9B,KAAK,CAAC,OAAO,CAAC,OAAO;gBACnB,MAAM,IAAI,CAAC,QAAQ,CACjB,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EACtC,OAAO,CAAC,GAAG,CACZ,CAAC;gBAEF,OAAO;oBACL,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI;wBACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAClC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EACzD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;wBAEF,MAAM,QAAQ,GAAG,IAAI;6BAClB,OAAO,CAAC,QAAQ,CAAC;6BACjB,YAAY,EAAE;6BACd,OAAO,CAAC,QAAQ,CAAC;6BACjB,YAAY,EAAE,CAAC;wBAElB,OAAO,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,CAAC;oBACnC,CAAC;iBACF,CAAC;YACJ,CAAC;SACF,CAAC;QAEF,sDAAsD;QACtD,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;QAEnB,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzE,CAAC;CACF,CAAC,CAAC"}