@monoes/monobrowse 1.0.9 → 1.0.12

package/src/browser/types.ts

@@ -127,10 +127,29 @@ export interface BrowserSession {
 }
 
 export const INTERACTIVE_ROLES = new Set([
-  'button', 'link', 'textbox', 'combobox', 'listbox', 'checkbox', 'radio',
-  'slider', 'spinbutton', 'searchbox', 'option', 'menuitem', 'tab', 'switch',
-  'treeitem', 'menuitemcheckbox', 'menuitemradio', 'row', 'gridcell', 'cell',
-  'columnheader', 'rowheader', 'scrollbar',
+  'button',
+  'link',
+  'textbox',
+  'combobox',
+  'listbox',
+  'checkbox',
+  'radio',
+  'slider',
+  'spinbutton',
+  'searchbox',
+  'option',
+  'menuitem',
+  'tab',
+  'switch',
+  'treeitem',
+  'menuitemcheckbox',
+  'menuitemradio',
+  'row',
+  'gridcell',
+  'cell',
+  'columnheader',
+  'rowheader',
+  'scrollbar',
 ]);
 
 export const CHROME_EXECUTABLES = [

package/src/browser/vitals.ts

@@ -1,5 +1,5 @@
-import type { CdpClient } from './cdp.js';
 import { evaluateJs } from './actions.js';
+import type { CdpClient } from './cdp.js';
 
 export interface WebVitals {
   lcp?: number;
@@ -16,7 +16,7 @@ export interface WebVitals {
 export async function collectVitals(
   client: CdpClient,
   sessionId: string,
-  waitMs = 2000
+  waitMs = 2000,
 ): Promise<WebVitals> {
   // Inject PerformanceObserver collectors and wait for data
   const script = `
@@ -97,26 +97,43 @@ export async function collectVitals(
 
 export function formatVitals(vitals: WebVitals): string {
   const lines: string[] = [];
-  const ms = (v?: number) => v !== undefined ? `${Math.round(v)}ms` : 'n/a';
+  const ms = (v?: number) => (v !== undefined ? `${Math.round(v)}ms` : 'n/a');
   const score = (metric: string, v?: number): string => {
     if (v === undefined) return '';
-    if (metric === 'lcp') return v < 2500 ? ' ✓ good' : v < 4000 ? ' ~ needs improvement' : ' ✗ poor';
-    if (metric === 'fcp') return v < 1800 ? ' ✓ good' : v < 3000 ? ' ~ needs improvement' : ' ✗ poor';
-    if (metric === 'cls') return v < 0.1 ? ' ✓ good' : v < 0.25 ? ' ~ needs improvement' : ' ✗ poor';
+    if (metric === 'lcp')
+      return v < 2500 ? ' ✓ good' : v < 4000 ? ' ~ needs improvement' : ' ✗ poor';
+    if (metric === 'fcp')
+      return v < 1800 ? ' ✓ good' : v < 3000 ? ' ~ needs improvement' : ' ✗ poor';
+    if (metric === 'cls')
+      return v < 0.1 ? ' ✓ good' : v < 0.25 ? ' ~ needs improvement' : ' ✗ poor';
     if (metric === 'inp') return v < 200 ? ' ✓ good' : v < 500 ? ' ~ needs improvement' : ' ✗ poor';
-    if (metric === 'ttfb') return v < 800 ? ' ✓ good' : v < 1800 ? ' ~ needs improvement' : ' ✗ poor';
+    if (metric === 'ttfb')
+      return v < 800 ? ' ✓ good' : v < 1800 ? ' ~ needs improvement' : ' ✗ poor';
     return '';
   };
 
-  if (vitals.lcp !== undefined) lines.push(`  LCP  (Largest Contentful Paint):  ${ms(vitals.lcp)}${score('lcp', vitals.lcp)}`);
-  if (vitals.fcp !== undefined) lines.push(`  FCP  (First Contentful Paint):     ${ms(vitals.fcp)}${score('fcp', vitals.fcp)}`);
-  if (vitals.cls !== undefined) lines.push(`  CLS  (Cumulative Layout Shift):    ${vitals.cls?.toFixed(4)}${score('cls', vitals.cls)}`);
-  if (vitals.inp !== undefined) lines.push(`  INP  (Interaction to Next Paint):  ${ms(vitals.inp)}${score('inp', vitals.inp)}`);
-  if (vitals.ttfb !== undefined) lines.push(`  TTFB (Time to First Byte):         ${ms(vitals.ttfb)}${score('ttfb', vitals.ttfb)}`);
-  if (vitals.domInteractive !== undefined) lines.push(`  DOM Interactive:                   ${ms(vitals.domInteractive)}`);
-  if (vitals.domContentLoaded !== undefined) lines.push(`  DOMContentLoaded:                  ${ms(vitals.domContentLoaded)}`);
-  if (vitals.loadTime !== undefined) lines.push(`  Load:                              ${ms(vitals.loadTime)}`);
-  if (vitals.resources !== undefined) lines.push(`  Resources loaded:                  ${vitals.resources}`);
+  if (vitals.lcp !== undefined)
+    lines.push(`  LCP  (Largest Contentful Paint):  ${ms(vitals.lcp)}${score('lcp', vitals.lcp)}`);
+  if (vitals.fcp !== undefined)
+    lines.push(`  FCP  (First Contentful Paint):     ${ms(vitals.fcp)}${score('fcp', vitals.fcp)}`);
+  if (vitals.cls !== undefined)
+    lines.push(
+      `  CLS  (Cumulative Layout Shift):    ${vitals.cls?.toFixed(4)}${score('cls', vitals.cls)}`,
+    );
+  if (vitals.inp !== undefined)
+    lines.push(`  INP  (Interaction to Next Paint):  ${ms(vitals.inp)}${score('inp', vitals.inp)}`);
+  if (vitals.ttfb !== undefined)
+    lines.push(
+      `  TTFB (Time to First Byte):         ${ms(vitals.ttfb)}${score('ttfb', vitals.ttfb)}`,
+    );
+  if (vitals.domInteractive !== undefined)
+    lines.push(`  DOM Interactive:                   ${ms(vitals.domInteractive)}`);
+  if (vitals.domContentLoaded !== undefined)
+    lines.push(`  DOMContentLoaded:                  ${ms(vitals.domContentLoaded)}`);
+  if (vitals.loadTime !== undefined)
+    lines.push(`  Load:                              ${ms(vitals.loadTime)}`);
+  if (vitals.resources !== undefined)
+    lines.push(`  Resources loaded:                  ${vitals.resources}`);
 
   return lines.join('\n');
 }

package/src/browser/wait.ts

@@ -1,7 +1,7 @@
+import { evaluateJs } from './actions.js';
+import { getCurrentUrl } from './browser.js';
 import type { CdpClient } from './cdp.js';
 import type { WaitOptions } from './types.js';
-import { getCurrentUrl } from './browser.js';
-import { evaluateJs } from './actions.js';
 
 const DEFAULT_TIMEOUT = 30_000;
 const POLL_INTERVAL = 250;
@@ -9,7 +9,7 @@ const POLL_INTERVAL = 250;
 export async function waitFor(
   client: CdpClient,
   sessionId: string,
-  options: WaitOptions
+  options: WaitOptions,
 ): Promise<void> {
   const timeout = options.timeout ?? DEFAULT_TIMEOUT;
   const deadline = Date.now() + timeout;
@@ -42,7 +42,7 @@ async function waitForLoad(
   client: CdpClient,
   sessionId: string,
   condition: string,
-  timeout: number
+  timeout: number,
 ): Promise<void> {
   if (condition === 'networkidle') {
     await waitForNetworkIdle(client, sessionId, 500, timeout);
@@ -54,7 +54,10 @@ async function waitForLoad(
   let timedOut = false;
   let timeoutHandle: ReturnType<typeof setTimeout> | undefined;
   const timeoutPromise = new Promise<void>((resolve) => {
-    timeoutHandle = setTimeout(() => { timedOut = true; resolve(); }, timeout);
+    timeoutHandle = setTimeout(() => {
+      timedOut = true;
+      resolve();
+    }, timeout);
   });
   try {
     await Promise.race([eventPromise, timeoutPromise]);
@@ -69,7 +72,7 @@ async function waitForNetworkIdle(
   client: CdpClient,
   sessionId: string,
   idleMs: number,
-  timeout: number
+  timeout: number,
 ): Promise<void> {
   return new Promise((resolve, reject) => {
     let pending = 0;
@@ -77,9 +80,15 @@ async function waitForNetworkIdle(
     let idleTimer: ReturnType<typeof setTimeout> | null = null;
 
     const cleanup = () => {
-      if (idleTimer) { clearTimeout(idleTimer); idleTimer = null; }
+      if (idleTimer) {
+        clearTimeout(idleTimer);
+        idleTimer = null;
+      }
       clearTimeout(killTimer);
-      offReq(); offResp(); offFail(); offCache();
+      offReq();
+      offResp();
+      offFail();
+      offCache();
     };
 
     const killTimer = setTimeout(() => {
@@ -87,31 +96,44 @@ async function waitForNetworkIdle(
       reject(new Error('Timeout waiting for networkidle'));
     }, timeout);
 
-    const settle = () => { cleanup(); resolve(); };
+    const settle = () => {
+      cleanup();
+      resolve();
+    };
 
     const check = () => {
       if (pending === 0) {
         if (idleTimer) clearTimeout(idleTimer);
         idleTimer = setTimeout(settle, idleMs);
       } else {
-        if (idleTimer) { clearTimeout(idleTimer); idleTimer = null; }
+        if (idleTimer) {
+          clearTimeout(idleTimer);
+          idleTimer = null;
+        }
       }
     };
 
     const offReq = client.on('Network.requestWillBeSent', (params, sid) => {
       if (sid !== sessionId) return;
       const id = params.requestId as string;
-      if (!inflight.has(id)) { inflight.add(id); pending++; check(); }
+      if (!inflight.has(id)) {
+        inflight.add(id);
+        pending++;
+        check();
+      }
     });
 
     const decrement = (params: Record<string, unknown>, sid?: string) => {
       if (sid !== sessionId) return;
       const id = params.requestId as string;
-      if (inflight.delete(id)) { pending = Math.max(0, pending - 1); check(); }
+      if (inflight.delete(id)) {
+        pending = Math.max(0, pending - 1);
+        check();
+      }
     };
 
-    const offResp  = client.on('Network.loadingFinished',        decrement);
-    const offFail  = client.on('Network.loadingFailed',          decrement);
+    const offResp = client.on('Network.loadingFinished', decrement);
+    const offFail = client.on('Network.loadingFailed', decrement);
     const offCache = client.on('Network.requestServedFromCache', decrement);
 
     check();
@@ -122,7 +144,7 @@ async function waitForUrl(
   client: CdpClient,
   sessionId: string,
   pattern: string,
-  deadline: number
+  deadline: number,
 ): Promise<void> {
   const regex = globToRegex(pattern);
   while (Date.now() < deadline) {
@@ -137,10 +159,14 @@ async function waitForText(
   client: CdpClient,
   sessionId: string,
   text: string,
-  deadline: number
+  deadline: number,
 ): Promise<void> {
   while (Date.now() < deadline) {
-    const bodyText = await evaluateJs(client, sessionId, 'document.body?.innerText ?? ""') as string;
+    const bodyText = (await evaluateJs(
+      client,
+      sessionId,
+      'document.body?.innerText ?? ""',
+    )) as string;
     if (bodyText.includes(text)) return;
     await sleep(POLL_INTERVAL);
   }
@@ -151,14 +177,14 @@ async function waitForSelector(
   client: CdpClient,
   sessionId: string,
   selector: string,
-  deadline: number
+  deadline: number,
 ): Promise<void> {
   while (Date.now() < deadline) {
-    const found = await evaluateJs(
+    const found = (await evaluateJs(
       client,
       sessionId,
-      `!!document.querySelector(${JSON.stringify(selector)})`
-    ) as boolean;
+      `!!document.querySelector(${JSON.stringify(selector)})`,
+    )) as boolean;
     if (found) return;
     await sleep(POLL_INTERVAL);
   }

package/src/cli/action.ts

@@ -1,10 +1,11 @@
 // src/commands/browse-action.ts
-import { Command } from 'commander';
-import { readdir, readFile, writeFile, mkdir } from 'node:fs/promises';
+
 import { existsSync } from 'node:fs';
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { analyzePageForAction, type AnalyzerPage } from '../index.js';
+import { Command } from 'commander';
 import type { ActionDef, StepDef } from '../index.js';
+import { type AnalyzerPage, analyzePageForAction } from '../index.js';
 
 async function readAction(filePath: string): Promise<ActionDef> {
   return JSON.parse(await readFile(filePath, 'utf8')) as ActionDef;
@@ -34,7 +35,7 @@ const BUILTIN_ACTIONS: { id: string; platform: string; name: string }[] = [
 async function getCustomActions(): Promise<ActionDef[]> {
   const dir = join(process.cwd(), '.monomind', 'actions');
   if (!existsSync(dir)) return [];
-  const files = (await readdir(dir)).filter(f => f.endsWith('.json'));
+  const files = (await readdir(dir)).filter((f) => f.endsWith('.json'));
   const results: ActionDef[] = [];
   for (const f of files) {
     try {
@@ -63,10 +64,16 @@ export function createActionCommand(): Command {
       try {
         // Dynamic import to avoid crashing if CDP is unavailable
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const mod = await (import('@monoes/monobrowse' as string) as Promise<any>).catch(() => null);
-        const createBrowserPage = mod?.createBrowserPage as ((url: string) => Promise<AnalyzerPage>) | null;
+        const mod = await (import('@monoes/monobrowse' as string) as Promise<any>).catch(
+          () => null,
+        );
+        const createBrowserPage = mod?.createBrowserPage as
+          | ((url: string) => Promise<AnalyzerPage>)
+          | null;
         if (!createBrowserPage) {
-          throw new Error('Browser CDP client not available. Ensure Chrome is running with --remote-debugging-port=9222');
+          throw new Error(
+            'Browser CDP client not available. Ensure Chrome is running with --remote-debugging-port=9222',
+          );
         }
         const page = await createBrowserPage(opts.url);
         actionDef = await analyzePageForAction(page, opts.task);
@@ -98,10 +105,12 @@ export function createActionCommand(): Command {
       console.log(`Running action: ${actionId} with account: ${opts.account}`);
 
       const custom = await getCustomActions();
-      const def = custom.find(a => a.id === actionId);
+      const def = custom.find((a) => a.id === actionId);
       if (!def) {
         console.error(`Action not found in custom actions: ${actionId}`);
-        console.error('Built-in actions require adapter step definitions — use "action build" to create a custom action.');
+        console.error(
+          'Built-in actions require adapter step definitions — use "action build" to create a custom action.',
+        );
         process.exit(1);
       }
 
@@ -126,8 +135,13 @@ export function createActionCommand(): Command {
               break;
             case 'find': {
               for (const sel of step.selectors) {
-                const found = await findBySelector(client, sessionId, refs, interpolate(sel)).catch(() => null);
-                if (found) { refs.set(step.as, found); break; }
+                const found = await findBySelector(client, sessionId, refs, interpolate(sel)).catch(
+                  () => null,
+                );
+                if (found) {
+                  refs.set(step.as, found);
+                  break;
+                }
               }
               console.log(`  find → ${step.as}`);
               break;
@@ -150,9 +164,12 @@ export function createActionCommand(): Command {
               if (step.condition === 'network_idle') {
                 await waitFor(client, sessionId, { load: 'networkidle', timeout: step.timeout });
               } else if (step.condition === 'selector' && step.selector) {
-                await waitFor(client, sessionId, { selector: step.selector, timeout: step.timeout });
+                await waitFor(client, sessionId, {
+                  selector: step.selector,
+                  timeout: step.timeout,
+                });
               } else if (step.condition === 'duration') {
-                await new Promise(r => setTimeout(r, step.timeout ?? 1000));
+                await new Promise((r) => setTimeout(r, step.timeout ?? 1000));
               }
               console.log(`  wait → ${step.condition}`);
               break;
@@ -160,8 +177,16 @@ export function createActionCommand(): Command {
               const ref = refs.get(step.target);
               if (!ref) throw new Error(`Element "${step.target}" not found`);
               const val = step.attribute
-                ? await evaluateJs(client, sessionId, `document.querySelector('[data-ref="${ref.ref}"]')?.getAttribute('${step.attribute}')`)
-                : await evaluateJs(client, sessionId, `document.querySelector('[data-ref="${ref.ref}"]')?.textContent`);
+                ? await evaluateJs(
+                    client,
+                    sessionId,
+                    `document.querySelector('[data-ref="${ref.ref}"]')?.getAttribute('${step.attribute}')`,
+                  )
+                : await evaluateJs(
+                    client,
+                    sessionId,
+                    `document.querySelector('[data-ref="${ref.ref}"]')?.textContent`,
+                  );
               console.log(`  extract → ${step.as}: ${val}`);
               break;
             }
@@ -189,10 +214,10 @@ export function createActionCommand(): Command {
     .action(async (opts: { platform?: string }) => {
       const custom = await getCustomActions();
       const all = [
-        ...BUILTIN_ACTIONS.map(a => ({ ...a, source: 'built-in' })),
-        ...custom.map(a => ({ id: a.id, platform: a.platform, name: a.name, source: 'custom' })),
+        ...BUILTIN_ACTIONS.map((a) => ({ ...a, source: 'built-in' })),
+        ...custom.map((a) => ({ id: a.id, platform: a.platform, name: a.name, source: 'custom' })),
       ];
-      const filtered = opts.platform ? all.filter(a => a.platform === opts.platform) : all;
+      const filtered = opts.platform ? all.filter((a) => a.platform === opts.platform) : all;
       if (filtered.length === 0) {
         console.log('No actions found.');
         return;
@@ -210,7 +235,7 @@ export function createActionCommand(): Command {
     .action(async (actionId: string) => {
       // Check custom actions first
       const dir = join(process.cwd(), '.monomind', 'actions');
-      const fileName = actionId.replace(':', '-') + '.json';
+      const fileName = `${actionId.replace(':', '-')}.json`;
       const customPath = join(dir, fileName);
       if (existsSync(customPath)) {
         const def = await readAction(customPath);
@@ -218,9 +243,15 @@ export function createActionCommand(): Command {
         return;
       }
       // Check built-ins
-      const builtin = BUILTIN_ACTIONS.find(a => a.id === actionId);
+      const builtin = BUILTIN_ACTIONS.find((a) => a.id === actionId);
       if (builtin) {
-        console.log(JSON.stringify({ ...builtin, note: 'Built-in action — steps defined in browser/adapters/' }, null, 2));
+        console.log(
+          JSON.stringify(
+            { ...builtin, note: 'Built-in action — steps defined in browser/adapters/' },
+            null,
+            2,
+          ),
+        );
         return;
       }
       console.error(`Action not found: ${actionId}`);