beeai-framework 0.1.2

package/dist/backend/message.cjs

@@ -0,0 +1,201 @@
+'use strict';
+
+var serializable_cjs = require('../internals/serializable.cjs');
+var utils_cjs = require('../serializer/utils.cjs');
+var zod = require('zod');
+var errors_cjs = require('../errors.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function isText(content) {
+  return content.type === "text";
+}
+__name(isText, "isText");
+function isImage(content) {
+  return content.type === "image";
+}
+__name(isImage, "isImage");
+function isFile(content) {
+  return content.type === "file";
+}
+__name(isFile, "isFile");
+function isToolCall(content) {
+  return content.type === "tool-call";
+}
+__name(isToolCall, "isToolCall");
+function isToolResult(content) {
+  return content.type === "tool-result";
+}
+__name(isToolResult, "isToolResult");
+class Message extends serializable_cjs.Serializable {
+  static {
+    __name(this, "Message");
+  }
+  meta;
+  content;
+  constructor(content, meta = {}) {
+    super(), this.meta = meta;
+    if (!meta?.createdAt) {
+      meta.createdAt = /* @__PURE__ */ new Date();
+    }
+    if (typeof content === "string") {
+      this.content = [
+        this.fromString(content)
+      ];
+    } else {
+      this.content = Array.isArray(content) ? content : [
+        content
+      ];
+    }
+  }
+  static of({ role, text, meta }) {
+    if (role === "user") {
+      return new UserMessage(text, meta);
+    } else if (role === "assistant") {
+      return new AssistantMessage(text, meta);
+    } else if (role === "system") {
+      return new SystemMessage(text, meta);
+    } else if (role === "tool") {
+      return new ToolMessage(text, meta);
+    } else {
+      return new CustomMessage(role, text, meta);
+    }
+  }
+  get text() {
+    return this.getTexts().map((c) => c.text).join("");
+  }
+  getTexts() {
+    return this.content.filter(isText);
+  }
+  createSnapshot() {
+    return {
+      content: utils_cjs.shallowCopy(this.content),
+      meta: utils_cjs.shallowCopy(this.meta),
+      role: this.role
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+  toPlain() {
+    return {
+      role: this.role,
+      content: utils_cjs.shallowCopy(this.content)
+    };
+  }
+  [Symbol.iterator]() {
+    return this.content[Symbol.iterator]();
+  }
+}
+class AssistantMessage extends Message {
+  static {
+    __name(this, "AssistantMessage");
+  }
+  role = "assistant";
+  static {
+    this.register();
+  }
+  getToolCalls() {
+    return this.content.filter(isToolCall);
+  }
+  fromString(text) {
+    return {
+      type: "text",
+      text
+    };
+  }
+}
+class ToolMessage extends Message {
+  static {
+    __name(this, "ToolMessage");
+  }
+  role = "tool";
+  static {
+    this.register();
+  }
+  getToolResults() {
+    return this.content.filter(isToolResult);
+  }
+  fromString(text) {
+    const { success, data } = zod.z.object({
+      type: zod.z.literal("tool-result"),
+      result: zod.z.any(),
+      toolName: zod.z.string(),
+      toolCallId: zod.z.string()
+    }).safeParse(text);
+    if (!success) {
+      throw new errors_cjs.ValueError(`ToolMessage cannot be created from '${text}'!`);
+    }
+    return data;
+  }
+}
+class SystemMessage extends Message {
+  static {
+    __name(this, "SystemMessage");
+  }
+  role = "system";
+  static {
+    this.register();
+  }
+  fromString(text) {
+    return {
+      type: "text",
+      text
+    };
+  }
+}
+class UserMessage extends Message {
+  static {
+    __name(this, "UserMessage");
+  }
+  role = "user";
+  static {
+    this.register();
+  }
+  getImages() {
+    return this.content.filter(isImage);
+  }
+  getFiles() {
+    return this.content.filter(isFile);
+  }
+  fromString(text) {
+    return {
+      type: "text",
+      text
+    };
+  }
+}
+const Role = {
+  ASSISTANT: "assistant",
+  SYSTEM: "system",
+  USER: "user"
+};
+class CustomMessage extends Message {
+  static {
+    __name(this, "CustomMessage");
+  }
+  role;
+  constructor(role, content, meta = {}) {
+    super(content, meta);
+    if (!role) {
+      throw new errors_cjs.ValueError(`Role "${role}" must be specified!`);
+    }
+    this.role = role;
+  }
+  fromString(input) {
+    return {
+      type: "text",
+      text: input
+    };
+  }
+}
+
+exports.AssistantMessage = AssistantMessage;
+exports.CustomMessage = CustomMessage;
+exports.Message = Message;
+exports.Role = Role;
+exports.SystemMessage = SystemMessage;
+exports.ToolMessage = ToolMessage;
+exports.UserMessage = UserMessage;
+//# sourceMappingURL=message.cjs.map
+//# sourceMappingURL=message.cjs.map

package/dist/backend/message.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backend/message.ts"],"names":["isText","content","type","isImage","isFile","isToolCall","isToolResult","Message","Serializable","constructor","meta","createdAt","Date","fromString","Array","isArray","of","role","text","UserMessage","AssistantMessage","SystemMessage","ToolMessage","CustomMessage","getTexts","map","c","join","filter","createSnapshot","shallowCopy","loadSnapshot","snapshot","Object","assign","toPlain","Symbol","iterator","register","getToolCalls","getToolResults","success","data","z","object","literal","result","any","toolName","string","toolCallId","safeParse","ValueError","getImages","getFiles","Role","ASSISTANT","SYSTEM","USER","input"],"mappings":"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","file":"message.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 { Serializable } from \"@/internals/serializable.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { FilePart, ImagePart, TextPart, ToolCallPart, ToolResultPart } from \"ai\";\nimport { z } from \"zod\";\nimport { ValueError } from \"@/errors.js\";\n\nexport type MessageRole = \"user\" | \"system\" | \"tool\" | \"assistant\";\nexport type MessageContentPart = TextPart | ToolCallPart | ImagePart | FilePart | ToolResultPart;\n\nexport interface MessageMeta {\n  [key: string]: any;\n  createdAt?: Date;\n}\n\nexport interface MessageInput {\n  role: MessageRole;\n  text: string; // TODO\n  meta?: MessageMeta;\n}\n\nfunction isText(content: MessageContentPart): content is TextPart {\n  return content.type === \"text\";\n}\nfunction isImage(content: MessageContentPart): content is ImagePart {\n  return content.type === \"image\";\n}\nfunction isFile(content: MessageContentPart): content is FilePart {\n  return content.type === \"file\";\n}\nfunction isToolCall(content: MessageContentPart): content is ToolCallPart {\n  return content.type === \"tool-call\";\n}\nfunction isToolResult(content: MessageContentPart): content is ToolResultPart {\n  return content.type === \"tool-result\";\n}\n\nexport abstract class Message<\n  T extends MessageContentPart = MessageContentPart,\n  R extends string = MessageRole | string,\n> extends Serializable {\n  public abstract readonly role: R;\n  public readonly content: T[];\n\n  constructor(\n    content: T | T[] | string,\n    public readonly meta: MessageMeta = {},\n  ) {\n    super();\n    if (!meta?.createdAt) {\n      meta.createdAt = new Date();\n    }\n    if (typeof content === \"string\") {\n      this.content = [this.fromString(content)];\n    } else {\n      this.content = Array.isArray(content) ? content : [content];\n    }\n  }\n\n  protected abstract fromString(input: string): T;\n\n  static of({ role, text, meta }: MessageInput): Message {\n    if (role === \"user\") {\n      return new UserMessage(text, meta);\n    } else if (role === \"assistant\") {\n      return new AssistantMessage(text, meta);\n    } else if (role === \"system\") {\n      return new SystemMessage(text, meta);\n    } else if (role === \"tool\") {\n      return new ToolMessage(text, meta);\n    } else {\n      return new CustomMessage(role, text, meta);\n    }\n  }\n\n  get text() {\n    return this.getTexts()\n      .map((c) => c.text)\n      .join(\"\");\n  }\n\n  getTexts() {\n    return this.content.filter(isText) as TextPart[];\n  }\n\n  createSnapshot() {\n    return { content: shallowCopy(this.content), meta: shallowCopy(this.meta), role: this.role };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n\n  toPlain() {\n    return { role: this.role, content: shallowCopy(this.content) } as const;\n  }\n\n  [Symbol.iterator](): Iterator<T> {\n    return this.content[Symbol.iterator]();\n  }\n}\n\nexport class AssistantMessage extends Message<TextPart | ToolCallPart> {\n  public readonly role = \"assistant\";\n\n  static {\n    this.register();\n  }\n\n  getToolCalls() {\n    return this.content.filter(isToolCall);\n  }\n\n  protected fromString(text: string): TextPart {\n    return { type: \"text\", text };\n  }\n}\n\nexport class ToolMessage extends Message<ToolResultPart> {\n  public readonly role = \"tool\";\n\n  static {\n    this.register();\n  }\n\n  getToolResults() {\n    return this.content.filter(isToolResult);\n  }\n\n  protected fromString(text: string): ToolResultPart {\n    const { success, data } = z\n      .object({\n        type: z.literal(\"tool-result\"),\n        result: z.any(),\n        toolName: z.string(),\n        toolCallId: z.string(),\n      })\n      .safeParse(text);\n\n    if (!success) {\n      throw new ValueError(`ToolMessage cannot be created from '${text}'!`);\n    }\n\n    return data as ToolResultPart;\n  }\n}\n\nexport class SystemMessage extends Message<TextPart> {\n  public readonly role: MessageRole = \"system\";\n\n  static {\n    this.register();\n  }\n\n  protected fromString(text: string): TextPart {\n    return { type: \"text\", text };\n  }\n}\n\nexport class UserMessage extends Message<TextPart | ImagePart | FilePart> {\n  public readonly role = \"user\";\n\n  static {\n    this.register();\n  }\n\n  getImages() {\n    return this.content.filter(isImage);\n  }\n\n  getFiles() {\n    return this.content.filter(isFile);\n  }\n\n  protected fromString(text: string): TextPart {\n    return { type: \"text\", text };\n  }\n}\n\nexport const Role = {\n  ASSISTANT: \"assistant\",\n  SYSTEM: \"system\",\n  USER: \"user\",\n} as const;\n\nexport class CustomMessage extends Message<MessageContentPart, string> {\n  public role: string;\n\n  constructor(role: string, content: MessageContentPart | string, meta: MessageMeta = {}) {\n    super(content, meta);\n    if (!role) {\n      throw new ValueError(`Role \"${role}\" must be specified!`);\n    }\n    this.role = role;\n  }\n\n  protected fromString(input: string): MessageContentPart {\n    return { type: \"text\", text: input };\n  }\n}\n"]}

