open-agents-ai 0.187.572 → 0.187.574

package/dist/index.js

@@ -3800,7 +3800,7 @@ var init_web_fetch = __esm({
     WebFetchTool = class {
       name = "web_fetch";
       _fetchCache = /* @__PURE__ */ new Map();
-      description = "Fetch a single web page and return its text content (HTML stripped to plain text). FASTEST web tool — use this for reading any single URL: documentation, articles, README files, API references, Stack Overflow answers. Limitations: no JavaScript rendering (SPAs/React apps return empty), no link following, no cookies/auth, no structured data extraction. If the page is blank or incomplete, switch to web_crawl with strategy='playwright'. For scraping/extracting structured data (prices, listings, tables), use web_crawl instead. For search engine queries, use web_search instead. For interactive browser sessions (login, form filling, clicking), use browser_action instead.";
+      description = "Fetch a single web page and return its text content (HTML stripped to plain text). FASTEST web tool — use this for reading any single URL: documentation, articles, README files, API references, Stack Overflow answers. Limitations: no JavaScript rendering (SPAs/React apps return empty), no link following, no cookies/auth, no structured data extraction. On timeout, automatically falls back to browser_action (headless Chrome) for slow/heavy pages. If the page is blank or incomplete, switch to web_crawl with strategy='playwright'. For scraping/extracting structured data (prices, listings, tables), use web_crawl instead. For search engine queries, use web_search instead. For interactive browser sessions (login, form filling, clicking), use browser_action instead.";
       parameters = {
         type: "object",
         properties: {
@@ -3869,12 +3869,105 @@ var init_web_fetch = __esm({
             durationMs: performance.now() - start2
           };
         } catch (error) {
+          const errMsg = error instanceof Error ? error.message : String(error);
+          if (/abort|timeout/i.test(errMsg)) {
+            const fallback = await this.#hydraFallback(url, maxLength, start2);
+            if (fallback)
+              return fallback;
+          }
           return {
             success: false,
             output: "",
-            error: error instanceof Error ? error.message : String(error),
+            error: errMsg,
+            durationMs: performance.now() - start2
+          };
+        }
+      }
+      /** Fallback: use Hydra Chrome automation service (web-scrape-service on :8130)
+       *  when the HTTP fetch times out. Navigates with a real headless browser
+       *  so slow/heavy/JS pages render fully. Returns null if the service is
+       *  unavailable or any step fails — the original timeout error propagates. */
+      async #hydraFallback(url, maxLength, start2) {
+        const BASE = "http://localhost:8130";
+        try {
+          const health = await fetch(`${BASE}/health`, {
+            signal: AbortSignal.timeout(2e3)
+          });
+          if (!health.ok)
+            return null;
+        } catch {
+          return null;
+        }
+        try {
+          const sessionRes = await fetch(`${BASE}/session/start`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ headless: true }),
+            signal: AbortSignal.timeout(1e4)
+          });
+          const sessionData = await sessionRes.json();
+          if (!sessionData.ok || !sessionData.session_id)
+            return null;
+          const sid = sessionData.session_id;
+          const navRes = await fetch(`${BASE}/navigate`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ sid, url }),
+            signal: AbortSignal.timeout(6e4)
+          });
+          const navData = await navRes.json();
+          if (!navData.ok) {
+            fetch(`${BASE}/session/close`, {
+              method: "POST",
+              headers: { "Content-Type": "application/json" },
+              body: JSON.stringify({ sid })
+            }).catch(() => {
+            });
+            return null;
+          }
+          const domRes = await fetch(`${BASE}/dom?sid=${encodeURIComponent(sid)}`, {
+            signal: AbortSignal.timeout(3e4)
+          });
+          const domData = await domRes.json();
+          if (!domData.ok) {
+            fetch(`${BASE}/session/close`, {
+              method: "POST",
+              headers: { "Content-Type": "application/json" },
+              body: JSON.stringify({ sid })
+            }).catch(() => {
+            });
+            return null;
+          }
+          const dom = domData.dom;
+          if (!dom || dom.length < 50) {
+            fetch(`${BASE}/session/close`, {
+              method: "POST",
+              headers: { "Content-Type": "application/json" },
+              body: JSON.stringify({ sid })
+            }).catch(() => {
+            });
+            return null;
+          }
+          fetch(`${BASE}/session/close`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ sid })
+          }).catch(() => {
+          });
+          const text = this.#stripHtml(dom);
+          this._fetchCache.set(url, { text, fetchedAt: Date.now() });
+          const truncated = text.length > maxLength;
+          return {
+            success: true,
+            output: `[Hydra fallback: HTTP fetch timed out, retrieved via Chrome browser]
+
+` + (truncated ? `${text.slice(0, maxLength)}
+
+[Content truncated to ${maxLength} characters]` : text),
             durationMs: performance.now() - start2
           };
