ue-mcp 1.3.7 → 1.3.8-beta.2

package/dist/flow/schema.d.ts

@@ -676,7 +676,7 @@ export declare const FlowConfigSchema: z.ZodObject<{
     }>, "many">>;
     guards: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
-        scope: z.ZodDefault<z.ZodEnum<["all", "mutations", "writes"]>>;
+        scope: z.ZodDefault<z.ZodEnum<["all", "mutations", "writes", "reads", "unknown"]>>;
         order: z.ZodDefault<z.ZodNumber>;
         before: z.ZodOptional<z.ZodObject<{
             class_path: z.ZodString;
@@ -700,7 +700,7 @@ export declare const FlowConfigSchema: z.ZodObject<{
         }>>;
     }, "strip", z.ZodTypeAny, {
         order: number;
-        scope: "all" | "mutations" | "writes";
+        scope: "unknown" | "all" | "mutations" | "writes" | "reads";
         description?: string | undefined;
         before?: {
             options: Record<string, unknown>;
@@ -711,9 +711,8 @@ export declare const FlowConfigSchema: z.ZodObject<{
             class_path: string;
         } | undefined;
     }, {
-        description?: string | undefined;
         order?: number | undefined;
-        scope?: "all" | "mutations" | "writes" | undefined;
+        description?: string | undefined;
         before?: {
             class_path: string;
             options?: Record<string, unknown> | undefined;
@@ -722,9 +721,10 @@ export declare const FlowConfigSchema: z.ZodObject<{
             class_path: string;
             options?: Record<string, unknown> | undefined;
         } | undefined;
+        scope?: "unknown" | "all" | "mutations" | "writes" | "reads" | undefined;
     }>, {
         order: number;
-        scope: "all" | "mutations" | "writes";
+        scope: "unknown" | "all" | "mutations" | "writes" | "reads";
         description?: string | undefined;
         before?: {
             options: Record<string, unknown>;
@@ -735,9 +735,8 @@ export declare const FlowConfigSchema: z.ZodObject<{
             class_path: string;
         } | undefined;
     }, {
-        description?: string | undefined;
         order?: number | undefined;
-        scope?: "all" | "mutations" | "writes" | undefined;
+        description?: string | undefined;
         before?: {
             class_path: string;
             options?: Record<string, unknown> | undefined;
@@ -746,6 +745,7 @@ export declare const FlowConfigSchema: z.ZodObject<{
             class_path: string;
             options?: Record<string, unknown> | undefined;
         } | undefined;
+        scope?: "unknown" | "all" | "mutations" | "writes" | "reads" | undefined;
     }>>>;
 }, "strip", z.ZodTypeAny, {
     plugins: {
@@ -816,7 +816,7 @@ export declare const FlowConfigSchema: z.ZodObject<{
     }>;
     guards: Record<string, {
         order: number;
-        scope: "all" | "mutations" | "writes";
+        scope: "unknown" | "all" | "mutations" | "writes" | "reads";
         description?: string | undefined;
         before?: {
             options: Record<string, unknown>;
@@ -977,9 +977,8 @@ export declare const FlowConfigSchema: z.ZodObject<{
         max_age_hours?: number | undefined;
     } | undefined;
     guards?: Record<string, {
-        description?: string | undefined;
         order?: number | undefined;
-        scope?: "all" | "mutations" | "writes" | undefined;
+        description?: string | undefined;
         before?: {
             class_path: string;
             options?: Record<string, unknown> | undefined;
@@ -988,6 +987,7 @@ export declare const FlowConfigSchema: z.ZodObject<{
             class_path: string;
             options?: Record<string, unknown> | undefined;
         } | undefined;
+        scope?: "unknown" | "all" | "mutations" | "writes" | "reads" | undefined;
     }> | undefined;
     agents?: Record<string, {
         description?: string | undefined;

package/dist/flow/skill-actions.d.ts

@@ -1,4 +1,4 @@
-import type { ActionSpec, ToolDef } from "../types.js";
+import type { ActionEffect, ActionSpec, ToolDef } from "../types.js";
 /**
  * The flow tool's own actions, the three that are not journal or skill.
  *
@@ -9,6 +9,20 @@ import type { ActionSpec, ToolDef } from "../types.js";
  * tool, so it cannot drift into being the lie it is there to prevent.
  */
 export declare const FLOW_OWN_ACTIONS: readonly ["run", "plan", "list"];
+/**
+ * What each of those three does to the addressed editor.
+ *
+ * Restated here rather than read off the built tool because `flow-tool.ts`
+ * imports this module and importing it back would close a cycle at module
+ * init. `tests/unit/flow-action-contract.test.ts` fails when the two disagree,
+ * so the restatement cannot drift into a second opinion.
+ *
+ * `run` is `mutate` rather than `unknown` even though a flow is only ever
+ * whatever its steps are: a flow of pure reads is theoretically a read, no
+ * flow in this repo or any shipped plugin is one, and both labels gate
+ * identically. The wider answer is the one that stands.
+ */
+export declare const FLOW_OWN_EFFECTS: Record<(typeof FLOW_OWN_ACTIONS)[number], ActionEffect>;
 /** The flow category as a graph entry, for the check to hold packs against. */
 export declare function flowCategoryForCheck(): ToolDef;
 export declare const skillActions: Record<string, ActionSpec>;

package/dist/flow/skill-actions.js

@@ -56,18 +56,35 @@ function discover(ctx) {
  * tool, so it cannot drift into being the lie it is there to prevent.
  */
 export const FLOW_OWN_ACTIONS = ["run", "plan", "list"];
+/**
+ * What each of those three does to the addressed editor.
+ *
+ * Restated here rather than read off the built tool because `flow-tool.ts`
+ * imports this module and importing it back would close a cycle at module
+ * init. `tests/unit/flow-action-contract.test.ts` fails when the two disagree,
+ * so the restatement cannot drift into a second opinion.
+ *
+ * `run` is `mutate` rather than `unknown` even though a flow is only ever
+ * whatever its steps are: a flow of pure reads is theoretically a read, no
+ * flow in this repo or any shipped plugin is one, and both labels gate
+ * identically. The wider answer is the one that stands.
+ */
+export const FLOW_OWN_EFFECTS = {
+    run: "mutate",
+    plan: "read",
+    list: "read",
+};
 /** The flow category as a graph entry, for the check to hold packs against. */
 export function flowCategoryForCheck() {
-    const names = [
-        ...FLOW_OWN_ACTIONS,
-        ...Object.keys(journalActions),
-        ...Object.keys(skillActions),
-    ];
+    const own = Object.entries(FLOW_OWN_EFFECTS).map(([name, effect]) => [name, { kind: "handler", effect, handler: async () => ({}) }]);
     return {
         name: "flow",
         description: "",
         schema: {},
-        actions: Object.fromEntries(names.map((n) => [n, {}])),
+        // The real specs for everything but the three own actions, so a check that
+        // reads an effect off this stand-in reads the declaration rather than a
+        // placeholder that happens to be next to it.
+        actions: { ...Object.fromEntries(own), ...journalActions, ...skillActions },
         handler: async () => ({}),
     };
 }
@@ -86,6 +103,8 @@ function requireProjectDir(ctx, verb) {
 }
 export const skillActions = {
     skill_list: {
+        kind: "handler",
+        effect: "read",
         description: "Every skill pack this server can see: the ones bundled with ue-mcp, the ones contributed by "
             + "loaded plugins (any plugin package shipping skills/<name>/SKILL.md), and the ones installed "
             + "into this project's .claude/skills. Each row carries the description an agent reads to decide "
@@ -95,6 +114,8 @@ export const skillActions = {
         handler: async (ctx, params) => skillList(ctx, params),
     },
     skill_get: {
+        kind: "handler",
+        effect: "read",
         description: "One skill pack in full, optionally including its markdown, so an agent can read the workflow "
             + "without leaving the tool surface. Reports whether the project's installed copy matches the "
             + "available one, which is how a stale install is spotted. Params: skillName, includeBody? "
@@ -102,6 +123,8 @@ export const skillActions = {
         handler: async (ctx, params) => skillGet(ctx, params),
     },
     skill_check: {
+        kind: "handler",
+        effect: "read",
         description: "Verify every skill pack against the live action surface. A pack is prose that names calls, so a "
             + "renamed or removed action leaves a document that teaches a call the server refuses; this reads "
             + "every category(action=\"x\") out of every pack and reports the ones that no longer resolve, with "
@@ -112,6 +135,8 @@ export const skillActions = {
         handler: async (ctx) => skillCheck(ctx),
     },
     skill_install: {
+        kind: "handler",
+        effect: "mutate",
         description: "Copy skill packs into this project's .claude/skills, SKILL.md and ue-mcp.yml sidecar together. "
             + "Idempotent and specific about it: a pack whose destination already holds the same bytes comes "
             + "back as unchanged rather than counted as installed, so a repeat call is distinguishable from a "
@@ -121,6 +146,8 @@ export const skillActions = {
         handler: async (ctx, params) => skillInstall(ctx, params),
     },
     skill_remove: {
+        kind: "handler",
+        effect: "mutate",
         description: "Remove installed skill packs from this project's .claude/skills. Deletes the SKILL.md and its "
             + "sidecar, then the pack directory only if it ends up empty and the skills directory only if it "
             + "does too, so anything the user added alongside survives. Idempotent: a pack that was not "

package/dist/flow/skill-actions.js.map

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

package/dist/flow/write-methods.d.ts

@@ -1,27 +1,3 @@
-/**
- * Write classification for the source-control guard.
- *
- * The guard needs to know, for a given bridge method + params, which asset
- * content paths the call is about to modify, so it can check them out (or refuse
- * on a human's lock) BEFORE the write reaches disk. This module is the single
- * place that encodes that knowledge.
- *
- * Two layers:
- *   1. An explicit map for methods whose path lives under an unusual param
- *      shape (batches, rename descriptors).
- *   2. A verb+param heuristic for the common case: a method named with a write
- *      verb (`save_`, `set_`, ...) carrying a recognizable asset-path param.
- *
- * Classification returns UE content paths (e.g. "/Game/Foo"). Resolving those to
- * on-disk files, and deciding which already exist (modify -> checkout) versus do
- * not (create -> skip, it will be `p4 add`ed later), is the caller's job.
- *
- * Design note: this is intentionally conservative. An unmapped write falls
- * through as "not a write" (fail-open). The cost of a miss is that the agent
- * hits Unreal's own read-only failure and can check out explicitly - visible,
- * not silent corruption. The cost of a false positive is an unnecessary
- * checkout, which takes a lock. We bias toward not over-locking.
- */
 export interface WriteClassification {
     /**
      * Whether this call modifies named content, which is what a source-control

package/dist/flow/write-methods.js

@@ -9,8 +9,19 @@
  * Two layers:
  *   1. An explicit map for methods whose path lives under an unusual param
  *      shape (batches, rename descriptors).
- *   2. A verb+param heuristic for the common case: a method named with a write
- *      verb (`save_`, `set_`, ...) carrying a recognizable asset-path param.
+ *   2. The method's DECLARED effect plus a recognizable asset-path param. A
+ *      declared read writes nothing whatever path it was handed; anything else
+ *      is a candidate.
+ *
+ * Layer two used to be a hand-written list of write verbs matched against the
+ * method NAME, and the list is gone rather than kept as a fallback: there is
+ * nothing left for it to answer. `bridgeMethodEffect` has no undefined case,
+ * so every method reaching here has an effect from the actions that forward to
+ * it, from the table of methods a handler calls directly, or from the default
+ * that treats an unrecognised method as a change. The list was also wrong in
+ * the expensive direction: `unwrap_uvs` rewrites a mesh's UV layout in place
+ * and `mesh_boolean` overwrites a StaticMesh package, and neither matched it,
+ * so neither was ever checked out before the write reached disk.
  *
  * Classification returns UE content paths (e.g. "/Game/Foo"). Resolving those to
  * on-disk files, and deciding which already exist (modify -> checkout) versus do
@@ -22,8 +33,7 @@
  * not silent corruption. The cost of a false positive is an unnecessary
  * checkout, which takes a lock. We bias toward not over-locking.
  */
-/** Method-name prefixes that denote a mutation. Read verbs are excluded. */
-const WRITE_VERB = /^(save|set|create|add|delete|remove|import|rename|move|duplicate|reparent|compile|apply|assign|modify|bake|generate|build)_/;
+import { bridgeMethodEffect } from "../action-effects.js";
 /** Single-value params that carry an asset content path. */
 const PATH_KEYS = ["assetPath", "sourcePath", "destinationPath", "packagePath", "path"];
 /** Array params that carry asset content paths. */
@@ -119,7 +129,13 @@ export function classifyWrite(method, params) {
         const contentPaths = dedupe(explicit(params));
         return { writes: contentPaths.length > 0, contentPaths };
     }
-    if (!WRITE_VERB.test(method)) {
+    // A declared read writes no content, whatever path it was handed. Anything
+    // else is a candidate, whatever its name looks like. `unknown` is a
+    // candidate for the same reason it gates like a mutation everywhere else,
+    // and an unnecessary checkout is the cheap side of this decision.
+    // With the parameters, so a wrapped engine tool is judged by which tool it
+    // is rather than by the one method all 830 of them share.
+    if (bridgeMethodEffect(method, params).effect === "read") {
         return { writes: false, contentPaths: [] };
     }
     const contentPaths = [];

package/dist/flow/write-methods.js.map

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

package/dist/guard-task.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Public guard-authoring surface for ue-mcp.
+ *
+ * A guard is not a task. `flow/guards.ts` has said so since guards stopped
+ * being tasks whose NAME encoded their phase and scope, and the declaration
+ * side reflects it: a guard is declared with `scope`, `order`, `before` and
+ * `after`, and is merely IMPLEMENTED BY a task named by `class_path`.
+ *
+ * The authoring side did not reflect it. Writing a guard meant extending
+ * `UeMcpTask` and implementing `execute()`, which left three things wrong:
+ *
+ *   Nothing was typed. `this.options` is `Record<string, unknown>`, so every
+ *   guard cast or guessed its way to `method` and `paths`.
+ *
+ *   Configuration and subject shared one namespace. The declared `options` and
+ *   the call being guarded were flattened into one bag, and the call won any
+ *   collision, so a guard with an option named `method` silently lost it.
+ *
+ *   The phase was implicit. One `execute()` served both hooks, and a class
+ *   used for both could only tell them apart by sniffing for a `result` key.
+ *   `TaskResult.data` meanwhile means "replace the call's result" after the
+ *   call and means nothing before it.
+ *
+ * `UeMcpGuard` fixes all three without moving the runtime: it still registers
+ * as a task, so `class_path` resolution, plugin loading and the pipeline are
+ * unchanged, and a guard written against `UeMcpTask` keeps working exactly as
+ * it did.
+ *
+ * ```ts
+ * import { UeMcpGuard, type GuardedCall } from "ue-mcp/guard";
+ *
+ * export default class Freeze extends UeMcpGuard<{ enabled?: boolean }> {
+ *   get taskName() { return "freeze"; }
+ *   async before(call: GuardedCall) {
+ *     if (this.config.enabled === false) return this.allow();
+ *     return this.deny(`Blocked '${call.method}'.`);
+ *   }
+ * }
+ * ```
+ */
+import type { TaskResult } from "@db-lyon/flowkit";
+import type { EditorSession } from "./session.js";
+import { UeMcpTask } from "./task.js";
+/**
+ * Where the pipeline puts the call being guarded, and the guard's own declared
+ * options, so the two cannot collide with each other or with anything a guard
+ * chooses to name.
+ *
+ * Reserved keys rather than symbols: the options object crosses the task
+ * registry, and a key that survives being spread is the one thing that has to
+ * hold. Both are also still flattened into the bag alongside these, because a
+ * guard written against `UeMcpTask` reads them there and must keep working.
+ */
+export declare const GUARD_CALL_KEY = "__ueMcpGuardCall";
+export declare const GUARD_CONFIG_KEY = "__ueMcpGuardConfig";
+/** Which hook is running. */
+export type GuardPhase = "before" | "after";
+/** The call a guard is being asked about. */
+export interface GuardedCall {
+    /** Which hook this is. */
+    readonly phase: GuardPhase;
+    /** The bridge method. For a wrapped engine tool this is `epic_call_tool`. */
+    readonly method: string;
+    /** The arguments the call carries. */
+    readonly params: Record<string, unknown>;
+    /**
+     * Existing files on disk the call would modify. Empty for a read, and empty
+     * for a mutation that names no content path, which is why a guard that wants
+     * "everything that changes" is declared `scope: mutations` rather than
+     * inferring it from this being non-empty.
+     */
+    readonly paths: readonly string[];
+    /** The editor this call is bound to, when it has one. */
+    readonly session?: EditorSession;
+}
+/** What a `before` hook answers. Build one with `allow()` or `deny()`. */
+export type GuardVerdict = TaskResult;
+/** The payload `flow/guards.ts` hands a guard task. */
+export interface GuardHookPayload {
+    phase: GuardPhase;
+    method: string;
+    params: Record<string, unknown>;
+    paths: string[];
+    result?: unknown;
+    session?: EditorSession;
+}
+/**
+ * Base class for a ue-mcp guard.
+ *
+ * Implement `before`, `after`, or both. `execute()` is wired once here and
+ * routes to whichever the pipeline asked for, so the phase is a signature
+ * rather than something to detect.
+ */
+export declare abstract class UeMcpGuard<TConfig = Record<string, unknown>> extends UeMcpTask {
+    /**
+     * The options this guard was DECLARED with, and nothing else.
+     *
+     * `this.options` still holds the flattened bag for compatibility. This is
+     * the one to read: the call being guarded cannot mask a key of yours in it.
+     */
+    protected get config(): TConfig;
+    /** Let the call proceed. */
+    protected allow(): GuardVerdict;
+    /**
+     * Refuse the call. The reason reaches the caller as a WRITE_BLOCKED error,
+     * so write it for whoever is about to read it in an agent transcript.
+     */
+    protected deny(reason: string): GuardVerdict;
+    /**
+     * Runs before the call. Returning `deny()` stops it; the call never happens.
+     * Throwing denies it too, because a guard that errored is not one that
+     * approved.
+     */
+    protected before?(call: GuardedCall): Promise<GuardVerdict> | GuardVerdict;
+    /**
+     * Runs after a call that succeeded, and cannot deny it: it already happened.
+     * Return an object to REPLACE the result, or nothing to leave it alone.
+     *
+     * An object rather than anything, because that is what the pipeline can
+     * actually carry: a replacement travels back as a task result's `data`, and
+     * a scalar there has nowhere to go.
+     */
+    protected after?(call: GuardedCall, result: unknown): Promise<Record<string, unknown> | void> | Record<string, unknown> | void;
+    execute(): Promise<TaskResult>;
+}

package/dist/guard-task.js

@@ -0,0 +1,85 @@
+import { UeMcpTask } from "./task.js";
+/**
+ * Where the pipeline puts the call being guarded, and the guard's own declared
+ * options, so the two cannot collide with each other or with anything a guard
+ * chooses to name.
+ *
+ * Reserved keys rather than symbols: the options object crosses the task
+ * registry, and a key that survives being spread is the one thing that has to
+ * hold. Both are also still flattened into the bag alongside these, because a
+ * guard written against `UeMcpTask` reads them there and must keep working.
+ */
+export const GUARD_CALL_KEY = "__ueMcpGuardCall";
+export const GUARD_CONFIG_KEY = "__ueMcpGuardConfig";
+/**
+ * Base class for a ue-mcp guard.
+ *
+ * Implement `before`, `after`, or both. `execute()` is wired once here and
+ * routes to whichever the pipeline asked for, so the phase is a signature
+ * rather than something to detect.
+ */
+export class UeMcpGuard extends UeMcpTask {
+    /**
+     * The options this guard was DECLARED with, and nothing else.
+     *
+     * `this.options` still holds the flattened bag for compatibility. This is
+     * the one to read: the call being guarded cannot mask a key of yours in it.
+     */
+    get config() {
+        const bag = this.options;
+        return (bag[GUARD_CONFIG_KEY] ?? {});
+    }
+    /** Let the call proceed. */
+    allow() {
+        return { success: true };
+    }
+    /**
+     * Refuse the call. The reason reaches the caller as a WRITE_BLOCKED error,
+     * so write it for whoever is about to read it in an agent transcript.
+     */
+    deny(reason) {
+        return { success: false, error: new Error(reason) };
+    }
+    async execute() {
+        const bag = (this.options ?? {});
+        const payload = bag[GUARD_CALL_KEY];
+        if (!payload) {
+            // Reached by invoking a guard as an ordinary task, which nothing in the
+            // pipeline does. Said plainly rather than reported as a guard that
+            // approved, because a guard that silently allows is the failure mode
+            // this whole layer exists to prevent.
+            return {
+                success: false,
+                error: new Error(`${this.taskName} is a guard and was run as a task. Guards are invoked by the `
+                    + "bridge pipeline from a `guards:` declaration, not called directly."),
+            };
+        }
+        const call = {
+            phase: payload.phase,
+            method: payload.method,
+            params: payload.params,
+            paths: payload.paths,
+            session: payload.session,
+        };
+        if (call.phase === "before") {
+            if (!this.before) {
+                return {
+                    success: false,
+                    error: new Error(`${this.taskName} is declared as a 'before' hook but implements no before().`),
+                };
+            }
+            return await this.before(call);
+        }
+        if (!this.after) {
+            return {
+                success: false,
+                error: new Error(`${this.taskName} is declared as an 'after' hook but implements no after().`),
+            };
+        }
+        const replacement = await this.after(call, payload.result);
+        // `data` is how the pipeline replaces a result. Returning nothing leaves
+        // the call's own result standing, which is the common case for an audit.
+        return replacement === undefined ? { success: true } : { success: true, data: replacement };
+    }
+}
+//# sourceMappingURL=guard-task.js.map

package/dist/guard-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-task.js","sourceRoot":"","sources":["../src/guard-task.ts"],"names":[],"mappings":"AA0CA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAqCrD;;;;;;GAMG;AACH,MAAM,OAAgB,UAA8C,SAAQ,SAAS;IACnF;;;;;OAKG;IACH,IAAc,MAAM;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAkC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAY,CAAC;IAClD,CAAC;IAED,4BAA4B;IAClB,KAAK;QACb,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACO,IAAI,CAAC,MAAc;QAC3B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;IACtD,CAAC;IAsBD,KAAK,CAAC,OAAO;QACX,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;QAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,CAAiC,CAAC;QACpE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,wEAAwE;YACxE,mEAAmE;YACnE,qEAAqE;YACrE,sCAAsC;YACtC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,KAAK,CACd,GAAG,IAAI,CAAC,QAAQ,+DAA+D;sBAC7E,oEAAoE,CACvE;aACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAgB;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,IAAI,KAAK,CACd,GAAG,IAAI,CAAC,QAAQ,6DAA6D,CAC9E;iBACF,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,KAAK,CACd,GAAG,IAAI,CAAC,QAAQ,4DAA4D,CAC7E;aACF,CAAC;QACJ,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3D,yEAAyE;QACzE,yEAAyE;QACzE,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC9F,CAAC;CACF"}