@ulpi/browse 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ulpi/browse",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/ulpi-io/browse"

package/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: browse
-version: 2.4.0
+version: 2.5.0
 description: |
   Fast web browsing for AI coding agents via persistent headless Chromium daemon. Navigate to any URL,
   read page content, click elements, fill forms, run JavaScript, take screenshots,
@@ -260,7 +260,8 @@ browse accessibility      Accessibility tree snapshot (ARIA)
 ### Snapshot (ref-based element selection)
 ```
 browse snapshot           Full accessibility tree with @refs
-browse snapshot -i        Interactive elements only (buttons, links, inputs)
+browse snapshot -i        Interactive elements only — terse flat list (minimal tokens)
+browse snapshot -i -v     Interactive elements — verbose indented tree with props
 browse snapshot -c        Compact (no empty structural elements)
 browse snapshot -C        Cursor-interactive (detect divs with cursor:pointer/onclick/tabindex)
 browse snapshot -d <N>    Limit depth to N levels

package/src/cli.ts

@@ -20,7 +20,6 @@ const cliFlags = {
   contentBoundaries: false,
   allowedDomains: '' as string,
   headed: false,
-  runtime: '' as string,
 };
 
 const BROWSE_PORT = parseInt(process.env.BROWSE_PORT || '0', 10);
@@ -253,7 +252,7 @@ async function startServer(): Promise<ServerState> {
       : ['bun', 'run', SERVER_SCRIPT];
     const proc = Bun.spawn(spawnCmd, {
       stdio: ['ignore', 'pipe', 'pipe'],
-      env: { ...process.env, __BROWSE_SERVER_MODE: '1', BROWSE_LOCAL_DIR: LOCAL_DIR, BROWSE_INSTANCE, ...(cliFlags.headed ? { BROWSE_HEADED: '1' } : {}), ...(cliFlags.runtime ? { BROWSE_RUNTIME: cliFlags.runtime } : {}) },
+      env: { ...process.env, __BROWSE_SERVER_MODE: '1', BROWSE_LOCAL_DIR: LOCAL_DIR, BROWSE_INSTANCE, ...(cliFlags.headed ? { BROWSE_HEADED: '1' } : {}) },
     });
 
     // Don't hold the CLI open
@@ -512,7 +511,7 @@ export async function main() {
     for (let i = 0; i < a.length; i++) {
       if (!a[i].startsWith('-')) return i;
       // Skip flag values for known value-flags
-      if (a[i] === '--session' || a[i] === '--allowed-domains' || a[i] === '--runtime') i++;
+      if (a[i] === '--session' || a[i] === '--allowed-domains') i++;
     }
     return a.length;
   }
@@ -570,25 +569,11 @@ export async function main() {
   }
   headed = headed || process.env.BROWSE_HEADED === '1';
 
-  // Extract --runtime flag (only before command)
-  let runtimeName: string | undefined;
-  const runtimeIdx = args.indexOf('--runtime');
-  if (runtimeIdx !== -1 && runtimeIdx < findCommandIndex(args)) {
-    runtimeName = args[runtimeIdx + 1];
-    if (!runtimeName || runtimeName.startsWith('-')) {
-      console.error('Usage: browse --runtime <name> <command> [args...]');
-      process.exit(1);
-    }
-    args.splice(runtimeIdx, 2);
-  }
-  runtimeName = runtimeName || process.env.BROWSE_RUNTIME || config.runtime || undefined;
-
   // Set global flags for sendCommand()
   cliFlags.json = jsonMode;
   cliFlags.contentBoundaries = contentBoundaries;
   cliFlags.allowedDomains = allowedDomains || '';
   cliFlags.headed = headed;
-  cliFlags.runtime = runtimeName || '';
 
   // ─── Local commands (no server needed) ─────────────────────
   if (args[0] === 'instances') {
@@ -620,8 +605,8 @@ Inspection:     js <expr> | eval <file> | css <sel> <prop> | attrs <sel>
                 element-state <sel> | console [--clear] | network [--clear]
                 cookies | storage [set <k> <v>] | perf
                 value <sel> | count <sel> | clipboard [write <text>]
-Visual:         screenshot [path] [--full] [--annotate] | pdf [path] | responsive [prefix]
-Snapshot:       snapshot [-i] [-c] [-C] [-d N] [-s sel]
+Visual:         screenshot [path] | pdf [path] | responsive [prefix]
+Snapshot:       snapshot [-i] [-v] [-c] [-C] [-d N] [-s sel]
 Find:           find role|text|label|placeholder|testid <query> [name]
 Compare:        diff <url1> <url2> | screenshot-diff <baseline> [current]
 Multi-step:     chain (reads JSON from stdin)
@@ -645,10 +630,10 @@ Options:
   --content-boundaries     Wrap page content in nonce-delimited markers
   --allowed-domains <d,d>  Block navigation/resources outside allowlist
   --headed                 Run browser in headed (visible) mode
-  --runtime <name>         Browser runtime (playwright, rebrowser, lightpanda)
 
 Snapshot flags:
-  -i            Interactive elements only (buttons, links, inputs)
+  -i            Interactive elements only (terse flat list by default)
+  -v            Verbose — full indented tree with props (use with -i)
   -c            Compact — remove empty structural elements
   -C            Cursor-interactive — detect divs with cursor:pointer,
                 onclick, tabindex, data-action (missed by ARIA tree)

package/src/snapshot.ts

@@ -30,7 +30,8 @@ const INTERACTIVE_ROLES = new Set([
 ]);
 
 interface SnapshotOptions {
-  interactive?: boolean;  // -i: only interactive elements
+  interactive?: boolean;  // -i: only interactive elements (terse flat list by default)
+  verbose?: boolean;      // -v: full indented ARIA tree with props/children (overrides -i terse default)
   compact?: boolean;      // -c: remove empty structural elements
   depth?: number;         // -d N: limit tree depth
   selector?: string;      // -s SEL: scope to CSS selector
@@ -72,6 +73,10 @@ export function parseSnapshotArgs(args: string[]): SnapshotOptions {
       case '--compact':
         opts.compact = true;
         break;
+      case '-v':
+      case '--verbose':
+        opts.verbose = true;
+        break;
       case '-C':
       case '--cursor':
         opts.cursor = true;
@@ -417,10 +422,18 @@ export async function handleSnapshot(
     refMap.set(ref, locator);
 
     // Format output line
-    let outputLine = `${indent}@${ref} [${node.role}]`;
-    if (node.name) outputLine += ` "${node.name}"`;
-    if (node.props) outputLine += ` ${node.props}`;
-    if (node.children) outputLine += `: ${node.children}`;
+    // -i without -v: terse flat list (no indent, no props, no children)
+    const terse = opts.interactive && !opts.verbose;
+    let outputLine: string;
+    if (terse) {
+      outputLine = `@${ref} [${node.role}]`;
+      if (node.name) outputLine += ` "${node.name}"`;
+    } else {
+      outputLine = `${indent}@${ref} [${node.role}]`;
+      if (node.name) outputLine += ` "${node.name}"`;
+      if (node.props) outputLine += ` ${node.props}`;
+      if (node.children) outputLine += `: ${node.children}`;
+    }
 
     output.push(outputLine);
   }