beeai-framework 0.1.2

package/dist/backend/constants.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 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 const BackendProviders: {
+    readonly OpenAI: {
+        readonly name: "OpenAI";
+        readonly module: "openai";
+        readonly aliases: string[];
+    };
+    readonly Azure: {
+        readonly name: "Azure";
+        readonly module: "azure";
+        readonly aliases: string[];
+    };
+    readonly Watsonx: {
+        readonly name: "Watsonx";
+        readonly module: "watsonx";
+        readonly aliases: string[];
+    };
+    readonly Ollama: {
+        readonly name: "Ollama";
+        readonly module: "ollama";
+        readonly aliases: string[];
+    };
+    readonly GoogleVertex: {
+        readonly name: "GoogleVertex";
+        readonly module: "google-vertex";
+        readonly aliases: string[];
+    };
+    readonly Bedrock: {
+        readonly name: "Bedrock";
+        readonly module: "amazon-bedrock";
+        readonly aliases: string[];
+    };
+    readonly Groq: {
+        readonly name: "Groq";
+        readonly module: "groq";
+        readonly aliases: string[];
+    };
+    readonly Dummy: {
+        readonly name: "Dummy";
+        readonly module: "dummy";
+        readonly aliases: string[];
+    };
+};
+type ProviderName = (typeof BackendProviders)[keyof typeof BackendProviders]["module"];
+type ProviderHumanName = (typeof BackendProviders)[keyof typeof BackendProviders]["name"];
+type ProviderDef = (typeof BackendProviders)[keyof typeof BackendProviders];
+
+export { BackendProviders, type ProviderDef, type ProviderHumanName, type ProviderName };

package/dist/backend/constants.js

@@ -0,0 +1,60 @@
+const BackendProviders = {
+  OpenAI: {
+    name: "OpenAI",
+    module: "openai",
+    aliases: [
+      "openai"
+    ]
+  },
+  Azure: {
+    name: "Azure",
+    module: "azure",
+    aliases: [
+      "microsoft",
+      "microsoft-azure"
+    ]
+  },
+  Watsonx: {
+    name: "Watsonx",
+    module: "watsonx",
+    aliases: [
+      "watsonx",
+      "ibm"
+    ]
+  },
+  Ollama: {
+    name: "Ollama",
+    module: "ollama",
+    aliases: []
+  },
+  GoogleVertex: {
+    name: "GoogleVertex",
+    module: "google-vertex",
+    aliases: [
+      "google",
+      "vertex"
+    ]
+  },
+  Bedrock: {
+    name: "Bedrock",
+    module: "amazon-bedrock",
+    aliases: [
+      "amazon",
+      "bedrock"
+    ]
+  },
+  Groq: {
+    name: "Groq",
+    module: "groq",
+    aliases: []
+  },
+  Dummy: {
+    name: "Dummy",
+    module: "dummy",
+    aliases: []
+  }
+};
+
+export { BackendProviders };
+//# sourceMappingURL=constants.js.map
+//# sourceMappingURL=constants.js.map

