@johpaz/hive-agents 0.0.38 → 0.0.39

package/packages/core/src/tools/api/index.ts

@@ -0,0 +1,16 @@
+/**
+ * API Tools - HTTP client for REST APIs (curl-like)
+ *
+ * Makes requests to external APIs with full control over method, headers, body.
+ */
+
+import type { Tool } from "../types.ts";
+import { apiRequestTool } from "./api-request.ts";
+
+export function createTools(): Tool[] {
+  return [
+    apiRequestTool,
+  ];
+}
+
+export { apiRequestTool } from "./api-request.ts";

package/packages/core/src/tools/index.ts

@@ -38,6 +38,9 @@ import * as office from "./office/index.ts";
 // Meeting (4)
 import * as meeting from "./meeting/index.ts";
 
+// API (1) - HTTP client for REST APIs
+import * as api from "./api/index.ts";
+
 /**
  * Creates all tools with proper configuration
  */
@@ -72,6 +75,9 @@ export function createAllTools(config: Config): Tool[] {
 
     // MEETING (4)
     ...meeting.createTools(),
+
+    // API (1)
+    ...api.createTools(),
   ];
 }
 
@@ -100,6 +106,8 @@ export function createToolsByCategory(category: string, config: Config): Tool[]
       return office.createTools();
     case "meeting":
       return meeting.createTools();
+    case "api":
+      return api.createTools();
     default:
       return [];
   }
@@ -195,3 +203,7 @@ export {
   officeLeerPptxTool,
   officeEscribirPptxTool,
 } from "./office/index.ts";
+
+export {
+  apiRequestTool,
+} from "./api/index.ts";

package/packages/core/src/tools/web/browser-click.ts

@@ -43,7 +43,7 @@ export const browserClickTool: Tool = {
       log.warn("Browser not available");
       return {
         ok: false,
-        error: "Browser automation not available. Install Chrome/Chromium.",
+        error: "Browser automation not available. Install agent-browser.",
       };
     }
 
