beeai-framework 0.1.7 → 0.1.9

package/README.md

@@ -11,20 +11,27 @@ Build production-ready multi-agent systems in TypeScript. BeeAI framework is als
 
 The source directory (`src`) contains the available modules:
 
-| Name                                                       | Description                                                                                 |
-| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
-| [**agents**](/typescript/docs/agents.md)                   | Base classes defining the common interface for agent.                                       |
-| [**backend**](/typescript/docs/backend.md)                 | Functionalities that relates to AI models (chat, embedding, image, tool calling, ...)       |
-| [**template**](/typescript/docs/templates.md)              | Prompt Templating system based on `Mustache` with various improvements.                     |
-| [**memory**](/typescript/docs/memory.md)                   | Various types of memories to use with agent.                                                |
-| [**tools**](/typescript/docs/tools.md)                     | Tools that an agent can use.                                                                |
-| [**cache**](/typescript/docs/cache.md)                     | Preset of different caching approaches that can be used together with tools.                |
-| [**errors**](/typescript/docs/errors.md)                   | Base framework error classes used by each module.                                           |
-| [**logger**](/typescript/docs/logger.md)                   | Core component for logging all actions within the framework.                                |
-| [**serializer**](/typescript/docs/serialization.md)        | Core component for the ability to serialize/deserialize modules into the serialized format. |
-| [**version**](/typescript/docs/version.md)                 | Constants representing the framework (e.g., the latest version)                             |
-| [**emitter**](/typescript/docs/emitter.md)                 | Bringing visibility to the system by emitting events.                                       |
-| [**instrumentation**](/typescript/docs/instrumentation.md) | Integrate monitoring tools into your application.                                           |
+| Name                                                | Description                                                                                 |
+| --------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| [**agents**](/typescript/docs/agents.md)            | Base classes defining the common interface for agent.                                       |
+| [**backend**](/typescript/docs/backend.md)          | Functionalities that relates to AI models (chat, embedding, image, tool calling, ...)       |
+| [**template**](/typescript/docs/templates.md)       | Prompt Templating system based on `Mustache` with various improvements.                     |
+| [**memory**](/typescript/docs/memory.md)            | Various types of memories to use with agent.                                                |
+| [**tools**](/typescript/docs/tools.md)              | Tools that an agent can use.                                                                |
+| [**cache**](/typescript/docs/cache.md)              | Preset of different caching approaches that can be used together with tools.                |
+| [**errors**](/typescript/docs/errors.md)            | Base framework error classes used by each module.                                           |
+| [**logger**](/typescript/docs/logger.md)            | Core component for logging all actions within the framework.                                |
+| [**serializer**](/typescript/docs/serialization.md) | Core component for the ability to serialize/deserialize modules into the serialized format. |
+| [**version**](/typescript/docs/version.md)          | Constants representing the framework (e.g., the latest version)                             |
+| [**emitter**](/typescript/docs/emitter.md)          | Bringing visibility to the system by emitting events.                                       |
+
+## External modules
+
+Use these packages to extend the base BeeAI framework functionality:
+
+| Name                                                                                                                       | Description                                       |
+| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
+| [**instrumentation**](https://github.com/Arize-ai/openinference/tree/main/js/packages/openinference-instrumentation-beeai) | Integrate monitoring tools into your application. |
 
 ## Installation
 
@@ -46,54 +53,60 @@ The following example demonstrates how to build a multi-agent workflow using the
 
 ```ts
 import "dotenv/config";
-import { UnconstrainedMemory } from "beeai-framework/memory/unconstrainedMemory";
 import { OpenMeteoTool } from "beeai-framework/tools/weather/openMeteo";
 import { WikipediaTool } from "beeai-framework/tools/search/wikipedia";
-import { AgentWorkflow } from "beeai-framework/experimental/workflows/agent";
-import { Message, Role } from "beeai-framework/llms/primitives/message";
-import { GroqChatLLM } from "beeai-framework/adapters/groq/chat";
+import { AgentWorkflow } from "beeai-framework/workflows/agent";
+import { OllamaChatModel } from "beeai-framework/adapters/ollama/backend/chat";
 
 const workflow = new AgentWorkflow();
 
 workflow.addAgent({
   name: "Researcher",
-  instructions: "You are a researcher assistant. Respond only if you can provide a useful answer.",
+  role: "A diligent researcher",
+  instructions: "You look up and provide information about a specific topic.",
   tools: [new WikipediaTool()],
-  llm: new GroqChatLLM(),
+  llm: new OllamaChatModel("llama3.1"),
 });
 
 workflow.addAgent({
   name: "WeatherForecaster",
-  instructions: "You are a weather assistant. Respond only if you can provide a useful answer.",
+  role: "A weather reporter",
+  instructions: "You provide detailed weather reports.",
   tools: [new OpenMeteoTool()],
-  llm: new GroqChatLLM(),
-  execution: { maxIterations: 3 },
+  llm: new OllamaChatModel("llama3.1"),
 });
 
 workflow.addAgent({
-  name: "Solver",
-  instructions:
-    "Your task is to provide the most useful final answer based on the assistants' responses which all are relevant. Ignore those where assistant do not know.",
-  llm: new GroqChatLLM(),
+  name: "DataSynthesizer",
+  role: "A meticulous and creative data synthesizer",
+  instructions: "You can combine disparate information into a final coherent summary.",
+  llm: new OllamaChatModel("llama3.1"),
 });
 
-const memory = new UnconstrainedMemory();
-
-await memory.add(
-  Message.of({
-    role: Role.USER,
-    text: "What is the capital of France and what is the current weather there?",
-    meta: { createdAt: new Date() },
-  }),
-);
-
-const { result } = await workflow.run(memory.messages).observe((emitter) => {
-  emitter.on("success", (data) => {
-    console.log(`-> ${data.step}`, data.response?.update?.finalAnswer ?? "-");
+const location = "Saint-Tropez";
+await workflow
+  .run([
+    {
+      prompt: `Provide a short history of ${location}.`,
+    },
+    {
+      prompt: `Provide a comprehensive weather summary for ${location} today.`,
+      expectedOutput:
+        "Essential weather details such as chance of rain, temperature and wind. Only report information that is available.",
+    },
+    {
+      prompt: `Summarize the historical and weather data for ${location}.`,
+      expectedOutput: `A paragraph that describes the history of ${location}, followed by the current weather conditions.`,
+    },
+  ])
+  .observe((emitter) => {
+    emitter.on("success", (data) => {
+      console.log(
+        `-> ${data.step} has been completed with the following outcome\n`,
+        data?.state.finalAnswer ?? "-",
+      );
+    });
   });
-});
-
-console.log(`Agent 🤖`, result.finalAnswer);
 ```
 
 ### Running the example

package/dist/adapters/openai/backend/client.cjs

@@ -15,11 +15,18 @@ class OpenAIClient extends client_cjs.BackendClient {
     const extraHeaders = env_cjs.parseEnv("OPENAI_API_HEADERS", zod.z.preprocess((value) => {
       return Object.fromEntries(String(value || "").split(",").filter((pair) => pair.includes("=")).map((pair) => pair.split("=")));
     }, zod.z.record(zod.z.string())));
+    const baseURL = this.settings?.baseURL || env_cjs.getEnv("OPENAI_API_ENDPOINT");
+    let compatibility = this.settings?.compatibility || env_cjs.getEnv("OPENAI_COMPATIBILITY_MODE");
+    if (baseURL && !compatibility) {
+      compatibility = "compatible";
+    } else if (!baseURL && !compatibility) {
+      compatibility = "strict";
+    }
     return openai.createOpenAI({
       ...this.settings,
-      compatibility: "compatible",
+      compatibility,
       apiKey: this.settings?.apiKey || env_cjs.getEnv("OPENAI_API_KEY"),
-      baseURL: this.settings?.baseURL || env_cjs.getEnv("OPENAI_API_ENDPOINT"),
+      baseURL,
       headers: {
         ...extraHeaders,
         ...this.settings?.headers

package/dist/adapters/openai/backend/client.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["client.ts"],"names":["OpenAIClient","BackendClient","create","extraHeaders","parseEnv","z","preprocess","value","Object","fromEntries","String","split","filter","pair","includes","map","record","string","createOpenAI","settings","compatibility","apiKey","getEnv","baseURL","headers"],"mappings":";;;;;;;;;AAuBO,MAAMA,qBAAqBC,wBAAAA,CAAAA;EAvBlC;;;EAwBYC,MAAyB,GAAA;AACjC,IAAA,MAAMC,eAAeC,gBACnB,CAAA,oBAAA,EACAC,KAAEC,CAAAA,UAAAA,CAAW,CAACC,KAAAA,KAAAA;AACZ,MAAOC,OAAAA,MAAAA,CAAOC,WACZC,CAAAA,MAAAA,CAAOH,KAAS,IAAA,EAAA,EACbI,KAAM,CAAA,GAAA,CACNC,CAAAA,MAAAA,CAAO,CAACC,IAAAA,KAASA,KAAKC,QAAS,CAAA,GAAA,CAAA,CAAA,CAC/BC,GAAI,CAAA,CAACF,SAASA,IAAKF,CAAAA,KAAAA,CAAM,GAAA,CAAA,CAAA,CAAA;AAEhC,KAAA,EAAGN,MAAEW,MAAOX,CAAAA,KAAAA,CAAEY,MAAM,EAAA,CAAA,CAAA,CAAA;AAGtB,IAAA,OAAOC,mBAAa,CAAA;AAClB,MAAA,GAAG,IAAKC,CAAAA,QAAAA;MACRC,aAAe,EAAA,YAAA;AACfC,MAAAA,MAAAA,EAAQ,IAAKF,CAAAA,QAAAA,EAAUE,MAAUC,IAAAA,cAAAA,CAAO,gBAAA,CAAA;AACxCC,MAAAA,OAAAA,EAAS,IAAKJ,CAAAA,QAAAA,EAAUI,OAAWD,IAAAA,cAAAA,CAAO,qBAAA,CAAA;MAC1CE,OAAS,EAAA;QACP,GAAGrB,YAAAA;AACH,QAAA,GAAG,KAAKgB,QAAUK,EAAAA;AACpB;KACF,CAAA;AACF;AACF","file":"client.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 { createOpenAI, OpenAIProvider, OpenAIProviderSettings } from \"@ai-sdk/openai\";\nimport { getEnv, parseEnv } from \"@/internals/env.js\";\nimport { z } from \"zod\";\nimport { BackendClient } from \"@/backend/client.js\";\n\nexport type OpenAIClientSettings = OpenAIProviderSettings;\n\nexport class OpenAIClient extends BackendClient<OpenAIClientSettings, OpenAIProvider> {\n  protected create(): OpenAIProvider {\n    const extraHeaders = parseEnv(\n      \"OPENAI_API_HEADERS\",\n      z.preprocess((value) => {\n        return Object.fromEntries(\n          String(value || \"\")\n            .split(\",\")\n            .filter((pair) => pair.includes(\"=\"))\n            .map((pair) => pair.split(\"=\")),\n        );\n      }, z.record(z.string())),\n    );\n\n    return createOpenAI({\n      ...this.settings,\n      compatibility: \"compatible\",\n      apiKey: this.settings?.apiKey || getEnv(\"OPENAI_API_KEY\"),\n      baseURL: this.settings?.baseURL || getEnv(\"OPENAI_API_ENDPOINT\"),\n      headers: {\n        ...extraHeaders,\n        ...this.settings?.headers,\n      },\n    });\n  }\n}\n"]}
+{"version":3,"sources":["client.ts"],"names":["OpenAIClient","BackendClient","create","extraHeaders","parseEnv","z","preprocess","value","Object","fromEntries","String","split","filter","pair","includes","map","record","string","baseURL","settings","getEnv","compatibility","createOpenAI","apiKey","headers"],"mappings":";;;;;;;;;AAuBO,MAAMA,qBAAqBC,wBAAAA,CAAAA;EAvBlC;;;EAwBYC,MAAyB,GAAA;AACjC,IAAA,MAAMC,eAAeC,gBACnB,CAAA,oBAAA,EACAC,KAAEC,CAAAA,UAAAA,CAAW,CAACC,KAAAA,KAAAA;AACZ,MAAOC,OAAAA,MAAAA,CAAOC,WACZC,CAAAA,MAAAA,CAAOH,KAAS,IAAA,EAAA,EACbI,KAAM,CAAA,GAAA,CACNC,CAAAA,MAAAA,CAAO,CAACC,IAAAA,KAASA,KAAKC,QAAS,CAAA,GAAA,CAAA,CAAA,CAC/BC,GAAI,CAAA,CAACF,SAASA,IAAKF,CAAAA,KAAAA,CAAM,GAAA,CAAA,CAAA,CAAA;AAEhC,KAAA,EAAGN,MAAEW,MAAOX,CAAAA,KAAAA,CAAEY,MAAM,EAAA,CAAA,CAAA,CAAA;AAGtB,IAAA,MAAMC,OAAU,GAAA,IAAA,CAAKC,QAAUD,EAAAA,OAAAA,IAAWE,eAAO,qBAAA,CAAA;AACjD,IAAA,IAAIC,aACF,GAAA,IAAA,CAAKF,QAAUE,EAAAA,aAAAA,IAAiBD,eAAO,2BAAA,CAAA;AACzC,IAAIF,IAAAA,OAAAA,IAAW,CAACG,aAAe,EAAA;AAC7BA,MAAgB,aAAA,GAAA,YAAA;KACP,MAAA,IAAA,CAACH,OAAW,IAAA,CAACG,aAAe,EAAA;AACrCA,MAAgB,aAAA,GAAA,QAAA;AAClB;AAEA,IAAA,OAAOC,mBAAa,CAAA;AAClB,MAAA,GAAG,IAAKH,CAAAA,QAAAA;AACRE,MAAAA,aAAAA;AACAE,MAAAA,MAAAA,EAAQ,IAAKJ,CAAAA,QAAAA,EAAUI,MAAUH,IAAAA,cAAAA,CAAO,gBAAA,CAAA;AACxCF,MAAAA,OAAAA;MACAM,OAAS,EAAA;QACP,GAAGrB,YAAAA;AACH,QAAA,GAAG,KAAKgB,QAAUK,EAAAA;AACpB;KACF,CAAA;AACF;AACF","file":"client.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 { createOpenAI, OpenAIProvider, OpenAIProviderSettings } from \"@ai-sdk/openai\";\nimport { getEnv, parseEnv } from \"@/internals/env.js\";\nimport { z } from \"zod\";\nimport { BackendClient } from \"@/backend/client.js\";\n\nexport type OpenAIClientSettings = OpenAIProviderSettings;\n\nexport class OpenAIClient extends BackendClient<OpenAIClientSettings, OpenAIProvider> {\n  protected create(): OpenAIProvider {\n    const extraHeaders = parseEnv(\n      \"OPENAI_API_HEADERS\",\n      z.preprocess((value) => {\n        return Object.fromEntries(\n          String(value || \"\")\n            .split(\",\")\n            .filter((pair) => pair.includes(\"=\"))\n            .map((pair) => pair.split(\"=\")),\n        );\n      }, z.record(z.string())),\n    );\n\n    const baseURL = this.settings?.baseURL || getEnv(\"OPENAI_API_ENDPOINT\");\n    let compatibility: string | undefined =\n      this.settings?.compatibility || getEnv(\"OPENAI_COMPATIBILITY_MODE\");\n    if (baseURL && !compatibility) {\n      compatibility = \"compatible\";\n    } else if (!baseURL && !compatibility) {\n      compatibility = \"strict\";\n    }\n\n    return createOpenAI({\n      ...this.settings,\n      compatibility: compatibility as \"strict\" | \"compatible\" | undefined,\n      apiKey: this.settings?.apiKey || getEnv(\"OPENAI_API_KEY\"),\n      baseURL,\n      headers: {\n        ...extraHeaders,\n        ...this.settings?.headers,\n      },\n    });\n  }\n}\n"]}

package/dist/adapters/openai/backend/client.js

@@ -13,11 +13,18 @@ class OpenAIClient extends BackendClient {
     const extraHeaders = parseEnv("OPENAI_API_HEADERS", z.preprocess((value) => {
       return Object.fromEntries(String(value || "").split(",").filter((pair) => pair.includes("=")).map((pair) => pair.split("=")));
     }, z.record(z.string())));
+    const baseURL = this.settings?.baseURL || getEnv("OPENAI_API_ENDPOINT");
+    let compatibility = this.settings?.compatibility || getEnv("OPENAI_COMPATIBILITY_MODE");
+    if (baseURL && !compatibility) {
+      compatibility = "compatible";
+    } else if (!baseURL && !compatibility) {
+      compatibility = "strict";
+    }
     return createOpenAI({
       ...this.settings,
-      compatibility: "compatible",
+      compatibility,
       apiKey: this.settings?.apiKey || getEnv("OPENAI_API_KEY"),
-      baseURL: this.settings?.baseURL || getEnv("OPENAI_API_ENDPOINT"),
+      baseURL,
       headers: {
         ...extraHeaders,
         ...this.settings?.headers

package/dist/adapters/openai/backend/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["client.ts"],"names":["OpenAIClient","BackendClient","create","extraHeaders","parseEnv","z","preprocess","value","Object","fromEntries","String","split","filter","pair","includes","map","record","string","createOpenAI","settings","compatibility","apiKey","getEnv","baseURL","headers"],"mappings":";;;;;;;AAuBO,MAAMA,qBAAqBC,aAAAA,CAAAA;EAvBlC;;;EAwBYC,MAAyB,GAAA;AACjC,IAAA,MAAMC,eAAeC,QACnB,CAAA,oBAAA,EACAC,CAAEC,CAAAA,UAAAA,CAAW,CAACC,KAAAA,KAAAA;AACZ,MAAOC,OAAAA,MAAAA,CAAOC,WACZC,CAAAA,MAAAA,CAAOH,KAAS,IAAA,EAAA,EACbI,KAAM,CAAA,GAAA,CACNC,CAAAA,MAAAA,CAAO,CAACC,IAAAA,KAASA,KAAKC,QAAS,CAAA,GAAA,CAAA,CAAA,CAC/BC,GAAI,CAAA,CAACF,SAASA,IAAKF,CAAAA,KAAAA,CAAM,GAAA,CAAA,CAAA,CAAA;AAEhC,KAAA,EAAGN,EAAEW,MAAOX,CAAAA,CAAAA,CAAEY,MAAM,EAAA,CAAA,CAAA,CAAA;AAGtB,IAAA,OAAOC,YAAa,CAAA;AAClB,MAAA,GAAG,IAAKC,CAAAA,QAAAA;MACRC,aAAe,EAAA,YAAA;AACfC,MAAAA,MAAAA,EAAQ,IAAKF,CAAAA,QAAAA,EAAUE,MAAUC,IAAAA,MAAAA,CAAO,gBAAA,CAAA;AACxCC,MAAAA,OAAAA,EAAS,IAAKJ,CAAAA,QAAAA,EAAUI,OAAWD,IAAAA,MAAAA,CAAO,qBAAA,CAAA;MAC1CE,OAAS,EAAA;QACP,GAAGrB,YAAAA;AACH,QAAA,GAAG,KAAKgB,QAAUK,EAAAA;AACpB;KACF,CAAA;AACF;AACF","file":"client.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 { createOpenAI, OpenAIProvider, OpenAIProviderSettings } from \"@ai-sdk/openai\";\nimport { getEnv, parseEnv } from \"@/internals/env.js\";\nimport { z } from \"zod\";\nimport { BackendClient } from \"@/backend/client.js\";\n\nexport type OpenAIClientSettings = OpenAIProviderSettings;\n\nexport class OpenAIClient extends BackendClient<OpenAIClientSettings, OpenAIProvider> {\n  protected create(): OpenAIProvider {\n    const extraHeaders = parseEnv(\n      \"OPENAI_API_HEADERS\",\n      z.preprocess((value) => {\n        return Object.fromEntries(\n          String(value || \"\")\n            .split(\",\")\n            .filter((pair) => pair.includes(\"=\"))\n            .map((pair) => pair.split(\"=\")),\n        );\n      }, z.record(z.string())),\n    );\n\n    return createOpenAI({\n      ...this.settings,\n      compatibility: \"compatible\",\n      apiKey: this.settings?.apiKey || getEnv(\"OPENAI_API_KEY\"),\n      baseURL: this.settings?.baseURL || getEnv(\"OPENAI_API_ENDPOINT\"),\n      headers: {\n        ...extraHeaders,\n        ...this.settings?.headers,\n      },\n    });\n  }\n}\n"]}
+{"version":3,"sources":["client.ts"],"names":["OpenAIClient","BackendClient","create","extraHeaders","parseEnv","z","preprocess","value","Object","fromEntries","String","split","filter","pair","includes","map","record","string","baseURL","settings","getEnv","compatibility","createOpenAI","apiKey","headers"],"mappings":";;;;;;;AAuBO,MAAMA,qBAAqBC,aAAAA,CAAAA;EAvBlC;;;EAwBYC,MAAyB,GAAA;AACjC,IAAA,MAAMC,eAAeC,QACnB,CAAA,oBAAA,EACAC,CAAEC,CAAAA,UAAAA,CAAW,CAACC,KAAAA,KAAAA;AACZ,MAAOC,OAAAA,MAAAA,CAAOC,WACZC,CAAAA,MAAAA,CAAOH,KAAS,IAAA,EAAA,EACbI,KAAM,CAAA,GAAA,CACNC,CAAAA,MAAAA,CAAO,CAACC,IAAAA,KAASA,KAAKC,QAAS,CAAA,GAAA,CAAA,CAAA,CAC/BC,GAAI,CAAA,CAACF,SAASA,IAAKF,CAAAA,KAAAA,CAAM,GAAA,CAAA,CAAA,CAAA;AAEhC,KAAA,EAAGN,EAAEW,MAAOX,CAAAA,CAAAA,CAAEY,MAAM,EAAA,CAAA,CAAA,CAAA;AAGtB,IAAA,MAAMC,OAAU,GAAA,IAAA,CAAKC,QAAUD,EAAAA,OAAAA,IAAWE,OAAO,qBAAA,CAAA;AACjD,IAAA,IAAIC,aACF,GAAA,IAAA,CAAKF,QAAUE,EAAAA,aAAAA,IAAiBD,OAAO,2BAAA,CAAA;AACzC,IAAIF,IAAAA,OAAAA,IAAW,CAACG,aAAe,EAAA;AAC7BA,MAAgB,aAAA,GAAA,YAAA;KACP,MAAA,IAAA,CAACH,OAAW,IAAA,CAACG,aAAe,EAAA;AACrCA,MAAgB,aAAA,GAAA,QAAA;AAClB;AAEA,IAAA,OAAOC,YAAa,CAAA;AAClB,MAAA,GAAG,IAAKH,CAAAA,QAAAA;AACRE,MAAAA,aAAAA;AACAE,MAAAA,MAAAA,EAAQ,IAAKJ,CAAAA,QAAAA,EAAUI,MAAUH,IAAAA,MAAAA,CAAO,gBAAA,CAAA;AACxCF,MAAAA,OAAAA;MACAM,OAAS,EAAA;QACP,GAAGrB,YAAAA;AACH,QAAA,GAAG,KAAKgB,QAAUK,EAAAA;AACpB;KACF,CAAA;AACF;AACF","file":"client.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 { createOpenAI, OpenAIProvider, OpenAIProviderSettings } from \"@ai-sdk/openai\";\nimport { getEnv, parseEnv } from \"@/internals/env.js\";\nimport { z } from \"zod\";\nimport { BackendClient } from \"@/backend/client.js\";\n\nexport type OpenAIClientSettings = OpenAIProviderSettings;\n\nexport class OpenAIClient extends BackendClient<OpenAIClientSettings, OpenAIProvider> {\n  protected create(): OpenAIProvider {\n    const extraHeaders = parseEnv(\n      \"OPENAI_API_HEADERS\",\n      z.preprocess((value) => {\n        return Object.fromEntries(\n          String(value || \"\")\n            .split(\",\")\n            .filter((pair) => pair.includes(\"=\"))\n            .map((pair) => pair.split(\"=\")),\n        );\n      }, z.record(z.string())),\n    );\n\n    const baseURL = this.settings?.baseURL || getEnv(\"OPENAI_API_ENDPOINT\");\n    let compatibility: string | undefined =\n      this.settings?.compatibility || getEnv(\"OPENAI_COMPATIBILITY_MODE\");\n    if (baseURL && !compatibility) {\n      compatibility = \"compatible\";\n    } else if (!baseURL && !compatibility) {\n      compatibility = \"strict\";\n    }\n\n    return createOpenAI({\n      ...this.settings,\n      compatibility: compatibility as \"strict\" | \"compatible\" | undefined,\n      apiKey: this.settings?.apiKey || getEnv(\"OPENAI_API_KEY\"),\n      baseURL,\n      headers: {\n        ...extraHeaders,\n        ...this.settings?.headers,\n      },\n    });\n  }\n}\n"]}

package/dist/agents/base.cjs

@@ -3,9 +3,6 @@
 var errors_cjs = require('../errors.cjs');
 var serializable_cjs = require('../internals/serializable.cjs');
 var context_cjs = require('../context.cjs');
-var createTelemetryMiddleware_cjs = require('../instrumentation/create-telemetry-middleware.cjs');
-var config_cjs = require('../instrumentation/config.cjs');
-var remeda = require('remeda');
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -44,7 +41,7 @@ class BaseAgent extends serializable_cjs.Serializable {
       } finally {
         this.isRunning = false;
       }
-    }).middleware(config_cjs.INSTRUMENTATION_ENABLED ? createTelemetryMiddleware_cjs.createTelemetryMiddleware() : remeda.doNothing());
+    });
   }
   destroy() {
     this.emitter.destroy();

package/dist/agents/base.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["base.ts"],"names":["AgentError","FrameworkError","BaseAgent","Serializable","isRunning","run","input","options","RunContext","enter","signal","params","context","_run","e","middleware","INSTRUMENTATION_ENABLED","createTelemetryMiddleware","doNothing","destroy","emitter","meta","name","constructor","description","tools","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":";;;;;;;;;;;AA0BO,MAAMA,mBAAmBC,yBAAAA,CAAAA;EA1BhC;;;AA0BgD;AAMzC,MAAeC,kBAIZC,6BAAAA,CAAAA;EApCV;;;EAqCYC,SAAY,GAAA,KAAA;EAIfC,GACF,CAAA,GAAA,CAACC,KAAOC,EAAAA,OAAAA,CAGX,EAAA;AACA,IAAA,IAAI,KAAKH,SAAW,EAAA;AAClB,MAAM,MAAA,IAAIJ,WAAW,2BAAA,CAAA;AACvB;AAEA,IAAOQ,OAAAA,sBAAAA,CAAWC,MAChB,IACA,EAAA;AAAEC,MAAAA,MAAAA,EAAQH,OAASG,EAAAA,MAAAA;MAAQC,MAAQ,EAAA;AAACL,QAAAA,KAAAA;AAAOC,QAAAA;;AAAkB,KAAA,EAC7D,OAAOK,OAAAA,KAAAA;AACL,MAAI,IAAA;AACF,QAAA,IAAA,CAAKR,SAAY,GAAA,IAAA;AAEjB,QAAA,OAAO,MAAM,IAAA,CAAKS,IAAKP,CAAAA,KAAAA,EAAOC,SAASK,OAAAA,CAAAA;AACzC,OAAA,CAAA,OAASE,CAAG,EAAA;AACV,QAAA,IAAIA,aAAad,UAAY,EAAA;AAC3B,UAAMc,MAAAA,CAAAA;SACD,MAAA;AACL,UAAM,MAAA,IAAId,WAAW,CAAuC,mCAAA,CAAA,EAAA;AAACc,YAAAA;AAAE,WAAA,CAAA;AACjE;OACF,SAAA;AACE,QAAA,IAAA,CAAKV,SAAY,GAAA,KAAA;AACnB;AACF,KAAA,EACAW,UAAWC,CAAAA,kCAAAA,GAA0BC,uDAAAA,EAAAA,GAA8BC,kBAAAA,CAAAA;AACvE;EAQAC,OAAU,GAAA;AACR,IAAA,IAAA,CAAKC,QAAQD,OAAO,EAAA;AACtB;AAKA,EAAA,IAAWE,IAAkB,GAAA;AAC3B,IAAO,OAAA;MACLC,IAAM,EAAA,IAAA,CAAKC,YAAYD,IAAQ,IAAA,WAAA;MAC/BE,WAAa,EAAA,EAAA;AACbC,MAAAA,KAAAA,EAAO;AACT,KAAA;AACF;EAEAC,cAAiB,GAAA;AACf,IAAO,OAAA;MAAEtB,SAAW,EAAA,KAAA;AAAOgB,MAAAA,OAAAA,EAAS,IAAKA,CAAAA;AAAQ,KAAA;AACnD;AAEAO,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"base.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { FrameworkError } from \"@/errors.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\nimport { GetRunContext, RunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { createTelemetryMiddleware } from \"@/instrumentation/create-telemetry-middleware.js\";\nimport { INSTRUMENTATION_ENABLED } from \"@/instrumentation/config.js\";\nimport { doNothing } from \"remeda\";\nimport { BaseMemory } from \"@/memory/base.js\";\n\nexport class AgentError extends FrameworkError {}\n\nexport interface BaseAgentRunOptions {\n  signal?: AbortSignal;\n}\n\nexport abstract class BaseAgent<\n  TInput,\n  TOutput,\n  TOptions extends BaseAgentRunOptions = BaseAgentRunOptions,\n> extends Serializable {\n  protected isRunning = false;\n\n  public abstract readonly emitter: Emitter<unknown>;\n\n  public run(\n    ...[input, options]: Partial<TOptions> extends TOptions\n      ? [input: TInput, options?: TOptions]\n      : [input: TInput, options: TOptions]\n  ) {\n    if (this.isRunning) {\n      throw new AgentError(\"Agent is already running!\");\n    }\n\n    return RunContext.enter(\n      this,\n      { signal: options?.signal, params: [input, options] as const },\n      async (context) => {\n        try {\n          this.isRunning = true;\n          // @ts-expect-error\n          return await this._run(input, options, context);\n        } catch (e) {\n          if (e instanceof AgentError) {\n            throw e;\n          } else {\n            throw new AgentError(`The Agent has encountered an error.`, [e]);\n          }\n        } finally {\n          this.isRunning = false;\n        }\n      },\n    ).middleware(INSTRUMENTATION_ENABLED ? createTelemetryMiddleware() : doNothing());\n  }\n\n  protected abstract _run(\n    input: TInput,\n    options: TOptions,\n    run: GetRunContext<typeof this>,\n  ): Promise<TOutput>;\n\n  destroy() {\n    this.emitter.destroy();\n  }\n\n  public abstract set memory(memory: BaseMemory);\n  public abstract get memory(): BaseMemory;\n\n  public get meta(): AgentMeta {\n    return {\n      name: this.constructor.name ?? \"BaseAgent\",\n      description: \"\",\n      tools: [],\n    };\n  }\n\n  createSnapshot() {\n    return { isRunning: false, emitter: this.emitter };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}
+{"version":3,"sources":["base.ts"],"names":["AgentError","FrameworkError","BaseAgent","Serializable","isRunning","run","input","options","RunContext","enter","signal","params","context","_run","e","destroy","emitter","meta","name","constructor","description","tools","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":";;;;;;;;AAuBO,MAAMA,mBAAmBC,yBAAAA,CAAAA;EAvBhC;;;AAuBgD;AAMzC,MAAeC,kBAIZC,6BAAAA,CAAAA;EAjCV;;;EAkCYC,SAAY,GAAA,KAAA;EAIfC,GACF,CAAA,GAAA,CAACC,KAAOC,EAAAA,OAAAA,CAGX,EAAA;AACA,IAAA,IAAI,KAAKH,SAAW,EAAA;AAClB,MAAM,MAAA,IAAIJ,WAAW,2BAAA,CAAA;AACvB;AAEA,IAAOQ,OAAAA,sBAAAA,CAAWC,MAChB,IACA,EAAA;AAAEC,MAAAA,MAAAA,EAAQH,OAASG,EAAAA,MAAAA;MAAQC,MAAQ,EAAA;AAACL,QAAAA,KAAAA;AAAOC,QAAAA;;AAAkB,KAAA,EAC7D,OAAOK,OAAAA,KAAAA;AACL,MAAI,IAAA;AACF,QAAA,IAAA,CAAKR,SAAY,GAAA,IAAA;AAEjB,QAAA,OAAO,MAAM,IAAA,CAAKS,IAAKP,CAAAA,KAAAA,EAAOC,SAASK,OAAAA,CAAAA;AACzC,OAAA,CAAA,OAASE,CAAG,EAAA;AACV,QAAA,IAAIA,aAAad,UAAY,EAAA;AAC3B,UAAMc,MAAAA,CAAAA;SACD,MAAA;AACL,UAAM,MAAA,IAAId,WAAW,CAAuC,mCAAA,CAAA,EAAA;AAACc,YAAAA;AAAE,WAAA,CAAA;AACjE;OACF,SAAA;AACE,QAAA,IAAA,CAAKV,SAAY,GAAA,KAAA;AACnB;KACF,CAAA;AAEJ;EAQAW,OAAU,GAAA;AACR,IAAA,IAAA,CAAKC,QAAQD,OAAO,EAAA;AACtB;AAKA,EAAA,IAAWE,IAAkB,GAAA;AAC3B,IAAO,OAAA;MACLC,IAAM,EAAA,IAAA,CAAKC,YAAYD,IAAQ,IAAA,WAAA;MAC/BE,WAAa,EAAA,EAAA;AACbC,MAAAA,KAAAA,EAAO;AACT,KAAA;AACF;EAEAC,cAAiB,GAAA;AACf,IAAO,OAAA;MAAElB,SAAW,EAAA,KAAA;AAAOY,MAAAA,OAAAA,EAAS,IAAKA,CAAAA;AAAQ,KAAA;AACnD;AAEAO,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"base.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { FrameworkError } from \"@/errors.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\nimport { GetRunContext, RunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\n\nexport class AgentError extends FrameworkError {}\n\nexport interface BaseAgentRunOptions {\n  signal?: AbortSignal;\n}\n\nexport abstract class BaseAgent<\n  TInput,\n  TOutput,\n  TOptions extends BaseAgentRunOptions = BaseAgentRunOptions,\n> extends Serializable {\n  protected isRunning = false;\n\n  public abstract readonly emitter: Emitter<unknown>;\n\n  public run(\n    ...[input, options]: Partial<TOptions> extends TOptions\n      ? [input: TInput, options?: TOptions]\n      : [input: TInput, options: TOptions]\n  ) {\n    if (this.isRunning) {\n      throw new AgentError(\"Agent is already running!\");\n    }\n\n    return RunContext.enter(\n      this,\n      { signal: options?.signal, params: [input, options] as const },\n      async (context) => {\n        try {\n          this.isRunning = true;\n          // @ts-expect-error\n          return await this._run(input, options, context);\n        } catch (e) {\n          if (e instanceof AgentError) {\n            throw e;\n          } else {\n            throw new AgentError(`The Agent has encountered an error.`, [e]);\n          }\n        } finally {\n          this.isRunning = false;\n        }\n      },\n    );\n  }\n\n  protected abstract _run(\n    input: TInput,\n    options: TOptions,\n    run: GetRunContext<typeof this>,\n  ): Promise<TOutput>;\n\n  destroy() {\n    this.emitter.destroy();\n  }\n\n  public abstract set memory(memory: BaseMemory);\n  public abstract get memory(): BaseMemory;\n\n  public get meta(): AgentMeta {\n    return {\n      name: this.constructor.name ?? \"BaseAgent\",\n      description: \"\",\n      tools: [],\n    };\n  }\n\n  createSnapshot() {\n    return { isRunning: false, emitter: this.emitter };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/agents/base.js

@@ -1,9 +1,6 @@
 import { FrameworkError } from '../errors.js';
 import { Serializable } from '../internals/serializable.js';
 import { RunContext } from '../context.js';
-import { createTelemetryMiddleware } from '../instrumentation/create-telemetry-middleware.js';
-import { INSTRUMENTATION_ENABLED } from '../instrumentation/config.js';
-import { doNothing } from 'remeda';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -42,7 +39,7 @@ class BaseAgent extends Serializable {
       } finally {
         this.isRunning = false;
       }
-    }).middleware(INSTRUMENTATION_ENABLED ? createTelemetryMiddleware() : doNothing());
+    });
   }
   destroy() {
     this.emitter.destroy();

package/dist/agents/base.js.map

@@ -1 +1 @@
-{"version":3,"sources":["base.ts"],"names":["AgentError","FrameworkError","BaseAgent","Serializable","isRunning","run","input","options","RunContext","enter","signal","params","context","_run","e","middleware","INSTRUMENTATION_ENABLED","createTelemetryMiddleware","doNothing","destroy","emitter","meta","name","constructor","description","tools","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":";;;;;;;;;AA0BO,MAAMA,mBAAmBC,cAAAA,CAAAA;EA1BhC;;;AA0BgD;AAMzC,MAAeC,kBAIZC,YAAAA,CAAAA;EApCV;;;EAqCYC,SAAY,GAAA,KAAA;EAIfC,GACF,CAAA,GAAA,CAACC,KAAOC,EAAAA,OAAAA,CAGX,EAAA;AACA,IAAA,IAAI,KAAKH,SAAW,EAAA;AAClB,MAAM,MAAA,IAAIJ,WAAW,2BAAA,CAAA;AACvB;AAEA,IAAOQ,OAAAA,UAAAA,CAAWC,MAChB,IACA,EAAA;AAAEC,MAAAA,MAAAA,EAAQH,OAASG,EAAAA,MAAAA;MAAQC,MAAQ,EAAA;AAACL,QAAAA,KAAAA;AAAOC,QAAAA;;AAAkB,KAAA,EAC7D,OAAOK,OAAAA,KAAAA;AACL,MAAI,IAAA;AACF,QAAA,IAAA,CAAKR,SAAY,GAAA,IAAA;AAEjB,QAAA,OAAO,MAAM,IAAA,CAAKS,IAAKP,CAAAA,KAAAA,EAAOC,SAASK,OAAAA,CAAAA;AACzC,OAAA,CAAA,OAASE,CAAG,EAAA;AACV,QAAA,IAAIA,aAAad,UAAY,EAAA;AAC3B,UAAMc,MAAAA,CAAAA;SACD,MAAA;AACL,UAAM,MAAA,IAAId,WAAW,CAAuC,mCAAA,CAAA,EAAA;AAACc,YAAAA;AAAE,WAAA,CAAA;AACjE;OACF,SAAA;AACE,QAAA,IAAA,CAAKV,SAAY,GAAA,KAAA;AACnB;AACF,KAAA,EACAW,UAAWC,CAAAA,uBAAAA,GAA0BC,yBAAAA,EAAAA,GAA8BC,WAAAA,CAAAA;AACvE;EAQAC,OAAU,GAAA;AACR,IAAA,IAAA,CAAKC,QAAQD,OAAO,EAAA;AACtB;AAKA,EAAA,IAAWE,IAAkB,GAAA;AAC3B,IAAO,OAAA;MACLC,IAAM,EAAA,IAAA,CAAKC,YAAYD,IAAQ,IAAA,WAAA;MAC/BE,WAAa,EAAA,EAAA;AACbC,MAAAA,KAAAA,EAAO;AACT,KAAA;AACF;EAEAC,cAAiB,GAAA;AACf,IAAO,OAAA;MAAEtB,SAAW,EAAA,KAAA;AAAOgB,MAAAA,OAAAA,EAAS,IAAKA,CAAAA;AAAQ,KAAA;AACnD;AAEAO,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"base.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { FrameworkError } from \"@/errors.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\nimport { GetRunContext, RunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { createTelemetryMiddleware } from \"@/instrumentation/create-telemetry-middleware.js\";\nimport { INSTRUMENTATION_ENABLED } from \"@/instrumentation/config.js\";\nimport { doNothing } from \"remeda\";\nimport { BaseMemory } from \"@/memory/base.js\";\n\nexport class AgentError extends FrameworkError {}\n\nexport interface BaseAgentRunOptions {\n  signal?: AbortSignal;\n}\n\nexport abstract class BaseAgent<\n  TInput,\n  TOutput,\n  TOptions extends BaseAgentRunOptions = BaseAgentRunOptions,\n> extends Serializable {\n  protected isRunning = false;\n\n  public abstract readonly emitter: Emitter<unknown>;\n\n  public run(\n    ...[input, options]: Partial<TOptions> extends TOptions\n      ? [input: TInput, options?: TOptions]\n      : [input: TInput, options: TOptions]\n  ) {\n    if (this.isRunning) {\n      throw new AgentError(\"Agent is already running!\");\n    }\n\n    return RunContext.enter(\n      this,\n      { signal: options?.signal, params: [input, options] as const },\n      async (context) => {\n        try {\n          this.isRunning = true;\n          // @ts-expect-error\n          return await this._run(input, options, context);\n        } catch (e) {\n          if (e instanceof AgentError) {\n            throw e;\n          } else {\n            throw new AgentError(`The Agent has encountered an error.`, [e]);\n          }\n        } finally {\n          this.isRunning = false;\n        }\n      },\n    ).middleware(INSTRUMENTATION_ENABLED ? createTelemetryMiddleware() : doNothing());\n  }\n\n  protected abstract _run(\n    input: TInput,\n    options: TOptions,\n    run: GetRunContext<typeof this>,\n  ): Promise<TOutput>;\n\n  destroy() {\n    this.emitter.destroy();\n  }\n\n  public abstract set memory(memory: BaseMemory);\n  public abstract get memory(): BaseMemory;\n\n  public get meta(): AgentMeta {\n    return {\n      name: this.constructor.name ?? \"BaseAgent\",\n      description: \"\",\n      tools: [],\n    };\n  }\n\n  createSnapshot() {\n    return { isRunning: false, emitter: this.emitter };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}
+{"version":3,"sources":["base.ts"],"names":["AgentError","FrameworkError","BaseAgent","Serializable","isRunning","run","input","options","RunContext","enter","signal","params","context","_run","e","destroy","emitter","meta","name","constructor","description","tools","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":";;;;;;AAuBO,MAAMA,mBAAmBC,cAAAA,CAAAA;EAvBhC;;;AAuBgD;AAMzC,MAAeC,kBAIZC,YAAAA,CAAAA;EAjCV;;;EAkCYC,SAAY,GAAA,KAAA;EAIfC,GACF,CAAA,GAAA,CAACC,KAAOC,EAAAA,OAAAA,CAGX,EAAA;AACA,IAAA,IAAI,KAAKH,SAAW,EAAA;AAClB,MAAM,MAAA,IAAIJ,WAAW,2BAAA,CAAA;AACvB;AAEA,IAAOQ,OAAAA,UAAAA,CAAWC,MAChB,IACA,EAAA;AAAEC,MAAAA,MAAAA,EAAQH,OAASG,EAAAA,MAAAA;MAAQC,MAAQ,EAAA;AAACL,QAAAA,KAAAA;AAAOC,QAAAA;;AAAkB,KAAA,EAC7D,OAAOK,OAAAA,KAAAA;AACL,MAAI,IAAA;AACF,QAAA,IAAA,CAAKR,SAAY,GAAA,IAAA;AAEjB,QAAA,OAAO,MAAM,IAAA,CAAKS,IAAKP,CAAAA,KAAAA,EAAOC,SAASK,OAAAA,CAAAA;AACzC,OAAA,CAAA,OAASE,CAAG,EAAA;AACV,QAAA,IAAIA,aAAad,UAAY,EAAA;AAC3B,UAAMc,MAAAA,CAAAA;SACD,MAAA;AACL,UAAM,MAAA,IAAId,WAAW,CAAuC,mCAAA,CAAA,EAAA;AAACc,YAAAA;AAAE,WAAA,CAAA;AACjE;OACF,SAAA;AACE,QAAA,IAAA,CAAKV,SAAY,GAAA,KAAA;AACnB;KACF,CAAA;AAEJ;EAQAW,OAAU,GAAA;AACR,IAAA,IAAA,CAAKC,QAAQD,OAAO,EAAA;AACtB;AAKA,EAAA,IAAWE,IAAkB,GAAA;AAC3B,IAAO,OAAA;MACLC,IAAM,EAAA,IAAA,CAAKC,YAAYD,IAAQ,IAAA,WAAA;MAC/BE,WAAa,EAAA,EAAA;AACbC,MAAAA,KAAAA,EAAO;AACT,KAAA;AACF;EAEAC,cAAiB,GAAA;AACf,IAAO,OAAA;MAAElB,SAAW,EAAA,KAAA;AAAOY,MAAAA,OAAAA,EAAS,IAAKA,CAAAA;AAAQ,KAAA;AACnD;AAEAO,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"base.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { FrameworkError } from \"@/errors.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\nimport { GetRunContext, RunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\n\nexport class AgentError extends FrameworkError {}\n\nexport interface BaseAgentRunOptions {\n  signal?: AbortSignal;\n}\n\nexport abstract class BaseAgent<\n  TInput,\n  TOutput,\n  TOptions extends BaseAgentRunOptions = BaseAgentRunOptions,\n> extends Serializable {\n  protected isRunning = false;\n\n  public abstract readonly emitter: Emitter<unknown>;\n\n  public run(\n    ...[input, options]: Partial<TOptions> extends TOptions\n      ? [input: TInput, options?: TOptions]\n      : [input: TInput, options: TOptions]\n  ) {\n    if (this.isRunning) {\n      throw new AgentError(\"Agent is already running!\");\n    }\n\n    return RunContext.enter(\n      this,\n      { signal: options?.signal, params: [input, options] as const },\n      async (context) => {\n        try {\n          this.isRunning = true;\n          // @ts-expect-error\n          return await this._run(input, options, context);\n        } catch (e) {\n          if (e instanceof AgentError) {\n            throw e;\n          } else {\n            throw new AgentError(`The Agent has encountered an error.`, [e]);\n          }\n        } finally {\n          this.isRunning = false;\n        }\n      },\n    );\n  }\n\n  protected abstract _run(\n    input: TInput,\n    options: TOptions,\n    run: GetRunContext<typeof this>,\n  ): Promise<TOutput>;\n\n  destroy() {\n    this.emitter.destroy();\n  }\n\n  public abstract set memory(memory: BaseMemory);\n  public abstract get memory(): BaseMemory;\n\n  public get meta(): AgentMeta {\n    return {\n      name: this.constructor.name ?? \"BaseAgent\",\n      description: \"\",\n      tools: [],\n    };\n  }\n\n  createSnapshot() {\n    return { isRunning: false, emitter: this.emitter };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/agents/react/prompts.d.cts

@@ -39,12 +39,12 @@ declare const ReActAgentSystemPrompt: PromptTemplate<z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>, "many">;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    instructions: string;
     tools: z.objectOutputType<{
         name: z.ZodString;
         description: z.ZodString;
         schema: z.ZodString;
     }, z.ZodTypeAny, "passthrough">[];
+    instructions: string;
     createdAt?: string | null | undefined;
 }, {
     tools: z.objectInputType<{
@@ -52,8 +52,8 @@ declare const ReActAgentSystemPrompt: PromptTemplate<z.ZodObject<{
         description: z.ZodString;
         schema: z.ZodString;
     }, z.ZodTypeAny, "passthrough">[];
-    createdAt?: string | null | undefined;
     instructions?: string | undefined;
+    createdAt?: string | null | undefined;
 }>>;
 declare const ReActAgentAssistantPrompt: PromptTemplate<z.ZodObject<{
     thought: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -62,14 +62,14 @@ declare const ReActAgentAssistantPrompt: PromptTemplate<z.ZodObject<{
     toolOutput: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     finalAnswer: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    toolName?: string[] | undefined;
     thought?: string[] | undefined;
+    toolName?: string[] | undefined;
     toolInput?: string[] | undefined;
     toolOutput?: string[] | undefined;
     finalAnswer?: string[] | undefined;
 }, {
-    toolName?: string[] | undefined;
     thought?: string[] | undefined;
+    toolName?: string[] | undefined;
     toolInput?: string[] | undefined;
     toolOutput?: string[] | undefined;
     finalAnswer?: string[] | undefined;

package/dist/agents/react/prompts.d.ts

@@ -39,12 +39,12 @@ declare const ReActAgentSystemPrompt: PromptTemplate<z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>, "many">;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    instructions: string;
     tools: z.objectOutputType<{
         name: z.ZodString;
         description: z.ZodString;
         schema: z.ZodString;
     }, z.ZodTypeAny, "passthrough">[];
+    instructions: string;
     createdAt?: string | null | undefined;
 }, {
     tools: z.objectInputType<{
@@ -52,8 +52,8 @@ declare const ReActAgentSystemPrompt: PromptTemplate<z.ZodObject<{
         description: z.ZodString;
         schema: z.ZodString;
     }, z.ZodTypeAny, "passthrough">[];
-    createdAt?: string | null | undefined;
     instructions?: string | undefined;
+    createdAt?: string | null | undefined;
 }>>;
 declare const ReActAgentAssistantPrompt: PromptTemplate<z.ZodObject<{
     thought: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -62,14 +62,14 @@ declare const ReActAgentAssistantPrompt: PromptTemplate<z.ZodObject<{
     toolOutput: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     finalAnswer: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    toolName?: string[] | undefined;
     thought?: string[] | undefined;
+    toolName?: string[] | undefined;
     toolInput?: string[] | undefined;
     toolOutput?: string[] | undefined;
     finalAnswer?: string[] | undefined;
 }, {
-    toolName?: string[] | undefined;
     thought?: string[] | undefined;
+    toolName?: string[] | undefined;
     toolInput?: string[] | undefined;
     toolOutput?: string[] | undefined;
     finalAnswer?: string[] | undefined;

package/dist/agents/react/runners/deep-think/prompts.d.cts

@@ -28,14 +28,14 @@ declare const DeepThinkReActAgentAssistantPrompt: PromptTemplate<zod.ZodObject<{
     toolOutput: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
     finalAnswer: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
 }, "strip", zod.ZodTypeAny, {
-    toolName?: string[] | undefined;
     thought?: string[] | undefined;
+    toolName?: string[] | undefined;
     toolInput?: string[] | undefined;
     toolOutput?: string[] | undefined;
     finalAnswer?: string[] | undefined;
 }, {
-    toolName?: string[] | undefined;
     thought?: string[] | undefined;
+    toolName?: string[] | undefined;
     toolInput?: string[] | undefined;
     toolOutput?: string[] | undefined;
     finalAnswer?: string[] | undefined;
@@ -57,12 +57,12 @@ declare const DeepThinkReActAgentSystemPrompt: PromptTemplate<zod.ZodObject<{
     }, zod.ZodTypeAny, "passthrough">>, "many">;
     createdAt: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
 }, "strip", zod.ZodTypeAny, {
-    instructions: string;
     tools: zod.objectOutputType<{
         name: zod.ZodString;
         description: zod.ZodString;
         schema: zod.ZodString;
     }, zod.ZodTypeAny, "passthrough">[];
+    instructions: string;
     createdAt?: string | null | undefined;
 }, {
     tools: zod.objectInputType<{
@@ -70,8 +70,8 @@ declare const DeepThinkReActAgentSystemPrompt: PromptTemplate<zod.ZodObject<{
         description: zod.ZodString;
         schema: zod.ZodString;
     }, zod.ZodTypeAny, "passthrough">[];
-    createdAt?: string | null | undefined;
     instructions?: string | undefined;
+    createdAt?: string | null | undefined;
 }>>;
 declare const DeepThinkReActAgentSchemaErrorPrompt: PromptTemplate<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
 declare const DeepThinkReActAgentUserPrompt: PromptTemplate<zod.ZodObject<{

package/dist/agents/react/runners/deep-think/prompts.d.ts

@@ -28,14 +28,14 @@ declare const DeepThinkReActAgentAssistantPrompt: PromptTemplate<zod.ZodObject<{
     toolOutput: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
     finalAnswer: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
 }, "strip", zod.ZodTypeAny, {
-    toolName?: string[] | undefined;
     thought?: string[] | undefined;
+    toolName?: string[] | undefined;
     toolInput?: string[] | undefined;
     toolOutput?: string[] | undefined;
     finalAnswer?: string[] | undefined;
 }, {
-    toolName?: string[] | undefined;
     thought?: string[] | undefined;
+    toolName?: string[] | undefined;
     toolInput?: string[] | undefined;
     toolOutput?: string[] | undefined;
     finalAnswer?: string[] | undefined;
@@ -57,12 +57,12 @@ declare const DeepThinkReActAgentSystemPrompt: PromptTemplate<zod.ZodObject<{
     }, zod.ZodTypeAny, "passthrough">>, "many">;
     createdAt: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
 }, "strip", zod.ZodTypeAny, {
-    instructions: string;
     tools: zod.objectOutputType<{
         name: zod.ZodString;
         description: zod.ZodString;
         schema: zod.ZodString;
     }, zod.ZodTypeAny, "passthrough">[];
+    instructions: string;
     createdAt?: string | null | undefined;
 }, {
     tools: zod.objectInputType<{
@@ -70,8 +70,8 @@ declare const DeepThinkReActAgentSystemPrompt: PromptTemplate<zod.ZodObject<{
         description: zod.ZodString;
         schema: zod.ZodString;
     }, zod.ZodTypeAny, "passthrough">[];
-    createdAt?: string | null | undefined;
     instructions?: string | undefined;
+    createdAt?: string | null | undefined;
 }>>;
 declare const DeepThinkReActAgentSchemaErrorPrompt: PromptTemplate<zod.ZodObject<{}, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{}, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{}, zod.ZodTypeAny, "passthrough">>>;
 declare const DeepThinkReActAgentUserPrompt: PromptTemplate<zod.ZodObject<{

package/dist/agents/react/runners/deep-think/runner.d.cts

@@ -51,12 +51,12 @@ declare class DeepThinkRunner extends DefaultRunner {
             }, z.ZodTypeAny, "passthrough">>, "many">;
             createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            instructions: string;
             tools: z.objectOutputType<{
                 name: z.ZodString;
                 description: z.ZodString;
                 schema: z.ZodString;
             }, z.ZodTypeAny, "passthrough">[];
+            instructions: string;
             createdAt?: string | null | undefined;
         }, {
             tools: z.objectInputType<{
@@ -64,8 +64,8 @@ declare class DeepThinkRunner extends DefaultRunner {
                 description: z.ZodString;
                 schema: z.ZodString;
             }, z.ZodTypeAny, "passthrough">[];
-            createdAt?: string | null | undefined;
             instructions?: string | undefined;
+            createdAt?: string | null | undefined;
         }>>;
         assistant: PromptTemplate<z.ZodObject<{
             thought: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -74,14 +74,14 @@ declare class DeepThinkRunner extends DefaultRunner {
             toolOutput: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             finalAnswer: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
-            toolName?: string[] | undefined;
             thought?: string[] | undefined;
+            toolName?: string[] | undefined;
             toolInput?: string[] | undefined;
             toolOutput?: string[] | undefined;
             finalAnswer?: string[] | undefined;
         }, {
-            toolName?: string[] | undefined;
             thought?: string[] | undefined;
+            toolName?: string[] | undefined;
             toolInput?: string[] | undefined;
             toolOutput?: string[] | undefined;
             finalAnswer?: string[] | undefined;

package/dist/agents/react/runners/deep-think/runner.d.ts

@@ -51,12 +51,12 @@ declare class DeepThinkRunner extends DefaultRunner {
             }, z.ZodTypeAny, "passthrough">>, "many">;
             createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            instructions: string;
             tools: z.objectOutputType<{
                 name: z.ZodString;
                 description: z.ZodString;
                 schema: z.ZodString;
             }, z.ZodTypeAny, "passthrough">[];
+            instructions: string;
             createdAt?: string | null | undefined;
         }, {
             tools: z.objectInputType<{
@@ -64,8 +64,8 @@ declare class DeepThinkRunner extends DefaultRunner {
                 description: z.ZodString;
                 schema: z.ZodString;
             }, z.ZodTypeAny, "passthrough">[];
-            createdAt?: string | null | undefined;
             instructions?: string | undefined;
+            createdAt?: string | null | undefined;
         }>>;
         assistant: PromptTemplate<z.ZodObject<{
             thought: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -74,14 +74,14 @@ declare class DeepThinkRunner extends DefaultRunner {
             toolOutput: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             finalAnswer: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
-            toolName?: string[] | undefined;
             thought?: string[] | undefined;
+            toolName?: string[] | undefined;
             toolInput?: string[] | undefined;
             toolOutput?: string[] | undefined;
             finalAnswer?: string[] | undefined;
         }, {
-            toolName?: string[] | undefined;
             thought?: string[] | undefined;
+            toolName?: string[] | undefined;
             toolInput?: string[] | undefined;
             toolOutput?: string[] | undefined;
             finalAnswer?: string[] | undefined;

package/dist/agents/react/runners/default/runner.d.cts

@@ -51,12 +51,12 @@ declare class DefaultRunner extends BaseRunner {
             }, z.ZodTypeAny, "passthrough">>, "many">;
             createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            instructions: string;
             tools: z.objectOutputType<{
                 name: z.ZodString;
                 description: z.ZodString;
                 schema: z.ZodString;
             }, z.ZodTypeAny, "passthrough">[];
+            instructions: string;
             createdAt?: string | null | undefined;
         }, {
             tools: z.objectInputType<{
@@ -64,8 +64,8 @@ declare class DefaultRunner extends BaseRunner {
                 description: z.ZodString;
                 schema: z.ZodString;
             }, z.ZodTypeAny, "passthrough">[];
-            createdAt?: string | null | undefined;
             instructions?: string | undefined;
+            createdAt?: string | null | undefined;
         }>>;
         assistant: PromptTemplate<z.ZodObject<{
             thought: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -74,14 +74,14 @@ declare class DefaultRunner extends BaseRunner {
             toolOutput: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             finalAnswer: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
-            toolName?: string[] | undefined;
             thought?: string[] | undefined;
+            toolName?: string[] | undefined;
             toolInput?: string[] | undefined;
             toolOutput?: string[] | undefined;
             finalAnswer?: string[] | undefined;
         }, {
-            toolName?: string[] | undefined;
             thought?: string[] | undefined;
+            toolName?: string[] | undefined;
             toolInput?: string[] | undefined;
             toolOutput?: string[] | undefined;
             finalAnswer?: string[] | undefined;