@omnitron-dev/omnitron 0.3.1 → 0.3.3

package/dist/daemon/rpc-connection.js

@@ -0,0 +1,137 @@
+import { randomUUID } from 'node:crypto';
+import { Interface, Netron, NETRON_EVENT_PEER_DISCONNECT } from '@omnitron-dev/titan/netron';
+import { createNullLogger } from '@omnitron-dev/titan/module/logger';
+const CONNECT_TIMEOUT = 15_000;
+const CLOSE_TIMEOUT = 1_000;
+export function withRpcDeadline(work, ms, message) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(message)), ms);
+        timer.unref?.();
+        work.then(value => { clearTimeout(timer); resolve(value); }, error => { clearTimeout(timer); reject(error); });
+    });
+}
+/**
+ * Omnitron's client lifetime is longer than a backend connection. Netron
+ * owns transport, serialization and interface discovery; this adapter only
+ * binds a retained service handle to the current connection on each call.
+ * No invocation is retried: a lost reply may follow a committed mutation.
+ */
+export class RpcConnection {
+    address;
+    configure;
+    options;
+    session;
+    handles = new Map();
+    constructor(address, configure, options = {}) {
+        this.address = address;
+        this.configure = configure;
+        this.options = options;
+    }
+    async close(session) {
+        // A session owns its own Netron. Late completion/teardown can never close
+        // a newer connection, even when disconnect's deadline has already expired.
+        session.closing ??= withRpcDeadline(session.netron.stop(), CLOSE_TIMEOUT, 'the transport did not close in time')
+            .catch(() => undefined);
+        await session.closing;
+    }
+    current() {
+        const previous = this.session;
+        if (previous && (!previous.peer || previous.netron.peers.get(previous.peer.id) === previous.peer)) {
+            return previous;
+        }
+        if (previous)
+            void this.close(previous);
+        const netron = new Netron(this.options.logger ?? createNullLogger(), { id: `omnitron-${process.pid}-${randomUUID()}` });
+        this.configure(netron);
+        const session = { netron, ready: undefined, interfaces: new Map() };
+        this.session = session;
+        netron.on(NETRON_EVENT_PEER_DISCONNECT, ({ peerId }) => {
+            if (session.peer?.id !== peerId)
+                return;
+            // Netron settles pending requests and removes the lost peer before this
+            // event. Omnitron only invalidates its retained-handle connection.
+            if (this.session === session)
+                this.session = undefined;
+            void this.close(session);
+        });
+        session.ready = withRpcDeadline(Promise.resolve().then(async () => {
+            await this.options.beforeConnect?.();
+            if (this.session !== session)
+                throw new Error('RPC connection was closed before admission');
+            return netron.connect(this.address, false);
+        }).then(async (peer) => {
+            const remote = peer;
+            if (this.session !== session) {
+                await remote.disconnect();
+                throw new Error('RPC connection was closed before it became ready');
+            }
+            session.peer = remote;
+            await this.options.afterConnect?.(remote);
+            if (this.session !== session)
+                throw new Error('RPC connection was closed during peer validation');
+            return remote;
+        }), CONNECT_TIMEOUT, `the ${this.options.peerName ?? 'daemon'} did not complete a connection within ${CONNECT_TIMEOUT / 1000}s`).catch(error => {
+            if (this.session === session)
+                this.session = undefined;
+            void this.close(session);
+            throw error;
+        });
+        return session;
+    }
+    async resolve(name) {
+        const session = this.current();
+        const peer = await session.ready;
+        if (this.session !== session)
+            throw new Error('RPC connection was closed');
+        let pending = session.interfaces.get(name);
+        if (!pending) {
+            pending = peer.queryInterface(name).catch(error => {
+                session.interfaces.delete(name);
+                throw error;
+            });
+            session.interfaces.set(name, pending);
+        }
+        const resolved = await pending;
+        if (this.session !== session)
+            throw new Error('RPC connection was closed');
+        return resolved;
+    }
+    async service(name) {
+        const initial = await this.resolve(name);
+        let handle = this.handles.get(name);
+        if (!handle) {
+            if (!initial.$def || !initial.$peer)
+                throw new Error(`Invalid RPC interface: ${name}`);
+            // Keep Netron's Interface, including properties, waitForAssigned,
+            // references and stream serialization. Only the destination changes.
+            const route = (operation) => async (_id, ...args) => {
+                const current = await this.resolve(name);
+                if (!current.$def || !current.$peer)
+                    throw new Error(`Invalid RPC interface: ${name}`);
+                return Reflect.apply(current.$peer[operation], current.$peer, [current.$def.id, ...args]);
+            };
+            const operations = { call: route('call'), get: route('get'), set: route('set') };
+            const peer = new Proxy(initial.$peer, {
+                get: (target, property) => {
+                    if (property === 'call' || property === 'get' || property === 'set')
+                        return operations[property];
+                    return Reflect.get(target, property, target);
+                },
+            });
+            handle = Interface.create(initial.$def, peer);
+            this.handles.set(name, handle);
+        }
+        return handle;
+    }
+    async disconnect() {
+        const session = this.session;
+        this.session = undefined;
+        if (!session)
+            return;
+        // Fence first, then wait a bounded time for the handshake and teardown.
+        // Retained handles remain usable for a later, explicit call.
+        await withRpcDeadline(session.ready, CLOSE_TIMEOUT, 'connection did not settle').catch(() => undefined);
+        await this.close(session);
+    }
+}
+//# sourceMappingURL=rpc-connection.js.map

