beeai-framework 0.1.2

package/dist/tools/calculator.cjs

@@ -0,0 +1,74 @@
+'use strict';
+
+var base_cjs = require('./base.cjs');
+var zod = require('zod');
+var mathjs = require('mathjs');
+var emitter_cjs = require('../emitter/emitter.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class CalculatorTool extends base_cjs.Tool {
+  static {
+    __name(this, "CalculatorTool");
+  }
+  name = "Calculator";
+  description = `A calculator tool that performs basic arithmetic operations like addition, subtraction, multiplication, and division. 
+Only use the calculator tool if you need to perform a calculation.`;
+  emitter = emitter_cjs.Emitter.root.child({
+    namespace: [
+      "tool",
+      "calculator"
+    ],
+    creator: this
+  });
+  inputSchema() {
+    return zod.z.object({
+      expression: zod.z.string().min(1).describe(`The mathematical expression to evaluate (e.g., "2 + 3 * 4"). Use Mathjs basic expression syntax. Constants only.`)
+    });
+  }
+  limitedEvaluate;
+  constructor({ config, imports, ...options } = {}) {
+    super(options);
+    const math = mathjs.create(mathjs.all, config);
+    this.limitedEvaluate = math.evaluate;
+    math.import({
+      // most important (hardly any functional impact)
+      import: /* @__PURE__ */ __name(function() {
+        throw new Error("Function import is disabled");
+      }, "import"),
+      createUnit: /* @__PURE__ */ __name(function() {
+        throw new Error("Function createUnit is disabled");
+      }, "createUnit"),
+      reviver: /* @__PURE__ */ __name(function() {
+        throw new Error("Function reviver is disabled");
+      }, "reviver"),
+      // extra (has functional impact)
+      evaluate: /* @__PURE__ */ __name(function() {
+        throw new Error("Function evaluate is disabled");
+      }, "evaluate"),
+      parse: /* @__PURE__ */ __name(function() {
+        throw new Error("Function parse is disabled");
+      }, "parse"),
+      simplify: /* @__PURE__ */ __name(function() {
+        throw new Error("Function simplify is disabled");
+      }, "simplify"),
+      derivative: /* @__PURE__ */ __name(function() {
+        throw new Error("Function derivative is disabled");
+      }, "derivative"),
+      resolve: /* @__PURE__ */ __name(function() {
+        throw new Error("Function resolve is disabled");
+      }, "resolve")
+    }, {
+      override: true,
+      ...imports?.options
+    });
+  }
+  async _run({ expression }) {
+    const result = this.limitedEvaluate(expression);
+    return new base_cjs.StringToolOutput(result);
+  }
+}
+
+exports.CalculatorTool = CalculatorTool;
+//# sourceMappingURL=calculator.cjs.map
+//# sourceMappingURL=calculator.cjs.map

