sweetlink 0.1.0

package/dist/src/runtime/session.js

@@ -0,0 +1,205 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { createSweetLinkCommandId } from '../../shared/src/index.js';
+import { fetchJson } from '../http.js';
+import { fetchCliToken } from '../token.js';
+const VALID_SELECTOR_HOOKS = new Set(['data-target', 'id', 'aria', 'role', 'structure', 'testid']);
+const SESSION_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const CODENAME_CACHE_PATH = path.join(os.homedir(), '.sweetlink', 'session-codenames.json');
+async function loadCodenameCache() {
+    try {
+        const raw = await readFile(CODENAME_CACHE_PATH, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object') {
+            return parsed;
+        }
+    }
+    catch {
+        /* ignore cache read issues */
+    }
+    return {};
+}
+async function saveCodenameCache(cache) {
+    try {
+        const directory = path.dirname(CODENAME_CACHE_PATH);
+        await mkdir(directory, { recursive: true });
+        await writeFile(CODENAME_CACHE_PATH, JSON.stringify(cache, null, 2), 'utf8');
+    }
+    catch {
+        /* ignore cache write issues */
+    }
+}
+async function stabilizeSessionCodenames(sessions) {
+    if (sessions.length === 0) {
+        return sessions;
+    }
+    const cache = await loadCodenameCache();
+    let cacheMutations = 0;
+    const stabilized = [];
+    for (const session of sessions) {
+        const cachedCodename = cache[session.sessionId];
+        if (cachedCodename) {
+            if (session.codename === cachedCodename) {
+                stabilized.push(session);
+            }
+            else {
+                cacheMutations += 1;
+                stabilized.push({ ...session, codename: cachedCodename });
+            }
+            continue;
+        }
+        if (session.codename && session.codename.trim().length > 0) {
+            cache[session.sessionId] = session.codename;
+            cacheMutations += 1;
+        }
+        stabilized.push(session);
+    }
+    if (cacheMutations > 0) {
+        await saveCodenameCache(cache);
+    }
+    return stabilized;
+}
+export async function fetchSessionSummaries(config, existingToken) {
+    const token = existingToken ?? (await fetchCliToken(config));
+    const response = await fetchJson(`${config.daemonBaseUrl}/sessions`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    return await stabilizeSessionCodenames(response.sessions);
+}
+/** Formats a session id + codename pair for CLI display. */
+export function formatSessionHeadline(session) {
+    return session.codename ? `${session.codename} (${session.sessionId})` : session.sessionId;
+}
+/** Resolves a human codename or short id to an active SweetLink session. */
+export async function resolveSessionIdFromHint(sessionHint, config) {
+    const input = sessionHint.trim();
+    if (input.length === 0) {
+        throw new Error('A SweetLink session identifier is required.');
+    }
+    if (SESSION_ID_PATTERN.test(input)) {
+        return input;
+    }
+    const sessions = await fetchSessionSummaries(config);
+    const normalized = input.toLowerCase();
+    const matches = sessions.filter((session) => {
+        if (session.sessionId === input || session.sessionId.toLowerCase() === normalized) {
+            return true;
+        }
+        if (session.codename && session.codename.toLowerCase() === normalized) {
+            return true;
+        }
+        return false;
+    });
+    if (matches.length === 0) {
+        throw new Error(`No active SweetLink session matches "${sessionHint}". Run \`pnpm sweetlink sessions\` to list active sessions.`);
+    }
+    if (matches.length > 1) {
+        const headlines = matches.map((session) => formatSessionHeadline(session)).join(', ');
+        throw new Error(`Multiple SweetLink sessions match "${sessionHint}". Refine using one of: ${headlines}.`);
+    }
+    const match = matches[0];
+    if (!match) {
+        throw new Error('Unexpected missing SweetLink session match.');
+    }
+    return match.sessionId;
+}
+/** Sends a SweetLink runScript command and returns the raw command result. */
+export async function executeRunScriptCommand(config, options) {
+    const token = await fetchCliToken(config);
+    const payload = {
+        type: 'runScript',
+        id: createSweetLinkCommandId(),
+        code: options.code,
+        timeoutMs: options.timeoutMs,
+        captureConsole: Boolean(options.captureConsole),
+    };
+    const result = await fetchJson(`${config.daemonBaseUrl}/sessions/${encodeURIComponent(options.sessionId)}/command`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(payload),
+    });
+    return result.result;
+}
+/** Returns recent console events captured for a SweetLink session. */
+export async function fetchConsoleEvents(config, sessionId) {
+    const token = await fetchCliToken(config);
+    const response = await fetchJson(`${config.daemonBaseUrl}/sessions/${encodeURIComponent(sessionId)}/console`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    return Array.isArray(response.events) ? response.events : [];
+}
+export async function getSessionSummaryById(config, token, sessionId) {
+    const sessions = await fetchSessionSummaries(config, token);
+    return sessions.find((session) => session.sessionId === sessionId);
+}
+/** Returns the resolved prompt string for CLI commands. */
+export function resolvePromptOption(options) {
+    const trimmedPrompt = options.prompt?.trim();
+    if (trimmedPrompt) {
+        return trimmedPrompt;
+    }
+    const trimmedQuestion = options.question?.trim();
+    if (trimmedQuestion) {
+        return trimmedQuestion;
+    }
+    return;
+}
+/** Builds a DOM click script scoped to the provided selector. */
+export function buildClickScript({ selector, scrollIntoView, bubbles }) {
+    const safeSelector = JSON.stringify(selector);
+    const notFoundMessage = `SweetLink click: selector ${selector} not found`;
+    const lines = [
+        '(() => {',
+        `  const target = document.querySelector(${safeSelector});`,
+        '  if (!target) {',
+        `    throw new Error(${JSON.stringify(notFoundMessage)});`,
+        '  }',
+    ];
+    if (scrollIntoView) {
+        lines.push('  if (typeof target.scrollIntoView === "function") {', '    try {', '      target.scrollIntoView({ block: "center", inline: "center", behavior: "smooth" });', '    } catch {', '      target.scrollIntoView();', '    }', '  }');
+    }
+    lines.push('  const event = new MouseEvent("click", {', '    view: window,', `    bubbles: ${bubbles},`, '    cancelable: true,', '    composed: true', '  });', '  target.dispatchEvent(event);', '  if (typeof target.click === "function") {', '    target.click();', '  }', '  return "clicked";', '})()');
+    return lines.join('\n');
+}
+/** Shared guard ensuring candidates from selector discovery are valid. */
+export const isSweetLinkSelectorCandidate = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    if (typeof candidate.selector !== 'string' ||
+        typeof candidate.tagName !== 'string' ||
+        typeof candidate.hook !== 'string' ||
+        !VALID_SELECTOR_HOOKS.has(candidate.hook) ||
+        typeof candidate.textSnippet !== 'string' ||
+        typeof candidate.score !== 'number' ||
+        typeof candidate.visible !== 'boolean' ||
+        typeof candidate.path !== 'string') {
+        return false;
+    }
+    const size = candidate.size;
+    const position = candidate.position;
+    if (!size || typeof size.width !== 'number' || typeof size.height !== 'number') {
+        return false;
+    }
+    if (!position || typeof position.top !== 'number' || typeof position.left !== 'number') {
+        return false;
+    }
+    return true;
+};
+/** Wrapper guards selector discovery responses. */
+export const isSweetLinkSelectorDiscoveryResult = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const record = value;
+    if (!Array.isArray(record.candidates)) {
+        return false;
+    }
+    return record.candidates.every((candidate) => isSweetLinkSelectorCandidate(candidate));
+};
+//# sourceMappingURL=session.js.map

