@timurproko/a1 0.1.0

package/dist/src/foundation/release/update.js

@@ -0,0 +1,316 @@
+import { spawn } from "node:child_process";
+import { access, readFile, realpath } from "node:fs/promises";
+import { connect } from "node:net";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import crossSpawn from "cross-spawn";
+import { valid as validSemver } from "semver";
+import { certifyMaterializedRelease, probeOwnership, readEndpointMetadata, removeEndpointArtifacts, startSupervisor, waitForProcessExit, waitForVerifiedEndpoint, } from "./bootstrap.js";
+import { resolveAddOnePaths } from "../lifecycle/index.js";
+import { encodeFrame, LineFrameDecoder } from "../protocol/index.js";
+import { CohortStateStore } from "./cohort-state.js";
+import { cleanupVerifiedOwner, processIsAlive } from "./process-cleanup.js";
+import { materializeRelease, readMaterializedRelease } from "./release-store.js";
+import { UpdateTransactionStore } from "./update-transaction.js";
+export const ADDONE_PACKAGE = "@timurproko/a1";
+const UPDATE_DIST_TAGS = { stable: "latest", next: "next" };
+const defaultFileSystem = {
+    async readFile(path) { return await readFile(path, "utf8"); },
+    realpath,
+    access,
+};
+const defaultOutput = {
+    stdout(message) { process.stdout.write(message); },
+    stderr(message) { process.stderr.write(message); },
+};
+export function createNpmProcessRunner(platform = process.platform) {
+    return async (command, arguments_, request) => await new Promise((resolvePromise, rejectPromise) => {
+        const stdio = request.captureStdout ? ["ignore", "pipe", "inherit"] : ["inherit", "inherit", "inherit"];
+        const child = platform === "win32" ? crossSpawn(command, [...arguments_], { stdio }) : spawn(command, [...arguments_], { stdio });
+        const stdout = [];
+        child.stdout?.on("data", chunk => stdout.push(Buffer.from(chunk)));
+        let settled = false;
+        child.once("error", error => { if (!settled) {
+            settled = true;
+            rejectPromise(error);
+        } });
+        child.once("close", code => { if (!settled) {
+            settled = true;
+            resolvePromise({ code, stdout: Buffer.concat(stdout).toString("utf8") });
+        } });
+    });
+}
+export function createUpdateLifecycleCoordinator(environment = process.env, fileSystem = defaultFileSystem) {
+    const paths = resolveAddOnePaths(environment);
+    const stateStore = new CohortStateStore(paths.dataDir);
+    return {
+        async targetIsActive(targetVersion) {
+            const state = await stateStore.read();
+            const activeId = state.references.active;
+            if (!activeId || state.releases[activeId]?.packageVersion !== targetVersion)
+                return false;
+            const endpoint = await readEndpointMetadata(paths.endpointMetadataPath);
+            return endpoint?.releaseId === activeId && await probeOwnership(endpoint) === "live-verified";
+        },
+        async shutdownVerifiedOwners(targetVersion) {
+            const state = await stateStore.read();
+            const priorActiveVersion = state.references.active ? state.releases[state.references.active]?.packageVersion ?? null : null;
+            const endpoint = await readEndpointMetadata(paths.endpointMetadataPath);
+            if (!endpoint)
+                return { priorActiveVersion };
+            const ownership = await probeOwnership(endpoint);
+            if (ownership !== "live-verified" && ownership !== "dead") {
+                throw new Error(`AddOne refused update shutdown because supervisor ownership is ${ownership}`);
+            }
+            const immutableRoot = await canonicalImmutableRoot(paths.dataDir, endpoint.releaseRoot);
+            const legacyMutableInstall = ownership === "live-verified" && !immutableRoot;
+            const identity = ownership === "dead"
+                ? { accepted: false, reason: "recorded owner is dead" }
+                : await requestUpdateShutdown(endpoint, targetVersion, 2_000);
+            if (!identity.accepted && processIsAlive(endpoint.pid)) {
+                // Explicit update consent permits bounded cleanup of an authenticated
+                // older owner that predates the update-shutdown message.
+                const cleanup = await cleanupVerifiedOwner(endpoint, {
+                    allowLiveGenerations: true,
+                    reason: legacyMutableInstall ? "legacy-mutable-install" : "explicit-update",
+                });
+                if (!cleanup.terminated)
+                    throw new Error(`verified AddOne owner ${endpoint.pid} rejected shutdown and could not be terminated: ${identity.reason}`);
+            }
+            else if (identity.accepted) {
+                await waitForProcessExit(endpoint.pid, 3_000).catch(async () => {
+                    const cleanup = await cleanupVerifiedOwner(endpoint, {
+                        allowLiveGenerations: true,
+                        reason: legacyMutableInstall ? "legacy-mutable-install" : "explicit-update",
+                    });
+                    if (!cleanup.terminated)
+                        throw new Error(`verified AddOne owner ${endpoint.pid} did not terminate`);
+                });
+            }
+            await removeEndpointArtifacts(paths.endpointMetadataPath, paths.endpoint);
+            return { priorActiveVersion };
+        },
+        async verifyPackageUnlocked(packageRoot) {
+            if (fileSystem.access)
+                await fileSystem.access(packageRoot);
+            const probe = `${packageRoot}.addone-unlock-probe`;
+            const { rename } = await import("node:fs/promises");
+            try {
+                await rename(packageRoot, probe);
+                await rename(probe, packageRoot);
+            }
+            catch (error) {
+                // Best-effort rollback if the first rename succeeded and the second did not.
+                await rename(probe, packageRoot).catch(() => { });
+                throw new Error(`AddOne package remains locked after verified shutdown: ${errorMessage(error)}`);
+            }
+        },
+        async activateInstalled(packageRoot, targetVersion, phase) {
+            const candidate = await materializeRelease(packageRoot, paths.dataDir);
+            if (candidate.packageVersion !== targetVersion)
+                throw new Error(`installed AddOne version ${candidate.packageVersion} does not match target ${targetVersion}`);
+            await stateStore.recordCandidate(candidate);
+            await phase("materialized");
+            const diagnostics = await certifyMaterializedRelease(candidate, paths.dataDir);
+            await stateStore.approve(candidate.releaseId, diagnostics);
+            await phase("certified");
+            await stateStore.activate(candidate.releaseId);
+            await phase("active-reference-committed");
+            await startSupervisor(candidate, environment);
+            await waitForVerifiedEndpoint(paths.endpointMetadataPath, candidate, 8_000);
+        },
+    };
+}
+export async function runSelfUpdate(options) {
+    const fileSystem = options.fileSystem ?? defaultFileSystem;
+    const output = options.output ?? defaultOutput;
+    const runner = options.runner ?? createNpmProcessRunner();
+    const channel = options.channel ?? "stable";
+    const distTag = UPDATE_DIST_TAGS[channel];
+    let runningVersion;
+    try {
+        const packageJson = JSON.parse(await fileSystem.readFile(resolve(options.packageRoot, "package.json")));
+        const parsedVersion = typeof packageJson.version === "string" ? validSemver(packageJson.version) : null;
+        if (parsedVersion === null)
+            throw new Error("package.json does not contain a valid semantic version");
+        runningVersion = parsedVersion;
+    }
+    catch (error) {
+        output.stderr(`AddOne could not read its running package version: ${errorMessage(error)}\n`);
+        return 1;
+    }
+    const targetLookup = await runNpm(runner, ["view", `${ADDONE_PACKAGE}@${distTag}`, "version"], true, output, `query the npm ${distTag} channel`);
+    if (targetLookup.result === null)
+        return targetLookup.exitCode;
+    const targetVersion = validSemver(targetLookup.result.stdout.trim());
+    if (targetVersion === null) {
+        output.stderr(`AddOne received a malformed ${distTag} version from npm: ${JSON.stringify(targetLookup.result.stdout.trim())}.\n`);
+        return 1;
+    }
+    output.stdout(`AddOne update (${channel}): ${runningVersion} → ${targetVersion}.\n`);
+    const rootLookup = await runNpm(runner, ["root", "--global"], true, output, "resolve npm's global package root");
+    if (rootLookup.result === null)
+        return rootLookup.exitCode;
+    if (rootLookup.result.stdout.trim().length === 0) {
+        output.stderr("AddOne could not verify its installation because npm returned an empty global package root.\n");
+        return 1;
+    }
+    let packageRoot;
+    let globalRoot;
+    try {
+        [packageRoot, globalRoot] = await Promise.all([fileSystem.realpath(options.packageRoot), fileSystem.realpath(rootLookup.result.stdout.trim())]);
+    }
+    catch (error) {
+        output.stderr(`AddOne could not canonicalize the running and global npm paths: ${errorMessage(error)}\n`);
+        return 1;
+    }
+    if (!isContainedBy(globalRoot, packageRoot)) {
+        output.stderr(`AddOne refused to update automatically because ${packageRoot} is not managed beneath npm's global package root ${globalRoot}.\n`);
+        return 1;
+    }
+    const environment = options.environment ?? process.env;
+    const paths = resolveAddOnePaths(environment);
+    const lifecycle = options.lifecycle ?? createUpdateLifecycleCoordinator(environment, fileSystem);
+    const transactionStore = options.transactionStore ?? new UpdateTransactionStore(paths.dataDir);
+    let transaction = await transactionStore.read();
+    try {
+        if (await lifecycle.targetIsActive(targetVersion)) {
+            if (transaction?.status === "active") {
+                await transactionStore.advance("supervisor-verified");
+                await transactionStore.finish("completed");
+            }
+            await transactionStore.clearCompleted();
+            output.stdout("AddOne is already current and active for this channel; no installation was changed.\n");
+            return 0;
+        }
+        const cohortState = await new CohortStateStore(paths.dataDir).read();
+        transaction = await transactionStore.begin({
+            channel,
+            targetVersion,
+            packageRoot,
+            priorActiveReleaseId: cohortState.references.active,
+        });
+        if (phaseBefore(transaction.phase, "ownership-released")) {
+            await lifecycle.shutdownVerifiedOwners(targetVersion);
+            await lifecycle.verifyPackageUnlocked(packageRoot);
+            transaction = await transactionStore.advance("ownership-released");
+        }
+        if (phaseBefore(transaction.phase, "package-installed")) {
+            output.stdout(`AddOne is installing ${ADDONE_PACKAGE}@${targetVersion}.\n`);
+            const installation = await runNpm(runner, ["install", "--global", `${ADDONE_PACKAGE}@${targetVersion}`], false, output, "start the global npm installation", false);
+            if (installation.result === null)
+                throw new UpdateFailure(installation.exitCode, "npm process failed");
+            if (installation.result.code !== 0)
+                throw new UpdateFailure(unsuccessfulCode(installation.result.code), `npm exited with status ${formatExitCode(installation.result.code)}`);
+            transaction = await transactionStore.advance("package-installed");
+        }
+        await lifecycle.activateInstalled(packageRoot, targetVersion, async (phase) => { transaction = await transactionStore.advance(phase); });
+        await transactionStore.advance("supervisor-verified");
+        await transactionStore.finish("completed");
+        await transactionStore.clearCompleted();
+        output.stdout(`AddOne updated successfully: ${targetVersion} (${channel}).\n`);
+        return 0;
+    }
+    catch (error) {
+        const message = errorMessage(error);
+        const rollback = options.lifecycle
+            ? "previous test lifecycle retained"
+            : await rollbackPriorCohort(paths.dataDir, environment, transaction?.priorActiveReleaseId ?? null).catch(rollbackError => `rollback failed: ${errorMessage(rollbackError)}`);
+        if (transaction)
+            await transactionStore.finish(rollback === "rolled back" ? "rolled-back" : "failed", `${message}; ${rollback}`);
+        output.stderr(`AddOne update failed: ${message}. ${rollback}. Diagnostics: ${transactionStore.path}\n`);
+        return error instanceof UpdateFailure ? error.exitCode : 1;
+    }
+}
+async function requestUpdateShutdown(metadata, targetVersion, timeoutMs) {
+    if (!processIsAlive(metadata.pid))
+        return { accepted: false, reason: "recorded owner is dead" };
+    return await new Promise(resolvePromise => {
+        const socket = connect(metadata.endpoint);
+        const decoder = new LineFrameDecoder();
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            resolvePromise(value);
+        };
+        socket.once("error", () => finish({ accepted: false, reason: "verified endpoint did not respond" }));
+        socket.once("connect", () => socket.write(encodeFrame({ type: "release-update-ownership", bootNonce: metadata.bootNonce, targetVersion })));
+        socket.on("data", chunk => {
+            try {
+                const message = decoder.push(chunk)[0];
+                if (message?.type === "release-update-result")
+                    finish({ accepted: message.accepted === true, reason: String(message.reason ?? "shutdown rejected") });
+            }
+            catch {
+                finish({ accepted: false, reason: "invalid shutdown response" });
+            }
+        });
+        setTimeout(() => finish({ accepted: false, reason: "verified endpoint shutdown timed out" }), timeoutMs).unref();
+    });
+}
+async function runNpm(runner, arguments_, captureStdout, output, action, reportNonzero = true) {
+    let result;
+    try {
+        result = await runner("npm", arguments_, { captureStdout });
+    }
+    catch (error) {
+        output.stderr(`AddOne could not execute npm to ${action}: ${errorMessage(error)}\n`);
+        return { result: null, exitCode: 1 };
+    }
+    if (result.code !== 0 && reportNonzero) {
+        output.stderr(`AddOne could not ${action}; npm exited with status ${formatExitCode(result.code)}. Review npm's diagnostics above.\n`);
+        return { result: null, exitCode: unsuccessfulCode(result.code) };
+    }
+    return { result, exitCode: 0 };
+}
+async function rollbackPriorCohort(dataDir, environment, priorReleaseId) {
+    if (!priorReleaseId)
+        return "no prior cohort was available for rollback";
+    const stateStore = new CohortStateStore(dataDir);
+    const state = await stateStore.read();
+    const prior = state.releases[priorReleaseId];
+    if (!prior || prior.approval !== "approved")
+        return "prior cohort is not a verified rollback candidate";
+    if (state.references.active !== priorReleaseId) {
+        if (state.references.rollback === priorReleaseId)
+            await stateStore.rollback(true);
+        else
+            throw new Error(`prior release ${priorReleaseId} is not the recorded rollback cohort`);
+    }
+    const release = await readMaterializedRelease(prior.releaseRoot);
+    const paths = resolveAddOnePaths(environment);
+    await startSupervisor(release, environment);
+    await waitForVerifiedEndpoint(paths.endpointMetadataPath, release, 8_000);
+    return "rolled back";
+}
+function phaseBefore(current, target) {
+    const phases = ["shutdown-intent", "ownership-released", "package-installed", "materialized", "certified", "active-reference-committed", "supervisor-verified"];
+    return phases.indexOf(current) < phases.indexOf(target);
+}
+class UpdateFailure extends Error {
+    exitCode;
+    constructor(exitCode, message) {
+        super(message);
+        this.exitCode = exitCode;
+    }
+}
+async function canonicalImmutableRoot(dataDir, releaseRoot) {
+    try {
+        const [store, selected] = await Promise.all([realpath(resolve(dataDir, "releases")), realpath(releaseRoot)]);
+        const fromStore = relative(store, selected);
+        return fromStore.length > 0 && fromStore !== ".." && !fromStore.startsWith(`..${sep}`) && !isAbsolute(fromStore);
+    }
+    catch {
+        return false;
+    }
+}
+function isContainedBy(parent, child) {
+    const pathFromParent = relative(parent, child);
+    return pathFromParent.length > 0 && pathFromParent !== ".." && !pathFromParent.startsWith(`..${sep}`) && !isAbsolute(pathFromParent);
+}
+function unsuccessfulCode(code) { return code === null || code === 0 ? 1 : code; }
+function formatExitCode(code) { return code === null ? "unknown" : String(code); }
+function errorMessage(error) { return error instanceof Error ? error.message : String(error); }
+//# sourceMappingURL=update.js.map

