@easynet/agent-tool-buildin 0.0.1 → 0.0.2

package/dist/index.cjs

@@ -2036,7 +2036,8 @@ __export(index_exports, {
   templateRenderSpec: () => templateRenderSpec,
   truncateSpec: () => truncateSpec,
   validateUrl: () => validateUrl,
-  writeTextSpec: () => writeTextSpec
+  writeTextSpec: () => writeTextSpec,
+  yahooFinanceQuoteSpec: () => yahooFinanceQuoteSpec
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -2190,7 +2191,10 @@ function isWithinRoot(path, root) {
 var import_agent_tool2 = require("@easynet/agent-tool");
 var readTextHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const inputPath = args.path;
+  const inputPath = (args.path ?? args.filePath)?.trim();
+  if (!inputPath) {
+    throw (0, import_agent_tool2.createTaggedError)("FS_INVALID", "path is required (pass 'path' or 'filePath')", {});
+  }
   const maxBytes = args.maxBytes ?? ctx.config.maxReadBytes;
   const resolvedPath = await resolveSandboxedPath(inputPath, ctx.config.sandboxRoot);
   const fileStat = await (0, import_promises2.stat)(resolvedPath);
@@ -2225,8 +2229,11 @@ var import_node_crypto = require("crypto");
 var import_node_path2 = require("path");
 var writeTextHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const inputPath = args.path;
-  const text = args.text;
+  const inputPath = (args.path ?? args.filePath)?.trim();
+  if (!inputPath) {
+    throw new Error("path is required (pass 'path' or 'filePath')");
+  }
+  const text = args.text ?? args.content ?? "";
   const overwrite = args.overwrite ?? false;
   const mkdirp = args.mkdirp ?? true;
   const resolvedPath = await resolveSandboxedPath(inputPath, ctx.config.sandboxRoot);
@@ -2272,7 +2279,10 @@ var import_promises4 = require("fs/promises");
 var import_node_path3 = require("path");
 var listDirHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const inputPath = args.path;
+  const inputPath = (args.path ?? args.filePath ?? args.dir ?? args.directory)?.trim();
+  if (!inputPath) {
+    throw new Error("path is required (pass 'path', 'filePath', 'dir', or 'directory')");
+  }
   const maxEntries = args.maxEntries ?? 2e3;
   const includeHidden = args.includeHidden ?? false;
   const recursive = args.recursive ?? false;
@@ -2364,8 +2374,14 @@ var import_node_readline = require("readline");
 var import_node_path4 = require("path");
 var searchTextHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const rootPath = args.root;
-  const query = args.query;
+  const rootPath = (args.root ?? args.path ?? args.dir ?? args.directory)?.trim();
+  if (!rootPath) {
+    throw new Error("root is required (pass 'root', 'path', 'dir', or 'directory')");
+  }
+  const query = (args.query ?? args.q)?.trim();
+  if (!query) {
+    throw new Error("query is required (pass 'query' or 'q')");
+  }
   const glob = args.glob ?? "**/*.{md,txt,log,json,ts,js,py,java,scala}";
   const maxMatches = args.maxMatches ?? 100;
   const maxFiles = args.maxFiles ?? 500;
@@ -2484,9 +2500,13 @@ function escapeRegExp(str) {
 var import_node_fs2 = require("fs");
 var import_promises6 = require("fs/promises");
 var import_node_crypto2 = require("crypto");
+var import_agent_tool3 = require("@easynet/agent-tool");
 var sha256Handler = (async (args) => {
   const ctx = getBuiltinContext();
-  const inputPath = args.path;
+  const inputPath = (args.path ?? args.filePath)?.trim();
+  if (!inputPath) {
+    throw (0, import_agent_tool3.createTaggedError)("FS_INVALID", "path is required (pass 'path' or 'filePath')", {});
+  }
   const resolvedPath = await resolveSandboxedPath(inputPath, ctx.config.sandboxRoot);
   const fileStat = await (0, import_promises6.stat)(resolvedPath);
   const hash = await new Promise((resolve3, reject) => {
@@ -2517,7 +2537,10 @@ var sha256Handler = (async (args) => {
 var import_promises7 = require("fs/promises");
 var deletePathHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const inputPath = args.path;
+  const inputPath = (args.path ?? args.filePath)?.trim();
+  if (!inputPath) {
+    throw new Error("path is required (pass 'path' or 'filePath')");
+  }
   const recursive = args.recursive ?? false;
   const confirm = args.confirm;
   if (!confirm) {
@@ -2566,20 +2589,20 @@ var deletePathHandler = (async (args) => {
 
 // security/ssrf.ts
 var import_promises8 = require("dns/promises");
-var import_agent_tool3 = require("@easynet/agent-tool");
+var import_agent_tool4 = require("@easynet/agent-tool");
 async function validateUrl(url, allowedHosts, blockedCidrs) {
   let parsed;
   try {
     parsed = new URL(url);
   } catch {
-    throw (0, import_agent_tool3.createTaggedError)(
+    throw (0, import_agent_tool4.createTaggedError)(
       "HTTP_DISALLOWED_HOST",
       `Invalid URL: ${url}`,
       { url }
     );
   }
   if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-    throw (0, import_agent_tool3.createTaggedError)(
+    throw (0, import_agent_tool4.createTaggedError)(
       "HTTP_DISALLOWED_HOST",
       `Protocol not allowed: ${parsed.protocol}. Only http: and https: are supported.`,
       { url, protocol: parsed.protocol }
@@ -2587,7 +2610,7 @@ async function validateUrl(url, allowedHosts, blockedCidrs) {
   }
   const hostname = parsed.hostname;
   if (!isHostAllowed(hostname, allowedHosts)) {
-    throw (0, import_agent_tool3.createTaggedError)(
+    throw (0, import_agent_tool4.createTaggedError)(
       "HTTP_DISALLOWED_HOST",
       `Host "${hostname}" is not in the allowed hosts list`,
       { url, hostname, allowedHosts }
@@ -2596,7 +2619,7 @@ async function validateUrl(url, allowedHosts, blockedCidrs) {
   try {
     const { address } = await (0, import_promises8.lookup)(hostname);
     if (isIpInBlockedCidrs(address, blockedCidrs)) {
-      throw (0, import_agent_tool3.createTaggedError)(
+      throw (0, import_agent_tool4.createTaggedError)(
         "HTTP_DISALLOWED_HOST",
         `Host "${hostname}" resolves to blocked IP: ${address}`,
         { url, hostname, resolvedIp: address }
@@ -2606,7 +2629,7 @@ async function validateUrl(url, allowedHosts, blockedCidrs) {
     if (err instanceof Error && err.kind === "HTTP_DISALLOWED_HOST") {
       throw err;
     }
-    throw (0, import_agent_tool3.createTaggedError)(
+    throw (0, import_agent_tool4.createTaggedError)(
       "HTTP_DISALLOWED_HOST",
       `DNS resolution failed for host "${hostname}": ${err instanceof Error ? err.message : String(err)}`,
       { url, hostname }
@@ -2717,10 +2740,13 @@ function expandIpv6(ip) {
 }
 
 // http/fetchText.ts
-var import_agent_tool4 = require("@easynet/agent-tool");
+var import_agent_tool5 = require("@easynet/agent-tool");
 var fetchTextHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const url = args.url;
+  const url = (args.url ?? args.uri)?.trim();
+  if (!url) {
+    throw (0, import_agent_tool5.createTaggedError)("HTTP_INVALID", "url is required (pass 'url' or 'uri')", {});
+  }
   const method = args.method ?? "GET";
   const headers = args.headers ?? {};
   const body = args.body ?? void 0;
@@ -2742,13 +2768,13 @@ var fetchTextHandler = (async (args) => {
     });
   } catch (err) {
     if (err instanceof Error && err.name === "AbortError") {
-      throw (0, import_agent_tool4.createTaggedError)(
+      throw (0, import_agent_tool5.createTaggedError)(
         "HTTP_TIMEOUT",
         `Request to ${url} timed out after ${timeoutMs}ms`,
         { url, timeoutMs }
       );
     }
-    throw (0, import_agent_tool4.createTaggedError)(
+    throw (0, import_agent_tool5.createTaggedError)(
       "UPSTREAM_ERROR",
       `Fetch failed for ${url}: ${err instanceof Error ? err.message : String(err)}`,
       { url }
@@ -2758,7 +2784,7 @@ var fetchTextHandler = (async (args) => {
   }
   const contentLength = response.headers.get("content-length");
   if (contentLength && parseInt(contentLength, 10) > maxBytes) {
-    throw (0, import_agent_tool4.createTaggedError)(
+    throw (0, import_agent_tool5.createTaggedError)(
       "HTTP_TOO_LARGE",
       `Response Content-Length ${contentLength} exceeds limit of ${maxBytes} bytes`,
       { url, contentLength: parseInt(contentLength, 10), limit: maxBytes }
@@ -2803,7 +2829,7 @@ async function readResponseWithLimit(response, maxBytes, url) {
       totalBytes += value.byteLength;
       if (totalBytes > maxBytes) {
         reader.cancel();
-        throw (0, import_agent_tool4.createTaggedError)(
+        throw (0, import_agent_tool5.createTaggedError)(
           "HTTP_TOO_LARGE",
           `Response body exceeded limit of ${maxBytes} bytes while reading from ${url}`,
           { url, bytesRead: totalBytes, limit: maxBytes }
@@ -2819,10 +2845,13 @@ async function readResponseWithLimit(response, maxBytes, url) {
 }
 
 // http/fetchJson.ts
-var import_agent_tool5 = require("@easynet/agent-tool");
+var import_agent_tool6 = require("@easynet/agent-tool");
 var fetchJsonHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const url = args.url;
+  const url = (args.url ?? args.uri)?.trim();
+  if (!url) {
+    throw (0, import_agent_tool6.createTaggedError)("HTTP_INVALID", "url is required (pass 'url' or 'uri')", {});
+  }
   const method = args.method ?? "GET";
   const headers = args.headers ?? {};
   const body = args.body ?? void 0;
@@ -2847,13 +2876,13 @@ var fetchJsonHandler = (async (args) => {
     });
   } catch (err) {
     if (err instanceof Error && err.name === "AbortError") {
-      throw (0, import_agent_tool5.createTaggedError)(
+      throw (0, import_agent_tool6.createTaggedError)(
         "HTTP_TIMEOUT",
         `Request to ${url} timed out after ${timeoutMs}ms`,
         { url, timeoutMs }
       );
     }
-    throw (0, import_agent_tool5.createTaggedError)(
+    throw (0, import_agent_tool6.createTaggedError)(
       "UPSTREAM_ERROR",
       `Fetch failed for ${url}: ${err instanceof Error ? err.message : String(err)}`,
       { url }
@@ -2863,7 +2892,7 @@ var fetchJsonHandler = (async (args) => {
   }
   const contentLength = response.headers.get("content-length");
   if (contentLength && parseInt(contentLength, 10) > maxBytes) {
-    throw (0, import_agent_tool5.createTaggedError)(
+    throw (0, import_agent_tool6.createTaggedError)(
       "HTTP_TOO_LARGE",
       `Response Content-Length ${contentLength} exceeds limit of ${maxBytes} bytes`,
       { url, contentLength: parseInt(contentLength, 10), limit: maxBytes }
@@ -2872,7 +2901,7 @@ var fetchJsonHandler = (async (args) => {
   const text = await response.text();
   const bytes = Buffer.byteLength(text, "utf-8");
   if (bytes > maxBytes) {
-    throw (0, import_agent_tool5.createTaggedError)(
+    throw (0, import_agent_tool6.createTaggedError)(
       "HTTP_TOO_LARGE",
       `Response body ${bytes} bytes exceeds limit of ${maxBytes} bytes`,
       { url, bytes, limit: maxBytes }
@@ -2882,7 +2911,7 @@ var fetchJsonHandler = (async (args) => {
   try {
     json = JSON.parse(text);
   } catch {
-    throw (0, import_agent_tool5.createTaggedError)(
+    throw (0, import_agent_tool6.createTaggedError)(
       "UPSTREAM_ERROR",
       `Failed to parse JSON response from ${url}: ${text.slice(0, 200)}`,
       { url, status: response.status, textPreview: text.slice(0, 500) }
@@ -2910,11 +2939,17 @@ var fetchJsonHandler = (async (args) => {
 var import_promises9 = require("fs/promises");
 var import_node_crypto3 = require("crypto");
 var import_node_path5 = require("path");
-var import_agent_tool6 = require("@easynet/agent-tool");
+var import_agent_tool7 = require("@easynet/agent-tool");
 var downloadFileHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const url = args.url;
-  const destPath = args.destPath;
+  const url = (args.url ?? args.uri)?.trim();
+  if (!url) {
+    throw (0, import_agent_tool7.createTaggedError)("HTTP_INVALID", "url is required (pass 'url' or 'uri')", {});
+  }
+  const destPath = (args.destPath ?? args.destination ?? args.filePath)?.trim();
+  if (!destPath) {
+    throw (0, import_agent_tool7.createTaggedError)("HTTP_INVALID", "destPath is required (pass 'destPath', 'destination', or 'filePath')", {});
+  }
   const headers = args.headers ?? {};
   const timeoutMs = args.timeoutMs ?? ctx.config.defaultTimeoutMs;
   const maxBytes = args.maxBytes ?? ctx.config.maxDownloadBytes;
@@ -2949,13 +2984,13 @@ var downloadFileHandler = (async (args) => {
     });
   } catch (err) {
     if (err instanceof Error && err.name === "AbortError") {
-      throw (0, import_agent_tool6.createTaggedError)(
+      throw (0, import_agent_tool7.createTaggedError)(
         "HTTP_TIMEOUT",
         `Download from ${url} timed out after ${timeoutMs}ms`,
         { url, timeoutMs }
       );
     }
-    throw (0, import_agent_tool6.createTaggedError)(
+    throw (0, import_agent_tool7.createTaggedError)(
       "UPSTREAM_ERROR",
       `Download failed for ${url}: ${err instanceof Error ? err.message : String(err)}`,
       { url }
@@ -2965,14 +3000,14 @@ var downloadFileHandler = (async (args) => {
   }
   const contentLength = response.headers.get("content-length");
   if (contentLength && parseInt(contentLength, 10) > maxBytes) {
-    throw (0, import_agent_tool6.createTaggedError)(
+    throw (0, import_agent_tool7.createTaggedError)(
       "HTTP_TOO_LARGE",
       `Download Content-Length ${contentLength} exceeds limit of ${maxBytes} bytes`,
       { url, contentLength: parseInt(contentLength, 10), limit: maxBytes }
     );
   }
   if (!response.body) {
-    throw (0, import_agent_tool6.createTaggedError)("UPSTREAM_ERROR", `No response body from ${url}`, { url });
+    throw (0, import_agent_tool7.createTaggedError)("UPSTREAM_ERROR", `No response body from ${url}`, { url });
   }
   const reader = response.body.getReader();
   const chunks = [];
@@ -2985,7 +3020,7 @@ var downloadFileHandler = (async (args) => {
       totalBytes += value.byteLength;
       if (totalBytes > maxBytes) {
         reader.cancel();
-        throw (0, import_agent_tool6.createTaggedError)(
+        throw (0, import_agent_tool7.createTaggedError)(
           "HTTP_TOO_LARGE",
           `Download from ${url} exceeded limit of ${maxBytes} bytes (received ${totalBytes})`,
           { url, bytesRead: totalBytes, limit: maxBytes }
@@ -3027,10 +3062,13 @@ var downloadFileHandler = (async (args) => {
 });
 
 // http/head.ts
-var import_agent_tool7 = require("@easynet/agent-tool");
+var import_agent_tool8 = require("@easynet/agent-tool");
 var headHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const url = args.url;
+  const url = (args.url ?? args.uri)?.trim();
+  if (!url) {
+    throw (0, import_agent_tool8.createTaggedError)("HTTP_INVALID", "url is required (pass 'url' or 'uri')", {});
+  }
   const headers = args.headers ?? {};
   const timeoutMs = args.timeoutMs ?? ctx.config.defaultTimeoutMs;
   await validateUrl(url, ctx.config.allowedHosts, ctx.config.blockedCidrs);
@@ -3048,13 +3086,13 @@ var headHandler = (async (args) => {
     });
   } catch (err) {
     if (err instanceof Error && err.name === "AbortError") {
-      throw (0, import_agent_tool7.createTaggedError)(
+      throw (0, import_agent_tool8.createTaggedError)(
         "HTTP_TIMEOUT",
         `HEAD request to ${url} timed out after ${timeoutMs}ms`,
         { url, timeoutMs }
       );
     }
-    throw (0, import_agent_tool7.createTaggedError)(
+    throw (0, import_agent_tool8.createTaggedError)(
       "UPSTREAM_ERROR",
       `HEAD request failed for ${url}: ${err instanceof Error ? err.message : String(err)}`,
       { url }
@@ -3084,13 +3122,13 @@ var headHandler = (async (args) => {
 });
 
 // http/duckduckgoSearch.ts
-var import_agent_tool8 = require("@easynet/agent-tool");
+var import_agent_tool9 = require("@easynet/agent-tool");
 var DUCKDUCKGO_API = "https://api.duckduckgo.com/";
 var duckduckgoSearchHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const query = args.query?.trim();
+  const query = (args.query ?? args.q)?.trim();
   if (!query) {
-    throw (0, import_agent_tool8.createTaggedError)("DUCKDUCKGO_INVALID", "query is required", {});
+    throw (0, import_agent_tool9.createTaggedError)("DUCKDUCKGO_INVALID", "query is required (pass 'query' or 'q')", {});
   }
   const timeoutMs = args.timeoutMs ?? ctx.config.defaultTimeoutMs;
   const maxResults = args.maxResults ?? 10;
@@ -3108,13 +3146,13 @@ var duckduckgoSearchHandler = (async (args) => {
   } catch (err) {
     clearTimeout(timer);
     if (err instanceof Error && err.name === "AbortError") {
-      throw (0, import_agent_tool8.createTaggedError)(
+      throw (0, import_agent_tool9.createTaggedError)(
         "HTTP_TIMEOUT",
         `DuckDuckGo search timed out after ${timeoutMs}ms`,
         { query, timeoutMs }
       );
     }
-    throw (0, import_agent_tool8.createTaggedError)(
+    throw (0, import_agent_tool9.createTaggedError)(
       "UPSTREAM_ERROR",
       `DuckDuckGo search failed: ${err instanceof Error ? err.message : String(err)}`,
       { query }
@@ -3125,7 +3163,7 @@ var duckduckgoSearchHandler = (async (args) => {
   const text = await response.text();
   const bytes = Buffer.byteLength(text, "utf-8");
   if (bytes > maxBytes) {
-    throw (0, import_agent_tool8.createTaggedError)(
+    throw (0, import_agent_tool9.createTaggedError)(
       "HTTP_TOO_LARGE",
       `DuckDuckGo response ${bytes} bytes exceeds limit of ${maxBytes} bytes`,
       { query, bytes, limit: maxBytes }
@@ -3135,7 +3173,7 @@ var duckduckgoSearchHandler = (async (args) => {
   try {
     raw = JSON.parse(text);
   } catch {
-    throw (0, import_agent_tool8.createTaggedError)(
+    throw (0, import_agent_tool9.createTaggedError)(
       "UPSTREAM_ERROR",
       `DuckDuckGo returned invalid JSON`,
       { query, textPreview: text.slice(0, 200) }
@@ -3186,7 +3224,7 @@ var duckduckgoSearchHandler = (async (args) => {
 
 // http/fetchPageMainContent.ts
 var import_node_html_parser = require("node-html-parser");
-var import_agent_tool9 = require("@easynet/agent-tool");
+var import_agent_tool10 = require("@easynet/agent-tool");
 var MAIN_SELECTORS = [
   "main",
   "article",
@@ -3227,7 +3265,10 @@ function extractMainContent(html) {
 }
 var fetchPageMainContentHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const url = args.url;
+  const url = (args.url ?? args.uri)?.trim();
+  if (!url) {
+    throw (0, import_agent_tool10.createTaggedError)("HTTP_INVALID", "url is required (pass 'url' or 'uri')", {});
+  }
   const timeoutMs = args.timeoutMs ?? ctx.config.defaultTimeoutMs;
   const maxBytes = args.maxBytes ?? ctx.config.maxHttpBytes;
   await validateUrl(url, ctx.config.allowedHosts, ctx.config.blockedCidrs);
@@ -3243,13 +3284,13 @@ var fetchPageMainContentHandler = (async (args) => {
   } catch (err) {
     clearTimeout(timer);
     if (err instanceof Error && err.name === "AbortError") {
-      throw (0, import_agent_tool9.createTaggedError)(
+      throw (0, import_agent_tool10.createTaggedError)(
         "HTTP_TIMEOUT",
         `Request to ${url} timed out after ${timeoutMs}ms`,
         { url, timeoutMs }
       );
     }
-    throw (0, import_agent_tool9.createTaggedError)(
+    throw (0, import_agent_tool10.createTaggedError)(
       "UPSTREAM_ERROR",
       `Fetch failed for ${url}: ${err instanceof Error ? err.message : String(err)}`,
       { url }
@@ -3258,7 +3299,7 @@ var fetchPageMainContentHandler = (async (args) => {
   clearTimeout(timer);
   const contentLength = response.headers.get("content-length");
   if (contentLength && parseInt(contentLength, 10) > maxBytes) {
-    throw (0, import_agent_tool9.createTaggedError)(
+    throw (0, import_agent_tool10.createTaggedError)(
       "HTTP_TOO_LARGE",
       `Response Content-Length ${contentLength} exceeds limit of ${maxBytes} bytes`,
       { url, contentLength: parseInt(contentLength, 10), limit: maxBytes }
@@ -3267,7 +3308,7 @@ var fetchPageMainContentHandler = (async (args) => {
   const rawText = await response.text();
   const rawBytes = Buffer.byteLength(rawText, "utf-8");
   if (rawBytes > maxBytes) {
-    throw (0, import_agent_tool9.createTaggedError)(
+    throw (0, import_agent_tool10.createTaggedError)(
       "HTTP_TOO_LARGE",
       `Response body ${rawBytes} bytes exceeds limit of ${maxBytes} bytes`,
       { url, bytes: rawBytes, limit: maxBytes }
@@ -3309,10 +3350,133 @@ var fetchPageMainContentHandler = (async (args) => {
   };
 });
 
+// http/yahooFinance.ts
+var import_agent_tool11 = require("@easynet/agent-tool");
+var YAHOO_CHART_BASE = "https://query1.finance.yahoo.com/v8/finance/chart/";
+var yahooFinanceQuoteHandler = (async (args) => {
+  const ctx = getBuiltinContext();
+  const rawSymbols = args.symbols ?? args.symbol ?? args.tickers;
+  const symbols = Array.isArray(rawSymbols) ? rawSymbols.map((s) => String(s).trim().toUpperCase()).filter(Boolean) : rawSymbols != null ? [String(rawSymbols).trim().toUpperCase()].filter(Boolean) : [];
+  if (symbols.length === 0) {
+    throw (0, import_agent_tool11.createTaggedError)(
+      "YAHOO_INVALID",
+      "At least one symbol is required",
+      {}
+    );
+  }
+  const range = args.range ?? "1d";
+  const timeoutMs = args.timeoutMs ?? ctx.config.defaultTimeoutMs;
+  const maxBytes = ctx.config.maxHttpBytes;
+  const quotes = [];
+  for (const symbol of symbols) {
+    const url2 = `${YAHOO_CHART_BASE}${encodeURIComponent(symbol)}?interval=1d&range=${range}`;
+    await validateUrl(url2, ctx.config.allowedHosts, ctx.config.blockedCidrs);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    try {
+      response = await fetch(url2, {
+        method: "GET",
+        headers: {
+          "User-Agent": ctx.config.httpUserAgent,
+          Accept: "application/json"
+        },
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      if (err instanceof Error && err.name === "AbortError") {
+        throw (0, import_agent_tool11.createTaggedError)(
+          "HTTP_TIMEOUT",
+          `Yahoo Finance request for ${symbol} timed out after ${timeoutMs}ms`,
+          { symbol, timeoutMs }
+        );
+      }
+      throw (0, import_agent_tool11.createTaggedError)(
+        "UPSTREAM_ERROR",
+        `Yahoo Finance request failed: ${err instanceof Error ? err.message : String(err)}`,
+        { symbol }
+      );
+    }
+    clearTimeout(timer);
+    const text = await response.text();
+    const bytes = Buffer.byteLength(text, "utf-8");
+    if (bytes > maxBytes) {
+      throw (0, import_agent_tool11.createTaggedError)(
+        "HTTP_TOO_LARGE",
+        `Yahoo Finance response ${bytes} bytes exceeds limit of ${maxBytes} bytes`,
+        { symbol, bytes, limit: maxBytes }
+      );
+    }
+    let data;
+    try {
+      data = JSON.parse(text);
+    } catch {
+      throw (0, import_agent_tool11.createTaggedError)(
+        "UPSTREAM_ERROR",
+        "Yahoo Finance returned invalid JSON",
+        { symbol, textPreview: text.slice(0, 200) }
+      );
+    }
+    const error = data.chart?.error;
+    if (error?.description) {
+      throw (0, import_agent_tool11.createTaggedError)(
+        "YAHOO_ERROR",
+        `Yahoo Finance error for ${symbol}: ${error.description}`,
+        { symbol, code: error.code }
+      );
+    }
+    const result = data.chart?.result?.[0];
+    if (!result) {
+      quotes.push({ symbol });
+      continue;
+    }
+    const meta = result.meta ?? {};
+    const quoteArr = result.indicators?.quote?.[0];
+    const lastIdx = (result.timestamp?.length ?? 1) - 1;
+    const price = meta.regularMarketPrice ?? meta.previousClose ?? quoteArr?.close?.[lastIdx] ?? void 0;
+    const previousClose = meta.previousClose ?? meta.chartPreviousClose ?? quoteArr?.close?.[Math.max(0, lastIdx - 1)] ?? void 0;
+    const change = price != null && previousClose != null ? price - previousClose : void 0;
+    const changePercent = change != null && previousClose != null && previousClose !== 0 ? change / previousClose * 100 : void 0;
+    quotes.push({
+      symbol: meta.symbol ?? symbol,
+      currency: meta.currency,
+      price: price ?? void 0,
+      previousClose: previousClose ?? void 0,
+      change,
+      changePercent,
+      open: quoteArr?.open?.[lastIdx] ?? void 0,
+      high: quoteArr?.high?.[lastIdx] ?? void 0,
+      low: quoteArr?.low?.[lastIdx] ?? void 0,
+      volume: quoteArr?.volume?.[lastIdx] ?? void 0,
+      timestamp: result.timestamp?.[lastIdx]
+    });
+  }
+  const url = `${YAHOO_CHART_BASE}${encodeURIComponent(symbols[0])}?interval=1d&range=${range}`;
+  return {
+    result: {
+      symbols: quotes.map((q) => q.symbol),
+      quotes,
+      range
+    },
+    evidence: [
+      {
+        type: "url",
+        ref: url,
+        summary: `Yahoo Finance quote: ${symbols.join(", ")} (${quotes.length} result(s))`,
+        createdAt: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    ]
+  };
+});
+
 // util/jsonSelect.ts
 var jsonSelectHandler = (async (args) => {
   const json = args.json;
-  const path = args.path;
+  const path = (args.path ?? args.expression)?.trim();
+  if (path === void 0 || path === "") {
+    throw new Error("path is required (pass 'path' or 'expression')");
+  }
   let jmespath;
   try {
     jmespath = await Promise.resolve().then(() => __toESM(require_jmespath(), 1));
@@ -3469,37 +3633,37 @@ var templateRenderHandler = (async (args) => {
 // exec/runCommand.ts
 var import_node_child_process = require("child_process");
 var import_node_path6 = require("path");
-var import_agent_tool10 = require("@easynet/agent-tool");
+var import_agent_tool12 = require("@easynet/agent-tool");
 var runCommandHandler = (async (args) => {
   const ctx = getBuiltinContext();
   const { allowedCommands, maxCommandOutputBytes, commandTimeoutMs } = ctx.config;
   if (!allowedCommands.length) {
-    throw (0, import_agent_tool10.createTaggedError)(
+    throw (0, import_agent_tool12.createTaggedError)(
       "EXEC_DISABLED",
       "Exec is disabled: allowedCommands is empty",
       {}
     );
   }
-  const rawCommand = args.command?.trim();
+  const rawCommand = (args.command ?? args.cmd)?.trim();
   if (!rawCommand) {
-    throw (0, import_agent_tool10.createTaggedError)("EXEC_INVALID", "command is required", {});
+    throw (0, import_agent_tool12.createTaggedError)("EXEC_INVALID", "command is required (pass 'command' or 'cmd')", {});
   }
   const baseName = rawCommand.replace(/^.*\//, "").trim();
   if (baseName !== rawCommand || /[;&|$`\s]/.test(rawCommand)) {
-    throw (0, import_agent_tool10.createTaggedError)(
+    throw (0, import_agent_tool12.createTaggedError)(
       "EXEC_INVALID",
       "command must be a single executable name (no path, no shell chars)",
       { command: rawCommand }
     );
   }
   if (!allowedCommands.includes(baseName)) {
-    throw (0, import_agent_tool10.createTaggedError)(
+    throw (0, import_agent_tool12.createTaggedError)(
       "EXEC_NOT_ALLOWED",
       `Command "${baseName}" is not in allowedCommands`,
       { command: baseName, allowed: allowedCommands }
     );
   }
-  const cmdArgs = Array.isArray(args.args) ? args.args : [];
+  const cmdArgs = Array.isArray(args.args) ? args.args : Array.isArray(args.arguments) ? args.arguments : [];
   const timeoutMs = args.timeoutMs ?? commandTimeoutMs;
   let cwd = (0, import_node_path6.resolve)(ctx.config.sandboxRoot);
   if (args.cwd != null && args.cwd !== "") {
@@ -3520,7 +3684,7 @@ var runCommandHandler = (async (args) => {
       if (totalBytes + len > maxCommandOutputBytes) {
         proc.kill("SIGKILL");
         rejectPromise(
-          (0, import_agent_tool10.createTaggedError)(
+          (0, import_agent_tool12.createTaggedError)(
             "EXEC_OUTPUT_TOO_LARGE",
             `Command output exceeded ${maxCommandOutputBytes} bytes`,
             { maxBytes: maxCommandOutputBytes }
@@ -3558,7 +3722,7 @@ var runCommandHandler = (async (args) => {
     proc.on("error", (err) => {
       clearTimeout(timeout);
       rejectPromise(
-        (0, import_agent_tool10.createTaggedError)("EXEC_SPAWN_ERROR", err.message, { command: baseName })
+        (0, import_agent_tool12.createTaggedError)("EXEC_SPAWN_ERROR", err.message, { command: baseName })
       );
     });
     proc.on("close", (code, signal) => {
@@ -3590,7 +3754,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/fs.readText",
     kind: "core",
-    description: "Read a UTF-8 text file from the sandbox",
+    description: "Read a UTF-8 text file from the sandbox. Input: path (or filePath), optional maxBytes.",
     tags: ["filesystem", "read", "core"],
     capabilities: ["read:fs"],
     sideEffect: "none"
@@ -3598,7 +3762,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/fs.writeText",
     kind: "core",
-    description: "Write UTF-8 text to a file in the sandbox",
+    description: "Write UTF-8 text to a file in the sandbox. Input: path (or filePath), text (or content), optional overwrite, mkdirp.",
     tags: ["filesystem", "write", "core"],
     capabilities: ["write:fs"],
     sideEffect: "local_write"
@@ -3606,7 +3770,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/fs.listDir",
     kind: "core",
-    description: "List directory contents in the sandbox",
+    description: "List directory contents in the sandbox. Input: path (or filePath, dir, directory), optional maxEntries, includeHidden, recursive, maxDepth.",
     tags: ["filesystem", "read", "core"],
     capabilities: ["read:fs"],
     sideEffect: "none"
@@ -3614,7 +3778,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/fs.searchText",
     kind: "core",
-    description: "Search for text patterns in files within the sandbox",
+    description: "Search for text patterns in files within the sandbox. Input: root (or path, dir, directory), query (or q), optional glob, maxMatches, maxFiles.",
     tags: ["filesystem", "search", "core"],
     capabilities: ["read:fs"],
     sideEffect: "none"
@@ -3622,7 +3786,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/fs.sha256",
     kind: "core",
-    description: "Compute SHA-256 hash of a file in the sandbox",
+    description: "Compute SHA-256 hash of a file in the sandbox. Input: path (or filePath).",
     tags: ["filesystem", "hash", "core"],
     capabilities: ["read:fs"],
     sideEffect: "none"
@@ -3630,7 +3794,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/fs.deletePath",
     kind: "core",
-    description: "Delete a file or directory in the sandbox (dangerous, requires explicit confirmation)",
+    description: "Delete a file or directory in the sandbox (dangerous, requires explicit confirmation). Input: path (or filePath), confirm=true, optional recursive.",
     tags: ["filesystem", "delete", "dangerous", "core"],
     capabilities: ["danger:destructive", "write:fs"],
     sideEffect: "destructive"
@@ -3639,7 +3803,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/http.fetchText",
     kind: "core",
-    description: "Fetch a URL and return the response as text",
+    description: "Fetch a URL and return the response as text. Input: url (or uri), optional method, headers, body, timeoutMs, maxBytes.",
     tags: ["http", "network", "core"],
     capabilities: ["network"],
     sideEffect: "none"
@@ -3647,7 +3811,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/http.fetchJson",
     kind: "core",
-    description: "Fetch a URL and return the response as parsed JSON",
+    description: "Fetch a URL and return the response as parsed JSON. Input: url (or uri), optional method, headers, body, timeoutMs, maxBytes.",
     tags: ["http", "network", "json", "core"],
     capabilities: ["network"],
     sideEffect: "none"
@@ -3655,7 +3819,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/http.downloadFile",
     kind: "core",
-    description: "Download a file from a URL to the sandbox",
+    description: "Download a file from a URL to the sandbox. Input: url (or uri), destPath (or destination, filePath), optional headers, timeoutMs, maxBytes, overwrite.",
     tags: ["http", "network", "download", "core"],
     capabilities: ["network", "write:fs"],
     sideEffect: "local_write"
@@ -3663,7 +3827,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/http.head",
     kind: "core",
-    description: "Send a HEAD request to get response headers without body",
+    description: "Send a HEAD request to get response headers without body. Input: url (or uri), optional headers, timeoutMs.",
     tags: ["http", "network", "core"],
     capabilities: ["network"],
     sideEffect: "none"
@@ -3671,7 +3835,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/http.duckduckgoSearch",
     kind: "core",
-    description: "Search DuckDuckGo via Instant Answer API (no API key). Add api.duckduckgo.com to allowedHosts.",
+    description: "Search DuckDuckGo via Instant Answer API (no API key). Add api.duckduckgo.com to allowedHosts. Input: use 'query' (or 'q') for the search string, optional 'maxResults'.",
     tags: ["http", "search", "duckduckgo", "core"],
     capabilities: ["network"],
     sideEffect: "none"
@@ -3679,16 +3843,24 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/http.fetchPageMainContent",
     kind: "core",
-    description: "Fetch a URL and return only the main content (main/article/body text). Strips nav, header, footer, scripts.",
+    description: "Fetch a URL and return only the main content (main/article/body text). Strips nav, header, footer, scripts. Input: url (or uri), optional timeoutMs, maxBytes.",
     tags: ["http", "network", "html", "main-content", "core"],
     capabilities: ["network"],
     sideEffect: "none"
   },
+  {
+    name: "core/http.yahooFinanceQuote",
+    kind: "core",
+    description: "Fetch stock quote(s) from Yahoo Finance chart API (no API key). Add query1.finance.yahoo.com to allowedHosts. Input: symbols (or symbol, tickers), optional range, timeoutMs.",
+    tags: ["http", "finance", "yahoo", "stock", "quote", "core"],
+    capabilities: ["network"],
+    sideEffect: "none"
+  },
   // Utils
   {
     name: "core/util.json.select",
     kind: "core",
-    description: "Select fields from JSON data using JMESPath expressions",
+    description: "Select fields from JSON data using JMESPath expressions. Input: json, path (or expression).",
     tags: ["util", "json", "core"],
     capabilities: [],
     sideEffect: "none"
@@ -3729,7 +3901,7 @@ var CORE_TOOL_MANIFEST = [
   {
     name: "core/exec.runCommand",
     kind: "core",
-    description: "Run a Linux command in the sandbox (allowlist, timeout, no shell). Command name only; args as array.",
+    description: "Run a Linux command in the sandbox (allowlist, timeout, no shell). Input: command (or cmd), optional args (or arguments), cwd, timeoutMs.",
     tags: ["exec", "shell", "linux", "core"],
     capabilities: ["exec"],
     sideEffect: "local_write"
@@ -3748,6 +3920,7 @@ var CORE_TOOL_HANDLERS = [
   headHandler,
   duckduckgoSearchHandler,
   fetchPageMainContentHandler,
+  yahooFinanceQuoteHandler,
   jsonSelectHandler,
   truncateHandler,
   hashTextHandler,
@@ -3765,14 +3938,15 @@ var fetchTextSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[6]);
 var fetchJsonSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[7]);
 var downloadFileSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[8]);
 var headSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[9]);
-var jsonSelectSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[10]);
-var truncateSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[11]);
-var hashTextSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[12]);
-var nowSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[13]);
-var templateRenderSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[14]);
-var runCommandSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[15]);
-var duckduckgoSearchSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[16]);
-var fetchPageMainContentSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[17]);
+var duckduckgoSearchSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[10]);
+var fetchPageMainContentSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[11]);
+var yahooFinanceQuoteSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[12]);
+var jsonSelectSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[13]);
+var truncateSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[14]);
+var hashTextSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[15]);
+var nowSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[16]);
+var templateRenderSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[17]);
+var runCommandSpec = (0, import_core.createToolSpec)(CORE_TOOL_MANIFEST[18]);
 var CORE_GROUP_PREFIX = {
   fs: "core/fs.",
   http: "core/http.",
@@ -3827,7 +4001,8 @@ function registerCoreTools(registry, userConfig, options) {
   templateRenderSpec,
   truncateSpec,
   validateUrl,
-  writeTextSpec
+  writeTextSpec,
+  yahooFinanceQuoteSpec
 });
 /*! Bundled license information: