beeai-framework 0.1.2

package/dist/tools/python/storage.d.cts

@@ -0,0 +1,83 @@
+import { PathLike } from 'fs';
+import { Serializable } from '../../internals/serializable.cjs';
+import '../../internals/types.cjs';
+import '../../internals/helpers/guards.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 PythonFile {
+    id: string;
+    pythonId: string;
+    filename: string;
+}
+interface PythonUploadFile {
+    id: string;
+    filename: string;
+}
+interface PythonDownloadFile {
+    id?: string;
+    filename: string;
+    pythonId: string;
+}
+declare abstract class PythonStorage extends Serializable {
+    /**
+     * List all files that code interpreter can use.
+     */
+    abstract list(): Promise<PythonFile[]>;
+    /**
+     * Prepare subset of available files to code interpreter.
+     */
+    abstract upload(files: PythonUploadFile[]): Promise<PythonFile[]>;
+    /**
+     * Process updated/modified/deleted files from code interpreter response.
+     */
+    abstract download(files: PythonDownloadFile[]): Promise<PythonFile[]>;
+}
+declare class TemporaryStorage extends PythonStorage {
+    protected files: PythonFile[];
+    list(): Promise<PythonFile[]>;
+    upload(files: PythonUploadFile[]): Promise<PythonFile[]>;
+    download(files: PythonDownloadFile[]): Promise<PythonFile[]>;
+    createSnapshot(): {
+        files: PythonFile[];
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+interface Input {
+    localWorkingDir: PathLike;
+    interpreterWorkingDir: PathLike;
+    ignoredFiles?: Set<string>;
+}
+declare class LocalPythonStorage extends PythonStorage {
+    protected readonly input: Required<Input>;
+    constructor(input: Input);
+    protected init(): Promise<void>;
+    list(): Promise<PythonFile[]>;
+    upload(files: PythonUploadFile[]): Promise<PythonFile[]>;
+    download(files: PythonDownloadFile[]): Promise<{
+        id: string;
+        filename: string;
+        pythonId: string;
+    }[]>;
+    protected computeHash(file: PathLike): Promise<string>;
+    createSnapshot(): {
+        input: Required<Input>;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { LocalPythonStorage, type PythonDownloadFile, type PythonFile, PythonStorage, type PythonUploadFile, TemporaryStorage };

package/dist/tools/python/storage.d.ts

@@ -0,0 +1,83 @@
+import { PathLike } from 'fs';
+import { Serializable } from '../../internals/serializable.js';
+import '../../internals/types.js';
+import '../../internals/helpers/guards.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 PythonFile {
+    id: string;
+    pythonId: string;
+    filename: string;
+}
+interface PythonUploadFile {
+    id: string;
+    filename: string;
+}
+interface PythonDownloadFile {
+    id?: string;
+    filename: string;
+    pythonId: string;
+}
+declare abstract class PythonStorage extends Serializable {
+    /**
+     * List all files that code interpreter can use.
+     */
+    abstract list(): Promise<PythonFile[]>;
+    /**
+     * Prepare subset of available files to code interpreter.
+     */
+    abstract upload(files: PythonUploadFile[]): Promise<PythonFile[]>;
+    /**
+     * Process updated/modified/deleted files from code interpreter response.
+     */
+    abstract download(files: PythonDownloadFile[]): Promise<PythonFile[]>;
+}
+declare class TemporaryStorage extends PythonStorage {
+    protected files: PythonFile[];
+    list(): Promise<PythonFile[]>;
+    upload(files: PythonUploadFile[]): Promise<PythonFile[]>;
+    download(files: PythonDownloadFile[]): Promise<PythonFile[]>;
+    createSnapshot(): {
+        files: PythonFile[];
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+interface Input {
+    localWorkingDir: PathLike;
+    interpreterWorkingDir: PathLike;
+    ignoredFiles?: Set<string>;
+}
+declare class LocalPythonStorage extends PythonStorage {
+    protected readonly input: Required<Input>;
+    constructor(input: Input);
+    protected init(): Promise<void>;
+    list(): Promise<PythonFile[]>;
+    upload(files: PythonUploadFile[]): Promise<PythonFile[]>;
+    download(files: PythonDownloadFile[]): Promise<{
+        id: string;
+        filename: string;
+        pythonId: string;
+    }[]>;
+    protected computeHash(file: PathLike): Promise<string>;
+    createSnapshot(): {
+        input: Required<Input>;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { LocalPythonStorage, type PythonDownloadFile, type PythonFile, PythonStorage, type PythonUploadFile, TemporaryStorage };

package/dist/tools/python/storage.js

@@ -0,0 +1,142 @@
+import * as crypto from 'node:crypto';
+import { pipeline } from 'node:stream/promises';
+import fs, { createReadStream } from 'node:fs';
+import { copyFile } from 'node:fs/promises';
+import path from 'node:path';
+import { Cache } from '../../cache/decoratorCache.js';
+import { Serializable } from '../../internals/serializable.js';
+import { shallowCopy } from '../../serializer/utils.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 PythonStorage extends Serializable {
+  static {
+    __name(this, "PythonStorage");
+  }
+}
+class TemporaryStorage extends PythonStorage {
+  static {
+    __name(this, "TemporaryStorage");
+  }
+  files = [];
+  async list() {
+    return this.files.slice();
+  }
+  async upload(files) {
+    return files.map((file) => ({
+      id: file.id,
+      pythonId: file.id,
+      filename: file.filename
+    }));
+  }
+  async download(files) {
+    this.files = [
+      ...this.files.filter((file) => files.every((f) => f.filename !== file.filename)),
+      ...files.map((file) => ({
+        id: file.pythonId,
+        ...file
+      }))
+    ];
+    return this.files.slice();
+  }
+  createSnapshot() {
+    return {
+      files: this.files.slice()
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+class LocalPythonStorage extends PythonStorage {
+  static {
+    __name(this, "LocalPythonStorage");
+  }
+  input;
+  constructor(input) {
+    super();
+    this.input = {
+      ...input,
+      ignoredFiles: input?.ignoredFiles ?? /* @__PURE__ */ new Set([
+        ".gitkeep"
+      ])
+    };
+  }
+  async init() {
+    await fs.promises.mkdir(this.input.localWorkingDir, {
+      recursive: true
+    });
+    await fs.promises.mkdir(this.input.interpreterWorkingDir, {
+      recursive: true
+    });
+  }
+  async list() {
+    await this.init();
+    const files = await fs.promises.readdir(this.input.localWorkingDir, {
+      withFileTypes: true,
+      recursive: false
+    });
+    return Promise.all(files.filter((file) => file.isFile() && !this.input.ignoredFiles.has(file.name)).map(async (file) => {
+      const pythonId = await this.computeHash(path.join(this.input.localWorkingDir.toString(), file.name));
+      return {
+        id: pythonId,
+        filename: file.name,
+        pythonId
+      };
+    }));
+  }
+  async upload(files) {
+    await this.init();
+    const fileList = await this.list();
+    await Promise.all(files.map((file) => {
+      const filesystemFile = fileList.find((filesystemFile2) => filesystemFile2.id === file.id);
+      return copyFile(path.join(this.input.localWorkingDir.toString(), filesystemFile.filename), path.join(this.input.interpreterWorkingDir.toString(), filesystemFile.id));
+    }));
+    return files.map((file) => ({
+      ...file,
+      pythonId: file.id
+    }));
+  }
+  async download(files) {
+    await this.init();
+    await Promise.all(files.map((file) => copyFile(path.join(this.input.interpreterWorkingDir.toString(), file.pythonId), path.join(this.input.localWorkingDir.toString(), file.filename))));
+    return files.map((file) => ({
+      ...file,
+      id: file.pythonId
+    }));
+  }
+  async computeHash(file) {
+    const hash = crypto.createHash("sha256");
+    await pipeline(createReadStream(file), hash);
+    return hash.digest("hex");
+  }
+  createSnapshot() {
+    return {
+      input: shallowCopy(this.input)
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+_ts_decorate([
+  Cache(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", []),
+  _ts_metadata("design:returntype", Promise)
+], LocalPythonStorage.prototype, "init", null);
+
+export { LocalPythonStorage, PythonStorage, TemporaryStorage };
+//# sourceMappingURL=storage.js.map
+//# sourceMappingURL=storage.js.map

package/dist/tools/python/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/python/storage.ts"],"names":["PythonStorage","Serializable","TemporaryStorage","files","list","slice","upload","map","file","id","pythonId","filename","download","filter","every","f","createSnapshot","loadSnapshot","snapshot","Object","assign","LocalPythonStorage","input","constructor","ignoredFiles","Set","init","fs","promises","mkdir","localWorkingDir","recursive","interpreterWorkingDir","readdir","withFileTypes","Promise","all","isFile","has","name","computeHash","path","join","toString","fileList","filesystemFile","find","copyFile","hash","crypto","createHash","pipeline","createReadStream","digest","shallowCopy"],"mappings":"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","file":"storage.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 { PathLike } from \"fs\";\nimport * as crypto from \"node:crypto\";\nimport { pipeline } from \"node:stream/promises\";\nimport fs, { createReadStream } from \"node:fs\";\nimport { copyFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\n\nexport interface PythonFile {\n  id: string;\n  pythonId: string;\n  filename: string;\n}\n\nexport interface PythonUploadFile {\n  id: string;\n  filename: string;\n}\n\nexport interface PythonDownloadFile {\n  id?: string;\n  filename: string;\n  pythonId: string;\n}\n\nexport abstract class PythonStorage extends Serializable {\n  /**\n   * List all files that code interpreter can use.\n   */\n  abstract list(): Promise<PythonFile[]>;\n\n  /**\n   * Prepare subset of available files to code interpreter.\n   */\n  abstract upload(files: PythonUploadFile[]): Promise<PythonFile[]>;\n\n  /**\n   * Process updated/modified/deleted files from code interpreter response.\n   */\n  abstract download(files: PythonDownloadFile[]): Promise<PythonFile[]>;\n}\n\nexport class TemporaryStorage extends PythonStorage {\n  protected files: PythonFile[] = [];\n\n  async list() {\n    return this.files.slice();\n  }\n\n  async upload(files: PythonUploadFile[]): Promise<PythonFile[]> {\n    return files.map((file) => ({\n      id: file.id,\n      pythonId: file.id,\n      filename: file.filename,\n    }));\n  }\n\n  async download(files: PythonDownloadFile[]) {\n    this.files = [\n      ...this.files.filter((file) => files.every((f) => f.filename !== file.filename)),\n      ...files.map((file) => ({ id: file.pythonId, ...file })),\n    ];\n    return this.files.slice();\n  }\n\n  createSnapshot() {\n    return { files: this.files.slice() };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n\ninterface Input {\n  localWorkingDir: PathLike;\n  interpreterWorkingDir: PathLike;\n  ignoredFiles?: Set<string>;\n}\n\nexport class LocalPythonStorage extends PythonStorage {\n  protected readonly input: Required<Input>;\n\n  constructor(input: Input) {\n    super();\n    this.input = {\n      ...input,\n      ignoredFiles: input?.ignoredFiles ?? new Set([\".gitkeep\"]),\n    };\n  }\n\n  @Cache()\n  protected async init() {\n    await fs.promises.mkdir(this.input.localWorkingDir, { recursive: true });\n    await fs.promises.mkdir(this.input.interpreterWorkingDir, { recursive: true });\n  }\n\n  async list(): Promise<PythonFile[]> {\n    await this.init();\n\n    const files = await fs.promises.readdir(this.input.localWorkingDir, {\n      withFileTypes: true,\n      recursive: false,\n    });\n    return Promise.all(\n      files\n        .filter((file) => file.isFile() && !this.input.ignoredFiles.has(file.name))\n        .map(async (file) => {\n          const pythonId = await this.computeHash(\n            path.join(this.input.localWorkingDir.toString(), file.name),\n          );\n\n          return {\n            id: pythonId,\n            filename: file.name,\n            pythonId,\n          };\n        }),\n    );\n  }\n\n  async upload(files: PythonUploadFile[]): Promise<PythonFile[]> {\n    await this.init();\n\n    const fileList = await this.list();\n\n    await Promise.all(\n      files.map((file) => {\n        const filesystemFile = fileList.find((filesystemFile) => filesystemFile.id === file.id)!;\n        return copyFile(\n          path.join(this.input.localWorkingDir.toString(), filesystemFile.filename),\n          path.join(this.input.interpreterWorkingDir.toString(), filesystemFile.id),\n        );\n      }),\n    );\n    return files.map((file) => ({ ...file, pythonId: file.id }));\n  }\n\n  async download(files: PythonDownloadFile[]) {\n    await this.init();\n\n    await Promise.all(\n      files.map((file) =>\n        copyFile(\n          path.join(this.input.interpreterWorkingDir.toString(), file.pythonId),\n          path.join(this.input.localWorkingDir.toString(), file.filename),\n        ),\n      ),\n    );\n    return files.map((file) => ({ ...file, id: file.pythonId }));\n  }\n\n  protected async computeHash(file: PathLike) {\n    const hash = crypto.createHash(\"sha256\");\n    await pipeline(createReadStream(file), hash);\n    return hash.digest(\"hex\");\n  }\n\n  createSnapshot() {\n    return { input: shallowCopy(this.input) };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/tools/search/base.cjs

@@ -0,0 +1,77 @@
+'use strict';
+
+var base_cjs = require('../base.cjs');
+var decoratorCache_cjs = require('../../cache/decoratorCache.cjs');
+var R = require('remeda');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var R__namespace = /*#__PURE__*/_interopNamespace(R);
+
+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 SearchToolOutput extends base_cjs.ToolOutput {
+  static {
+    __name(this, "SearchToolOutput");
+  }
+  results;
+  constructor(results) {
+    super(), this.results = results;
+  }
+  get sources() {
+    return R__namespace.unique(this.results.map((result) => result.url));
+  }
+  isEmpty() {
+    return this.results.length === 0;
+  }
+  getTextContent() {
+    return this.results.map((result) => JSON.stringify(result, null, 2)).join("\n\n");
+  }
+}
+_ts_decorate([
+  decoratorCache_cjs.Cache({
+    cacheKey: decoratorCache_cjs.WeakRefKeyFn.from((self) => self.results),
+    enumerable: false
+  }),
+  _ts_metadata("design:type", void 0),
+  _ts_metadata("design:paramtypes", [])
+], SearchToolOutput.prototype, "sources", null);
+_ts_decorate([
+  decoratorCache_cjs.Cache({
+    cacheKey: decoratorCache_cjs.WeakRefKeyFn.from((self) => self.results)
+  }),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", []),
+  _ts_metadata("design:returntype", String)
+], SearchToolOutput.prototype, "getTextContent", null);
+
+exports.SearchToolOutput = SearchToolOutput;
+//# sourceMappingURL=base.cjs.map
+//# sourceMappingURL=base.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/search/base.ts"],"names":["SearchToolOutput","ToolOutput","constructor","results","sources","R","unique","map","result","url","isEmpty","length","getTextContent","JSON","stringify","join","cacheKey","WeakRefKeyFn","from","self","enumerable"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcC,SAAA,YAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAAA,EAAA,IAAA,EAAA;;;;;;AAAA,MAAA,CAAA,YAAA,EAAA,cAAA,CAAA;;;;;AAgBM,MAAeA,yBAEZC,mBAAAA,CAAAA;EAhCV;;;;AAiCEC,EAAAA,WAAAA,CAA4BC,OAA8B,EAAA;AACxD,IAAK,KAAA,EAAA,EAAA,KADqBA,OAAAA,GAAAA,OAAAA;AAE5B;AAEA,EAAA,IAIIC,OAAU,GAAA;AACZ,IAAOC,OAAAA,YAAAA,CAAEC,OAAO,IAAKH,CAAAA,OAAAA,CAAQI,IAAI,CAACC,MAAAA,KAAWA,MAAOC,CAAAA,GAAG,CAAA,CAAA;AACzD;EAEAC,OAAU,GAAA;AACR,IAAO,OAAA,IAAA,CAAKP,QAAQQ,MAAW,KAAA,CAAA;AACjC;EAKAC,cAAyB,GAAA;AACvB,IAAA,OAAO,IAAKT,CAAAA,OAAAA,CAAQI,GAAI,CAAA,CAACC,MAAWK,KAAAA,IAAAA,CAAKC,SAAUN,CAAAA,MAAAA,EAAQ,IAAM,EAAA,CAAA,CAAA,CAAA,CAAIO,KAAK,MAAA,CAAA;AAC5E;AACF;;;AAjBIC,IAAAA,QAAAA,EAAUC,+BAAaC,CAAAA,IAAAA,CAAuB,CAACC,IAAAA,KAASA,KAAKhB,OAAO,CAAA;IACpEiB,UAAY,EAAA;;;;;;;AAWZJ,IAAAA,QAAAA,EAAUC,+BAAaC,CAAAA,IAAAA,CAAuB,CAACC,IAAAA,KAASA,KAAKhB,OAAO","file":"base.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 { BaseToolOptions, BaseToolRunOptions, ToolOutput } from \"@/tools/base.js\";\nimport { Cache, WeakRefKeyFn } from \"@/cache/decoratorCache.js\";\nimport * as R from \"remeda\";\n\nexport interface SearchToolOptions extends BaseToolOptions {}\n\nexport interface SearchToolRunOptions extends BaseToolRunOptions {}\n\nexport interface SearchToolResult {\n  title: string;\n  description: string;\n  url: string;\n}\n\nexport abstract class SearchToolOutput<\n  TSearchToolResult extends SearchToolResult = SearchToolResult,\n> extends ToolOutput {\n  constructor(public readonly results: TSearchToolResult[]) {\n    super();\n  }\n\n  @Cache({\n    cacheKey: WeakRefKeyFn.from<SearchToolOutput>((self) => self.results),\n    enumerable: false,\n  })\n  get sources() {\n    return R.unique(this.results.map((result) => result.url));\n  }\n\n  isEmpty() {\n    return this.results.length === 0;\n  }\n\n  @Cache({\n    cacheKey: WeakRefKeyFn.from<SearchToolOutput>((self) => self.results),\n  })\n  getTextContent(): string {\n    return this.results.map((result) => JSON.stringify(result, null, 2)).join(\"\\n\\n\");\n  }\n}\n"]}

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

@@ -0,0 +1,49 @@
+import { BaseToolOptions, BaseToolRunOptions, ToolOutput } from '../base.cjs';
+import 'ajv';
+import '../../context.cjs';
+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';
+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 SearchToolOptions extends BaseToolOptions {
+}
+interface SearchToolRunOptions extends BaseToolRunOptions {
+}
+interface SearchToolResult {
+    title: string;
+    description: string;
+    url: string;
+}
+declare abstract class SearchToolOutput<TSearchToolResult extends SearchToolResult = SearchToolResult> extends ToolOutput {
+    readonly results: TSearchToolResult[];
+    constructor(results: TSearchToolResult[]);
+    get sources(): string[];
+    isEmpty(): boolean;
+    getTextContent(): string;
+}
+
+export { type SearchToolOptions, SearchToolOutput, type SearchToolResult, type SearchToolRunOptions };

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

@@ -0,0 +1,49 @@
+import { BaseToolOptions, BaseToolRunOptions, ToolOutput } from '../base.js';
+import 'ajv';
+import '../../context.js';
+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';
+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 SearchToolOptions extends BaseToolOptions {
+}
+interface SearchToolRunOptions extends BaseToolRunOptions {
+}
+interface SearchToolResult {
+    title: string;
+    description: string;
+    url: string;
+}
+declare abstract class SearchToolOutput<TSearchToolResult extends SearchToolResult = SearchToolResult> extends ToolOutput {
+    readonly results: TSearchToolResult[];
+    constructor(results: TSearchToolResult[]);
+    get sources(): string[];
+    isEmpty(): boolean;
+    getTextContent(): string;
+}
+
+export { type SearchToolOptions, SearchToolOutput, type SearchToolResult, type SearchToolRunOptions };

package/dist/tools/search/base.js

@@ -0,0 +1,55 @@
+import { ToolOutput } from '../base.js';
+import { Cache, WeakRefKeyFn } from '../../cache/decoratorCache.js';
+import * as R from 'remeda';
+
+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 SearchToolOutput extends ToolOutput {
+  static {
+    __name(this, "SearchToolOutput");
+  }
+  results;
+  constructor(results) {
+    super(), this.results = results;
+  }
+  get sources() {
+    return R.unique(this.results.map((result) => result.url));
+  }
+  isEmpty() {
+    return this.results.length === 0;
+  }
+  getTextContent() {
+    return this.results.map((result) => JSON.stringify(result, null, 2)).join("\n\n");
+  }
+}
+_ts_decorate([
+  Cache({
+    cacheKey: WeakRefKeyFn.from((self) => self.results),
+    enumerable: false
+  }),
+  _ts_metadata("design:type", void 0),
+  _ts_metadata("design:paramtypes", [])
+], SearchToolOutput.prototype, "sources", null);
+_ts_decorate([
+  Cache({
+    cacheKey: WeakRefKeyFn.from((self) => self.results)
+  }),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", []),
+  _ts_metadata("design:returntype", String)
+], SearchToolOutput.prototype, "getTextContent", null);
+
+export { SearchToolOutput };
+//# sourceMappingURL=base.js.map
+//# sourceMappingURL=base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/search/base.ts"],"names":["SearchToolOutput","ToolOutput","constructor","results","sources","R","unique","map","result","url","isEmpty","length","getTextContent","JSON","stringify","join","cacheKey","WeakRefKeyFn","from","self","enumerable"],"mappings":";;;;;;AAcC,SAAA,YAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAAA,EAAA,IAAA,EAAA;;;;;;AAAA,MAAA,CAAA,YAAA,EAAA,cAAA,CAAA;;;;;AAgBM,MAAeA,yBAEZC,UAAAA,CAAAA;EAhCV;;;;AAiCEC,EAAAA,WAAAA,CAA4BC,OAA8B,EAAA;AACxD,IAAK,KAAA,EAAA,EAAA,KADqBA,OAAAA,GAAAA,OAAAA;AAE5B;AAEA,EAAA,IAIIC,OAAU,GAAA;AACZ,IAAOC,OAAAA,CAAAA,CAAEC,OAAO,IAAKH,CAAAA,OAAAA,CAAQI,IAAI,CAACC,MAAAA,KAAWA,MAAOC,CAAAA,GAAG,CAAA,CAAA;AACzD;EAEAC,OAAU,GAAA;AACR,IAAO,OAAA,IAAA,CAAKP,QAAQQ,MAAW,KAAA,CAAA;AACjC;EAKAC,cAAyB,GAAA;AACvB,IAAA,OAAO,IAAKT,CAAAA,OAAAA,CAAQI,GAAI,CAAA,CAACC,MAAWK,KAAAA,IAAAA,CAAKC,SAAUN,CAAAA,MAAAA,EAAQ,IAAM,EAAA,CAAA,CAAA,CAAA,CAAIO,KAAK,MAAA,CAAA;AAC5E;AACF;;;AAjBIC,IAAAA,QAAAA,EAAUC,YAAaC,CAAAA,IAAAA,CAAuB,CAACC,IAAAA,KAASA,KAAKhB,OAAO,CAAA;IACpEiB,UAAY,EAAA;;;;;;;AAWZJ,IAAAA,QAAAA,EAAUC,YAAaC,CAAAA,IAAAA,CAAuB,CAACC,IAAAA,KAASA,KAAKhB,OAAO","file":"base.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 { BaseToolOptions, BaseToolRunOptions, ToolOutput } from \"@/tools/base.js\";\nimport { Cache, WeakRefKeyFn } from \"@/cache/decoratorCache.js\";\nimport * as R from \"remeda\";\n\nexport interface SearchToolOptions extends BaseToolOptions {}\n\nexport interface SearchToolRunOptions extends BaseToolRunOptions {}\n\nexport interface SearchToolResult {\n  title: string;\n  description: string;\n  url: string;\n}\n\nexport abstract class SearchToolOutput<\n  TSearchToolResult extends SearchToolResult = SearchToolResult,\n> extends ToolOutput {\n  constructor(public readonly results: TSearchToolResult[]) {\n    super();\n  }\n\n  @Cache({\n    cacheKey: WeakRefKeyFn.from<SearchToolOutput>((self) => self.results),\n    enumerable: false,\n  })\n  get sources() {\n    return R.unique(this.results.map((result) => result.url));\n  }\n\n  isEmpty() {\n    return this.results.length === 0;\n  }\n\n  @Cache({\n    cacheKey: WeakRefKeyFn.from<SearchToolOutput>((self) => self.results),\n  })\n  getTextContent(): string {\n    return this.results.map((result) => JSON.stringify(result, null, 2)).join(\"\\n\\n\");\n  }\n}\n"]}