sweetlink 0.1.0

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

@@ -0,0 +1,78 @@
+import type { SweetLinkCommandResult, SweetLinkScreenshotRenderer } from '../../shared/src/index.js';
+import type { CliConfig } from '../types.js';
+import type { SweetLinkConsoleDump } from './session.js';
+export interface DevToolsCaptureOptions {
+    readonly devtoolsUrl: string;
+    readonly sessionUrl: string;
+    readonly selector?: string;
+    readonly quality: number;
+    readonly mode: 'full' | 'element';
+    readonly outputPath: string;
+}
+export interface SweetLinkScreenshotResultPayload {
+    readonly mimeType: 'image/jpeg';
+    readonly base64: string;
+    readonly width: number;
+    readonly height: number;
+    readonly renderer: SweetLinkScreenshotRenderer;
+}
+export type ScreenshotFallbackContext = {
+    readonly config: CliConfig;
+    readonly token: string;
+    readonly sessionId: string;
+    readonly payload: {
+        readonly type: 'screenshot';
+        readonly id: string;
+        readonly mode: 'full' | 'element';
+        readonly selector?: string;
+        readonly quality: number;
+        readonly timeoutMs: number;
+        readonly renderer?: SweetLinkScreenshotRenderer;
+        readonly hooks?: unknown;
+    };
+    readonly outputPath: string;
+    readonly prompt: string | undefined;
+    readonly suppressOutput: boolean;
+};
+export type HtmlToImageFallbackOutcome = {
+    readonly handled: true;
+} | {
+    readonly handled: false;
+    readonly fallbackResult: SweetLinkCommandResult;
+};
+export type DevToolsRecoveryContext = {
+    readonly sessionUrl?: string;
+    readonly devtoolsUrl: string;
+    readonly selector?: string;
+    readonly quality: number;
+    readonly mode: 'full' | 'element';
+    readonly outputPath: string;
+    readonly prompt: string | undefined;
+    readonly suppressOutput: boolean;
+    readonly logInfo: (...args: unknown[]) => void;
+    readonly failureReason?: string | null;
+    readonly appLabel?: string;
+};
+export declare function maybeDescribeScreenshot(prompt: string | undefined, imagePath: string, options?: {
+    silent?: boolean;
+    appLabel?: string;
+}): Promise<void>;
+export declare function maybeAnalyzeConsoleWithPrompt(prompt: string | undefined, selector: string, events: SweetLinkConsoleDump[], options?: {
+    silent?: boolean;
+    appLabel?: string;
+}): Promise<boolean>;
+export declare function tryHtmlToImageFallback(context: ScreenshotFallbackContext & {
+    readonly rendererOverride: SweetLinkScreenshotRenderer;
+    readonly failureReason?: string | null;
+}): Promise<HtmlToImageFallbackOutcome>;
+export declare function attemptDevToolsCapture(options: DevToolsCaptureOptions): Promise<{
+    width: number;
+    height: number;
+    sizeKb: number;
+    renderer: 'puppeteer';
+} | null>;
+export declare function tryDevToolsRecovery(context: DevToolsRecoveryContext): Promise<boolean>;
+export declare function persistScreenshotResult(outputPath: string, result: SweetLinkCommandResult, options?: {
+    silent?: boolean;
+}): Promise<SweetLinkScreenshotResultPayload>;
+//# sourceMappingURL=screenshot.d.ts.map

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

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

package/dist/src/runtime/screenshot.js