package/dist/tools/calculator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tools/calculator.ts"],"names":["CalculatorTool","Tool","name","description","emitter","Emitter","root","child","namespace","creator","inputSchema","z","object","expression","string","min","describe","limitedEvaluate","constructor","config","imports","options","math","create","all","evaluate","import","Error","createUnit","reviver","parse","simplify","derivative","resolve","override","_run","result","StringToolOutput"],"mappings":";;;;;;;;;AAoCO,MAAMA,uBAAuBC,aAAAA,CAAAA;EApCpC;;;EAqCEC,IAAO,GAAA,YAAA;EACPC,WAAc,GAAA,CAAA;;EAGEC,OAA0DC,GAAAA,mBAAAA,CAAQC,KAAKC,KAAM,CAAA;IAC3FC,SAAW,EAAA;AAAC,MAAA,MAAA;AAAQ,MAAA;;IACpBC,OAAS,EAAA;GACX,CAAA;EAEAC,WAAc,GAAA;AACZ,IAAA,OAAOC,MAAEC,MAAO,CAAA;AACdC,MAAAA,UAAAA,EAAYF,MACTG,MAAM,EAAA,CACNC,IAAI,CAAA,CAAA,CACJC,SACC,CAAkH,gHAAA,CAAA;KAExH,CAAA;AACF;AAEUC,EAAAA,eAAAA;AAEVC,EAAAA,WAAAA,CAAY,EAAEC,MAAQC,EAAAA,OAAAA,EAAS,GAAGC,OAAAA,EAAAA,GAAiC,EAAI,EAAA;AACrE,IAAA,KAAA,CAAMA,OAAAA,CAAAA;AACN,IAAMC,MAAAA,IAAAA,GAAOC,aAAOC,CAAAA,UAAAA,EAAKL,MAAAA,CAAAA;AACzB,IAAA,IAAA,CAAKF,kBAAkBK,IAAKG,CAAAA,QAAAA;AAE5BH,IAAAA,IAAAA,CAAKI,MACH,CAAA;;AAEEA,MAAAA,MAAAA,kBAAQ,MAAA,CAAA,WAAA;AACN,QAAM,MAAA,IAAIC,MAAM,6BAAA,CAAA;OADV,EAAA,QAAA,CAAA;AAGRC,MAAAA,UAAAA,kBAAY,MAAA,CAAA,WAAA;AACV,QAAM,MAAA,IAAID,MAAM,iCAAA,CAAA;OADN,EAAA,YAAA,CAAA;AAGZE,MAAAA,OAAAA,kBAAS,MAAA,CAAA,WAAA;AACP,QAAM,MAAA,IAAIF,MAAM,8BAAA,CAAA;OADT,EAAA,SAAA,CAAA;;AAKTF,MAAAA,QAAAA,kBAAU,MAAA,CAAA,WAAA;AACR,QAAM,MAAA,IAAIE,MAAM,+BAAA,CAAA;OADR,EAAA,UAAA,CAAA;AAGVG,MAAAA,KAAAA,kBAAO,MAAA,CAAA,WAAA;AACL,QAAM,MAAA,IAAIH,MAAM,4BAAA,CAAA;OADX,EAAA,OAAA,CAAA;AAGPI,MAAAA,QAAAA,kBAAU,MAAA,CAAA,WAAA;AACR,QAAM,MAAA,IAAIJ,MAAM,+BAAA,CAAA;OADR,EAAA,UAAA,CAAA;AAGVK,MAAAA,UAAAA,kBAAY,MAAA,CAAA,WAAA;AACV,QAAM,MAAA,IAAIL,MAAM,iCAAA,CAAA;OADN,EAAA,YAAA,CAAA;AAGZM,MAAAA,OAAAA,kBAAS,MAAA,CAAA,WAAA;AACP,QAAM,MAAA,IAAIN,MAAM,8BAAA,CAAA;OADT,EAAA,SAAA;KAIX,EAAA;MAAEO,QAAU,EAAA,IAAA;AAAM,MAAA,GAAGd,OAASC,EAAAA;KAAQ,CAAA;AAE1C;EAEA,MAAgBc,IAAAA,CAAK,EAAEtB,UAAAA,EAA+B,EAAA;AACpD,IAAMuB,MAAAA,MAAAA,GAAS,IAAKnB,CAAAA,eAAAA,CAAgBJ,UAAAA,CAAAA;AACpC,IAAO,OAAA,IAAIwB,0BAAiBD,MAAAA,CAAAA;AAC9B;AACF","file":"calculator.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 { ToolEmitter, StringToolOutput, Tool, ToolInput } from \"@/tools/base.js\";\nimport { z } from \"zod\";\nimport { create, all, evaluate, ImportOptions, ImportObject, ConfigOptions } from \"mathjs\";\nimport { Emitter } from \"@/emitter/emitter.js\";\n\nexport interface CalculatorToolInput {\n  config?: ConfigOptions;\n  imports?: {\n    entries: ImportObject | ImportObject[];\n    options?: ImportOptions;\n  };\n}\n\n/**\n * Waring: The CalculatorTool enbales the agent (and by proxy the user) to execute arbirtary\n * expressions via mathjs.\n *\n * Please consider the security and stability risks documented at\n * https://mathjs.org/docs/expressions/security.html before using this tool.\n */\nexport class CalculatorTool extends Tool<StringToolOutput> {\n  name = \"Calculator\";\n  description = `A calculator tool that performs basic arithmetic operations like addition, subtraction, multiplication, and division. \nOnly use the calculator tool if you need to perform a calculation.`;\n\n  public readonly emitter: ToolEmitter<ToolInput<this>, StringToolOutput> = Emitter.root.child({\n    namespace: [\"tool\", \"calculator\"],\n    creator: this,\n  });\n\n  inputSchema() {\n    return z.object({\n      expression: z\n        .string()\n        .min(1)\n        .describe(\n          `The mathematical expression to evaluate (e.g., \"2 + 3 * 4\"). Use Mathjs basic expression syntax. Constants only.`,\n        ),\n    });\n  }\n\n  protected limitedEvaluate: typeof evaluate;\n\n  constructor({ config, imports, ...options }: CalculatorToolInput = {}) {\n    super(options);\n    const math = create(all, config);\n    this.limitedEvaluate = math.evaluate;\n    // Disable use of potentially vulnerable functions\n    math.import(\n      {\n        // most important (hardly any functional impact)\n        import: function () {\n          throw new Error(\"Function import is disabled\");\n        },\n        createUnit: function () {\n          throw new Error(\"Function createUnit is disabled\");\n        },\n        reviver: function () {\n          throw new Error(\"Function reviver is disabled\");\n        },\n\n        // extra (has functional impact)\n        evaluate: function () {\n          throw new Error(\"Function evaluate is disabled\");\n        },\n        parse: function () {\n          throw new Error(\"Function parse is disabled\");\n        },\n        simplify: function () {\n          throw new Error(\"Function simplify is disabled\");\n        },\n        derivative: function () {\n          throw new Error(\"Function derivative is disabled\");\n        },\n        resolve: function () {\n          throw new Error(\"Function resolve is disabled\");\n        },\n      },\n      { override: true, ...imports?.options },\n    );\n  }\n\n  protected async _run({ expression }: ToolInput<this>) {\n    const result = this.limitedEvaluate(expression);\n    return new StringToolOutput(result);\n  }\n}\n"]}