package/dist/backend/message.d.cts

@@ -0,0 +1,85 @@
+import { Serializable } from '../internals/serializable.cjs';
+import { TextPart, ToolCallPart, ImagePart, FilePart, ToolResultPart } from 'ai';
+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.
+ */
+
+type MessageRole = "user" | "system" | "tool" | "assistant";
+type MessageContentPart = TextPart | ToolCallPart | ImagePart | FilePart | ToolResultPart;
+interface MessageMeta {
+    [key: string]: any;
+    createdAt?: Date;
+}
+interface MessageInput {
+    role: MessageRole;
+    text: string;
+    meta?: MessageMeta;
+}
+declare abstract class Message<T extends MessageContentPart = MessageContentPart, R extends string = MessageRole | string> extends Serializable {
+    readonly meta: MessageMeta;
+    abstract readonly role: R;
+    readonly content: T[];
+    constructor(content: T | T[] | string, meta?: MessageMeta);
+    protected abstract fromString(input: string): T;
+    static of({ role, text, meta }: MessageInput): Message;
+    get text(): string;
+    getTexts(): TextPart[];
+    createSnapshot(): {
+        content: T[];
+        meta: MessageMeta;
+        role: R;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+    toPlain(): {
+        readonly role: R;
+        readonly content: T[];
+    };
+    [Symbol.iterator](): Iterator<T>;
+}
+declare class AssistantMessage extends Message<TextPart | ToolCallPart> {
+    readonly role = "assistant";
+    getToolCalls(): ToolCallPart[];
+    protected fromString(text: string): TextPart;
+}
+declare class ToolMessage extends Message<ToolResultPart> {
+    readonly role = "tool";
+    getToolResults(): ToolResultPart[];
+    protected fromString(text: string): ToolResultPart;
+}
+declare class SystemMessage extends Message<TextPart> {
+    readonly role: MessageRole;
+    protected fromString(text: string): TextPart;
+}
+declare class UserMessage extends Message<TextPart | ImagePart | FilePart> {
+    readonly role = "user";
+    getImages(): ImagePart[];
+    getFiles(): FilePart[];
+    protected fromString(text: string): TextPart;
+}
+declare const Role: {
+    readonly ASSISTANT: "assistant";
+    readonly SYSTEM: "system";
+    readonly USER: "user";
+};
+declare class CustomMessage extends Message<MessageContentPart, string> {
+    role: string;
+    constructor(role: string, content: MessageContentPart | string, meta?: MessageMeta);
+    protected fromString(input: string): MessageContentPart;
+}
+
+export { AssistantMessage, CustomMessage, Message, type MessageContentPart, type MessageInput, type MessageMeta, type MessageRole, Role, SystemMessage, ToolMessage, UserMessage };

package/dist/backend/message.d.ts

@@ -0,0 +1,85 @@
+import { Serializable } from '../internals/serializable.js';
+import { TextPart, ToolCallPart, ImagePart, FilePart, ToolResultPart } from 'ai';
+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.
+ */
+
+type MessageRole = "user" | "system" | "tool" | "assistant";
+type MessageContentPart = TextPart | ToolCallPart | ImagePart | FilePart | ToolResultPart;
+interface MessageMeta {
+    [key: string]: any;
+    createdAt?: Date;
+}
+interface MessageInput {
+    role: MessageRole;
+    text: string;
+    meta?: MessageMeta;
+}
+declare abstract class Message<T extends MessageContentPart = MessageContentPart, R extends string = MessageRole | string> extends Serializable {
+    readonly meta: MessageMeta;
+    abstract readonly role: R;
+    readonly content: T[];
+    constructor(content: T | T[] | string, meta?: MessageMeta);
+    protected abstract fromString(input: string): T;
+    static of({ role, text, meta }: MessageInput): Message;
+    get text(): string;
+    getTexts(): TextPart[];
+    createSnapshot(): {
+        content: T[];
+        meta: MessageMeta;
+        role: R;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+    toPlain(): {
+        readonly role: R;
+        readonly content: T[];
+    };
+    [Symbol.iterator](): Iterator<T>;
+}
+declare class AssistantMessage extends Message<TextPart | ToolCallPart> {
+    readonly role = "assistant";
+    getToolCalls(): ToolCallPart[];
+    protected fromString(text: string): TextPart;
+}
+declare class ToolMessage extends Message<ToolResultPart> {
+    readonly role = "tool";
+    getToolResults(): ToolResultPart[];
+    protected fromString(text: string): ToolResultPart;
+}
+declare class SystemMessage extends Message<TextPart> {
+    readonly role: MessageRole;
+    protected fromString(text: string): TextPart;
+}
+declare class UserMessage extends Message<TextPart | ImagePart | FilePart> {
+    readonly role = "user";
+    getImages(): ImagePart[];
+    getFiles(): FilePart[];
+    protected fromString(text: string): TextPart;
+}
+declare const Role: {
+    readonly ASSISTANT: "assistant";
+    readonly SYSTEM: "system";
+    readonly USER: "user";
+};
+declare class CustomMessage extends Message<MessageContentPart, string> {
+    role: string;
+    constructor(role: string, content: MessageContentPart | string, meta?: MessageMeta);
+    protected fromString(input: string): MessageContentPart;
+}
+
+export { AssistantMessage, CustomMessage, Message, type MessageContentPart, type MessageInput, type MessageMeta, type MessageRole, Role, SystemMessage, ToolMessage, UserMessage };

package/dist/backend/message.js

@@ -0,0 +1,193 @@
+import { Serializable } from '../internals/serializable.js';
+import { shallowCopy } from '../serializer/utils.js';
+import { z } from 'zod';
+import { ValueError } from '../errors.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function isText(content) {
+  return content.type === "text";
+}
+__name(isText, "isText");
+function isImage(content) {
+  return content.type === "image";
+}
+__name(isImage, "isImage");
+function isFile(content) {
+  return content.type === "file";
+}
+__name(isFile, "isFile");
+function isToolCall(content) {
+  return content.type === "tool-call";
+}
+__name(isToolCall, "isToolCall");
+function isToolResult(content) {
+  return content.type === "tool-result";
+}
+__name(isToolResult, "isToolResult");
+class Message extends Serializable {
+  static {
+    __name(this, "Message");
+  }
+  meta;
+  content;
+  constructor(content, meta = {}) {
+    super(), this.meta = meta;
+    if (!meta?.createdAt) {
+      meta.createdAt = /* @__PURE__ */ new Date();
+    }
+    if (typeof content === "string") {
+      this.content = [
+        this.fromString(content)
+      ];
+    } else {
+      this.content = Array.isArray(content) ? content : [
+        content
+      ];
+    }
+  }
+  static of({ role, text, meta }) {
+    if (role === "user") {
+      return new UserMessage(text, meta);
+    } else if (role === "assistant") {
+      return new AssistantMessage(text, meta);
+    } else if (role === "system") {
+      return new SystemMessage(text, meta);
+    } else if (role === "tool") {
+      return new ToolMessage(text, meta);
+    } else {
+      return new CustomMessage(role, text, meta);
+    }
+  }
+  get text() {
+    return this.getTexts().map((c) => c.text).join("");
+  }
+  getTexts() {
+    return this.content.filter(isText);
+  }
+  createSnapshot() {
+    return {
+      content: shallowCopy(this.content),
+      meta: shallowCopy(this.meta),
+      role: this.role
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+  toPlain() {
+    return {
+      role: this.role,
+      content: shallowCopy(this.content)
+    };
+  }
+  [Symbol.iterator]() {
+    return this.content[Symbol.iterator]();
+  }
+}
+class AssistantMessage extends Message {
+  static {
+    __name(this, "AssistantMessage");
+  }
+  role = "assistant";
+  static {
+    this.register();
+  }
+  getToolCalls() {
+    return this.content.filter(isToolCall);
+  }
+  fromString(text) {
+    return {
+      type: "text",
+      text
+    };
+  }
+}
+class ToolMessage extends Message {
+  static {
+    __name(this, "ToolMessage");
+  }
+  role = "tool";
+  static {
+    this.register();
+  }
+  getToolResults() {
+    return this.content.filter(isToolResult);
+  }
+  fromString(text) {
+    const { success, data } = z.object({
+      type: z.literal("tool-result"),
+      result: z.any(),
+      toolName: z.string(),
+      toolCallId: z.string()
+    }).safeParse(text);
+    if (!success) {
+      throw new ValueError(`ToolMessage cannot be created from '${text}'!`);
+    }
+    return data;
+  }
+}
+class SystemMessage extends Message {
+  static {
+    __name(this, "SystemMessage");
+  }
+  role = "system";
+  static {
+    this.register();
+  }
+  fromString(text) {
+    return {
+      type: "text",
+      text
+    };
+  }
+}
+class UserMessage extends Message {
+  static {
+    __name(this, "UserMessage");
+  }
+  role = "user";
+  static {
+    this.register();
+  }
+  getImages() {
+    return this.content.filter(isImage);
+  }
+  getFiles() {
+    return this.content.filter(isFile);
+  }
+  fromString(text) {
+    return {
+      type: "text",
+      text
+    };
+  }
+}
+const Role = {
+  ASSISTANT: "assistant",
+  SYSTEM: "system",
+  USER: "user"
+};
+class CustomMessage extends Message {
+  static {
+    __name(this, "CustomMessage");
+  }
+  role;
+  constructor(role, content, meta = {}) {
+    super(content, meta);
+    if (!role) {
+      throw new ValueError(`Role "${role}" must be specified!`);
+    }
+    this.role = role;
+  }
+  fromString(input) {
+    return {
+      type: "text",
+      text: input
+    };
+  }
+}
+
+export { AssistantMessage, CustomMessage, Message, Role, SystemMessage, ToolMessage, UserMessage };
+//# sourceMappingURL=message.js.map
+//# sourceMappingURL=message.js.map

package/dist/backend/message.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backend/message.ts"],"names":["isText","content","type","isImage","isFile","isToolCall","isToolResult","Message","Serializable","constructor","meta","createdAt","Date","fromString","Array","isArray","of","role","text","UserMessage","AssistantMessage","SystemMessage","ToolMessage","CustomMessage","getTexts","map","c","join","filter","createSnapshot","shallowCopy","loadSnapshot","snapshot","Object","assign","toPlain","Symbol","iterator","register","getToolCalls","getToolResults","success","data","z","object","literal","result","any","toolName","string","toolCallId","safeParse","ValueError","getImages","getFiles","Role","ASSISTANT","SYSTEM","USER","input"],"mappings":"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","file":"message.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 { Serializable } from \"@/internals/serializable.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { FilePart, ImagePart, TextPart, ToolCallPart, ToolResultPart } from \"ai\";\nimport { z } from \"zod\";\nimport { ValueError } from \"@/errors.js\";\n\nexport type MessageRole = \"user\" | \"system\" | \"tool\" | \"assistant\";\nexport type MessageContentPart = TextPart | ToolCallPart | ImagePart | FilePart | ToolResultPart;\n\nexport interface MessageMeta {\n  [key: string]: any;\n  createdAt?: Date;\n}\n\nexport interface MessageInput {\n  role: MessageRole;\n  text: string; // TODO\n  meta?: MessageMeta;\n}\n\nfunction isText(content: MessageContentPart): content is TextPart {\n  return content.type === \"text\";\n}\nfunction isImage(content: MessageContentPart): content is ImagePart {\n  return content.type === \"image\";\n}\nfunction isFile(content: MessageContentPart): content is FilePart {\n  return content.type === \"file\";\n}\nfunction isToolCall(content: MessageContentPart): content is ToolCallPart {\n  return content.type === \"tool-call\";\n}\nfunction isToolResult(content: MessageContentPart): content is ToolResultPart {\n  return content.type === \"tool-result\";\n}\n\nexport abstract class Message<\n  T extends MessageContentPart = MessageContentPart,\n  R extends string = MessageRole | string,\n> extends Serializable {\n  public abstract readonly role: R;\n  public readonly content: T[];\n\n  constructor(\n    content: T | T[] | string,\n    public readonly meta: MessageMeta = {},\n  ) {\n    super();\n    if (!meta?.createdAt) {\n      meta.createdAt = new Date();\n    }\n    if (typeof content === \"string\") {\n      this.content = [this.fromString(content)];\n    } else {\n      this.content = Array.isArray(content) ? content : [content];\n    }\n  }\n\n  protected abstract fromString(input: string): T;\n\n  static of({ role, text, meta }: MessageInput): Message {\n    if (role === \"user\") {\n      return new UserMessage(text, meta);\n    } else if (role === \"assistant\") {\n      return new AssistantMessage(text, meta);\n    } else if (role === \"system\") {\n      return new SystemMessage(text, meta);\n    } else if (role === \"tool\") {\n      return new ToolMessage(text, meta);\n    } else {\n      return new CustomMessage(role, text, meta);\n    }\n  }\n\n  get text() {\n    return this.getTexts()\n      .map((c) => c.text)\n      .join(\"\");\n  }\n\n  getTexts() {\n    return this.content.filter(isText) as TextPart[];\n  }\n\n  createSnapshot() {\n    return { content: shallowCopy(this.content), meta: shallowCopy(this.meta), role: this.role };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n\n  toPlain() {\n    return { role: this.role, content: shallowCopy(this.content) } as const;\n  }\n\n  [Symbol.iterator](): Iterator<T> {\n    return this.content[Symbol.iterator]();\n  }\n}\n\nexport class AssistantMessage extends Message<TextPart | ToolCallPart> {\n  public readonly role = \"assistant\";\n\n  static {\n    this.register();\n  }\n\n  getToolCalls() {\n    return this.content.filter(isToolCall);\n  }\n\n  protected fromString(text: string): TextPart {\n    return { type: \"text\", text };\n  }\n}\n\nexport class ToolMessage extends Message<ToolResultPart> {\n  public readonly role = \"tool\";\n\n  static {\n    this.register();\n  }\n\n  getToolResults() {\n    return this.content.filter(isToolResult);\n  }\n\n  protected fromString(text: string): ToolResultPart {\n    const { success, data } = z\n      .object({\n        type: z.literal(\"tool-result\"),\n        result: z.any(),\n        toolName: z.string(),\n        toolCallId: z.string(),\n      })\n      .safeParse(text);\n\n    if (!success) {\n      throw new ValueError(`ToolMessage cannot be created from '${text}'!`);\n    }\n\n    return data as ToolResultPart;\n  }\n}\n\nexport class SystemMessage extends Message<TextPart> {\n  public readonly role: MessageRole = \"system\";\n\n  static {\n    this.register();\n  }\n\n  protected fromString(text: string): TextPart {\n    return { type: \"text\", text };\n  }\n}\n\nexport class UserMessage extends Message<TextPart | ImagePart | FilePart> {\n  public readonly role = \"user\";\n\n  static {\n    this.register();\n  }\n\n  getImages() {\n    return this.content.filter(isImage);\n  }\n\n  getFiles() {\n    return this.content.filter(isFile);\n  }\n\n  protected fromString(text: string): TextPart {\n    return { type: \"text\", text };\n  }\n}\n\nexport const Role = {\n  ASSISTANT: \"assistant\",\n  SYSTEM: \"system\",\n  USER: \"user\",\n} as const;\n\nexport class CustomMessage extends Message<MessageContentPart, string> {\n  public role: string;\n\n  constructor(role: string, content: MessageContentPart | string, meta: MessageMeta = {}) {\n    super(content, meta);\n    if (!role) {\n      throw new ValueError(`Role \"${role}\" must be specified!`);\n    }\n    this.role = role;\n  }\n\n  protected fromString(input: string): MessageContentPart {\n    return { type: \"text\", text: input };\n  }\n}\n"]}

package/dist/backend/utils.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+var errors_cjs = require('../errors.cjs');
+var constants_cjs = require('./constants.cjs');
+var remeda = require('remeda');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function findProviderDef(value) {
+  return Object.values(constants_cjs.BackendProviders).find((p) => p.name === value || p.module === value || p.aliases.includes(value)) ?? null;
+}
+__name(findProviderDef, "findProviderDef");
+function parseModel(name) {
+  if (!name) {
+    throw new errors_cjs.ValueError("Neither 'provider' nor 'provider:model' was specified.");
+  }
+  const [providerId, modelId] = name.split(":");
+  const providerDef = findProviderDef(providerId);
+  if (!providerDef) {
+    throw new errors_cjs.ValueError("Model does not contain provider name!");
+  }
+  return {
+    providerId,
+    modelId,
+    providerDef
+  };
+}
+__name(parseModel, "parseModel");
+async function loadModel(name, type) {
+  const { providerDef } = parseModel(name);
+  const module = await import(`beeai-framework/adapters/${providerDef.module}/backend/${type}`);
+  return module[`${providerDef.name}${remeda.capitalize(type)}Model`];
+}
+__name(loadModel, "loadModel");
+
+exports.loadModel = loadModel;
+exports.parseModel = parseModel;
+//# sourceMappingURL=utils.cjs.map
+//# sourceMappingURL=utils.cjs.map

package/dist/backend/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backend/utils.ts"],"names":["findProviderDef","value","Object","values","BackendProviders","find","p","name","module","aliases","includes","parseModel","ValueError","providerId","modelId","split","providerDef","loadModel","type","capitalize"],"mappings":";;;;;;;;AAuBA,SAASA,gBAAgBC,KAAa,EAAA;AACpC,EAAA,OACEC,OAAOC,MAAOC,CAAAA,8BAAAA,EAAkBC,IAC9B,CAAA,CAACC,MAAMA,CAAEC,CAAAA,IAAAA,KAASN,KAASK,IAAAA,CAAAA,CAAEE,WAAWP,KAASK,IAAAA,CAAAA,CAAEG,QAAQC,QAAST,CAAAA,KAAAA,CAAAA,CACjE,IAAA,IAAA;AAET;AANSD,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAQF,SAASW,WAAWJ,IAAY,EAAA;AACrC,EAAA,IAAI,CAACA,IAAM,EAAA;AACT,IAAM,MAAA,IAAIK,sBAAW,wDAAA,CAAA;AACvB;AACA,EAAA,MAAM,CAACC,UAAYC,EAAAA,OAAAA,CAAWP,GAAAA,IAAAA,CAAKQ,MAAM,GAAA,CAAA;AACzC,EAAMC,MAAAA,WAAAA,GAAchB,gBAAgBa,UAAAA,CAAAA;AACpC,EAAA,IAAI,CAACG,WAAa,EAAA;AAChB,IAAM,MAAA,IAAIJ,sBAAW,uCAAA,CAAA;AACvB;AACA,EAAO,OAAA;AAAEC,IAAAA,UAAAA;AAAYC,IAAAA,OAAAA;AAASE,IAAAA;AAAY,GAAA;AAC5C;AAVgBL,MAAAA,CAAAA,UAAAA,EAAAA,YAAAA,CAAAA;AAYhB,eAAsBM,SAAAA,CACpBV,MACAW,IAA0B,EAAA;AAE1B,EAAA,MAAM,EAAEF,WAAAA,EAAgBL,GAAAA,UAAAA,CAAWJ,IAAAA,CAAAA;AACnC,EAAA,MAAMC,SAAS,MAAM,OAAO,4BAA4BQ,WAAYR,CAAAA,MAAM,YAAYU,IAAAA,CAAAA,CAAAA,CAAAA;AACtF,EAAOV,OAAAA,MAAAA,CAAO,GAAGQ,WAAYT,CAAAA,IAAI,GAAGY,iBAAWD,CAAAA,IAAAA,CAAAA,CAAY,KAAA,CAAA,CAAA;AAC7D;AAPsBD,MAAAA,CAAAA,SAAAA,EAAAA,WAAAA,CAAAA","file":"utils.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 { ValueError } from \"@/errors.js\";\nimport { ClassConstructor } from \"@/internals/types.js\";\nimport { BackendProviders, ProviderDef, ProviderName } from \"@/backend/constants.js\";\nimport { capitalize } from \"remeda\";\n\nexport type FullModelName = `${ProviderName}:${string}`;\n\nfunction findProviderDef(value: string): ProviderDef | null {\n  return (\n    Object.values(BackendProviders).find(\n      (p) => p.name === value || p.module === value || p.aliases.includes(value),\n    ) ?? null\n  );\n}\n\nexport function parseModel(name: string) {\n  if (!name) {\n    throw new ValueError(\"Neither 'provider' nor 'provider:model' was specified.\");\n  }\n  const [providerId, modelId] = name.split(\":\") as [ProviderName, string];\n  const providerDef = findProviderDef(providerId);\n  if (!providerDef) {\n    throw new ValueError(\"Model does not contain provider name!\");\n  }\n  return { providerId, modelId, providerDef };\n}\n\nexport async function loadModel<T>(\n  name: ProviderName | FullModelName,\n  type: \"embedding\" | \"chat\",\n): Promise<ClassConstructor<T>> {\n  const { providerDef } = parseModel(name);\n  const module = await import(`beeai-framework/adapters/${providerDef.module}/backend/${type}`);\n  return module[`${providerDef.name}${capitalize(type)}Model`];\n}\n"]}