@@ -0,0 +1,232 @@
+import { writeFile } from 'node:fs/promises';
+import { runCodexImagePrompt, runCodexTextPrompt } from '../codex.js';
+import { fetchJson } from '../http.js';
+import { describeAppForPrompt } from '../util/app-label.js';
+import { extractEventMessage, isErrnoException } from '../util/errors.js';
+import { TRAILING_SLASH_PATTERN } from '../util/regex.js';
+import { formatConsoleArg } from './devtools.js';
+export async function maybeDescribeScreenshot(prompt, imagePath, options = {}) {
+    const question = prompt?.trim();
+    if (!question) {
+        return;
+    }
+    const appDescription = describeAppForPrompt(options.appLabel);
+    const combinedPrompt = `You are analyzing a screenshot from ${appDescription} (treat it like a typical product dashboard). Inspect the image carefully before answering.\nQuestion: ${question}`;
+    if (!options.silent) {
+        console.log(`Asking Codex about screenshot: ${question}`);
+    }
+    try {
+        const exitCode = await runCodexImagePrompt(imagePath, combinedPrompt);
+        if (exitCode !== 0) {
+            console.warn(`Codex exited with status ${exitCode}.`);
+        }
+    }
+    catch (error) {
+        const message = extractEventMessage(error);
+        const missing = isErrnoException(error) && error.code === 'ENOENT';
+        const prefix = missing ? 'Codex CLI not found' : `Codex CLI failed: ${message}`;
+        console.warn(missing ? `${prefix}; install it or add it to $PATH to use --prompt.` : prefix);
+    }
+}
+export async function maybeAnalyzeConsoleWithPrompt(prompt, selector, events, options = {}) {
+    const question = prompt?.trim();
+    if (!question) {
+        return false;
+    }
+    const lines = events.length > 0
+        ? events.map((event) => {
+            const timestamp = new Date(event.timestamp ?? Date.now()).toLocaleTimeString();
+            const argsText = event.args && event.args.length > 0 ? event.args.map((value) => formatConsoleArg(value)).join(' ') : '';
+            const suffix = argsText.length > 0 ? `: ${argsText}` : '';
+            return `[${timestamp}] ${event.level}${suffix}`;
+        })
+        : ['(no console events were captured after the click)'];
+    const appDescription = describeAppForPrompt(options.appLabel);
+    const combinedPrompt = `You are analyzing console output from ${appDescription} immediately after triggering a click on selector "${selector}". ` +
+        'Review the log lines below (most recent last) and answer the agent’s question.\n\n' +
+        `Console output:\n${lines.join('\n')}\n\nQuestion: ${question}`;
+    if (!options.silent) {
+        console.log(`Asking Codex about console output after ${selector}: ${question}`);
+    }
+    try {
+        const exitCode = await runCodexTextPrompt(combinedPrompt);
+        if (exitCode !== 0) {
+            console.warn(`Codex exited with status ${exitCode}.`);
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        const message = extractEventMessage(error);
+        const missing = isErrnoException(error) && error.code === 'ENOENT';
+        const prefix = missing ? 'Codex CLI not found' : `Codex CLI failed: ${message}`;
+        console.warn(missing ? `${prefix}; install it or add it to $PATH to use --prompt.` : prefix);
+        return false;
+    }
+}
+export async function tryHtmlToImageFallback(context) {
+    const { rendererOverride, failureReason, config, token, sessionId, payload, outputPath, prompt, suppressOutput } = context;
+    console.warn(`Requested renderer "${rendererOverride}" failed: ${failureReason ?? 'Unknown error'}`);
+    console.warn('Falling back to html-to-image renderer…');
+    const fallbackResponse = await fetchJson(`${config.daemonBaseUrl}/sessions/${encodeURIComponent(sessionId)}/command`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ ...payload, renderer: 'html-to-image' }),
+    });
+    const fallbackResult = fallbackResponse.result;
+    if (!fallbackResult.ok) {
+        console.error('Fallback html-to-image renderer also failed.');
+        return { handled: false, fallbackResult };
+    }
+    await persistScreenshotResult(outputPath, fallbackResult, { silent: suppressOutput });
+    await maybeDescribeScreenshot(prompt, outputPath, { silent: suppressOutput, appLabel: config.appLabel });
+    return { handled: true };
+}
+export async function attemptDevToolsCapture(options) {
+    const { devtoolsUrl, sessionUrl, selector, quality, mode, outputPath } = options;
+    const normalizedUrl = devtoolsUrl.replace(TRAILING_SLASH_PATTERN, '');
+    try {
+        const versionResponse = await fetch(`${normalizedUrl}/json/version`, { method: 'GET' });
+        if (!versionResponse.ok) {
+            return null;
+        }
+    }
+    catch {
+        return null;
+    }
+    let puppeteer;
+    try {
+        ({ default: puppeteer } = await import('puppeteer'));
+    }
+    catch (error) {
+        console.warn('Puppeteer is unavailable:', error);
+        return null;
+    }
+    const browser = await puppeteer.connect({ browserURL: normalizedUrl, defaultViewport: null, protocolTimeout: 5000 });
+    try {
+        const pages = await browser.pages();
+        const sessionUrlObj = new URL(sessionUrl);
+        const target = pages.find((page) => page.url() === sessionUrl) ||
+            pages.find((page) => page.url()?.startsWith(sessionUrlObj.origin));
+        if (!target) {
+            return null;
+        }
+        await target.bringToFront();
+        const jpegQuality = Math.min(100, Math.max(1, Math.round(quality * 100)));
+        let buffer;
+        let width = 0;
+        let height = 0;
+        if (selector) {
+            await target.waitForSelector(selector, { timeout: 10_000 });
+            const element = await target.$(selector);
+            if (!element) {
+                throw new Error(`Selector ${selector} not found in target page`);
+            }
+            const box = await element.boundingBox();
+            const raw = (await element.screenshot({ type: 'jpeg', quality: jpegQuality }));
+            await writeFile(outputPath, raw, { mode: 0o600 });
+            buffer = raw;
+            width = box ? Math.round(box.width) : 0;
+            height = box ? Math.round(box.height) : 0;
+        }
+        else if (mode === 'full') {
+            const raw = (await target.screenshot({
+                type: 'jpeg',
+                quality: jpegQuality,
+                fullPage: true,
+            }));
+            await writeFile(outputPath, raw, { mode: 0o600 });
+            buffer = raw;
+            const dims = await target.evaluate(() => ({
+                width: document.documentElement.scrollWidth,
+                height: document.documentElement.scrollHeight,
+            }));
+            width = Math.round(dims.width);
+            height = Math.round(dims.height);
+        }
+        else {
+            const clip = await target.evaluate(() => {
+                const explicit = document.querySelector('[data-sweetlink-target="top-posters-card"]');
+                const cards = explicit ? [explicit] : [...document.querySelectorAll('div.col-span-1')];
+                const targetCard = cards.find((card) => [...card.querySelectorAll('span, h2, h3')].some((node) => (node.textContent || '').trim().toLowerCase() === 'top posters'));
+                if (!targetCard) {
+                    return null;
+                }
+                targetCard.scrollIntoView({ behavior: 'auto', block: 'center' });
+                const rect = targetCard.getBoundingClientRect();
+                return {
+                    x: Math.max(0, Math.floor(rect.left) - 8),
+                    y: Math.max(0, Math.floor(rect.top) - 8),
+                    width: Math.ceil(rect.width) + 16,
+                    height: Math.ceil(rect.height) + 16,
+                };
+            });
+            if (!clip) {
+                throw new Error('Unable to locate Top Posters card in target tab');
+            }
+            const raw = (await target.screenshot({ type: 'jpeg', quality: jpegQuality, clip }));
+            await writeFile(outputPath, raw, { mode: 0o600 });
+            buffer = raw;
+            width = Math.round(clip.width);
+            height = Math.round(clip.height);
+        }
+        return {
+            width,
+            height,
+            sizeKb: buffer.length / 1024,
+            renderer: 'puppeteer',
+        };
+    }
+    catch (error) {
+        console.warn('DevTools capture failed:', error instanceof Error ? error.message : error);
+        return null;
+    }
+    finally {
+        await browser.disconnect();
+    }
+}
+export async function tryDevToolsRecovery(context) {
+    const { sessionUrl, devtoolsUrl, selector, quality, mode, outputPath, prompt, suppressOutput, logInfo, failureReason, } = context;
+    if (!sessionUrl) {
+        return false;
+    }
+    const devtoolsFallback = await attemptDevToolsCapture({
+        devtoolsUrl,
+        outputPath,
+        sessionUrl,
+        selector,
+        quality,
+        mode,
+    });
+    if (!devtoolsFallback) {
+        console.warn('Puppeteer fallback did not succeed; showing original renderer error.');
+        return false;
+    }
+    const reason = failureReason ?? 'unknown error';
+    logInfo(`Renderer failure (${reason}) recovered via Puppeteer fallback (${devtoolsFallback.width}x${devtoolsFallback.height}, ${devtoolsFallback.sizeKb.toFixed(1)} KB).`);
+    if (!suppressOutput) {
+        console.log(`Saved screenshot to ${outputPath} (${devtoolsFallback.width}x${devtoolsFallback.height}, ${devtoolsFallback.sizeKb.toFixed(1)} KB, method: ${devtoolsFallback.renderer}).`);
+    }
+    await maybeDescribeScreenshot(prompt, outputPath, { silent: suppressOutput, appLabel: context.appLabel });
+    return true;
+}
+export async function persistScreenshotResult(outputPath, result, options = {}) {
+    if (!result.ok) {
+        throw new Error(result.error ?? 'Screenshot command failed');
+    }
+    const data = result.data;
+    if (!data || typeof data.base64 !== 'string') {
+        throw new Error('Screenshot succeeded but no image payload was returned.');
+    }
+    const buffer = Buffer.from(data.base64, 'base64');
+    await writeFile(outputPath, buffer, { mode: 0o600 });
+    const sizeInKb = buffer.length / 1024;
+    if (!options.silent) {
+        console.log(`Saved screenshot to ${outputPath} (${data.width}x${data.height}, ${sizeInKb.toFixed(1)} KB, method: ${data.renderer}).`);
+    }
+    return data;
+}
+//# sourceMappingURL=screenshot.js.map

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

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

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