package/dist/backend/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backend/constants.ts"],"names":["BackendProviders","OpenAI","name","module","aliases","Azure","Watsonx","Ollama","GoogleVertex","Bedrock","Groq","Dummy"],"mappings":"AAgBO,MAAMA,gBAAmB,GAAA;EAC9BC,MAAQ,EAAA;IAAEC,IAAM,EAAA,QAAA;IAAUC,MAAQ,EAAA,QAAA;IAAUC,OAAS,EAAA;AAAC,MAAA;;AAAsB,GAAA;EAC5EC,KAAO,EAAA;IAAEH,IAAM,EAAA,OAAA;IAASC,MAAQ,EAAA,OAAA;IAASC,OAAS,EAAA;AAAC,MAAA,WAAA;AAAa,MAAA;;AAA+B,GAAA;EAC/FE,OAAS,EAAA;IAAEJ,IAAM,EAAA,SAAA;IAAWC,MAAQ,EAAA,SAAA;IAAWC,OAAS,EAAA;AAAC,MAAA,SAAA;AAAW,MAAA;;AAAmB,GAAA;EACvFG,MAAQ,EAAA;IAAEL,IAAM,EAAA,QAAA;IAAUC,MAAQ,EAAA,QAAA;AAAUC,IAAAA,OAAAA,EAAS;AAAe,GAAA;EACpEI,YAAc,EAAA;IACZN,IAAM,EAAA,cAAA;IACNC,MAAQ,EAAA,eAAA;IACRC,OAAS,EAAA;AAAC,MAAA,QAAA;AAAU,MAAA;;AACtB,GAAA;EACAK,OAAS,EAAA;IACPP,IAAM,EAAA,SAAA;IACNC,MAAQ,EAAA,gBAAA;IACRC,OAAS,EAAA;AAAC,MAAA,QAAA;AAAU,MAAA;;AACtB,GAAA;EACAM,IAAM,EAAA;IAAER,IAAM,EAAA,MAAA;IAAQC,MAAQ,EAAA,MAAA;AAAQC,IAAAA,OAAAA,EAAS;AAAe,GAAA;EAC9DO,KAAO,EAAA;IAAET,IAAM,EAAA,OAAA;IAASC,MAAQ,EAAA,OAAA;AAASC,IAAAA,OAAAA,EAAS;AAAe;AACnE","file":"constants.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\nexport const BackendProviders = {\n  OpenAI: { name: \"OpenAI\", module: \"openai\", aliases: [\"openai\"] as string[] },\n  Azure: { name: \"Azure\", module: \"azure\", aliases: [\"microsoft\", \"microsoft-azure\"] as string[] },\n  Watsonx: { name: \"Watsonx\", module: \"watsonx\", aliases: [\"watsonx\", \"ibm\"] as string[] },\n  Ollama: { name: \"Ollama\", module: \"ollama\", aliases: [] as string[] },\n  GoogleVertex: {\n    name: \"GoogleVertex\",\n    module: \"google-vertex\",\n    aliases: [\"google\", \"vertex\"] as string[],\n  },\n  Bedrock: {\n    name: \"Bedrock\",\n    module: \"amazon-bedrock\",\n    aliases: [\"amazon\", \"bedrock\"] as string[],\n  },\n  Groq: { name: \"Groq\", module: \"groq\", aliases: [] as string[] },\n  Dummy: { name: \"Dummy\", module: \"dummy\", aliases: [] as string[] },\n} as const;\n\nexport type ProviderName = (typeof BackendProviders)[keyof typeof BackendProviders][\"module\"];\nexport type ProviderHumanName = (typeof BackendProviders)[keyof typeof BackendProviders][\"name\"];\nexport type ProviderDef = (typeof BackendProviders)[keyof typeof BackendProviders];\n"]}

package/dist/backend/core.cjs

@@ -0,0 +1,42 @@
+'use strict';
+
+var backend_cjs = require('./backend.cjs');
+var chat_cjs = require('./chat.cjs');
+var embedding_cjs = require('./embedding.cjs');
+var message_cjs = require('./message.cjs');
+var errors_cjs = require('./errors.cjs');
+
+
+
+Object.keys(backend_cjs).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return backend_cjs[k]; }
+	});
+});
+Object.keys(chat_cjs).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return chat_cjs[k]; }
+	});
+});
+Object.keys(embedding_cjs).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return embedding_cjs[k]; }
+	});
+});
+Object.keys(message_cjs).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return message_cjs[k]; }
+	});
+});
+Object.keys(errors_cjs).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return errors_cjs[k]; }
+	});
+});
+//# sourceMappingURL=core.cjs.map
+//# sourceMappingURL=core.cjs.map

package/dist/backend/core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"core.cjs","sourcesContent":[]}

package/dist/backend/core.d.cts

@@ -0,0 +1,23 @@
+export { Backend } from './backend.cjs';
+export { ChatConfig, ChatModel, ChatModelCache, ChatModelEmitter, ChatModelEvents, ChatModelFinishReason, ChatModelInput, ChatModelObjectInput, ChatModelObjectOutput, ChatModelOutput, ChatModelParameters, ChatModelUsage, ConfigFn } from './chat.cjs';
+export { EmbeddingModel, EmbeddingModelEmitter, EmbeddingModelEvents, EmbeddingModelInput, EmbeddingModelOutput } from './embedding.cjs';
+export { AssistantMessage, CustomMessage, Message, MessageContentPart, MessageInput, MessageMeta, MessageRole, Role, SystemMessage, ToolMessage, UserMessage } from './message.cjs';
+export { BackendError, ChatModelError, EmbeddingModelError } from './errors.cjs';
+import '../internals/serializable.cjs';
+import '../internals/types.cjs';
+import '../internals/helpers/guards.cjs';
+import './utils.cjs';
+import './constants.cjs';
+import 'ai';
+import '../context.cjs';
+import '../emitter-BWtGHYn0.cjs';
+import '../internals/helpers/promise.cjs';
+import '../errors.cjs';
+import 'promise-based-task';
+import '../cache/base.cjs';
+import '../tools/base.cjs';
+import 'ajv';
+import '../internals/helpers/schema.cjs';
+import 'zod';
+import 'zod-to-json-schema';
+import '@ai-sdk/provider';

