beeai-framework 0.1.2

package/dist/tools/search/duckDuckGoSearch.cjs

@@ -0,0 +1,146 @@
+'use strict';
+
+var duckDuckScrape = require('duck-duck-scrape');
+var stringStripHtml = require('string-strip-html');
+var pThrottle = require('p-throttle');
+var base_cjs = require('./base.cjs');
+var base_cjs$1 = require('../base.cjs');
+var headerGenerator = require('header-generator');
+var zod = require('zod');
+var decoratorCache_cjs = require('../../cache/decoratorCache.cjs');
+var paginate_cjs = require('../../internals/helpers/paginate.cjs');
+var emitter_cjs = require('../../emitter/emitter.cjs');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var pThrottle__default = /*#__PURE__*/_interopDefault(pThrottle);
+
+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 DuckDuckGoSearchToolOutput extends base_cjs.SearchToolOutput {
+  static {
+    __name(this, "DuckDuckGoSearchToolOutput");
+  }
+  results;
+  constructor(results) {
+    super(results), this.results = results;
+  }
+  static {
+    this.register();
+  }
+  createSnapshot() {
+    return {
+      results: this.results
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+class DuckDuckGoSearchTool extends base_cjs$1.Tool {
+  static {
+    __name(this, "DuckDuckGoSearchTool");
+  }
+  name = "DuckDuckGo";
+  description = "Search for online trends, news, current events, real-time information, or research topics.";
+  emitter = emitter_cjs.Emitter.root.child({
+    namespace: [
+      "tool",
+      "search",
+      "ddg"
+    ],
+    creator: this
+  });
+  client;
+  inputSchema() {
+    return zod.z.object({
+      query: zod.z.string({
+        description: `Search query`
+      }).min(1).max(128)
+    });
+  }
+  constructor(options = {}) {
+    super({
+      ...options,
+      maxResults: options?.maxResults ?? 15
+    });
+    this.client = this._createClient();
+  }
+  static {
+    this.register();
+  }
+  _createClient() {
+    const { throttle } = this.options;
+    return throttle === false ? duckDuckScrape.search : pThrottle__default.default({
+      ...throttle,
+      limit: throttle?.limit ?? 1,
+      interval: throttle?.interval ?? 3e3
+    })(duckDuckScrape.search);
+  }
+  async _run({ query: input }, options, run) {
+    const headers = new headerGenerator.HeaderGenerator().getHeaders();
+    const results = await paginate_cjs.paginate({
+      size: this.options.maxResults,
+      handler: /* @__PURE__ */ __name(async ({ cursor = 0 }) => {
+        const { results: data, noResults: done } = await this.client(input, {
+          safeSearch: duckDuckScrape.SafeSearchType.MODERATE,
+          ...this.options.search,
+          ...options?.search,
+          offset: cursor
+        }, {
+          headers,
+          user_agent: headers["user-agent"],
+          ...this.options?.httpClientOptions,
+          ...options?.httpClientOptions,
+          signal: run.signal,
+          uri_modifier: /* @__PURE__ */ __name((rawUrl) => {
+            const url = new URL(rawUrl);
+            url.searchParams.delete("ss_mkt");
+            return url.toString();
+          }, "uri_modifier")
+        });
+        return {
+          data,
+          nextCursor: done ? void 0 : cursor + data.length
+        };
+      }, "handler")
+    });
+    return new DuckDuckGoSearchToolOutput(results.map((result) => ({
+      title: stringStripHtml.stripHtml(result.title).result,
+      description: stringStripHtml.stripHtml(result.description).result,
+      url: result.url
+    })));
+  }
+  loadSnapshot(snapshot) {
+    super.loadSnapshot(snapshot);
+    Object.assign(this, {
+      client: this._createClient()
+    });
+  }
+}
+_ts_decorate([
+  decoratorCache_cjs.Cache(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", []),
+  _ts_metadata("design:returntype", void 0)
+], DuckDuckGoSearchTool.prototype, "inputSchema", null);
+
+Object.defineProperty(exports, "DuckDuckGoSearchToolSearchType", {
+  enumerable: true,
+  get: function () { return duckDuckScrape.SafeSearchType; }
+});
+exports.DuckDuckGoSearchTool = DuckDuckGoSearchTool;
+exports.DuckDuckGoSearchToolOutput = DuckDuckGoSearchToolOutput;
+//# sourceMappingURL=duckDuckGoSearch.cjs.map
+//# sourceMappingURL=duckDuckGoSearch.cjs.map

package/dist/tools/search/duckDuckGoSearch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/search/duckDuckGoSearch.ts"],"names":["DuckDuckGoSearchToolOutput","SearchToolOutput","constructor","results","register","createSnapshot","loadSnapshot","snapshot","Object","assign","DuckDuckGoSearchTool","Tool","name","description","emitter","Emitter","root","child","namespace","creator","client","inputSchema","z","object","query","string","min","max","options","maxResults","_createClient","throttle","rawDDGSearch","pThrottle","limit","interval","_run","input","run","headers","HeaderGenerator","getHeaders","paginate","size","handler","cursor","data","noResults","done","safeSearch","SafeSearchType","MODERATE","search","offset","user_agent","httpClientOptions","signal","uri_modifier","rawUrl","url","URL","searchParams","delete","toString","nextCursor","undefined","length","map","result","title","stripHtml"],"mappings":"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","file":"duckDuckGoSearch.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 { SearchOptions, search as rawDDGSearch, SafeSearchType } from \"duck-duck-scrape\";\nimport { stripHtml } from \"string-strip-html\";\nimport pThrottle, { Options as ThrottleOptions } from \"p-throttle\";\nimport {\n  SearchToolOptions,\n  SearchToolOutput,\n  SearchToolResult,\n  SearchToolRunOptions,\n} from \"./base.js\";\nimport { ToolEmitter, Tool, ToolInput } from \"@/tools/base.js\";\nimport { HeaderGenerator } from \"header-generator\";\nimport type { NeedleOptions } from \"needle\";\nimport { z } from \"zod\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { RunContext } from \"@/context.js\";\nimport { paginate } from \"@/internals/helpers/paginate.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\n\nexport { SafeSearchType as DuckDuckGoSearchToolSearchType };\n\nexport interface DuckDuckGoSearchToolOptions extends SearchToolOptions {\n  search?: SearchOptions;\n  throttle?: ThrottleOptions | false;\n  httpClientOptions?: NeedleOptions;\n  maxResults: number;\n}\n\nexport interface DuckDuckGoSearchToolRunOptions extends SearchToolRunOptions {\n  search?: SearchOptions;\n  httpClientOptions?: NeedleOptions;\n}\n\nexport interface DuckDuckGoSearchToolResult extends SearchToolResult {}\n\nexport class DuckDuckGoSearchToolOutput extends SearchToolOutput<DuckDuckGoSearchToolResult> {\n  constructor(public readonly results: DuckDuckGoSearchToolResult[]) {\n    super(results);\n  }\n\n  static {\n    this.register();\n  }\n\n  createSnapshot() {\n    return {\n      results: this.results,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n\nexport class DuckDuckGoSearchTool extends Tool<\n  DuckDuckGoSearchToolOutput,\n  DuckDuckGoSearchToolOptions,\n  DuckDuckGoSearchToolRunOptions\n> {\n  name = \"DuckDuckGo\";\n  description =\n    \"Search for online trends, news, current events, real-time information, or research topics.\";\n\n  public readonly emitter: ToolEmitter<ToolInput<this>, DuckDuckGoSearchToolOutput> =\n    Emitter.root.child({\n      namespace: [\"tool\", \"search\", \"ddg\"],\n      creator: this,\n    });\n\n  protected readonly client: typeof rawDDGSearch;\n\n  @Cache()\n  inputSchema() {\n    return z.object({\n      query: z.string({ description: `Search query` }).min(1).max(128),\n    });\n  }\n\n  public constructor(options: Partial<DuckDuckGoSearchToolOptions> = {}) {\n    super({ ...options, maxResults: options?.maxResults ?? 15 });\n\n    this.client = this._createClient();\n  }\n\n  static {\n    this.register();\n  }\n\n  protected _createClient() {\n    const { throttle } = this.options;\n\n    return throttle === false\n      ? rawDDGSearch\n      : pThrottle({\n          ...throttle,\n          limit: throttle?.limit ?? 1,\n          interval: throttle?.interval ?? 3000,\n        })(rawDDGSearch);\n  }\n\n  protected async _run(\n    { query: input }: ToolInput<this>,\n    options: Partial<DuckDuckGoSearchToolRunOptions>,\n    run: RunContext<this>,\n  ) {\n    const headers = new HeaderGenerator().getHeaders();\n\n    const results = await paginate({\n      size: this.options.maxResults,\n      handler: async ({ cursor = 0 }) => {\n        const { results: data, noResults: done } = await this.client(\n          input,\n          {\n            safeSearch: SafeSearchType.MODERATE,\n            ...this.options.search,\n            ...options?.search,\n            offset: cursor,\n          },\n          {\n            headers,\n            user_agent: headers[\"user-agent\"],\n            ...this.options?.httpClientOptions,\n            ...options?.httpClientOptions,\n            signal: run.signal,\n            uri_modifier: (rawUrl) => {\n              const url = new URL(rawUrl);\n              url.searchParams.delete(\"ss_mkt\");\n              return url.toString();\n            },\n          },\n        );\n\n        return {\n          data,\n          nextCursor: done ? undefined : cursor + data.length,\n        };\n      },\n    });\n\n    return new DuckDuckGoSearchToolOutput(\n      results.map((result) => ({\n        title: stripHtml(result.title).result,\n        description: stripHtml(result.description).result,\n        url: result.url,\n      })),\n    );\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void {\n    super.loadSnapshot(snapshot);\n    Object.assign(this, { client: this._createClient() });\n  }\n}\n"]}

package/dist/tools/search/duckDuckGoSearch.d.cts

@@ -0,0 +1,75 @@
+import { SearchOptions, search } from 'duck-duck-scrape';
+export { SafeSearchType as DuckDuckGoSearchToolSearchType } from 'duck-duck-scrape';
+import { Options } from 'p-throttle';
+import { SearchToolOptions, SearchToolRunOptions, SearchToolResult, SearchToolOutput } from './base.cjs';
+import { Tool, ToolEmitter, ToolInput } from '../base.cjs';
+import { NeedleOptions } from 'needle';
+import { z } from 'zod';
+import { RunContext } from '../../context.cjs';
+import 'ajv';
+import '../../emitter-BWtGHYn0.cjs';
+import '../../internals/types.cjs';
+import '../../internals/helpers/guards.cjs';
+import '../../internals/serializable.cjs';
+import '../../internals/helpers/promise.cjs';
+import '../../errors.cjs';
+import 'promise-based-task';
+import '../../cache/base.cjs';
+import '../../internals/helpers/schema.cjs';
+import 'zod-to-json-schema';
+
+/**
+ * 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 DuckDuckGoSearchToolOptions extends SearchToolOptions {
+    search?: SearchOptions;
+    throttle?: Options | false;
+    httpClientOptions?: NeedleOptions;
+    maxResults: number;
+}
+interface DuckDuckGoSearchToolRunOptions extends SearchToolRunOptions {
+    search?: SearchOptions;
+    httpClientOptions?: NeedleOptions;
+}
+interface DuckDuckGoSearchToolResult extends SearchToolResult {
+}
+declare class DuckDuckGoSearchToolOutput extends SearchToolOutput<DuckDuckGoSearchToolResult> {
+    readonly results: DuckDuckGoSearchToolResult[];
+    constructor(results: DuckDuckGoSearchToolResult[]);
+    createSnapshot(): {
+        results: DuckDuckGoSearchToolResult[];
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+declare class DuckDuckGoSearchTool extends Tool<DuckDuckGoSearchToolOutput, DuckDuckGoSearchToolOptions, DuckDuckGoSearchToolRunOptions> {
+    name: string;
+    description: string;
+    readonly emitter: ToolEmitter<ToolInput<this>, DuckDuckGoSearchToolOutput>;
+    protected readonly client: typeof search;
+    inputSchema(): z.ZodObject<{
+        query: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+    }, {
+        query: string;
+    }>;
+    constructor(options?: Partial<DuckDuckGoSearchToolOptions>);
+    protected _createClient(): typeof search;
+    protected _run({ query: input }: ToolInput<this>, options: Partial<DuckDuckGoSearchToolRunOptions>, run: RunContext<this>): Promise<DuckDuckGoSearchToolOutput>;
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { DuckDuckGoSearchTool, type DuckDuckGoSearchToolOptions, DuckDuckGoSearchToolOutput, type DuckDuckGoSearchToolResult, type DuckDuckGoSearchToolRunOptions };

package/dist/tools/search/duckDuckGoSearch.d.ts

@@ -0,0 +1,75 @@
+import { SearchOptions, search } from 'duck-duck-scrape';
+export { SafeSearchType as DuckDuckGoSearchToolSearchType } from 'duck-duck-scrape';
+import { Options } from 'p-throttle';
+import { SearchToolOptions, SearchToolRunOptions, SearchToolResult, SearchToolOutput } from './base.js';
+import { Tool, ToolEmitter, ToolInput } from '../base.js';
+import { NeedleOptions } from 'needle';
+import { z } from 'zod';
+import { RunContext } from '../../context.js';
+import 'ajv';
+import '../../emitter-l0W9gC1A.js';
+import '../../internals/types.js';
+import '../../internals/helpers/guards.js';
+import '../../internals/serializable.js';
+import '../../internals/helpers/promise.js';
+import '../../errors.js';
+import 'promise-based-task';
+import '../../cache/base.js';
+import '../../internals/helpers/schema.js';
+import 'zod-to-json-schema';
+
+/**
+ * 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 DuckDuckGoSearchToolOptions extends SearchToolOptions {
+    search?: SearchOptions;
+    throttle?: Options | false;
+    httpClientOptions?: NeedleOptions;
+    maxResults: number;
+}
+interface DuckDuckGoSearchToolRunOptions extends SearchToolRunOptions {
+    search?: SearchOptions;
+    httpClientOptions?: NeedleOptions;
+}
+interface DuckDuckGoSearchToolResult extends SearchToolResult {
+}
+declare class DuckDuckGoSearchToolOutput extends SearchToolOutput<DuckDuckGoSearchToolResult> {
+    readonly results: DuckDuckGoSearchToolResult[];
+    constructor(results: DuckDuckGoSearchToolResult[]);
+    createSnapshot(): {
+        results: DuckDuckGoSearchToolResult[];
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+declare class DuckDuckGoSearchTool extends Tool<DuckDuckGoSearchToolOutput, DuckDuckGoSearchToolOptions, DuckDuckGoSearchToolRunOptions> {
+    name: string;
+    description: string;
+    readonly emitter: ToolEmitter<ToolInput<this>, DuckDuckGoSearchToolOutput>;
+    protected readonly client: typeof search;
+    inputSchema(): z.ZodObject<{
+        query: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+    }, {
+        query: string;
+    }>;
+    constructor(options?: Partial<DuckDuckGoSearchToolOptions>);
+    protected _createClient(): typeof search;
+    protected _run({ query: input }: ToolInput<this>, options: Partial<DuckDuckGoSearchToolRunOptions>, run: RunContext<this>): Promise<DuckDuckGoSearchToolOutput>;
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { DuckDuckGoSearchTool, type DuckDuckGoSearchToolOptions, DuckDuckGoSearchToolOutput, type DuckDuckGoSearchToolResult, type DuckDuckGoSearchToolRunOptions };

package/dist/tools/search/duckDuckGoSearch.js

@@ -0,0 +1,136 @@
+import { search, SafeSearchType } from 'duck-duck-scrape';
+export { SafeSearchType as DuckDuckGoSearchToolSearchType } from 'duck-duck-scrape';
+import { stripHtml } from 'string-strip-html';
+import pThrottle from 'p-throttle';
+import { SearchToolOutput } from './base.js';
+import { Tool } from '../base.js';
+import { HeaderGenerator } from 'header-generator';
+import { z } from 'zod';
+import { Cache } from '../../cache/decoratorCache.js';
+import { paginate } from '../../internals/helpers/paginate.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 DuckDuckGoSearchToolOutput extends SearchToolOutput {
+  static {
+    __name(this, "DuckDuckGoSearchToolOutput");
+  }
+  results;
+  constructor(results) {
+    super(results), this.results = results;
+  }
+  static {
+    this.register();
+  }
+  createSnapshot() {
+    return {
+      results: this.results
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+class DuckDuckGoSearchTool extends Tool {
+  static {
+    __name(this, "DuckDuckGoSearchTool");
+  }
+  name = "DuckDuckGo";
+  description = "Search for online trends, news, current events, real-time information, or research topics.";
+  emitter = Emitter.root.child({
+    namespace: [
+      "tool",
+      "search",
+      "ddg"
+    ],
+    creator: this
+  });
+  client;
+  inputSchema() {
+    return z.object({
+      query: z.string({
+        description: `Search query`
+      }).min(1).max(128)
+    });
+  }
+  constructor(options = {}) {
+    super({
+      ...options,
+      maxResults: options?.maxResults ?? 15
+    });
+    this.client = this._createClient();
+  }
+  static {
+    this.register();
+  }
+  _createClient() {
+    const { throttle } = this.options;
+    return throttle === false ? search : pThrottle({
+      ...throttle,
+      limit: throttle?.limit ?? 1,
+      interval: throttle?.interval ?? 3e3
+    })(search);
+  }
+  async _run({ query: input }, options, run) {
+    const headers = new HeaderGenerator().getHeaders();
+    const results = await paginate({
+      size: this.options.maxResults,
+      handler: /* @__PURE__ */ __name(async ({ cursor = 0 }) => {
+        const { results: data, noResults: done } = await this.client(input, {
+          safeSearch: SafeSearchType.MODERATE,
+          ...this.options.search,
+          ...options?.search,
+          offset: cursor
+        }, {
+          headers,
+          user_agent: headers["user-agent"],
+          ...this.options?.httpClientOptions,
+          ...options?.httpClientOptions,
+          signal: run.signal,
+          uri_modifier: /* @__PURE__ */ __name((rawUrl) => {
+            const url = new URL(rawUrl);
+            url.searchParams.delete("ss_mkt");
+            return url.toString();
+          }, "uri_modifier")
+        });
+        return {
+          data,
+          nextCursor: done ? void 0 : cursor + data.length
+        };
+      }, "handler")
+    });
+    return new DuckDuckGoSearchToolOutput(results.map((result) => ({
+      title: stripHtml(result.title).result,
+      description: stripHtml(result.description).result,
+      url: result.url
+    })));
+  }
+  loadSnapshot(snapshot) {
+    super.loadSnapshot(snapshot);
+    Object.assign(this, {
+      client: this._createClient()
+    });
+  }
+}
+_ts_decorate([
+  Cache(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", []),
+  _ts_metadata("design:returntype", void 0)
+], DuckDuckGoSearchTool.prototype, "inputSchema", null);
+
+export { DuckDuckGoSearchTool, DuckDuckGoSearchToolOutput };
+//# sourceMappingURL=duckDuckGoSearch.js.map
+//# sourceMappingURL=duckDuckGoSearch.js.map

package/dist/tools/search/duckDuckGoSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/search/duckDuckGoSearch.ts"],"names":["DuckDuckGoSearchToolOutput","SearchToolOutput","constructor","results","register","createSnapshot","loadSnapshot","snapshot","Object","assign","DuckDuckGoSearchTool","Tool","name","description","emitter","Emitter","root","child","namespace","creator","client","inputSchema","z","object","query","string","min","max","options","maxResults","_createClient","throttle","rawDDGSearch","pThrottle","limit","interval","_run","input","run","headers","HeaderGenerator","getHeaders","paginate","size","handler","cursor","data","noResults","done","safeSearch","SafeSearchType","MODERATE","search","offset","user_agent","httpClientOptions","signal","uri_modifier","rawUrl","url","URL","searchParams","delete","toString","nextCursor","undefined","length","map","result","title","stripHtml"],"mappings":"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","file":"duckDuckGoSearch.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 { SearchOptions, search as rawDDGSearch, SafeSearchType } from \"duck-duck-scrape\";\nimport { stripHtml } from \"string-strip-html\";\nimport pThrottle, { Options as ThrottleOptions } from \"p-throttle\";\nimport {\n  SearchToolOptions,\n  SearchToolOutput,\n  SearchToolResult,\n  SearchToolRunOptions,\n} from \"./base.js\";\nimport { ToolEmitter, Tool, ToolInput } from \"@/tools/base.js\";\nimport { HeaderGenerator } from \"header-generator\";\nimport type { NeedleOptions } from \"needle\";\nimport { z } from \"zod\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { RunContext } from \"@/context.js\";\nimport { paginate } from \"@/internals/helpers/paginate.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\n\nexport { SafeSearchType as DuckDuckGoSearchToolSearchType };\n\nexport interface DuckDuckGoSearchToolOptions extends SearchToolOptions {\n  search?: SearchOptions;\n  throttle?: ThrottleOptions | false;\n  httpClientOptions?: NeedleOptions;\n  maxResults: number;\n}\n\nexport interface DuckDuckGoSearchToolRunOptions extends SearchToolRunOptions {\n  search?: SearchOptions;\n  httpClientOptions?: NeedleOptions;\n}\n\nexport interface DuckDuckGoSearchToolResult extends SearchToolResult {}\n\nexport class DuckDuckGoSearchToolOutput extends SearchToolOutput<DuckDuckGoSearchToolResult> {\n  constructor(public readonly results: DuckDuckGoSearchToolResult[]) {\n    super(results);\n  }\n\n  static {\n    this.register();\n  }\n\n  createSnapshot() {\n    return {\n      results: this.results,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n\nexport class DuckDuckGoSearchTool extends Tool<\n  DuckDuckGoSearchToolOutput,\n  DuckDuckGoSearchToolOptions,\n  DuckDuckGoSearchToolRunOptions\n> {\n  name = \"DuckDuckGo\";\n  description =\n    \"Search for online trends, news, current events, real-time information, or research topics.\";\n\n  public readonly emitter: ToolEmitter<ToolInput<this>, DuckDuckGoSearchToolOutput> =\n    Emitter.root.child({\n      namespace: [\"tool\", \"search\", \"ddg\"],\n      creator: this,\n    });\n\n  protected readonly client: typeof rawDDGSearch;\n\n  @Cache()\n  inputSchema() {\n    return z.object({\n      query: z.string({ description: `Search query` }).min(1).max(128),\n    });\n  }\n\n  public constructor(options: Partial<DuckDuckGoSearchToolOptions> = {}) {\n    super({ ...options, maxResults: options?.maxResults ?? 15 });\n\n    this.client = this._createClient();\n  }\n\n  static {\n    this.register();\n  }\n\n  protected _createClient() {\n    const { throttle } = this.options;\n\n    return throttle === false\n      ? rawDDGSearch\n      : pThrottle({\n          ...throttle,\n          limit: throttle?.limit ?? 1,\n          interval: throttle?.interval ?? 3000,\n        })(rawDDGSearch);\n  }\n\n  protected async _run(\n    { query: input }: ToolInput<this>,\n    options: Partial<DuckDuckGoSearchToolRunOptions>,\n    run: RunContext<this>,\n  ) {\n    const headers = new HeaderGenerator().getHeaders();\n\n    const results = await paginate({\n      size: this.options.maxResults,\n      handler: async ({ cursor = 0 }) => {\n        const { results: data, noResults: done } = await this.client(\n          input,\n          {\n            safeSearch: SafeSearchType.MODERATE,\n            ...this.options.search,\n            ...options?.search,\n            offset: cursor,\n          },\n          {\n            headers,\n            user_agent: headers[\"user-agent\"],\n            ...this.options?.httpClientOptions,\n            ...options?.httpClientOptions,\n            signal: run.signal,\n            uri_modifier: (rawUrl) => {\n              const url = new URL(rawUrl);\n              url.searchParams.delete(\"ss_mkt\");\n              return url.toString();\n            },\n          },\n        );\n\n        return {\n          data,\n          nextCursor: done ? undefined : cursor + data.length,\n        };\n      },\n    });\n\n    return new DuckDuckGoSearchToolOutput(\n      results.map((result) => ({\n        title: stripHtml(result.title).result,\n        description: stripHtml(result.description).result,\n        url: result.url,\n      })),\n    );\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void {\n    super.loadSnapshot(snapshot);\n    Object.assign(this, { client: this._createClient() });\n  }\n}\n"]}

