export function normalizeErrorMessage(error: unknown): string { if (error instanceof Error) return error.message; if (typeof error === "string") return error; if (typeof error === "object" && error !== null) { const msg = (error as Record).message; if (typeof msg === "string") return msg; try { return JSON.stringify(error) ?? `{${Object.keys(error).join(", ")}}`; } catch { try { return `{${Object.keys(error as object).join(", ")}}`; } catch { /* truly opaque object */ } } } return String(error ?? "unknown error"); } const PROTOCOL_TIMEOUT_ADVICE = / Increase the 'protocolTimeout' setting in launch\/connect calls[^.]*\./; export async function atStep(step: string, run: () => Promise): Promise { try { return await run(); } catch (error) { if (error instanceof Error && !error.message.includes(` (while ${step})`)) { error.message = error.message.replace(PROTOCOL_TIMEOUT_ADVICE, "") + ` (while ${step})`; } throw error; } }