@ytspar/sweetlink 1.19.0 → 1.21.0

package/dist/daemon/server.js

@@ -6,17 +6,17 @@
  * Manages idle timer for auto-shutdown.
  */
 import { createServer } from 'http';
-import { closeBrowser, getBrowserInstance, getPage, initBrowser, takeResponsiveScreenshots, takeScreenshot } from './browser.js';
-import { annotateScreenshot, diffSnapshots } from './diff.js';
+import { closeBrowser, getBrowserInstance, getPage, initBrowser, takeResponsiveScreenshots, takeScreenshot, } from './browser.js';
 import { takeDeviceScreenshots } from './devices.js';
-import { consoleBuffer, dialogBuffer, formatConsoleEntries, formatNetworkEntries, getErrorCount, getWarningCount, networkBuffer, } from './listeners.js';
-import { getRecordingPage, getRecordingStatus, isRecording, logAction, pauseRecording, resumeRecording, startRecording, stopRecording } from './recording.js';
+import { annotateScreenshot, diffSnapshots } from './diff.js';
 import { detectServerErrors } from './errorPatterns.js';
+import { consoleBuffer, dialogBuffer, formatConsoleEntries, formatNetworkEntries, getErrorCount, getWarningCount, networkBuffer, } from './listeners.js';
+import { getRecordingEventCursors, getRecordingPage, getRecordingStatus, isRecording, logAction, pauseRecording, resumeRecording, startRecording, stopRecording, } from './recording.js';
+import { buildRefMap, checkRefStale, formatRefMap, getBaseline, getCurrentRefMap, resolveRef, setBaseline, } from './refs.js';
 import { generateSummary } from './summary.js';
+import { DAEMON_IDLE_TIMEOUT_MS, DEFAULT_RESPONSIVE_VIEWPORTS } from './types.js';
 import { generateViewer } from './viewer.js';
 import { visualDiff } from './visualDiff.js';
-import { buildRefMap, checkRefStale, formatRefMap, getBaseline, getCurrentRefMap, resolveRef, setBaseline, } from './refs.js';
-import { DAEMON_IDLE_TIMEOUT_MS, DEFAULT_RESPONSIVE_VIEWPORTS } from './types.js';
 // ============================================================================
 // State
 // ============================================================================
@@ -197,7 +197,10 @@ async function captureFailure(page, reason) {
         const dir = '.sweetlink/failures';
         await fsp.mkdir(dir, { recursive: true });
         const stamp = new Date().toISOString().replace(/[:.]/g, '-');
-        const slug = reason.replace(/[^a-z0-9]/gi, '-').slice(0, 40).toLowerCase();
+        const slug = reason
+            .replace(/[^a-z0-9]/gi, '-')
+            .slice(0, 40)
+            .toLowerCase();
         const filePath = `${dir}/${stamp}-${slug}.png`;
         const buf = await page.screenshot({ fullPage: false });
         await fsp.writeFile(filePath, buf);
@@ -207,6 +210,314 @@ async function captureFailure(page, reason) {
         return undefined;
     }
 }