package/dist/backend/core.d.ts

@@ -0,0 +1,23 @@
+export { Backend } from './backend.js';
+export { ChatConfig, ChatModel, ChatModelCache, ChatModelEmitter, ChatModelEvents, ChatModelFinishReason, ChatModelInput, ChatModelObjectInput, ChatModelObjectOutput, ChatModelOutput, ChatModelParameters, ChatModelUsage, ConfigFn } from './chat.js';
+export { EmbeddingModel, EmbeddingModelEmitter, EmbeddingModelEvents, EmbeddingModelInput, EmbeddingModelOutput } from './embedding.js';
+export { AssistantMessage, CustomMessage, Message, MessageContentPart, MessageInput, MessageMeta, MessageRole, Role, SystemMessage, ToolMessage, UserMessage } from './message.js';
+export { BackendError, ChatModelError, EmbeddingModelError } from './errors.js';
+import '../internals/serializable.js';
+import '../internals/types.js';
+import '../internals/helpers/guards.js';
+import './utils.js';
+import './constants.js';
+import 'ai';
+import '../context.js';
+import '../emitter-l0W9gC1A.js';
+import '../internals/helpers/promise.js';
+import '../errors.js';
+import 'promise-based-task';
+import '../cache/base.js';
+import '../tools/base.js';
+import 'ajv';
+import '../internals/helpers/schema.js';
+import 'zod';
+import 'zod-to-json-schema';
+import '@ai-sdk/provider';

package/dist/backend/core.js

@@ -0,0 +1,7 @@
+export * from './backend.js';
+export * from './chat.js';
+export * from './embedding.js';
+export * from './message.js';
+export * from './errors.js';
+//# sourceMappingURL=core.js.map
+//# sourceMappingURL=core.js.map

package/dist/backend/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"core.js","sourcesContent":[]}

package/dist/backend/embedding.cjs

@@ -0,0 +1,70 @@
+'use strict';
+
+var serializable_cjs = require('../internals/serializable.cjs');
+var utils_cjs = require('../serializer/utils.cjs');
+var context_cjs = require('../context.cjs');
+var retry_cjs = require('../internals/helpers/retry.cjs');
+var utils_cjs$1 = require('./utils.cjs');
+var errors_cjs = require('./errors.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class EmbeddingModel extends serializable_cjs.Serializable {
+  static {
+    __name(this, "EmbeddingModel");
+  }
+  create(input) {
+    input = utils_cjs.shallowCopy(input);
+    return context_cjs.RunContext.enter(this, {
+      params: [
+        input
+      ],
+      signal: input?.abortSignal
+    }, async (run) => {
+      try {
+        await run.emitter.emit("start", {
+          input
+        });
+        const result = await retry_cjs.pRetry(() => this._create(input, run), {
+          retries: input.maxRetries || 0,
+          signal: run.signal
+        });
+        await run.emitter.emit("success", {
+          value: result
+        });
+        return result;
+      } catch (error) {
+        await run.emitter.emit("error", {
+          input,
+          error
+        });
+        if (error instanceof errors_cjs.EmbeddingModelError) {
+          throw error;
+        } else {
+          throw new errors_cjs.EmbeddingModelError(`LLM has occurred an error.`, [
+            error
+          ]);
+        }
+      } finally {
+        await run.emitter.emit("finish", null);
+      }
+    });
+  }
+  static async fromName(name) {
+    const { providerId, modelId = "" } = utils_cjs$1.parseModel(name);
+    const Target = await utils_cjs$1.loadModel(providerId, "embedding");
+    return new Target(modelId);
+  }
+  createSnapshot() {
+    return {
+      emitter: this.emitter
+    };
+  }
+  destroy() {
+    this.emitter.destroy();
+  }
+}
+
+exports.EmbeddingModel = EmbeddingModel;
+//# sourceMappingURL=embedding.cjs.map
+//# sourceMappingURL=embedding.cjs.map