package/dist/src/runtime/session.js.map

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

package/dist/src/runtime/smoke.d.ts

@@ -0,0 +1,36 @@
+import type { CliConfig } from '../types.js';
+import { type SweetLinkBootstrapDiagnostics } from './devtools.js';
+import type { SweetLinkConsoleDump } from './session.js';
+export declare const SMOKE_ROUTE_PRESETS: Record<string, string[]>;
+export declare const DEFAULT_SMOKE_ROUTES: string[];
+export declare const deriveSmokeRoutes: (raw: string | undefined, defaults: readonly string[]) => string[];
+export declare const buildSmokeRouteUrl: (base: URL, route: string) => URL;
+export declare const navigateSweetLinkSession: (params: {
+    sessionId: string;
+    targetUrl: URL;
+    config: CliConfig;
+}) => Promise<void>;
+export declare const triggerSweetLinkCliAuto: (devtoolsUrl: string, candidateUrl: string) => Promise<void>;
+export declare const ensureSweetLinkSessionConnected: (params: {
+    config: CliConfig;
+    token: string;
+    sessionId: string;
+    devtoolsUrl: string;
+    currentUrl: string;
+    timeoutMs?: number;
+    onSessionIdChanged?: (nextSessionId: string) => void;
+    candidateUrls?: string[];
+}) => Promise<boolean>;
+export declare const waitForSmokeRouteReady: (params: {
+    devtoolsUrl: string;
+    targetUrl: URL;
+    timeoutMs: number;
+}) => Promise<SweetLinkBootstrapDiagnostics | null>;
+export declare function computeSmokeRouteSignature(routes: readonly string[]): string;
+export declare function loadSmokeProgressIndex(baseOrigin: string, routes: readonly string[]): Promise<number | null>;
+export declare function saveSmokeProgressIndex(baseOrigin: string, routes: readonly string[], nextIndex: number): Promise<void>;
+export declare function clearSmokeProgress(baseOrigin: string, routes: readonly string[]): Promise<void>;
+export declare const consoleEventIndicatesAuthIssue: (event: SweetLinkConsoleDump) => boolean;
+export declare const consoleEventIndicatesRuntimeError: (event: SweetLinkConsoleDump) => boolean;
+export declare const formatConsoleEventSummary: (event: SweetLinkConsoleDump) => string;
+//# sourceMappingURL=smoke.d.ts.map

