beeai-framework 0.1.2

package/dist/tools/weather/openMeteo.js

@@ -0,0 +1,218 @@
+import { JSONToolOutput, Tool, ToolError, ToolInputValidationError } from '../base.js';
+import { z } from 'zod';
+import { createURLParams } from '../../internals/fetcher.js';
+import { omit, pickBy, isNullish, pick } from 'remeda';
+import { Cache } from '../../cache/decoratorCache.js';
+import { getProp, setProp } from '../../internals/helpers/object.js';
+import { Emitter } from '../../emitter/emitter.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+class OpenMeteoToolOutput extends JSONToolOutput {
+  static {
+    __name(this, "OpenMeteoToolOutput");
+  }
+}
+class OpenMeteoTool extends Tool {
+  static {
+    __name(this, "OpenMeteoTool");
+  }
+  name = "OpenMeteo";
+  description = `Retrieve current, past, or future weather forecasts for a location.`;
+  inputSchema() {
+    return z.object({
+      location: z.union([
+        z.object({
+          name: z.string().min(1),
+          country: z.string().optional(),
+          language: z.string().default("English")
+        }).strip(),
+        z.object({
+          latitude: z.coerce.number(),
+          longitude: z.coerce.number()
+        }).strip()
+      ]),
+      start_date: z.string().date().describe("Start date for the weather forecast in the format YYYY-MM-DD (UTC)"),
+      end_date: z.string().date().describe("End date for the weather forecast in the format YYYY-MM-DD (UTC)").optional(),
+      temperature_unit: z.enum([
+        "celsius",
+        "fahrenheit"
+      ]).default("celsius")
+    }).strip();
+  }
+  emitter = Emitter.root.child({
+    namespace: [
+      "tool",
+      "weather",
+      "openMeteo"
+    ],
+    creator: this
+  });
+  static {
+    this.register();
+  }
+  constructor(options = {}) {
+    super({
+      ...options,
+      responseFilter: options?.responseFilter ?? {
+        excludedKeys: [
+          "latitude",
+          "longitude",
+          "generationtime_ms",
+          "utc_offset_seconds",
+          "timezone",
+          "timezone_abbreviation",
+          "elevation",
+          "hourly",
+          "hourly_units"
+        ]
+      }
+    });
+  }
+  preprocessInput(rawInput) {
+    super.preprocessInput(rawInput);
+    const fixDate = /* @__PURE__ */ __name((key) => {
+      const value = getProp(rawInput, [
+        key
+      ]);
+      if (value) {
+        setProp(rawInput, [
+          key
+        ], value.substring(0, 10));
+      }
+    }, "fixDate");
+    fixDate("start_date");
+    fixDate("end_date");
+  }
+  async _run({ location, start_date: startDate, end_date: endDate, ...input }, _options, run) {
+    const { apiKey } = this.options;
+    const prepareParams = /* @__PURE__ */ __name(async () => {
+      const extractLocation = /* @__PURE__ */ __name(async () => {
+        if ("name" in location) {
+          const response2 = await this._geocode(location, run.signal);
+          return pick(response2, [
+            "latitude",
+            "longitude"
+          ]);
+        }
+        return location;
+      }, "extractLocation");
+      function validateAndSetDates(startDateStr, endDateStr) {
+        const now = /* @__PURE__ */ new Date();
+        const start2 = startDateStr ? new Date(startDateStr) : new Date(Date.UTC(now.getFullYear(), now.getMonth(), now.getDate()));
+        if (endDateStr) {
+          const end2 = new Date(endDateStr);
+          if (end2 < start2) {
+            throw new ToolInputValidationError(`The 'end_date' (${endDateStr}) has to occur on or after the 'start_date' (${startDateStr}).`);
+          }
+          return {
+            start: start2,
+            end: end2
+          };
+        } else {
+          return {
+            start: start2,
+            end: new Date(start2)
+          };
+        }
+      }
+      __name(validateAndSetDates, "validateAndSetDates");
+      const { start, end } = validateAndSetDates(startDate, endDate);
+      const toDateString = /* @__PURE__ */ __name((date) => date.toISOString().split("T")[0], "toDateString");
+      return createURLParams({
+        ...pickBy(input, (v) => !isNullish(v) && v !== ""),
+        ...await extractLocation(),
+        start_date: toDateString(start),
+        end_date: toDateString(end),
+        current: [
+          "temperature_2m",
+          "rain",
+          "relative_humidity_2m",
+          "wind_speed_10m"
+        ],
+        daily: [
+          "temperature_2m_max",
+          "temperature_2m_min",
+          "rain_sum"
+        ],
+        hourly: [
+          "temperature_2m",
+          "relative_humidity_2m",
+          "rain"
+        ],
+        timezone: "UTC"
+      });
+    }, "prepareParams");
+    const params = await prepareParams();
+    const response = await fetch(`https://api.open-meteo.com/v1/forecast?${params}`, {
+      headers: {
+        ...apiKey && {
+          Authorization: `Bearer ${apiKey}`
+        }
+      },
+      signal: run.signal
+    });
+    if (!response.ok) {
+      throw new ToolError("Request to OpenMeteo API has failed!", [
+        new Error(await response.text())
+      ]);
+    }
+    let data = await response.json();
+    if (this.options?.responseFilter?.excludedKeys) {
+      data = omit(data, this.options.responseFilter.excludedKeys);
+    }
+    return new OpenMeteoToolOutput(data);
+  }
+  async _geocode(location, signal) {
+    const { apiKey } = this.options;
+    const params = createURLParams({
+      name: location.name,
+      language: location.language,
+      country: location.country,
+      format: "json",
+      count: 1
+    });
+    const response = await fetch(`https://geocoding-api.open-meteo.com/v1/search?${params}`, {
+      headers: {
+        ...apiKey && {
+          Authorization: `Bearer ${apiKey}`
+        }
+      },
+      signal
+    });
+    if (!response.ok) {
+      throw new ToolError(`Failed to GeoCode provided location (${location.name}).`, [
+        new Error(await response.text())
+      ]);
+    }
+    const { results } = await response.json();
+    if (!results || results.length === 0) {
+      throw new ToolError(`Location '${location.name}' was not found.`);
+    }
+    return results[0];
+  }
+}
+_ts_decorate([
+  Cache(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof LocationSearch === "undefined" ? Object : LocationSearch,
+    typeof AbortSignal === "undefined" ? Object : AbortSignal
+  ]),
+  _ts_metadata("design:returntype", Promise)
+], OpenMeteoTool.prototype, "_geocode", null);
+
+export { OpenMeteoTool, OpenMeteoToolOutput };
+//# sourceMappingURL=openMeteo.js.map
+//# sourceMappingURL=openMeteo.js.map