package/dist/tools/calculator.d.cts

@@ -0,0 +1,63 @@
+import { Tool, StringToolOutput, ToolEmitter, ToolInput } from './base.cjs';
+import { z } from 'zod';
+import { ConfigOptions, ImportObject, ImportOptions, evaluate } from 'mathjs';
+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-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 CalculatorToolInput {
+    config?: ConfigOptions;
+    imports?: {
+        entries: ImportObject | ImportObject[];
+        options?: ImportOptions;
+    };
+}
+/**
+ * Waring: The CalculatorTool enbales the agent (and by proxy the user) to execute arbirtary
+ * expressions via mathjs.
+ *
+ * Please consider the security and stability risks documented at
+ * https://mathjs.org/docs/expressions/security.html before using this tool.
+ */
+declare class CalculatorTool extends Tool<StringToolOutput> {
+    name: string;
+    description: string;
+    readonly emitter: ToolEmitter<ToolInput<this>, StringToolOutput>;
+    inputSchema(): z.ZodObject<{
+        expression: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        expression: string;
+    }, {
+        expression: string;
+    }>;
+    protected limitedEvaluate: typeof evaluate;
+    constructor({ config, imports, ...options }?: CalculatorToolInput);
+    protected _run({ expression }: ToolInput<this>): Promise<StringToolOutput>;
+}
+
+export { CalculatorTool, type CalculatorToolInput };

package/dist/tools/calculator.d.ts

@@ -0,0 +1,63 @@
+import { Tool, StringToolOutput, ToolEmitter, ToolInput } from './base.js';
+import { z } from 'zod';
+import { ConfigOptions, ImportObject, ImportOptions, evaluate } from 'mathjs';
+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-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 CalculatorToolInput {
+    config?: ConfigOptions;
+    imports?: {
+        entries: ImportObject | ImportObject[];
+        options?: ImportOptions;
+    };
+}
+/**
+ * Waring: The CalculatorTool enbales the agent (and by proxy the user) to execute arbirtary
+ * expressions via mathjs.
+ *
+ * Please consider the security and stability risks documented at
+ * https://mathjs.org/docs/expressions/security.html before using this tool.
+ */
+declare class CalculatorTool extends Tool<StringToolOutput> {
+    name: string;
+    description: string;
+    readonly emitter: ToolEmitter<ToolInput<this>, StringToolOutput>;
+    inputSchema(): z.ZodObject<{
+        expression: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        expression: string;
+    }, {
+        expression: string;
+    }>;
+    protected limitedEvaluate: typeof evaluate;
+    constructor({ config, imports, ...options }?: CalculatorToolInput);
+    protected _run({ expression }: ToolInput<this>): Promise<StringToolOutput>;
+}
+
+export { CalculatorTool, type CalculatorToolInput };

package/dist/tools/calculator.js