+        } catch {
+          return null;
         }
       }
       #stripHtml(html) {
@@ -16769,19 +16862,36 @@ function isYouTubeUrl(url) {
   return /(?:youtube\.com\/(?:watch|shorts|live|embed|v\/)|youtu\.be\/)/i.test(url);
 }
 function ensureYtDlp() {
-  try {
-    execSync13("yt-dlp --version", { timeout: 5e3, stdio: "pipe" });
-    return true;
-  } catch {
+  if (_ytDlpPath)
+    return _ytDlpPath;
+  const isWin2 = process.platform === "win32";
+  const venvDir = join27(homedir8(), ".open-agents", "venv");
+  const pipPath = isWin2 ? join27(venvDir, "Scripts", "pip.exe") : join27(venvDir, "bin", "pip");
+  const ytDlpPath = isWin2 ? join27(venvDir, "Scripts", "yt-dlp.exe") : join27(venvDir, "bin", "yt-dlp");
+  if (!existsSync22(pipPath)) {
     try {
-      execSync13("pip3 install --user yt-dlp 2>/dev/null || pip install --user yt-dlp 2>/dev/null", {
-        timeout: 6e4,
+      mkdirSync9(join27(homedir8(), ".open-agents"), { recursive: true });
+      execSync13(`python3 -m venv "${venvDir}"`, {
+        timeout: 3e4,
         stdio: "pipe"
       });
-      return true;
     } catch {
-      return false;
+      return null;
+    }
+  }
+  try {
+    execSync13(`"${pipPath}" install -U yt-dlp 2>&1`, {
+      timeout: 6e4,
+      stdio: "pipe"
+    });
+    _ytDlpPath = ytDlpPath;
+    return ytDlpPath;
+  } catch {
+    if (existsSync22(ytDlpPath)) {
+      _ytDlpPath = ytDlpPath;
+      return ytDlpPath;
     }
+    return null;
   }
 }
 function formatTime(seconds) {
@@ -16789,7 +16899,7 @@ function formatTime(seconds) {
   const s2 = Math.floor(seconds % 60);
   return `${String(m2).padStart(2, "0")}:${String(s2).padStart(2, "0")}`;
 }
-var AUDIO_EXTS, VIDEO_EXTS, _tcModule, _tcChecked, TranscribeFileTool, TranscribeUrlTool, YouTubeDownloadTool;
+var AUDIO_EXTS, VIDEO_EXTS, _tcModule, _tcChecked, TranscribeFileTool, _ytDlpPath, TranscribeUrlTool, YouTubeDownloadTool;
 var init_transcribe_tool = __esm({
   "packages/execution/dist/tools/transcribe-tool.js"() {
     "use strict";
@@ -16986,9 +17096,10 @@ var init_transcribe_tool = __esm({
         }
       }
     };
+    _ytDlpPath = null;
     TranscribeUrlTool = class {
       name = "transcribe_url";
-      description = "Download and transcribe audio/video from a URL. Supports YouTube links (youtube.com/watch?v=..., youtu.be/...) and direct media URLs (MP3, WAV, MP4, etc.). YouTube audio is extracted via yt-dlp (auto-installed). Transcription is local via faster-whisper (no cloud API).";
+      description = "Download and transcribe audio/video from a URL. Supports YouTube links (youtube.com/watch?v=..., youtu.be/...) and direct media URLs (MP3, WAV, MP4, etc.). YouTube audio is extracted via yt-dlp (shared venv at ~/.open-agents/venv/). If yt-dlp gets YouTube 403 errors, the tool auto-upgrades it. Transcription is local via faster-whisper (no cloud API).";
       parameters = {
         type: "object",
         properties: {
@@ -17026,17 +17137,18 @@ var init_transcribe_tool = __esm({
         let tmpFile = "";
         try {
           if (isYouTubeUrl(url)) {
-            if (!ensureYtDlp()) {
+            const ytDlp = ensureYtDlp();
+            if (!ytDlp) {
               return {
                 success: false,
                 output: "",
-                error: "yt-dlp not found and auto-install failed. Install manually: pip3 install yt-dlp",
+                error: "yt-dlp not available via shared venv. Run: python3 -m venv ~/.open-agents/venv && ~/.open-agents/venv/bin/pip install yt-dlp",
                 durationMs: performance.now() - start2
               };
             }
             tmpFile = `${tmpBase}.mp3`;
             try {
-              execSync13(`yt-dlp -x --audio-format mp3 --audio-quality 5 -o "${tmpBase}.%(ext)s" "${url}" 2>&1`, { timeout: 3e5, stdio: ["pipe", "pipe", "pipe"] });
+              execSync13(`"${ytDlp}" -x --audio-format mp3 --audio-quality 5 -o "${tmpBase}.%(ext)s" "${url}" 2>&1`, { timeout: 3e5, stdio: ["pipe", "pipe", "pipe"] });
               if (!existsSync22(tmpFile)) {
                 const { readdirSync: rd } = __require("node:fs");
                 const files = rd(tmpDir).filter((f2) => f2.startsWith(`download-`) && f2 !== ".gitkeep");
@@ -17046,10 +17158,11 @@ var init_transcribe_tool = __esm({
               }
             } catch (dlErr) {
               const errMsg = dlErr instanceof Error ? dlErr.message : String(dlErr);
+              const upgradeHint = errMsg.includes("403") ? " YouTube 403 error — yt-dlp was auto-upgraded. Retry; if the issue persists, the video may be region-restricted." : " Is the video available and not age-restricted?";
               return {
                 success: false,
                 output: "",
-                error: `yt-dlp failed: ${errMsg.slice(0, 200)}. Is the video available and not age-restricted?`,
+                error: `yt-dlp failed: ${errMsg.slice(0, 200)}.${upgradeHint}`,
                 durationMs: performance.now() - start2
               };
             }
@@ -17109,7 +17222,7 @@ ${result.output}`,
     };
     YouTubeDownloadTool = class {
       name = "youtube_download";
-      description = "Download video or audio from YouTube. Saves mp4 (video) or mp3 (audio) to the working directory. Uses yt-dlp (auto-installed). Supports youtube.com/watch, youtu.be, shorts, live URLs.";
+      description = "Download video or audio from YouTube. Saves mp4 (video), mp3, or wav (audio) to the working directory. Uses yt-dlp (auto-upgraded to fix YouTube 403 errors) and ffmpeg internally for audio conversion. If you get YouTube 403 errors, the tool auto-upgrades yt-dlp. For ffmpeg-based processing (cutting, segmenting, concatenating), download wav format which is raw PCM suitable for shell ffmpeg pipelines. Supports youtube.com/watch, youtu.be, shorts, live URLs.";
       parameters = {
         type: "object",
         properties: {
@@ -17119,8 +17232,8 @@ ${result.output}`,
           },
           format: {
             type: "string",
-            enum: ["mp3", "mp4"],
-            description: "Output format: 'mp3' for audio only, 'mp4' for video (default: mp3)"
+            enum: ["mp3", "mp4", "wav"],
+            description: "Output format: 'mp3' (compressed audio), 'wav' (raw PCM — use for ffmpeg segmentation), 'mp4' (video). Default: mp3"
           },
           output_dir: {
             type: "string",
@@ -17139,25 +17252,44 @@ ${result.output}`,
         const format3 = String(args.format ?? "mp3").toLowerCase();
         const outputDir = String(args.output_dir ?? this.workingDir);
         if (!url) {
-          return { success: false, output: "", error: "URL is required", durationMs: Date.now() - start2 };
+          return {
+            success: false,
+            output: "",
+            error: "URL is required",
+            durationMs: Date.now() - start2
+          };
         }
         if (!isYouTubeUrl(url)) {
-          return { success: false, output: "", error: "Not a recognized YouTube URL. Supported: youtube.com/watch, youtu.be, shorts, live, embed", durationMs: Date.now() - start2 };
+          return {
+            success: false,
+            output: "",
+            error: "Not a recognized YouTube URL. Supported: youtube.com/watch, youtu.be, shorts, live, embed",
+            durationMs: Date.now() - start2
+          };
         }
-        if (!ensureYtDlp()) {
-          return { success: false, output: "", error: "yt-dlp not available and auto-install failed. Install manually: pip install yt-dlp", durationMs: Date.now() - start2 };
+        const ytDlp = ensureYtDlp();
+        if (!ytDlp) {
+          return {
+            success: false,
+            output: "",
+            error: "yt-dlp not available via shared venv. Run: python3 -m venv ~/.open-agents/venv && ~/.open-agents/venv/bin/pip install yt-dlp",
+            durationMs: Date.now() - start2
+          };
         }
         mkdirSync9(outputDir, { recursive: true });
         try {
           let title = "download";
           try {
-            title = execSync13(`yt-dlp --get-title "${url}"`, { timeout: 15e3, stdio: "pipe" }).toString().trim().replace(/[<>:"/\\|?*]/g, "_").slice(0, 100);
+            title = execSync13(`"${ytDlp}" --get-title "${url}"`, {
+              timeout: 15e3,
+              stdio: "pipe"
+            }).toString().trim().replace(/[<>:"/\\|?*]/g, "_").slice(0, 100);
           } catch {
           }
           if (format3 === "mp4") {
             const outPath = join27(outputDir, `${title}.mp4`);
             const outTemplate = join27(outputDir, `${title}.%(ext)s`);
-            execSync13(`yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" --merge-output-format mp4 -o "${outTemplate}" "${url}"`, { timeout: 6e5, stdio: "pipe", cwd: outputDir });
+            execSync13(`"${ytDlp}" -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" --merge-output-format mp4 -o "${outTemplate}" "${url}"`, { timeout: 6e5, stdio: "pipe", cwd: outputDir });
             const actualPath = existsSync22(outPath) ? outPath : outTemplate.replace("%(ext)s", "mp4");
             return {
               success: true,
@@ -17166,11 +17298,23 @@ Title: ${title}
 Format: mp4`,
               durationMs: Date.now() - start2
             };
+          } else if (format3 === "wav") {
+            const outPath = join27(outputDir, `${title}.wav`);
+            const outTemplate = join27(outputDir, `${title}.%(ext)s`);
+            execSync13(`"${ytDlp}" -x --audio-format wav --audio-quality 0 -o "${outTemplate}" "${url}"`, { timeout: 6e5, stdio: "pipe", cwd: outputDir });
+            const actualPath = existsSync22(outPath) ? outPath : outTemplate.replace("%(ext)s", "wav");
+            return {
+              success: true,
+              output: `Downloaded audio: ${actualPath}
+Title: ${title}
+Format: wav`,
+              durationMs: Date.now() - start2
+            };
           } else {
             const outPath = join27(outputDir, `${title}.mp3`);
             const outTemplate = join27(outputDir, `${title}.%(ext)s`);
-            execSync13(`yt-dlp -x --audio-format mp3 --audio-quality 0 -o "${outTemplate}" "${url}"`, { timeout: 6e5, stdio: "pipe", cwd: outputDir });
-            const actualPath = existsSync22(outPath) ? outPath : outTemplate.replace("%(ext)s", "mp3");
+            execSync13(`"${ytDlp}" -x --audio-format mp3 --audio-quality 0 -o "${outTemplate}" "${url}"`, { timeout: 6e5, stdio: "pipe", cwd: outputDir });
+            const actualPath = existsSync22(outPath) ? outPath : outTemplate.replace("%(ext)s)", "mp3");
             return {
               success: true,
               output: `Downloaded audio: ${actualPath}
@@ -252456,7 +252600,9 @@ async function probeService() {
   try {
     const controller = new AbortController();
     const timeout2 = setTimeout(() => controller.abort(), 3e3);
-    const res = await fetch(`${BASE_URL}/health`, { signal: controller.signal });
+    const res = await fetch(`${BASE_URL}/health`, {
+      signal: controller.signal
+    });
     clearTimeout(timeout2);
     return res.ok;
   } catch {
@@ -252466,7 +252612,10 @@ async function probeService() {
 function findPython3() {
   for (const cmd of ["python3", "python"]) {
     try {
-      const ver = execSync19(`${cmd} --version 2>&1`, { stdio: "pipe", timeout: 5e3 }).toString().trim();
+      const ver = execSync19(`${cmd} --version 2>&1`, {
+        stdio: "pipe",
+        timeout: 5e3
+      }).toString().trim();
       if (ver.includes("Python 3"))
         return cmd;
     } catch {
@@ -252538,7 +252687,10 @@ async function ensureSession() {
   });
   const data = await res.json();
   if (!data.ok)
-    return { error: String(data.message ?? "Failed to start browser session"), sessionId: "" };
+    return {
+      error: String(data.message ?? "Failed to start browser session"),
+      sessionId: ""
+    };
   activeSessionId = data.session_id;
   return { sessionId: activeSessionId };
 }
@@ -252684,7 +252836,22 @@ var init_browser_action = __esm({
         properties: {
           action: {
             type: "string",
-            enum: ["navigate", "click", "click_xy", "type", "screenshot", "dom", "dom_summary", "vision_click", "scroll", "scroll_up", "scroll_down", "back", "forward", "close"],
+            enum: [
+              "navigate",
+              "click",
+              "click_xy",
+              "type",
+              "screenshot",
+              "dom",
+              "dom_summary",
+              "vision_click",
+              "scroll",
+              "scroll_up",
+              "scroll_down",
+              "back",
+              "forward",
+              "close"
+            ],
             description: "Browser action to perform. Key actions:\n- 'dom_summary': compact view of interactive elements (~1KB vs 200KB raw DOM)\n- 'vision_click': screenshot the page, use Moondream vision to find an element by description, then click it. Pass the element description in 'text' parameter (e.g. text='the login button'). This is the visual grounding loop from SeeAct.\n- 'click': click by CSS selector (fastest when you know the selector)\n- 'click_xy': click at pixel coordinates (when you have exact coords)"
           },
           url: {
@@ -252714,12 +252881,44 @@ var init_browser_action = __esm({
         },
         required: ["action"]
       };
+      /** TASK-CLEANUP: gracefully close the browser session when the task completes. */
+      async cleanup() {
+        if (activeSessionId) {
+          try {
+            const res = await fetch(`${BASE_URL}/session/close`, {
+              method: "POST",
+              headers: { "Content-Type": "application/json" },
+              body: JSON.stringify({ sid: activeSessionId }),
+              signal: AbortSignal.timeout(5e3)
+            });
+            await res.json();
+          } catch {
+          }
+          activeSessionId = null;
+        }
+        if (serviceProcess && serviceProcess.pid && !serviceProcess.killed) {
+          try {
+            process.kill(-serviceProcess.pid, "SIGKILL");
+          } catch {
+          }
+          try {
+            serviceProcess.kill("SIGKILL");
+          } catch {
+          }
+          serviceProcess = null;
+        }
+      }
       async execute(args) {
         const start2 = Date.now();
         const action = args.action;
         const launchErr = await launchService();
         if (launchErr) {
-          return { success: false, output: "", error: launchErr, durationMs: Date.now() - start2 };
+          return {
+            success: false,
+            output: "",
+            error: launchErr,
+            durationMs: Date.now() - start2
+          };
         }
         if (action === "close") {
           if (activeSessionId) {
@@ -252729,21 +252928,41 @@ var init_browser_action = __esm({
             }
             activeSessionId = null;
           }
-          return { success: true, output: "Browser session closed.", durationMs: Date.now() - start2 };
+          return {
+            success: true,
+            output: "Browser session closed.",
+            durationMs: Date.now() - start2
+          };
         }
         const session = await ensureSession();
         if (session.error) {
-          return { success: false, output: "", error: session.error, durationMs: Date.now() - start2 };
+          return {
+            success: false,
+            output: "",
+            error: session.error,
+            durationMs: Date.now() - start2
+          };
         }
         try {
           let result;
           switch (action) {
             case "navigate": {
               if (!args.url)
-                return { success: false, output: "", error: "url is required for navigate action", durationMs: Date.now() - start2 };
-              result = await apiCall("/navigate", "POST", { url: args.url });
+                return {
+                  success: false,
+                  output: "",
+                  error: "url is required for navigate action",
+                  durationMs: Date.now() - start2
+                };
+              result = await apiCall("/navigate", "POST", {
+                url: args.url
+              });
               if (result.ok) {
-                return { success: true, output: `Navigated to ${args.url}`, durationMs: Date.now() - start2 };
+                return {
+                  success: true,
+                  output: `Navigated to ${args.url}`,
+                  durationMs: Date.now() - start2
+                };
               }
               const navMsg = String(result.message ?? "Navigation failed");
               const navHint = navMsg.toLowerCase().includes("connection") || navMsg.toLowerCase().includes("refused") || navMsg.toLowerCase().includes("err_connection") ? " (the URL appears unreachable — check if the target server is running and accepting connections)" : navMsg.toLowerCase().includes("timeout") ? " (page load timed out — try again or use a different URL)" : "";
@@ -252756,10 +252975,21 @@ var init_browser_action = __esm({
             }
             case "click": {
               if (!args.selector)
-                return { success: false, output: "", error: "selector is required for click action", durationMs: Date.now() - start2 };
-              result = await apiCall("/click", "POST", { selector: args.selector });
+                return {
+                  success: false,
+                  output: "",
+                  error: "selector is required for click action",
+                  durationMs: Date.now() - start2
+                };
+              result = await apiCall("/click", "POST", {
+                selector: args.selector
+              });
               if (result.ok) {
-                return { success: true, output: `Clicked element: ${args.selector}`, durationMs: Date.now() - start2 };
+                return {
+                  success: true,
+                  output: `Clicked element: ${args.selector}`,
+                  durationMs: Date.now() - start2
+                };
               }
               const clickMsg = String(result.message ?? "Click failed");
               return {
@@ -252771,10 +253001,19 @@ var init_browser_action = __esm({
             }
             case "click_xy": {
               if (args.x == null || args.y == null)
-                return { success: false, output: "", error: "x and y are required for click_xy action", durationMs: Date.now() - start2 };
+                return {
+                  success: false,
+                  output: "",
+                  error: "x and y are required for click_xy action",
+                  durationMs: Date.now() - start2
+                };
               result = await apiCall("/click_xy", "POST", { x: args.x, y: args.y });
               if (result.ok) {
-                return { success: true, output: `Clicked at (${args.x}, ${args.y})`, durationMs: Date.now() - start2 };
+                return {
+                  success: true,
+                  output: `Clicked at (${args.x}, ${args.y})`,
+                  durationMs: Date.now() - start2
+                };
               }
               const xyMsg = String(result.message ?? "Click failed");
               return {
@@ -252786,10 +253025,22 @@ var init_browser_action = __esm({
             }
             case "type": {
               if (!args.selector || !args.text)
-                return { success: false, output: "", error: "selector and text are required for type action", durationMs: Date.now() - start2 };
-              result = await apiCall("/type", "POST", { selector: args.selector, text: args.text });
+                return {
+                  success: false,
+                  output: "",
+                  error: "selector and text are required for type action",
+                  durationMs: Date.now() - start2
+                };
+              result = await apiCall("/type", "POST", {
+                selector: args.selector,
+                text: args.text
+              });
               if (result.ok) {
-                return { success: true, output: `Typed "${args.text.slice(0, 50)}" into ${args.selector}`, durationMs: Date.now() - start2 };
+                return {
+                  success: true,
+                  output: `Typed "${args.text.slice(0, 50)}" into ${args.selector}`,
+                  durationMs: Date.now() - start2
+                };
               }
               const typeMsg = String(result.message ?? "Type failed");
               return {
@@ -252837,16 +253088,30 @@ var init_browser_action = __esm({
                   durationMs: Date.now() - start2
                 };
               }
-              return { success: false, output: "", error: "Screenshot failed", durationMs: Date.now() - start2 };
+              return {
+                success: false,
+                output: "",
+                error: "Screenshot failed",
+                durationMs: Date.now() - start2
+              };
             }
             case "dom": {
               result = await apiCall("/dom", "GET");
               const dom = result.dom;
               if (dom) {
                 const truncated = dom.length > 5e4 ? dom.slice(0, 5e4) + "\n... (truncated)" : dom;
-                return { success: true, output: truncated, durationMs: Date.now() - start2 };
+                return {
+                  success: true,
+                  output: truncated,
+                  durationMs: Date.now() - start2
+                };
               }
-              return { success: false, output: "", error: "DOM capture failed", durationMs: Date.now() - start2 };
+              return {
+                success: false,
+                output: "",
+                error: "DOM capture failed",
+                durationMs: Date.now() - start2
+              };
             }
             // dom_summary: Research-grounded DOM downsampling
             // Paper: AgentOccam (arXiv:2410.13825, ICLR 2025) — pivotal node extraction
@@ -252860,9 +253125,18 @@ var init_browser_action = __esm({
               result = await apiCall("/dom", "GET");
               const rawDom = result.dom;
               if (!rawDom)
-                return { success: false, output: "", error: "DOM capture failed", durationMs: Date.now() - start2 };
+                return {
+                  success: false,
+                  output: "",
+                  error: "DOM capture failed",
+                  durationMs: Date.now() - start2
+                };
               const summary = downsampleDom(rawDom);
-              return { success: true, output: summary, durationMs: Date.now() - start2 };
+              return {
+                success: true,
+                output: summary,
+                durationMs: Date.now() - start2
+              };
             }
             // vision_click: Screenshot → Moondream point detection → Click
             // Paper: SeeAct (arXiv:2401.01614) — visual grounding for web agents
@@ -252875,14 +253149,24 @@ var init_browser_action = __esm({
             case "vision_click": {
               const target = args.text;
               if (!target)
-                return { success: false, output: "", error: "text parameter is required for vision_click — describe what to click (e.g. 'the login button')", durationMs: Date.now() - start2 };
+                return {
+                  success: false,
+                  output: "",
+                  error: "text parameter is required for vision_click — describe what to click (e.g. 'the login button')",
+                  durationMs: Date.now() - start2
+                };
               const ssResult = await apiCall("/screenshot", "GET");
               const ssB64 = ssResult.b64;
               const ssWidth = ssResult.width || 1280;
               const ssHeight = ssResult.height || 720;
               const ssFile = ssResult.file;
               if (!ssB64 && !ssFile) {
-                return { success: false, output: "", error: "Screenshot failed — cannot perform vision click", durationMs: Date.now() - start2 };
+                return {
+                  success: false,
+                  output: "",
+                  error: "Screenshot failed — cannot perform vision click",
+                  durationMs: Date.now() - start2
+                };
               }
               let imagePath = "";
               if (ssFile) {
@@ -252894,7 +253178,12 @@ var init_browser_action = __esm({
                   wfs(tmpPath, fileBuffer);
                   imagePath = tmpPath;
                 } catch (e2) {
-                  return { success: false, output: "", error: `Failed to save screenshot: ${e2}`, durationMs: Date.now() - start2 };
+                  return {
+                    success: false,
+                    output: "",
+                    error: `Failed to save screenshot: ${e2}`,
+                    durationMs: Date.now() - start2
+                  };
                 }
               } else if (ssB64) {
                 const tmpPath = join41(process.env["TMPDIR"] || "/tmp", `oa-vision-click-${Date.now()}.png`);
@@ -252912,7 +253201,12 @@ var init_browser_action = __esm({
                   prompt: target
                 });
                 if (!visionResult.success) {
-                  return { success: false, output: `Vision could not find "${target}" on the page. Try using dom_summary to find the CSS selector instead.`, error: visionResult.error, durationMs: Date.now() - start2 };
+                  return {
+                    success: false,
+                    output: `Vision could not find "${target}" on the page. Try using dom_summary to find the CSS selector instead.`,
+                    error: visionResult.error,
+                    durationMs: Date.now() - start2
+                  };
                 }
                 const coordMatch = visionResult.output.match(/\((\d+\.?\d*),\s*(\d+\.?\d*)\)/);
                 if (coordMatch) {
@@ -252922,10 +253216,19 @@ var init_browser_action = __esm({
                   pointY = Math.round(normY * ssHeight);
                 }
               } catch (e2) {
-                return { success: false, output: "", error: `Vision detection failed: ${e2}`, durationMs: Date.now() - start2 };
+                return {
+                  success: false,
+                  output: "",
+                  error: `Vision detection failed: ${e2}`,
+                  durationMs: Date.now() - start2
+                };
               }
               if (pointX < 0 || pointY < 0) {
-                return { success: false, output: `Could not determine click coordinates for "${target}". Vision returned no valid points.`, durationMs: Date.now() - start2 };
+                return {
+                  success: false,
+                  output: `Could not determine click coordinates for "${target}". Vision returned no valid points.`,
+                  durationMs: Date.now() - start2
+                };
               }
               const clickResult = await apiCall("/click_xy", "POST", {
                 x: pointX,
@@ -252948,22 +253251,49 @@ var init_browser_action = __esm({
               };
             }
             case "scroll":
-              result = await apiCall("/scroll", "POST", { amount: args.amount ?? 600 });
-              return { success: !!result.ok, output: `Scrolled ${args.amount ?? 600}px`, durationMs: Date.now() - start2 };
+              result = await apiCall("/scroll", "POST", {
+                amount: args.amount ?? 600
+              });
+              return {
+                success: !!result.ok,
+                output: `Scrolled ${args.amount ?? 600}px`,
+                durationMs: Date.now() - start2
+              };
             case "scroll_up":
               result = await apiCall("/scroll/up", "POST");
-              return { success: !!result.ok, output: "Scrolled up", durationMs: Date.now() - start2 };
+              return {
+                success: !!result.ok,
+                output: "Scrolled up",
+                durationMs: Date.now() - start2
+              };
             case "scroll_down":
               result = await apiCall("/scroll/down", "POST");
-              return { success: !!result.ok, output: "Scrolled down", durationMs: Date.now() - start2 };
+              return {
+                success: !!result.ok,
+                output: "Scrolled down",
+                durationMs: Date.now() - start2
+              };
             case "back":
               result = await apiCall("/history/back", "POST");
-              return { success: !!result.ok, output: "Navigated back", durationMs: Date.now() - start2 };
+              return {
+                success: !!result.ok,
+                output: "Navigated back",
+                durationMs: Date.now() - start2
+              };
             case "forward":
               result = await apiCall("/history/forward", "POST");
-              return { success: !!result.ok, output: "Navigated forward", durationMs: Date.now() - start2 };
+              return {
+                success: !!result.ok,
+                output: "Navigated forward",
+                durationMs: Date.now() - start2
+              };
             default:
-              return { success: false, output: "", error: `Unknown action: ${action}. Available: navigate, click, click_xy, type, screenshot, dom, scroll, scroll_up, scroll_down, back, forward, close`, durationMs: Date.now() - start2 };
+              return {
+                success: false,
+                output: "",
+                error: `Unknown action: ${action}. Available: navigate, click, click_xy, type, screenshot, dom, scroll, scroll_up, scroll_down, back, forward, close`,
+                durationMs: Date.now() - start2
+              };
           }
         } catch (err) {
           return {
@@ -534749,6 +535079,14 @@ ${sr.result.output}`;
                         } else {
                           completed = true;
                           summary = extractTaskCompleteSummary(r2.tc.arguments);
+                          for (const tool of this.tools.values()) {
+                            if (tool.cleanup) {
+                              try {
+                                await tool.cleanup();
+                              } catch {
+                              }
+                            }
+                          }
                           if (summary && !this._assistantTextEmitted) {
                             this.emit({
                               type: "assistant_text",
@@ -613709,7 +614047,9 @@ function adaptTool6(tool) {
         output: result.output,
         error: result.error
       };
-    }
+    },
+    // Pass through lifecycle hooks from the underlying Tool implementation
+    cleanup: tool.cleanup
   };
 }
 function scanForSessionSignals(toolOutput) {
@@ -617741,6 +618081,9 @@ Rationale: ${proposal.rationale}${provenanceNote}`;
     rl.setPreSubmit(() => statusBar.suggestAccept());
   }
   process.stdout.on("resize", () => {
+    if (statusBar.isActive) {
+      statusBar.reapplyScrollRegion();
+    }
     statusBar.handleResize();
     setTermSize(process.stdout.rows ?? 24, process.stdout.columns ?? 80);
     if (isNeovimActive()) {