package/dist/src/foundation/release/update.js.map

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

package/dist/src/foundation/storage/control-store.d.ts

@@ -0,0 +1,61 @@
+import { DatabaseSync } from "node:sqlite";
+import type { ManagedAgentDescriptor, PaneId, AgentRecoveryAuthority, RecoveryReferenceId, TerminalSessionLaunch, TerminalTopologySnapshot } from "../workspace-contracts/index.js";
+import type { ForegroundTerminalLease, ForegroundTerminalLeaseId, GenerationId, NativeProcessIdentity, TransparentTerminalLifecycleOutcome } from "../lifecycle/index.js";
+export declare const DEFAULT_WORKSPACE_ID = "workspace-default";
+export interface WorkspaceAgentPresentation {
+    readonly unreadActivity: number;
+    readonly attention: boolean;
+    readonly failure: {
+        readonly code: string;
+        readonly message: string;
+    } | null;
+}
+export interface StoredWorkspaceAgent {
+    readonly agent: ManagedAgentDescriptor;
+    readonly presentation: WorkspaceAgentPresentation;
+}
+export declare class ControlStore {
+    #private;
+    readonly bootNonce: string | null;
+    readonly database: DatabaseSync;
+    constructor(path: string, bootNonce?: string | null);
+    migrate(): void;
+    reconcilePriorBootGenerations(bootNonce: string): number;
+    acquireForegroundTerminalLease(lease: ForegroundTerminalLease): void;
+    activateForegroundTerminalLease(leaseId: ForegroundTerminalLeaseId, generationId: GenerationId, processIdentity: NativeProcessIdentity, heartbeatAt: string): boolean;
+    heartbeatForegroundTerminalLease(leaseId: ForegroundTerminalLeaseId, processIdentity: NativeProcessIdentity, heartbeatAt: string): boolean;
+    releaseForegroundTerminalLease(leaseId: ForegroundTerminalLeaseId, processIdentity: NativeProcessIdentity | null, outcome: TransparentTerminalLifecycleOutcome, releasedAt: string): boolean;
+    loadLiveForegroundTerminalLease(): ForegroundTerminalLease | null;
+    reconcilePriorBootForegroundTerminalLeases(bootNonce: string, reconciledAt?: string): number;
+    persistWorkspaceAgent(agent: ManagedAgentDescriptor, updatedAt?: string): void;
+    persistWorkspaceAgentRecord(record: StoredWorkspaceAgent, updatedAt?: string): void;
+    replaceWorkspaceAgentRecords(records: readonly StoredWorkspaceAgent[], selectedAgentId: string | null, revision: number, updatedAt?: string): void;
+    loadWorkspaceAgents(): ManagedAgentDescriptor[];
+    loadWorkspaceAgentRecord(agentId: string): StoredWorkspaceAgent | null;
+    loadWorkspaceAgentRecords(): StoredWorkspaceAgent[];
+    loadSelectedWorkspaceAgentId(): string | null;
+    loadWorkspaceRevision(): number;
+    saveNativeHostTopology(topology: TerminalTopologySnapshot, rollbackTopology: TerminalTopologySnapshot | null, updatedAt?: string): void;
+    loadNativeHostTopology(hostInstanceId: string): {
+        readonly topology: TerminalTopologySnapshot;
+        readonly rollback: unknown;
+        readonly updatedAt: string;
+    } | null;
+    persistTerminalSession(session: TerminalSessionLaunch, hostInstanceId: string, paneId: PaneId, lifecycle: string, recoveryReferenceId: RecoveryReferenceId | null, updatedAt?: string): void;
+    loadTerminalSessions(): {
+        readonly session: TerminalSessionLaunch;
+        readonly hostInstanceId: string;
+        readonly paneId: PaneId;
+        readonly lifecycle: string;
+        readonly recoveryReferenceId: RecoveryReferenceId | null;
+    }[];
+    persistRecoveryReference(authority: AgentRecoveryAuthority, status: "pending" | "accepted" | "rejected" | "discontinuous", rollbackMetadata: Readonly<Record<string, unknown>>, updatedAt?: string): void;
+    loadRecoveryReference(id: RecoveryReferenceId): {
+        readonly authority: unknown;
+        readonly status: string;
+        readonly rollback: unknown;
+        readonly updatedAt: string;
+    } | null;
+    close(): void;
+}
+//# sourceMappingURL=control-store.d.ts.map

