ai-dev-browser 0.9.2__tar.gz → 0.9.4__tar.gz

{ai_dev_browser-0.9.2 → ai_dev_browser-0.9.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-dev-browser
-Version: 0.9.2
+Version: 0.9.4
 Summary: A browser for AI to develop web automation — human-like automation that works seamlessly in a world designed for humans
 Author: sudoprivacy
 License: AGPL-3.0

{ai_dev_browser-0.9.2 → ai_dev_browser-0.9.4}/ai_dev_browser/core/browser.py

@@ -77,6 +77,7 @@ def browser_start(
     startup_timeout: float = 30.0,
     extra_args: list[str] | None = None,
     disable_default_args: list[str] | None = None,
+    silent_stderr: bool = False,
 ) -> dict:
     """Start or reuse a browser instance.
 
@@ -106,6 +107,12 @@ def browser_start(
             logic and what removing them costs (in particular,
             `--enable-automation` removal makes the Chrome invisible to
             `browser_list` workspace filter and `browser_cleanup`).
+        silent_stderr: If True, route Chrome's stderr to DEVNULL instead
+            of PIPE. Use in long-running / multi-agent scenarios where
+            you don't want Chrome's GPU/Crashpad/V8 subsystems filling
+            the pipe buffer. Trade-off: loses Chrome's exit-time stderr
+            in the error path (falls back to generic "Chrome exited
+            silently"). See `launch_chrome` docstring for details.
 
     Returns:
         dict with port, pid, headless, url, profile, reused, message
@@ -174,6 +181,7 @@ def browser_start(
         user_data_dir=str(user_data_dir) if user_data_dir else None,
         extra_args=extra_args,
         disable_default_args=disable_default_args,
+        silent_stderr=silent_stderr,
     )
 
     # Wait for Chrome to bind its debug port.

{ai_dev_browser-0.9.2 → ai_dev_browser-0.9.4}/ai_dev_browser/core/chrome.py

@@ -131,6 +131,7 @@ def launch_chrome(
     profile_prefix: str = DEFAULT_PROFILE_PREFIX,
     extra_args: list[str] | None = None,
     disable_default_args: list[str] | None = None,
+    silent_stderr: bool = False,
     start_url: str = "about:blank",
     disable_session_restore: bool = True,
     disable_session_crashed_bubble: bool = True,
@@ -148,6 +149,18 @@ def launch_chrome(
         user_data_dir: Custom user data directory. If None, creates a temp directory.
         profile_prefix: Prefix for temp profile directory name
         extra_args: Additional Chrome command-line arguments appended after defaults.
+        silent_stderr: If True, route Chrome's stderr to `subprocess.DEVNULL`
+            instead of `subprocess.PIPE`. Default False preserves current
+            behavior — `browser_start` captures Chrome's exit-time stderr
+            to surface in the "Chrome exited unexpectedly" error.
+
+            Set True in long-running multi-instance / multi-agent scenarios
+            where you don't need the diagnostic and want to avoid PIPE
+            buffer pressure from Chrome's GPU / Crashpad / V8 subsystems
+            (these subsystems ignore `--disable-logging` and emit
+            unconditional stderr). Trade-off: on a Chrome-exit-on-startup,
+            the error message falls back to the generic "Chrome exited
+            silently" wording with no captured detail.
         disable_default_args: List of default Chrome flags to remove before launch.
             Match is exact for `--flag` form and prefix-equality for `--flag=value`
             form (e.g. `["--enable-automation"]` strips both). Use this when a
@@ -261,16 +274,17 @@ def launch_chrome(
         # Use subprocess.Popen on all platforms
         # On Unix, use start_new_session to detach from parent
         # On Windows, CREATE_NEW_PROCESS_GROUP for similar isolation
+        stderr_target = subprocess.DEVNULL if silent_stderr else subprocess.PIPE
         if platform.system() == "Windows":
             popen_kwargs = {
                 "stdout": subprocess.DEVNULL,
-                "stderr": subprocess.PIPE,
+                "stderr": stderr_target,
                 "creationflags": subprocess.CREATE_NEW_PROCESS_GROUP,
             }
         else:
             popen_kwargs = {
                 "stdout": subprocess.DEVNULL,
-                "stderr": subprocess.PIPE,
+                "stderr": stderr_target,
                 "start_new_session": True,
             }
 

{ai_dev_browser-0.9.2 → ai_dev_browser-0.9.4}/ai_dev_browser/pool/job.py

@@ -96,7 +96,15 @@ class JobResult:
         job_id: ID of the job this result belongs to
         success: True if job completed without error
         data: Return value from the client method (JSON-serializable)
-        error: Error message if job failed
+        error: Error message if job failed (from `str(exception)`)
+        error_type: Exception class name if job failed (e.g.
+            `"GrokRateLimitError"`). Lets callers branch on exception
+            type without string-matching `error`. None on success.
+        error_bases: List of exception base-class names from the mro,
+            excluding `object` (e.g.
+            `["RateLimitError", "RuntimeError", "Exception"]`). Lets
+            callers match superclasses when the concrete type is
+            domain-specific but the base is standard. Empty on success.
         completed_at: Timestamp when job completed
         worker_id: ID of the worker that executed the job
 
@@ -107,15 +115,51 @@ class JobResult:
             data={"url": "https://example.com", "title": "Example"},
             worker_id=0,
         )
+
+        # Failure branching without text matching:
+        if not result.success:
+            if result.error_type == "GrokRateLimitError":
+                schedule_retry()
+            elif "TimeoutError" in result.error_bases:
+                ...
     """
 
     job_id: str
     success: bool
     data: Any = None
     error: str | None = None
+    error_type: str | None = None
+    error_bases: list[str] = field(default_factory=list)
     completed_at: datetime = field(default_factory=datetime.now)
     worker_id: int | None = None
 
+    @classmethod
+    def from_exception(
+        cls,
+        job_id: str,
+        exc: BaseException,
+        worker_id: int | None = None,
+    ) -> "JobResult":
+        """Build a failure result capturing the exception's type + mro.
+
+        Use inside worker exception handlers so callers downstream can
+        branch on `error_type` / `error_bases` without parsing
+        `error` text.
+        """
+        cls_chain = type(exc).__mro__
+        # mro ends with `object`; drop it. First element is the type
+        # itself, which we surface as `error_type`; the rest is bases.
+        error_type = cls_chain[0].__name__
+        error_bases = [c.__name__ for c in cls_chain[1:] if c is not object]
+        return cls(
+            job_id=job_id,
+            success=False,
+            error=str(exc),
+            error_type=error_type,
+            error_bases=error_bases,
+            worker_id=worker_id,
+        )
+
     def to_dict(self) -> dict:
         """Serialize result for persistence."""
         return {
@@ -123,6 +167,8 @@ class JobResult:
             "success": self.success,
             "data": self.data,
             "error": self.error,
+            "error_type": self.error_type,
+            "error_bases": self.error_bases,
             "completed_at": self.completed_at.isoformat(),
             "worker_id": self.worker_id,
         }
@@ -135,6 +181,8 @@ class JobResult:
             success=data["success"],
             data=data.get("data"),
             error=data.get("error"),
+            error_type=data.get("error_type"),
+            error_bases=data.get("error_bases") or [],
             completed_at=datetime.fromisoformat(data["completed_at"]),
             worker_id=data.get("worker_id"),
         )

