@easynet/agent-tool-buildin 0.0.1 → 0.0.2

package/dist/index.js

@@ -150,7 +150,10 @@ function isWithinRoot(path, root) {
 import { createTaggedError as createTaggedError2 } from "@easynet/agent-tool";
 var readTextHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const inputPath = args.path;
+  const inputPath = (args.path ?? args.filePath)?.trim();
+  if (!inputPath) {
+    throw createTaggedError2("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 stat(resolvedPath);
@@ -185,8 +188,11 @@ import { createHash } from "crypto";
 import { dirname as dirname2 } from "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);
@@ -232,7 +238,10 @@ import { readdir, stat as stat2 } from "fs/promises";
 import { resolve as resolve2, join } from "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;
@@ -324,8 +333,14 @@ import { createInterface } from "readline";
 import { join as join2, relative } from "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;
@@ -444,9 +459,13 @@ function escapeRegExp(str) {
 import { createReadStream as createReadStream2 } from "fs";
 import { stat as stat4 } from "fs/promises";
 import { createHash as createHash2 } from "crypto";
+import { createTaggedError as createTaggedError3 } from "@easynet/agent-tool";
 var sha256Handler = (async (args) => {
   const ctx = getBuiltinContext();
-  const inputPath = args.path;
+  const inputPath = (args.path ?? args.filePath)?.trim();
+  if (!inputPath) {
+    throw createTaggedError3("FS_INVALID", "path is required (pass 'path' or 'filePath')", {});
+  }
   const resolvedPath = await resolveSandboxedPath(inputPath, ctx.config.sandboxRoot);
   const fileStat = await stat4(resolvedPath);
   const hash = await new Promise((resolve3, reject) => {
@@ -477,7 +496,10 @@ var sha256Handler = (async (args) => {
 import { rm, unlink, rmdir, stat as stat5 } from "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) {
@@ -526,20 +548,20 @@ var deletePathHandler = (async (args) => {
 
 // security/ssrf.ts
 import { lookup } from "dns/promises";
-import { createTaggedError as createTaggedError3 } from "@easynet/agent-tool";
+import { createTaggedError as createTaggedError4 } from "@easynet/agent-tool";
 async function validateUrl(url, allowedHosts, blockedCidrs) {
   let parsed;
   try {
     parsed = new URL(url);
   } catch {
-    throw createTaggedError3(
+    throw createTaggedError4(
       "HTTP_DISALLOWED_HOST",
       `Invalid URL: ${url}`,
       { url }
     );
   }
   if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-    throw createTaggedError3(
+    throw createTaggedError4(
       "HTTP_DISALLOWED_HOST",
       `Protocol not allowed: ${parsed.protocol}. Only http: and https: are supported.`,
       { url, protocol: parsed.protocol }
@@ -547,7 +569,7 @@ async function validateUrl(url, allowedHosts, blockedCidrs) {
   }
   const hostname = parsed.hostname;
   if (!isHostAllowed(hostname, allowedHosts)) {
-    throw createTaggedError3(
+    throw createTaggedError4(
       "HTTP_DISALLOWED_HOST",
       `Host "${hostname}" is not in the allowed hosts list`,
       { url, hostname, allowedHosts }
@@ -556,7 +578,7 @@ async function validateUrl(url, allowedHosts, blockedCidrs) {
   try {
     const { address } = await lookup(hostname);
     if (isIpInBlockedCidrs(address, blockedCidrs)) {
-      throw createTaggedError3(
+      throw createTaggedError4(
         "HTTP_DISALLOWED_HOST",
         `Host "${hostname}" resolves to blocked IP: ${address}`,
         { url, hostname, resolvedIp: address }
@@ -566,7 +588,7 @@ async function validateUrl(url, allowedHosts, blockedCidrs) {
     if (err instanceof Error && err.kind === "HTTP_DISALLOWED_HOST") {
       throw err;
     }
-    throw createTaggedError3(
+    throw createTaggedError4(
       "HTTP_DISALLOWED_HOST",
       `DNS resolution failed for host "${hostname}": ${err instanceof Error ? err.message : String(err)}`,
       { url, hostname }
@@ -677,10 +699,13 @@ function expandIpv6(ip) {
 }
 
 // http/fetchText.ts
-import { createTaggedError as createTaggedError4 } from "@easynet/agent-tool";
+import { createTaggedError as createTaggedError5 } from "@easynet/agent-tool";
 var fetchTextHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const url = args.url;
+  const url = (args.url ?? args.uri)?.trim();
+  if (!url) {
+    throw createTaggedError5("HTTP_INVALID", "url is required (pass 'url' or 'uri')", {});
+  }
   const method = args.method ?? "GET";
   const headers = args.headers ?? {};
   const body = args.body ?? void 0;
@@ -702,13 +727,13 @@ var fetchTextHandler = (async (args) => {
     });
   } catch (err) {
     if (err instanceof Error && err.name === "AbortError") {
-      throw createTaggedError4(
+      throw createTaggedError5(
         "HTTP_TIMEOUT",
         `Request to ${url} timed out after ${timeoutMs}ms`,
         { url, timeoutMs }
       );
     }
-    throw createTaggedError4(
+    throw createTaggedError5(
       "UPSTREAM_ERROR",
       `Fetch failed for ${url}: ${err instanceof Error ? err.message : String(err)}`,
       { url }
@@ -718,7 +743,7 @@ var fetchTextHandler = (async (args) => {
   }
   const contentLength = response.headers.get("content-length");
   if (contentLength && parseInt(contentLength, 10) > maxBytes) {
-    throw createTaggedError4(
+    throw createTaggedError5(
       "HTTP_TOO_LARGE",
       `Response Content-Length ${contentLength} exceeds limit of ${maxBytes} bytes`,
       { url, contentLength: parseInt(contentLength, 10), limit: maxBytes }
@@ -763,7 +788,7 @@ async function readResponseWithLimit(response, maxBytes, url) {
       totalBytes += value.byteLength;
       if (totalBytes > maxBytes) {
         reader.cancel();
-        throw createTaggedError4(
+        throw createTaggedError5(
           "HTTP_TOO_LARGE",
           `Response body exceeded limit of ${maxBytes} bytes while reading from ${url}`,
           { url, bytesRead: totalBytes, limit: maxBytes }
@@ -779,10 +804,13 @@ async function readResponseWithLimit(response, maxBytes, url) {
 }
 
 // http/fetchJson.ts
-import { createTaggedError as createTaggedError5 } from "@easynet/agent-tool";
+import { createTaggedError as createTaggedError6 } from "@easynet/agent-tool";
 var fetchJsonHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const url = args.url;
+  const url = (args.url ?? args.uri)?.trim();
+  if (!url) {
+    throw createTaggedError6("HTTP_INVALID", "url is required (pass 'url' or 'uri')", {});
+  }
   const method = args.method ?? "GET";
   const headers = args.headers ?? {};
   const body = args.body ?? void 0;
@@ -807,13 +835,13 @@ var fetchJsonHandler = (async (args) => {
     });
   } catch (err) {
     if (err instanceof Error && err.name === "AbortError") {
-      throw createTaggedError5(
+      throw createTaggedError6(
         "HTTP_TIMEOUT",
         `Request to ${url} timed out after ${timeoutMs}ms`,
         { url, timeoutMs }
       );
     }
-    throw createTaggedError5(
+    throw createTaggedError6(
       "UPSTREAM_ERROR",
       `Fetch failed for ${url}: ${err instanceof Error ? err.message : String(err)}`,
       { url }
@@ -823,7 +851,7 @@ var fetchJsonHandler = (async (args) => {
   }
   const contentLength = response.headers.get("content-length");
   if (contentLength && parseInt(contentLength, 10) > maxBytes) {
-    throw createTaggedError5(
+    throw createTaggedError6(
       "HTTP_TOO_LARGE",
       `Response Content-Length ${contentLength} exceeds limit of ${maxBytes} bytes`,
       { url, contentLength: parseInt(contentLength, 10), limit: maxBytes }
@@ -832,7 +860,7 @@ var fetchJsonHandler = (async (args) => {
   const text = await response.text();
   const bytes = Buffer.byteLength(text, "utf-8");
   if (bytes > maxBytes) {
-    throw createTaggedError5(
+    throw createTaggedError6(
       "HTTP_TOO_LARGE",
       `Response body ${bytes} bytes exceeds limit of ${maxBytes} bytes`,
       { url, bytes, limit: maxBytes }
@@ -842,7 +870,7 @@ var fetchJsonHandler = (async (args) => {
   try {
     json = JSON.parse(text);
   } catch {
-    throw createTaggedError5(
+    throw createTaggedError6(
       "UPSTREAM_ERROR",
       `Failed to parse JSON response from ${url}: ${text.slice(0, 200)}`,
       { url, status: response.status, textPreview: text.slice(0, 500) }
@@ -870,11 +898,17 @@ var fetchJsonHandler = (async (args) => {
 import { writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
 import { createHash as createHash3 } from "crypto";
 import { dirname as dirname3 } from "path";
-import { createTaggedError as createTaggedError6 } from "@easynet/agent-tool";
+import { createTaggedError as createTaggedError7 } from "@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 createTaggedError7("HTTP_INVALID", "url is required (pass 'url' or 'uri')", {});
+  }
+  const destPath = (args.destPath ?? args.destination ?? args.filePath)?.trim();
+  if (!destPath) {
+    throw createTaggedError7("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;
@@ -909,13 +943,13 @@ var downloadFileHandler = (async (args) => {
     });
   } catch (err) {
     if (err instanceof Error && err.name === "AbortError") {
-      throw createTaggedError6(
+      throw createTaggedError7(
         "HTTP_TIMEOUT",
         `Download from ${url} timed out after ${timeoutMs}ms`,
         { url, timeoutMs }
       );
     }
-    throw createTaggedError6(
+    throw createTaggedError7(
       "UPSTREAM_ERROR",
       `Download failed for ${url}: ${err instanceof Error ? err.message : String(err)}`,
       { url }
@@ -925,14 +959,14 @@ var downloadFileHandler = (async (args) => {
   }
   const contentLength = response.headers.get("content-length");
   if (contentLength && parseInt(contentLength, 10) > maxBytes) {
-    throw createTaggedError6(
+    throw createTaggedError7(
       "HTTP_TOO_LARGE",
       `Download Content-Length ${contentLength} exceeds limit of ${maxBytes} bytes`,
       { url, contentLength: parseInt(contentLength, 10), limit: maxBytes }
     );
   }
   if (!response.body) {
-    throw createTaggedError6("UPSTREAM_ERROR", `No response body from ${url}`, { url });
+    throw createTaggedError7("UPSTREAM_ERROR", `No response body from ${url}`, { url });
   }
   const reader = response.body.getReader();
   const chunks = [];
@@ -945,7 +979,7 @@ var downloadFileHandler = (async (args) => {
       totalBytes += value.byteLength;
       if (totalBytes > maxBytes) {
         reader.cancel();
-        throw createTaggedError6(
+        throw createTaggedError7(
           "HTTP_TOO_LARGE",
           `Download from ${url} exceeded limit of ${maxBytes} bytes (received ${totalBytes})`,
           { url, bytesRead: totalBytes, limit: maxBytes }
@@ -987,10 +1021,13 @@ var downloadFileHandler = (async (args) => {
 });
 
 // http/head.ts
-import { createTaggedError as createTaggedError7 } from "@easynet/agent-tool";
+import { createTaggedError as createTaggedError8 } from "@easynet/agent-tool";
 var headHandler = (async (args) => {
   const ctx = getBuiltinContext();
-  const url = args.url;
+  const url = (args.url ?? args.uri)?.trim();
+  if (!url) {
+    throw createTaggedError8("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);
@@ -1008,13 +1045,13 @@ var headHandler = (async (args) => {
     });
   } catch (err) {
     if (err instanceof Error && err.name === "AbortError") {
-      throw createTaggedError7(
+      throw createTaggedError8(
         "HTTP_TIMEOUT",
         `HEAD request to ${url} timed out after ${timeoutMs}ms`,
         { url, timeoutMs }
       );
     }
-    throw createTaggedError7(
+    throw createTaggedError8(
       "UPSTREAM_ERROR",
       `HEAD request failed for ${url}: ${err instanceof Error ? err.message : String(err)}`,
       { url }
@@ -1044,13 +1081,13 @@ var headHandler = (async (args) => {
 });
 
 // http/duckduckgoSearch.ts
-import { createTaggedError as createTaggedError8 } from "@easynet/agent-tool";
+import { createTaggedError as createTaggedError9 } from "@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 createTaggedError8("DUCKDUCKGO_INVALID", "query is required", {});
+    throw createTaggedError9("DUCKDUCKGO_INVALID", "query is required (pass 'query' or 'q')", {});
   }
   const timeoutMs = args.timeoutMs ?? ctx.config.defaultTimeoutMs;
   const maxResults = args.maxResults ?? 10;
@@ -1068,13 +1105,13 @@ var duckduckgoSearchHandler = (async (args) => {
   } catch (err) {
     clearTimeout(timer);
     if (err instanceof Error && err.name === "AbortError") {
-      throw createTaggedError8(
+      throw createTaggedError9(
         "HTTP_TIMEOUT",
         `DuckDuckGo search timed out after ${timeoutMs}ms`,
         { query, timeoutMs }
       );
     }
-    throw createTaggedError8(
+    throw createTaggedError9(
       "UPSTREAM_ERROR",
       `DuckDuckGo search failed: ${err instanceof Error ? err.message : String(err)}`,
       { query }
@@ -1085,7 +1122,7 @@ var duckduckgoSearchHandler = (async (args) => {
   const text = await response.text();
   const bytes = Buffer.byteLength(text, "utf-8");
   if (bytes > maxBytes) {
-    throw createTaggedError8(
+    throw createTaggedError9(
       "HTTP_TOO_LARGE",
       `DuckDuckGo response ${bytes} bytes exceeds limit of ${maxBytes} bytes`,
       { query, bytes, limit: maxBytes }
@@ -1095,7 +1132,7 @@ var duckduckgoSearchHandler = (async (args) => {
   try {
     raw = JSON.parse(text);
   } catch {
-    throw createTaggedError8(
+    throw createTaggedError9(
       "UPSTREAM_ERROR",
       `DuckDuckGo returned invalid JSON`,
       { query, textPreview: text.slice(0, 200) }
@@ -1146,7 +1183,7 @@ var duckduckgoSearchHandler = (async (args) => {
 
 // http/fetchPageMainContent.ts
 import { parse } from "node-html-parser";
-import { createTaggedError as createTaggedError9 } from "@easynet/agent-tool";
+import { createTaggedError as createTaggedError10 } from "@easynet/agent-tool";
 var MAIN_SELECTORS = [
   "main",
   "article",
@@ -1187,7 +1224,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 createTaggedError10("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);
@@ -1203,13 +1243,13 @@ var fetchPageMainContentHandler = (async (args) => {
   } catch (err) {
     clearTimeout(timer);
     if (err instanceof Error && err.name === "AbortError") {
-      throw createTaggedError9(
+      throw createTaggedError10(
         "HTTP_TIMEOUT",
         `Request to ${url} timed out after ${timeoutMs}ms`,
         { url, timeoutMs }
       );
     }
-    throw createTaggedError9(
+    throw createTaggedError10(
       "UPSTREAM_ERROR",
       `Fetch failed for ${url}: ${err instanceof Error ? err.message : String(err)}`,
       { url }
@@ -1218,7 +1258,7 @@ var fetchPageMainContentHandler = (async (args) => {
   clearTimeout(timer);
   const contentLength = response.headers.get("content-length");
   if (contentLength && parseInt(contentLength, 10) > maxBytes) {
-    throw createTaggedError9(
+    throw createTaggedError10(
       "HTTP_TOO_LARGE",
       `Response Content-Length ${contentLength} exceeds limit of ${maxBytes} bytes`,
       { url, contentLength: parseInt(contentLength, 10), limit: maxBytes }
@@ -1227,7 +1267,7 @@ var fetchPageMainContentHandler = (async (args) => {
   const rawText = await response.text();
   const rawBytes = Buffer.byteLength(rawText, "utf-8");
   if (rawBytes > maxBytes) {
-    throw createTaggedError9(
+    throw createTaggedError10(
       "HTTP_TOO_LARGE",
       `Response body ${rawBytes} bytes exceeds limit of ${maxBytes} bytes`,
       { url, bytes: rawBytes, limit: maxBytes }
@@ -1269,10 +1309,133 @@ var fetchPageMainContentHandler = (async (args) => {
   };
 });
 
+// http/yahooFinance.ts
+import { createTaggedError as createTaggedError11 } from "@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 createTaggedError11(
+      "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 createTaggedError11(
+          "HTTP_TIMEOUT",
+          `Yahoo Finance request for ${symbol} timed out after ${timeoutMs}ms`,
+          { symbol, timeoutMs }
+        );
+      }
+      throw createTaggedError11(
+        "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 createTaggedError11(
+        "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 createTaggedError11(
+        "UPSTREAM_ERROR",
+        "Yahoo Finance returned invalid JSON",
+        { symbol, textPreview: text.slice(0, 200) }
+      );
+    }
+    const error = data.chart?.error;
+    if (error?.description) {
+      throw createTaggedError11(
+        "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 import("./jmespath-6W7SK7AH.js");
@@ -1429,37 +1592,37 @@ var templateRenderHandler = (async (args) => {
 // exec/runCommand.ts
 import { spawn } from "child_process";
 import { resolve as pathResolve } from "path";
-import { createTaggedError as createTaggedError10 } from "@easynet/agent-tool";
+import { createTaggedError as createTaggedError12 } from "@easynet/agent-tool";
 var runCommandHandler = (async (args) => {
   const ctx = getBuiltinContext();
   const { allowedCommands, maxCommandOutputBytes, commandTimeoutMs } = ctx.config;
   if (!allowedCommands.length) {
-    throw createTaggedError10(
+    throw createTaggedError12(
       "EXEC_DISABLED",
       "Exec is disabled: allowedCommands is empty",
       {}
     );
   }
-  const rawCommand = args.command?.trim();
+  const rawCommand = (args.command ?? args.cmd)?.trim();
   if (!rawCommand) {
-    throw createTaggedError10("EXEC_INVALID", "command is required", {});
+    throw createTaggedError12("EXEC_INVALID", "command is required (pass 'command' or 'cmd')", {});
   }
   const baseName = rawCommand.replace(/^.*\//, "").trim();
   if (baseName !== rawCommand || /[;&|$`\s]/.test(rawCommand)) {
-    throw createTaggedError10(
+    throw createTaggedError12(
       "EXEC_INVALID",
       "command must be a single executable name (no path, no shell chars)",
       { command: rawCommand }
     );
   }
   if (!allowedCommands.includes(baseName)) {
-    throw createTaggedError10(
+    throw createTaggedError12(
       "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 = pathResolve(ctx.config.sandboxRoot);
   if (args.cwd != null && args.cwd !== "") {
@@ -1480,7 +1643,7 @@ var runCommandHandler = (async (args) => {
       if (totalBytes + len > maxCommandOutputBytes) {
         proc.kill("SIGKILL");
         rejectPromise(
-          createTaggedError10(
+          createTaggedError12(
             "EXEC_OUTPUT_TOO_LARGE",
             `Command output exceeded ${maxCommandOutputBytes} bytes`,
             { maxBytes: maxCommandOutputBytes }
@@ -1518,7 +1681,7 @@ var runCommandHandler = (async (args) => {
     proc.on("error", (err) => {
       clearTimeout(timeout);
       rejectPromise(
-        createTaggedError10("EXEC_SPAWN_ERROR", err.message, { command: baseName })
+        createTaggedError12("EXEC_SPAWN_ERROR", err.message, { command: baseName })
       );
     });
     proc.on("close", (code, signal) => {
@@ -1550,7 +1713,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"
@@ -1558,7 +1721,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"
@@ -1566,7 +1729,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"
@@ -1574,7 +1737,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"
@@ -1582,7 +1745,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"
@@ -1590,7 +1753,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"
@@ -1599,7 +1762,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"
@@ -1607,7 +1770,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"
@@ -1615,7 +1778,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"
@@ -1623,7 +1786,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"
@@ -1631,7 +1794,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"
@@ -1639,16 +1802,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"
@@ -1689,7 +1860,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"
@@ -1708,6 +1879,7 @@ var CORE_TOOL_HANDLERS = [
   headHandler,
   duckduckgoSearchHandler,
   fetchPageMainContentHandler,
+  yahooFinanceQuoteHandler,
   jsonSelectHandler,
   truncateHandler,
   hashTextHandler,
@@ -1725,14 +1897,15 @@ var fetchTextSpec = createToolSpec(CORE_TOOL_MANIFEST[6]);
 var fetchJsonSpec = createToolSpec(CORE_TOOL_MANIFEST[7]);
 var downloadFileSpec = createToolSpec(CORE_TOOL_MANIFEST[8]);
 var headSpec = createToolSpec(CORE_TOOL_MANIFEST[9]);
-var jsonSelectSpec = createToolSpec(CORE_TOOL_MANIFEST[10]);
-var truncateSpec = createToolSpec(CORE_TOOL_MANIFEST[11]);
-var hashTextSpec = createToolSpec(CORE_TOOL_MANIFEST[12]);
-var nowSpec = createToolSpec(CORE_TOOL_MANIFEST[13]);
-var templateRenderSpec = createToolSpec(CORE_TOOL_MANIFEST[14]);
-var runCommandSpec = createToolSpec(CORE_TOOL_MANIFEST[15]);
-var duckduckgoSearchSpec = createToolSpec(CORE_TOOL_MANIFEST[16]);
-var fetchPageMainContentSpec = createToolSpec(CORE_TOOL_MANIFEST[17]);
+var duckduckgoSearchSpec = createToolSpec(CORE_TOOL_MANIFEST[10]);
+var fetchPageMainContentSpec = createToolSpec(CORE_TOOL_MANIFEST[11]);
+var yahooFinanceQuoteSpec = createToolSpec(CORE_TOOL_MANIFEST[12]);
+var jsonSelectSpec = createToolSpec(CORE_TOOL_MANIFEST[13]);
+var truncateSpec = createToolSpec(CORE_TOOL_MANIFEST[14]);
+var hashTextSpec = createToolSpec(CORE_TOOL_MANIFEST[15]);
+var nowSpec = createToolSpec(CORE_TOOL_MANIFEST[16]);
+var templateRenderSpec = createToolSpec(CORE_TOOL_MANIFEST[17]);
+var runCommandSpec = createToolSpec(CORE_TOOL_MANIFEST[18]);
 var CORE_GROUP_PREFIX = {
   fs: "core/fs.",
   http: "core/http.",
@@ -1786,6 +1959,7 @@ export {
   templateRenderSpec,
   truncateSpec,
   validateUrl,
-  writeTextSpec
+  writeTextSpec,
+  yahooFinanceQuoteSpec
 };
 //# sourceMappingURL=index.js.map