@@ -0,0 +1,16 @@
+import type { SweetLinkCommandResult } from '../../shared/src/index.js';
+export interface RunJsOptions {
+    code?: string[];
+    file?: string;
+    captureConsole?: boolean;
+    timeout: number;
+}
+/** Resolve inline or file-based JavaScript payloads for run-js commands. */
+export declare function resolveScript(options: RunJsOptions, inline?: string[]): Promise<string>;
+/** Loads an optional beforeScript snippet for screenshot hooks. */
+export declare function resolveHookSnippet(value?: string): Promise<string | null>;
+/** Pretty-prints a command result to stdout. */
+export declare function renderCommandResult(result: SweetLinkCommandResult): void;
+/** Formats unknown result payloads safely for logging. */
+export declare function formatResultData(value: unknown): string;
+//# sourceMappingURL=scripts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../../src/runtime/scripts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGxE,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAc7F;AAED,mEAAmE;AACnE,wBAAsB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuB/E;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAwCxE;AAMD,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmBvD"}

package/dist/src/runtime/scripts.js

@@ -0,0 +1,110 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { inspect } from 'node:util';
+import { sweetLinkDebug } from '../env.js';
+/** Resolve inline or file-based JavaScript payloads for run-js commands. */
+export async function resolveScript(options, inline) {
+    if (options.file) {
+        const fileContents = await readFile(options.file, 'utf8');
+        return fileContents.toString();
+    }
+    if (options.code && options.code.length > 0) {
+        return options.code.join(' ');
+    }
+    if (inline?.length) {
+        return inline.join(' ');
+    }
+    throw new Error('Provide JavaScript inline (e.g. `pnpm sweetlink run-js <id> "console.log(1)"`) or use --code/--file to supply a script.');
+}
+/** Loads an optional beforeScript snippet for screenshot hooks. */
+export async function resolveHookSnippet(value) {
+    if (!value) {
+        return null;
+    }
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    if (trimmed.startsWith('@')) {
+        const candidatePath = trimmed.slice(1).trim();
+        if (!candidatePath) {
+            throw new Error('Expected a file path after @ for --before-script.');
+        }
+        const absolute = path.isAbsolute(candidatePath) ? candidatePath : path.resolve(candidatePath);
+        const hookContents = await readFile(absolute, 'utf8');
+        return hookContents.toString();
+    }
+    if (trimmed.startsWith('file://')) {
+        const filePath = trimmed.slice('file://'.length);
+        const hookContents = await readFile(filePath, 'utf8');
+        return hookContents.toString();
+    }
+    return trimmed;
+}
+/** Pretty-prints a command result to stdout. */
+export function renderCommandResult(result) {
+    if (result.ok) {
+        console.log('✅ Script executed successfully');
+        if (sweetLinkDebug) {
+            console.log('[sweetlink] command result payload', result);
+        }
+        if (hasCommandResultData(result)) {
+            const formatted = formatResultData(result.data);
+            if (formatted.includes('\n')) {
+                console.log(`Result:\n${formatted}`);
+            }
+            else {
+                console.log('Result:', formatted);
+            }
+        }
+        if (result.console?.length) {
+            console.log('\nConsole output:');
+            for (const entry of result.console) {
+                const timestamp = new Date(entry.timestamp).toLocaleTimeString();
+                console.log(`[${timestamp}] ${entry.level}:`, ...entry.args);
+            }
+        }
+        return;
+    }
+    console.error('❌ Script failed');
+    console.error('Error:', result.error);
+    if (typeof result.error === 'string' && result.error.includes('Session not found or offline')) {
+        console.error('Hint: run `pnpm sweetlink sessions` to list active SweetLink sessions and grab a fresh id.');
+    }
+    if (result.stack) {
+        console.error(result.stack);
+    }
+    if (result.console?.length) {
+        console.error('\nConsole output before failure:');
+        for (const entry of result.console) {
+            const timestamp = new Date(entry.timestamp).toLocaleTimeString();
+            console.error(`[${timestamp}] ${entry.level}:`, ...entry.args);
+        }
+    }
+    process.exitCode = 1;
+}
+const hasCommandResultData = (value) => typeof value === 'object' && value !== null && 'data' in value;
+/** Formats unknown result payloads safely for logging. */
+export function formatResultData(value) {
+    if (value === undefined) {
+        return '(undefined)';
+    }
+    if (value === null) {
+        return 'null';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        try {
+            return inspect(value, { depth: 2, breakLength: 60 });
+        }
+        catch {
+            return '[unserializable result]';
+        }
+    }
+}
+//# sourceMappingURL=scripts.js.map

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

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

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