@@ -0,0 +1,72 @@
+import { Tool, StringToolOutput } from './base.js';
+import { z } from 'zod';
+import { create, all } from 'mathjs';
+import { Emitter } from '../emitter/emitter.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class CalculatorTool extends Tool {
+  static {
+    __name(this, "CalculatorTool");
+  }
+  name = "Calculator";
+  description = `A calculator tool that performs basic arithmetic operations like addition, subtraction, multiplication, and division. 
+Only use the calculator tool if you need to perform a calculation.`;
+  emitter = Emitter.root.child({
+    namespace: [
+      "tool",
+      "calculator"
+    ],
+    creator: this
+  });
+  inputSchema() {
+    return z.object({
+      expression: z.string().min(1).describe(`The mathematical expression to evaluate (e.g., "2 + 3 * 4"). Use Mathjs basic expression syntax. Constants only.`)
+    });
+  }
+  limitedEvaluate;
+  constructor({ config, imports, ...options } = {}) {
+    super(options);
+    const math = create(all, config);
+    this.limitedEvaluate = math.evaluate;
+    math.import({
+      // most important (hardly any functional impact)
+      import: /* @__PURE__ */ __name(function() {
+        throw new Error("Function import is disabled");
+      }, "import"),
+      createUnit: /* @__PURE__ */ __name(function() {
+        throw new Error("Function createUnit is disabled");
+      }, "createUnit"),
+      reviver: /* @__PURE__ */ __name(function() {
+        throw new Error("Function reviver is disabled");
+      }, "reviver"),
+      // extra (has functional impact)
+      evaluate: /* @__PURE__ */ __name(function() {
+        throw new Error("Function evaluate is disabled");
+      }, "evaluate"),
+      parse: /* @__PURE__ */ __name(function() {
+        throw new Error("Function parse is disabled");
+      }, "parse"),
+      simplify: /* @__PURE__ */ __name(function() {
+        throw new Error("Function simplify is disabled");
+      }, "simplify"),
+      derivative: /* @__PURE__ */ __name(function() {
+        throw new Error("Function derivative is disabled");
+      }, "derivative"),
+      resolve: /* @__PURE__ */ __name(function() {
+        throw new Error("Function resolve is disabled");
+      }, "resolve")
+    }, {
+      override: true,
+      ...imports?.options
+    });
+  }
+  async _run({ expression }) {
+    const result = this.limitedEvaluate(expression);
+    return new StringToolOutput(result);
+  }
+}
+
+export { CalculatorTool };
+//# sourceMappingURL=calculator.js.map
+//# sourceMappingURL=calculator.js.map

