/** Shared helpers for onboarding, reset, gateway checks, and wizard output. */

import fs from "node:fs/promises";

import path from "node:path";

import { inspect } from "node:util";

export { detectBrowserOpenSupport, openUrl, resolveBrowserOpenCommand };

export { resolveControlUiLinks };

/** Handles Clack cancellation by exiting through the runtime. */

export function guardCancel<T>(value: T | symbol, runtime: RuntimeEnv): T {

if (isCancel(value)) {

cancel(stylePromptTitle("Setup cancelled.") ?? "Setup cancelled.");

return value;

}

/** Summarizes existing config values before onboarding overwrites or reuses them. */

export function summarizeExistingConfig(config: OpenClawConfig): string {

const rows: string[] = [];

const defaults = config.agents?.defaults;

}

}

/** Normalizes gateway token prompts while rejecting JS stringification sentinels. */

export function normalizeGatewayTokenInput(value: unknown): string {

if (typeof value !== "string") {

return "";

return trimmed;

}

/** Validates gateway password prompt input. */

export function validateGatewayPasswordInput(value: unknown): string | undefined {

if (typeof value !== "string") {

return "Required";

return undefined;

}

/** Prints the onboarding banner. */

export function printWizardHeader(runtime: RuntimeEnv) {

const bannerWidth = 54;

const icon = decorativeEmoji("🦞");

runtime.log(header);

}

/** Records wizard provenance metadata on config writes. */

export function applyWizardMetadata(

cfg: OpenClawConfig,

params: { command: string; mode: OnboardMode },

};

}

/** Formats the no-GUI SSH tunnel hint for opening the Control UI remotely. */

export function formatControlUiSshHint(params: {

port: number;

basePath?: string;

return `${user}@${host}`;

}

/** Ensures workspace bootstrap files and session transcript directories exist. */

export async function ensureWorkspaceAndSessions(

workspaceDir: string,

runtime: RuntimeEnv,

runtime.log(`Sessions OK: ${shortenHomePath(sessionsDir)}`);

}

/** Returns package manager choices offered by onboarding. */

export function resolveNodeManagerOptions(): Array<{

value: NodeManagerChoice;

label: string;

];

}

/** Moves a path to Trash when it exists, logging a manual-delete fallback on failure. */

export async function moveToTrash(pathname: string, runtime: RuntimeEnv): Promise<void> {

if (!pathname) {

return;

return uniqueStrings(allowedRoots);

}

/** Deletes onboarding-managed state according to the selected reset scope. */

export async function handleReset(scope: ResetScope, workspaceDir: string, runtime: RuntimeEnv) {

await moveToTrash(resolveConfigPath(), runtime);

if (scope === "config") {

}

}

/** Runs a single lightweight gateway probe for onboarding readiness checks. */

export async function probeGatewayReachable(params: {

url: string;

token?: string;

}

}

/** Polls gateway reachability until success or deadline. */

export async function waitForGatewayReachable(params: {

url: string;

token?: string;

return line.length > 120 ? `${line.slice(0, 119)}…` : line;

}

/** Default workspace path shown by onboarding prompts. */

export const DEFAULT_WORKSPACE = DEFAULT_AGENT_WORKSPACE_DIR;