package/dist/tools/weather/openMeteo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/weather/openMeteo.ts"],"names":["OpenMeteoToolOutput","JSONToolOutput","OpenMeteoTool","Tool","name","description","inputSchema","z","object","location","union","string","min","country","optional","language","default","strip","latitude","coerce","number","longitude","start_date","date","describe","end_date","temperature_unit","enum","emitter","Emitter","root","child","namespace","creator","register","options","responseFilter","excludedKeys","preprocessInput","rawInput","fixDate","key","value","getProp","setProp","substring","_run","startDate","endDate","input","_options","run","apiKey","prepareParams","extractLocation","response","_geocode","signal","pick","validateAndSetDates","startDateStr","endDateStr","now","Date","start","UTC","getFullYear","getMonth","getDate","end","ToolInputValidationError","toDateString","toISOString","split","createURLParams","pickBy","v","isNullish","current","daily","hourly","timezone","params","fetch","headers","Authorization","ok","ToolError","Error","text","data","json","omit","format","count","results","length"],"mappings":"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","file":"openMeteo.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  BaseToolOptions,\n  BaseToolRunOptions,\n  ToolEmitter,\n  JSONToolOutput,\n  Tool,\n  ToolError,\n  ToolInput,\n  ToolInputValidationError,\n} from \"@/tools/base.js\";\nimport { z } from \"zod\";\nimport { createURLParams } from \"@/internals/fetcher.js\";\nimport { isNullish, omit, pick, pickBy } from \"remeda\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { RunContext } from \"@/context.js\";\nimport { getProp, setProp } from \"@/internals/helpers/object.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\n\nexport interface ResponseFilter {\n  excludedKeys: (keyof OpenMeteoToolResponse)[];\n}\n\ninterface ToolOptions extends BaseToolOptions {\n  apiKey?: string;\n  responseFilter?: ResponseFilter;\n}\n\ntype ToolRunOptions = BaseToolRunOptions;\n\ninterface Location {\n  latitude: number;\n  longitude: number;\n}\n\ninterface LocationSearch {\n  name: string;\n  country?: string;\n  language?: string;\n}\n\nexport interface OpenMeteoToolResponse {\n  latitude?: number;\n  longitude?: number;\n  generationtime_ms?: number;\n  utc_offset_seconds?: number;\n  timezone?: string;\n  timezone_abbreviation?: string;\n  elevation?: number;\n  current_units?: Record<string, string>;\n  current?: Record<string, string>;\n  hourly_units?: Record<string, string>;\n  hourly?: Record<string, any[]>;\n  daily_units?: Record<string, string>;\n  daily?: Record<string, any[]>;\n}\n\nexport class OpenMeteoToolOutput extends JSONToolOutput<OpenMeteoToolResponse> {}\n\nexport class OpenMeteoTool extends Tool<OpenMeteoToolOutput, ToolOptions, ToolRunOptions> {\n  name = \"OpenMeteo\";\n  description = `Retrieve current, past, or future weather forecasts for a location.`;\n\n  inputSchema() {\n    return z\n      .object({\n        location: z.union([\n          z\n            .object({\n              name: z.string().min(1),\n              country: z.string().optional(),\n              language: z.string().default(\"English\"),\n            })\n            .strip(),\n          z\n            .object({\n              latitude: z.coerce.number(),\n              longitude: z.coerce.number(),\n            })\n            .strip(),\n        ]),\n        start_date: z\n          .string()\n          .date()\n          .describe(\"Start date for the weather forecast in the format YYYY-MM-DD (UTC)\"),\n        end_date: z\n          .string()\n          .date()\n          .describe(\"End date for the weather forecast in the format YYYY-MM-DD (UTC)\")\n          .optional(),\n        temperature_unit: z.enum([\"celsius\", \"fahrenheit\"]).default(\"celsius\"),\n      })\n      .strip();\n  }\n\n  public readonly emitter: ToolEmitter<ToolInput<this>, OpenMeteoToolOutput> = Emitter.root.child({\n    namespace: [\"tool\", \"weather\", \"openMeteo\"],\n    creator: this,\n  });\n\n  static {\n    this.register();\n  }\n\n  public constructor(options: Partial<ToolOptions> = {}) {\n    super({\n      ...options,\n      responseFilter: options?.responseFilter ?? {\n        excludedKeys: [\n          \"latitude\",\n          \"longitude\",\n          \"generationtime_ms\",\n          \"utc_offset_seconds\",\n          \"timezone\",\n          \"timezone_abbreviation\",\n          \"elevation\",\n          \"hourly\",\n          \"hourly_units\",\n        ],\n      },\n    });\n  }\n\n  protected preprocessInput(rawInput: unknown) {\n    super.preprocessInput(rawInput);\n\n    const fixDate = (key: keyof ToolInput<this>) => {\n      const value = getProp(rawInput, [key]);\n      if (value) {\n        setProp(rawInput, [key], value.substring(0, 10));\n      }\n    };\n\n    fixDate(\"start_date\");\n    fixDate(\"end_date\");\n  }\n\n  protected async _run(\n    { location, start_date: startDate, end_date: endDate, ...input }: ToolInput<this>,\n    _options: Partial<BaseToolRunOptions>,\n    run: RunContext<this>,\n  ) {\n    const { apiKey } = this.options;\n\n    const prepareParams = async () => {\n      const extractLocation = async (): Promise<Location> => {\n        if (\"name\" in location) {\n          const response = await this._geocode(location, run.signal);\n          return pick(response, [\"latitude\", \"longitude\"]);\n        }\n        return location;\n      };\n\n      function validateAndSetDates(\n        startDateStr: string,\n        endDateStr?: string,\n      ): { start: Date; end: Date } {\n        const now = new Date();\n        const start = startDateStr\n          ? new Date(startDateStr)\n          : new Date(Date.UTC(now.getFullYear(), now.getMonth(), now.getDate()));\n\n        if (endDateStr) {\n          const end = new Date(endDateStr);\n          if (end < start) {\n            throw new ToolInputValidationError(\n              `The 'end_date' (${endDateStr}) has to occur on or after the 'start_date' (${startDateStr}).`,\n            );\n          }\n          return { start: start, end: end };\n        } else {\n          // If endDate is undefined, set it to the start date\n          return { start: start, end: new Date(start) };\n        }\n      }\n\n      const { start, end } = validateAndSetDates(startDate, endDate);\n\n      const toDateString = (date: Date) => date.toISOString().split(\"T\")[0];\n\n      return createURLParams({\n        ...pickBy(input, (v) => !isNullish(v) && v !== \"\"),\n        ...(await extractLocation()),\n        start_date: toDateString(start),\n        end_date: toDateString(end),\n        current: [\"temperature_2m\", \"rain\", \"relative_humidity_2m\", \"wind_speed_10m\"],\n        daily: [\"temperature_2m_max\", \"temperature_2m_min\", \"rain_sum\"],\n        hourly: [\"temperature_2m\", \"relative_humidity_2m\", \"rain\"],\n        timezone: \"UTC\",\n      });\n    };\n\n    const params = await prepareParams();\n    const response = await fetch(`https://api.open-meteo.com/v1/forecast?${params}`, {\n      headers: {\n        ...(apiKey && {\n          Authorization: `Bearer ${apiKey}`,\n        }),\n      },\n      signal: run.signal,\n    });\n\n    if (!response.ok) {\n      throw new ToolError(\"Request to OpenMeteo API has failed!\", [\n        new Error(await response.text()),\n      ]);\n    }\n\n    let data: OpenMeteoToolResponse = await response.json();\n\n    if (this.options?.responseFilter?.excludedKeys) {\n      data = omit(data, this.options.responseFilter.excludedKeys);\n    }\n\n    return new OpenMeteoToolOutput(data);\n  }\n\n  @Cache()\n  protected async _geocode(location: LocationSearch, signal: AbortSignal) {\n    const { apiKey } = this.options;\n\n    const params = createURLParams({\n      name: location.name,\n      language: location.language,\n      country: location.country,\n      format: \"json\",\n      count: 1,\n    });\n    const response = await fetch(`https://geocoding-api.open-meteo.com/v1/search?${params}`, {\n      headers: {\n        ...(apiKey && {\n          Authorization: `Bearer ${apiKey}`,\n        }),\n      },\n      signal,\n    });\n    if (!response.ok) {\n      throw new ToolError(`Failed to GeoCode provided location (${location.name}).`, [\n        new Error(await response.text()),\n      ]);\n    }\n\n    const { results } = await response.json();\n    if (!results || results.length === 0) {\n      throw new ToolError(`Location '${location.name}' was not found.`);\n    }\n    return results[0];\n  }\n}\n"]}

