@atelierai/uco 1.0.0

package/dist/devops/lib/open.js

@@ -0,0 +1,522 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { platform as nodePlatform } from 'os';
+import { findEditorPath, getProjectEditorVersion, launchEditor, } from '../utils/unity-editor.js';
+import { clearCachedEditorPath } from '../utils/editor-cache.js';
+import { findUnityProcess } from '../utils/unity-process.js';
+import { readConfig, isCloudMode, writeConfig } from '../utils/config.js';
+import { prepareOwnedNodeServer } from './owned-node-server.js';
+import { tryDismissLaunchErrorsDialog, LINUX_XDOTOOL_MISSING_PREFIX, UNSUPPORTED_PLATFORM_PREFIX, } from '../utils/launch-error-dismiss.js';
+import { emitProgress } from './progress.js';
+import { redactSensitiveText, redactSensitiveValue } from '../../util/redaction.js';
+/**
+ * Resolve the project path from an explicit option or fall back to
+ * the supplied cwd. Always returns an absolute, resolved path plus a
+ * flag indicating whether the cwd fallback was used (so the CLI
+ * surface can emit a friendlier "no path provided" message).
+ *
+ * Pure / no I/O — exported for tests and for the CLI command's own
+ * use so the two paths can share resolution semantics.
+ */
+export function resolveProjectPath(optionPath, cwd) {
+    const explicit = optionPath;
+    const resolvedPath = explicit ?? cwd;
+    return {
+        projectPath: path.resolve(resolvedPath),
+        usedCwdFallback: explicit === undefined,
+    };
+}
+/**
+ * Returns true if `projectPath` looks like a Unity project — i.e. it
+ * contains an `Assets/` directory and a
+ * `ProjectSettings/ProjectVersion.txt` file. Pure / no I/O beyond
+ * `fs.existsSync`.
+ */
+export function isUnityProjectDir(projectPath) {
+    const hasAssets = fs.existsSync(path.join(projectPath, 'Assets'));
+    const hasProjectVersion = fs.existsSync(path.join(projectPath, 'ProjectSettings', 'ProjectVersion.txt'));
+    return hasAssets && hasProjectVersion;
+}
+function isValidAuth(v) {
+    return v === 'none' || v === 'required';
+}
+function isValidTransport(v) {
+    return v === 'streamableHttp' || v === 'stdio';
+}
+/**
+ * Extract the leading executable path from a Unity process command
+ * line. Quote-aware: a leading double-quoted token (the typical
+ * Windows CIM `CommandLine` shape for paths containing spaces) is
+ * consumed whole, otherwise the first whitespace-delimited token is
+ * used. Pure / no I/O.
+ */
+function extractEditorPathFromCommandLine(commandLine) {
+    const trimmed = commandLine.trim();
+    if (trimmed.length === 0)
+        return '';
+    const quoted = trimmed.match(/^"([^"]+)"/);
+    if (quoted)
+        return quoted[1];
+    const unquoted = trimmed.match(/^(\S+)/);
+    return unquoted ? unquoted[1] : '';
+}
+/**
+ * Build the env-var map propagated to the editor process when
+ * `noConnect !== true`. Pure (returns a fresh object); validates the
+ * `auth` and `transport` enums and throws on bad input — the
+ * `openProject` boundary catches the throw and returns it as a
+ * `{ kind: 'failure' }` result so nothing escapes past the public
+ * boundary.
+ *
+ * Exported for tests so the env-var assembly can be exercised
+ * without a real editor launch.
+ */
+export function buildOpenEnv(options) {
+    if (options.noConnect === true)
+        return undefined;
+    const env = {};
+    if (options.url !== undefined)
+        env['UNITY_MCP_HOST'] = options.url;
+    if (options.keepConnected)
+        env['UNITY_MCP_KEEP_CONNECTED'] = 'true';
+    if (options.tools !== undefined)
+        env['UNITY_MCP_TOOLS'] = options.tools;
+    if (options.token !== undefined)
+        env['UNITY_MCP_TOKEN'] = options.token;
+    if (options.auth !== undefined) {
+        if (!isValidAuth(options.auth)) {
+            throw new Error('auth must be "none" or "required"');
+        }
+        env['UNITY_MCP_AUTH_OPTION'] = options.auth;
+    }
+    if (options.transport !== undefined) {
+        if (!isValidTransport(options.transport)) {
+            throw new Error('transport must be "streamableHttp" or "stdio"');
+        }
+        env['UNITY_MCP_TRANSPORT'] = options.transport;
+    }
+    if (options.startServer !== undefined) {
+        env['UNITY_MCP_START_SERVER'] = options.startServer ? 'true' : 'false';
+    }
+    return Object.keys(env).length > 0 ? env : undefined;
+}
+/**
+ * Open a Unity project in the Unity Editor — the library-callable
+ * equivalent of the `open` CLI command. Library-safe: never calls
+ * `process.exit`, never prints to stdout / stderr, never throws past
+ * the public boundary.
+ *
+ * The launch logic (Unity-version detection, editor location,
+ * project-path validation, environment-variable wiring, editor
+ * spawn) is shared with the CLI command — `commands/open.ts`
+ * delegates to this function so the two paths cannot drift.
+ *
+ * Returns a discriminated union — narrow with
+ * `result.kind === 'success'` to access `editorPath` / `editorPid`
+ * / `unityVersion` / `projectPath`, or `result.kind === 'failure'`
+ * to access `errorMessage` / `error`.
+ */
+export async function openProject(options) {
+    const warnings = [];
+    let resolvedProjectPath;
+    let resolvedEditorPath;
+    let resolvedVersion;
+    try {
+        const { projectPath } = resolveProjectPath(options.projectPath, process.cwd());
+        resolvedProjectPath = projectPath;
+        if (!fs.existsSync(projectPath)) {
+            throw new Error(`Project path does not exist: ${projectPath}`);
+        }
+        if (!isUnityProjectDir(projectPath)) {
+            throw new Error(`Not a Unity project (missing Assets/ or ProjectSettings/ProjectVersion.txt): ${projectPath}`);
+        }
+        emitProgress(options.onProgress, {
+            phase: 'start',
+            message: `Opening Unity project at ${projectPath}`,
+        });
+        // Validate auth/transport BEFORE work begins so callers learn of
+        // a typo without first paying for editor-discovery I/O. The
+        // returned env is recomputed below if cloud-mode auto-detect
+        // flips keepConnected; otherwise we reuse this same map.
+        let env = buildOpenEnv(options);
+        if (options.noConnect === true && options.startServer === true) {
+            throw new Error('--no-connect cannot be combined with COCli-owned --start-server true.');
+        }
+        if (options.transport === 'stdio' && options.startServer === true) {
+            throw new Error('COCli-owned --start-server true requires streamableHttp transport.');
+        }
+        // An existing Editor cannot receive a new launch environment. An explicit
+        // owned-server request therefore cannot be fulfilled by this invocation;
+        // fail honestly instead of starting a bridge that the Editor cannot use.
+        const existingProcess = findUnityProcess(projectPath);
+        if (existingProcess) {
+            if (options.startServer === true) {
+                throw new Error(`Unity is already running with this project (PID: ${existingProcess.pid}). ` +
+                    'Close it and reopen with --start-server true; the running Editor cannot receive ' +
+                    'the verified connection environment from a new uco launch.');
+            }
+            warnings.push(`Unity is already running with this project (PID: ${existingProcess.pid}). Skipping launch.`);
+            emitProgress(options.onProgress, {
+                phase: 'done',
+                message: 'Unity is already running for this project — launch skipped.',
+            });
+            return {
+                kind: 'success',
+                success: true,
+                editorPath: extractEditorPathFromCommandLine(existingProcess.commandLine),
+                editorPid: existingProcess.pid,
+                unityVersion: getProjectEditorVersion(projectPath) ?? undefined,
+                projectPath,
+                warnings,
+                alreadyRunning: true,
+            };
+        }
+        // Resolve editor version: explicit option wins, otherwise read
+        // from ProjectVersion.txt.
+        emitProgress(options.onProgress, {
+            phase: 'detecting-editor-version',
+            message: 'Detecting Unity Editor version',
+        });
+        let version = options.unityVersion;
+        if (!version) {
+            version = getProjectEditorVersion(projectPath) ?? undefined;
+        }
+        resolvedVersion = version;
+        // Locate editor binary (Unity Hub / common locations).
+        const editorPath = await findEditorPath(version);
+        // Boolean signal for caller telemetry — we surface only whether
+        // editor discovery succeeded, not how many editors are installed.
+        emitProgress(options.onProgress, {
+            phase: 'editors-located',
+            message: editorPath
+                ? 'Located Unity Editor candidates'
+                : 'Failed to locate any Unity Editor',
+            found: editorPath !== null,
+        });
+        if (!editorPath) {
+            const detail = version
+                ? `Unity Editor ${version} is not installed.`
+                : 'No Unity Editor found.';
+            throw new Error(detail);
+        }
+        resolvedEditorPath = editorPath;
+        emitProgress(options.onProgress, {
+            phase: 'editor-resolved',
+            message: `Resolved Unity Editor at ${editorPath}`,
+            editorPath,
+            version,
+        });
+        // Cloud-mode auto-detect: if the project's config is in Cloud
+        // mode AND has a cloudToken, ensure keepConnected so the plugin
+        // connects on startup; also enable claude-code skill auto-gen.
+        let effectiveOptions = options;
+        {
+            const config = readConfig(projectPath);
+            if (config && isCloudMode(config) && config.cloudToken) {
+                if (!effectiveOptions.keepConnected) {
+                    effectiveOptions = { ...effectiveOptions, keepConnected: true };
+                    warnings.push('Cloud mode with token detected — auto-enabling keep-connected.');
+                    // keepConnected flipped — rebuild the env map so the editor
+                    // receives UNITY_MCP_KEEP_CONNECTED=true.
+                    env = buildOpenEnv(effectiveOptions);
+                }
+                const skillAutoGenerate = { ...(config.skillAutoGenerate ?? {}) };
+                if (!skillAutoGenerate['claude-code']) {
+                    skillAutoGenerate['claude-code'] = true;
+                    writeConfig(projectPath, { ...config, skillAutoGenerate });
+                }
+            }
+        }
+        // Explicit --start-server true means UCO owns the Node process. Establish
+        // its listener and authenticated health endpoint before Unity can attempt
+        // the plugin WebSocket connection. Tell the plugin not to start a duplicate.
+        if (effectiveOptions.startServer === true) {
+            emitProgress(options.onProgress, {
+                phase: 'starting-node-server',
+                message: 'Starting the local Node bridge before Unity',
+            });
+            const ownedServer = await prepareOwnedNodeServer({
+                projectPath,
+                ...(effectiveOptions.url ? { url: effectiveOptions.url } : {}),
+                ...(effectiveOptions.token ? { token: effectiveOptions.token } : {}),
+                ...(effectiveOptions.auth ? { auth: effectiveOptions.auth } : {}),
+            });
+            effectiveOptions = {
+                ...effectiveOptions,
+                url: ownedServer.baseUrl,
+                token: ownedServer.token,
+                auth: ownedServer.authorization,
+                startServer: false,
+            };
+            env = buildOpenEnv(effectiveOptions);
+            emitProgress(options.onProgress, {
+                phase: 'node-server-ready',
+                message: ownedServer.alreadyRunning
+                    ? 'Local Node bridge was already ready'
+                    : 'Local Node bridge is listening and authenticated',
+                alreadyRunning: ownedServer.alreadyRunning,
+                pid: ownedServer.pid,
+            });
+        }
+        emitProgress(options.onProgress, {
+            phase: 'connection-details',
+            message: env
+                ? 'MCP connection environment variables prepared'
+                : 'No MCP connection environment variables (--no-connect or no options provided)',
+            projectPath,
+            editorPath,
+            envVars: redactOpenEnvironment(env),
+        });
+        emitProgress(options.onProgress, {
+            phase: 'launching-editor',
+            message: `Launching Unity Editor`,
+            editorPath,
+            projectPath,
+        });
+        // Spawn the editor via the shared util. We capture the spawn /
+        // error events with callbacks and bridge them to the
+        // onProgress channel.
+        const child = launchEditor(editorPath, projectPath, env, {
+            onSpawn: (pid) => {
+                emitProgress(options.onProgress, {
+                    phase: 'editor-launched',
+                    message: `Launched Unity Editor (PID: ${pid ?? 'unknown'})`,
+                    pid,
+                });
+            },
+            onError: (err) => {
+                // Don't throw out of the event listener — the caller can't
+                // catch it. Surface the warning for diagnostics.
+                warnings.push(`Editor spawn reported error: ${err.message}`);
+                // The resolved path failed to spawn (binary corrupted,
+                // wrong arch, perms revoked, …). Drop the cache so the
+                // next invocation re-resolves from Unity Hub instead of
+                // handing back the same broken path.
+                clearCachedEditorPath(version);
+            },
+        });
+        // The `spawn` event fires asynchronously after `spawn(...)` returns.
+        // We wait briefly so the PID gets surfaced in the result. The
+        // child is already detached + unref'd, so this does NOT block
+        // process exit.
+        const pid = await waitForSpawn(child);
+        // Auto-dismiss the Unity "compile errors at launch" dialog if it
+        // appears. The polling loop runs synchronously inside this call
+        // (so the CLI's event loop stays alive until it completes) but
+        // never throws — a transient platform error is logged via the
+        // progress callback as a warning and the loop continues until
+        // either the dialog is dismissed and stays dismissed, the abort
+        // signal fires, the no-dialog grace window elapses, or the
+        // overall timeout elapses.
+        //
+        // When `autoDismissLaunchErrors === false` the loop is skipped
+        // entirely; behaviour is identical to the pre-feature baseline.
+        if (options.autoDismissLaunchErrors !== false) {
+            await pollAndDismissLaunchErrors({
+                timeoutMs: options.launchDismissTimeoutMs ?? 30000,
+                intervalMs: options.launchDismissPollIntervalMs ?? 1500,
+                onProgress: options.onProgress,
+                warnings,
+                abortSignal: options.launchDismissAbortSignal,
+            });
+        }
+        emitProgress(options.onProgress, {
+            phase: 'done',
+            message: 'Editor launched.',
+        });
+        return {
+            kind: 'success',
+            success: true,
+            editorPath,
+            editorPid: pid,
+            unityVersion: version,
+            projectPath,
+            warnings,
+        };
+    }
+    catch (err) {
+        const originalMessage = err instanceof Error ? err.message : String(err);
+        const withoutExplicitToken = options.token
+            ? originalMessage.split(options.token).join('[REDACTED]')
+            : originalMessage;
+        const errorObj = new Error(redactSensitiveText(withoutExplicitToken));
+        return {
+            kind: 'failure',
+            success: false,
+            projectPath: resolvedProjectPath,
+            editorPath: resolvedEditorPath,
+            unityVersion: resolvedVersion,
+            warnings,
+            errorMessage: errorObj.message,
+            error: errorObj,
+        };
+    }
+}
+function redactOpenEnvironment(env) {
+    const redacted = redactSensitiveValue(env ?? {});
+    if (env?.UNITY_MCP_TOKEN !== undefined)
+        redacted.UNITY_MCP_TOKEN = '[REDACTED]';
+    return redacted;
+}
+/**
+ * Poll the OS desktop for the Unity "compile errors at launch"
+ * dialog and click `Ignore` (or the platform-equivalent) every time
+ * the probe reports it as found. Returns once the abort signal has
+ * fired, the no-dialog grace window has elapsed, the overall timeout
+ * has elapsed, or a permanent platform error has been observed.
+ *
+ * Re-entrant dismissals are supported: when the dialog re-appears
+ * after a successful click (the resolver-fix → dialog-reappears
+ * cycle described in the issue), each subsequent dismissal emits its
+ * own `launch-errors-dismissed` progress event so the user sees the
+ * recurrence in the log.
+ *
+ * Library-safe: never throws. Transient platform errors (e.g. a
+ * missing `xdotool` on Linux, or a momentary syscall failure on
+ * Windows) are recorded once as a warning on the supplied
+ * `warnings` array; subsequent identical errors are silently
+ * suppressed so the warnings array does not balloon over the polling
+ * window. Permanent errors (e.g. xdotool truly absent) bail out of
+ * the loop after the first occurrence so the helper does not spawn
+ * 60 doomed tool invocations on a 30s budget.
+ */
+export async function _pollAndDismissLaunchErrorsForTests(opts) {
+    return pollAndDismissLaunchErrors(opts);
+}
+/**
+ * Substring markers that identify a `kind: 'error'` outcome as
+ * permanent for this run. When seen, the polling loop bails out
+ * after recording the warning once; ticking again would just respawn
+ * the same doomed tool. Keep this list narrow — only conditions that
+ * cannot self-heal mid-launch belong here.
+ *
+ * The entries reference the producer-side constants in
+ * `launch-error-dismiss.ts` so a re-word at the producer site stays
+ * in sync with the bailout matcher (and the test in
+ * `launch-error-dismiss.test.ts` locks the constants down).
+ */
+const PERMANENT_DISMISS_ERROR_MARKERS = [
+    LINUX_XDOTOOL_MISSING_PREFIX,
+    UNSUPPORTED_PLATFORM_PREFIX,
+];
+function isPermanentDismissError(message) {
+    return PERMANENT_DISMISS_ERROR_MARKERS.some((m) => message.includes(m));
+}
+async function pollAndDismissLaunchErrors(opts) {
+    const platform = (opts.platform ?? nodePlatform());
+    const probe = opts.probe ?? tryDismissLaunchErrorsDialog;
+    const start = Date.now();
+    const deadline = start + Math.max(0, opts.timeoutMs);
+    const interval = Math.max(50, opts.intervalMs);
+    const graceMs = Math.max(0, opts.noDialogGraceMs ?? 15000);
+    const seenErrorMessages = new Set();
+    let dismissedAtLeastOnce = false;
+    let aborted = opts.abortSignal?.aborted ?? false;
+    const onAbort = () => { aborted = true; };
+    opts.abortSignal?.addEventListener('abort', onAbort, { once: true });
+    try {
+        while (Date.now() < deadline && !aborted) {
+            const outcome = await probe(platform);
+            // Re-check the exit conditions BEFORE applying the outcome:
+            // if abort fired (or the deadline lapsed) while `probe` was
+            // in flight, the in-flight result is stale and applying it
+            // would emit a misleading progress event or warning.
+            if (aborted || Date.now() >= deadline)
+                break;
+            if (outcome.kind === 'dismissed') {
+                dismissedAtLeastOnce = true;
+                emitProgress(opts.onProgress, {
+                    phase: 'launch-errors-dismissed',
+                    message: `[open] dismissed Unity launch-errors dialog (button=${outcome.button}, platform=${platform})`,
+                    button: outcome.button,
+                    platform,
+                });
+                // Keep polling — the dialog may re-appear after the resolver
+                // fixes one error and surfaces the next.
+            }
+            else if (outcome.kind === 'error') {
+                if (!seenErrorMessages.has(outcome.message)) {
+                    seenErrorMessages.add(outcome.message);
+                    opts.warnings.push(`launch-errors auto-dismiss: ${outcome.message}`);
+                }
+                if (isPermanentDismissError(outcome.message)) {
+                    // No point ticking another 59 times — bail out.
+                    return;
+                }
+            }
+            else if (
+            // outcome.kind === 'not-found'
+            !dismissedAtLeastOnce &&
+                opts.abortSignal === undefined &&
+                Date.now() - start >= graceMs) {
+                // No dialog within the grace window AND no caller-supplied
+                // abort signal to wait on. Exit early — the README's "no
+                // extra delay" claim depends on this.
+                return;
+            }
+            const remaining = deadline - Date.now();
+            if (remaining <= 0 || aborted)
+                break;
+            await sleep(Math.min(interval, remaining), opts.abortSignal);
+        }
+    }
+    finally {
+        opts.abortSignal?.removeEventListener('abort', onAbort);
+    }
+    // Surface a timeout warning ONLY when the deadline was actually
+    // reached (not the abort path) AND a platform error was observed.
+    // The grace-window exit returns silently above; the abort path is
+    // a caller-driven cancellation, not a timeout.
+    if (Date.now() >= deadline &&
+        !aborted &&
+        seenErrorMessages.size > 0 &&
+        !dismissedAtLeastOnce) {
+        opts.warnings.push(`launch-errors auto-dismiss timed out after ${opts.timeoutMs}ms — continuing with wait-for-ready`);
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const t = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(t);
+            resolve();
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+        // Do NOT unref() — the polling timer is the reason `openProject`
+        // is awaiting in the first place, and unref'ing would let Node
+        // exit before the loop completes.
+    });
+}
+/**
+ * Resolve to the spawned PID once the child process emits its
+ * `spawn` event, or to `undefined` if a short timeout elapses or
+ * the process emits `error` first. Library-safe: never throws,
+ * never blocks process exit (the caller has already detached).
+ */
+function waitForSpawn(child, timeoutMs = 2000) {
+    return new Promise((resolve) => {
+        if (child.pid !== undefined && child.pid !== null) {
+            // Some Node versions populate `pid` synchronously on spawn().
+            resolve(child.pid);
+            return;
+        }
+        let settled = false;
+        const finish = (pid) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(pid);
+        };
+        child.once('spawn', () => finish(child.pid ?? undefined));
+        child.once('error', () => finish(undefined));
+        setTimeout(() => finish(child.pid ?? undefined), timeoutMs).unref();
+    });
+}
+//# sourceMappingURL=open.js.map