@@ -0,0 +1,64 @@
+import type { SweetLinkSelectorCandidate, SweetLinkSelectorDiscoveryResult } from '../../shared/src/index.js';
+import { type SweetLinkCommandResult } from '../../shared/src/index.js';
+import type { CliConfig } from '../types.js';
+export interface SweetLinkSessionSummaryResponse {
+    readonly sessions: Array<{
+        readonly sessionId: string;
+        readonly codename?: string;
+        readonly url: string;
+        readonly title: string;
+        readonly topOrigin: string;
+        readonly createdAt: number;
+        readonly lastSeenAt: number;
+        readonly heartbeatMsAgo?: number;
+        readonly consoleEventsBuffered?: number;
+        readonly consoleErrorsBuffered?: number;
+        readonly pendingCommandCount?: number;
+        readonly socketState?: 'open' | 'closing' | 'closed' | 'connecting' | 'unknown';
+        readonly userAgent?: string;
+        readonly lastConsoleEventAt?: number | null;
+    }>;
+}
+export type SweetLinkSessionSummary = SweetLinkSessionSummaryResponse['sessions'][number];
+export interface SweetLinkConsoleDump {
+    readonly id: string;
+    readonly timestamp: number;
+    readonly level: string;
+    readonly args: unknown[];
+}
+export interface RunScriptCommandOptions {
+    readonly sessionId: string;
+    readonly code: string;
+    readonly timeoutMs: number;
+    readonly captureConsole?: boolean;
+}
+export interface BuildClickScriptOptions {
+    readonly selector: string;
+    readonly scrollIntoView: boolean;
+    readonly bubbles: boolean;
+}
+export declare function fetchSessionSummaries(config: CliConfig, existingToken?: string): Promise<SweetLinkSessionSummary[]>;
+/** Formats a session id + codename pair for CLI display. */
+export declare function formatSessionHeadline(session: {
+    sessionId: string;
+    codename?: string;
+}): string;
+/** Resolves a human codename or short id to an active SweetLink session. */
+export declare function resolveSessionIdFromHint(sessionHint: string, config: CliConfig): Promise<string>;
+/** Sends a SweetLink runScript command and returns the raw command result. */
+export declare function executeRunScriptCommand(config: CliConfig, options: RunScriptCommandOptions): Promise<SweetLinkCommandResult>;
+/** Returns recent console events captured for a SweetLink session. */
+export declare function fetchConsoleEvents(config: CliConfig, sessionId: string): Promise<SweetLinkConsoleDump[]>;
+export declare function getSessionSummaryById(config: CliConfig, token: string, sessionId: string): Promise<SweetLinkSessionSummary | undefined>;
+/** Returns the resolved prompt string for CLI commands. */
+export declare function resolvePromptOption(options: {
+    prompt?: string;
+    question?: string;
+}): string | undefined;
+/** Builds a DOM click script scoped to the provided selector. */
+export declare function buildClickScript({ selector, scrollIntoView, bubbles }: BuildClickScriptOptions): string;
+/** Shared guard ensuring candidates from selector discovery are valid. */
+export declare const isSweetLinkSelectorCandidate: (value: unknown) => value is SweetLinkSelectorCandidate;
+/** Wrapper guards selector discovery responses. */
+export declare const isSweetLinkSelectorDiscoveryResult: (value: unknown) => value is SweetLinkSelectorDiscoveryResult;
+//# sourceMappingURL=session.d.ts.map

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

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