package/dist/tools/web/webCrawler.cjs

@@ -0,0 +1,111 @@
+'use strict';
+
+var base_cjs = require('../base.cjs');
+var zod = require('zod');
+var decoratorCache_cjs = require('../../cache/decoratorCache.cjs');
+var stringStripHtml = require('string-strip-html');
+var emitter_cjs = require('../../emitter/emitter.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+class WebCrawlerToolOutput extends base_cjs.JSONToolOutput {
+  static {
+    __name(this, "WebCrawlerToolOutput");
+  }
+  getTextContent() {
+    return [
+      `URL: ${this.result.url}`,
+      `STATUS: ${this.result.statusCode} (${this.result.statusText})`,
+      `CONTENT-TYPE: ${this.result.contentType}`,
+      `CONTENT: ${this.result.content}`
+    ].join("\n");
+  }
+}
+_ts_decorate([
+  decoratorCache_cjs.Cache(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", []),
+  _ts_metadata("design:returntype", String)
+], WebCrawlerToolOutput.prototype, "getTextContent", null);
+async function defaultParser(response) {
+  const text = await response.text();
+  if (text) {
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("text/html")) {
+      return stringStripHtml.stripHtml(text).result;
+    }
+  }
+  return text || "No Content";
+}
+__name(defaultParser, "defaultParser");
+class WebCrawlerTool extends base_cjs.Tool {
+  static {
+    __name(this, "WebCrawlerTool");
+  }
+  name = "WebCrawler";
+  description = `Retrieves content of an arbitrary website.`;
+  inputSchema() {
+    return zod.z.object({
+      url: zod.z.string().url().describe("Website URL")
+    });
+  }
+  client;
+  parser;
+  emitter = emitter_cjs.Emitter.root.child({
+    namespace: [
+      "tool",
+      "webCrawler"
+    ],
+    creator: this
+  });
+  constructor({ client, parser, ...options } = {}) {
+    super(options);
+    this.client = client ?? fetch;
+    this.parser = parser ?? defaultParser;
+  }
+  async _run({ url }, _options, run) {
+    const response = await this.client(url, {
+      redirect: "follow",
+      ...this.options.request,
+      signal: run.signal
+    });
+    const content = await this.parser(response);
+    return new WebCrawlerToolOutput({
+      url,
+      statusCode: response.status,
+      statusText: response.statusText,
+      contentType: response.headers.get("content-type") ?? "unknown",
+      content
+    });
+  }
+  createSnapshot() {
+    return {
+      ...super.createSnapshot(),
+      client: this.client,
+      parser: this.parser
+    };
+  }
+  loadSnapshot({ client, parser, ...snapshot }) {
+    super.loadSnapshot(snapshot);
+    Object.assign(this, {
+      client: client ?? fetch,
+      parser: parser ?? defaultParser
+    });
+  }
+}
+
+exports.WebCrawlerTool = WebCrawlerTool;
+exports.WebCrawlerToolOutput = WebCrawlerToolOutput;
+//# sourceMappingURL=webCrawler.cjs.map
+//# sourceMappingURL=webCrawler.cjs.map