package/dist/tools/calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tools/calculator.ts"],"names":["CalculatorTool","Tool","name","description","emitter","Emitter","root","child","namespace","creator","inputSchema","z","object","expression","string","min","describe","limitedEvaluate","constructor","config","imports","options","math","create","all","evaluate","import","Error","createUnit","reviver","parse","simplify","derivative","resolve","override","_run","result","StringToolOutput"],"mappings":";;;;;;;AAoCO,MAAMA,uBAAuBC,IAAAA,CAAAA;EApCpC;;;EAqCEC,IAAO,GAAA,YAAA;EACPC,WAAc,GAAA,CAAA;;EAGEC,OAA0DC,GAAAA,OAAAA,CAAQC,KAAKC,KAAM,CAAA;IAC3FC,SAAW,EAAA;AAAC,MAAA,MAAA;AAAQ,MAAA;;IACpBC,OAAS,EAAA;GACX,CAAA;EAEAC,WAAc,GAAA;AACZ,IAAA,OAAOC,EAAEC,MAAO,CAAA;AACdC,MAAAA,UAAAA,EAAYF,EACTG,MAAM,EAAA,CACNC,IAAI,CAAA,CAAA,CACJC,SACC,CAAkH,gHAAA,CAAA;KAExH,CAAA;AACF;AAEUC,EAAAA,eAAAA;AAEVC,EAAAA,WAAAA,CAAY,EAAEC,MAAQC,EAAAA,OAAAA,EAAS,GAAGC,OAAAA,EAAAA,GAAiC,EAAI,EAAA;AACrE,IAAA,KAAA,CAAMA,OAAAA,CAAAA;AACN,IAAMC,MAAAA,IAAAA,GAAOC,MAAOC,CAAAA,GAAAA,EAAKL,MAAAA,CAAAA;AACzB,IAAA,IAAA,CAAKF,kBAAkBK,IAAKG,CAAAA,QAAAA;AAE5BH,IAAAA,IAAAA,CAAKI,MACH,CAAA;;AAEEA,MAAAA,MAAAA,kBAAQ,MAAA,CAAA,WAAA;AACN,QAAM,MAAA,IAAIC,MAAM,6BAAA,CAAA;OADV,EAAA,QAAA,CAAA;AAGRC,MAAAA,UAAAA,kBAAY,MAAA,CAAA,WAAA;AACV,QAAM,MAAA,IAAID,MAAM,iCAAA,CAAA;OADN,EAAA,YAAA,CAAA;AAGZE,MAAAA,OAAAA,kBAAS,MAAA,CAAA,WAAA;AACP,QAAM,MAAA,IAAIF,MAAM,8BAAA,CAAA;OADT,EAAA,SAAA,CAAA;;AAKTF,MAAAA,QAAAA,kBAAU,MAAA,CAAA,WAAA;AACR,QAAM,MAAA,IAAIE,MAAM,+BAAA,CAAA;OADR,EAAA,UAAA,CAAA;AAGVG,MAAAA,KAAAA,kBAAO,MAAA,CAAA,WAAA;AACL,QAAM,MAAA,IAAIH,MAAM,4BAAA,CAAA;OADX,EAAA,OAAA,CAAA;AAGPI,MAAAA,QAAAA,kBAAU,MAAA,CAAA,WAAA;AACR,QAAM,MAAA,IAAIJ,MAAM,+BAAA,CAAA;OADR,EAAA,UAAA,CAAA;AAGVK,MAAAA,UAAAA,kBAAY,MAAA,CAAA,WAAA;AACV,QAAM,MAAA,IAAIL,MAAM,iCAAA,CAAA;OADN,EAAA,YAAA,CAAA;AAGZM,MAAAA,OAAAA,kBAAS,MAAA,CAAA,WAAA;AACP,QAAM,MAAA,IAAIN,MAAM,8BAAA,CAAA;OADT,EAAA,SAAA;KAIX,EAAA;MAAEO,QAAU,EAAA,IAAA;AAAM,MAAA,GAAGd,OAASC,EAAAA;KAAQ,CAAA;AAE1C;EAEA,MAAgBc,IAAAA,CAAK,EAAEtB,UAAAA,EAA+B,EAAA;AACpD,IAAMuB,MAAAA,MAAAA,GAAS,IAAKnB,CAAAA,eAAAA,CAAgBJ,UAAAA,CAAAA;AACpC,IAAO,OAAA,IAAIwB,iBAAiBD,MAAAA,CAAAA;AAC9B;AACF","file":"calculator.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 { ToolEmitter, StringToolOutput, Tool, ToolInput } from \"@/tools/base.js\";\nimport { z } from \"zod\";\nimport { create, all, evaluate, ImportOptions, ImportObject, ConfigOptions } from \"mathjs\";\nimport { Emitter } from \"@/emitter/emitter.js\";\n\nexport interface CalculatorToolInput {\n  config?: ConfigOptions;\n  imports?: {\n    entries: ImportObject | ImportObject[];\n    options?: ImportOptions;\n  };\n}\n\n/**\n * Waring: The CalculatorTool enbales the agent (and by proxy the user) to execute arbirtary\n * expressions via mathjs.\n *\n * Please consider the security and stability risks documented at\n * https://mathjs.org/docs/expressions/security.html before using this tool.\n */\nexport class CalculatorTool extends Tool<StringToolOutput> {\n  name = \"Calculator\";\n  description = `A calculator tool that performs basic arithmetic operations like addition, subtraction, multiplication, and division. \nOnly use the calculator tool if you need to perform a calculation.`;\n\n  public readonly emitter: ToolEmitter<ToolInput<this>, StringToolOutput> = Emitter.root.child({\n    namespace: [\"tool\", \"calculator\"],\n    creator: this,\n  });\n\n  inputSchema() {\n    return z.object({\n      expression: z\n        .string()\n        .min(1)\n        .describe(\n          `The mathematical expression to evaluate (e.g., \"2 + 3 * 4\"). Use Mathjs basic expression syntax. Constants only.`,\n        ),\n    });\n  }\n\n  protected limitedEvaluate: typeof evaluate;\n\n  constructor({ config, imports, ...options }: CalculatorToolInput = {}) {\n    super(options);\n    const math = create(all, config);\n    this.limitedEvaluate = math.evaluate;\n    // Disable use of potentially vulnerable functions\n    math.import(\n      {\n        // most important (hardly any functional impact)\n        import: function () {\n          throw new Error(\"Function import is disabled\");\n        },\n        createUnit: function () {\n          throw new Error(\"Function createUnit is disabled\");\n        },\n        reviver: function () {\n          throw new Error(\"Function reviver is disabled\");\n        },\n\n        // extra (has functional impact)\n        evaluate: function () {\n          throw new Error(\"Function evaluate is disabled\");\n        },\n        parse: function () {\n          throw new Error(\"Function parse is disabled\");\n        },\n        simplify: function () {\n          throw new Error(\"Function simplify is disabled\");\n        },\n        derivative: function () {\n          throw new Error(\"Function derivative is disabled\");\n        },\n        resolve: function () {\n          throw new Error(\"Function resolve is disabled\");\n        },\n      },\n      { override: true, ...imports?.options },\n    );\n  }\n\n  protected async _run({ expression }: ToolInput<this>) {\n    const result = this.limitedEvaluate(expression);\n    return new StringToolOutput(result);\n  }\n}\n"]}

package/dist/tools/custom.cjs

