@fastbrowse/darwin-x64 0.7.0 → 0.7.3

package/fastbrowse/_internal/fastbrowse/browser/snapshot.js

@@ -983,6 +983,41 @@
   readText(document, 0, 0);
   const viewport_text = words.join('\n');
 
+  // Page state carried by pixels: a chart, a picture, a drawing or a video is evidence the page text and the
+  // control list cannot hold, and the verifier needs the screenshot for it. Only what the viewport shows counts,
+  // because that is what a screenshot captures: an image below the fold cannot appear in it, and counting every
+  // image on a long page would ask for a screenshot on almost every page and undo the gate it exists to serve.
+  // Geometry is read in the parent's coordinates the way readText reads text, so a frame's image counts where the
+  // frame itself sits on screen. Elements small enough to be an icon or a rule are not page state.
+  const VISUAL = 'img,canvas,video,svg,picture,figure,[role="img"]';
+  const VISUAL_MIN_PX = 48;
+  let visual_content = 0;
+  const readVisual = (doc, dx, dy) => {
+    if (visual_content) return;
+    for (const e of doc.querySelectorAll(VISUAL)) {
+      if (e.closest('[aria-hidden="true"],[inert]') || !visible(e)) continue;
+      const r = e.getBoundingClientRect();
+      const top = r.top + dy,
+        left = r.left + dx;
+      if (r.width < VISUAL_MIN_PX || r.height < VISUAL_MIN_PX) continue;
+      if (top + r.height <= 0 || top >= innerHeight || left + r.width <= 0 || left >= innerWidth) continue;
+      visual_content = 1;
+      return;
+    }
+    for (const frame of doc.querySelectorAll('iframe,frame')) {
+      let inner = null;
+      try {
+        inner = frame.contentDocument;
+      } catch {
+        inner = null;
+      }
+      if (!inner || !granted(inner)) continue;
+      const f = frame.getBoundingClientRect();
+      readVisual(inner, dx + f.left + frame.clientLeft, dy + f.top + frame.clientTop);
+    }
+  };
+  readVisual(document, 0, 0);
+
   const guards = {},
     retarget_keys = {};
   for (const c of controls) {
@@ -1035,6 +1070,7 @@
     url: location.href,
     title: document.title,
     viewport_text,
+    visual_content,
     document_key: String(performance.timeOrigin),
     controls: semantics,
     page_key,

package/fastbrowse/_internal/{fastbrowse-0.7.0.dist-info → fastbrowse-0.7.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: fastbrowse
-Version: 0.7.0
+Version: 0.7.3
 Summary: Browser automation with cited answers, structured output and code-controlled credentials and authorization.
 Project-URL: Homepage, https://github.com/agent-labs-dev/fastbrowse
 Project-URL: Repository, https://github.com/agent-labs-dev/fastbrowse
@@ -133,6 +133,7 @@ Steps go to stderr; the status, cost, step count, the reason a run stopped short
 | `--start URL` | the page to open first; worked out from the task when omitted |
 | `--cloud` | force cloud Chrome even when `FASTBROWSE_PROFILE` or `FASTBROWSE_HEADED` is set |
 | `--local` | use local Chrome instead of a Browser Use Cloud browser. Cloud is the default: it passes bot checks a fresh Chrome fails, and prints a URL to watch the run live |
+| `--fetch` | read pages over HTTP and start no browser at all, for a task that only has to read one and needs no clicking, forms or screenshots |
 | `--headed` | show the local Chrome window (implies `--local`) |
 | `--profile DIR` | keep the local Chrome profile in `DIR`, so a site signed into there stays signed in (implies `--local`) |
 | `--cloud-profile ID` | run on a Browser Use Cloud profile, signed in as whoever set it up |
@@ -148,6 +149,7 @@ Steps go to stderr; the status, cost, step count, the reason a run stopped short
 | `--max-steps N`, `--max-dollars N` | optionally bound steps and model spend; defaults are unlimited. Cloud browser charges are added when it stops |
 | `--downloads DIR` | keep downloaded files |
 | `--json` | full result instead of the answer |
+| `--trace FILE` | append the run's trace to `FILE` as JSON lines, or `-` for stderr: each model call with its purpose and timing, which reader answered each read and why, every check's scores and each recovery's reason. It holds ids, scores, redacted addresses, requirement texts and control labels, not page captures. `FASTBROWSE_TRACE` does the same for `serve` and the MCP server |
 | `--record FILE` | save an MP4 of the tab, each step captioned, ending on the answer, time and cost (needs `ffmpeg`; the captions need its libass), e.g. `recordings/demo.mp4`, which git ignores; `demo.plain.mp4` beside it has no captions. It shows what the pages showed, so watch it before sharing |
 | `--cursor` | draw the agent's cursor over a visible Chrome (`--headed`, or one you attach to) with [Cua Driver](https://github.com/trycua/cua), so you can watch where it acts. Off by default. It needs `cua-driver` on `PATH` and an X11 display on Linux, and does nothing without them. It brings the run's tab to the front as `--foreground` does, since the cursor lies over the window's front tab |
 
@@ -296,7 +298,7 @@ without a field-writing generation.
 
 A browser command that remains unanswered for 120 seconds returns `unavailable`, even if the browser
 still answers health checks. Step and dollar limits do not bound total elapsed time. Set `Limits(max_seconds=...)` for a run deadline.
-When investigating a stalled run, enable trace logging and retain the last event alongside the result.
+When investigating a stalled run, write its trace with `--trace FILE` (or `FASTBROWSE_TRACE=FILE` for `serve` and the MCP server) and keep the last event alongside the result.
 
 [Troubleshooting](docs/troubleshooting.md) takes each status a run can stop with: what it means, its common
 causes and the next step.
@@ -420,7 +422,9 @@ it can be `None` for an ordinary successful action.
 
 For continuous live images, pass an async `on_frame` handler accepting JPEG bytes. Frames follow the active
 tab and are acknowledged after delivery, with no fixed frame rate. Only the latest pending frame is kept.
-Handler failures are logged without stopping the run. Live frames and recordings are held back while a
+Handler failures are logged without stopping the run. A handler must honour cancellation: it runs on the
+caller's event loop, so one that catches `CancelledError` without re-raising keeps that loop alive, and
+`asyncio.run` then waits for it at shutdown. Live frames and recordings are held back while a
 resolved secret may show on the page, as PNG step frames are. No handler means no live capture.
 
 Jev uses direct TypeSafe when keyed, otherwise OpenRouter, with Vercel AI Gateway also supported.

package/fastbrowse/_internal/fastbrowse-0.7.3.dist-info/RECORD

@@ -0,0 +1,14 @@
+../../../bin/fastbrowse,sha256=k_VHUJGUyyMLHeLCiSHLkBTLNP1m86q6e4YkyAHdlZM,337
+../../../bin/fastbrowse-mcp,sha256=1CAFjtHrbGFIoAzljudiwUZ-Qrz8WFq5CLTPaDEvGRE,344
+_editable_impl_fastbrowse.pth,sha256=Ft6bxdkTegROr5p9hZSxsnUSfEHrZYCfXWKjtpA4_DU,44
+fastbrowse-0.7.3.dist-info/INSTALLER,sha256=5hhM4Q4mYTT9z6QB6PGpUAW81PGNFrYrdXMj4oM_6ak,2
+fastbrowse-0.7.3.dist-info/METADATA,sha256=Z_DUoeZGMQEm7pT1232-a7PAplk6ABH_ZuR7iEp5IQ4,39344
+fastbrowse-0.7.3.dist-info/RECORD,,
+fastbrowse-0.7.3.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastbrowse-0.7.3.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+fastbrowse-0.7.3.dist-info/direct_url.json,sha256=cZGZY9ovdib3X-RhjHdlyO_0_EMUe0tW6AXsSyMbNE4,86
+fastbrowse-0.7.3.dist-info/entry_points.txt,sha256=SlQAK1_4_oywTAMckx8BYuCQJva0F-QuShQPcxtUm-g,95
+fastbrowse-0.7.3.dist-info/licenses/LICENSE,sha256=gcUazG_j5a2blKPmfKqRKE98KOqX2kPbWY-EOtQZiNU,1067
+fastbrowse-0.7.3.dist-info/licenses/NOTICE,sha256=qEO0Az_Tk98vRVL0xjnGYgMvexlMCA92lWl4JBwYRzg,1854
+fastbrowse-0.7.3.dist-info/uv_build.json,sha256=RBNvo1WzZ4oRRq0W9-hknpT7T8If536DEMBg9hyq_4o,2
+fastbrowse-0.7.3.dist-info/uv_cache.json,sha256=bfJjOgVYNmAssE2wY6VxsSPjCyA9EwKUgh1JNkmD3j8,194

package/fastbrowse/_internal/fastbrowse-0.7.3.dist-info/uv_cache.json

@@ -0,0 +1 @@
+{"timestamp":{"secs_since_epoch":1793030949,"nanos_since_epoch":899156616},"commit":null,"tags":null,"env":{},"directories":{"src":{"secs_since_epoch":1793030949,"nanos_since_epoch":974523249}}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fastbrowse/darwin-x64",
-  "version": "0.7.0",
+  "version": "0.7.3",
   "description": "The fastbrowse binary for macOS on x64.",
   "license": "MIT",
   "repository": {

package/fastbrowse/_internal/fastbrowse-0.7.0.dist-info/RECORD

@@ -1,14 +0,0 @@
-../../../bin/fastbrowse,sha256=k_VHUJGUyyMLHeLCiSHLkBTLNP1m86q6e4YkyAHdlZM,337
-../../../bin/fastbrowse-mcp,sha256=1CAFjtHrbGFIoAzljudiwUZ-Qrz8WFq5CLTPaDEvGRE,344
-_editable_impl_fastbrowse.pth,sha256=Ft6bxdkTegROr5p9hZSxsnUSfEHrZYCfXWKjtpA4_DU,44
-fastbrowse-0.7.0.dist-info/INSTALLER,sha256=5hhM4Q4mYTT9z6QB6PGpUAW81PGNFrYrdXMj4oM_6ak,2
-fastbrowse-0.7.0.dist-info/METADATA,sha256=7vV9jxG0yGiwE2e_oimnIrnEMsrz3D7N5w-HlzvCHiQ,38538
-fastbrowse-0.7.0.dist-info/RECORD,,
-fastbrowse-0.7.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fastbrowse-0.7.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-fastbrowse-0.7.0.dist-info/direct_url.json,sha256=cZGZY9ovdib3X-RhjHdlyO_0_EMUe0tW6AXsSyMbNE4,86
-fastbrowse-0.7.0.dist-info/entry_points.txt,sha256=SlQAK1_4_oywTAMckx8BYuCQJva0F-QuShQPcxtUm-g,95
-fastbrowse-0.7.0.dist-info/licenses/LICENSE,sha256=gcUazG_j5a2blKPmfKqRKE98KOqX2kPbWY-EOtQZiNU,1067
-fastbrowse-0.7.0.dist-info/licenses/NOTICE,sha256=qEO0Az_Tk98vRVL0xjnGYgMvexlMCA92lWl4JBwYRzg,1854
-fastbrowse-0.7.0.dist-info/uv_build.json,sha256=RBNvo1WzZ4oRRq0W9-hknpT7T8If536DEMBg9hyq_4o,2
-fastbrowse-0.7.0.dist-info/uv_cache.json,sha256=8BhBXAm2DwdjSnwjuOCkWHT-R2Ao19iV1lD5LiBS9bY,194

package/fastbrowse/_internal/fastbrowse-0.7.0.dist-info/uv_cache.json

@@ -1 +0,0 @@
-{"timestamp":{"secs_since_epoch":1792857031,"nanos_since_epoch":325702513},"commit":null,"tags":null,"env":{},"directories":{"src":{"secs_since_epoch":1792857031,"nanos_since_epoch":333003188}}}