package/dist/tools/web/webCrawler.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/web/webCrawler.ts"],"names":["WebCrawlerToolOutput","JSONToolOutput","getTextContent","result","url","statusCode","statusText","contentType","content","join","defaultParser","response","text","headers","get","includes","stripHtml","WebCrawlerTool","Tool","name","description","inputSchema","z","object","string","describe","client","parser","emitter","Emitter","root","child","namespace","creator","constructor","options","fetch","_run","_options","run","redirect","request","signal","status","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":"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","file":"webCrawler.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  BaseToolOptions,\n  BaseToolRunOptions,\n  ToolEmitter,\n  JSONToolOutput,\n  Tool,\n  ToolInput,\n} from \"@/tools/base.js\";\nimport { z } from \"zod\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { stripHtml } from \"string-strip-html\";\nimport { RunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\n\ninterface CrawlerOutput {\n  url: string;\n  statusCode: number;\n  statusText: string;\n  contentType: string;\n  content: string;\n}\n\nexport class WebCrawlerToolOutput extends JSONToolOutput<CrawlerOutput> {\n  @Cache()\n  getTextContent(): string {\n    return [\n      `URL: ${this.result.url}`,\n      `STATUS: ${this.result.statusCode} (${this.result.statusText})`,\n      `CONTENT-TYPE: ${this.result.contentType}`,\n      `CONTENT: ${this.result.content}`,\n    ].join(\"\\n\");\n  }\n}\n\nexport type HttpClient = (url: string, options?: RequestInit) => Promise<HttpClientResponse>;\ninterface HttpClientResponse {\n  status: number;\n  statusText: string;\n  headers: Headers;\n  text(): Promise<string>;\n}\n\ntype Parser = (response: HttpClientResponse) => Promise<string>;\ninterface WebsiteCrawlerToolOptions extends BaseToolOptions {\n  client?: HttpClient;\n  parser?: Parser;\n  request?: RequestInit;\n}\n\nasync function defaultParser(response: HttpClientResponse) {\n  const text = await response.text();\n  if (text) {\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (contentType.includes(\"text/html\")) {\n      return stripHtml(text).result;\n    }\n  }\n  return text || \"No Content\";\n}\n\nexport class WebCrawlerTool extends Tool<WebCrawlerToolOutput, WebsiteCrawlerToolOptions> {\n  name = \"WebCrawler\";\n  description = `Retrieves content of an arbitrary website.`;\n  inputSchema() {\n    return z.object({\n      url: z.string().url().describe(\"Website URL\"),\n    });\n  }\n\n  protected client: HttpClient;\n  protected parser: Parser;\n\n  public readonly emitter: ToolEmitter<ToolInput<this>, WebCrawlerToolOutput> = Emitter.root.child({\n    namespace: [\"tool\", \"webCrawler\"],\n    creator: this,\n  });\n\n  constructor({ client, parser, ...options }: WebsiteCrawlerToolOptions = {}) {\n    super(options);\n    this.client = client ?? fetch;\n    this.parser = parser ?? defaultParser;\n  }\n\n  protected async _run(\n    { url }: ToolInput<this>,\n    _options: Partial<BaseToolRunOptions>,\n    run: RunContext<this>,\n  ) {\n    const response = await this.client(url, {\n      redirect: \"follow\",\n      ...this.options.request,\n      signal: run.signal,\n    });\n\n    const content = await this.parser(response);\n    return new WebCrawlerToolOutput({\n      url,\n      statusCode: response.status,\n      statusText: response.statusText,\n      contentType: response.headers.get(\"content-type\") ?? \"unknown\",\n      content,\n    });\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      client: this.client,\n      parser: this.parser,\n    };\n  }\n\n  loadSnapshot({ client, parser, ...snapshot }: ReturnType<typeof this.createSnapshot>) {\n    super.loadSnapshot(snapshot);\n    Object.assign(this, {\n      client: client ?? fetch,\n      parser: parser ?? defaultParser,\n    });\n  }\n}\n"]}