package/dist/backend/embedding.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backend/embedding.ts"],"names":["EmbeddingModel","Serializable","create","input","shallowCopy","RunContext","enter","params","signal","abortSignal","run","emitter","emit","result","pRetry","_create","retries","maxRetries","value","error","EmbeddingModelError","fromName","name","providerId","modelId","parseModel","Target","loadModel","createSnapshot","destroy"],"mappings":";;;;;;;;;;;AAkDO,MAAeA,uBAAuBC,6BAAAA,CAAAA;EAlD7C;;;AAwDEC,EAAAA,MAAAA,CAAOC,KAA4B,EAAA;AACjCA,IAAAA,KAAAA,GAAQC,sBAAYD,KAAAA,CAAAA;AAEpB,IAAOE,OAAAA,sBAAAA,CAAWC,MAChB,IACA,EAAA;MAAEC,MAAQ,EAAA;AAACJ,QAAAA;;AAAiBK,MAAAA,MAAAA,EAAQL,KAAOM,EAAAA;AAAY,KAAA,EACvD,OAAOC,GAAAA,KAAAA;AACL,MAAI,IAAA;AACF,QAAMA,MAAAA,GAAAA,CAAIC,OAAQC,CAAAA,IAAAA,CAAK,OAAS,EAAA;AAAET,UAAAA;SAAM,CAAA;AACxC,QAAMU,MAAAA,MAAAA,GAA+B,MAAMC,gBAAO,CAAA,MAAM,KAAKC,OAAQZ,CAAAA,KAAAA,EAAOO,GAAAA,CAAM,EAAA;AAChFM,UAAAA,OAAAA,EAASb,MAAMc,UAAc,IAAA,CAAA;AAC7BT,UAAAA,MAAAA,EAAQE,GAAIF,CAAAA;SACd,CAAA;AACA,QAAME,MAAAA,GAAAA,CAAIC,OAAQC,CAAAA,IAAAA,CAAK,SAAW,EAAA;UAAEM,KAAOL,EAAAA;SAAO,CAAA;AAClD,QAAOA,OAAAA,MAAAA;AACT,OAAA,CAAA,OAASM,KAAO,EAAA;AACd,QAAMT,MAAAA,GAAAA,CAAIC,OAAQC,CAAAA,IAAAA,CAAK,OAAS,EAAA;AAAET,UAAAA,KAAAA;AAAOgB,UAAAA;SAAM,CAAA;AAC/C,QAAA,IAAIA,iBAAiBC,8BAAqB,EAAA;AACxC,UAAMD,MAAAA,KAAAA;SACD,MAAA;AACL,UAAM,MAAA,IAAIC,+BAAoB,CAA8B,0BAAA,CAAA,EAAA;AAACD,YAAAA;AAAM,WAAA,CAAA;AACrE;OACF,SAAA;AACE,QAAA,MAAMT,GAAIC,CAAAA,OAAAA,CAAQC,IAAK,CAAA,QAAA,EAAU,IAAA,CAAA;AACnC;KACF,CAAA;AAEJ;AAEA,EAAA,aAAaS,SAASC,IAAoC,EAAA;AACxD,IAAA,MAAM,EAAEC,UAAYC,EAAAA,OAAAA,GAAU,EAAE,EAAA,GAAKC,uBAAWH,IAAAA,CAAAA;AAChD,IAAA,MAAMI,MAAS,GAAA,MAAMC,qBAA0BJ,CAAAA,UAAAA,EAAY,WAAA,CAAA;AAC3D,IAAO,OAAA,IAAIG,OAAOF,OAAAA,CAAAA;AACpB;EAOAI,cAAiB,GAAA;AACf,IAAO,OAAA;AAAEjB,MAAAA,OAAAA,EAAS,IAAKA,CAAAA;AAAQ,KAAA;AACjC;EAEAkB,OAAU,GAAA;AACR,IAAA,IAAA,CAAKlB,QAAQkB,OAAO,EAAA;AACtB;AACF","file":"embedding.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 { Callback } from \"@/emitter/types.js\";\nimport { FrameworkError } from \"@/errors.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { GetRunContext, RunContext } from \"@/context.js\";\nimport { pRetry } from \"@/internals/helpers/retry.js\";\nimport { FullModelName, loadModel, parseModel } from \"@/backend/utils.js\";\nimport { ProviderName } from \"@/backend/constants.js\";\nimport { EmbeddingModelError } from \"@/backend/errors.js\";\n\nexport interface EmbeddingModelInput {\n  values: string[];\n  abortSignal?: AbortSignal;\n  maxRetries?: number;\n}\n\nexport interface EmbeddingModelOutput {\n  values: string[];\n  embeddings: number[][];\n  usage: { tokens?: number };\n}\n\nexport interface EmbeddingModelEvents {\n  success?: Callback<{ value: EmbeddingModelOutput }>;\n  start?: Callback<{ input: EmbeddingModelInput }>;\n  error?: Callback<{ input: EmbeddingModelInput; error: FrameworkError }>;\n  finish?: Callback<null>;\n}\n\nexport type EmbeddingModelEmitter<A = Record<never, never>> = Emitter<\n  EmbeddingModelEvents & Omit<A, keyof EmbeddingModelEvents>\n>;\n\nexport abstract class EmbeddingModel extends Serializable {\n  public abstract readonly emitter: Emitter<EmbeddingModelEvents>;\n\n  abstract get modelId(): string;\n  abstract get providerId(): string;\n\n  create(input: EmbeddingModelInput) {\n    input = shallowCopy(input);\n\n    return RunContext.enter(\n      this,\n      { params: [input] as const, signal: input?.abortSignal },\n      async (run) => {\n        try {\n          await run.emitter.emit(\"start\", { input });\n          const result: EmbeddingModelOutput = await pRetry(() => this._create(input, run), {\n            retries: input.maxRetries || 0,\n            signal: run.signal,\n          });\n          await run.emitter.emit(\"success\", { value: result });\n          return result;\n        } catch (error) {\n          await run.emitter.emit(\"error\", { input, error });\n          if (error instanceof EmbeddingModelError) {\n            throw error;\n          } else {\n            throw new EmbeddingModelError(`LLM has occurred an error.`, [error]);\n          }\n        } finally {\n          await run.emitter.emit(\"finish\", null);\n        }\n      },\n    );\n  }\n\n  static async fromName(name: FullModelName | ProviderName) {\n    const { providerId, modelId = \"\" } = parseModel(name);\n    const Target = await loadModel<EmbeddingModel>(providerId, \"embedding\");\n    return new Target(modelId);\n  }\n\n  protected abstract _create(\n    input: EmbeddingModelInput,\n    run: GetRunContext<typeof this>,\n  ): Promise<EmbeddingModelOutput>;\n\n  createSnapshot() {\n    return { emitter: this.emitter };\n  }\n\n  destroy() {\n    this.emitter.destroy();\n  }\n}\n"]}

