@pixelzx/genesis 2026.6.13-beta.3 → 2026.6.13

package/dist/onboard-non-interactive-Hk6vLQCB.js

@@ -0,0 +1,635 @@
+import { c as normalizeOptionalString } from "./string-coerce-DPP_aYVc.js";
+import { m as resolveUserPath } from "./utils-CWrkFsp0.js";
+import { n as defaultRuntime, r as writeRuntimeJson } from "./runtime-DDkDH9fa.js";
+import { t as formatCliCommand } from "./command-format-B3Q5KD9o.js";
+import { u as resolveGatewayPort } from "./paths-Bv2rGpO9.js";
+import "./daemon-runtime-CJizAliC.js";
+import { c as isValidEnvSecretRefId, p as resolveSecretInputRef } from "./types.secrets-BbgGt42I.js";
+import { l as resolveDefaultSecretProviderAlias } from "./ref-contract-D_WmZ91C.js";
+import { t as resolveGatewayAuthToken } from "./auth-token-resolution-GdyGS8ti.js";
+import { u as readConfigFileSnapshot } from "./io-lNN4Levs.js";
+import { t as randomToken } from "./random-token-CC24wPn8.js";
+import { r as replaceConfigFile } from "./mutate-CEhvH2fV.js";
+import "./config-DzozJ_v4.js";
+import { t as resolveControlUiLinks } from "./control-ui-links-C-bMAXFT.js";
+import { n as logConfigUpdated } from "./logging-B8esngtp.js";
+import { c as normalizeGatewayTokenInput, m as waitForGatewayReachable, n as applyWizardMetadata, r as ensureWorkspaceAndSessions, t as DEFAULT_WORKSPACE } from "./onboard-helpers-Kt5u4yMJ.js";
+import { n as loadNodeHostConfig, r as saveNodeHostConfig } from "./config-D9J1iRQR.js";
+import { i as applySkipBootstrapConfig, r as applyLocalSetupWorkspaceConfig } from "./onboard-config-CyDLmOtI.js";
+//#region src/commands/onboard-non-interactive/local/gateway-config.ts
+function applyNonInteractiveGatewayConfig(params) {
+	const { opts, runtime } = params;
+	const hasGatewayPort = opts.gatewayPort !== void 0;
+	if (hasGatewayPort && (!Number.isFinite(opts.gatewayPort) || (opts.gatewayPort ?? 0) <= 0)) {
+		runtime.error("Invalid --gateway-port");
+		runtime.exit(1);
+		return null;
+	}
+	const port = hasGatewayPort ? opts.gatewayPort : params.defaultPort;
+	let bind = opts.gatewayBind ?? "loopback";
+	const authModeRaw = opts.gatewayAuth ?? "token";
+	if (authModeRaw !== "token" && authModeRaw !== "password") {
+		runtime.error("Invalid --gateway-auth (use token|password).");
+		runtime.exit(1);
+		return null;
+	}
+	let authMode = authModeRaw;
+	const tailscaleMode = opts.tailscale ?? "off";
+	const tailscaleResetOnExit = Boolean(opts.tailscaleResetOnExit);
+	if (tailscaleMode !== "off" && bind !== "loopback") bind = "loopback";
+	if (tailscaleMode === "funnel" && authMode !== "password") authMode = "password";
+	let nextConfig = params.nextConfig;
+	const explicitGatewayToken = normalizeGatewayTokenInput(opts.gatewayToken);
+	const envGatewayToken = normalizeGatewayTokenInput(process.env.GENESIS_GATEWAY_TOKEN);
+	const existingTokenInput = nextConfig.gateway?.auth?.token;
+	const existingTokenRef = resolveSecretInputRef({
+		value: existingTokenInput,
+		defaults: nextConfig.secrets?.defaults
+	}).ref;
+	const existingPlaintextToken = normalizeGatewayTokenInput(existingTokenInput);
+	let gatewayToken = explicitGatewayToken || existingPlaintextToken || envGatewayToken || void 0;
+	const gatewayTokenRefEnv = normalizeOptionalString(opts.gatewayTokenRefEnv ?? "") ?? "";
+	if (authMode === "token") if (gatewayTokenRefEnv) {
+		if (!isValidEnvSecretRefId(gatewayTokenRefEnv)) {
+			runtime.error("Invalid --gateway-token-ref-env (use env var name like GENESIS_GATEWAY_TOKEN).");
+			runtime.exit(1);
+			return null;
+		}
+		if (explicitGatewayToken) {
+			runtime.error("Use either --gateway-token or --gateway-token-ref-env, not both.");
+			runtime.exit(1);
+			return null;
+		}
+		const resolvedFromEnv = process.env[gatewayTokenRefEnv]?.trim();
+		if (!resolvedFromEnv) {
+			runtime.error(`Environment variable "${gatewayTokenRefEnv}" is missing or empty.`);
+			runtime.exit(1);
+			return null;
+		}
+		gatewayToken = resolvedFromEnv;
+		nextConfig = {
+			...nextConfig,
+			gateway: {
+				...nextConfig.gateway,
+				auth: {
+					...nextConfig.gateway?.auth,
+					mode: "token",
+					token: {
+						source: "env",
+						provider: resolveDefaultSecretProviderAlias(nextConfig, "env", { preferFirstProviderForSource: true }),
+						id: gatewayTokenRefEnv
+					}
+				}
+			}
+		};
+	} else if (!explicitGatewayToken && existingTokenRef) nextConfig = {
+		...nextConfig,
+		gateway: {
+			...nextConfig.gateway,
+			auth: {
+				...nextConfig.gateway?.auth,
+				mode: "token"
+			}
+		}
+	};
+	else {
+		if (!gatewayToken) gatewayToken = randomToken();
+		nextConfig = {
+			...nextConfig,
+			gateway: {
+				...nextConfig.gateway,
+				auth: {
+					...nextConfig.gateway?.auth,
+					mode: "token",
+					token: gatewayToken
+				}
+			}
+		};
+	}
+	if (authMode === "password") {
+		const password = opts.gatewayPassword?.trim();
+		if (!password) {
+			runtime.error("Missing --gateway-password for password auth.");
+			runtime.exit(1);
+			return null;
+		}
+		nextConfig = {
+			...nextConfig,
+			gateway: {
+				...nextConfig.gateway,
+				auth: {
+					...nextConfig.gateway?.auth,
+					mode: "password",
+					password
+				}
+			}
+		};
+	}
+	nextConfig = {
+		...nextConfig,
+		gateway: {
+			...nextConfig.gateway,
+			port,
+			bind,
+			tailscale: {
+				...nextConfig.gateway?.tailscale,
+				mode: tailscaleMode,
+				resetOnExit: tailscaleResetOnExit
+			}
+		}
+	};
+	return {
+		nextConfig,
+		port,
+		bind,
+		authMode,
+		tailscaleMode,
+		tailscaleResetOnExit
+	};
+}
+//#endregion
+//#region src/commands/onboard-non-interactive/local/output.ts
+function logNonInteractiveOnboardingJson(params) {
+	if (!params.opts.json) return;
+	writeRuntimeJson(params.runtime, {
+		ok: true,
+		mode: params.mode,
+		workspace: params.workspaceDir,
+		authChoice: params.authChoice,
+		gateway: params.gateway,
+		installDaemon: Boolean(params.installDaemon),
+		daemonInstall: params.daemonInstall,
+		daemonRuntime: params.daemonRuntime,
+		skipSkills: Boolean(params.skipSkills),
+		skipHealth: Boolean(params.skipHealth)
+	});
+}
+function formatGatewayRuntimeSummary(diagnostics) {
+	const service = diagnostics?.service;
+	if (!service?.runtimeStatus) return;
+	const parts = [service.runtimeStatus];
+	if (typeof service.pid === "number") parts.push(`pid ${service.pid}`);
+	if (service.state) parts.push(`state ${service.state}`);
+	if (typeof service.lastExitStatus === "number") parts.push(`last exit ${service.lastExitStatus}`);
+	if (service.lastExitReason) parts.push(`reason ${service.lastExitReason}`);
+	return parts.join(", ");
+}
+function logNonInteractiveOnboardingFailure(params) {
+	const hints = params.hints?.filter(Boolean) ?? [];
+	const gatewayRuntime = formatGatewayRuntimeSummary(params.diagnostics);
+	if (params.opts.json) {
+		writeRuntimeJson(params.runtime, {
+			ok: false,
+			mode: params.mode,
+			phase: params.phase,
+			message: params.message,
+			detail: params.detail,
+			gateway: params.gateway,
+			installDaemon: Boolean(params.installDaemon),
+			daemonInstall: params.daemonInstall,
+			daemonRuntime: params.daemonRuntime,
+			diagnostics: params.diagnostics,
+			hints: hints.length > 0 ? hints : void 0
+		});
+		return;
+	}
+	const lines = [
+		params.message,
+		params.detail ? `Last probe: ${params.detail}` : void 0,
+		params.diagnostics?.service ? `Service: ${params.diagnostics.service.label} (${params.diagnostics.service.loaded ? params.diagnostics.service.loadedText : "not loaded"})` : void 0,
+		gatewayRuntime ? `Runtime: ${gatewayRuntime}` : void 0,
+		params.diagnostics?.lastGatewayError ? `Last gateway error: ${params.diagnostics.lastGatewayError}` : void 0,
+		params.diagnostics?.inspectError ? `Diagnostics warning: ${params.diagnostics.inspectError}` : void 0,
+		hints.length > 0 ? hints.join("\n") : void 0
+	].filter(Boolean).join("\n");
+	params.runtime.error(lines);
+}
+//#endregion
+//#region src/commands/onboard-non-interactive/local/skills-config.ts
+function applyNonInteractiveSkillsConfig(params) {
+	const { nextConfig, opts, runtime } = params;
+	if (opts.skipSkills) return nextConfig;
+	const nodeManager = opts.nodeManager ?? "npm";
+	if (![
+		"npm",
+		"pnpm",
+		"bun"
+	].includes(nodeManager)) {
+		runtime.error("Invalid --node-manager (use npm, pnpm, or bun)");
+		runtime.exit(1);
+		return nextConfig;
+	}
+	return {
+		...nextConfig,
+		skills: {
+			...nextConfig.skills,
+			install: {
+				...nextConfig.skills?.install,
+				nodeManager
+			}
+		}
+	};
+}
+//#endregion
+//#region src/commands/onboard-non-interactive/local/workspace.ts
+function resolveNonInteractiveWorkspaceDir(params) {
+	return resolveUserPath((params.opts.workspace ?? params.baseConfig.agents?.defaults?.workspace ?? params.defaultWorkspaceDir).trim());
+}
+//#endregion
+//#region src/commands/onboard-non-interactive/local.ts
+const INSTALL_DAEMON_HEALTH_DEADLINE_MS = 45e3;
+const ATTACH_EXISTING_GATEWAY_HEALTH_DEADLINE_MS = 15e3;
+const INSTALL_DAEMON_HEALTH_PROBE_TIMEOUT_MS = 1e4;
+const WINDOWS_INSTALL_DAEMON_HEALTH_DEADLINE_MS = 9e4;
+const WINDOWS_INSTALL_DAEMON_HEALTH_PROBE_TIMEOUT_MS = 15e3;
+const INSTALL_DAEMON_HEALTH_COMMAND_TIMEOUT_MS = 1e4;
+const WINDOWS_INSTALL_DAEMON_HEALTH_COMMAND_TIMEOUT_MS = 9e4;
+function resolveInstallDaemonGatewayHealthTiming(platform = process.platform) {
+	if (platform === "win32") return {
+		deadlineMs: WINDOWS_INSTALL_DAEMON_HEALTH_DEADLINE_MS,
+		probeTimeoutMs: WINDOWS_INSTALL_DAEMON_HEALTH_PROBE_TIMEOUT_MS,
+		healthCommandTimeoutMs: WINDOWS_INSTALL_DAEMON_HEALTH_COMMAND_TIMEOUT_MS
+	};
+	return {
+		deadlineMs: INSTALL_DAEMON_HEALTH_DEADLINE_MS,
+		probeTimeoutMs: INSTALL_DAEMON_HEALTH_PROBE_TIMEOUT_MS,
+		healthCommandTimeoutMs: INSTALL_DAEMON_HEALTH_COMMAND_TIMEOUT_MS
+	};
+}
+async function collectGatewayHealthFailureDiagnostics() {
+	const diagnostics = {};
+	try {
+		const { resolveGatewayService } = await import("./service-SxXpolg3.js");
+		const service = resolveGatewayService();
+		const env = process.env;
+		const [loaded, runtime] = await Promise.all([service.isLoaded({ env }).catch(() => false), service.readRuntime(env).catch(() => void 0)]);
+		diagnostics.service = {
+			label: service.label,
+			loaded,
+			loadedText: service.loadedText,
+			runtimeStatus: runtime?.status,
+			state: runtime?.state,
+			pid: runtime?.pid,
+			lastExitStatus: runtime?.lastExitStatus,
+			lastExitReason: runtime?.lastExitReason
+		};
+	} catch (err) {
+		diagnostics.inspectError = `service diagnostics failed: ${String(err)}`;
+	}
+	try {
+		const { readLastGatewayErrorLine } = await import("./diagnostics-CToDFzIg.js");
+		diagnostics.lastGatewayError = await readLastGatewayErrorLine(process.env) ?? void 0;
+	} catch (err) {
+		diagnostics.inspectError = diagnostics.inspectError ? `${diagnostics.inspectError}; log diagnostics failed: ${String(err)}` : `log diagnostics failed: ${String(err)}`;
+	}
+	return diagnostics.service || diagnostics.lastGatewayError || diagnostics.inspectError ? diagnostics : void 0;
+}
+async function resolveGatewayHealthProbeToken(nextConfig) {
+	const resolved = await resolveGatewayAuthToken({
+		cfg: nextConfig,
+		env: process.env,
+		envFallback: "no-secret-ref",
+		unresolvedReasonStyle: "detailed"
+	});
+	const probeAuth = {};
+	if (resolved.token) probeAuth.token = resolved.token;
+	if (resolved.unresolvedRefReason) probeAuth.unresolvedRefReason = resolved.unresolvedRefReason;
+	return probeAuth;
+}
+function formatGatewayHealthFailureDetail(params) {
+	return [params.probeDetail, params.unresolvedRefReason].filter(Boolean).join("\n") || void 0;
+}
+async function runNonInteractiveLocalSetup(params) {
+	const { opts, runtime, baseConfig, baseHash } = params;
+	const mode = "local";
+	const workspaceDir = resolveNonInteractiveWorkspaceDir({
+		opts,
+		baseConfig,
+		defaultWorkspaceDir: DEFAULT_WORKSPACE
+	});
+	let nextConfig = applyLocalSetupWorkspaceConfig(baseConfig, workspaceDir);
+	if (opts.skipBootstrap) nextConfig = applySkipBootstrapConfig(nextConfig);
+	const inferredAuthChoice = opts.authChoice ? void 0 : (await import("./auth-choice-inference-DJXevk5K.js")).inferAuthChoiceFromFlags(opts, {
+		config: nextConfig,
+		workspaceDir,
+		env: process.env
+	});
+	if (!opts.authChoice && inferredAuthChoice && inferredAuthChoice.matches.length > 1) {
+		runtime.error([
+			"Multiple API key flags were provided for non-interactive setup.",
+			"Use a single provider flag or pass --auth-choice explicitly.",
+			`Flags: ${inferredAuthChoice.matches.map((match) => match.label).join(", ")}`
+		].join("\n"));
+		runtime.exit(1);
+		return;
+	}
+	const authChoice = opts.authChoice ?? inferredAuthChoice?.choice ?? "skip";
+	if (authChoice !== "skip") {
+		const { applyNonInteractiveAuthChoice } = await import("./auth-choice-BY7D52tq.js");
+		const nextConfigAfterAuth = await applyNonInteractiveAuthChoice({
+			nextConfig,
+			authChoice,
+			opts,
+			runtime,
+			baseConfig
+		});
+		if (!nextConfigAfterAuth) return;
+		nextConfig = nextConfigAfterAuth;
+	}
+	const gatewayBasePort = resolveGatewayPort(baseConfig);
+	const gatewayResult = applyNonInteractiveGatewayConfig({
+		nextConfig,
+		opts,
+		runtime,
+		defaultPort: gatewayBasePort
+	});
+	if (!gatewayResult) return;
+	nextConfig = gatewayResult.nextConfig;
+	nextConfig = applyNonInteractiveSkillsConfig({
+		nextConfig,
+		opts,
+		runtime
+	});
+	nextConfig = applyWizardMetadata(nextConfig, {
+		command: "onboard",
+		mode
+	});
+	await replaceConfigFile({
+		nextConfig,
+		...baseHash !== void 0 ? { baseHash } : {}
+	});
+	logConfigUpdated(runtime);
+	await ensureWorkspaceAndSessions(workspaceDir, runtime, { skipBootstrap: Boolean(nextConfig.agents?.defaults?.skipBootstrap) });
+	const daemonRuntimeRaw = opts.daemonRuntime ?? "node";
+	let daemonInstallStatus;
+	if (opts.installDaemon) {
+		const { installGatewayDaemonNonInteractive } = await import("./daemon-install-CfhUN6Cy.js");
+		const daemonInstall = await installGatewayDaemonNonInteractive({
+			nextConfig,
+			opts,
+			runtime,
+			port: gatewayResult.port
+		});
+		daemonInstallStatus = daemonInstall.installed ? {
+			requested: true,
+			installed: true
+		} : {
+			requested: true,
+			installed: false,
+			skippedReason: daemonInstall.skippedReason
+		};
+		if (!daemonInstall.installed && !opts.skipHealth) {
+			logNonInteractiveOnboardingFailure({
+				opts,
+				runtime,
+				mode,
+				phase: "daemon-install",
+				message: daemonInstall.skippedReason === "systemd-user-unavailable" ? "Gateway service install is unavailable because systemd user services are not reachable in this Linux session." : "Gateway service install did not complete successfully.",
+				installDaemon: true,
+				daemonInstall: {
+					requested: true,
+					installed: false,
+					skippedReason: daemonInstall.skippedReason
+				},
+				daemonRuntime: daemonRuntimeRaw,
+				hints: daemonInstall.skippedReason === "systemd-user-unavailable" ? ["Fix: rerun without `--install-daemon` for one-shot setup, or enable a working user-systemd session and retry.", "If your auth profile uses env-backed refs, keep those env vars set in the shell that runs `genesis gateway run` or `genesis agent --local`."] : [`Run \`${formatCliCommand("genesis gateway status --deep")}\` for more detail.`]
+			});
+			runtime.exit(1);
+			return;
+		}
+	}
+	if (!opts.skipHealth) {
+		const { healthCommand } = await import("./health-B2JkLr-g.js");
+		const links = resolveControlUiLinks({
+			bind: gatewayResult.bind,
+			port: gatewayResult.port,
+			customBindHost: nextConfig.gateway?.customBindHost,
+			basePath: void 0
+		});
+		const installDaemonGatewayHealthTiming = resolveInstallDaemonGatewayHealthTiming();
+		const probeAuth = await resolveGatewayHealthProbeToken(nextConfig);
+		const probe = await waitForGatewayReachable({
+			url: links.wsUrl,
+			token: probeAuth.token,
+			deadlineMs: opts.installDaemon ? installDaemonGatewayHealthTiming.deadlineMs : ATTACH_EXISTING_GATEWAY_HEALTH_DEADLINE_MS,
+			probeTimeoutMs: opts.installDaemon ? installDaemonGatewayHealthTiming.probeTimeoutMs : void 0
+		});
+		if (!probe.ok) {
+			const detail = formatGatewayHealthFailureDetail({
+				probeDetail: probe.detail,
+				unresolvedRefReason: probeAuth.unresolvedRefReason
+			});
+			const diagnostics = opts.installDaemon ? await collectGatewayHealthFailureDiagnostics() : void 0;
+			logNonInteractiveOnboardingFailure({
+				opts,
+				runtime,
+				mode,
+				phase: "gateway-health",
+				message: `Gateway did not become reachable at ${links.wsUrl}.`,
+				detail,
+				gateway: {
+					wsUrl: links.wsUrl,
+					httpUrl: links.httpUrl
+				},
+				installDaemon: Boolean(opts.installDaemon),
+				daemonInstall: daemonInstallStatus,
+				daemonRuntime: opts.installDaemon ? daemonRuntimeRaw : void 0,
+				diagnostics,
+				hints: !opts.installDaemon ? [
+					"Non-interactive local setup only waits for an already-running gateway unless you pass --install-daemon.",
+					`Fix: start \`${formatCliCommand("genesis gateway run")}\`, re-run with \`--install-daemon\`, or use \`--skip-health\`.`,
+					process.platform === "win32" ? "Native Windows managed gateway install tries Scheduled Tasks first and falls back to a per-user Startup-folder login item when task creation is denied." : void 0
+				].filter((value) => Boolean(value)) : [`Run \`${formatCliCommand("genesis gateway status --deep")}\` for more detail.`]
+			});
+			runtime.exit(1);
+			return;
+		}
+		await healthCommand({
+			json: false,
+			timeoutMs: opts.installDaemon ? installDaemonGatewayHealthTiming.healthCommandTimeoutMs : 1e4
+		}, runtime);
+	}
+	logNonInteractiveOnboardingJson({
+		opts,
+		runtime,
+		mode,
+		workspaceDir,
+		authChoice,
+		gateway: {
+			port: gatewayResult.port,
+			bind: gatewayResult.bind,
+			authMode: gatewayResult.authMode,
+			tailscaleMode: gatewayResult.tailscaleMode
+		},
+		installDaemon: Boolean(opts.installDaemon),
+		daemonInstall: daemonInstallStatus,
+		daemonRuntime: opts.installDaemon ? daemonRuntimeRaw : void 0,
+		skipSkills: Boolean(opts.skipSkills),
+		skipHealth: Boolean(opts.skipHealth)
+	});
+	if (!opts.json) runtime.log(`Tip: run \`${formatCliCommand("genesis configure --section web")}\` to store your Brave API key for web_search. Docs: https://genesis.pixelzx.com/docs/tools/web`);
+}
+//#endregion
+//#region src/commands/onboard-non-interactive/node.ts
+async function runNonInteractiveNodeSetup(params) {
+	const { opts, runtime, baseConfig, baseHash } = params;
+	const mode = "node";
+	const remoteUrl = normalizeOptionalString(opts.remoteUrl);
+	if (!remoteUrl) {
+		runtime.error("Missing --remote-url for node mode.");
+		runtime.exit(1);
+		return;
+	}
+	let nextConfig = {
+		...baseConfig,
+		gateway: {
+			...baseConfig.gateway,
+			mode: "remote",
+			remote: {
+				url: remoteUrl,
+				token: normalizeOptionalString(opts.remoteToken)
+			}
+		}
+	};
+	if (opts.skipBootstrap) nextConfig = applySkipBootstrapConfig(nextConfig);
+	const url = new URL(remoteUrl);
+	const host = url.hostname;
+	const port = url.port ? Number.parseInt(url.port, 10) : 18789;
+	const tls = url.protocol === "wss:";
+	const existingNodeConfig = await loadNodeHostConfig();
+	await saveNodeHostConfig({
+		version: 1,
+		nodeId: existingNodeConfig?.nodeId ?? crypto.randomUUID(),
+		token: existingNodeConfig?.token,
+		displayName: existingNodeConfig?.displayName,
+		gateway: {
+			...existingNodeConfig?.gateway,
+			host,
+			port,
+			tls
+		}
+	});
+	nextConfig = applyWizardMetadata(nextConfig, {
+		command: "onboard",
+		mode
+	});
+	await replaceConfigFile({
+		nextConfig,
+		...baseHash !== void 0 ? { baseHash } : {}
+	});
+	logConfigUpdated(runtime);
+	if (opts.installDaemon) {
+		const { runNodeDaemonInstall } = await import("./daemon-DCKLVZts.js");
+		await runNodeDaemonInstall({
+			host,
+			port,
+			tls,
+			json: opts.json
+		});
+	}
+	const payload = {
+		mode,
+		remoteUrl,
+		auth: opts.remoteToken ? "token" : "none",
+		nodeHost: {
+			host,
+			port,
+			tls
+		}
+	};
+	if (opts.json) writeRuntimeJson(runtime, payload);
+	else {
+		runtime.log(`Node mode configured.`);
+		runtime.log(`Remote gateway: ${remoteUrl}`);
+		runtime.log(`Auth: ${payload.auth}`);
+		if (opts.installDaemon) runtime.log(`Node daemon install requested.`);
+		runtime.log(`Tip: run \`${formatCliCommand("genesis configure --section web")}\` to store your Brave API key for web_search. Docs: https://genesis.pixelzx.com/docs/tools/web`);
+	}
+}
+//#endregion
+//#region src/commands/onboard-non-interactive/remote.ts
+async function runNonInteractiveRemoteSetup(params) {
+	const { opts, runtime, baseConfig, baseHash } = params;
+	const mode = "remote";
+	const remoteUrl = normalizeOptionalString(opts.remoteUrl);
+	if (!remoteUrl) {
+		runtime.error("Missing --remote-url for remote mode.");
+		runtime.exit(1);
+		return;
+	}
+	let nextConfig = {
+		...baseConfig,
+		gateway: {
+			...baseConfig.gateway,
+			mode: "remote",
+			remote: {
+				url: remoteUrl,
+				token: normalizeOptionalString(opts.remoteToken)
+			}
+		}
+	};
+	if (opts.skipBootstrap) nextConfig = applySkipBootstrapConfig(nextConfig);
+	nextConfig = applyWizardMetadata(nextConfig, {
+		command: "onboard",
+		mode
+	});
+	await replaceConfigFile({
+		nextConfig,
+		...baseHash !== void 0 ? { baseHash } : {}
+	});
+	logConfigUpdated(runtime);
+	const payload = {
+		mode,
+		remoteUrl,
+		auth: opts.remoteToken ? "token" : "none"
+	};
+	if (opts.json) writeRuntimeJson(runtime, payload);
+	else {
+		runtime.log(`Remote gateway: ${remoteUrl}`);
+		runtime.log(`Auth: ${payload.auth}`);
+		runtime.log(`Tip: run \`${formatCliCommand("genesis configure --section web")}\` to store your Brave API key for web_search. Docs: https://genesis.pixelzx.com/docs/tools/web`);
+	}
+}
+//#endregion
+//#region src/commands/onboard-non-interactive.ts
+async function runNonInteractiveSetup(opts, runtime = defaultRuntime) {
+	const snapshot = await readConfigFileSnapshot();
+	if (snapshot.exists && !snapshot.valid) {
+		runtime.error(`Config invalid. Run \`${formatCliCommand("genesis doctor")}\` to repair it, then re-run setup.`);
+		runtime.exit(1);
+		return;
+	}
+	const baseConfig = snapshot.valid ? snapshot.exists ? snapshot.sourceConfig ?? snapshot.config : {} : {};
+	const mode = opts.mode ?? "local";
+	if (mode !== "local" && mode !== "remote" && mode !== "gateway" && mode !== "node") {
+		runtime.error(`Invalid --mode "${String(mode)}" (use local|remote|gateway|node).`);
+		runtime.exit(1);
+		return;
+	}
+	if (mode === "remote") {
+		await runNonInteractiveRemoteSetup({
+			opts,
+			runtime,
+			baseConfig,
+			baseHash: snapshot.hash
+		});
+		return;
+	}
+	if (mode === "node") {
+		await runNonInteractiveNodeSetup({
+			opts,
+			runtime,
+			baseConfig,
+			baseHash: snapshot.hash
+		});
+		return;
+	}
+	await runNonInteractiveLocalSetup({
+		opts,
+		runtime,
+		baseConfig,
+		baseHash: snapshot.hash
+	});
+}
+//#endregion
+export { runNonInteractiveSetup };