@nuanu-ai/agentbrowse 0.2.5 → 0.2.7

package/dist/commands/act.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../src/commands/act.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAsB,GAAG,CACvB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CA0Bf"}
+{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../src/commands/act.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoCH,wBAAsB,GAAG,CACvB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/commands/act.js

@@ -3,28 +3,71 @@
  */
 import { connectStagehand, getPageInfo } from '../stagehand.js';
 import { outputJSON, outputError } from '../output.js';
+const ROOT_SELECTORS = new Set(['/', '/html', 'xpath=/', 'xpath=/html']);
+const CONCRETE_TARGET_METHODS = new Set([
+    'click',
+    'doubleClick',
+    'fill',
+    'type',
+    'hover',
+    'dragAndDrop',
+    'selectOption',
+    'selectOptionFromDropdown',
+    'clickAndHold',
+]);
+// Stagehand's act prompt says "return an empty object" when no element matches,
+// but its act schema requires a concrete elementId/method pair. In practice,
+// that contradiction sometimes produces a synthetic page-root action
+// (`xpath=/html`) which Playwright accepts as a successful no-op click/type.
+function isSyntheticRootSuccess(result) {
+    if (!result.success || !Array.isArray(result.actions) || result.actions.length === 0) {
+        return false;
+    }
+    const [firstAction] = result.actions;
+    const selector = firstAction?.selector?.trim();
+    const method = firstAction?.method?.trim();
+    return ROOT_SELECTORS.has(selector ?? '') && CONCRETE_TARGET_METHODS.has(method ?? '');
+}
 export async function act(cdpUrl, instruction, variables) {
     let stagehand;
+    let url = 'unknown';
+    let title = 'unknown';
+    let failureMessage = null;
     try {
         stagehand = await connectStagehand(cdpUrl);
     }
     catch (err) {
-        outputError(`Failed to connect to browser: ${err instanceof Error ? err.message : String(err)}`);
+        return outputError(`Failed to connect to browser: ${err instanceof Error ? err.message : String(err)}`);
     }
     try {
         const result = await stagehand.act(instruction, variables ? { variables } : undefined);
-        const { url, title } = await getPageInfo(stagehand);
+        ({ url, title } = await getPageInfo(stagehand));
         await stagehand.close();
-        outputJSON({
-            success: result.success,
-            action: result.actionDescription ?? instruction,
-            message: result.message,
-            url,
-            title,
-        });
+        if (isSyntheticRootSuccess(result)) {
+            failureMessage =
+                `Act failed: Stagehand selected the page root instead of a concrete element. ` +
+                    `This usually means no actionable match was found for: ${instruction} ` +
+                    `(page: ${title} — ${url})`;
+        }
+        else if (!result.success) {
+            const message = typeof result.message === 'string' && result.message.trim().length > 0
+                ? result.message.trim()
+                : `Stagehand could not complete the requested action: ${instruction}`;
+            failureMessage = `Act failed: ${message} (page: ${title} — ${url})`;
+        }
+        else {
+            return outputJSON({
+                success: true,
+                action: result.actionDescription ?? instruction,
+                message: result.message,
+                url,
+                title,
+            });
+        }
     }
     catch (err) {
         await stagehand.close();
-        outputError(`Act failed: ${err instanceof Error ? err.message : String(err)}`);
+        failureMessage = `Act failed: ${err instanceof Error ? err.message : String(err)} (page: ${title} — ${url})`;
     }
+    return outputError(failureMessage ?? `Act failed: Stagehand could not complete the requested action: ${instruction}`);
 }

package/dist/commands/observe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/commands/observe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCjF"}
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/commands/observe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCjF"}

package/dist/commands/observe.js

@@ -19,6 +19,7 @@ export async function observe(cdpUrl, instruction) {
         await stagehand.close();
         outputJSON({
             success: true,
+            message: actions.length === 0 ? 'No actions found by Stagehand observe.' : undefined,
             actions: actions.map((a) => ({
                 description: a.description,
                 selector: a.selector,

package/dist/output.js

@@ -10,7 +10,7 @@ function formatValue(value) {
 /** Write result to stdout and exit. Errors go to stderr with exit 1. */
 export function outputJSON(result) {
     if (!result.success) {
-        process.stderr.write(`${result.error}\n`);
+        process.stderr.write(`${result.error ?? 'Unknown error'}\n`);
         process.exit(1);
     }
     const { success: _, ...rest } = result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuanu-ai/agentbrowse",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "type": "module",
   "description": "Standalone browser automation CLI for AI agents: launch, observe, act, extract, and solve captcha",
   "keywords": [