package/dist/src/foundation/storage/control-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-store.d.ts","sourceRoot":"","sources":["../../../../src/foundation/storage/control-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EACV,sBAAsB,EACtB,MAAM,EACN,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,iCAAiC,CAAC;AAOzC,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EACzB,YAAY,EACZ,qBAAqB,EACrB,mCAAmC,EACpC,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAGxD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9E;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAC;CACnD;AAQD,qBAAa,YAAY;;IAGG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAF3D,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;gBAEpB,IAAI,EAAE,MAAM,EAAW,SAAS,GAAE,MAAM,GAAG,IAAW;IAYlE,OAAO,IAAI,IAAI;IAmJf,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAYxD,8BAA8B,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI;IAgBpE,+BAA+B,CAAC,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IASrK,gCAAgC,CAAC,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAQ1I,8BAA8B,CAAC,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,qBAAqB,GAAG,IAAI,EAAE,OAAO,EAAE,mCAAmC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAW5L,+BAA+B,IAAI,uBAAuB,GAAG,IAAI;IAKjE,0CAA0C,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,SAA2B,GAAG,MAAM;IAS9G,qBAAqB,CAAC,KAAK,EAAE,sBAAsB,EAAE,SAAS,SAA2B,GAAG,IAAI;IAQhG,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,EAAE,SAAS,SAA2B,GAAG,IAAI;IAMrG,4BAA4B,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,SAA2B,GAAG,IAAI;IAqBpK,mBAAmB,IAAI,sBAAsB,EAAE;IAI/C,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAKtE,yBAAyB,IAAI,oBAAoB,EAAE;IAKnD,4BAA4B,IAAI,MAAM,GAAG,IAAI;IAK7C,qBAAqB,IAAI,MAAM;IAuC/B,sBAAsB,CAAC,QAAQ,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,wBAAwB,GAAG,IAAI,EAAE,SAAS,SAA2B,GAAG,IAAI;IA2BzJ,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAQ9J,sBAAsB,CACpB,OAAO,EAAE,qBAAqB,EAC9B,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,mBAAmB,GAAG,IAAI,EAC/C,SAAS,SAA2B,GACnC,IAAI;IAeP,oBAAoB,IAAI;QAAE,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;QAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,IAAI,CAAA;KAAE,EAAE;IASrN,wBAAwB,CACtB,SAAS,EAAE,sBAAsB,EACjC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,EAC7D,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACnD,SAAS,SAA2B,GACnC,IAAI;IAgBP,qBAAqB,CAAC,EAAE,EAAE,mBAAmB,GAAG;QAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAQvK,KAAK,IAAI,IAAI;CAed"}