harness-mix 0.1.0

package/src/native-ui/desktop-control/dist/renderer-cdp-control-session.d.ts

@@ -0,0 +1,49 @@
+import { type CdpClientOptions, type CdpFetch, type CdpTarget } from "./cdp-client.js";
+import { type RendererDraftPrewarmPolicyStatus } from "./renderer-draft-prewarm-policy.js";
+export interface ProductionRendererStatus {
+    version: 2;
+    enabledAgents: string[];
+    adapter: {
+        state: "ready";
+        reason: string;
+    };
+}
+export interface RendererCdpControlSnapshot {
+    target: CdpTarget;
+    draftPrewarmPolicy: RendererDraftPrewarmPolicyStatus;
+    binding: ProductionRendererStatus;
+}
+interface RendererCdpClient {
+    command(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    evaluate<T>(expression: string): Promise<T>;
+    close(): void;
+}
+interface RendererCdpControlOperations {
+    listTargets(endpoint: string): Promise<CdpTarget[]>;
+    connect(webSocketDebuggerUrl: string): Promise<RendererCdpClient>;
+    installDraftPrewarmPolicy(renderer: RendererCdpClient): Promise<RendererDraftPrewarmPolicyStatus>;
+}
+export interface RendererCdpControlSession {
+    readonly snapshot: RendererCdpControlSnapshot;
+    ensureInstalled(): Promise<RendererCdpControlSnapshot>;
+    activateDesktop(): Promise<number>;
+    executeRenderer<T>(expression: string): Promise<T>;
+    close(): void;
+}
+export interface InstallRendererCdpControlOptions {
+    rendererCdpEndpoint: string;
+    rendererSource: string;
+    enabledAgents?: readonly string[];
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+}
+interface CreateRendererCdpControlOptions extends InstallRendererCdpControlOptions {
+    operations?: RendererCdpControlOperations;
+}
+export declare function selectPrimaryRendererTarget(targets: readonly CdpTarget[], preferredTargetId?: string): CdpTarget | null;
+export declare function createRendererCdpControlSession(options: CreateRendererCdpControlOptions): Promise<RendererCdpControlSession>;
+export declare function installRendererCdpControlSession(options: InstallRendererCdpControlOptions): Promise<RendererCdpControlSession>;
+export type RendererCdpFetch = CdpFetch;
+export type RendererCdpClientOptions = CdpClientOptions;
+export {};
+//# sourceMappingURL=renderer-cdp-control-session.d.ts.map

package/src/native-ui/desktop-control/dist/renderer-cdp-control-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-cdp-control-session.d.ts","sourceRoot":"","sources":["../src/renderer-cdp-control-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,SAAS,CAAC;IAClB,kBAAkB,EAAE,gCAAgC,CAAC;IACrD,OAAO,EAAE,wBAAwB,CAAC;CACnC;AAED,UAAU,iBAAiB;IACzB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,UAAU,4BAA4B;IACpC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClE,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAAC;CACnG;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,eAAe,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvD,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,gCAAgC;IAC/C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,+BAAgC,SAAQ,gCAAgC;IAChF,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AA+BD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,SAAS,EAAE,EAC7B,iBAAiB,CAAC,EAAE,MAAM,GACzB,SAAS,GAAG,IAAI,CAKlB;AA6ND,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,yBAAyB,CAAC,CA6BpC;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,yBAAyB,CAAC,CAEpC;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACxC,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAC"}

package/src/native-ui/desktop-control/dist/renderer-cdp-control-session.js

@@ -0,0 +1,214 @@
+import { CdpClient, listCdpTargets, } from "./cdp-client.js";
+import { installRendererDraftPrewarmPolicyDirect, } from "./renderer-draft-prewarm-policy.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function sleep(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+function sameAgents(actual, expected) {
+    return (actual.length === expected.length && actual.every((agent, index) => agent === expected[index]));
+}
+function isPrimaryRendererUrl(value) {
+    try {
+        const url = new URL(value);
+        return (url.protocol === "app:" &&
+            url.hostname === "-" &&
+            url.pathname === "/index.html" &&
+            url.search === "" &&
+            url.hash === "");
+    }
+    catch {
+        return false;
+    }
+}
+export function selectPrimaryRendererTarget(targets, preferredTargetId) {
+    const candidates = targets.filter((target) => target.type === "page" && isPrimaryRendererUrl(target.url));
+    return candidates.find((target) => target.id === preferredTargetId) ?? candidates.at(0) ?? null;
+}
+class RendererAdapterReadinessError extends Error {
+    state;
+    reason;
+    constructor(state, reason) {
+        super(`Production Renderer Adapter is ${state}: ${reason}`);
+        this.state = state;
+        this.reason = reason;
+        this.name = "RendererAdapterReadinessError";
+    }
+}
+function validateBindingStatus(value, expectedAgents) {
+    if (!isRecord(value) ||
+        value.version !== 2 ||
+        !Array.isArray(value.enabledAgents) ||
+        value.enabledAgents.some((agent) => typeof agent !== "string") ||
+        !sameAgents(value.enabledAgents, expectedAgents) ||
+        !isRecord(value.adapter)) {
+        throw new Error("Production Renderer binding returned an invalid status");
+    }
+    if (value.adapter.state !== "ready" || typeof value.adapter.reason !== "string") {
+        const state = typeof value.adapter.state === "string" ? value.adapter.state : "invalid";
+        const reason = typeof value.adapter.reason === "string" ? value.adapter.reason : "unknown";
+        throw new RendererAdapterReadinessError(state, reason);
+    }
+    return value;
+}
+async function waitForPrimaryTarget(endpoint, operations, timeoutMs, pollIntervalMs, preferredTargetId) {
+    const deadline = Date.now() + timeoutMs;
+    let lastError;
+    while (Date.now() < deadline) {
+        try {
+            const target = selectPrimaryRendererTarget(await operations.listTargets(endpoint), preferredTargetId);
+            if (target)
+                return target;
+            lastError = new Error("Renderer CDP has no primary app://-/index.html page target");
+        }
+        catch (error) {
+            lastError = error;
+        }
+        await sleep(pollIntervalMs);
+    }
+    const detail = lastError instanceof Error ? `: ${lastError.message}` : "";
+    throw new Error(`Primary Codex Renderer CDP target did not become ready${detail}`);
+}
+async function evaluateSource(renderer, source) {
+    const response = await renderer.command("Runtime.evaluate", {
+        expression: source,
+        awaitPromise: true,
+    });
+    if (!isRecord(response))
+        throw new Error("Renderer source evaluation returned an invalid result");
+    if (isRecord(response.exceptionDetails)) {
+        const text = typeof response.exceptionDetails.text === "string"
+            ? response.exceptionDetails.text
+            : "Renderer source evaluation failed";
+        throw new Error(text);
+    }
+}
+async function readBinding(renderer) {
+    return renderer.evaluate("window.__codexhostRendererBindingProbeV1?.status() ?? null");
+}
+async function waitForBinding(renderer, enabledAgents, timeoutMs, pollIntervalMs) {
+    const deadline = Date.now() + timeoutMs;
+    let lastError;
+    while (Date.now() < deadline) {
+        try {
+            const value = await readBinding(renderer);
+            if (value !== null)
+                return validateBindingStatus(value, enabledAgents);
+        }
+        catch (error) {
+            lastError = error;
+            if (error instanceof RendererAdapterReadinessError && error.state !== "installing") {
+                throw error;
+            }
+        }
+        await sleep(pollIntervalMs);
+    }
+    const detail = lastError instanceof Error ? `: ${lastError.message}` : "";
+    throw new Error(`Production Renderer binding did not become ready${detail}`);
+}
+async function installTarget(target, rendererSource, enabledAgents, timeoutMs, pollIntervalMs, operations) {
+    const renderer = await operations.connect(target.webSocketDebuggerUrl);
+    try {
+        await renderer.command("Runtime.enable");
+        await renderer.command("Page.enable");
+        await renderer.command("Page.addScriptToEvaluateOnNewDocument", { source: rendererSource });
+        await evaluateSource(renderer, rendererSource);
+        const draftPrewarmPolicy = await operations.installDraftPrewarmPolicy(renderer);
+        const binding = await waitForBinding(renderer, enabledAgents, timeoutMs, pollIntervalMs);
+        return { renderer, snapshot: { target, draftPrewarmPolicy, binding } };
+    }
+    catch (error) {
+        renderer.close();
+        throw error;
+    }
+}
+class InstalledRendererCdpControlSession {
+    renderer;
+    rendererCdpEndpoint;
+    rendererSource;
+    enabledAgents;
+    timeoutMs;
+    pollIntervalMs;
+    operations;
+    currentSnapshot;
+    #closed = false;
+    constructor(renderer, rendererCdpEndpoint, rendererSource, enabledAgents, timeoutMs, pollIntervalMs, operations, currentSnapshot) {
+        this.renderer = renderer;
+        this.rendererCdpEndpoint = rendererCdpEndpoint;
+        this.rendererSource = rendererSource;
+        this.enabledAgents = enabledAgents;
+        this.timeoutMs = timeoutMs;
+        this.pollIntervalMs = pollIntervalMs;
+        this.operations = operations;
+        this.currentSnapshot = currentSnapshot;
+    }
+    get snapshot() {
+        return this.currentSnapshot;
+    }
+    async ensureInstalled() {
+        if (this.#closed)
+            throw new Error("Renderer CDP Control Session is closed");
+        const target = await waitForPrimaryTarget(this.rendererCdpEndpoint, this.operations, this.timeoutMs, this.pollIntervalMs, this.currentSnapshot.target.id);
+        if (target.id !== this.currentSnapshot.target.id) {
+            const replacement = await installTarget(target, this.rendererSource, this.enabledAgents, this.timeoutMs, this.pollIntervalMs, this.operations);
+            this.renderer.close();
+            this.renderer = replacement.renderer;
+            this.currentSnapshot = replacement.snapshot;
+            return this.currentSnapshot;
+        }
+        try {
+            const existing = await readBinding(this.renderer);
+            if (existing === null)
+                await evaluateSource(this.renderer, this.rendererSource);
+            else
+                validateBindingStatus(existing, this.enabledAgents);
+            const draftPrewarmPolicy = await this.operations.installDraftPrewarmPolicy(this.renderer);
+            const binding = await waitForBinding(this.renderer, this.enabledAgents, this.timeoutMs, this.pollIntervalMs);
+            this.currentSnapshot = { target, draftPrewarmPolicy, binding };
+            return this.currentSnapshot;
+        }
+        catch {
+            const replacement = await installTarget(target, this.rendererSource, this.enabledAgents, this.timeoutMs, this.pollIntervalMs, this.operations);
+            this.renderer.close();
+            this.renderer = replacement.renderer;
+            this.currentSnapshot = replacement.snapshot;
+            return this.currentSnapshot;
+        }
+    }
+    async activateDesktop() {
+        if (this.#closed)
+            throw new Error("Renderer CDP Control Session is closed");
+        await this.renderer.command("Page.bringToFront");
+        return 1;
+    }
+    executeRenderer(expression) {
+        if (this.#closed)
+            return Promise.reject(new Error("Renderer CDP Control Session is closed"));
+        return this.renderer.evaluate(expression);
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.renderer.close();
+    }
+}
+const defaultOperations = {
+    listTargets: (endpoint) => listCdpTargets(endpoint),
+    connect: (webSocketDebuggerUrl) => CdpClient.connect(webSocketDebuggerUrl),
+    installDraftPrewarmPolicy: installRendererDraftPrewarmPolicyDirect,
+};
+export async function createRendererCdpControlSession(options) {
+    const enabledAgents = options.enabledAgents ?? ["codex", "pi"];
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const pollIntervalMs = options.pollIntervalMs ?? 250;
+    const operations = options.operations ?? defaultOperations;
+    const target = await waitForPrimaryTarget(options.rendererCdpEndpoint, operations, timeoutMs, pollIntervalMs);
+    const installed = await installTarget(target, options.rendererSource, enabledAgents, timeoutMs, pollIntervalMs, operations);
+    return new InstalledRendererCdpControlSession(installed.renderer, options.rendererCdpEndpoint, options.rendererSource, enabledAgents, timeoutMs, pollIntervalMs, operations, installed.snapshot);
+}
+export function installRendererCdpControlSession(options) {
+    return createRendererCdpControlSession(options);
+}
+//# sourceMappingURL=renderer-cdp-control-session.js.map

package/src/native-ui/desktop-control/dist/renderer-cdp-control-session.js.map

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

package/src/native-ui/desktop-control/dist/renderer-control-session.d.ts

@@ -0,0 +1,79 @@
+import { type CdpFetch, type CdpTarget } from "./cdp-client.js";
+import { type MainProcessTitlePolicyCounters, type MainProcessTitlePolicyStatus, type RendererTitlePolicyReadiness } from "./main-process-title-policy.js";
+import { type RendererDraftPrewarmPolicyStatus } from "./renderer-draft-prewarm-policy.js";
+export interface ElectronRendererSummary {
+    id: number;
+    type: string;
+    surface: "primary" | "overlay";
+    runtime: {
+        available: boolean;
+        elementCount: number | null;
+    };
+}
+export interface ProductionRendererStatus {
+    version: 2;
+    enabledAgents: string[];
+    adapter: {
+        state: "ready";
+        reason: string;
+    };
+}
+export interface RendererControlSnapshot {
+    renderer: ElectronRendererSummary;
+    titlePolicy: MainProcessTitlePolicyStatus;
+    titlePolicyReadiness: RendererTitlePolicyReadiness;
+    draftPrewarmPolicy: RendererDraftPrewarmPolicyStatus;
+    binding: ProductionRendererStatus;
+}
+interface RendererInspector {
+    command(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    evaluate<T>(expression: string): Promise<T>;
+    close(): void;
+}
+interface RendererControlOperations {
+    inspect(inspector: RendererInspector): Promise<ElectronRendererSummary[]>;
+    installTitlePolicy(inspector: RendererInspector, rendererWebContentsId: number): Promise<MainProcessTitlePolicyStatus>;
+    markTitlePolicyReady(inspector: RendererInspector, rendererWebContentsId: number): Promise<RendererTitlePolicyReadiness>;
+    installDraftPrewarmPolicy(inspector: RendererInspector, rendererWebContentsId: number): Promise<RendererDraftPrewarmPolicyStatus>;
+    reload(inspector: RendererInspector, rendererWebContentsId: number): Promise<void>;
+    execute(inspector: RendererInspector, rendererWebContentsId: number, source: string): Promise<unknown>;
+    readBinding(inspector: RendererInspector, rendererWebContentsId: number): Promise<unknown>;
+    readTitlePolicyCounters(inspector: RendererInspector): Promise<MainProcessTitlePolicyCounters | null>;
+}
+export interface RendererControlSession {
+    readonly snapshot: RendererControlSnapshot;
+    ensureInstalled(): Promise<RendererControlSnapshot>;
+    activateDesktop(): Promise<number>;
+    executeRenderer<T>(expression: string): Promise<T>;
+    readTitlePolicyCounters(): Promise<MainProcessTitlePolicyCounters | null>;
+    close(): void;
+}
+export interface InstallRendererControlOptions {
+    inspectorEndpoint: string;
+    rendererSource: string;
+    enabledAgents?: readonly string[];
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+}
+interface CreateRendererControlOptions extends InstallRendererControlOptions {
+    inspector: RendererInspector;
+    operations?: RendererControlOperations;
+}
+export declare function selectRendererWebContents(contents: readonly ElectronRendererSummary[], preferredRendererId?: number): ElectronRendererSummary | null;
+export declare function waitForRendererTitlePolicyReady(markReadiness: () => Promise<RendererTitlePolicyReadiness>, options?: {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    now?: () => number;
+    sleep?: (milliseconds: number) => Promise<void>;
+}): Promise<RendererTitlePolicyReadiness>;
+export declare function waitForInspectorTarget(endpoint: string, options?: {
+    fetchImpl?: CdpFetch;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+}): Promise<CdpTarget>;
+export declare function inspectElectronWebContents(inspector: Pick<RendererInspector, "evaluate">): Promise<ElectronRendererSummary[]>;
+export declare function activateElectronDesktop(inspector: Pick<RendererInspector, "evaluate">): Promise<number>;
+export declare function createRendererControlSession(options: CreateRendererControlOptions): Promise<RendererControlSession>;
+export declare function installRendererControlSession(options: InstallRendererControlOptions): Promise<RendererControlSession>;
+export {};
+//# sourceMappingURL=renderer-control-session.d.ts.map

package/src/native-ui/desktop-control/dist/renderer-control-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-control-session.d.ts","sourceRoot":"","sources":["../src/renderer-control-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAIL,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE;QACP,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,WAAW,EAAE,4BAA4B,CAAC;IAC1C,oBAAoB,EAAE,4BAA4B,CAAC;IACnD,kBAAkB,EAAE,gCAAgC,CAAC;IACrD,OAAO,EAAE,wBAAwB,CAAC;CACnC;AAED,UAAU,iBAAiB;IACzB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,UAAU,yBAAyB;IACjC,OAAO,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC1E,kBAAkB,CAChB,SAAS,EAAE,iBAAiB,EAC5B,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACzC,oBAAoB,CAClB,SAAS,EAAE,iBAAiB,EAC5B,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACzC,yBAAyB,CACvB,SAAS,EAAE,iBAAiB,EAC5B,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC7C,MAAM,CAAC,SAAS,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,OAAO,CACL,SAAS,EAAE,iBAAiB,EAC5B,qBAAqB,EAAE,MAAM,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,WAAW,CAAC,SAAS,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3F,uBAAuB,CACrB,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,eAAe,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpD,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnD,uBAAuB,IAAI,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAAC;IAC1E,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,4BAA6B,SAAQ,6BAA6B;IAC1E,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC;AAgDD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,EAC5C,mBAAmB,CAAC,EAAE,MAAM,GAC3B,uBAAuB,GAAG,IAAI,CAkBhC;AAED,wBAAsB,+BAA+B,CACnD,aAAa,EAAE,MAAM,OAAO,CAAC,4BAA4B,CAAC,EAC1D,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C,GACL,OAAO,CAAC,4BAA4B,CAAC,CAiBvC;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,SAAS,CAAC,CAkBpB;AAcD,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,GAC7C,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAgDpC;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,GAC7C,OAAO,CAAC,MAAM,CAAC,CAejB;AAgND,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA0DjC;AAED,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,sBAAsB,CAAC,CAuBjC"}