@johpaz/hive-agents 0.0.38 → 0.0.40

package/packages/core/src/tools/api/api-request.ts

@@ -0,0 +1,174 @@
+/**
+ * api_request - Make HTTP requests to REST APIs (curl-like)
+ *
+ * Supports: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
+ * Features: custom headers, JSON/form body, query params, timeout
+ *
+ * @category api
+ * @seedId api_request
+ * @spanish llamar api, petición http, curl, post a api, put api, delete api
+ */
+
+import type { Tool } from "../types.ts";
+import { logger } from "../../utils/logger.ts";
+
+const log = logger.child("api-request");
+
+const ALLOWED_METHODS = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+
+export const apiRequestTool: Tool = {
+  name: "api_request",
+  description:
+    "Make an HTTP request to a REST API endpoint. Supports GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS with custom headers, body, and query parameters. " +
+    "Spanish: llamar api, petición http, curl, post a api, put api, delete api, consumir servicio rest",
+  parameters: {
+    type: "object",
+    properties: {
+      method: {
+        type: "string",
+        description: "HTTP method: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS",
+        enum: ALLOWED_METHODS,
+      },
+      url: {
+        type: "string",
+        description: "Full URL of the API endpoint (including query string, or use query_params)",
+      },
+      headers: {
+        type: "object",
+        description: "Optional HTTP headers as key-value pairs. Example: {\"Content-Type\": \"application/json\", \"Authorization\": \"Bearer token\"}",
+        additionalProperties: { type: "string" },
+      },
+      body: {
+        type: "string",
+        description: "Optional request body as a string. For JSON APIs, pass a JSON string. For form data, pass URL-encoded string.",
+      },
+      query_params: {
+        type: "object",
+        description: "Optional query parameters as key-value pairs. Will be URL-encoded and appended to the URL.",
+        additionalProperties: { type: "string" },
+      },
+      timeout_ms: {
+        type: "number",
+        description: "Request timeout in milliseconds. Default: 30000 (30s). Max: 120000 (2 min).",
+        minimum: 1000,
+        maximum: 120000,
+      },
+    },
+    required: ["method", "url"],
+  },
+  execute: async (params: Record<string, unknown>) => {
+    const method = (params.method as string)?.toUpperCase().trim() || "GET";
+    let url = params.url as string;
+    const headers = (params.headers as Record<string, string>) || {};
+    const body = params.body as string | undefined;
+    const queryParams = (params.query_params as Record<string, string>) || {};
+    const timeoutMs = (params.timeout_ms as number) || 30000;
+
+    if (!ALLOWED_METHODS.includes(method)) {
+      return {
+        ok: false,
+        error: `Invalid HTTP method: ${method}. Allowed: ${ALLOWED_METHODS.join(", ")}`,
+      };
+    }
+
+    if (!url || typeof url !== "string") {
+      return {
+        ok: false,
+        error: "Missing required parameter: url",
+      };
+    }
+
+    // Append query params to URL
+    if (Object.keys(queryParams).length > 0) {
+      const urlObj = new URL(url);
+      for (const [key, value] of Object.entries(queryParams)) {
+        urlObj.searchParams.append(key, value);
+      }
+      url = urlObj.toString();
+    }
+
+    log.info(`[api_request] ${method} ${url}`);
+
+    const fetchOptions: RequestInit = {
+      method,
+      headers: {
+        "User-Agent": "HiveAgent/1.0",
+        ...headers,
+      },
+      // @ts-ignore — Bun supports timeout
+      timeout: timeoutMs,
+    };
+
+    if (body !== undefined && body !== null && body !== "") {
+      // Auto-set Content-Type to application/json if body looks like JSON
+      if (
+        !headers["Content-Type"] &&
+        !headers["content-type"] &&
+        typeof body === "string" &&
+        (body.trim().startsWith("{") || body.trim().startsWith("["))
+      ) {
+        (fetchOptions.headers as Record<string, string>)["Content-Type"] = "application/json";
+      }
+      fetchOptions.body = body;
+    }
+
+    try {
+      const response = await fetch(url, fetchOptions);
+
+      // For HEAD requests, don't read body
+      if (method === "HEAD") {
+        const responseHeaders: Record<string, string> = {};
+        response.headers.forEach((value, key) => {
+          responseHeaders[key] = value;
+        });
+        return {
+          ok: response.ok,
+          status: response.status,
+          statusText: response.statusText,
+          headers: responseHeaders,
+          url: response.url,
+        };
+      }
+
+      const contentType = response.headers.get("content-type") || "";
+      let responseBody: string | object;
+      const rawText = await response.text();
+
+      if (contentType.includes("application/json")) {
+        try {
+          responseBody = JSON.parse(rawText);
+        } catch {
+          responseBody = rawText;
+        }
+      } else {
+        responseBody = rawText;
+      }
+
+      const responseHeaders: Record<string, string> = {};
+      response.headers.forEach((value, key) => {
+        responseHeaders[key] = value;
+      });
+
+      log.info(`[api_request] ${method} ${url} → ${response.status} ${response.statusText}`);
+
+      return {
+        ok: response.ok,
+        status: response.status,
+        statusText: response.statusText,
+        headers: responseHeaders,
+        body: responseBody,
+        contentType,
+        url: response.url,
+      };
+    } catch (error) {
+      const msg = (error as Error).message;
+      log.error(`[api_request] ${method} ${url} failed: ${msg}`);
+      return {
+        ok: false,
+        error: `HTTP request failed: ${msg}`,
+        url,
+        method,
+      };
+    }
+  },
+};

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);