@@ -0,0 +1,122 @@
+'use strict';
+
+var base_cjs = require('./base.cjs');
+var errors_cjs = require('../errors.cjs');
+var zod = require('zod');
+var general_cjs = require('../internals/helpers/general.cjs');
+var python_cjs = require('./python/python.cjs');
+var emitter_cjs = require('../emitter/emitter.cjs');
+var remeda = require('remeda');
+var object_cjs = require('../internals/helpers/object.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class CustomToolCreateError extends errors_cjs.FrameworkError {
+  static {
+    __name(this, "CustomToolCreateError");
+  }
+}
+class CustomToolExecuteError extends errors_cjs.FrameworkError {
+  static {
+    __name(this, "CustomToolExecuteError");
+  }
+}
+const toolOptionsSchema = zod.z.object({
+  codeInterpreter: zod.z.object({
+    url: zod.z.string().url(),
+    connectionOptions: zod.z.any().optional()
+  }),
+  sourceCode: zod.z.string().min(1),
+  name: zod.z.string().min(1),
+  description: zod.z.string().min(1),
+  inputSchema: zod.z.any()
+}).passthrough();
+class CustomTool extends base_cjs.Tool {
+  static {
+    __name(this, "CustomTool");
+  }
+  name;
+  description;
+  emitter = emitter_cjs.Emitter.root.child({
+    namespace: [
+      "tool",
+      "custom"
+    ],
+    creator: this
+  });
+  inputSchema() {
+    return this.options.inputSchema;
+  }
+  static {
+    this.register();
+  }
+  constructor(options) {
+    general_cjs.validate(options, toolOptionsSchema);
+    super(options);
+    this.name = options.name;
+    this.description = options.description;
+  }
+  async _run(input, options, run) {
+    try {
+      const result = await python_cjs.callCodeInterpreter({
+        url: `${this.options.codeInterpreter.url}/v1/execute-custom-tool`,
+        body: {
+          tool_source_code: this.options.sourceCode,
+          tool_input_json: JSON.stringify(input),
+          env: remeda.merge(object_cjs.omitUndefined(this.options.env ?? {}), object_cjs.omitUndefined(options.env ?? {}))
+        },
+        signal: run.signal
+      });
+      if (result.stderr) {
+        throw new CustomToolExecuteError(result.stderr);
+      }
+      return new base_cjs.StringToolOutput(result.tool_output_json);
+    } catch (e) {
+      if (e instanceof base_cjs.ToolError) {
+        throw new CustomToolExecuteError(e.message, [
+          e
+        ]);
+      } else {
+        throw e;
+      }
+    }
+  }
+  loadSnapshot(snapshot) {
+    super.loadSnapshot(snapshot);
+  }
+  static async fromSourceCode({ env, ...codeInterpreter }, sourceCode) {
+    try {
+      const result = await python_cjs.callCodeInterpreter({
+        url: `${codeInterpreter.url}/v1/parse-custom-tool`,
+        body: {
+          tool_source_code: sourceCode
+        }
+      });
+      if (result.error_messages) {
+        throw new CustomToolCreateError(result.error_messages.join("\n"));
+      }
+      return new CustomTool({
+        codeInterpreter,
+        sourceCode,
+        name: result.tool_name,
+        description: result.tool_description,
+        inputSchema: JSON.parse(result.tool_input_schema_json),
+        env
+      });
+    } catch (e) {
+      if (e instanceof base_cjs.ToolError) {
+        throw new CustomToolCreateError(e.message, [
+          e
+        ]);
+      } else {
+        throw e;
+      }
+    }
+  }
+}
+
+exports.CustomTool = CustomTool;
+exports.CustomToolCreateError = CustomToolCreateError;
+exports.CustomToolExecuteError = CustomToolExecuteError;
+//# sourceMappingURL=custom.cjs.map
+//# sourceMappingURL=custom.cjs.map