package/dist/backend/embedding.d.cts

@@ -0,0 +1,50 @@
+import { Run, GetRunContext } from '../context.cjs';
+import { Serializable } from '../internals/serializable.cjs';
+import { C as Callback, E as Emitter } from '../emitter-BWtGHYn0.cjs';
+import { FrameworkError } from '../errors.cjs';
+import { FullModelName } from './utils.cjs';
+import { ProviderName } from './constants.cjs';
+import '../internals/helpers/promise.cjs';
+import '../internals/types.cjs';
+import '../internals/helpers/guards.cjs';
+
+interface EmbeddingModelInput {
+    values: string[];
+    abortSignal?: AbortSignal;
+    maxRetries?: number;
+}
+interface EmbeddingModelOutput {
+    values: string[];
+    embeddings: number[][];
+    usage: {
+        tokens?: number;
+    };
+}
+interface EmbeddingModelEvents {
+    success?: Callback<{
+        value: EmbeddingModelOutput;
+    }>;
+    start?: Callback<{
+        input: EmbeddingModelInput;
+    }>;
+    error?: Callback<{
+        input: EmbeddingModelInput;
+        error: FrameworkError;
+    }>;
+    finish?: Callback<null>;
+}
+type EmbeddingModelEmitter<A = Record<never, never>> = Emitter<EmbeddingModelEvents & Omit<A, keyof EmbeddingModelEvents>>;
+declare abstract class EmbeddingModel extends Serializable {
+    abstract readonly emitter: Emitter<EmbeddingModelEvents>;
+    abstract get modelId(): string;
+    abstract get providerId(): string;
+    create(input: EmbeddingModelInput): Run<EmbeddingModelOutput, this, readonly [EmbeddingModelInput]>;
+    static fromName(name: FullModelName | ProviderName): Promise<EmbeddingModel>;
+    protected abstract _create(input: EmbeddingModelInput, run: GetRunContext<typeof this>): Promise<EmbeddingModelOutput>;
+    createSnapshot(): {
+        emitter: Emitter<EmbeddingModelEvents>;
+    };
+    destroy(): void;
+}
+
+export { EmbeddingModel, type EmbeddingModelEmitter, type EmbeddingModelEvents, type EmbeddingModelInput, type EmbeddingModelOutput };

package/dist/backend/embedding.d.ts

