beeai-framework 0.1.2

package/dist/tools/similarity.js

@@ -0,0 +1,58 @@
+import { JSONToolOutput, Tool } from './base.js';
+import { z, string } from 'zod';
+import { pipe, map, filter, sortBy, prop, take } from 'remeda';
+import { Emitter } from '../emitter/emitter.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const documentSchema = z.object({
+  text: string()
+}).passthrough();
+class SimilarityToolOutput extends JSONToolOutput {
+  static {
+    __name(this, "SimilarityToolOutput");
+  }
+}
+class SimilarityTool extends Tool {
+  static {
+    __name(this, "SimilarityTool");
+  }
+  name = "Similarity";
+  description = "Extract relevant information from documents.";
+  emitter = Emitter.root.child({
+    namespace: [
+      "tool",
+      "similarity"
+    ],
+    creator: this
+  });
+  inputSchema() {
+    return z.object({
+      query: z.string(),
+      documents: z.array(documentSchema)
+    });
+  }
+  static {
+    this.register();
+  }
+  async _run({ query, documents }, options, run) {
+    return pipe(await this.options.provider({
+      query,
+      documents
+    }, options?.provider, run), map(({ score }, idx) => ({
+      documentIndex: idx,
+      score
+    })), filter(({ score }) => score >= (options.minScore ?? -Infinity)), sortBy([
+      prop("score"),
+      "desc"
+    ]), take(options?.maxResults ?? this.options.maxResults ?? Infinity), (data) => new SimilarityToolOutput(data.map(({ documentIndex, score }) => ({
+      document: documents[documentIndex],
+      index: documentIndex,
+      score
+    }))));
+  }
+}
+
+export { SimilarityTool, SimilarityToolOutput };
+//# sourceMappingURL=similarity.js.map
+//# sourceMappingURL=similarity.js.map

