@anweat/dsh-browser 0.1.4 → 0.1.6

package/lib/automation.js

@@ -0,0 +1,181 @@
+/**
+ * Bounded, auditable Playwright recipes for model-generated browser flows.
+ * Recipes deliberately expose named operations instead of arbitrary JavaScript.
+ * @module dsh-browser/automation
+ */
+const READ_ONLY_ACTIONS = new Set(['wait', 'extract', 'assert', 'screenshot']);
+function finite(value, fallback, min, max, label) {
+    const resolved = value ?? fallback;
+    if (!Number.isFinite(resolved) || resolved < min || resolved > max)
+        throw new Error(label + ' must be between ' + min + ' and ' + max);
+    return resolved;
+}
+function selector(value) {
+    if (!value || value.length > 500)
+        throw new Error('selector must contain 1 to 500 characters');
+    return value;
+}
+function shortText(value, label, max = 20_000) {
+    if (value === undefined || value.length === 0 || value.length > max)
+        throw new Error(label + ' must contain 1 to ' + max + ' characters');
+    return value;
+}
+export function validateRecipe(steps) {
+    if (steps.length < 1 || steps.length > 25)
+        throw new Error('recipe must contain between 1 and 25 steps');
+    for (const step of steps) {
+        switch (step.type) {
+            case 'wait': {
+                finite(step.timeoutMs, 15_000, 0, 30_000, 'wait timeoutMs');
+                if (step.condition === 'selector')
+                    selector(step.value);
+                else if (step.condition === 'text')
+                    shortText(step.value, 'wait text', 2_000);
+                else if (step.condition === 'time')
+                    finite(step.waitMs ?? Number(step.value ?? 0), 0, 0, 10_000, 'wait waitMs');
+                break;
+            }
+            case 'click':
+                selector(step.selector);
+                finite(step.timeoutMs, 15_000, 1, 30_000, 'click timeoutMs');
+                break;
+            case 'fill':
+            case 'type':
+                selector(step.selector);
+                shortText(step.value, step.type + ' value');
+                finite(step.timeoutMs, 15_000, 1, 30_000, step.type + ' timeoutMs');
+                break;
+            case 'press':
+                shortText(step.key, 'key', 100);
+                if (step.selector !== undefined)
+                    selector(step.selector);
+                break;
+            case 'select':
+                selector(step.selector);
+                shortText(step.value, 'select value', 2_000);
+                break;
+            case 'check':
+            case 'hover':
+                selector(step.selector);
+                break;
+            case 'scroll':
+                finite(step.deltaY, 2_000, -20_000, 20_000, 'scroll deltaY');
+                finite(step.waitMs, 400, 0, 5_000, 'scroll waitMs');
+                break;
+            case 'extract':
+                if (step.selector !== undefined)
+                    selector(step.selector);
+                finite(step.limit, 100, 1, 500, 'extract limit');
+                if (step.mode === 'attribute')
+                    shortText(step.attribute, 'attribute', 100);
+                break;
+            case 'assert':
+                if (step.selector === undefined && step.text === undefined)
+                    throw new Error('assert requires selector or text');
+                if (step.selector !== undefined)
+                    selector(step.selector);
+                if (step.text !== undefined)
+                    shortText(step.text, 'assert text', 2_000);
+                finite(step.timeoutMs, 15_000, 1, 30_000, 'assert timeoutMs');
+                break;
+            case 'screenshot':
+                break;
+            default:
+                throw new Error('unsupported recipe step');
+        }
+    }
+}
+export function recipeNeedsApproval(steps) {
+    return steps.some(step => !READ_ONLY_ACTIONS.has(step.type));
+}
+function cap(value, max = 50_000) {
+    return value.length <= max ? value : value.slice(0, max) + '\n…(truncated)';
+}
+export async function runRecipe(page, steps, captureScreenshot, signal) {
+    validateRecipe(steps);
+    const results = [];
+    for (let index = 0; index < steps.length; index += 1) {
+        signal?.throwIfAborted();
+        const step = steps[index];
+        let value;
+        switch (step.type) {
+            case 'wait': {
+                const timeout = finite(step.timeoutMs, 15_000, 0, 30_000, 'wait timeoutMs');
+                if (step.condition === 'selector')
+                    await page.locator(selector(step.value)).first().waitFor({ state: 'visible', timeout });
+                else if (step.condition === 'text')
+                    await page.getByText(shortText(step.value, 'wait text', 2_000), { exact: false }).first().waitFor({ state: 'visible', timeout });
+                else if (step.condition === 'load')
+                    await page.waitForLoadState('networkidle', { timeout });
+                else
+                    await page.waitForTimeout(finite(step.waitMs ?? Number(step.value ?? 0), 0, 0, 10_000, 'wait waitMs'));
+                break;
+            }
+            case 'click':
+                await page.locator(selector(step.selector)).first().click({ timeout: step.timeoutMs ?? 15_000 });
+                break;
+            case 'fill':
+                await page.locator(selector(step.selector)).first().fill(step.value, { timeout: step.timeoutMs ?? 15_000 });
+                break;
+            case 'type':
+                await page.locator(selector(step.selector)).first().pressSequentially(step.value, { timeout: step.timeoutMs ?? 15_000 });
+                break;
+            case 'press':
+                if (step.selector)
+                    await page.locator(selector(step.selector)).first().press(step.key);
+                else
+                    await page.keyboard.press(step.key);
+                break;
+            case 'select':
+                await page.locator(selector(step.selector)).first().selectOption(step.value);
+                break;
+            case 'check': {
+                const target = page.locator(selector(step.selector)).first();
+                if (step.checked === false)
+                    await target.uncheck();
+                else
+                    await target.check();
+                break;
+            }
+            case 'hover':
+                await page.locator(selector(step.selector)).first().hover();
+                break;
+            case 'scroll':
+                await page.mouse.wheel(0, step.deltaY ?? 2_000);
+                await page.waitForTimeout(step.waitMs ?? 400);
+                break;
+            case 'extract': {
+                const target = page.locator(step.selector ?? 'body').first();
+                const mode = step.mode ?? 'text';
+                if (mode === 'text')
+                    value = cap(await target.innerText());
+                else if (mode === 'html')
+                    value = cap(await target.innerHTML());
+                else if (mode === 'attribute')
+                    value = String(await target.getAttribute(shortText(step.attribute, 'attribute', 100)) ?? '');
+                else {
+                    const rows = await target.locator('a[href]').evaluateAll((anchors, limit) => anchors.slice(0, limit).map(anchor => ({
+                        text: String(anchor.textContent ?? '').trim(),
+                        url: String(anchor.href ?? ''),
+                    })), step.limit ?? 100);
+                    value = cap(JSON.stringify(rows));
+                }
+                break;
+            }
+            case 'assert': {
+                const timeout = step.timeoutMs ?? 15_000;
+                if (step.selector)
+                    await page.locator(selector(step.selector)).first().waitFor({ state: 'visible', timeout });
+                if (step.text)
+                    await page.getByText(step.text, { exact: false }).first().waitFor({ state: 'visible', timeout });
+                break;
+            }
+            case 'screenshot':
+                value = await captureScreenshot();
+                break;
+        }
+        results.push({ step: index + 1, action: step.type, ok: true, ...value !== undefined ? { value } : {} });
+    }
+    return results;
+}
+//# sourceMappingURL=automation.js.map