@@ -0,0 +1,50 @@
+import { Run, GetRunContext } from '../context.js';
+import { Serializable } from '../internals/serializable.js';
+import { C as Callback, E as Emitter } from '../emitter-l0W9gC1A.js';
+import { FrameworkError } from '../errors.js';
+import { FullModelName } from './utils.js';
+import { ProviderName } from './constants.js';
+import '../internals/helpers/promise.js';
+import '../internals/types.js';
+import '../internals/helpers/guards.js';
+
+interface EmbeddingModelInput {
+    values: string[];
+    abortSignal?: AbortSignal;
+    maxRetries?: number;
+}
+interface EmbeddingModelOutput {
+    values: string[];
+    embeddings: number[][];
+    usage: {
+        tokens?: number;
+    };
+}
+interface EmbeddingModelEvents {
+    success?: Callback<{
+        value: EmbeddingModelOutput;
+    }>;
+    start?: Callback<{
+        input: EmbeddingModelInput;
+    }>;
+    error?: Callback<{
+        input: EmbeddingModelInput;
+        error: FrameworkError;
+    }>;
+    finish?: Callback<null>;
+}
+type EmbeddingModelEmitter<A = Record<never, never>> = Emitter<EmbeddingModelEvents & Omit<A, keyof EmbeddingModelEvents>>;
+declare abstract class EmbeddingModel extends Serializable {
+    abstract readonly emitter: Emitter<EmbeddingModelEvents>;
+    abstract get modelId(): string;
+    abstract get providerId(): string;
+    create(input: EmbeddingModelInput): Run<EmbeddingModelOutput, this, readonly [EmbeddingModelInput]>;
+    static fromName(name: FullModelName | ProviderName): Promise<EmbeddingModel>;
+    protected abstract _create(input: EmbeddingModelInput, run: GetRunContext<typeof this>): Promise<EmbeddingModelOutput>;
+    createSnapshot(): {
+        emitter: Emitter<EmbeddingModelEvents>;
+    };
+    destroy(): void;
+}
+
+export { EmbeddingModel, type EmbeddingModelEmitter, type EmbeddingModelEvents, type EmbeddingModelInput, type EmbeddingModelOutput };

package/dist/backend/embedding.js

@@ -0,0 +1,68 @@
+import { Serializable } from '../internals/serializable.js';
+import { shallowCopy } from '../serializer/utils.js';
+import { RunContext } from '../context.js';
+import { pRetry } from '../internals/helpers/retry.js';
+import { parseModel, loadModel } from './utils.js';
+import { EmbeddingModelError } from './errors.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class EmbeddingModel extends Serializable {
+  static {
+    __name(this, "EmbeddingModel");
+  }
+  create(input) {
+    input = shallowCopy(input);
+    return RunContext.enter(this, {
+      params: [
+        input
+      ],
+      signal: input?.abortSignal
+    }, async (run) => {
+      try {
+        await run.emitter.emit("start", {
+          input
+        });
+        const result = await pRetry(() => this._create(input, run), {
+          retries: input.maxRetries || 0,
+          signal: run.signal
+        });
+        await run.emitter.emit("success", {
+          value: result
+        });
+        return result;
+      } catch (error) {
+        await run.emitter.emit("error", {
+          input,
+          error
+        });
+        if (error instanceof EmbeddingModelError) {
+          throw error;
+        } else {
+          throw new EmbeddingModelError(`LLM has occurred an error.`, [
+            error
+          ]);
+        }
+      } finally {
+        await run.emitter.emit("finish", null);
+      }
+    });
+  }
+  static async fromName(name) {
+    const { providerId, modelId = "" } = parseModel(name);
+    const Target = await loadModel(providerId, "embedding");
+    return new Target(modelId);
+  }
+  createSnapshot() {
+    return {
+      emitter: this.emitter
+    };
+  }
+  destroy() {
+    this.emitter.destroy();
+  }
+}
+
+export { EmbeddingModel };
+//# sourceMappingURL=embedding.js.map
+//# sourceMappingURL=embedding.js.map