package/dist/tools/similarity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tools/similarity.ts"],"names":["documentSchema","z","object","text","string","passthrough","SimilarityToolOutput","JSONToolOutput","SimilarityTool","Tool","name","description","emitter","Emitter","root","child","namespace","creator","inputSchema","query","documents","array","register","_run","options","run","pipe","provider","map","score","idx","documentIndex","filter","minScore","sortBy","prop","take","maxResults","Infinity","data","document","index"],"mappings":";;;;;;;AA6BA,MAAMA,cAAAA,GAAiBC,EAAEC,MAAO,CAAA;AAAEC,EAAAA,IAAAA,EAAMC,MAAAA;AAAS,CAAA,EAAGC,WAAW,EAAA;AAgCxD,MAAMC,6BAA6BC,cAAAA,CAAAA;EA7D1C;;;AA6DkF;AAE3E,MAAMC,uBAAyCC,IAAAA,CAAAA;EA/DtD;;;EAoEEC,IAAO,GAAA,YAAA;EACPC,WAAc,GAAA,8CAAA;EAEEC,OAA8DC,GAAAA,OAAAA,CAAQC,KAAKC,KAAM,CAAA;IAC/FC,SAAW,EAAA;AAAC,MAAA,MAAA;AAAQ,MAAA;;IACpBC,OAAS,EAAA;GACX,CAAA;EAEAC,WAAc,GAAA;AACZ,IAAA,OAAOjB,EAAEC,MAAO,CAAA;AAAEiB,MAAAA,KAAAA,EAAOlB,EAAEG,MAAM,EAAA;MAAIgB,SAAWnB,EAAAA,CAAAA,CAAEoB,MAAMrB,cAAAA;KAAgB,CAAA;AAC1E;EAEA;AACE,IAAA,IAAA,CAAKsB,QAAQ,EAAA;AACf;AAEA,EAAA,MAAgBC,KACd,EAAEJ,KAAAA,EAAOC,SAAS,EAAA,EAClBI,SACAC,GACA,EAAA;AACA,IAAA,OAAOC,IACL,CAAA,MAAM,IAAKF,CAAAA,OAAAA,CAAQG,QACjB,CAAA;AACER,MAAAA,KAAAA;AACAC,MAAAA;KAEFI,EAAAA,OAAAA,EAASG,UACTF,GAAAA,CAAAA,EAEFG,IAAI,CAAC,EAAEC,KAAK,EAAA,EAAIC,GAAS,MAAA;MACvBC,aAAeD,EAAAA,GAAAA;AACfD,MAAAA;KACF,CAAA,CAAA,EACAG,MAAO,CAAA,CAAC,EAAEH,KAAAA,EAAYA,KAAAA,KAAAA,KAAUL,OAAQS,CAAAA,QAAAA,IAAY,CAAQ,QAAA,CAAA,CAAA,EAC5DC,MAAO,CAAA;AAACC,MAAAA,IAAAA,CAAK,OAAA,CAAA;AAAU,MAAA;AAAO,KAAA,CAAA,EAC9BC,KAAKZ,OAASa,EAAAA,UAAAA,IAAc,KAAKb,OAAQa,CAAAA,UAAAA,IAAcC,QAAAA,CACvD,EAAA,CAACC,IACC,KAAA,IAAIjC,qBACFiC,IAAKX,CAAAA,GAAAA,CAAI,CAAC,EAAEG,aAAAA,EAAeF,OAAa,MAAA;AACtCW,MAAAA,QAAAA,EAAUpB,UAAUW,aAAAA,CAAAA;MACpBU,KAAOV,EAAAA,aAAAA;AACPF,MAAAA;AACF,KAAA,CAAA,CAAA,CAAA,CAAA;AAGR;AACF","file":"similarity.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 \"./base.js\";\nimport { string, z } from \"zod\";\nimport { RunContext } from \"@/context.js\";\nimport { filter, map, pipe, prop, sortBy, take } from \"remeda\";\nimport { Emitter } from \"@/emitter/emitter.js\";\n\nconst documentSchema = z.object({ text: string() }).passthrough();\n\ntype Document = z.infer<typeof documentSchema>;\n\ninterface ProviderInput {\n  query: string;\n  documents: Document[];\n}\n\ntype Provider<TProviderOptions> = (\n  input: ProviderInput,\n  options: TProviderOptions | undefined,\n  run: RunContext<SimilarityTool<TProviderOptions>>,\n) => Promise<{ score: number }[]>;\n\nexport interface SimilarityToolOptions<TProviderOptions = unknown> extends BaseToolOptions {\n  provider: Provider<TProviderOptions>;\n  maxResults?: number;\n}\n\nexport interface SimilarityToolRunOptions<TProviderOptions = unknown> extends BaseToolRunOptions {\n  provider?: TProviderOptions;\n  maxResults?: number;\n  minScore?: number;\n}\n\nexport interface SimilarityToolResult {\n  document: Document;\n  index: number;\n  score: number;\n}\n\nexport class SimilarityToolOutput extends JSONToolOutput<SimilarityToolResult[]> {}\n\nexport class SimilarityTool<TProviderOptions> extends Tool<\n  SimilarityToolOutput,\n  SimilarityToolOptions<TProviderOptions>,\n  SimilarityToolRunOptions<TProviderOptions>\n> {\n  name = \"Similarity\";\n  description = \"Extract relevant information from documents.\";\n\n  public readonly emitter: ToolEmitter<ToolInput<this>, SimilarityToolOutput> = Emitter.root.child({\n    namespace: [\"tool\", \"similarity\"],\n    creator: this,\n  });\n\n  inputSchema() {\n    return z.object({ query: z.string(), documents: z.array(documentSchema) });\n  }\n\n  static {\n    this.register();\n  }\n\n  protected async _run(\n    { query, documents }: ToolInput<this>,\n    options: Partial<SimilarityToolRunOptions<TProviderOptions>>,\n    run: RunContext<this>,\n  ) {\n    return pipe(\n      await this.options.provider(\n        {\n          query,\n          documents,\n        },\n        options?.provider,\n        run,\n      ),\n      map(({ score }, idx) => ({\n        documentIndex: idx,\n        score,\n      })),\n      filter(({ score }) => score >= (options.minScore ?? -Infinity)),\n      sortBy([prop(\"score\"), \"desc\"]),\n      take(options?.maxResults ?? this.options.maxResults ?? Infinity),\n      (data) =>\n        new SimilarityToolOutput(\n          data.map(({ documentIndex, score }) => ({\n            document: documents[documentIndex],\n            index: documentIndex,\n            score,\n          })),\n        ),\n    );\n  }\n}\n"]}