+function failureData(page, details, failureScreenshot) {
+    return {
+        currentUrl: page.url(),
+        ...details,
+        ...(failureScreenshot ? { failureScreenshot } : {}),
+    };
+}
+function slugifyArtifact(value) {
+    return (value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 72) || 'inspect');
+}
+function normalizeActionTranscript(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((entry) => {
+        if (!entry || typeof entry !== 'object')
+            return [];
+        const record = entry;
+        const action = typeof record.action === 'string' ? record.action : undefined;
+        if (!action)
+            return [];
+        return [
+            {
+                action,
+                target: typeof record.target === 'string' ? record.target : undefined,
+                result: typeof record.result === 'string' ? record.result : undefined,
+            },
+        ];
+    });
+}
+async function getPageInfo(page) {
+    return page.evaluate(() => {
+        const nav = performance.getEntriesByType('navigation')[0];
+        const fcp = performance.getEntriesByName('first-contentful-paint')[0];
+        return {
+            url: location.href,
+            title: document.title,
+            viewport: {
+                width: window.innerWidth,
+                height: window.innerHeight,
+                deviceScaleFactor: window.devicePixelRatio,
+            },
+            vitals: {
+                fcp: fcp ? Math.round(fcp.startTime) : null,
+                pageSize: nav ? nav.transferSize || nav.encodedBodySize || null : null,
+            },
+        };
+    });
+}
+async function getAxeSource() {
+    try {
+        const axeModule = await import('axe-core');
+        const candidate = axeModule;
+        return candidate.source ?? candidate.default?.source ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+async function runInspectA11y(page) {
+    const source = await getAxeSource();
+    if (!source) {
+        return {
+            ok: false,
+            error: 'axe-core is not available in this environment',
+        };
+    }
+    try {
+        await page.addScriptTag({ content: source });
+        return await page.evaluate(async () => {
+            const axe = window.axe;
+            if (!axe)
+                throw new Error('axe-core did not initialize on the page');
+            const compactIssue = (issue) => ({
+                id: issue.id,
+                impact: issue.impact ?? 'unknown',
+                help: issue.help ?? '',
+                description: issue.description ?? '',
+                helpUrl: issue.helpUrl ?? '',
+                nodes: (issue.nodes ?? []).slice(0, 3).map((node) => ({
+                    target: (node.target ?? []).join(' '),
+                    html: (node.html ?? '').slice(0, 180),
+                    summary: node.failureSummary ??
+                        node.any?.[0]?.message ??
+                        node.all?.[0]?.message ??
+                        node.none?.[0]?.message ??
+                        '',
+                })),
+            });
+            const result = await axe.run(document, {
+                runOnly: {
+                    type: 'tag',
+                    values: ['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa', 'best-practice'],
+                },
+                rules: {
+                    'color-contrast': { enabled: true },
+                },
+            });
+            const byImpact = {};
+            for (const violation of result.violations) {
+                const impact = violation.impact ?? 'unknown';
+                byImpact[impact] = (byImpact[impact] ?? 0) + 1;
+            }
+            return {
+                ok: true,
+                summary: {
+                    violations: result.violations.length,
+                    incomplete: result.incomplete.length,
+                    passes: result.passes.length,
+                    byImpact,
+                },
+                violations: result.violations.map(compactIssue),
+                incomplete: result.incomplete.map(compactIssue),
+            };
+        });
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function inspectNextActions(counts, artifacts) {
+    const actions = [
+        `Open ${artifacts.summaryMarkdown} and ${artifacts.screenshotPng} before making visual claims.`,
+    ];
+    if (counts.consoleErrors > 0) {
+        actions.push('Investigate console errors before changing UI behavior.');
+    }
+    else if (counts.consoleWarnings > 0) {
+        actions.push('Review console warnings for stale props, hydration, or deprecated API signals.');
+    }
+    if (counts.networkFailures > 0) {
+        actions.push('Inspect failed network entries before assuming the UI state is a component bug.');
+    }
+    if ((counts.a11yViolations ?? 0) > 0 || (counts.a11yIncomplete ?? 0) > 0) {
+        actions.push(`Use ${artifacts.a11yJson ?? 'the a11y artifact'} to prioritize accessibility fixes.`);
+    }
+    if (counts.refs > 0) {
+        actions.push('Use @e refs for click/fill/press actions, then rerun inspect after DOM changes.');
+    }
+    else {
+        actions.push('No interactive refs were found; inspect the DOM/outline before attempting actions.');
+    }
+    return actions;
+}
+function renderInspectSummary(data) {
+    const transcript = data.actionTranscript.length > 0
+        ? data.actionTranscript
+            .map((entry, index) => {
+            const target = entry.target ? ` target=${entry.target}` : '';
+            const result = entry.result ? ` result=${entry.result}` : '';
+            return `${index + 1}. ${entry.action}${target}${result}`;
+        })
+            .join('\n')
+        : '(none supplied)';
+    const refs = data.refs.length > 0
+        ? data.refs.map((ref) => `- ${ref.ref} [${ref.role}] "${ref.name}"`).join('\n')
+        : '(no interactive refs)';
+    const a11ySummary = data.a11y
+        ? JSON.stringify(data.a11y.summary ?? { ok: data.a11y.ok, error: data.a11y.error }, null, 2)
+        : '(skipped)';
+    return [
+        '# Sweetlink Inspect',
+        '',
+        `- URL: ${data.url}`,
+        `- Title: ${data.title || '(untitled)'}`,
+        `- Generated: ${data.generatedAt}`,
+        `- Viewport: ${data.viewport.width}x${data.viewport.height} @${data.viewport.deviceScaleFactor}x`,
+        `- FCP: ${data.vitals.fcp ?? 'n/a'}ms`,
+        `- Page size: ${data.vitals.pageSize ?? 'n/a'} bytes`,
+        '',
+        '## Expected Outcome',
+        '',
+        data.expectedOutcome ?? '(not supplied)',
+        '',
+        '## Action Transcript',
+        '',
+        transcript,
+        '',
+        '## Counts',
+        '',
+        `- Interactive refs: ${data.counts.refs}`,
+        `- Console: ${data.counts.consoleEntries} entries, ${data.counts.consoleErrors} errors, ${data.counts.consoleWarnings} warnings`,
+        `- Network: ${data.counts.networkEntries} entries, ${data.counts.networkFailures} failures`,
+        `- Accessibility: ${data.counts.a11yViolations ?? 'n/a'} violations, ${data.counts.a11yIncomplete ?? 'n/a'} incomplete`,
+        '',
+        '## Next Actions',
+        '',
+        data.nextActions.map((action) => `- ${action}`).join('\n'),
+        '',
+        '## Artifacts',
+        '',
+        ...Object.entries(data.artifacts).map(([key, value]) => `- ${key}: ${value ?? '(not generated)'}`),
+        '',
+        '## Interactive Refs',
+        '',
+        refs,
+        '',
+        '## Console',
+        '',
+        data.consoleText,
+        '',
+        '## Network',
+        '',
+        data.networkText,
+        '',
+        '## Accessibility',
+        '',
+        a11ySummary,
+        '',
+    ].join('\n');
+}
+async function handleInspect(params, url) {
+    await initBrowser(url);
+    const page = getRecordingPage() ?? getPage();
+    const pageInfo = await getPageInfo(page);
+    const generatedAt = new Date().toISOString();
+    const label = typeof params.label === 'string' ? params.label : 'inspect';
+    const stamp = generatedAt.replace(/[:.]/g, '-');
+    const { promises: fsp } = await import('fs');
+    const path = await import('path');
+    const dir = path.resolve(`.sweetlink/inspect/${stamp}-${slugifyArtifact(label)}`);
+    await fsp.mkdir(dir, { recursive: true });
+    const lastRaw = typeof params.last === 'number' ? params.last : Number(params.last);
+    const last = Number.isFinite(lastRaw) && lastRaw > 0 ? Math.min(Math.floor(lastRaw), 500) : 50;
+    const includeA11y = params.includeA11y !== false;
+    const expectedOutcome = typeof params.expectedOutcome === 'string' ? params.expectedOutcome : undefined;
+    const actionTranscript = normalizeActionTranscript(params.actionTranscript);
+    const refMap = await buildRefMap(page, { interactive: true });
+    const snapshotText = formatRefMap(refMap);
+    const screenshotBuffer = await page.screenshot({ fullPage: true });
+    const consoleEntries = consoleBuffer.toArray().slice(-last);
+    const networkEntries = networkBuffer.toArray().slice(-last);
+    const consoleText = formatConsoleEntries(consoleEntries);
+    const networkText = formatNetworkEntries(networkEntries);
+    const a11y = includeA11y ? await runInspectA11y(page) : undefined;
+    const artifacts = {
+        dir,
+        summaryMarkdown: path.join(dir, 'SUMMARY.md'),
+        contextJson: path.join(dir, 'context.json'),
+        screenshotPng: path.join(dir, 'screenshot.png'),
+        snapshotMarkdown: path.join(dir, 'snapshot.md'),
+        consoleText: path.join(dir, 'console.txt'),
+        networkText: path.join(dir, 'network.txt'),
+        a11yJson: includeA11y ? path.join(dir, 'a11y.json') : undefined,
+    };
+    const a11ySummary = a11y?.summary;
+    const counts = {
+        refs: refMap.entries.length,
+        consoleEntries: consoleEntries.length,
+        consoleErrors: consoleEntries.filter((entry) => entry.level === 'error').length,
+        consoleWarnings: consoleEntries.filter((entry) => entry.level === 'warning').length,
+        networkEntries: networkEntries.length,
+        networkFailures: networkEntries.filter((entry) => entry.status >= 400 || entry.status === 0)
+            .length,
+        a11yViolations: a11ySummary?.violations,
+        a11yIncomplete: a11ySummary?.incomplete,
+    };
+    const nextActions = inspectNextActions(counts, artifacts);
+    const context = {
+        url: pageInfo.url,
+        title: pageInfo.title,
+        generatedAt,
+        viewport: pageInfo.viewport,
+        vitals: pageInfo.vitals,
+        artifacts,
+        counts,
+        refs: refMap.entries,
+        console: { entries: consoleEntries, formatted: consoleText },
+        network: { entries: networkEntries, formatted: networkText },
+        a11y,
+        expectedOutcome,
+        actionTranscript,
+        failureArtifacts: [],
+        nextActions,
+    };
+    await fsp.writeFile(artifacts.screenshotPng, screenshotBuffer);
+    await fsp.writeFile(artifacts.snapshotMarkdown, snapshotText, 'utf-8');
+    await fsp.writeFile(artifacts.consoleText, consoleText, 'utf-8');
+    await fsp.writeFile(artifacts.networkText, networkText, 'utf-8');
+    if (artifacts.a11yJson) {
+        await fsp.writeFile(artifacts.a11yJson, JSON.stringify(a11y ?? null, null, 2), 'utf-8');
+    }
+    const summary = renderInspectSummary({
+        url: context.url,
+        title: context.title,
+        generatedAt: context.generatedAt,
+        viewport: context.viewport,
+        vitals: context.vitals,
+        artifacts: context.artifacts,
+        counts: context.counts,
+        refs: context.refs,
+        consoleText,
+        networkText,
+        a11y,
+        expectedOutcome,
+        actionTranscript,
+        nextActions,
+    });
+    await fsp.writeFile(artifacts.summaryMarkdown, summary, 'utf-8');
+    await fsp.writeFile(artifacts.contextJson, JSON.stringify(context, null, 2), 'utf-8');
+    return { ok: true, data: context };
+}
 async function handleClickRef(params, url) {
     await initBrowser(url);
     // Use recording page if recording, otherwise main page
@@ -221,7 +532,12 @@ async function handleClickRef(params, url) {
         return {
             ok: false,
             error: `Ref ${ref} is stale — element no longer exists. Run \`snapshot\` to get fresh refs.`,
-            data: failureScreenshot ? { failureScreenshot } : undefined,
+            data: failureData(page, {
+                action: 'click-ref',
+                ref,
+                staleRef: true,
+                remediation: 'Run `sweetlink snapshot -i` or `sweetlink inspect` to refresh refs before retrying.',
+            }, failureScreenshot),
         };
     }
     const locator = resolveRef(page, ref);
@@ -233,12 +549,31 @@ async function handleClickRef(params, url) {
         return {
             ok: false,
             error: `Ref ${ref} is disabled — cannot click.`,
-            data: failureScreenshot ? { failureScreenshot } : undefined,
+            data: failureData(page, {
+                action: 'click-ref',
+                ref,
+                disabled: true,
+                remediation: 'Wait for the control to become enabled or choose a different interactive ref.',
+            }, failureScreenshot),
         };
     }
     const box = await locator.boundingBox();
     const t0 = Date.now();
-    await locator.click();
+    try {
+        await locator.click();
+    }
+    catch (error) {
+        const failureScreenshot = await captureFailure(page, `click-failed-${ref}`);
+        return {
+            ok: false,
+            error: `Click failed for ${ref}: ${error instanceof Error ? error.message : String(error)}`,
+            data: failureData(page, {
+                action: 'click-ref',
+                ref,
+                remediation: 'Inspect the failure screenshot and rerun `sweetlink snapshot -i` if the layout changed.',
+            }, failureScreenshot),
+        };
+    }
     const durationMs = Date.now() - t0;
     // Log action if recording
     if (isRecording()) {
@@ -258,9 +593,16 @@ async function handleFillRef(params, url) {
         return { ok: false, error: 'Missing value parameter' };
     const stale = await checkRefStale(page, ref);
     if (stale) {
+        const failureScreenshot = await captureFailure(page, `stale-fill-ref-${ref}`);
         return {
             ok: false,
             error: `Ref ${ref} is stale — element no longer exists. Run \`snapshot\` to get fresh refs.`,
+            data: failureData(page, {
+                action: 'fill-ref',
+                ref,
+                staleRef: true,
+                remediation: 'Run `sweetlink snapshot -i` or `sweetlink inspect` to refresh refs before retrying.',
+            }, failureScreenshot),
         };
     }
     const locator = resolveRef(page, ref);
@@ -272,12 +614,31 @@ async function handleFillRef(params, url) {
         return {
             ok: false,
             error: `Ref ${ref} is not editable (use click-ref/press-key for non-text inputs).`,
-            data: failureScreenshot ? { failureScreenshot } : undefined,
+            data: failureData(page, {
+                action: 'fill-ref',
+                ref,
+                nonEditable: true,
+                remediation: 'Use `fill-ref` only on editable inputs, textareas, or contenteditable fields.',
+            }, failureScreenshot),
         };
     }
     const box = await locator.boundingBox();
     const t0 = Date.now();
-    await locator.fill(value);
+    try {
+        await locator.fill(value);
+    }
+    catch (error) {
+        const failureScreenshot = await captureFailure(page, `fill-failed-${ref}`);
+        return {
+            ok: false,
+            error: `Fill failed for ${ref}: ${error instanceof Error ? error.message : String(error)}`,
+            data: failureData(page, {
+                action: 'fill-ref',
+                ref,
+                remediation: 'Inspect the failure screenshot and rerun `sweetlink snapshot -i` if the target changed.',
+            }, failureScreenshot),
+        };
+    }
     const durationMs = Date.now() - t0;
     if (isRecording()) {
         await logAction('fill', [ref, value], page, box ?? undefined, durationMs);
@@ -316,7 +677,14 @@ async function handleClickCss(params, url) {
         return {
             ok: false,
             error: `No element found matching: ${selector ?? text} (${found} matches)`,
-            data: failureScreenshot ? { failureScreenshot } : undefined,
+            data: failureData(page, {
+                action: 'click-css',
+                selector,
+                text,
+                index,
+                matchCount: found,
+                remediation: 'Update the selector/text or run `sweetlink inspect` to verify the current DOM.',
+            }, failureScreenshot),
         };
     }
     const box = await target.boundingBox();
@@ -334,11 +702,13 @@ async function handleClickCss(params, url) {
                 return { ours: true };
             if (top === intended || intended.contains(top))
                 return { ours: true };
-            const desc = top.tagName.toLowerCase() +
-                (top.id ? '#' + top.id : '') +
-                (top.className && typeof top.className === 'string'
-                    ? '.' + top.className.split(/\s+/).filter(Boolean).slice(0, 2).join('.')
-                    : '');
+            const desc = [
+                top.tagName.toLowerCase(),
+                top.id ? `#${top.id}` : '',
+                top.className && typeof top.className === 'string'
+                    ? `.${top.className.split(/\s+/).filter(Boolean).slice(0, 2).join('.')}`
+                    : '',
+            ].join('');
             return { ours: false, coveredBy: desc };
         }, { cx, cy, sel: selector ?? null });
         if (!info.ours) {
@@ -346,12 +716,35 @@ async function handleClickCss(params, url) {
             return {
                 ok: false,
                 error: `Click target ${selector ?? text} is covered by <${info.coveredBy}>. Dismiss the overlay first.`,
-                data: failureScreenshot ? { failureScreenshot } : undefined,
+                data: failureData(page, {
+                    action: 'click-css',
+                    selector,
+                    text,
+                    index,
+                    coveredBy: info.coveredBy,
+                    remediation: 'Scroll, close overlays, or click a visible target before retrying.',
+                }, failureScreenshot),
             };
         }
     }
     const t0 = Date.now();
-    await target.click();
+    try {
+        await target.click();
+    }
+    catch (error) {
+        const failureScreenshot = await captureFailure(page, `click-css-failed-${selector ?? text}`);
+        return {
+            ok: false,
+            error: `Click failed for ${selector ?? text}: ${error instanceof Error ? error.message : String(error)}`,
+            data: failureData(page, {
+                action: 'click-css',
+                selector,
+                text,
+                index,
+                remediation: 'Inspect the failure screenshot and rerun `sweetlink inspect` if the layout changed.',
+            }, failureScreenshot),
+        };
+    }
     const durationMs = Date.now() - t0;
     const tag = await target.evaluate((el) => el.tagName.toLowerCase()).catch(() => 'unknown');
     const found = await locator.count();
@@ -499,11 +892,15 @@ async function handleRecordStart(params, url) {
     const storageState = params.storageState || undefined;
     const trace = params.trace || undefined;
     const result = await startRecording(browser, url, '.sweetlink', {
-        viewport, label, storageState, trace,
+        viewport,
+        label,
+        storageState,
+        trace,
     });
     return { ok: true, data: { sessionId: result.sessionId, label, trace: !!trace } };
 }
 async function handleRecordStop() {
+    const eventCursors = getRecordingEventCursors();
     const manifest = await stopRecording();
     if (!manifest) {
         return { ok: false, error: 'No recording in progress' };
@@ -513,8 +910,12 @@ async function handleRecordStop() {
     let viewerPath;
     let summaryPath;
     try {
-        const consoleLogs = consoleBuffer.toArray();
-        const networkLogs = networkBuffer.toArray();
+        const consoleLogs = eventCursors
+            ? consoleBuffer.since(eventCursors.consoleStartCursor)
+            : consoleBuffer.toArray();
+        const networkLogs = eventCursors
+            ? networkBuffer.since(eventCursors.networkStartCursor)
+            : networkBuffer.toArray();
         viewerPath = await generateViewer(manifest, {
             sessionDir,
             consoleEntries: consoleLogs,
@@ -523,16 +924,17 @@ async function handleRecordStop() {
         // Generate SUMMARY.md
         const { promises: fsp } = await import('fs');
         // Detect server errors from console log messages
-        const consoleText = consoleLogs.map(e => e.message).join('\n');
+        const consoleText = consoleLogs.map((e) => e.message).join('\n');
         const serverErrors = detectServerErrors(consoleText);
         if (serverErrors.length > 0) {
             manifest.errors.server = serverErrors.length;
         }
+        await fsp.writeFile(`${sessionDir}/sweetlink-session.json`, JSON.stringify(manifest, null, 2), 'utf-8');
         const summaryMd = generateSummary({
             manifest,
             consoleEntries: consoleLogs,
             networkEntries: networkLogs,
-            serverErrors: serverErrors.map(e => ({
+            serverErrors: serverErrors.map((e) => ({
                 source: 'server',
                 message: e.line,
                 timestamp: Date.now(),
@@ -549,7 +951,9 @@ async function handleRecordStop() {
         console.error('[Daemon] Report generation error:', e);
     }
     // Include a browser-accessible URL for the viewer
-    const viewerUrl = manifest.sessionId && daemonPort ? `http://127.0.0.1:${daemonPort}/viewer/${manifest.sessionId}` : undefined;
+    const viewerUrl = manifest.sessionId && daemonPort
+        ? `http://127.0.0.1:${daemonPort}/viewer/${manifest.sessionId}`
+        : undefined;
     return { ok: true, data: { manifest, viewerPath, viewerUrl, summaryPath } };
 }
 async function handleRecordStatus() {
@@ -588,8 +992,14 @@ async function handleSessionsList() {
             try {
                 const raw = await fsp.readFile(manifestPath, 'utf-8');
                 const m = JSON.parse(raw);
-                const hasVideo = await fsp.access(path.join(dir, e.name, 'session.webm')).then(() => true).catch(() => false);
-                const hasViewer = await fsp.access(path.join(dir, e.name, 'viewer.html')).then(() => true).catch(() => false);
+                const hasVideo = await fsp
+                    .access(path.join(dir, e.name, 'session.webm'))
+                    .then(() => true)
+                    .catch(() => false);
+                const hasViewer = await fsp
+                    .access(path.join(dir, e.name, 'viewer.html'))
+                    .then(() => true)
+                    .catch(() => false);
                 sessions.push({
                     sessionId: m.sessionId,
                     label: m.label,
@@ -611,16 +1021,20 @@ async function handleSessionsList() {
         sessions.sort((a, b) => (b.startedAt ?? '').localeCompare(a.startedAt ?? ''));
         // Also write an index.html that links to every viewer for quick browsing.
         try {
-            const items = sessions.map((s) => {
+            const items = sessions
+                .map((s) => {
                 const viewerLink = s.hasViewer ? `${s.sessionId}/viewer.html` : '#';
                 const errorsTotal = s.errors ? s.errors.console + s.errors.network + s.errors.server : 0;
                 const errBadge = errorsTotal > 0
                     ? `<span style="color:#c00;font-weight:600">${errorsTotal} err</span>`
                     : '<span style="color:#0a0">clean</span>';
-                const labelHtml = s.label ? `<span style="color:#06c">${escape(s.label)}</span> · ` : '';
+                const labelHtml = s.label
+                    ? `<span style="color:#06c">${escapeHtml(s.label)}</span> · `
+                    : '';
                 const dur = s.duration ? `${s.duration.toFixed(1)}s` : '—';
-                return `<li><a href="${viewerLink}">${labelHtml}<code>${escape(s.sessionId)}</code></a> · ${escape(s.url ?? '')} · ${dur} · ${s.actionCount} actions · ${errBadge}</li>`;
-            }).join('\n');
+                return `<li><a href="${viewerLink}">${labelHtml}<code>${escapeHtml(s.sessionId)}</code></a> · ${escapeHtml(s.url ?? '')} · ${dur} · ${s.actionCount} actions · ${errBadge}</li>`;
+            })
+                .join('\n');
             const indexHtml = `<!DOCTYPE html>
 <html><head><title>Sweetlink Sessions</title>
 <style>
@@ -635,15 +1049,21 @@ a{text-decoration:none;color:#222}
 </body></html>`;
             await fsp.writeFile(path.join(dir, 'index.html'), indexHtml);
         }
-        catch { /* index is best-effort */ }
+        catch {
+            /* index is best-effort */
+        }
         return { ok: true, data: { sessions, indexPath: path.join(dir, 'index.html') } };
     }
     catch (err) {
         return { ok: false, error: err instanceof Error ? err.message : String(err) };
     }
 }
-function escape(s) {
-    return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+function escapeHtml(s) {
+    return String(s)
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
 }
 async function handleGenerateViewer(params) {
     const sessionDir = params.sessionDir;
@@ -663,7 +1083,10 @@ async function handleGenerateViewer(params) {
         return { ok: true, data: { viewerPath } };
     }
     catch (error) {
-        return { ok: false, error: `Failed to generate viewer: ${error instanceof Error ? error.message : error}` };
+        return {
+            ok: false,
+            error: `Failed to generate viewer: ${error instanceof Error ? error.message : error}`,
+        };
     }
 }
 async function handleVisualDiff(params) {
@@ -692,55 +1115,36 @@ async function handleVisualDiff(params) {
 // ============================================================================
 // Request Handling
 // ============================================================================
+const DAEMON_HANDLERS = {
+    ping: () => handlePing(),
+    shutdown: () => handleShutdown(),
+    screenshot: (params, url) => handleScreenshot(params, url),
+    'screenshot-responsive': (params, url) => handleResponsiveScreenshot(params, url),
+    snapshot: (params, url) => handleSnapshot(params, url),
+    inspect: (params, url) => handleInspect(params, url),
+    'click-ref': (params, url) => handleClickRef(params, url),
+    'click-css': (params, url) => handleClickCss(params, url),
+    'fill-ref': (params, url) => handleFillRef(params, url),
+    'hover-ref': (params, url) => handleHoverRef(params, url),
+    'press-key': (params, url) => handlePressKey(params, url),
+    'console-read': (params, url) => handleConsoleRead(params, url),
+    'network-read': (params, url) => handleNetworkRead(params, url),
+    'dialog-read': (_params, url) => handleDialogRead(url),
+    'screenshot-devices': (params, url) => handleScreenshotDevices(params, url),
+    'visual-diff': (params) => handleVisualDiff(params),
+    'record-start': (params, url) => handleRecordStart(params, url),
+    'record-pause': () => handleRecordPause(),
+    'record-resume': () => handleRecordResume(),
+    'sessions-list': () => handleSessionsList(),
+    'record-stop': () => handleRecordStop(),
+    'record-status': () => handleRecordStatus(),
+    'generate-viewer': (params) => handleGenerateViewer(params),
+};
 async function handleRequest(action, params, url) {
-    switch (action) {
-        case 'ping':
-            return handlePing();
-        case 'shutdown':
-            return handleShutdown();
-        case 'screenshot':
-            return handleScreenshot(params, url);
-        case 'screenshot-responsive':
-            return handleResponsiveScreenshot(params, url);
-        case 'snapshot':
-            return handleSnapshot(params, url);
-        case 'click-ref':
-            return handleClickRef(params, url);
-        case 'click-css':
-            return handleClickCss(params, url);
-        case 'fill-ref':
-            return handleFillRef(params, url);
-        case 'hover-ref':
-            return handleHoverRef(params, url);
-        case 'press-key':
-            return handlePressKey(params, url);
-        case 'console-read':
-            return handleConsoleRead(params, url);
-        case 'network-read':
-            return handleNetworkRead(params, url);
-        case 'dialog-read':
-            return handleDialogRead(url);
-        case 'screenshot-devices':
-            return handleScreenshotDevices(params, url);
-        case 'visual-diff':
-            return handleVisualDiff(params);
-        case 'record-start':
-            return handleRecordStart(params, url);
-        case 'record-pause':
-            return handleRecordPause();
-        case 'record-resume':
-            return handleRecordResume();
-        case 'sessions-list':
-            return handleSessionsList();
-        case 'record-stop':
-            return handleRecordStop();
-        case 'record-status':
-            return handleRecordStatus();
-        case 'generate-viewer':
-            return handleGenerateViewer(params);
-        default:
-            return { ok: false, error: `Unknown action: ${action}` };
-    }
+    const handler = DAEMON_HANDLERS[action];
+    if (!handler)
+        return { ok: false, error: `Unknown action: ${action}` };
+    return handler(params, url);
 }
 function readBody(req) {
     return new Promise((resolve, reject) => {
@@ -807,8 +1211,8 @@ export function startServer(options) {
                         const { promises: fsp } = await import('fs');
                         const entries = await fsp.readdir('.sweetlink', { withFileTypes: true });
                         const sessions = entries
-                            .filter(e => e.isDirectory() && e.name.startsWith('session-'))
-                            .map(e => e.name)
+                            .filter((e) => e.isDirectory() && e.name.startsWith('session-'))
+                            .map((e) => e.name)
                             .sort()
                             .reverse();
                         res.writeHead(200, { 'Content-Type': 'application/json' });