modelfusion 0.9.0 → 0.10.0

package/README.md

@@ -199,7 +199,7 @@ A tool is a function with a name, a description, and a schema for the input para
 
 ```ts
 const calculator = new Tool({
-  name: "calculator" as const, // mark 'as const' for type inference
+  name: "calculator",
   description: "Execute a calculation",
 
   inputSchema: z.object({

package/composed-function/summarize/summarizeRecursivelyWithTextGenerationAndTokenSplitting.cjs

@@ -17,10 +17,7 @@ async function summarizeRecursivelyWithTextGenerationAndTokenSplitting({ text, m
             tokenizer: model.tokenizer,
             maxTokensPerChunk: tokenLimit - emptyPromptTokens,
         }),
-        summarize: async (input) => {
-            const text = await (0, generateText_js_1.generateText)(model, await prompt(input), options);
-            return text;
-        },
+        summarize: async (input) => (0, generateText_js_1.generateText)(model, await prompt(input), options),
         join,
         text,
     }, options);

package/composed-function/summarize/summarizeRecursivelyWithTextGenerationAndTokenSplitting.js

@@ -14,10 +14,7 @@ export async function summarizeRecursivelyWithTextGenerationAndTokenSplitting({
             tokenizer: model.tokenizer,
             maxTokensPerChunk: tokenLimit - emptyPromptTokens,
         }),
-        summarize: async (input) => {
-            const text = await generateText(model, await prompt(input), options);
-            return text;
-        },
+        summarize: async (input) => generateText(model, await prompt(input), options),
         join,
         text,
     }, options);

package/model-provider/openai/chat/OpenAIChatMessage.cjs

@@ -21,4 +21,27 @@ exports.OpenAIChatMessage = {
     functionResult(name, content) {
         return { role: "function", name, content };
     },
+    /**
+     * Creates a function call chat message for tool calls.
+     */
+    toolCall({ text, tool, parameters, }) {
+        return {
+            role: "assistant",
+            content: text,
+            function_call: {
+                name: tool,
+                arguments: JSON.stringify(parameters),
+            },
+        };
+    },
+    /**
+     * Creates a function result chat message for tool call results.
+     */
+    toolResult({ tool, result }) {
+        return {
+            role: "function",
+            name: tool,
+            content: JSON.stringify(result),
+        };
+    },
 };

package/model-provider/openai/chat/OpenAIChatMessage.d.ts

@@ -23,4 +23,30 @@ export declare const OpenAIChatMessage: {
         arguments: string;
     }): OpenAIChatMessage;
     functionResult(name: string, content: string): OpenAIChatMessage;
+    /**
+     * Creates a function call chat message for tool calls.
+     */
+    toolCall({ text, tool, parameters, }: {
+        text: string | null;
+        tool: string;
+        parameters: unknown;
+    }): {
+        role: "assistant";
+        content: string | null;
+        function_call: {
+            name: string;
+            arguments: string;
+        };
+    };
+    /**
+     * Creates a function result chat message for tool call results.
+     */
+    toolResult({ tool, result }: {
+        tool: string;
+        result: unknown;
+    }): {
+        role: "function";
+        name: string;
+        content: string;
+    };
 };

package/model-provider/openai/chat/OpenAIChatMessage.js

@@ -18,4 +18,27 @@ export const OpenAIChatMessage = {
     functionResult(name, content) {
         return { role: "function", name, content };
     },
+    /**
+     * Creates a function call chat message for tool calls.
+     */
+    toolCall({ text, tool, parameters, }) {
+        return {
+            role: "assistant",
+            content: text,
+            function_call: {
+                name: tool,
+                arguments: JSON.stringify(parameters),
+            },
+        };
+    },
+    /**
+     * Creates a function result chat message for tool call results.
+     */
+    toolResult({ tool, result }) {
+        return {
+            role: "function",
+            name: tool,
+            content: JSON.stringify(result),
+        };
+    },
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "modelfusion",
   "description": "Build AI applications, chatbots, and agents with JavaScript and TypeScript.",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "author": "Lars Grammel",
   "license": "MIT",
   "keywords": [

package/tool/InvalidToolNameError.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidToolNameError = void 0;
+class InvalidToolNameError extends Error {
+    constructor({ toolName, namePattern, }) {
+        super(`Invalid tool name '${toolName}'. The tool name must match the regular expression pattern ${namePattern}.`);
+        Object.defineProperty(this, "toolName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = "InvalidToolNameError";
+        this.toolName = toolName;
+    }
+}
+exports.InvalidToolNameError = InvalidToolNameError;

package/tool/InvalidToolNameError.d.ts

@@ -0,0 +1,7 @@
+export declare class InvalidToolNameError extends Error {
+    readonly toolName: string;
+    constructor({ toolName, namePattern, }: {
+        toolName: string;
+        namePattern: RegExp;
+    });
+}

package/tool/InvalidToolNameError.js

@@ -0,0 +1,13 @@
+export class InvalidToolNameError extends Error {
+    constructor({ toolName, namePattern, }) {
+        super(`Invalid tool name '${toolName}'. The tool name must match the regular expression pattern ${namePattern}.`);
+        Object.defineProperty(this, "toolName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = "InvalidToolNameError";
+        this.toolName = toolName;
+    }
+}

package/tool/Tool.cjs

@@ -1,14 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Tool = void 0;
+const InvalidToolNameError_js_1 = require("./InvalidToolNameError.cjs");
+const namePattern = /^[a-zA-Z0-9_-]{1,64}$/;
 /**
  * A tool is a function with a name, description and defined inputs that can be used
  * by agents and chatbots.
  */
 class Tool {
-    constructor(options) {
+    constructor({ name, description, inputSchema, outputSchema, execute, }) {
         /**
-         * The name of the tool. Should be understandable for language models and unique among the tools that they know.
+         * The name of the tool.
+         * It has to be a function name that matches the regular expression pattern '^[a-zA-Z0-9_-]{1,64}$'.
+         * Should be understandable for language models and unique among the tools that they know.
          */
         Object.defineProperty(this, "name", {
             enumerable: true,
@@ -53,11 +57,18 @@ class Tool {
             writable: true,
             value: void 0
         });
-        this.name = options.name;
-        this.description = options.description;
-        this.inputSchema = options.inputSchema;
-        this.outputSchema = options.outputSchema;
-        this.execute = options.execute;
+        // check that the name is a valid function name:
+        if (!namePattern.test(name)) {
+            throw new InvalidToolNameError_js_1.InvalidToolNameError({
+                toolName: name,
+                namePattern,
+            });
+        }
+        this.name = name;
+        this.description = description;
+        this.inputSchema = inputSchema;
+        this.outputSchema = outputSchema;
+        this.execute = execute;
     }
     /**
      * Provdes a schema definition with the name, description and schema of the input.

package/tool/Tool.d.ts

@@ -7,7 +7,9 @@ import { RunFunction } from "../run/RunFunction.js";
  */
 export declare class Tool<NAME extends string, INPUT, OUTPUT> {
     /**
-     * The name of the tool. Should be understandable for language models and unique among the tools that they know.
+     * The name of the tool.
+     * It has to be a function name that matches the regular expression pattern '^[a-zA-Z0-9_-]{1,64}$'.
+     * Should be understandable for language models and unique among the tools that they know.
      */
     readonly name: NAME;
     /**
@@ -27,7 +29,7 @@ export declare class Tool<NAME extends string, INPUT, OUTPUT> {
      * The actual execution function of the tool.
      */
     readonly execute: RunFunction<INPUT, OUTPUT>;
-    constructor(options: {
+    constructor({ name, description, inputSchema, outputSchema, execute, }: {
         name: NAME;
         description: string;
         inputSchema: z.ZodSchema<INPUT>;

package/tool/Tool.js

@@ -1,11 +1,15 @@
+import { InvalidToolNameError } from "./InvalidToolNameError.js";
+const namePattern = /^[a-zA-Z0-9_-]{1,64}$/;
 /**
  * A tool is a function with a name, description and defined inputs that can be used
  * by agents and chatbots.
  */
 export class Tool {
-    constructor(options) {
+    constructor({ name, description, inputSchema, outputSchema, execute, }) {
         /**
-         * The name of the tool. Should be understandable for language models and unique among the tools that they know.
+         * The name of the tool.
+         * It has to be a function name that matches the regular expression pattern '^[a-zA-Z0-9_-]{1,64}$'.
+         * Should be understandable for language models and unique among the tools that they know.
          */
         Object.defineProperty(this, "name", {
             enumerable: true,
@@ -50,11 +54,18 @@ export class Tool {
             writable: true,
             value: void 0
         });
-        this.name = options.name;
-        this.description = options.description;
-        this.inputSchema = options.inputSchema;
-        this.outputSchema = options.outputSchema;
-        this.execute = options.execute;
+        // check that the name is a valid function name:
+        if (!namePattern.test(name)) {
+            throw new InvalidToolNameError({
+                toolName: name,
+                namePattern,
+            });
+        }
+        this.name = name;
+        this.description = description;
+        this.inputSchema = inputSchema;
+        this.outputSchema = outputSchema;
+        this.execute = execute;
     }
     /**
      * Provdes a schema definition with the name, description and schema of the input.

package/tool/index.cjs

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./InvalidToolNameError.cjs"), exports);
 __exportStar(require("./NoSuchToolError.cjs"), exports);
 __exportStar(require("./Tool.cjs"), exports);
 __exportStar(require("./ToolExecutionError.cjs"), exports);

package/tool/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./InvalidToolNameError.js";
 export * from "./NoSuchToolError.js";
 export * from "./Tool.js";
 export * from "./ToolExecutionError.js";

package/tool/index.js

@@ -1,3 +1,4 @@
+export * from "./InvalidToolNameError.js";
 export * from "./NoSuchToolError.js";
 export * from "./Tool.js";
 export * from "./ToolExecutionError.js";