{ai_dev_browser-0.9.2 → ai_dev_browser-0.9.4}/ai_dev_browser/pool/pool.py

@@ -697,7 +697,7 @@ class BrowserPool(Generic[ClientT]):
                         )
 
                 except Exception as e:
-                    await self._handle_job_failure(worker, job, str(e))
+                    await self._handle_job_failure(worker, job, str(e), exc=e)
 
                 finally:
                     worker.mark_idle()
@@ -709,8 +709,22 @@ class BrowserPool(Generic[ClientT]):
                 logger.error(f"Worker {worker.worker_id} loop error: {e}")
                 await asyncio.sleep(1)
 
-    async def _handle_job_failure(self, worker: Worker, job: Job, error: str) -> None:
-        """Handle job failure - retry or mark as failed."""
+    async def _handle_job_failure(
+        self,
+        worker: Worker,
+        job: Job,
+        error: str,
+        *,
+        exc: BaseException | None = None,
+    ) -> None:
+        """Handle job failure - retry or mark as failed.
+
+        If `exc` is provided (exception caught in the worker loop), the
+        terminal `JobResult` captures `error_type` + `error_bases` so
+        callers can branch on exception type without parsing `error`.
+        Non-exception failures (e.g. `fail_condition` triggered) pass
+        only `error` and the type fields stay None / [].
+        """
         job.retries += 1
         worker.stats.fail += 1
 
@@ -725,12 +739,19 @@ class BrowserPool(Generic[ClientT]):
                 f"({job.job_id[:8]}...), retry {job.retries}: {error}"
             )
         else:
-            result = JobResult(
-                job_id=job.job_id,
-                success=False,
-                error=error,
-                worker_id=worker.worker_id,
-            )
+            if exc is not None:
+                result = JobResult.from_exception(
+                    job_id=job.job_id,
+                    exc=exc,
+                    worker_id=worker.worker_id,
+                )
+            else:
+                result = JobResult(
+                    job_id=job.job_id,
+                    success=False,
+                    error=error,
+                    worker_id=worker.worker_id,
+                )
             self._results[job.job_id] = result
             self._pending_jobs.pop(job.job_id, None)
             job.status = JobStatus.FAILED

{ai_dev_browser-0.9.2 → ai_dev_browser-0.9.4}/ai_dev_browser.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-dev-browser
-Version: 0.9.2
+Version: 0.9.4
 Summary: A browser for AI to develop web automation — human-like automation that works seamlessly in a world designed for humans
 Author: sudoprivacy
 License: AGPL-3.0