package/dist/tools/search/googleSearch.cjs

@@ -0,0 +1,155 @@
+'use strict';
+
+var customsearch = require('@googleapis/customsearch');
+var base_cjs = require('./base.cjs');
+var base_cjs$1 = require('../base.cjs');
+var zod = require('zod');
+var decoratorCache_cjs = require('../../cache/decoratorCache.cjs');
+var errors_cjs = require('../../errors.cjs');
+var env_cjs = require('../../internals/env.cjs');
+var paginate_cjs = require('../../internals/helpers/paginate.cjs');
+var ajv = require('ajv');
+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 GoogleSearchToolOutput extends base_cjs.SearchToolOutput {
+  static {
+    __name(this, "GoogleSearchToolOutput");
+  }
+  results;
+  constructor(results) {
+    super(results), this.results = results;
+  }
+  static {
+    this.register();
+  }
+  createSnapshot() {
+    return {
+      results: this.results
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+class GoogleSearchTool extends base_cjs$1.Tool {
+  static {
+    __name(this, "GoogleSearchTool");
+  }
+  name = "GoogleSearch";
+  description = `Search for online trends, news, current events, real-time information, or research topics.`;
+  emitter = emitter_cjs.Emitter.root.child({
+    namespace: [
+      "tool",
+      "search",
+      "google"
+    ],
+    creator: this
+  });
+  inputSchema() {
+    return zod.z.object({
+      query: zod.z.string({
+        description: `Search query`
+      }).min(1).max(2048)
+    });
+  }
+  apiKey;
+  cseId;
+  constructor(options = {
+    maxResults: 10
+  }) {
+    super(options);
+    this.apiKey = options.apiKey || env_cjs.parseEnv("GOOGLE_API_KEY", zod.z.string());
+    this.cseId = options.cseId || env_cjs.parseEnv("GOOGLE_CSE_ID", zod.z.string());
+    if (!this.apiKey || !this.cseId) {
+      throw new errors_cjs.ValueError([
+        `"apiKey" or "cseId" must both be provided.`,
+        `Either set them directly or put them in ENV ("GOOGLE_API_KEY" / "GOOGLE_CSE_ID")`
+      ].join("\n"));
+    }
+    if (options.maxResults < 1 || options.maxResults > 100) {
+      throw new ajv.ValidationError([
+        {
+          message: "Property 'maxResults' must be between 1 and 100",
+          propertyName: "options.maxResults"
+        }
+      ]);
+    }
+  }
+  get client() {
+    return new customsearch.customsearch_v1.Customsearch({
+      auth: this.apiKey
+    });
+  }
+  static {
+    this.register();
+  }
+  async _run({ query: input }, _options, run) {
+    const results = await paginate_cjs.paginate({
+      size: this.options.maxResults,
+      handler: /* @__PURE__ */ __name(async ({ cursor = 0, limit }) => {
+        const maxChunkSize = 10;
+        const { data: { items = [] } } = await this.client.cse.list({
+          cx: this.cseId,
+          q: input,
+          start: cursor,
+          num: Math.min(limit, maxChunkSize),
+          safe: "active"
+        }, {
+          signal: run.signal
+        });
+        return {
+          data: items,
+          nextCursor: items.length < maxChunkSize ? void 0 : cursor + items.length
+        };
+      }, "handler")
+    });
+    return new GoogleSearchToolOutput(results.map((result) => ({
+      title: result.title || "",
+      description: result.snippet || "",
+      url: result.link || ""
+    })));
+  }
+  createSnapshot() {
+    return {
+      ...super.createSnapshot(),
+      apiKey: this.apiKey,
+      cseId: this.cseId
+    };
+  }
+  loadSnapshot({ apiKey, cseId, ...snapshot }) {
+    super.loadSnapshot(snapshot);
+    Object.assign(this, {
+      apiKey,
+      cseId
+    });
+  }
+}
+_ts_decorate([
+  decoratorCache_cjs.Cache(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", []),
+  _ts_metadata("design:returntype", void 0)
+], GoogleSearchTool.prototype, "inputSchema", null);
+_ts_decorate([
+  decoratorCache_cjs.Cache(),
+  _ts_metadata("design:type", typeof customsearch.customsearch_v1 === "undefined" || typeof customsearch.customsearch_v1.Customsearch === "undefined" ? Object : customsearch.customsearch_v1.Customsearch),
+  _ts_metadata("design:paramtypes", [])
+], GoogleSearchTool.prototype, "client", null);
+
+exports.GoogleSearchTool = GoogleSearchTool;
+exports.GoogleSearchToolOutput = GoogleSearchToolOutput;
+//# sourceMappingURL=googleSearch.cjs.map
+//# sourceMappingURL=googleSearch.cjs.map

package/dist/tools/search/googleSearch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/search/googleSearch.ts"],"names":["GoogleSearchToolOutput","SearchToolOutput","constructor","results","register","createSnapshot","loadSnapshot","snapshot","Object","assign","GoogleSearchTool","Tool","name","description","emitter","Emitter","root","child","namespace","creator","inputSchema","z","object","query","string","min","max","apiKey","cseId","options","maxResults","parseEnv","ValueError","join","ValidationError","message","propertyName","client","GoogleSearchAPI","Customsearch","auth","_run","input","_options","run","paginate","size","handler","cursor","limit","maxChunkSize","data","items","cse","list","cx","q","start","num","Math","safe","signal","nextCursor","length","undefined","map","result","title","snippet","url","link"],"mappings":"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","file":"googleSearch.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 { customsearch_v1 as GoogleSearchAPI } from \"@googleapis/customsearch\";\nimport {\n  SearchToolOptions,\n  SearchToolOutput,\n  SearchToolResult,\n  SearchToolRunOptions,\n} from \"./base.js\";\nimport { ToolEmitter, Tool, ToolInput } from \"@/tools/base.js\";\nimport { z } from \"zod\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { ValueError } from \"@/errors.js\";\nimport { parseEnv } from \"@/internals/env.js\";\nimport { RunContext } from \"@/context.js\";\nimport { paginate } from \"@/internals/helpers/paginate.js\";\nimport { ValidationError } from \"ajv\";\nimport { Emitter } from \"@/emitter/emitter.js\";\n\nexport interface GoogleSearchToolOptions extends SearchToolOptions {\n  apiKey?: string;\n  cseId?: string;\n  maxResults: number;\n}\n\ntype GoogleSearchToolRunOptions = SearchToolRunOptions;\n\nexport interface GoogleSearchToolResult extends SearchToolResult {}\n\nexport class GoogleSearchToolOutput extends SearchToolOutput<GoogleSearchToolResult> {\n  constructor(public readonly results: GoogleSearchToolResult[]) {\n    super(results);\n  }\n\n  static {\n    this.register();\n  }\n\n  createSnapshot() {\n    return {\n      results: this.results,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n\nexport class GoogleSearchTool extends Tool<\n  GoogleSearchToolOutput,\n  GoogleSearchToolOptions,\n  GoogleSearchToolRunOptions\n> {\n  name = \"GoogleSearch\";\n  description = `Search for online trends, news, current events, real-time information, or research topics.`;\n\n  public readonly emitter: ToolEmitter<ToolInput<this>, GoogleSearchToolOutput> =\n    Emitter.root.child({\n      namespace: [\"tool\", \"search\", \"google\"],\n      creator: this,\n    });\n\n  @Cache()\n  inputSchema() {\n    return z.object({\n      query: z.string({ description: `Search query` }).min(1).max(2048),\n    });\n  }\n\n  protected apiKey: string;\n  protected cseId: string;\n\n  public constructor(options: GoogleSearchToolOptions = { maxResults: 10 }) {\n    super(options);\n\n    this.apiKey = options.apiKey || parseEnv(\"GOOGLE_API_KEY\", z.string());\n    this.cseId = options.cseId || parseEnv(\"GOOGLE_CSE_ID\", z.string());\n\n    if (!this.apiKey || !this.cseId) {\n      throw new ValueError(\n        [\n          `\"apiKey\" or \"cseId\" must both be provided.`,\n          `Either set them directly or put them in ENV (\"GOOGLE_API_KEY\" / \"GOOGLE_CSE_ID\")`,\n        ].join(\"\\n\"),\n      );\n    }\n\n    if (options.maxResults < 1 || options.maxResults > 100) {\n      throw new ValidationError([\n        {\n          message: \"Property 'maxResults' must be between 1 and 100\",\n          propertyName: \"options.maxResults\",\n        },\n      ]);\n    }\n  }\n\n  @Cache()\n  protected get client(): GoogleSearchAPI.Customsearch {\n    return new GoogleSearchAPI.Customsearch({\n      auth: this.apiKey,\n    });\n  }\n\n  static {\n    this.register();\n  }\n\n  protected async _run(\n    { query: input }: ToolInput<this>,\n    _options: Partial<GoogleSearchToolRunOptions>,\n    run: RunContext<this>,\n  ) {\n    const results = await paginate({\n      size: this.options.maxResults,\n      handler: async ({ cursor = 0, limit }) => {\n        const maxChunkSize = 10;\n\n        const {\n          data: { items = [] },\n        } = await this.client.cse.list(\n          {\n            cx: this.cseId,\n            q: input,\n            start: cursor,\n            num: Math.min(limit, maxChunkSize),\n            safe: \"active\",\n          },\n          {\n            signal: run.signal,\n          },\n        );\n\n        return {\n          data: items,\n          nextCursor: items.length < maxChunkSize ? undefined : cursor + items.length,\n        };\n      },\n    });\n\n    return new GoogleSearchToolOutput(\n      results.map((result) => ({\n        title: result.title || \"\",\n        description: result.snippet || \"\",\n        url: result.link || \"\",\n      })),\n    );\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      apiKey: this.apiKey,\n      cseId: this.cseId,\n    };\n  }\n\n  loadSnapshot({ apiKey, cseId, ...snapshot }: ReturnType<typeof this.createSnapshot>) {\n    super.loadSnapshot(snapshot);\n    Object.assign(this, {\n      apiKey,\n      cseId,\n    });\n  }\n}\n"]}