package/dist/src/runtime/smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.d.ts","sourceRoot":"","sources":["../../../src/runtime/smoke.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAIL,KAAK,6BAA6B,EACnC,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AA0EzD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAGxD,CAAC;AAoBF,eAAO,MAAM,oBAAoB,UAAwE,CAAC;AAE1G,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,GAAG,SAAS,EAAE,UAAU,SAAS,MAAM,EAAE,KAAG,MAAM,EAc9F,CAAC;AAuBF,eAAO,MAAM,kBAAkB,GAAI,MAAM,GAAG,EAAE,OAAO,MAAM,KAAG,GAsB7D,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAU,QAAQ;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,GAAG,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;CACnB,KAAG,OAAO,CAAC,IAAI,CAuBf,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,aAAa,MAAM,EAAE,cAAc,MAAM,KAAG,OAAO,CAAC,IAAI,CAiCrG,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAU,QAAQ;IAC5D,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,KAAG,OAAO,CAAC,OAAO,CA4ClB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAU,QAAQ;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,KAAG,OAAO,CAAC,6BAA6B,GAAG,IAAI,CAgC/C,CAAC;AAqCF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE5E;AAED,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQlH;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUrG;AAED,eAAO,MAAM,8BAA8B,GAAI,OAAO,oBAAoB,KAAG,OAkB5E,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAAI,OAAO,oBAAoB,KAAG,OAuD/E,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,OAAO,oBAAoB,KAAG,MAOvE,CAAC"}

package/dist/src/runtime/smoke.js