package/dist/daemon/rpc-connection.js.map

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

package/dist/daemon/runtime-installation.d.ts

@@ -0,0 +1,58 @@
+import { type BackendArtifact } from './backend-candidate.js';
+export interface RuntimeSelection {
+    protocol: 1;
+    revision: number;
+    current: string;
+    previous: string | null;
+    /** A management-capable release remains available even after rollback to a legacy backend. */
+    bootstrap: string | null;
+    selectedAt: string;
+}
+export interface RuntimeActivation {
+    candidate: string;
+    previous: string;
+    checkpoint: string;
+    startedAt: string;
+}
+/** One local, transactional startup selector, independent of PostgreSQL and the running daemon. */
+export declare class RuntimeInstallation {
+    readonly home: string;
+    readonly directory: string;
+    readonly releases: string;
+    private readonly store;
+    private lease;
+    private inspection?;
+    private constructor();
+    static open(home?: string, options?: {
+        existing?: boolean;
+        readOnly?: boolean;
+    }): Promise<RuntimeInstallation | null>;
+    /** No schema initialization or writer lease. SQLite may coordinate readers through WAL/SHM sidecars. */
+    static openReadOnly(home?: string): Promise<RuntimeInstallation | null>;
+    private read;
+    selection(): RuntimeSelection | null;
+    releasePath(id: string): string;
+    activation(): RuntimeActivation | null;
+    beginActivation(candidate: string, previous: string, checkpoint: string): void;
+    abortActivation(): void;
+    artifact(id: string): Promise<BackendArtifact>;
+    /** A passive observer cannot recover an abandoned lease or imply that a pending activation is settled. */
+    settledSelection(): RuntimeSelection;
+    settledSelection(options: {
+        allowEmpty: true;
+    }): RuntimeSelection | null;
+    private assertAvailable;
+    /** Exclusive across CLI processes; SQLite releases its own write lock even after SIGKILL. */
+    exclusive<T>(operation: () => Promise<T>): Promise<T>;
+    /** Copies only a prebuilt, sealed dependency closure. Never moves or rewrites a live release. */
+    install(source: string): Promise<BackendArtifact>;
+    select(id: string, expectedRevision: number, promoteManagement?: boolean): Promise<RuntimeSelection>;
+    /** A stable entry point whose bootstrap release is retained independently of backend selection. */
+    writeLauncher(initialBootstrap?: string): Promise<string>;
+    close(): Promise<void>;
+}
+/** Resolving a startup always revalidates Node, backend and the entire dependency closure. */
+export declare function selectedBackend(home?: string, purpose?: 'startup' | 'control' | 'management'): Promise<BackendArtifact | null>;
+/** Startup and version selection share a lease, closing the PID-file creation race. */
+export declare function withRuntimeStartup<T>(directory: string, start: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=runtime-installation.d.ts.map

package/dist/daemon/runtime-installation.d.ts.map

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

package/dist/daemon/runtime-installation.js

@@ -0,0 +1,346 @@
+import fs from 'node:fs/promises';
+import { constants } from 'node:fs';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { createNullLogger } from '@omnitron-dev/titan/module/logger';
+import { openSqliteDatabase } from '@omnitron-dev/titan-database/sqlite';
+import { OMNITRON_HOME } from '../config/defaults.js';
+import { verifyRuntimeArtifact } from '../shared/runtime-artifact.js';
+import { DaemonStateStore } from './daemon-state-store.service.js';
+import { checkBackendCandidate } from './backend-candidate.js';
+import { PidManager } from './pid-manager.js';
+import { writePrivateFile } from './execution-journal.js';
+const HASH = /^[a-f0-9]{64}$/;
+async function privateDirectory(directory, create) {
+    if (create)
+        await fs.mkdir(directory, { recursive: true, mode: 0o700 });
+    const stat = await fs.lstat(directory);
+    if (!stat.isDirectory() || stat.isSymbolicLink() || (stat.mode & 0o077) !== 0 ||
+        (process.getuid && stat.uid !== process.getuid())) {
+        throw new Error(`Runtime directory must be private and owned by this user: ${directory}`);
+    }
+}
+/** One local, transactional startup selector, independent of PostgreSQL and the running daemon. */
+export class RuntimeInstallation {
+    home;
+    directory;
+    releases;
+    store;
+    lease = null;
+    inspection;
+    constructor(home) {
+        this.home = home;
+        this.directory = path.join(home, 'runtime');
+        this.releases = path.join(this.directory, 'releases');
+        this.store = new DaemonStateStore(createNullLogger(), path.join(this.directory, 'state.db'));
+    }
+    static async open(home = OMNITRON_HOME, options = {}) {
+        if (!path.isAbsolute(home))
+            throw new Error('Runtime installation requires an absolute instance directory');
+        const installation = new RuntimeInstallation(path.resolve(home));
+        if (options.existing || options.readOnly) {
+            try {
+                await fs.lstat(installation.store.dbPath);
+            }
+            catch (error) {
+                if (error.code === 'ENOENT')
+                    return null;
+                throw error;
+            }
+        }
+        await privateDirectory(installation.directory, !options.readOnly);
+        await privateDirectory(installation.releases, !options.readOnly);
+        // Do not follow an operator-supplied database link, including SQLite sidecars.
+        for (const suffix of ['', '-wal', '-shm', '-journal']) {
+            try {
+                const stat = await fs.lstat(installation.store.dbPath + suffix);
+                if (!stat.isFile() || stat.isSymbolicLink() || (stat.mode & 0o077) !== 0 ||
+                    (process.getuid && stat.uid !== process.getuid()))
+                    throw new Error('Runtime registry must be a private regular file');
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+        }
+        if (options.readOnly)
+            installation.inspection = openSqliteDatabase(installation.store.dbPath, { readonly: true, fileMustExist: true });
+        else
+            installation.store.initSync().pragma('synchronous = FULL');
+        return installation;
+    }
+    /** No schema initialization or writer lease. SQLite may coordinate readers through WAL/SHM sidecars. */
+    static openReadOnly(home = OMNITRON_HOME) {
+        return RuntimeInstallation.open(home, { readOnly: true });
+    }
+    read(key) {
+        const row = (this.inspection ?? this.store.initSync()).prepare('SELECT value FROM state_kv WHERE key = ?').get(key);
+        // Invalid state is never interpreted as an empty installation.
+        if (!row)
+            return null;
+        const value = JSON.parse(row.value);
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            throw new Error('Invalid runtime registry record: ' + key);
+        return value;
+    }
+    selection() {
+        const value = this.read('runtime.selection');
+        if (!value)
+            return null;
+        if (value.protocol !== 1 || !Number.isSafeInteger(value.revision) || value.revision < 1 ||
+            !HASH.test(value.current) || (value.bootstrap !== null && !HASH.test(value.bootstrap)) ||
+            (value.previous !== null && !HASH.test(value.previous)) || !Number.isFinite(Date.parse(value.selectedAt))) {
+            throw new Error('Invalid runtime selection; cold start is refused');
+        }
+        return value;
+    }
+    releasePath(id) {
+        if (!HASH.test(id))
+            throw new Error('A complete runtime SHA-256 is required');
+        return path.join(this.releases, id);
+    }
+    activation() {
+        const value = this.read('runtime.activation');
+        if (value && (!HASH.test(value.candidate) || !HASH.test(value.previous) ||
+            typeof value.checkpoint !== 'string' || !path.isAbsolute(value.checkpoint) || !Number.isFinite(Date.parse(value.startedAt)))) {
+            throw new Error('Invalid runtime activation journal; automatic startup is refused');
+        }
+        return value;
+    }
+    beginActivation(candidate, previous, checkpoint) {
+        if (!this.lease || !HASH.test(candidate) || !HASH.test(previous) || !path.isAbsolute(checkpoint)) {
+            throw new Error('A leased activation and validated release identities are required');
+        }
+        if (this.activation())
+            throw new Error('A runtime activation is unfinished; inspect its checkpoint before another upgrade');
+        this.store.kvSetSync('runtime.activation', { candidate, previous, checkpoint, startedAt: new Date().toISOString() });
+    }
+    abortActivation() {
+        if (!this.lease)
+            throw new Error('Aborting activation requires the installation lease');
+        this.store.kvDeleteSync('runtime.activation');
+    }
+    async artifact(id) {
+        const root = this.releasePath(id);
+        const stat = await fs.lstat(root);
+        if (!stat.isDirectory() || stat.isSymbolicLink())
+            throw new Error('Installed runtime cannot be a symbolic link');
+        const artifact = await checkBackendCandidate(path.join(root, 'packages/0/dist'), undefined, id);
+        if (artifact.runtimeHash !== id)
+            throw new Error('Installed runtime content does not match its identity');
+        return artifact;
+    }
+    settledSelection(options) {
+        const db = this.inspection ?? this.store.initSync();
+        const read = () => {
+            if (db.prepare("SELECT 1 FROM state_kv WHERE key IN ('runtime.lease','runtime.activation') LIMIT 1").get()) {
+                throw Error('The runtime registry has an unsettled lease or activation');
+            }
+            const selection = this.selection();
+            if (!selection && !options?.allowEmpty)
+                throw Error('No runtime has been selected');
+            return selection;
+        };
+        return db.transaction(read).deferred();
+    }
+    assertAvailable() {
+        const previous = this.read('runtime.lease');
+        if (previous && (!Number.isSafeInteger(previous.pid) || previous.pid < 1 || !previous.token || PidManager.isProcessAlive(previous.pid))) {
+            throw new Error(`Another runtime operation holds the installation lease (PID ${previous.pid}); no activation performed`);
+        }
+    }
+    /** Exclusive across CLI processes; SQLite releases its own write lock even after SIGKILL. */
+    async exclusive(operation) {
+        if (this.inspection)
+            throw new Error('A read-only runtime inspection cannot claim the installation lease');
+        if (this.lease)
+            throw new Error('Runtime operation is already in progress');
+        const lease = { token: randomUUID(), pid: process.pid, acquiredAt: new Date().toISOString() };
+        this.store.initSync().transaction(() => {
+            this.assertAvailable();
+            this.store.kvSetSync('runtime.lease', lease);
+        }).immediate();
+        this.lease = lease;
+        try {
+            return await operation();
+        }
+        finally {
+            this.store.initSync().transaction(() => {
+                if (this.read('runtime.lease')?.token !== lease.token)
+                    throw new Error('Runtime lease changed unexpectedly');
+                this.store.kvDeleteSync('runtime.lease');
+            }).immediate();
+            this.lease = null;
+        }
+    }
+    /** Copies only a prebuilt, sealed dependency closure. Never moves or rewrites a live release. */
+    async install(source) {
+        if (!this.lease)
+            throw new Error('Runtime installation requires an exclusive operation');
+        const candidate = await checkBackendCandidate(path.join(source, 'packages/0/dist'));
+        const destination = this.releasePath(candidate.runtimeHash);
+        try {
+            await fs.lstat(destination);
+            return await this.artifact(candidate.runtimeHash);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+        const staging = path.join(this.releases, `.install-${this.lease.token}`);
+        try {
+            await fs.cp(candidate.runtimeRoot, staging, {
+                recursive: true, verbatimSymlinks: true, force: false, errorOnExist: true,
+                mode: constants.COPYFILE_FICLONE,
+            });
+            await verifyRuntimeArtifact(staging, candidate.runtimeHash);
+            // Flush every copied regular file before publishing the directory and its selector.
+            const syncTree = async (directory) => {
+                for (const entry of await fs.readdir(directory, { withFileTypes: true })) {
+                    const file = path.join(directory, entry.name);
+                    if (entry.isDirectory())
+                        await syncTree(file);
+                    else if (entry.isFile()) {
+                        const handle = await fs.open(file, 'r');
+                        try {
+                            await handle.sync();
+                        }
+                        finally {
+                            await handle.close();
+                        }
+                    }
+                }
+                const handle = await fs.open(directory, 'r');
+                try {
+                    await handle.sync();
+                }
+                finally {
+                    await handle.close();
+                }
+            };
+            await syncTree(staging);
+            await fs.rename(staging, destination);
+            const parent = await fs.open(this.releases, 'r');
+            try {
+                await parent.sync();
+            }
+            finally {
+                await parent.close();
+            }
+            return await this.artifact(candidate.runtimeHash);
+        }
+        finally {
+            // Only this operation's unpublished staging tree is disposable.
+            await fs.rm(staging, { recursive: true, force: true });
+        }
+    }
+    async select(id, expectedRevision, promoteManagement = false) {
+        if (!this.lease)
+            throw new Error('Runtime selection requires an exclusive operation');
+        const artifact = await this.artifact(id);
+        let hasLauncher = false;
+        try {
+            hasLauncher = (await fs.lstat(path.join(artifact.directory, 'cli/installed.js'))).isFile();
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+        return this.store.initSync().transaction(() => {
+            const previous = this.selection();
+            if ((previous?.revision ?? 0) !== expectedRevision)
+                throw new Error('Runtime selection changed; review the active installation before retrying');
+            const activation = this.activation();
+            if (activation && id !== activation.candidate && id !== activation.previous)
+                throw new Error('The selected release does not belong to the pending activation');
+            const value = {
+                protocol: 1, revision: expectedRevision + 1, current: id,
+                previous: previous?.current === id ? previous.previous : previous?.current ?? null,
+                bootstrap: promoteManagement && hasLauncher ? id : previous?.bootstrap ?? (hasLauncher ? id : null), selectedAt: new Date().toISOString(),
+            };
+            this.store.kvSetSync('runtime.selection', value);
+            this.store.kvDeleteSync('runtime.activation');
+            return value;
+        }).immediate();
+    }
+    /** A stable entry point whose bootstrap release is retained independently of backend selection. */
+    async writeLauncher(initialBootstrap) {
+        if (!this.lease)
+            throw new Error('Launcher installation requires an exclusive operation');
+        const selection = this.selection();
+        if (!selection)
+            throw new Error('Select a runtime before installing its launcher');
+        const bootstrap = selection.bootstrap ?? initialBootstrap ?? selection.current;
+        const artifact = await this.artifact(bootstrap);
+        const entry = path.join(artifact.directory, 'cli/installed.js');
+        await fs.access(entry);
+        if (!selection.bootstrap)
+            this.store.kvSetSync('runtime.selection', { ...selection, bootstrap });
+        const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+        const launcher = path.join(this.directory, 'bin/omnitron');
+        await writePrivateFile(launcher, `#!/bin/sh\nexport OMNITRON_HOME=${quote(this.home)}\nexec ${quote(artifact.execPath)} ${quote(entry)} "$@"\n`, 0o700);
+        return launcher;
+    }
+    async close() {
+        if (this.inspection)
+            this.inspection.close();
+        else
+            await this.store.dispose();
+    }
+}
+/** Resolving a startup always revalidates Node, backend and the entire dependency closure. */
+export async function selectedBackend(home = OMNITRON_HOME, purpose = 'startup') {
+    const installation = await RuntimeInstallation.open(home, { existing: true });
+    if (!installation)
+        return null;
+    try {
+        const activation = installation.activation();
+        if (activation && purpose === 'startup')
+            throw new Error(`Runtime activation is unfinished. Inspect and recover its checkpoint before cold start: ${activation.checkpoint}`);
+        const selection = installation.selection();
+        if (!selection)
+            return null;
+        if (activation && purpose !== 'startup')
+            return await installation.artifact(selection.bootstrap ?? selection.current);
+        const current = await installation.artifact(selection.current);
+        if (purpose === 'management' && selection.bootstrap) {
+            try {
+                await fs.access(path.join(current.directory, 'cli/installed.js'));
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+                return await installation.artifact(selection.bootstrap);
+            }
+        }
+        return current;
+    }
+    finally {
+        await installation.close();
+    }
+}
+/** Startup and version selection share a lease, closing the PID-file creation race. */
+export async function withRuntimeStartup(directory, start) {
+    const installation = await RuntimeInstallation.open(undefined, { existing: true });
+    if (!installation)
+        return start();
+    try {
+        return await installation.exclusive(async () => {
+            if (installation.activation())
+                throw new Error('Runtime activation is unfinished; recover its checkpoint before starting');
+            const selection = installation.selection();
+            if (selection) {
+                const root = installation.releasePath(selection.current);
+                if (await fs.realpath(directory) !== path.join(root, 'packages/0/dist') ||
+                    await fs.realpath(process.execPath) !== path.join(root, 'node')) {
+                    throw new Error('Runtime selection changed before startup; retry through the installed launcher');
+                }
+            }
+            return start();
+        });
+    }
+    finally {
+        await installation.close();
+    }
+}
+//# sourceMappingURL=runtime-installation.js.map

package/dist/daemon/runtime-installation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-installation.js","sourceRoot":"","sources":["../../src/daemon/runtime-installation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAwB,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAc1D,MAAM,IAAI,GAAG,gBAAgB,CAAC;AAE9B,KAAK,UAAU,gBAAgB,CAAC,SAAiB,EAAE,MAAe;IAChE,IAAI,MAAM;QAAE,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;QACzE,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,6DAA6D,SAAS,EAAE,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,OAAO,mBAAmB;IAOD,IAAI;IANxB,SAAS,CAAS;IAClB,QAAQ,CAAS;IACT,KAAK,CAAmB;IACjC,KAAK,GAA6B,IAAI,CAAC;IACvC,UAAU,CAAyC;IAE3D,YAA6B,IAAY;oBAAZ,IAAI;QAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,GAAG,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,aAAa,EAAE,OAAO,GAA+C,EAAE;QAC9F,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC5G,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACzC,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAAC,CAAC;YAClD,OAAO,KAAK,EAAE,CAAC;gBAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO,IAAI,CAAC;gBAAC,MAAM,KAAK,CAAC;YAAC,CAAC;QACrG,CAAC;QACD,MAAM,gBAAgB,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClE,MAAM,gBAAgB,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjE,+EAA+E;QAC/E,KAAK,MAAM,MAAM,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;gBAChE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;oBACpE,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YAC5H,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAC;YAAC,CAAC;QAC1F,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ;YAAE,YAAY,CAAC,UAAU,GAAG,kBAAkB,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;;YAClI,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAChE,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,wGAAwG;IACxG,MAAM,CAAC,YAAY,CAAC,IAAI,GAAG,aAAa;QACtC,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAEO,IAAI,CAAmB,GAAW;QACxC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,GAAG,CAAC,GAAG,CAAkC,CAAC;QACrJ,+DAA+D;QAC/D,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,GAAG,CAAC,CAAC;QAC5H,OAAO,KAAU,CAAC;IACpB,CAAC;IAED,SAAS;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAmB,mBAAmB,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC;YACnF,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACtF,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YAC9G,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW,CAAC,EAAU;QACpB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAoB,oBAAoB,CAAC,CAAC;QACjE,IAAI,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACnE,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACjI,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,eAAe,CAAC,SAAiB,EAAE,QAAgB,EAAE,UAAkB;QACrE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACjG,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;QAC5H,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACvH,CAAC;IAED,eAAe;QACb,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACxF,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAChG,IAAI,QAAQ,CAAC,WAAW,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC1G,OAAO,QAAQ,CAAC;IAClB,CAAC;IAKD,gBAAgB,CAAC,OAA8B;QAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,IAAI,EAAE,CAAC,OAAO,CAAC,oFAAoF,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;gBAC3G,MAAM,KAAK,CAAC,2DAA2D,CAAC,CAAC;YAC3E,CAAC;YACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,UAAU;gBAAE,MAAM,KAAK,CAAC,8BAA8B,CAAC,CAAC;YACpF,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;QACF,OAAO,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;IAEO,eAAe;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAoB,eAAe,CAAC,CAAC;QAC/D,IAAI,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxI,MAAM,IAAI,KAAK,CAAC,+DAA+D,QAAQ,CAAC,GAAG,4BAA4B,CAAC,CAAC;QAC3H,CAAC;IACH,CAAC;IAED,6FAA6F;IAC7F,KAAK,CAAC,SAAS,CAAI,SAA2B;QAC5C,IAAI,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QAC3G,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAC9F,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC;YAAC,OAAO,MAAM,SAAS,EAAE,CAAC;QAAC,CAAC;gBACzB,CAAC;YACP,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;gBACrC,IAAI,IAAI,CAAC,IAAI,CAAoB,eAAe,CAAC,EAAE,KAAK,KAAK,KAAK,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;gBAChI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,iGAAiG;IACjG,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACzF,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACpF,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC5B,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;QAAC,CAAC;QACxF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE;gBAC1C,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI;gBACzE,IAAI,EAAE,SAAS,CAAC,gBAAgB;aACjC,CAAC,CAAC;YACH,MAAM,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;YAC5D,oFAAoF;YACpF,MAAM,QAAQ,GAAG,KAAK,EAAE,SAAiB,EAAiB,EAAE;gBAC1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;oBACzE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC9C,IAAI,KAAK,CAAC,WAAW,EAAE;wBAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;yBACzC,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;wBACxB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;wBACxC,IAAI,CAAC;4BAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;wBAAC,CAAC;gCAAS,CAAC;4BAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;wBAAC,CAAC;oBAChE,CAAC;gBACH,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBAC7C,IAAI,CAAC;oBAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAAC,CAAC;wBAAS,CAAC;oBAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBAAC,CAAC;YAChE,CAAC,CAAC;YACF,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACjD,IAAI,CAAC;gBAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAAC,CAAC;oBAAS,CAAC;gBAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;YAC9D,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;gBAAS,CAAC;YACT,gEAAgE;YAChE,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,gBAAwB,EAAE,iBAAiB,GAAG,KAAK;QAC1E,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACtF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC;YAAC,WAAW,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAAC,CAAC;QACnG,OAAO,KAAK,EAAE,CAAC;YAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;QAAC,CAAC;QACtF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,QAAQ,EAAE,QAAQ,IAAI,CAAC,CAAC,KAAK,gBAAgB;gBAAE,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;YACjJ,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACrC,IAAI,UAAU,IAAI,EAAE,KAAK,UAAU,CAAC,SAAS,IAAI,EAAE,KAAK,UAAU,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;YAC/J,MAAM,KAAK,GAAqB;gBAC9B,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,gBAAgB,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE;gBACxD,QAAQ,EAAE,QAAQ,EAAE,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI;gBAClF,SAAS,EAAE,iBAAiB,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC1I,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;YAC9C,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IACjB,CAAC;IAED,mGAAmG;IACnG,KAAK,CAAC,aAAa,CAAC,gBAAyB;QAC3C,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC1F,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACnF,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,IAAI,gBAAgB,IAAI,SAAS,CAAC,OAAO,CAAC;QAC/E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAChE,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC,SAAS,CAAC,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,mBAAmB,EAAE,EAAE,GAAG,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QACjG,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;QAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC3D,MAAM,gBAAgB,CAAC,QAAQ,EAAE,mCAAmC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACxJ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;;YACxC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAClC,CAAC;CACF;AAED,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAI,GAAG,aAAa,EAAE,OAAO,GAAyC,SAAS;IACnH,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,EAAE,CAAC;QAC7C,IAAI,UAAU,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,2FAA2F,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7K,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC;QAC3C,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,IAAI,UAAU,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,MAAM,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;QACtH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,OAAO,KAAK,YAAY,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YACpD,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC;YAAC,CAAC;YAC1E,OAAO,KAAK,EAAE,CAAC;gBACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAC;gBACpE,OAAO,MAAM,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;YAAS,CAAC;QAAC,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AAC3C,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAI,SAAiB,EAAE,KAAuB;IACpF,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,EAAE,CAAC;IAClC,IAAI,CAAC;QAAC,OAAO,MAAM,YAAY,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;YACnD,IAAI,YAAY,CAAC,UAAU,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;YAC3H,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC;YAC3C,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBACzD,IAAI,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC;oBACnE,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;oBACpE,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;gBACpG,CAAC;YACH,CAAC;YACD,OAAO,KAAK,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IAAC,CAAC;YAAS,CAAC;QAAC,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AAC/C,CAAC"}

package/dist/daemon/runtime-launcher.d.ts

@@ -0,0 +1,6 @@
+import type { BackendArtifact } from './backend-candidate.js';
+/** A stable launcher follows the verified selector; signals and exit status retain OS supervision semantics. */
+export declare function runRuntimeEntry(artifact: BackendArtifact, kind: 'cli' | 'daemon', args: string[]): Promise<void>;
+/** Explicit handoffs and preflight select their candidate themselves and must never be redirected. */
+export declare function forwardSelectedRuntime(kind: 'cli' | 'daemon', currentEntry: string, args: string[]): Promise<boolean>;
+//# sourceMappingURL=runtime-launcher.d.ts.map

package/dist/daemon/runtime-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-launcher.d.ts","sourceRoot":"","sources":["../../src/daemon/runtime-launcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,gHAAgH;AAChH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBtH;AAED,sGAAsG;AACtG,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAO3H"}

package/dist/daemon/runtime-launcher.js

@@ -0,0 +1,45 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+import { selectedBackend } from './runtime-installation.js';
+/** A stable launcher follows the verified selector; signals and exit status retain OS supervision semantics. */
+export async function runRuntimeEntry(artifact, kind, args) {
+    const entry = kind === 'cli' ? path.join(artifact.directory, 'cli/omnitron.js') : artifact.entry;
+    const argv = kind === 'daemon' ? ['--import', 'tsx/esm', entry, ...args] : [entry, ...args];
+    const child = spawn(artifact.execPath, argv, {
+        stdio: 'inherit',
+        cwd: kind === 'daemon' ? path.dirname(artifact.directory) : process.cwd(),
+        env: { ...process.env, ...(kind === 'daemon' ? { OMNITRON_CWD: process.env['OMNITRON_CWD'] ?? process.cwd() } : {}) },
+    });
+    const signals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+    const forwarders = signals.map(signal => ({ signal, handler: () => { child.kill(signal); } }));
+    for (const { signal, handler } of forwarders)
+        process.on(signal, handler);
+    try {
+        const result = await new Promise((resolve, reject) => {
+            child.once('error', reject);
+            child.once('exit', (code, signal) => resolve({ code, signal }));
+        });
+        for (const { signal, handler } of forwarders)
+            process.off(signal, handler);
+        if (result.signal)
+            process.kill(process.pid, result.signal);
+        process.exitCode = result.code ?? 1;
+    }
+    finally {
+        for (const { signal, handler } of forwarders)
+            process.off(signal, handler);
+    }
+}
+/** Explicit handoffs and preflight select their candidate themselves and must never be redirected. */
+export async function forwardSelectedRuntime(kind, currentEntry, args) {
+    const artifact = await selectedBackend();
+    if (!artifact)
+        return false;
+    const target = kind === 'cli' ? path.join(artifact.directory, 'cli/omnitron.js') : artifact.entry;
+    if (await fs.realpath(currentEntry) === target && await fs.realpath(process.execPath) === artifact.execPath)
+        return false;
+    await runRuntimeEntry(artifact, kind, args);
+    return true;
+}
+//# sourceMappingURL=runtime-launcher.js.map