package/lib/automation.js.map

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

package/lib/browser-service.d.ts

@@ -20,6 +20,8 @@
  */
 import { type CliResult } from './deps.ts';
 import type { ResolvedConfig } from './config.ts';
+import { type BrowserRecipeStep, type RecipeStepResult } from './automation.ts';
+import { type UserscriptValidation } from './scripts.ts';
 export interface RenderRule {
     hostname: string;
     contentSelectors: string[];
@@ -56,27 +58,46 @@ export interface InteractiveState {
     text: string;
     screenshotPath?: string;
 }
+export interface RecipeRunResult extends InteractiveState {
+    steps: RecipeStepResult[];
+}
+export interface ScriptRunResult {
+    url: string;
+    name: string;
+    sha256: string;
+    capabilities: string[];
+    resultJson: string;
+    truncated: boolean;
+}
 export declare class BrowserService {
     private readonly config;
     private browser;
     private launching?;
     private activeContext;
     private activePage;
+    private activeProfile?;
+    private activeRulePack?;
+    private readonly authProfiles;
     constructor(config: ResolvedConfig);
     available(): boolean;
     private ensure;
     /** Run `playwright install chromium` from the bundled playwright CLI. */
     installChromium(): Promise<CliResult>;
     private transientContext;
+    private persistAndClose;
     render(url: string, rules: readonly RenderRule[], opts?: {
         signal?: AbortSignal;
         maxChars?: number;
         waitMs?: number;
+        authProfile?: string;
+        rulePack?: string;
     }): Promise<RenderResult>;
     snapshot(url: string, rules: readonly RenderRule[], opts: {
         signal?: AbortSignal;
         outDir: string;
         maxChars?: number;
+        authProfile?: string;
+        rulePack?: string;
     }): Promise<SnapshotResult>;
     searchResults(url: string, spec: PlatformSpec, opts?: {
         signal?: AbortSignal;
@@ -88,17 +109,42 @@ export declare class BrowserService {
             domain: string;
             path: string;
         }[];
+        authProfile?: string;
+        rulePack?: string;
     }): Promise<SearchItem[]>;
     opencliAvailable(): boolean;
     opencli(args: string[], opts?: {
         timeoutMs?: number;
         signal?: AbortSignal;
     }): Promise<CliResult>;
+    opencliDoctor(signal?: AbortSignal): Promise<CliResult>;
+    scriptCatalog(): {
+        id: string;
+        name: string;
+        description: string;
+        sha256: string;
+    }[];
+    validateUserscript(source: string, targetUrl?: string): UserscriptValidation;
+    private runScript;
+    runBuiltinScript(url: string, id: string, opts?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+        authProfile?: string;
+        rulePack?: string;
+    }): Promise<ScriptRunResult>;
+    runUserscript(url: string, source: string, opts?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+        authProfile?: string;
+        rulePack?: string;
+    }): Promise<ScriptRunResult>;
     private ensureActivePage;
     private captureScreenshot;
     private readState;
     open(url: string, opts?: {
         waitMs?: number;
+        authProfile?: string;
+        rulePack?: string;
     }): Promise<InteractiveState>;
     click(selector: string, opts?: {
         timeoutMs?: number;
@@ -114,6 +160,13 @@ export declare class BrowserService {
     screenshot(): Promise<{
         path: string;
     }>;
+    recipe(steps: readonly BrowserRecipeStep[], opts?: {
+        url?: string;
+        waitMs?: number;
+        authProfile?: string;
+        rulePack?: string;
+        signal?: AbortSignal;
+    }): Promise<RecipeRunResult>;
     closePage(): Promise<void>;
     status(): Promise<{
         enabled: boolean;
@@ -121,7 +174,17 @@ export declare class BrowserService {
         headless: boolean;
         opencliEnabled: boolean;
         chromiumInstalled: boolean;
+        authProfiles: {
+            id: string;
+            allowedDomains: string[];
+            persistState: boolean;
+        }[];
+        rulePacks: string[];
+        builtinScripts: string[];
+        externalUserscriptsRequireApproval: true;
+        mutatingRecipesRequireApproval: true;
         activeUrl?: string;
+        activeAuthProfile?: string;
     }>;
     close(): Promise<void>;
 }