package/dist/devops/lib/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/devops/lib/open.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,2BAA2B,GAE5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAUpF;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA8B,EAC9B,GAAW;IAEX,MAAM,QAAQ,GAAG,UAAU,CAAC;IAC5B,MAAM,YAAY,GAAG,QAAQ,IAAI,GAAG,CAAC;IACrC,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QACvC,eAAe,EAAE,QAAQ,KAAK,SAAS;KACxC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,MAAM,SAAS,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClE,MAAM,iBAAiB,GAAG,EAAE,CAAC,UAAU,CACrC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,CAAC,CAChE,CAAC;IACF,OAAO,SAAS,IAAI,iBAAiB,CAAC;AACxC,CAAC;AAED,SAAS,WAAW,CAAC,CAAU;IAC7B,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,UAAU,CAAC;AAC1C,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAU;IAClC,OAAO,CAAC,KAAK,gBAAgB,IAAI,CAAC,KAAK,OAAO,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gCAAgC,CAAC,WAAmB;IAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAsB;IAEtB,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAEjD,MAAM,GAAG,GAA2B,EAAE,CAAC;IAEvC,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,GAAG,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IACnE,IAAI,OAAO,CAAC,aAAa;QAAE,GAAG,CAAC,0BAA0B,CAAC,GAAG,MAAM,CAAC;IACpE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IACxE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAExE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,GAAG,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,GAAG,CAAC,qBAAqB,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IACjD,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,GAAG,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACzE,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAA2B;IAE3B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,mBAAuC,CAAC;IAC5C,IAAI,kBAAsC,CAAC;IAC3C,IAAI,eAAmC,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/E,mBAAmB,GAAG,WAAW,CAAC;QAElC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,gFAAgF,WAAW,EAAE,CAC9F,CAAC;QACJ,CAAC;QAED,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;YAC/B,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,4BAA4B,WAAW,EAAE;SACnD,CAAC,CAAC;QAEH,iEAAiE;QACjE,4DAA4D;QAC5D,6DAA6D;QAC7D,yDAAyD;QACzD,IAAI,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,KAAK,OAAO,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACxF,CAAC;QAED,0EAA0E;QAC1E,yEAAyE;QACzE,yEAAyE;QACzE,MAAM,eAAe,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CACb,oDAAoD,eAAe,CAAC,GAAG,KAAK;oBAC5E,kFAAkF;oBAClF,4DAA4D,CAC7D,CAAC;YACJ,CAAC;YACD,QAAQ,CAAC,IAAI,CACX,oDAAoD,eAAe,CAAC,GAAG,qBAAqB,CAC7F,CAAC;YACF,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;gBAC/B,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,6DAA6D;aACvE,CAAC,CAAC;YACH,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,gCAAgC,CAAC,eAAe,CAAC,WAAW,CAAC;gBACzE,SAAS,EAAE,eAAe,CAAC,GAAG;gBAC9B,YAAY,EAAE,uBAAuB,CAAC,WAAW,CAAC,IAAI,SAAS;gBAC/D,WAAW;gBACX,QAAQ;gBACR,cAAc,EAAE,IAAI;aACrB,CAAC;QACJ,CAAC;QAED,+DAA+D;QAC/D,2BAA2B;QAC3B,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;YAC/B,KAAK,EAAE,0BAA0B;YACjC,OAAO,EAAE,gCAAgC;SAC1C,CAAC,CAAC;QACH,IAAI,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,uBAAuB,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC;QAC9D,CAAC;QACD,eAAe,GAAG,OAAO,CAAC;QAE1B,uDAAuD;QACvD,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;QAEjD,gEAAgE;QAChE,kEAAkE;QAClE,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;YAC/B,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,UAAU;gBACjB,CAAC,CAAC,iCAAiC;gBACnC,CAAC,CAAC,mCAAmC;YACvC,KAAK,EAAE,UAAU,KAAK,IAAI;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,OAAO;gBACpB,CAAC,CAAC,gBAAgB,OAAO,oBAAoB;gBAC7C,CAAC,CAAC,wBAAwB,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QACD,kBAAkB,GAAG,UAAU,CAAC;QAEhC,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;YAC/B,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,4BAA4B,UAAU,EAAE;YACjD,UAAU;YACV,OAAO;SACR,CAAC,CAAC;QAEH,8DAA8D;QAC9D,gEAAgE;QAChE,+DAA+D;QAC/D,IAAI,gBAAgB,GAAG,OAAO,CAAC;QAC/B,CAAC;YACC,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACvD,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAC;oBACpC,gBAAgB,GAAG,EAAE,GAAG,gBAAgB,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;oBAChE,QAAQ,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;oBAChF,4DAA4D;oBAC5D,0CAA0C;oBAC1C,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;gBACvC,CAAC;gBACD,MAAM,iBAAiB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC,EAA6B,CAAC;gBAC7F,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,CAAC;oBACtC,iBAAiB,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;oBACxC,WAAW,CAAC,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,0EAA0E;QAC1E,6EAA6E;QAC7E,IAAI,gBAAgB,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC1C,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;gBAC/B,KAAK,EAAE,sBAAsB;gBAC7B,OAAO,EAAE,6CAA6C;aACvD,CAAC,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,sBAAsB,CAAC;gBAC/C,WAAW;gBACX,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClE,CAAC,CAAC;YACH,gBAAgB,GAAG;gBACjB,GAAG,gBAAgB;gBACnB,GAAG,EAAE,WAAW,CAAC,OAAO;gBACxB,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,IAAI,EAAE,WAAW,CAAC,aAAa;gBAC/B,WAAW,EAAE,KAAK;aACnB,CAAC;YACF,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;YACrC,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;gBAC/B,KAAK,EAAE,mBAAmB;gBAC1B,OAAO,EAAE,WAAW,CAAC,cAAc;oBACjC,CAAC,CAAC,qCAAqC;oBACvC,CAAC,CAAC,kDAAkD;gBACtD,cAAc,EAAE,WAAW,CAAC,cAAc;gBAC1C,GAAG,EAAE,WAAW,CAAC,GAAG;aACrB,CAAC,CAAC;QACL,CAAC;QAED,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;YAC/B,KAAK,EAAE,oBAAoB;YAC3B,OAAO,EAAE,GAAG;gBACV,CAAC,CAAC,+CAA+C;gBACjD,CAAC,CAAC,+EAA+E;YACnF,WAAW;YACX,UAAU;YACV,OAAO,EAAE,qBAAqB,CAAC,GAAG,CAAC;SACpC,CAAC,CAAC;QAEH,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;YAC/B,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE,wBAAwB;YACjC,UAAU;YACV,WAAW;SACZ,CAAC,CAAC;QAEH,+DAA+D;QAC/D,qDAAqD;QACrD,sBAAsB;QACtB,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,EAAE;YACvD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;oBAC/B,KAAK,EAAE,iBAAiB;oBACxB,OAAO,EAAE,+BAA+B,GAAG,IAAI,SAAS,GAAG;oBAC3D,GAAG;iBACJ,CAAC,CAAC;YACL,CAAC;YACD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,2DAA2D;gBAC3D,iDAAiD;gBACjD,QAAQ,CAAC,IAAI,CAAC,gCAAgC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC7D,uDAAuD;gBACvD,uDAAuD;gBACvD,wDAAwD;gBACxD,qCAAqC;gBACrC,qBAAqB,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;SACF,CAAC,CAAC;QAEH,qEAAqE;QACrE,8DAA8D;QAC9D,8DAA8D;QAC9D,gBAAgB;QAChB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;QAEtC,iEAAiE;QACjE,gEAAgE;QAChE,+DAA+D;QAC/D,8DAA8D;QAC9D,8DAA8D;QAC9D,gEAAgE;QAChE,2DAA2D;QAC3D,2BAA2B;QAC3B,EAAE;QACF,+DAA+D;QAC/D,gEAAgE;QAChE,IAAI,OAAO,CAAC,uBAAuB,KAAK,KAAK,EAAE,CAAC;YAC9C,MAAM,0BAA0B,CAAC;gBAC/B,SAAS,EAAE,OAAO,CAAC,sBAAsB,IAAI,KAAK;gBAClD,UAAU,EAAE,OAAO,CAAC,2BAA2B,IAAI,IAAI;gBACvD,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ;gBACR,WAAW,EAAE,OAAO,CAAC,wBAAwB;aAC9C,CAAC,CAAC;QACL,CAAC;QAED,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE;YAC/B,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,UAAU;YACV,SAAS,EAAE,GAAG;YACd,YAAY,EAAE,OAAO;YACrB,WAAW;YACX,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,eAAe,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzE,MAAM,oBAAoB,GAAG,OAAO,CAAC,KAAK;YACxC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;YACzD,CAAC,CAAC,eAAe,CAAC;QACpB,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,CAAC,CAAC;QACtE,OAAO;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,mBAAmB;YAChC,UAAU,EAAE,kBAAkB;YAC9B,YAAY,EAAE,eAAe;YAC7B,QAAQ;YACR,YAAY,EAAE,QAAQ,CAAC,OAAO;YAC9B,KAAK,EAAE,QAAQ;SAChB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAuC;IACpE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,IAAI,EAAE,CAA2B,CAAC;IAC3E,IAAI,GAAG,EAAE,eAAe,KAAK,SAAS;QAAE,QAAQ,CAAC,eAAe,GAAG,YAAY,CAAC;IAChF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAkED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,IAAoC;IAEpC,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,+BAA+B,GAAsB;IACzD,4BAA4B;IAC5B,2BAA2B;CAC5B,CAAC;AAEF,SAAS,uBAAuB,CAAC,OAAe;IAC9C,OAAO,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,KAAK,UAAU,0BAA0B,CAAC,IAA2B;IACnE,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAK,YAAY,EAAsB,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,4BAA4B,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC,CAAC;IAC3D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,IAAI,oBAAoB,GAAG,KAAK,CAAC;IACjC,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,IAAI,KAAK,CAAC;IACjD,MAAM,OAAO,GAAG,GAAS,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;YACtC,4DAA4D;YAC5D,4DAA4D;YAC5D,2DAA2D;YAC3D,qDAAqD;YACrD,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;gBAAE,MAAM;YAC7C,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACjC,oBAAoB,GAAG,IAAI,CAAC;gBAC5B,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE;oBAC5B,KAAK,EAAE,yBAAyB;oBAChC,OAAO,EAAE,uDAAuD,OAAO,CAAC,MAAM,cAAc,QAAQ,GAAG;oBACvG,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ;iBACT,CAAC,CAAC;gBACH,6DAA6D;gBAC7D,yCAAyC;YAC3C,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACpC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC5C,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,+BAA+B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvE,CAAC;gBACD,IAAI,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC7C,gDAAgD;oBAChD,OAAO;gBACT,CAAC;YACH,CAAC;iBAAM;YACL,+BAA+B;YAC/B,CAAC,oBAAoB;gBACrB,IAAI,CAAC,WAAW,KAAK,SAAS;gBAC9B,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,OAAO,EAC7B,CAAC;gBACD,2DAA2D;gBAC3D,yDAAyD;gBACzD,sCAAsC;gBACtC,OAAO;YACT,CAAC;YACD,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACxC,IAAI,SAAS,IAAI,CAAC,IAAI,OAAO;gBAAE,MAAM;YACrC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IACD,gEAAgE;IAChE,kEAAkE;IAClE,kEAAkE;IAClE,+CAA+C;IAC/C,IACE,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;QACtB,CAAC,OAAO;QACR,iBAAiB,CAAC,IAAI,GAAG,CAAC;QAC1B,CAAC,oBAAoB,EACrB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,8CAA8C,IAAI,CAAC,SAAS,qCAAqC,CAClG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,iEAAiE;QACjE,+DAA+D;QAC/D,kCAAkC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CACnB,KAA2C,EAC3C,SAAS,GAAG,IAAI;IAEhB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;YAClD,8DAA8D;YAC9D,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,GAAuB,EAAQ,EAAE;YAC/C,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,CAAC;QACf,CAAC,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7C,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/devops/lib/owned-node-server.d.ts