@@ -51,7 +51,7 @@ export const browserClickTool: Tool = {
 
     try {
       const view = await browserService.getView();
-      if (!view) return { ok: false, error: "Browser automation not available. Install Chrome/Chromium." };
+      if (!view) return { ok: false, error: "Browser automation not available. Install agent-browser." };
 
       if (url) {
         await view.navigate(url);

package/packages/core/src/tools/web/browser-extract.ts

@@ -14,7 +14,7 @@ const log = logger.child("browser-extract");
 
 export const browserExtractTool: Tool = {
   name: "browser_extract",
-  description: "Extract text, links, or structured data from page using CSS selectors or XPath. Spanish: extraer datos, obtener información, scraping, selectores",
+  description: "Extract text, links, or structured data from page using CSS selectors or XPath. For general page overview without specific selectors, returns compact accessibility snapshot. Spanish: extraer datos, obtener información, scraping, selectores",
   parameters: {
     type: "object",
     properties: {
@@ -24,7 +24,7 @@ export const browserExtractTool: Tool = {
       },
       selector: {
         type: "string",
-        description: "CSS selector or XPath (prefix with 'xpath:') to match elements",
+        description: "CSS selector or XPath (prefix with 'xpath:') to match elements. Use 'body' or omit for compact accessibility snapshot.",
       },
       attribute: {
         type: "string",
@@ -43,7 +43,7 @@ export const browserExtractTool: Tool = {
   },
   execute: async (params: Record<string, unknown>) => {
     const url = params.url as string | undefined;
-    const selector = params.selector as string;
+    const selector = (params.selector as string) || "body";
     const attribute = (params.attribute as string) ?? "text";
     const all = (params.all as boolean) ?? true;
     const timeout = (params.timeout as number) ?? 30000;
@@ -53,7 +53,7 @@ export const browserExtractTool: Tool = {
       log.warn("Browser not available");
       return {
         ok: false,
-        error: "Browser automation not available. Install Chrome/Chromium.",
+        error: "Browser automation not available. Install agent-browser.",
       };
     }
 
@@ -61,13 +61,30 @@ export const browserExtractTool: Tool = {
 
     try {
       const view = await browserService.getView();
-      if (!view) return { ok: false, error: "Browser automation not available. Install Chrome/Chromium." };
+      if (!view) return { ok: false, error: "Browser automation not available. Install agent-browser." };
 
       if (url) {
         await view.navigate(url);
         await Bun.sleep(500);
       }
 
+      const currentUrl = view.url;
+
+      // If selector is broad (body, html, *, :root) and attribute is text, return compact snapshot
+      const isBroadSelector = ["body", "html", "*", ":root", "document"].includes(selector.toLowerCase());
+      if (isBroadSelector && attribute === "text") {
+        const snapshot = await view.snapshot({ compact: true, depth: 3 });
+        log.info(`Snapshot extracted from ${currentUrl} (${snapshot.length} chars)`);
+        return {
+          ok: true,
+          url: currentUrl,
+          selector,
+          attribute: "snapshot",
+          count: 1,
+          data: [snapshot],
+        };
+      }
+
       const isXPath = selector.startsWith("xpath:");
       const actualSelector = isXPath ? selector.slice(6) : selector;
 
@@ -117,7 +134,6 @@ export const browserExtractTool: Tool = {
         })()
       `) as string[];
 
-      const currentUrl = view.url;
       log.info(`Extracted ${extracted.length} element(s) from ${currentUrl}`);
 
       return {

package/packages/core/src/tools/web/browser-navigate.ts

@@ -14,7 +14,7 @@ const log = logger.child("browser-navigate");
 
 export const browserNavigateTool: Tool = {
   name: "browser_navigate",
-  description: "Navigate browser to URL, get rendered page content (supports JS). Spanish: navegar a url, abrir página, sitio web",
+  description: "Navigate browser to URL, get rendered page content (supports JS). Returns compact accessibility tree with element refs (@e1, @e2) for interaction. Spanish: navegar a url, abrir página, sitio web",
   parameters: {
     type: "object",
     properties: {
@@ -30,6 +30,11 @@ export const browserNavigateTool: Tool = {
         type: "number",
         description: "Timeout in milliseconds (default: 30000)",
       },
+      mode: {
+        type: "string",
+        enum: ["snapshot", "text"],
+        description: "Content mode: 'snapshot' (compact accessibility tree with refs, default) or 'text' (full innerText). Use 'text' only if you need all readable text.",
+      },
     },
     required: ["url"],
   },
@@ -37,21 +42,22 @@ export const browserNavigateTool: Tool = {
     const url = params.url as string;
     const waitFor = params.waitFor as string | undefined;
     const timeout = (params.timeout as number) ?? 30000;
+    const mode = (params.mode as string) ?? "snapshot";
 
     const browserService = getBrowserService();
     if (!browserService?.isAvailable()) {
       log.warn("Browser not available");
       return {
         ok: false,
-        error: "Browser automation not available. Install Chrome/Chromium.",
+        error: "Browser automation not available. Install agent-browser.",
       };
     }
 
-    log.info(`Navigating: ${url}${waitFor ? ` (waiting for: ${waitFor})` : ""}`);
+    log.info(`Navigating: ${url}${waitFor ? ` (waiting for: ${waitFor})` : ""} [mode=${mode}]`);
 
     try {
       const view = await browserService.getView();
-      if (!view) return { ok: false, error: "Browser automation not available. Install Chrome/Chromium." };
+      if (!view) return { ok: false, error: "Browser automation not available. Install agent-browser." };
 
       await view.navigate(url);
 
@@ -67,28 +73,38 @@ export const browserNavigateTool: Tool = {
       }
 
       const finalUrl = view.url;
+      let content: string;
+      let contentType: string;
 
-      // Extraer texto limpio del DOM
-      const content = await view.evaluate(`
-        (() => {
-          try {
-            document.querySelectorAll("script, style, noscript, meta, link, iframe").forEach(el => el.remove());
-            let text = document.body?.innerText || document.documentElement?.innerText || "";
-            text = text.replace(/\\s+/g, " ").trim();
-            return text.slice(0, 50000);
-          } catch (e) {
-            return "Error extracting content: " + e.message;
-          }
-        })()
-      `) as string;
+      if (mode === "text") {
+        // Full innerText (legacy mode, heavy)
+        content = await view.evaluate(`
+          (() => {
+            try {
+              document.querySelectorAll("script, style, noscript, meta, link, iframe").forEach(el => el.remove());
+              let text = document.body?.innerText || document.documentElement?.innerText || "";
+              text = text.replace(/\\s+/g, " ").trim();
+              return text.slice(0, 50000);
+            } catch (e) {
+              return "Error extracting content: " + e.message;
+            }
+          })()
+        `) as string;
+        contentType = "text";
+      } else {
+        // Default: compact accessibility snapshot with refs
+        content = await view.snapshot({ compact: true, depth: 3 });
+        contentType = "snapshot";
+      }
 
-      log.info(`Navigation successful: ${finalUrl} (${content.length} chars)`);
+      log.info(`Navigation successful: ${finalUrl} (${content.length} chars, ${contentType})`);
 
       return {
         ok: true,
         url,
         finalUrl,
         content,
+        contentType,
         length: content.length,
       };
     } catch (error) {

package/packages/core/src/tools/web/browser-screenshot.ts

@@ -12,9 +12,12 @@ import { getBrowserService, screenshotElement } from "./browser-service.ts";
 
 const log = logger.child("browser-screenshot");
 
+// Default viewport for screenshots — keeps base64 small (~30-60KB vs ~300KB)
+const DEFAULT_VIEWPORT = { width: 1280, height: 720 };
+
 export const browserScreenshotTool: Tool = {
   name: "browser_screenshot",
-  description: "Take screenshot of current browser page. Spanish: captura de pantalla, screenshot, imagen de página",
+  description: "Take screenshot of current browser page. Returns JPEG by default for smaller size. Spanish: captura de pantalla, screenshot, imagen de página",
   parameters: {
     type: "object",
     properties: {
@@ -30,6 +33,23 @@ export const browserScreenshotTool: Tool = {
         type: "string",
         description: "CSS selector of specific element to screenshot (optional)",
       },
+      format: {
+        type: "string",
+        enum: ["jpeg", "png"],
+        description: "Image format: jpeg (default, smaller) or png (lossless, larger)",
+      },
+      quality: {
+        type: "number",
+        description: "JPEG quality 0-100 (default: 80). Ignored for PNG.",
+      },
+      width: {
+        type: "number",
+        description: "Viewport width in pixels (default: 1280). Smaller = smaller file.",
+      },
+      height: {
+        type: "number",
+        description: "Viewport height in pixels (default: 720). Smaller = smaller file.",
+      },
     },
     required: [],
   },
@@ -37,47 +57,59 @@ export const browserScreenshotTool: Tool = {
     const url = params.url as string | undefined;
     const fullPage = (params.fullPage as boolean) ?? false;
     const selector = params.selector as string | undefined;
+    const format = (params.format as string) ?? "jpeg";
+    const quality = (params.quality as number) ?? 80;
+    const width = (params.width as number) ?? DEFAULT_VIEWPORT.width;
+    const height = (params.height as number) ?? DEFAULT_VIEWPORT.height;
 
     const browserService = getBrowserService();
     if (!browserService?.isAvailable()) {
       log.warn("Browser not available");
       return {
         ok: false,
-        error: "Browser automation not available. Install Chrome/Chromium.",
+        error: "Browser automation not available. Install agent-browser.",
       };
     }
 
-    log.info(`Taking screenshot${url ? ` of: ${url}` : ""}${selector ? ` (element: ${selector})` : ""}`);
+    log.info(`Taking screenshot${url ? ` of: ${url}` : ""}${selector ? ` (element: ${selector})` : ""} [${format} ${width}x${height}]`);
 
     try {
       const view = await browserService.getView();
-      if (!view) return { ok: false, error: "Browser automation not available. Install Chrome/Chromium." };
+      if (!view) return { ok: false, error: "Browser automation not available. Install agent-browser." };
 
       if (url) {
         await view.navigate(url);
         await Bun.sleep(500);
       }
 
+      // Resize viewport before screenshot to keep image small
+      await view.resize(width, height);
+      await Bun.sleep(200);
+
       let screenshot: string;
 
       if (selector) {
         screenshot = await screenshotElement(view, selector);
       } else {
-        screenshot = await view.screenshot({ encoding: "base64", format: "png" });
+        screenshot = await view.screenshot({
+          encoding: "base64",
+          format: format as "jpeg" | "png" | "webp",
+          quality: format === "jpeg" ? quality : undefined,
+        });
       }
 
       const currentUrl = view.url;
-      log.info(`Screenshot captured: ${currentUrl} (${screenshot.length} base64 chars)`);
+      log.info(`Screenshot captured: ${currentUrl} (${screenshot.length} base64 chars, ${format})`);
 
       return {
         ok: true,
         url: currentUrl,
         screenshot,
-        format: "png",
+        format,
         encoding: "base64",
         fullPage,
         selector,
-        viewport: { width: 1280, height: 800 },
+        viewport: { width, height },
       };
     } catch (error) {
       log.error(`Screenshot failed: ${(error as Error).message}`);

package/packages/core/src/tools/web/browser-script.ts

@@ -43,7 +43,7 @@ export const browserScriptTool: Tool = {
       log.warn("Browser not available");
       return {
         ok: false,
-        error: "Browser automation not available. Install Chrome/Chromium.",
+        error: "Browser automation not available. Install agent-browser.",
       };
     }
 
@@ -51,7 +51,7 @@ export const browserScriptTool: Tool = {
 
     try {
       const view = await browserService.getView();
-      if (!view) return { ok: false, error: "Browser automation not available. Install Chrome/Chromium." };
+      if (!view) return { ok: false, error: "Browser automation not available. Install agent-browser." };
 
       if (url) {
         await view.navigate(url);