package/dist/tools/web/webCrawler.d.cts

@@ -0,0 +1,66 @@
+import { BaseCache } from '../../cache/base.cjs';
+import * as promise_based_task from 'promise-based-task';
+import { JSONToolOutput, Tool, ToolEmitter, ToolInput, BaseToolRunOptions, BaseToolOptions } from '../base.cjs';
+import { z } from 'zod';
+import { RunContext } from '../../context.cjs';
+import { E as Emitter } from '../../emitter-BWtGHYn0.cjs';
+import '../../internals/serializable.cjs';
+import '../../internals/types.cjs';
+import '../../internals/helpers/guards.cjs';
+import 'ajv';
+import '../../errors.cjs';
+import '../../internals/helpers/schema.cjs';
+import 'zod-to-json-schema';
+import '../../internals/helpers/promise.cjs';
+
+interface CrawlerOutput {
+    url: string;
+    statusCode: number;
+    statusText: string;
+    contentType: string;
+    content: string;
+}
+declare class WebCrawlerToolOutput extends JSONToolOutput<CrawlerOutput> {
+    getTextContent(): string;
+}
+type HttpClient = (url: string, options?: RequestInit) => Promise<HttpClientResponse>;
+interface HttpClientResponse {
+    status: number;
+    statusText: string;
+    headers: Headers;
+    text(): Promise<string>;
+}
+type Parser = (response: HttpClientResponse) => Promise<string>;
+interface WebsiteCrawlerToolOptions extends BaseToolOptions {
+    client?: HttpClient;
+    parser?: Parser;
+    request?: RequestInit;
+}
+declare class WebCrawlerTool extends Tool<WebCrawlerToolOutput, WebsiteCrawlerToolOptions> {
+    name: string;
+    description: string;
+    inputSchema(): z.ZodObject<{
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+    }, {
+        url: string;
+    }>;
+    protected client: HttpClient;
+    protected parser: Parser;
+    readonly emitter: ToolEmitter<ToolInput<this>, WebCrawlerToolOutput>;
+    constructor({ client, parser, ...options }?: WebsiteCrawlerToolOptions);
+    protected _run({ url }: ToolInput<this>, _options: Partial<BaseToolRunOptions>, run: RunContext<this>): Promise<WebCrawlerToolOutput>;
+    createSnapshot(): {
+        client: HttpClient;
+        parser: Parser;
+        name: string;
+        description: string;
+        options: WebsiteCrawlerToolOptions;
+        cache: BaseCache<promise_based_task.Task<WebCrawlerToolOutput, any>>;
+        emitter: Emitter<any>;
+    };
+    loadSnapshot({ client, parser, ...snapshot }: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { type HttpClient, WebCrawlerTool, WebCrawlerToolOutput };

package/dist/tools/web/webCrawler.d.ts

@@ -0,0 +1,66 @@
+import { BaseCache } from '../../cache/base.js';
+import * as promise_based_task from 'promise-based-task';
+import { JSONToolOutput, Tool, ToolEmitter, ToolInput, BaseToolRunOptions, BaseToolOptions } from '../base.js';
+import { z } from 'zod';
+import { RunContext } from '../../context.js';
+import { E as Emitter } from '../../emitter-l0W9gC1A.js';
+import '../../internals/serializable.js';
+import '../../internals/types.js';
+import '../../internals/helpers/guards.js';
+import 'ajv';
+import '../../errors.js';
+import '../../internals/helpers/schema.js';
+import 'zod-to-json-schema';
+import '../../internals/helpers/promise.js';
+
+interface CrawlerOutput {
+    url: string;
+    statusCode: number;
+    statusText: string;
+    contentType: string;
+    content: string;
+}
+declare class WebCrawlerToolOutput extends JSONToolOutput<CrawlerOutput> {
+    getTextContent(): string;
+}
+type HttpClient = (url: string, options?: RequestInit) => Promise<HttpClientResponse>;
+interface HttpClientResponse {
+    status: number;
+    statusText: string;
+    headers: Headers;
+    text(): Promise<string>;
+}
+type Parser = (response: HttpClientResponse) => Promise<string>;
+interface WebsiteCrawlerToolOptions extends BaseToolOptions {
+    client?: HttpClient;
+    parser?: Parser;
+    request?: RequestInit;
+}
+declare class WebCrawlerTool extends Tool<WebCrawlerToolOutput, WebsiteCrawlerToolOptions> {
+    name: string;
+    description: string;
+    inputSchema(): z.ZodObject<{
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+    }, {
+        url: string;
+    }>;
+    protected client: HttpClient;
+    protected parser: Parser;
+    readonly emitter: ToolEmitter<ToolInput<this>, WebCrawlerToolOutput>;
+    constructor({ client, parser, ...options }?: WebsiteCrawlerToolOptions);
+    protected _run({ url }: ToolInput<this>, _options: Partial<BaseToolRunOptions>, run: RunContext<this>): Promise<WebCrawlerToolOutput>;
+    createSnapshot(): {
+        client: HttpClient;
+        parser: Parser;
+        name: string;
+        description: string;
+        options: WebsiteCrawlerToolOptions;
+        cache: BaseCache<promise_based_task.Task<WebCrawlerToolOutput, any>>;
+        emitter: Emitter<any>;
+    };
+    loadSnapshot({ client, parser, ...snapshot }: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { type HttpClient, WebCrawlerTool, WebCrawlerToolOutput };

package/dist/tools/web/webCrawler.js

@@ -0,0 +1,108 @@
+import { JSONToolOutput, Tool } from '../base.js';
+import { z } from 'zod';
+import { Cache } from '../../cache/decoratorCache.js';
+import { stripHtml } from 'string-strip-html';
+import { Emitter } from '../../emitter/emitter.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+class WebCrawlerToolOutput extends JSONToolOutput {
+  static {
+    __name(this, "WebCrawlerToolOutput");
+  }
+  getTextContent() {
+    return [
+      `URL: ${this.result.url}`,
+      `STATUS: ${this.result.statusCode} (${this.result.statusText})`,
+      `CONTENT-TYPE: ${this.result.contentType}`,
+      `CONTENT: ${this.result.content}`
+    ].join("\n");
+  }
+}
+_ts_decorate([
+  Cache(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", []),
+  _ts_metadata("design:returntype", String)
+], WebCrawlerToolOutput.prototype, "getTextContent", null);
+async function defaultParser(response) {
+  const text = await response.text();
+  if (text) {
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("text/html")) {
+      return stripHtml(text).result;
+    }
+  }
+  return text || "No Content";
+}
+__name(defaultParser, "defaultParser");
+class WebCrawlerTool extends Tool {
+  static {
+    __name(this, "WebCrawlerTool");
+  }
+  name = "WebCrawler";
+  description = `Retrieves content of an arbitrary website.`;
+  inputSchema() {
+    return z.object({
+      url: z.string().url().describe("Website URL")
+    });
+  }
+  client;
+  parser;
+  emitter = Emitter.root.child({
+    namespace: [
+      "tool",
+      "webCrawler"
+    ],
+    creator: this
+  });
+  constructor({ client, parser, ...options } = {}) {
+    super(options);
+    this.client = client ?? fetch;
+    this.parser = parser ?? defaultParser;
+  }
+  async _run({ url }, _options, run) {
+    const response = await this.client(url, {
+      redirect: "follow",
+      ...this.options.request,
+      signal: run.signal
+    });
+    const content = await this.parser(response);
+    return new WebCrawlerToolOutput({
+      url,
+      statusCode: response.status,
+      statusText: response.statusText,
+      contentType: response.headers.get("content-type") ?? "unknown",
+      content
+    });
+  }
+  createSnapshot() {
+    return {
+      ...super.createSnapshot(),
+      client: this.client,
+      parser: this.parser
+    };
+  }
+  loadSnapshot({ client, parser, ...snapshot }) {
+    super.loadSnapshot(snapshot);
+    Object.assign(this, {
+      client: client ?? fetch,
+      parser: parser ?? defaultParser
+    });
+  }
+}
+
+export { WebCrawlerTool, WebCrawlerToolOutput };
+//# sourceMappingURL=webCrawler.js.map
+//# sourceMappingURL=webCrawler.js.map

package/dist/tools/web/webCrawler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/web/webCrawler.ts"],"names":["WebCrawlerToolOutput","JSONToolOutput","getTextContent","result","url","statusCode","statusText","contentType","content","join","defaultParser","response","text","headers","get","includes","stripHtml","WebCrawlerTool","Tool","name","description","inputSchema","z","object","string","describe","client","parser","emitter","Emitter","root","child","namespace","creator","constructor","options","fetch","_run","_options","run","redirect","request","signal","status","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":"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","file":"webCrawler.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  BaseToolOptions,\n  BaseToolRunOptions,\n  ToolEmitter,\n  JSONToolOutput,\n  Tool,\n  ToolInput,\n} from \"@/tools/base.js\";\nimport { z } from \"zod\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { stripHtml } from \"string-strip-html\";\nimport { RunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\n\ninterface CrawlerOutput {\n  url: string;\n  statusCode: number;\n  statusText: string;\n  contentType: string;\n  content: string;\n}\n\nexport class WebCrawlerToolOutput extends JSONToolOutput<CrawlerOutput> {\n  @Cache()\n  getTextContent(): string {\n    return [\n      `URL: ${this.result.url}`,\n      `STATUS: ${this.result.statusCode} (${this.result.statusText})`,\n      `CONTENT-TYPE: ${this.result.contentType}`,\n      `CONTENT: ${this.result.content}`,\n    ].join(\"\\n\");\n  }\n}\n\nexport type HttpClient = (url: string, options?: RequestInit) => Promise<HttpClientResponse>;\ninterface HttpClientResponse {\n  status: number;\n  statusText: string;\n  headers: Headers;\n  text(): Promise<string>;\n}\n\ntype Parser = (response: HttpClientResponse) => Promise<string>;\ninterface WebsiteCrawlerToolOptions extends BaseToolOptions {\n  client?: HttpClient;\n  parser?: Parser;\n  request?: RequestInit;\n}\n\nasync function defaultParser(response: HttpClientResponse) {\n  const text = await response.text();\n  if (text) {\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (contentType.includes(\"text/html\")) {\n      return stripHtml(text).result;\n    }\n  }\n  return text || \"No Content\";\n}\n\nexport class WebCrawlerTool extends Tool<WebCrawlerToolOutput, WebsiteCrawlerToolOptions> {\n  name = \"WebCrawler\";\n  description = `Retrieves content of an arbitrary website.`;\n  inputSchema() {\n    return z.object({\n      url: z.string().url().describe(\"Website URL\"),\n    });\n  }\n\n  protected client: HttpClient;\n  protected parser: Parser;\n\n  public readonly emitter: ToolEmitter<ToolInput<this>, WebCrawlerToolOutput> = Emitter.root.child({\n    namespace: [\"tool\", \"webCrawler\"],\n    creator: this,\n  });\n\n  constructor({ client, parser, ...options }: WebsiteCrawlerToolOptions = {}) {\n    super(options);\n    this.client = client ?? fetch;\n    this.parser = parser ?? defaultParser;\n  }\n\n  protected async _run(\n    { url }: ToolInput<this>,\n    _options: Partial<BaseToolRunOptions>,\n    run: RunContext<this>,\n  ) {\n    const response = await this.client(url, {\n      redirect: \"follow\",\n      ...this.options.request,\n      signal: run.signal,\n    });\n\n    const content = await this.parser(response);\n    return new WebCrawlerToolOutput({\n      url,\n      statusCode: response.status,\n      statusText: response.statusText,\n      contentType: response.headers.get(\"content-type\") ?? \"unknown\",\n      content,\n    });\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      client: this.client,\n      parser: this.parser,\n    };\n  }\n\n  loadSnapshot({ client, parser, ...snapshot }: ReturnType<typeof this.createSnapshot>) {\n    super.loadSnapshot(snapshot);\n    Object.assign(this, {\n      client: client ?? fetch,\n      parser: parser ?? defaultParser,\n    });\n  }\n}\n"]}

package/dist/version.cjs

@@ -0,0 +1,9 @@
+'use strict';
+
+exports.Version = "0.0.0";
+try {
+  exports.Version = "0.1.2";
+} catch {
+}
+//# sourceMappingURL=version.cjs.map
+//# sourceMappingURL=version.cjs.map

package/dist/version.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts"],"names":["Version","__LIBRARY_VERSION"],"mappings":";;AAkBIA,eAAU,GAAA;AACd,IAAI;AACFA,EAAUC,eAAAA,GAAAA,OAAAA;AACZ,CAAQ,CAAA,MAAA;AAER","file":"version.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\ndeclare const __LIBRARY_VERSION: string;\n\nlet Version = \"0.0.0\";\ntry {\n  Version = __LIBRARY_VERSION;\n} catch {\n  /* empty */\n}\n\nexport { Version };\n"]}