package/dist/tools/custom.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tools/custom.ts"],"names":["CustomToolCreateError","FrameworkError","CustomToolExecuteError","toolOptionsSchema","z","object","codeInterpreter","url","string","connectionOptions","any","optional","sourceCode","min","name","description","inputSchema","passthrough","CustomTool","Tool","emitter","Emitter","root","child","namespace","creator","options","register","validate","_run","input","run","result","callCodeInterpreter","body","tool_source_code","tool_input_json","JSON","stringify","env","merge","omitUndefined","signal","stderr","StringToolOutput","tool_output_json","e","ToolError","message","loadSnapshot","snapshot","fromSourceCode","error_messages","join","tool_name","tool_description","parse","tool_input_schema_json"],"mappings":"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","file":"custom.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  StringToolOutput,\n  Tool,\n  ToolInput,\n} from \"@/tools/base.js\";\nimport { FrameworkError } from \"@/errors.js\";\nimport { z } from \"zod\";\nimport { validate } from \"@/internals/helpers/general.js\";\nimport { callCodeInterpreter, CodeInterpreterOptions } from \"./python/python.js\";\nimport { RunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { ToolError } from \"@/tools/base.js\";\nimport { merge } from \"remeda\";\nimport { omitUndefined } from \"@/internals/helpers/object.js\";\n\nexport class CustomToolCreateError extends FrameworkError {}\nexport class CustomToolExecuteError extends FrameworkError {}\n\nconst toolOptionsSchema = z\n  .object({\n    codeInterpreter: z.object({\n      url: z.string().url(),\n      connectionOptions: z.any().optional(),\n    }),\n    sourceCode: z.string().min(1),\n    name: z.string().min(1),\n    description: z.string().min(1),\n    inputSchema: z.any(),\n  })\n  .passthrough();\n\ntype CustomToolEnv = Record<string, string | boolean | null | undefined | number>;\n\nexport type CustomToolOptions = z.output<typeof toolOptionsSchema> &\n  BaseToolOptions & { env?: CustomToolEnv };\n\nexport type CustomToolRunOptions = Pick<CustomToolOptions, \"env\"> & BaseToolRunOptions;\n\nexport class CustomTool extends Tool<StringToolOutput, CustomToolOptions, CustomToolRunOptions> {\n  name: string;\n  description: string;\n\n  public readonly emitter: ToolEmitter<ToolInput<this>, StringToolOutput> = Emitter.root.child({\n    namespace: [\"tool\", \"custom\"],\n    creator: this,\n  });\n\n  public inputSchema() {\n    return this.options.inputSchema;\n  }\n\n  static {\n    this.register();\n  }\n\n  public constructor(options: CustomToolOptions) {\n    validate(options, toolOptionsSchema);\n    super(options);\n    this.name = options.name;\n    this.description = options.description;\n  }\n\n  protected async _run(\n    input: any,\n    options: Partial<CustomToolRunOptions>,\n    run: RunContext<typeof this>,\n  ) {\n    try {\n      const result = await callCodeInterpreter({\n        url: `${this.options.codeInterpreter.url}/v1/execute-custom-tool`,\n        body: {\n          tool_source_code: this.options.sourceCode,\n          tool_input_json: JSON.stringify(input),\n          env: merge(omitUndefined(this.options.env ?? {}), omitUndefined(options.env ?? {})),\n        },\n        signal: run.signal,\n      });\n\n      if (result.stderr) {\n        throw new CustomToolExecuteError(result.stderr);\n      }\n\n      return new StringToolOutput(result.tool_output_json);\n    } catch (e) {\n      if (e instanceof ToolError) {\n        throw new CustomToolExecuteError(e.message, [e]);\n      } else {\n        throw e;\n      }\n    }\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void {\n    super.loadSnapshot(snapshot);\n  }\n\n  static async fromSourceCode(\n    { env, ...codeInterpreter }: CodeInterpreterOptions & Pick<CustomToolOptions, \"env\">,\n    sourceCode: string,\n  ) {\n    try {\n      const result = await callCodeInterpreter({\n        url: `${codeInterpreter.url}/v1/parse-custom-tool`,\n        body: {\n          tool_source_code: sourceCode,\n        },\n      });\n\n      if (result.error_messages) {\n        throw new CustomToolCreateError(result.error_messages.join(\"\\n\"));\n      }\n\n      return new CustomTool({\n        codeInterpreter,\n        sourceCode,\n        name: result.tool_name,\n        description: result.tool_description,\n        inputSchema: JSON.parse(result.tool_input_schema_json),\n        env,\n      });\n    } catch (e) {\n      if (e instanceof ToolError) {\n        throw new CustomToolCreateError(e.message, [e]);\n      } else {\n        throw e;\n      }\n    }\n  }\n}\n"]}

package/dist/tools/custom.d.cts