@@ -0,0 +1,417 @@
+import { regex } from 'arkregex';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { compact, uniq } from 'es-toolkit';
+import { loadSweetLinkFileConfig } from '../core/config-file.js';
+import { sweetLinkDebug } from '../env.js';
+import { describeUnknown, isErrnoException } from '../util/errors.js';
+import { delay } from '../util/time.js';
+import { collectBootstrapDiagnostics, diagnosticsContainBlockingIssues, evaluateInDevToolsTab, } from './devtools.js';
+import { executeRunScriptCommand, fetchSessionSummaries, getSessionSummaryById } from './session.js';
+import { buildWaitCandidateUrls, configurePathRedirects, urlsRoughlyMatch } from './url.js';
+const ABSOLUTE_URL_PATTERN = regex.as('^https?:', 'i');
+const normalizeRouteList = (input) => {
+    if (typeof input === 'string') {
+        const trimmed = input.trim();
+        return trimmed.length > 0 ? [trimmed] : [];
+    }
+    if (!Array.isArray(input)) {
+        return [];
+    }
+    return compact(input.map((route) => {
+        if (typeof route !== 'string') {
+            return null;
+        }
+        const trimmed = route.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }));
+};
+const normalizeSmokePresets = (presets) => {
+    if (!presets || typeof presets !== 'object') {
+        return {};
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(presets)) {
+        const routes = normalizeRouteList(value);
+        if (routes.length > 0) {
+            result[key] = routes;
+        }
+    }
+    return result;
+};
+const SMOKE_PROGRESS_PATH = path.join(os.homedir(), '.sweetlink', 'smoke-progress.json');
+const builtinSmokePresets = {
+    main: ['timeline/home', 'insights', 'search', 'pulse'],
+    settings: [
+        'settings/account',
+        'settings/activity',
+        'settings/billing',
+        'settings/notifications',
+        'settings/social',
+        'settings/sync',
+        'settings/import',
+        'settings/extension',
+        'settings/beta',
+    ],
+    'billing-only': ['settings/billing'],
+    'pulse-only': ['pulse'],
+};
+const { config: fileConfig } = loadSweetLinkFileConfig();
+configurePathRedirects(fileConfig.redirects);
+const configuredPresets = normalizeSmokePresets(fileConfig.smokeRoutes?.presets);
+export const SMOKE_ROUTE_PRESETS = {
+    ...builtinSmokePresets,
+    ...configuredPresets,
+};
+const getPresetRoutes = (name) => normalizeRouteList(SMOKE_ROUTE_PRESETS[name]);
+const configuredDefaults = normalizeRouteList(fileConfig.smokeRoutes?.defaults ?? []);
+const mainPresetRoutes = getPresetRoutes('main');
+const settingsPresetRoutes = getPresetRoutes('settings');
+const fallbackDefaults = [];
+if (mainPresetRoutes.length > 0) {
+    fallbackDefaults.push(...mainPresetRoutes);
+}
+else {
+    fallbackDefaults.push(...builtinSmokePresets.main);
+}
+if (settingsPresetRoutes.length > 0) {
+    fallbackDefaults.push(...settingsPresetRoutes);
+}
+else {
+    fallbackDefaults.push(...builtinSmokePresets.settings);
+}
+export const DEFAULT_SMOKE_ROUTES = configuredDefaults.length > 0 ? configuredDefaults : fallbackDefaults;
+export const deriveSmokeRoutes = (raw, defaults) => {
+    if (!raw || raw.trim().length === 0) {
+        return [...defaults];
+    }
+    const segments = compact(raw.split(',').map((segment) => segment.trim()));
+    if (segments.length === 0) {
+        return [...defaults];
+    }
+    const expanded = segments.flatMap((segment) => {
+        const candidatePreset = SMOKE_ROUTE_PRESETS[segment.toLowerCase()];
+        return Array.isArray(candidatePreset) ? candidatePreset : [segment];
+    });
+    const uniqueRoutes = uniq(expanded);
+    return uniqueRoutes.length > 0 ? uniqueRoutes : [...defaults];
+};
+const normalizeRoutePath = (route) => {
+    const routeValue = typeof route === 'string' ? route : String(route ?? '');
+    if (!routeValue) {
+        return '/';
+    }
+    if (ABSOLUTE_URL_PATTERN.test(routeValue)) {
+        try {
+            const parsed = new URL(routeValue);
+            return parsed.pathname || '/';
+        }
+        catch {
+            return '/';
+        }
+    }
+    const trimmed = String.prototype.trim.call(routeValue);
+    if (!trimmed) {
+        return '/';
+    }
+    const withSlash = String.prototype.startsWith.call(trimmed, '/') ? trimmed : `/${trimmed}`;
+    return withSlash.replaceAll(/\/{2,}/g, '/');
+};
+export const buildSmokeRouteUrl = (base, route) => {
+    if (ABSOLUTE_URL_PATTERN.test(route)) {
+        try {
+            const parsed = new URL(route);
+            parsed.searchParams.set('sweetlink', 'auto');
+            return parsed;
+        }
+        catch {
+            // Fall back to treating as relative path.
+        }
+    }
+    const [pathPart, searchPart] = route.split('?', 2);
+    const next = new URL(base.toString());
+    next.search = '';
+    next.pathname = normalizeRoutePath(pathPart ?? '/');
+    if (searchPart) {
+        const extra = new URLSearchParams(searchPart);
+        for (const [key, value] of extra.entries()) {
+            next.searchParams.set(key, value);
+        }
+    }
+    next.searchParams.set('sweetlink', 'auto');
+    return next;
+};
+export const navigateSweetLinkSession = async (params) => {
+    const script = `(() => {
+    try {
+      const target = new URL(${JSON.stringify(params.targetUrl.toString())}, window.location.origin);
+      if (target.searchParams.get('sweetlink') !== 'auto') {
+        target.searchParams.set('sweetlink', 'auto');
+      }
+      if (window.location.href === target.toString()) {
+        return target.toString();
+      }
+      window.location.assign(target.toString());
+      return target.toString();
+    } catch (error) {
+      throw new Error(String(error ?? 'navigation failed'));
+    }
+  })()`;
+    await executeRunScriptCommand(params.config, {
+        sessionId: params.sessionId,
+        code: script,
+        timeoutMs: 15_000,
+        captureConsole: false,
+    });
+};
+export const triggerSweetLinkCliAuto = async (devtoolsUrl, candidateUrl) => {
+    const candidates = buildWaitCandidateUrls(candidateUrl);
+    const expression = `(() => {
+    try {
+      if (typeof console?.log === 'function') {
+        console.log('[SweetLink CLI] dispatching sweetlink:cli-auto event');
+      }
+      const event = new CustomEvent('sweetlink:cli-auto');
+      window.dispatchEvent(event);
+      try {
+        window.sessionStorage?.setItem('sweetlink:auto', 'pending');
+        window.sessionStorage?.removeItem('sweetlink:last-session');
+      } catch {}
+      try {
+        window.localStorage?.removeItem('sweetlink:last-session');
+      } catch {}
+      return { dispatched: true };
+    } catch (error) {
+      return { dispatched: false, error: String(error ?? 'failed') };
+    }
+  })()`;
+    for (const candidate of candidates) {
+        try {
+            // biome-ignore lint/performance/noAwaitInLoops: evaluate each candidate sequentially until one succeeds.
+            await evaluateInDevToolsTab(devtoolsUrl, candidate, expression);
+            break;
+        }
+        catch (error) {
+            if (sweetLinkDebug) {
+                console.warn('Failed to trigger SweetLink CLI auto bootstrap:', error);
+            }
+        }
+    }
+};
+export const ensureSweetLinkSessionConnected = async (params) => {
+    const timeoutMs = params.timeoutMs ?? 15_000;
+    const deadline = Date.now() + timeoutMs;
+    let lastTriggerAt = 0;
+    let activeSessionId = params.sessionId;
+    const candidateSources = [params.currentUrl, ...(params.candidateUrls ?? [])];
+    const candidateUrls = candidateSources.flatMap((source) => buildWaitCandidateUrls(source));
+    while (Date.now() < deadline) {
+        try {
+            // biome-ignore lint/performance/noAwaitInLoops: polling for a session must remain sequential.
+            const summary = await getSessionSummaryById(params.config, params.token, activeSessionId);
+            if (summary && summary.socketState === 'open') {
+                return true;
+            }
+            if (!summary) {
+                const sessions = await fetchSessionSummaries(params.config, params.token);
+                const replacement = sessions.find((candidate) => {
+                    if (!candidate?.url) {
+                        return false;
+                    }
+                    return candidateUrls.some((candidateUrl) => urlsRoughlyMatch(candidate.url, candidateUrl));
+                });
+                if (replacement) {
+                    activeSessionId = replacement.sessionId;
+                    params.onSessionIdChanged?.(replacement.sessionId);
+                    if (replacement.socketState === 'open') {
+                        return true;
+                    }
+                }
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        if (Date.now() - lastTriggerAt > 750) {
+            await triggerSweetLinkCliAuto(params.devtoolsUrl, params.currentUrl);
+            lastTriggerAt = Date.now();
+        }
+        await delay(500);
+    }
+    return false;
+};
+export const waitForSmokeRouteReady = async (params) => {
+    const candidates = buildWaitCandidateUrls(params.targetUrl.toString());
+    const deadline = Date.now() + params.timeoutMs;
+    let lastDiagnostics = null;
+    while (Date.now() < deadline) {
+        try {
+            // biome-ignore lint/performance/noAwaitInLoops: retries rely on sequential collection attempts.
+            const diagnostics = await collectBootstrapDiagnostics(params.devtoolsUrl, candidates);
+            if (diagnostics) {
+                lastDiagnostics = diagnostics;
+                if (diagnosticsContainBlockingIssues(diagnostics)) {
+                    return diagnostics;
+                }
+                if (diagnostics.locationHref &&
+                    urlsRoughlyMatch(diagnostics.locationHref, params.targetUrl.toString()) &&
+                    diagnostics.readyState &&
+                    (diagnostics.readyState === 'complete' || diagnostics.readyState === 'interactive')) {
+                    return diagnostics;
+                }
+            }
+        }
+        catch (error) {
+            if (sweetLinkDebug) {
+                console.warn('Smoke wait diagnostics error:', error);
+            }
+        }
+        await delay(500);
+    }
+    return lastDiagnostics;
+};
+function routesSignatureKey(routes) {
+    return JSON.stringify(routes);
+}
+async function readSmokeProgressFile() {
+    try {
+        const raw = await readFile(SMOKE_PROGRESS_PATH, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed && Array.isArray(parsed.entries)) {
+            return {
+                entries: parsed.entries
+                    .map((entry) => ({
+                    baseOrigin: entry.baseOrigin,
+                    routesSignature: entry.routesSignature,
+                    nextIndex: entry.nextIndex ?? 0,
+                    updatedAt: entry.updatedAt ?? Date.now(),
+                }))
+                    .filter((entry) => typeof entry.baseOrigin === 'string' && typeof entry.routesSignature === 'string'),
+            };
+        }
+    }
+    catch (error) {
+        if (!isErrnoException(error) || error.code !== 'ENOENT') {
+            console.warn('Failed to read SweetLink smoke progress file:', error);
+        }
+    }
+    return { entries: [] };
+}
+async function writeSmokeProgressFile(file) {
+    const directory = path.dirname(SMOKE_PROGRESS_PATH);
+    await mkdir(directory, { recursive: true });
+    const payload = JSON.stringify({ entries: file.entries }, null, 2);
+    await writeFile(SMOKE_PROGRESS_PATH, payload, 'utf8');
+}
+export function computeSmokeRouteSignature(routes) {
+    return routesSignatureKey(routes);
+}
+export async function loadSmokeProgressIndex(baseOrigin, routes) {
+    const signature = routesSignatureKey(routes);
+    const file = await readSmokeProgressFile();
+    const match = file.entries.find((entry) => entry.baseOrigin === baseOrigin && entry.routesSignature === signature);
+    if (match && Number.isInteger(match.nextIndex) && match.nextIndex >= 0) {
+        return match.nextIndex;
+    }
+    return null;
+}
+export async function saveSmokeProgressIndex(baseOrigin, routes, nextIndex) {
+    const signature = routesSignatureKey(routes);
+    const file = await readSmokeProgressFile();
+    const now = Date.now();
+    const existingIndex = file.entries.findIndex((entry) => entry.baseOrigin === baseOrigin && entry.routesSignature === signature);
+    if (existingIndex === -1) {
+        file.entries.push({ baseOrigin, routesSignature: signature, nextIndex, updatedAt: now });
+    }
+    else {
+        file.entries[existingIndex] = {
+            baseOrigin,
+            routesSignature: signature,
+            nextIndex,
+            updatedAt: now,
+        };
+    }
+    await writeSmokeProgressFile(file);
+}
+export async function clearSmokeProgress(baseOrigin, routes) {
+    const signature = routesSignatureKey(routes);
+    const file = await readSmokeProgressFile();
+    const filtered = file.entries.filter((entry) => !(entry.baseOrigin === baseOrigin && entry.routesSignature === signature));
+    if (filtered.length === file.entries.length) {
+        return;
+    }
+    await writeSmokeProgressFile({ entries: filtered });
+}
+export const consoleEventIndicatesAuthIssue = (event) => {
+    const level = typeof event?.level === 'string' ? event.level.toLowerCase() : '';
+    if (level && level !== 'error' && level !== 'warn' && level !== 'assert') {
+        return false;
+    }
+    if (!(event && Array.isArray(event.args))) {
+        return false;
+    }
+    for (const value of event.args) {
+        const text = describeUnknown(value, '').toLowerCase();
+        if (!text) {
+            continue;
+        }
+        if (text.includes('authentication required') || text.includes('unauthorized') || text.includes('401')) {
+            return true;
+        }
+    }
+    return false;
+};
+export const consoleEventIndicatesRuntimeError = (event) => {
+    const level = typeof event?.level === 'string' ? event.level.toLowerCase() : '';
+    const isErrorLevel = level === 'error' || level === 'assert';
+    const args = Array.isArray(event?.args) ? event.args : [];
+    const renderedArgs = args
+        .map((value) => describeUnknown(value, ''))
+        .filter((value) => typeof value === 'string' && value.trim().length > 0);
+    if (renderedArgs.length === 0) {
+        return isErrorLevel;
+    }
+    const combined = renderedArgs.join(' ').toLowerCase();
+    if (combined.includes('[fast refresh]')) {
+        return false;
+    }
+    const isTrpcMetadataLog = combined.includes('[trpc]') && combined.includes('trpcclienterror');
+    if (isTrpcMetadataLog) {
+        return false;
+    }
+    if (isErrorLevel) {
+        return true;
+    }
+    if (level === 'warn') {
+        if (combined.includes('[trpc]')) {
+            return false;
+        }
+        return (combined.includes('uncaught') ||
+            combined.includes('unhandled') ||
+            combined.includes('sweetlink auto-activation failed') ||
+            (combined.includes('error:') && !combined.includes('trpcclienterror')));
+    }
+    if (!level || level === 'log' || level === 'info' || level === 'debug') {
+        if (combined.includes('sweetlink auto-activation failed')) {
+            return true;
+        }
+        if (combined.includes('uncaught') || combined.includes('unhandled')) {
+            return true;
+        }
+        if (combined.includes('error:') && !combined.includes('trpcclienterror') && !combined.includes('[trpc]')) {
+            return true;
+        }
+        return false;
+    }
+    return false;
+};
+export const formatConsoleEventSummary = (event) => {
+    const timestamp = Number.isFinite(event.timestamp) ? new Date(event.timestamp).toISOString() : 'unknown-time';
+    const message = event.args
+        .map((value) => describeUnknown(value, ''))
+        .join(' ')
+        .trim();
+    return `[${timestamp}] ${event.level ?? 'log'} ${message}`;
+};
+//# sourceMappingURL=smoke.js.map