@@ -0,0 +1,54 @@
+import { spawn } from 'node:child_process';
+export interface OwnedNodeServerOptions {
+    projectPath: string;
+    url?: string;
+    token?: string;
+    auth?: 'none' | 'required';
+    startupTimeoutMs?: number;
+    pollIntervalMs?: number;
+    cleanupTimeoutMs?: number;
+    /** Bounded wait for an occupied endpoint. Kept under the old option name for compatibility. */
+    lockTimeoutMs?: number;
+    /** Poll interval for endpoint reuse/reservation attempts. */
+    lockPollIntervalMs?: number;
+}
+export interface OwnedNodeServerResult {
+    baseUrl: string;
+    token: string | undefined;
+    authorization: 'none' | 'required';
+    alreadyRunning: boolean;
+    pid?: number;
+    serverInstanceId?: string;
+}
+export type OwnedHandoffPhase = 'reserved' | 'prepared' | 'spawned' | 'transferred' | 'precommit' | 'commit-intent' | 'commit-acknowledged' | 'committed';
+export interface OwnedNodeServerDependencies {
+    fetchImpl?: typeof fetch;
+    spawnImpl?: typeof spawn;
+    serverEntry?: string;
+    sleepImpl?: (ms: number) => Promise<void>;
+    onHandoffPhase?: (phase: OwnedHandoffPhase, details: {
+        serverInstanceId?: string;
+        pid?: number;
+    }) => void | Promise<void>;
+}
+export interface OwnedServerCredentials {
+    baseUrl: string;
+    listenHost: string;
+    port: number;
+    token: string | undefined;
+    authorization: 'none' | 'required';
+    tokenSource: 'explicit' | 'descriptor' | 'generated' | 'none';
+}
+/**
+ * Reserve and hand off the real target socket. No descriptor mutation or
+ * child spawn occurs until this process owns that operating-system resource.
+ */
+export declare function prepareOwnedNodeServer(options: OwnedNodeServerOptions, dependencies?: OwnedNodeServerDependencies): Promise<OwnedNodeServerResult>;
+/**
+ * Compatibility helper for callers that explicitly want immediate credential
+ * persistence. The owned lifecycle itself uses read-only planning followed by
+ * finalization only after socket reservation.
+ */
+export declare function resolveOwnedServerCredentials(options: OwnedNodeServerOptions): OwnedServerCredentials;
+/** Read host/auth/token candidates without writing the project descriptor. */
+export declare function planOwnedServerCredentials(options: OwnedNodeServerOptions): OwnedServerCredentials;