@@ -0,0 +1,110 @@
+import { BaseToolOptions, BaseToolRunOptions, Tool, StringToolOutput, ToolEmitter, ToolInput } from './base.cjs';
+import { FrameworkError } from '../errors.cjs';
+import { z } from 'zod';
+import { CodeInterpreterOptions } from './python/python.cjs';
+import { RunContext } from '../context.cjs';
+import 'ajv';
+import '../internals/serializable.cjs';
+import '../internals/types.cjs';
+import '../internals/helpers/guards.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';
+import '../template.cjs';
+import './python/storage.cjs';
+import 'fs';
+import './python/output.cjs';
+import 'node:tls';
+import '../backend/chat.cjs';
+import '../backend/message.cjs';
+import 'ai';
+import '../backend/utils.cjs';
+import '../backend/constants.cjs';
+import '@ai-sdk/provider';
+
+/**
+ * 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.
+ */
+
+declare class CustomToolCreateError extends FrameworkError {
+}
+declare class CustomToolExecuteError extends FrameworkError {
+}
+declare const toolOptionsSchema: z.ZodObject<{
+    codeInterpreter: z.ZodObject<{
+        url: z.ZodString;
+        connectionOptions: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        connectionOptions?: any;
+    }, {
+        url: string;
+        connectionOptions?: any;
+    }>;
+    sourceCode: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodAny;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    codeInterpreter: z.ZodObject<{
+        url: z.ZodString;
+        connectionOptions: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        connectionOptions?: any;
+    }, {
+        url: string;
+        connectionOptions?: any;
+    }>;
+    sourceCode: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodAny;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    codeInterpreter: z.ZodObject<{
+        url: z.ZodString;
+        connectionOptions: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        connectionOptions?: any;
+    }, {
+        url: string;
+        connectionOptions?: any;
+    }>;
+    sourceCode: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodAny;
+}, z.ZodTypeAny, "passthrough">>;
+type CustomToolEnv = Record<string, string | boolean | null | undefined | number>;
+type CustomToolOptions = z.output<typeof toolOptionsSchema> & BaseToolOptions & {
+    env?: CustomToolEnv;
+};
+type CustomToolRunOptions = Pick<CustomToolOptions, "env"> & BaseToolRunOptions;
+declare class CustomTool extends Tool<StringToolOutput, CustomToolOptions, CustomToolRunOptions> {
+    name: string;
+    description: string;
+    readonly emitter: ToolEmitter<ToolInput<this>, StringToolOutput>;
+    inputSchema(): any;
+    constructor(options: CustomToolOptions);
+    protected _run(input: any, options: Partial<CustomToolRunOptions>, run: RunContext<typeof this>): Promise<StringToolOutput>;
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+    static fromSourceCode({ env, ...codeInterpreter }: CodeInterpreterOptions & Pick<CustomToolOptions, "env">, sourceCode: string): Promise<CustomTool>;
+}
+
+export { CustomTool, CustomToolCreateError, CustomToolExecuteError, type CustomToolOptions, type CustomToolRunOptions };

package/dist/tools/custom.d.ts

@@ -0,0 +1,110 @@
+import { BaseToolOptions, BaseToolRunOptions, Tool, StringToolOutput, ToolEmitter, ToolInput } from './base.js';
+import { FrameworkError } from '../errors.js';
+import { z } from 'zod';
+import { CodeInterpreterOptions } from './python/python.js';
+import { RunContext } from '../context.js';
+import 'ajv';
+import '../internals/serializable.js';
+import '../internals/types.js';
+import '../internals/helpers/guards.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';
+import '../template.js';
+import './python/storage.js';
+import 'fs';
+import './python/output.js';
+import 'node:tls';
+import '../backend/chat.js';
+import '../backend/message.js';
+import 'ai';
+import '../backend/utils.js';
+import '../backend/constants.js';
+import '@ai-sdk/provider';
+
+/**
+ * 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.
+ */
+
+declare class CustomToolCreateError extends FrameworkError {
+}
+declare class CustomToolExecuteError extends FrameworkError {
+}
+declare const toolOptionsSchema: z.ZodObject<{
+    codeInterpreter: z.ZodObject<{
+        url: z.ZodString;
+        connectionOptions: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        connectionOptions?: any;
+    }, {
+        url: string;
+        connectionOptions?: any;
+    }>;
+    sourceCode: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodAny;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    codeInterpreter: z.ZodObject<{
+        url: z.ZodString;
+        connectionOptions: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        connectionOptions?: any;
+    }, {
+        url: string;
+        connectionOptions?: any;
+    }>;
+    sourceCode: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodAny;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    codeInterpreter: z.ZodObject<{
+        url: z.ZodString;
+        connectionOptions: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        connectionOptions?: any;
+    }, {
+        url: string;
+        connectionOptions?: any;
+    }>;
+    sourceCode: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodAny;
+}, z.ZodTypeAny, "passthrough">>;
+type CustomToolEnv = Record<string, string | boolean | null | undefined | number>;
+type CustomToolOptions = z.output<typeof toolOptionsSchema> & BaseToolOptions & {
+    env?: CustomToolEnv;
+};
+type CustomToolRunOptions = Pick<CustomToolOptions, "env"> & BaseToolRunOptions;
+declare class CustomTool extends Tool<StringToolOutput, CustomToolOptions, CustomToolRunOptions> {
+    name: string;
+    description: string;
+    readonly emitter: ToolEmitter<ToolInput<this>, StringToolOutput>;
+    inputSchema(): any;
+    constructor(options: CustomToolOptions);
+    protected _run(input: any, options: Partial<CustomToolRunOptions>, run: RunContext<typeof this>): Promise<StringToolOutput>;
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+    static fromSourceCode({ env, ...codeInterpreter }: CodeInterpreterOptions & Pick<CustomToolOptions, "env">, sourceCode: string): Promise<CustomTool>;
+}
+
+export { CustomTool, CustomToolCreateError, CustomToolExecuteError, type CustomToolOptions, type CustomToolRunOptions };