package/dist/tools/weather/openMeteo.cjs

@@ -0,0 +1,221 @@
+'use strict';
+
+var base_cjs = require('../base.cjs');
+var zod = require('zod');
+var fetcher_cjs = require('../../internals/fetcher.cjs');
+var remeda = require('remeda');
+var decoratorCache_cjs = require('../../cache/decoratorCache.cjs');
+var object_cjs = require('../../internals/helpers/object.cjs');
+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 OpenMeteoToolOutput extends base_cjs.JSONToolOutput {
+  static {
+    __name(this, "OpenMeteoToolOutput");
+  }
+}
+class OpenMeteoTool extends base_cjs.Tool {
+  static {
+    __name(this, "OpenMeteoTool");
+  }
+  name = "OpenMeteo";
+  description = `Retrieve current, past, or future weather forecasts for a location.`;
+  inputSchema() {
+    return zod.z.object({
+      location: zod.z.union([
+        zod.z.object({
+          name: zod.z.string().min(1),
+          country: zod.z.string().optional(),
+          language: zod.z.string().default("English")
+        }).strip(),
+        zod.z.object({
+          latitude: zod.z.coerce.number(),
+          longitude: zod.z.coerce.number()
+        }).strip()
+      ]),
+      start_date: zod.z.string().date().describe("Start date for the weather forecast in the format YYYY-MM-DD (UTC)"),
+      end_date: zod.z.string().date().describe("End date for the weather forecast in the format YYYY-MM-DD (UTC)").optional(),
+      temperature_unit: zod.z.enum([
+        "celsius",
+        "fahrenheit"
+      ]).default("celsius")
+    }).strip();
+  }
+  emitter = emitter_cjs.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 = object_cjs.getProp(rawInput, [
+        key
+      ]);
+      if (value) {
+        object_cjs.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 remeda.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 base_cjs.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 fetcher_cjs.createURLParams({
+        ...remeda.pickBy(input, (v) => !remeda.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 base_cjs.ToolError("Request to OpenMeteo API has failed!", [
+        new Error(await response.text())
+      ]);
+    }
+    let data = await response.json();
+    if (this.options?.responseFilter?.excludedKeys) {
+      data = remeda.omit(data, this.options.responseFilter.excludedKeys);
+    }
+    return new OpenMeteoToolOutput(data);
+  }
+  async _geocode(location, signal) {
+    const { apiKey } = this.options;
+    const params = fetcher_cjs.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 base_cjs.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 base_cjs.ToolError(`Location '${location.name}' was not found.`);
+    }
+    return results[0];
+  }
+}
+_ts_decorate([
+  decoratorCache_cjs.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);
+
+exports.OpenMeteoTool = OpenMeteoTool;
+exports.OpenMeteoToolOutput = OpenMeteoToolOutput;
+//# sourceMappingURL=openMeteo.cjs.map
+//# sourceMappingURL=openMeteo.cjs.map

package/dist/tools/weather/openMeteo.cjs.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.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  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/weather/openMeteo.d.cts

@@ -0,0 +1,123 @@
+import { JSONToolOutput, Tool, ToolEmitter, ToolInput, BaseToolRunOptions, BaseToolOptions } from '../base.cjs';
+import { z } from 'zod';
+import { RunContext } from '../../context.cjs';
+import 'ajv';
+import '../../errors.cjs';
+import '../../internals/types.cjs';
+import '../../internals/helpers/guards.cjs';
+import '../../internals/serializable.cjs';
+import 'promise-based-task';
+import '../../cache/base.cjs';
+import '../../internals/helpers/schema.cjs';
+import 'zod-to-json-schema';
+import '../../emitter-BWtGHYn0.cjs';
+import '../../internals/helpers/promise.cjs';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+interface ResponseFilter {
+    excludedKeys: (keyof OpenMeteoToolResponse)[];
+}
+interface ToolOptions extends BaseToolOptions {
+    apiKey?: string;
+    responseFilter?: ResponseFilter;
+}
+type ToolRunOptions = BaseToolRunOptions;
+interface LocationSearch {
+    name: string;
+    country?: string;
+    language?: string;
+}
+interface OpenMeteoToolResponse {
+    latitude?: number;
+    longitude?: number;
+    generationtime_ms?: number;
+    utc_offset_seconds?: number;
+    timezone?: string;
+    timezone_abbreviation?: string;
+    elevation?: number;
+    current_units?: Record<string, string>;
+    current?: Record<string, string>;
+    hourly_units?: Record<string, string>;
+    hourly?: Record<string, any[]>;
+    daily_units?: Record<string, string>;
+    daily?: Record<string, any[]>;
+}
+declare class OpenMeteoToolOutput extends JSONToolOutput<OpenMeteoToolResponse> {
+}
+declare class OpenMeteoTool extends Tool<OpenMeteoToolOutput, ToolOptions, ToolRunOptions> {
+    name: string;
+    description: string;
+    inputSchema(): z.ZodObject<{
+        location: z.ZodUnion<[z.ZodObject<{
+            name: z.ZodString;
+            country: z.ZodOptional<z.ZodString>;
+            language: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            language: string;
+            country?: string | undefined;
+        }, {
+            name: string;
+            country?: string | undefined;
+            language?: string | undefined;
+        }>, z.ZodObject<{
+            latitude: z.ZodNumber;
+            longitude: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            latitude: number;
+            longitude: number;
+        }, {
+            latitude: number;
+            longitude: number;
+        }>]>;
+        start_date: z.ZodString;
+        end_date: z.ZodOptional<z.ZodString>;
+        temperature_unit: z.ZodDefault<z.ZodEnum<["celsius", "fahrenheit"]>>;
+    }, "strip", z.ZodTypeAny, {
+        location: {
+            name: string;
+            language: string;
+            country?: string | undefined;
+        } | {
+            latitude: number;
+            longitude: number;
+        };
+        start_date: string;
+        temperature_unit: "celsius" | "fahrenheit";
+        end_date?: string | undefined;
+    }, {
+        location: {
+            name: string;
+            country?: string | undefined;
+            language?: string | undefined;
+        } | {
+            latitude: number;
+            longitude: number;
+        };
+        start_date: string;
+        end_date?: string | undefined;
+        temperature_unit?: "celsius" | "fahrenheit" | undefined;
+    }>;
+    readonly emitter: ToolEmitter<ToolInput<this>, OpenMeteoToolOutput>;
+    constructor(options?: Partial<ToolOptions>);
+    protected preprocessInput(rawInput: unknown): void;
+    protected _run({ location, start_date: startDate, end_date: endDate, ...input }: ToolInput<this>, _options: Partial<BaseToolRunOptions>, run: RunContext<this>): Promise<OpenMeteoToolOutput>;
+    protected _geocode(location: LocationSearch, signal: AbortSignal): Promise<any>;
+}
+
+export { OpenMeteoTool, OpenMeteoToolOutput, type OpenMeteoToolResponse, type ResponseFilter };

package/dist/tools/weather/openMeteo.d.ts

@@ -0,0 +1,123 @@
+import { JSONToolOutput, Tool, ToolEmitter, ToolInput, BaseToolRunOptions, BaseToolOptions } from '../base.js';
+import { z } from 'zod';
+import { RunContext } from '../../context.js';
+import 'ajv';
+import '../../errors.js';
+import '../../internals/types.js';
+import '../../internals/helpers/guards.js';
+import '../../internals/serializable.js';
+import 'promise-based-task';
+import '../../cache/base.js';
+import '../../internals/helpers/schema.js';
+import 'zod-to-json-schema';
+import '../../emitter-l0W9gC1A.js';
+import '../../internals/helpers/promise.js';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+interface ResponseFilter {
+    excludedKeys: (keyof OpenMeteoToolResponse)[];
+}
+interface ToolOptions extends BaseToolOptions {
+    apiKey?: string;
+    responseFilter?: ResponseFilter;
+}
+type ToolRunOptions = BaseToolRunOptions;
+interface LocationSearch {
+    name: string;
+    country?: string;
+    language?: string;
+}
+interface OpenMeteoToolResponse {
+    latitude?: number;
+    longitude?: number;
+    generationtime_ms?: number;
+    utc_offset_seconds?: number;
+    timezone?: string;
+    timezone_abbreviation?: string;
+    elevation?: number;
+    current_units?: Record<string, string>;
+    current?: Record<string, string>;
+    hourly_units?: Record<string, string>;
+    hourly?: Record<string, any[]>;
+    daily_units?: Record<string, string>;
+    daily?: Record<string, any[]>;
+}
+declare class OpenMeteoToolOutput extends JSONToolOutput<OpenMeteoToolResponse> {
+}
+declare class OpenMeteoTool extends Tool<OpenMeteoToolOutput, ToolOptions, ToolRunOptions> {
+    name: string;
+    description: string;
+    inputSchema(): z.ZodObject<{
+        location: z.ZodUnion<[z.ZodObject<{
+            name: z.ZodString;
+            country: z.ZodOptional<z.ZodString>;
+            language: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            language: string;
+            country?: string | undefined;
+        }, {
+            name: string;
+            country?: string | undefined;
+            language?: string | undefined;
+        }>, z.ZodObject<{
+            latitude: z.ZodNumber;
+            longitude: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            latitude: number;
+            longitude: number;
+        }, {
+            latitude: number;
+            longitude: number;
+        }>]>;
+        start_date: z.ZodString;
+        end_date: z.ZodOptional<z.ZodString>;
+        temperature_unit: z.ZodDefault<z.ZodEnum<["celsius", "fahrenheit"]>>;
+    }, "strip", z.ZodTypeAny, {
+        location: {
+            name: string;
+            language: string;
+            country?: string | undefined;
+        } | {
+            latitude: number;
+            longitude: number;
+        };
+        start_date: string;
+        temperature_unit: "celsius" | "fahrenheit";
+        end_date?: string | undefined;
+    }, {
+        location: {
+            name: string;
+            country?: string | undefined;
+            language?: string | undefined;
+        } | {
+            latitude: number;
+            longitude: number;
+        };
+        start_date: string;
+        end_date?: string | undefined;
+        temperature_unit?: "celsius" | "fahrenheit" | undefined;
+    }>;
+    readonly emitter: ToolEmitter<ToolInput<this>, OpenMeteoToolOutput>;
+    constructor(options?: Partial<ToolOptions>);
+    protected preprocessInput(rawInput: unknown): void;
+    protected _run({ location, start_date: startDate, end_date: endDate, ...input }: ToolInput<this>, _options: Partial<BaseToolRunOptions>, run: RunContext<this>): Promise<OpenMeteoToolOutput>;
+    protected _geocode(location: LocationSearch, signal: AbortSignal): Promise<any>;
+}
+
+export { OpenMeteoTool, OpenMeteoToolOutput, type OpenMeteoToolResponse, type ResponseFilter };