package/dist/backend/embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backend/embedding.ts"],"names":["EmbeddingModel","Serializable","create","input","shallowCopy","RunContext","enter","params","signal","abortSignal","run","emitter","emit","result","pRetry","_create","retries","maxRetries","value","error","EmbeddingModelError","fromName","name","providerId","modelId","parseModel","Target","loadModel","createSnapshot","destroy"],"mappings":";;;;;;;;;AAkDO,MAAeA,uBAAuBC,YAAAA,CAAAA;EAlD7C;;;AAwDEC,EAAAA,MAAAA,CAAOC,KAA4B,EAAA;AACjCA,IAAAA,KAAAA,GAAQC,YAAYD,KAAAA,CAAAA;AAEpB,IAAOE,OAAAA,UAAAA,CAAWC,MAChB,IACA,EAAA;MAAEC,MAAQ,EAAA;AAACJ,QAAAA;;AAAiBK,MAAAA,MAAAA,EAAQL,KAAOM,EAAAA;AAAY,KAAA,EACvD,OAAOC,GAAAA,KAAAA;AACL,MAAI,IAAA;AACF,QAAMA,MAAAA,GAAAA,CAAIC,OAAQC,CAAAA,IAAAA,CAAK,OAAS,EAAA;AAAET,UAAAA;SAAM,CAAA;AACxC,QAAMU,MAAAA,MAAAA,GAA+B,MAAMC,MAAO,CAAA,MAAM,KAAKC,OAAQZ,CAAAA,KAAAA,EAAOO,GAAAA,CAAM,EAAA;AAChFM,UAAAA,OAAAA,EAASb,MAAMc,UAAc,IAAA,CAAA;AAC7BT,UAAAA,MAAAA,EAAQE,GAAIF,CAAAA;SACd,CAAA;AACA,QAAME,MAAAA,GAAAA,CAAIC,OAAQC,CAAAA,IAAAA,CAAK,SAAW,EAAA;UAAEM,KAAOL,EAAAA;SAAO,CAAA;AAClD,QAAOA,OAAAA,MAAAA;AACT,OAAA,CAAA,OAASM,KAAO,EAAA;AACd,QAAMT,MAAAA,GAAAA,CAAIC,OAAQC,CAAAA,IAAAA,CAAK,OAAS,EAAA;AAAET,UAAAA,KAAAA;AAAOgB,UAAAA;SAAM,CAAA;AAC/C,QAAA,IAAIA,iBAAiBC,mBAAqB,EAAA;AACxC,UAAMD,MAAAA,KAAAA;SACD,MAAA;AACL,UAAM,MAAA,IAAIC,oBAAoB,CAA8B,0BAAA,CAAA,EAAA;AAACD,YAAAA;AAAM,WAAA,CAAA;AACrE;OACF,SAAA;AACE,QAAA,MAAMT,GAAIC,CAAAA,OAAAA,CAAQC,IAAK,CAAA,QAAA,EAAU,IAAA,CAAA;AACnC;KACF,CAAA;AAEJ;AAEA,EAAA,aAAaS,SAASC,IAAoC,EAAA;AACxD,IAAA,MAAM,EAAEC,UAAYC,EAAAA,OAAAA,GAAU,EAAE,EAAA,GAAKC,WAAWH,IAAAA,CAAAA;AAChD,IAAA,MAAMI,MAAS,GAAA,MAAMC,SAA0BJ,CAAAA,UAAAA,EAAY,WAAA,CAAA;AAC3D,IAAO,OAAA,IAAIG,OAAOF,OAAAA,CAAAA;AACpB;EAOAI,cAAiB,GAAA;AACf,IAAO,OAAA;AAAEjB,MAAAA,OAAAA,EAAS,IAAKA,CAAAA;AAAQ,KAAA;AACjC;EAEAkB,OAAU,GAAA;AACR,IAAA,IAAA,CAAKlB,QAAQkB,OAAO,EAAA;AACtB;AACF","file":"embedding.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 { Callback } from \"@/emitter/types.js\";\nimport { FrameworkError } from \"@/errors.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { GetRunContext, RunContext } from \"@/context.js\";\nimport { pRetry } from \"@/internals/helpers/retry.js\";\nimport { FullModelName, loadModel, parseModel } from \"@/backend/utils.js\";\nimport { ProviderName } from \"@/backend/constants.js\";\nimport { EmbeddingModelError } from \"@/backend/errors.js\";\n\nexport interface EmbeddingModelInput {\n  values: string[];\n  abortSignal?: AbortSignal;\n  maxRetries?: number;\n}\n\nexport interface EmbeddingModelOutput {\n  values: string[];\n  embeddings: number[][];\n  usage: { tokens?: number };\n}\n\nexport interface EmbeddingModelEvents {\n  success?: Callback<{ value: EmbeddingModelOutput }>;\n  start?: Callback<{ input: EmbeddingModelInput }>;\n  error?: Callback<{ input: EmbeddingModelInput; error: FrameworkError }>;\n  finish?: Callback<null>;\n}\n\nexport type EmbeddingModelEmitter<A = Record<never, never>> = Emitter<\n  EmbeddingModelEvents & Omit<A, keyof EmbeddingModelEvents>\n>;\n\nexport abstract class EmbeddingModel extends Serializable {\n  public abstract readonly emitter: Emitter<EmbeddingModelEvents>;\n\n  abstract get modelId(): string;\n  abstract get providerId(): string;\n\n  create(input: EmbeddingModelInput) {\n    input = shallowCopy(input);\n\n    return RunContext.enter(\n      this,\n      { params: [input] as const, signal: input?.abortSignal },\n      async (run) => {\n        try {\n          await run.emitter.emit(\"start\", { input });\n          const result: EmbeddingModelOutput = await pRetry(() => this._create(input, run), {\n            retries: input.maxRetries || 0,\n            signal: run.signal,\n          });\n          await run.emitter.emit(\"success\", { value: result });\n          return result;\n        } catch (error) {\n          await run.emitter.emit(\"error\", { input, error });\n          if (error instanceof EmbeddingModelError) {\n            throw error;\n          } else {\n            throw new EmbeddingModelError(`LLM has occurred an error.`, [error]);\n          }\n        } finally {\n          await run.emitter.emit(\"finish\", null);\n        }\n      },\n    );\n  }\n\n  static async fromName(name: FullModelName | ProviderName) {\n    const { providerId, modelId = \"\" } = parseModel(name);\n    const Target = await loadModel<EmbeddingModel>(providerId, \"embedding\");\n    return new Target(modelId);\n  }\n\n  protected abstract _create(\n    input: EmbeddingModelInput,\n    run: GetRunContext<typeof this>,\n  ): Promise<EmbeddingModelOutput>;\n\n  createSnapshot() {\n    return { emitter: this.emitter };\n  }\n\n  destroy() {\n    this.emitter.destroy();\n  }\n}\n"]}

package/dist/backend/errors.cjs

@@ -0,0 +1,27 @@
+'use strict';
+
+var errors_cjs = require('../errors.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class BackendError extends errors_cjs.FrameworkError {
+  static {
+    __name(this, "BackendError");
+  }
+}
+class ChatModelError extends BackendError {
+  static {
+    __name(this, "ChatModelError");
+  }
+}
+class EmbeddingModelError extends BackendError {
+  static {
+    __name(this, "EmbeddingModelError");
+  }
+}
+
+exports.BackendError = BackendError;
+exports.ChatModelError = ChatModelError;
+exports.EmbeddingModelError = EmbeddingModelError;
+//# sourceMappingURL=errors.cjs.map
+//# sourceMappingURL=errors.cjs.map

package/dist/backend/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backend/errors.ts"],"names":["BackendError","FrameworkError","ChatModelError","EmbeddingModelError"],"mappings":";;;;;;AAkBO,MAAMA,qBAAqBC,yBAAAA,CAAAA;EAlBlC;;;AAkBkD;AAE3C,MAAMC,uBAAuBF,YAAAA,CAAAA;EApBpC;;;AAoBkD;AAE3C,MAAMG,4BAA4BH,YAAAA,CAAAA;EAtBzC;;;AAsBuD","file":"errors.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 { FrameworkError } from \"@/errors.js\";\n\nexport class BackendError extends FrameworkError {}\n\nexport class ChatModelError extends BackendError {}\n\nexport class EmbeddingModelError extends BackendError {}\n"]}

package/dist/backend/errors.d.cts

@@ -0,0 +1,28 @@
+import { FrameworkError } from '../errors.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.
+ */
+
+declare class BackendError extends FrameworkError {
+}
+declare class ChatModelError extends BackendError {
+}
+declare class EmbeddingModelError extends BackendError {
+}
+
+export { BackendError, ChatModelError, EmbeddingModelError };

package/dist/backend/errors.d.ts

@@ -0,0 +1,28 @@
+import { FrameworkError } from '../errors.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.
+ */
+
+declare class BackendError extends FrameworkError {
+}
+declare class ChatModelError extends BackendError {
+}
+declare class EmbeddingModelError extends BackendError {
+}
+
+export { BackendError, ChatModelError, EmbeddingModelError };

package/dist/backend/errors.js

@@ -0,0 +1,23 @@
+import { FrameworkError } from '../errors.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class BackendError extends FrameworkError {
+  static {
+    __name(this, "BackendError");
+  }
+}
+class ChatModelError extends BackendError {
+  static {
+    __name(this, "ChatModelError");
+  }
+}
+class EmbeddingModelError extends BackendError {
+  static {
+    __name(this, "EmbeddingModelError");
+  }
+}
+
+export { BackendError, ChatModelError, EmbeddingModelError };
+//# sourceMappingURL=errors.js.map
+//# sourceMappingURL=errors.js.map

package/dist/backend/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backend/errors.ts"],"names":["BackendError","FrameworkError","ChatModelError","EmbeddingModelError"],"mappings":";;;;AAkBO,MAAMA,qBAAqBC,cAAAA,CAAAA;EAlBlC;;;AAkBkD;AAE3C,MAAMC,uBAAuBF,YAAAA,CAAAA;EApBpC;;;AAoBkD;AAE3C,MAAMG,4BAA4BH,YAAAA,CAAAA;EAtBzC;;;AAsBuD","file":"errors.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 { FrameworkError } from \"@/errors.js\";\n\nexport class BackendError extends FrameworkError {}\n\nexport class ChatModelError extends BackendError {}\n\nexport class EmbeddingModelError extends BackendError {}\n"]}