beeai-framework 0.1.2

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

@@ -0,0 +1,148 @@
+import { PromptTemplate } from '../../template.js';
+import { z } from 'zod';
+import '../../errors.js';
+import '../../internals/types.js';
+import '../../internals/helpers/guards.js';
+import '../../internals/serializable.js';
+import 'ajv';
+
+/**
+ * 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 BeeSystemPrompt: PromptTemplate<z.ZodObject<{
+    instructions: z.ZodDefault<z.ZodString>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        schema: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        name: z.ZodString;
+        description: z.ZodString;
+        schema: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        name: z.ZodString;
+        description: z.ZodString;
+        schema: z.ZodString;
+    }, 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">[];
+    createdAt?: string | null | undefined;
+}, {
+    tools: z.objectInputType<{
+        name: z.ZodString;
+        description: z.ZodString;
+        schema: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">[];
+    createdAt?: string | null | undefined;
+    instructions?: string | undefined;
+}>>;
+declare const BeeAssistantPrompt: PromptTemplate<z.ZodObject<{
+    thought: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    toolName: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    toolInput: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    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;
+    toolInput?: string[] | undefined;
+    toolOutput?: string[] | undefined;
+    finalAnswer?: string[] | undefined;
+}, {
+    toolName?: string[] | undefined;
+    thought?: string[] | undefined;
+    toolInput?: string[] | undefined;
+    toolOutput?: string[] | undefined;
+    finalAnswer?: string[] | undefined;
+}>>;
+declare const BeeUserPrompt: PromptTemplate<z.ZodObject<{
+    input: z.ZodString;
+    meta: z.ZodOptional<z.ZodObject<{
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    input: z.ZodString;
+    meta: z.ZodOptional<z.ZodObject<{
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    input: z.ZodString;
+    meta: z.ZodOptional<z.ZodObject<{
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">>>;
+declare const BeeUserEmptyPrompt: PromptTemplate<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+declare const BeeToolErrorPrompt: PromptTemplate<z.ZodObject<{
+    reason: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    reason: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    reason: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>>;
+declare const BeeToolInputErrorPrompt: PromptTemplate<z.ZodObject<{
+    reason: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    reason: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    reason: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>>;
+declare const BeeToolNoResultsPrompt: PromptTemplate<z.ZodRecord<z.ZodString, z.ZodAny>>;
+declare const BeeToolNotFoundPrompt: PromptTemplate<z.ZodObject<{
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        name: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, z.ZodTypeAny, "passthrough">>>;
+declare const BeeSchemaErrorPrompt: PromptTemplate<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+
+export { BeeAssistantPrompt, BeeSchemaErrorPrompt, BeeSystemPrompt, BeeToolErrorPrompt, BeeToolInputErrorPrompt, BeeToolNoResultsPrompt, BeeToolNotFoundPrompt, BeeUserEmptyPrompt, BeeUserPrompt };

package/dist/agents/bee/prompts.js

@@ -0,0 +1,166 @@
+import { PromptTemplate } from '../../template.js';
+import { z } from 'zod';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const BeeSystemPrompt = new PromptTemplate({
+  schema: z.object({
+    instructions: z.string().default("You are a helpful assistant."),
+    tools: z.array(z.object({
+      name: z.string().min(1),
+      description: z.string().min(1),
+      schema: z.string().min(1)
+    }).passthrough()),
+    createdAt: z.string().datetime().nullish()
+  }),
+  template: `# Available functions
+{{#tools.length}}
+You can only use the following functions. Always use all required parameters.
+
+{{#tools}}
+Function Name: {{name}}
+Description: {{description}}
+Parameters: {{schema}}
+
+{{/tools}}
+{{/tools.length}}
+{{^tools.length}}
+No functions are available.
+
+{{/tools.length}}
+# Communication structure
+You communicate only in instruction lines. The format is: "Instruction: expected output
+". You must only use these instruction lines and must not enter empty lines between them. Each instruction must start on a new line.
+{{#tools.length}}
+You must skip the instruction lines Function Name, Function Input and Function Output if no function calling is required.
+{{/tools.length}}
+
+Message: User's message. You never use this instruction line.
+{{^tools.length}}
+Thought: A single-line plan of how to answer the user's message, including an explanation of the reasoning behind it. It must be immediately followed by Final Answer.
+{{/tools.length}}
+{{#tools.length}}
+Thought: A single-line step-by-step plan of how to answer the user's message, including an explanation of the reasoning behind it. You can use the available functions defined above. This instruction line must be immediately followed by Function Name if one of the available functions defined above needs to be called, or by Final Answer. Do not provide the answer here.
+Function Name: Name of the function. This instruction line must be immediately followed by Function Input.
+Function Input: Function parameters. Empty object is a valid parameter.
+Function Output: Output of the function in JSON format.
+Thought: Continue your thinking process.
+{{/tools.length}}
+Final Answer: Answer the user or ask for more information or clarification. It must always be preceded by Thought.
+
+## Examples
+Message: Can you translate "How are you" into French?
+Thought: The user wants to translate a text into French. I can do that.
+Final Answer: Comment vas-tu?
+
+# Instructions
+User can only see the Final Answer, all answers must be provided there.
+{{^tools.length}}
+You must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by Final Answer.
+{{/tools.length}}
+{{#tools.length}}
+You must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by either Function Name or Final Answer.
+You must use Functions to retrieve factual or historical information to answer the message.
+{{/tools.length}}
+If the user suggests using a function that is not available, answer that the function is not available. You can suggest alternatives if appropriate.
+When the message is unclear or you need more information from the user, ask in Final Answer.
+
+# Your capabilities
+Prefer to use these capabilities over functions.
+- You understand these languages: English, Spanish, French.
+- You can translate, analyze, summarize, even long documents.
+
+# Notes
+- If you don't know the answer, say that you don't know.
+- The current time and date in ISO format can be found in the last message.
+- When answering the user, use friendly formats for time and date.
+- Use markdown syntax for formatting code snippets, links, JSON, tables, images, files.
+- Sometimes, things don't go as planned. Functions may not provide useful information on the first few tries. You should always try a few different approaches before declaring the problem unsolvable.
+- When the function doesn't give you what you were asking for, you must either use another function or a different function input.
+  - When using search engines, you try different formulations of the query, possibly even in a different language.
+- You cannot do complex calculations, computations, or data manipulations without using functions.
+
+# Role
+{{instructions}}`
+});
+const BeeAssistantPrompt = new PromptTemplate({
+  schema: z.object({
+    thought: z.array(z.string()),
+    toolName: z.array(z.string()),
+    toolInput: z.array(z.string()),
+    toolOutput: z.array(z.string()),
+    finalAnswer: z.array(z.string())
+  }).partial(),
+  template: `{{#thought}}Thought: {{.}}
+{{/thought}}{{#toolName}}Function Name: {{.}}
+{{/toolName}}{{#toolInput}}Function Input: {{.}}
+{{/toolInput}}{{#toolOutput}}Function Output: {{.}}
+{{/toolOutput}}{{#finalAnswer}}Final Answer: {{.}}{{/finalAnswer}}`
+});
+const BeeUserPrompt = new PromptTemplate({
+  schema: z.object({
+    input: z.string(),
+    meta: z.object({
+      createdAt: z.string().datetime().optional()
+    }).passthrough().optional()
+  }).passthrough(),
+  functions: {
+    formatMeta: /* @__PURE__ */ __name(function() {
+      const meta = this.meta;
+      if (!meta) {
+        return "";
+      }
+      const parts = [
+        meta.createdAt && `This message was created at ${meta.createdAt}`
+      ].filter(Boolean).join("\n");
+      return parts ? `
+
+${parts}` : parts;
+    }, "formatMeta")
+  },
+  template: `Message: {{input}}{{formatMeta}}`
+});
+const BeeUserEmptyPrompt = new PromptTemplate({
+  schema: z.object({}).passthrough(),
+  template: `Message: Empty message.`
+});
+const BeeToolErrorPrompt = new PromptTemplate({
+  schema: z.object({
+    reason: z.string()
+  }).passthrough(),
+  template: `The function has failed; the error log is shown below. If the function cannot accomplish what you want, use a different function or explain why you can't use it.
+
+{{reason}}`
+});
+const BeeToolInputErrorPrompt = new PromptTemplate({
+  schema: z.object({
+    reason: z.string()
+  }).passthrough(),
+  template: `{{reason}}
+
+HINT: If you're convinced that the input was correct but the function cannot process it then use a different function or say I don't know.`
+});
+const BeeToolNoResultsPrompt = new PromptTemplate({
+  schema: z.record(z.any()),
+  template: `No results were found!`
+});
+const BeeToolNotFoundPrompt = new PromptTemplate({
+  schema: z.object({
+    tools: z.array(z.object({
+      name: z.string()
+    }).passthrough())
+  }).passthrough(),
+  template: `Function does not exist!
+{{#tools.length}}
+Use one of the following functions: {{#trim}}{{#tools}}{{name}},{{/tools}}{{/trim}}
+{{/tools.length}}`
+});
+const BeeSchemaErrorPrompt = new PromptTemplate({
+  schema: z.object({}).passthrough(),
+  template: `Error: The generated response does not adhere to the communication structure mentioned in the system prompt.
+You communicate only in instruction lines. Valid instruction lines are 'Thought' followed by either 'Function Name' + 'Function Input' + 'Function Output' or 'Final Answer'.`
+});
+
+export { BeeAssistantPrompt, BeeSchemaErrorPrompt, BeeSystemPrompt, BeeToolErrorPrompt, BeeToolInputErrorPrompt, BeeToolNoResultsPrompt, BeeToolNotFoundPrompt, BeeUserEmptyPrompt, BeeUserPrompt };
+//# sourceMappingURL=prompts.js.map
+//# sourceMappingURL=prompts.js.map

package/dist/agents/bee/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/agents/bee/prompts.ts"],"names":["BeeSystemPrompt","PromptTemplate","schema","z","object","instructions","string","default","tools","array","name","min","description","passthrough","createdAt","datetime","nullish","template","BeeAssistantPrompt","thought","toolName","toolInput","toolOutput","finalAnswer","partial","BeeUserPrompt","input","meta","optional","functions","formatMeta","parts","filter","Boolean","join","BeeUserEmptyPrompt","BeeToolErrorPrompt","reason","BeeToolInputErrorPrompt","BeeToolNoResultsPrompt","record","any","BeeToolNotFoundPrompt","BeeSchemaErrorPrompt"],"mappings":"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","file":"prompts.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 { PromptTemplate } from \"@/template.js\";\nimport { z } from \"zod\";\nimport { MessageMeta } from \"@/backend/message.js\";\n\nexport const BeeSystemPrompt = new PromptTemplate({\n  schema: z.object({\n    instructions: z.string().default(\"You are a helpful assistant.\"),\n    tools: z.array(\n      z\n        .object({\n          name: z.string().min(1),\n          description: z.string().min(1),\n          schema: z.string().min(1),\n        })\n        .passthrough(),\n    ),\n    createdAt: z.string().datetime().nullish(),\n  }),\n  template: `# Available functions\n{{#tools.length}}\nYou can only use the following functions. Always use all required parameters.\n\n{{#tools}}\nFunction Name: {{name}}\nDescription: {{description}}\nParameters: {{schema}}\n\n{{/tools}}\n{{/tools.length}}\n{{^tools.length}}\nNo functions are available.\n\n{{/tools.length}}\n# Communication structure\nYou communicate only in instruction lines. The format is: \"Instruction: expected output\\n\". You must only use these instruction lines and must not enter empty lines between them. Each instruction must start on a new line.\n{{#tools.length}}\nYou must skip the instruction lines Function Name, Function Input and Function Output if no function calling is required.\n{{/tools.length}}\n\nMessage: User's message. You never use this instruction line.\n{{^tools.length}}\nThought: A single-line plan of how to answer the user's message, including an explanation of the reasoning behind it. It must be immediately followed by Final Answer.\n{{/tools.length}}\n{{#tools.length}}\nThought: A single-line step-by-step plan of how to answer the user's message, including an explanation of the reasoning behind it. You can use the available functions defined above. This instruction line must be immediately followed by Function Name if one of the available functions defined above needs to be called, or by Final Answer. Do not provide the answer here.\nFunction Name: Name of the function. This instruction line must be immediately followed by Function Input.\nFunction Input: Function parameters. Empty object is a valid parameter.\nFunction Output: Output of the function in JSON format.\nThought: Continue your thinking process.\n{{/tools.length}}\nFinal Answer: Answer the user or ask for more information or clarification. It must always be preceded by Thought.\n\n## Examples\nMessage: Can you translate \"How are you\" into French?\nThought: The user wants to translate a text into French. I can do that.\nFinal Answer: Comment vas-tu?\n\n# Instructions\nUser can only see the Final Answer, all answers must be provided there.\n{{^tools.length}}\nYou must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by Final Answer.\n{{/tools.length}}\n{{#tools.length}}\nYou must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by either Function Name or Final Answer.\nYou must use Functions to retrieve factual or historical information to answer the message.\n{{/tools.length}}\nIf the user suggests using a function that is not available, answer that the function is not available. You can suggest alternatives if appropriate.\nWhen the message is unclear or you need more information from the user, ask in Final Answer.\n\n# Your capabilities\nPrefer to use these capabilities over functions.\n- You understand these languages: English, Spanish, French.\n- You can translate, analyze, summarize, even long documents.\n\n# Notes\n- If you don't know the answer, say that you don't know.\n- The current time and date in ISO format can be found in the last message.\n- When answering the user, use friendly formats for time and date.\n- Use markdown syntax for formatting code snippets, links, JSON, tables, images, files.\n- Sometimes, things don't go as planned. Functions may not provide useful information on the first few tries. You should always try a few different approaches before declaring the problem unsolvable.\n- When the function doesn't give you what you were asking for, you must either use another function or a different function input.\n  - When using search engines, you try different formulations of the query, possibly even in a different language.\n- You cannot do complex calculations, computations, or data manipulations without using functions.\n\n# Role\n{{instructions}}`,\n});\n\nexport const BeeAssistantPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      thought: z.array(z.string()),\n      toolName: z.array(z.string()),\n      toolInput: z.array(z.string()),\n      toolOutput: z.array(z.string()),\n      finalAnswer: z.array(z.string()),\n    })\n    .partial(),\n  template: `{{#thought}}Thought: {{.}}\\n{{/thought}}{{#toolName}}Function Name: {{.}}\\n{{/toolName}}{{#toolInput}}Function Input: {{.}}\\n{{/toolInput}}{{#toolOutput}}Function Output: {{.}}\\n{{/toolOutput}}{{#finalAnswer}}Final Answer: {{.}}{{/finalAnswer}}`,\n});\n\nexport const BeeUserPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      input: z.string(),\n      meta: z\n        .object({\n          createdAt: z.string().datetime().optional(),\n        })\n        .passthrough()\n        .optional(),\n    })\n    .passthrough(),\n  functions: {\n    formatMeta: function () {\n      const meta = this.meta as MessageMeta;\n      if (!meta) {\n        return \"\";\n      }\n\n      const parts = [meta.createdAt && `This message was created at ${meta.createdAt}`]\n        .filter(Boolean)\n        .join(\"\\n\");\n\n      return parts ? `\\n\\n${parts}` : parts;\n    },\n  },\n  template: `Message: {{input}}{{formatMeta}}`,\n});\n\nexport const BeeUserEmptyPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `Message: Empty message.`,\n});\n\nexport const BeeToolErrorPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      reason: z.string(),\n    })\n    .passthrough(),\n  template: `The function has failed; the error log is shown below. If the function cannot accomplish what you want, use a different function or explain why you can't use it.\n\n{{reason}}`,\n});\n\nexport const BeeToolInputErrorPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      reason: z.string(),\n    })\n    .passthrough(),\n  template: `{{reason}}\n\nHINT: If you're convinced that the input was correct but the function cannot process it then use a different function or say I don't know.`,\n});\n\nexport const BeeToolNoResultsPrompt = new PromptTemplate({\n  schema: z.record(z.any()),\n  template: `No results were found!`,\n});\n\nexport const BeeToolNotFoundPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      tools: z.array(z.object({ name: z.string() }).passthrough()),\n    })\n    .passthrough(),\n  template: `Function does not exist!\n{{#tools.length}}\nUse one of the following functions: {{#trim}}{{#tools}}{{name}},{{/tools}}{{/trim}}\n{{/tools.length}}`,\n});\n\nexport const BeeSchemaErrorPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `Error: The generated response does not adhere to the communication structure mentioned in the system prompt.\nYou communicate only in instruction lines. Valid instruction lines are 'Thought' followed by either 'Function Name' + 'Function Input' + 'Function Output' or 'Final Answer'.`,\n});\n"]}

package/dist/agents/bee/runners/base.cjs

@@ -0,0 +1,103 @@
+'use strict';
+
+var serializable_cjs = require('../../../internals/serializable.cjs');
+var counter_cjs = require('../../../internals/helpers/counter.cjs');
+var base_cjs = require('../../base.cjs');
+var utils_cjs = require('../../../serializer/utils.cjs');
+var decoratorCache_cjs = require('../../../cache/decoratorCache.cjs');
+var object_cjs = require('../../../internals/helpers/object.cjs');
+var template_cjs = require('../../../template.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+class BaseRunner extends serializable_cjs.Serializable {
+  static {
+    __name(this, "BaseRunner");
+  }
+  input;
+  options;
+  run;
+  memory;
+  iterations;
+  failedAttemptsCounter;
+  constructor(input, options, run) {
+    super(), this.input = input, this.options = options, this.run = run, this.iterations = [];
+    this.failedAttemptsCounter = new counter_cjs.RetryCounter(options?.execution?.totalMaxRetries, base_cjs.AgentError);
+  }
+  async createIteration() {
+    const meta = {
+      iteration: this.iterations.length + 1
+    };
+    const maxIterations = this.options?.execution?.maxIterations ?? Infinity;
+    if (meta.iteration > maxIterations) {
+      throw new base_cjs.AgentError(`Agent was not able to resolve the task in ${maxIterations} iterations.`, [], {
+        isFatal: true,
+        isRetryable: false,
+        context: {
+          iterations: this.iterations.map((iteration2) => iteration2.state)
+        }
+      });
+    }
+    const emitter = this.run.emitter.child({
+      groupId: `iteration-${meta.iteration}`
+    });
+    const iteration = await this.llm({
+      emitter,
+      signal: this.run.signal,
+      meta
+    });
+    this.iterations.push(iteration);
+    return {
+      emitter,
+      state: iteration.state,
+      meta,
+      signal: this.run.signal
+    };
+  }
+  async init(input) {
+    this.memory = await this.initMemory(input);
+  }
+  get templates() {
+    const overrides = this.input.templates ?? {};
+    return object_cjs.mapObj(this.defaultTemplates)((key, defaultTemplate) => {
+      const override = overrides[key] ?? defaultTemplate;
+      if (override instanceof template_cjs.PromptTemplate) {
+        return override;
+      }
+      return override(defaultTemplate) ?? defaultTemplate;
+    });
+  }
+  createSnapshot() {
+    return {
+      input: utils_cjs.shallowCopy(this.input),
+      options: utils_cjs.shallowCopy(this.options),
+      memory: this.memory,
+      failedAttemptsCounter: this.failedAttemptsCounter
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+_ts_decorate([
+  decoratorCache_cjs.Cache({
+    enumerable: false
+  }),
+  _ts_metadata("design:type", typeof BeeAgentTemplates === "undefined" ? Object : BeeAgentTemplates),
+  _ts_metadata("design:paramtypes", [])
+], BaseRunner.prototype, "templates", null);
+
+exports.BaseRunner = BaseRunner;
+//# sourceMappingURL=base.cjs.map
+//# sourceMappingURL=base.cjs.map

package/dist/agents/bee/runners/base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/agents/bee/runners/base.ts"],"names":["BaseRunner","Serializable","memory","iterations","failedAttemptsCounter","constructor","input","options","run","RetryCounter","execution","totalMaxRetries","AgentError","createIteration","meta","iteration","length","maxIterations","Infinity","isFatal","isRetryable","context","map","state","emitter","child","groupId","llm","signal","push","init","initMemory","templates","overrides","mapObj","defaultTemplates","key","defaultTemplate","override","PromptTemplate","createSnapshot","shallowCopy","loadSnapshot","snapshot","Object","assign","enumerable"],"mappings":";;;;;;;;;;;;AAcC,SAAA,YAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAAA,EAAA,IAAA,EAAA;;;;;;AAAA,MAAA,CAAA,YAAA,EAAA,cAAA,CAAA;;;;;AAoCM,MAAeA,mBAAmBC,6BAAAA,CAAAA;EAlDzC;;;;;;AAmDSC,EAAAA,MAAAA;AACSC,EAAAA,UAAAA;AACGC,EAAAA,qBAAAA;EAEnBC,WACqBC,CAAAA,KAAAA,EACAC,SACAC,GACnB,EAAA;AACA,IAAA,KAAA,EAAK,EAAA,IAAA,CAJcF,KAAAA,GAAAA,KAAAA,EAAAA,IACAC,CAAAA,OAAAA,GAAAA,OAAAA,EAAAA,IAAAA,CACAC,GAAAA,GAAAA,GAAAA,EAAAA,IANLL,CAAAA,UAAAA,GAAqC,EAAA;AASnD,IAAA,IAAA,CAAKC,wBAAwB,IAAIK,wBAAAA,CAAaF,OAASG,EAAAA,SAAAA,EAAWC,iBAAiBC,mBAAAA,CAAAA;AACrF;AAEA,EAAA,MAAMC,eAAkB,GAAA;AACtB,IAAA,MAAMC,IAAgB,GAAA;MAAEC,SAAW,EAAA,IAAA,CAAKZ,WAAWa,MAAS,GAAA;AAAE,KAAA;AAC9D,IAAA,MAAMC,aAAgB,GAAA,IAAA,CAAKV,OAASG,EAAAA,SAAAA,EAAWO,aAAiBC,IAAAA,QAAAA;AAEhE,IAAIJ,IAAAA,IAAAA,CAAKC,YAAYE,aAAe,EAAA;AAClC,MAAA,MAAM,IAAIL,mBACR,CAAA,CAAA,0CAAA,EAA6CK,aAAAA,CAAAA,YAAAA,CAAAA,EAC7C,EACA,EAAA;QACEE,OAAS,EAAA,IAAA;QACTC,WAAa,EAAA,KAAA;QACbC,OAAS,EAAA;AAAElB,UAAAA,UAAAA,EAAY,KAAKA,UAAWmB,CAAAA,GAAAA,CAAI,CAACP,UAAAA,KAAcA,WAAUQ,KAAK;AAAE;OAC7E,CAAA;AAEJ;AAEA,IAAA,MAAMC,OAAU,GAAA,IAAA,CAAKhB,GAAIgB,CAAAA,OAAAA,CAAQC,KAAM,CAAA;MAAEC,OAAS,EAAA,CAAA,UAAA,EAAaZ,KAAKC,SAAS,CAAA;KAAG,CAAA;AAChF,IAAMA,MAAAA,SAAAA,GAAY,MAAM,IAAA,CAAKY,GAAI,CAAA;AAAEH,MAAAA,OAAAA;AAASI,MAAAA,MAAAA,EAAQ,KAAKpB,GAAIoB,CAAAA,MAAAA;AAAQd,MAAAA;KAAK,CAAA;AAC1E,IAAKX,IAAAA,CAAAA,UAAAA,CAAW0B,KAAKd,SAAAA,CAAAA;AAErB,IAAO,OAAA;AACLS,MAAAA,OAAAA;AACAD,MAAAA,KAAAA,EAAOR,SAAUQ,CAAAA,KAAAA;AACjBT,MAAAA,IAAAA;AACAc,MAAAA,MAAAA,EAAQ,KAAKpB,GAAIoB,CAAAA;AACnB,KAAA;AACF;AAEA,EAAA,MAAME,KAAKxB,KAAoB,EAAA;AAC7B,IAAA,IAAA,CAAKJ,MAAS,GAAA,MAAM,IAAK6B,CAAAA,UAAAA,CAAWzB,KAAAA,CAAAA;AACtC;AAQA,EAAA,IACW0B,SAA+B,GAAA;AACxC,IAAA,MAAMC,SAAY,GAAA,IAAA,CAAK3B,KAAM0B,CAAAA,SAAAA,IAAa,EAAC;AAE3C,IAAA,OAAOE,kBAAO,IAAKC,CAAAA,gBAAgB,CAAE,CAAA,CAACC,KAAKC,eAAAA,KAAAA;AACzC,MAAMC,MAAAA,QAAAA,GAAWL,SAAUG,CAAAA,GAAAA,CAAQC,IAAAA,eAAAA;AACnC,MAAA,IAAIC,oBAAoBC,2BAAgB,EAAA;AACtC,QAAOD,OAAAA,QAAAA;AACT;AACA,MAAOA,OAAAA,QAAAA,CAASD,eAAAA,CAAoBA,IAAAA,eAAAA;KACtC,CAAA;AACF;EAIAG,cAAiB,GAAA;AACf,IAAO,OAAA;MACLlC,KAAOmC,EAAAA,qBAAAA,CAAY,KAAKnC,KAAK,CAAA;MAC7BC,OAASkC,EAAAA,qBAAAA,CAAY,KAAKlC,OAAO,CAAA;AACjCL,MAAAA,MAAAA,EAAQ,IAAKA,CAAAA,MAAAA;AACbE,MAAAA,qBAAAA,EAAuB,IAAKA,CAAAA;AAC9B,KAAA;AACF;AAEAsC,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF;;;IA3BWG,UAAY,EAAA","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 { Serializable } from \"@/internals/serializable.js\";\nimport type { BeeAgentTemplates } from \"@/agents/bee/types.js\";\nimport {\n  BeeAgentRunIteration,\n  BeeCallbacks,\n  BeeIterationToolResult,\n  BeeMeta,\n  BeeRunInput,\n  BeeRunOptions,\n} from \"@/agents/bee/types.js\";\nimport type { BeeAgent, BeeInput } from \"@/agents/bee/agent.js\";\nimport { RetryCounter } from \"@/internals/helpers/counter.js\";\nimport { AgentError } from \"@/agents/base.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { GetRunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { mapObj } from \"@/internals/helpers/object.js\";\nimport { PromptTemplate } from \"@/template.js\";\n\nexport interface BeeRunnerLLMInput {\n  meta: BeeMeta;\n  signal: AbortSignal;\n  emitter: Emitter<BeeCallbacks>;\n}\n\nexport interface BeeRunnerToolInput {\n  state: BeeIterationToolResult;\n  meta: BeeMeta;\n  signal: AbortSignal;\n  emitter: Emitter<BeeCallbacks>;\n}\n\nexport abstract class BaseRunner extends Serializable {\n  public memory!: BaseMemory;\n  public readonly iterations: BeeAgentRunIteration[] = [];\n  protected readonly failedAttemptsCounter: RetryCounter;\n\n  constructor(\n    protected readonly input: BeeInput,\n    protected readonly options: BeeRunOptions,\n    protected readonly run: GetRunContext<BeeAgent>,\n  ) {\n    super();\n    this.failedAttemptsCounter = new RetryCounter(options?.execution?.totalMaxRetries, AgentError);\n  }\n\n  async createIteration() {\n    const meta: BeeMeta = { iteration: this.iterations.length + 1 };\n    const maxIterations = this.options?.execution?.maxIterations ?? Infinity;\n\n    if (meta.iteration > maxIterations) {\n      throw new AgentError(\n        `Agent was not able to resolve the task in ${maxIterations} iterations.`,\n        [],\n        {\n          isFatal: true,\n          isRetryable: false,\n          context: { iterations: this.iterations.map((iteration) => iteration.state) },\n        },\n      );\n    }\n\n    const emitter = this.run.emitter.child({ groupId: `iteration-${meta.iteration}` });\n    const iteration = await this.llm({ emitter, signal: this.run.signal, meta });\n    this.iterations.push(iteration);\n\n    return {\n      emitter,\n      state: iteration.state,\n      meta,\n      signal: this.run.signal,\n    };\n  }\n\n  async init(input: BeeRunInput) {\n    this.memory = await this.initMemory(input);\n  }\n\n  abstract llm(input: BeeRunnerLLMInput): Promise<BeeAgentRunIteration>;\n\n  abstract tool(input: BeeRunnerToolInput): Promise<{ output: string; success: boolean }>;\n\n  public abstract get defaultTemplates(): BeeAgentTemplates;\n\n  @Cache({ enumerable: false })\n  public get templates(): BeeAgentTemplates {\n    const overrides = this.input.templates ?? {};\n\n    return mapObj(this.defaultTemplates)((key, defaultTemplate: BeeAgentTemplates[typeof key]) => {\n      const override = overrides[key] ?? defaultTemplate;\n      if (override instanceof PromptTemplate) {\n        return override;\n      }\n      return override(defaultTemplate) ?? defaultTemplate;\n    });\n  }\n\n  protected abstract initMemory(input: BeeRunInput): Promise<BaseMemory>;\n\n  createSnapshot() {\n    return {\n      input: shallowCopy(this.input),\n      options: shallowCopy(this.options),\n      memory: this.memory,\n      failedAttemptsCounter: this.failedAttemptsCounter,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/agents/bee/runners/base.d.cts

@@ -0,0 +1,32 @@
+import '../../../parsers/linePrefix.cjs';
+import '../types.cjs';
+import '../../../internals/serializable.cjs';
+export { b as BaseRunner, c as BeeRunnerLLMInput, d as BeeRunnerToolInput } from '../../../agent-BbaHVlob.cjs';
+import '../../../internals/helpers/counter.cjs';
+import '../../../memory/base.cjs';
+import '../../../context.cjs';
+import '../../../emitter-BWtGHYn0.cjs';
+import '../../../parsers/field.cjs';
+import 'zod';
+import '@streamparser/json';
+import 'jsonrepair/stream';
+import '../../../internals/types.cjs';
+import '../../../internals/helpers/guards.cjs';
+import '../../../parsers/errors.cjs';
+import '../../../errors.cjs';
+import '../../../backend/message.cjs';
+import 'ai';
+import '../../../tools/base.cjs';
+import 'ajv';
+import 'promise-based-task';
+import '../../../cache/base.cjs';
+import '../../../internals/helpers/schema.cjs';
+import 'zod-to-json-schema';
+import '../../../internals/helpers/promise.cjs';
+import '../prompts.cjs';
+import '../../../template.cjs';
+import '../../../backend/chat.cjs';
+import '../../../backend/utils.cjs';
+import '../../../backend/constants.cjs';
+import '@ai-sdk/provider';
+import '../../../base-Csr9guq2.cjs';

package/dist/agents/bee/runners/base.d.ts

@@ -0,0 +1,32 @@
+import '../../../parsers/linePrefix.js';
+import '../types.js';
+import '../../../internals/serializable.js';
+export { b as BaseRunner, c as BeeRunnerLLMInput, d as BeeRunnerToolInput } from '../../../agent-Bks2fOUl.js';
+import '../../../internals/helpers/counter.js';
+import '../../../memory/base.js';
+import '../../../context.js';
+import '../../../emitter-l0W9gC1A.js';
+import '../../../parsers/field.js';
+import 'zod';
+import '@streamparser/json';
+import 'jsonrepair/stream';
+import '../../../internals/types.js';
+import '../../../internals/helpers/guards.js';
+import '../../../parsers/errors.js';
+import '../../../errors.js';
+import '../../../backend/message.js';
+import 'ai';
+import '../../../tools/base.js';
+import 'ajv';
+import 'promise-based-task';
+import '../../../cache/base.js';
+import '../../../internals/helpers/schema.js';
+import 'zod-to-json-schema';
+import '../../../internals/helpers/promise.js';
+import '../prompts.js';
+import '../../../template.js';
+import '../../../backend/chat.js';
+import '../../../backend/utils.js';
+import '../../../backend/constants.js';
+import '@ai-sdk/provider';
+import '../../../base-DHhpWHQm.js';

package/dist/agents/bee/runners/base.js

@@ -0,0 +1,101 @@
+import { Serializable } from '../../../internals/serializable.js';
+import { RetryCounter } from '../../../internals/helpers/counter.js';
+import { AgentError } from '../../base.js';
+import { shallowCopy } from '../../../serializer/utils.js';
+import { Cache } from '../../../cache/decoratorCache.js';
+import { mapObj } from '../../../internals/helpers/object.js';
+import { PromptTemplate } from '../../../template.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+class BaseRunner extends Serializable {
+  static {
+    __name(this, "BaseRunner");
+  }
+  input;
+  options;
+  run;
+  memory;
+  iterations;
+  failedAttemptsCounter;
+  constructor(input, options, run) {
+    super(), this.input = input, this.options = options, this.run = run, this.iterations = [];
+    this.failedAttemptsCounter = new RetryCounter(options?.execution?.totalMaxRetries, AgentError);
+  }
+  async createIteration() {
+    const meta = {
+      iteration: this.iterations.length + 1
+    };
+    const maxIterations = this.options?.execution?.maxIterations ?? Infinity;
+    if (meta.iteration > maxIterations) {
+      throw new AgentError(`Agent was not able to resolve the task in ${maxIterations} iterations.`, [], {
+        isFatal: true,
+        isRetryable: false,
+        context: {
+          iterations: this.iterations.map((iteration2) => iteration2.state)
+        }
+      });
+    }
+    const emitter = this.run.emitter.child({
+      groupId: `iteration-${meta.iteration}`
+    });
+    const iteration = await this.llm({
+      emitter,
+      signal: this.run.signal,
+      meta
+    });
+    this.iterations.push(iteration);
+    return {
+      emitter,
+      state: iteration.state,
+      meta,
+      signal: this.run.signal
+    };
+  }
+  async init(input) {
+    this.memory = await this.initMemory(input);
+  }
+  get templates() {
+    const overrides = this.input.templates ?? {};
+    return mapObj(this.defaultTemplates)((key, defaultTemplate) => {
+      const override = overrides[key] ?? defaultTemplate;
+      if (override instanceof PromptTemplate) {
+        return override;
+      }
+      return override(defaultTemplate) ?? defaultTemplate;
+    });
+  }
+  createSnapshot() {
+    return {
+      input: shallowCopy(this.input),
+      options: shallowCopy(this.options),
+      memory: this.memory,
+      failedAttemptsCounter: this.failedAttemptsCounter
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+_ts_decorate([
+  Cache({
+    enumerable: false
+  }),
+  _ts_metadata("design:type", typeof BeeAgentTemplates === "undefined" ? Object : BeeAgentTemplates),
+  _ts_metadata("design:paramtypes", [])
+], BaseRunner.prototype, "templates", null);
+
+export { BaseRunner };
+//# sourceMappingURL=base.js.map
+//# sourceMappingURL=base.js.map

package/dist/agents/bee/runners/base.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/agents/bee/runners/base.ts"],"names":["BaseRunner","Serializable","memory","iterations","failedAttemptsCounter","constructor","input","options","run","RetryCounter","execution","totalMaxRetries","AgentError","createIteration","meta","iteration","length","maxIterations","Infinity","isFatal","isRetryable","context","map","state","emitter","child","groupId","llm","signal","push","init","initMemory","templates","overrides","mapObj","defaultTemplates","key","defaultTemplate","override","PromptTemplate","createSnapshot","shallowCopy","loadSnapshot","snapshot","Object","assign","enumerable"],"mappings":"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","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 { Serializable } from \"@/internals/serializable.js\";\nimport type { BeeAgentTemplates } from \"@/agents/bee/types.js\";\nimport {\n  BeeAgentRunIteration,\n  BeeCallbacks,\n  BeeIterationToolResult,\n  BeeMeta,\n  BeeRunInput,\n  BeeRunOptions,\n} from \"@/agents/bee/types.js\";\nimport type { BeeAgent, BeeInput } from \"@/agents/bee/agent.js\";\nimport { RetryCounter } from \"@/internals/helpers/counter.js\";\nimport { AgentError } from \"@/agents/base.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { GetRunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { mapObj } from \"@/internals/helpers/object.js\";\nimport { PromptTemplate } from \"@/template.js\";\n\nexport interface BeeRunnerLLMInput {\n  meta: BeeMeta;\n  signal: AbortSignal;\n  emitter: Emitter<BeeCallbacks>;\n}\n\nexport interface BeeRunnerToolInput {\n  state: BeeIterationToolResult;\n  meta: BeeMeta;\n  signal: AbortSignal;\n  emitter: Emitter<BeeCallbacks>;\n}\n\nexport abstract class BaseRunner extends Serializable {\n  public memory!: BaseMemory;\n  public readonly iterations: BeeAgentRunIteration[] = [];\n  protected readonly failedAttemptsCounter: RetryCounter;\n\n  constructor(\n    protected readonly input: BeeInput,\n    protected readonly options: BeeRunOptions,\n    protected readonly run: GetRunContext<BeeAgent>,\n  ) {\n    super();\n    this.failedAttemptsCounter = new RetryCounter(options?.execution?.totalMaxRetries, AgentError);\n  }\n\n  async createIteration() {\n    const meta: BeeMeta = { iteration: this.iterations.length + 1 };\n    const maxIterations = this.options?.execution?.maxIterations ?? Infinity;\n\n    if (meta.iteration > maxIterations) {\n      throw new AgentError(\n        `Agent was not able to resolve the task in ${maxIterations} iterations.`,\n        [],\n        {\n          isFatal: true,\n          isRetryable: false,\n          context: { iterations: this.iterations.map((iteration) => iteration.state) },\n        },\n      );\n    }\n\n    const emitter = this.run.emitter.child({ groupId: `iteration-${meta.iteration}` });\n    const iteration = await this.llm({ emitter, signal: this.run.signal, meta });\n    this.iterations.push(iteration);\n\n    return {\n      emitter,\n      state: iteration.state,\n      meta,\n      signal: this.run.signal,\n    };\n  }\n\n  async init(input: BeeRunInput) {\n    this.memory = await this.initMemory(input);\n  }\n\n  abstract llm(input: BeeRunnerLLMInput): Promise<BeeAgentRunIteration>;\n\n  abstract tool(input: BeeRunnerToolInput): Promise<{ output: string; success: boolean }>;\n\n  public abstract get defaultTemplates(): BeeAgentTemplates;\n\n  @Cache({ enumerable: false })\n  public get templates(): BeeAgentTemplates {\n    const overrides = this.input.templates ?? {};\n\n    return mapObj(this.defaultTemplates)((key, defaultTemplate: BeeAgentTemplates[typeof key]) => {\n      const override = overrides[key] ?? defaultTemplate;\n      if (override instanceof PromptTemplate) {\n        return override;\n      }\n      return override(defaultTemplate) ?? defaultTemplate;\n    });\n  }\n\n  protected abstract initMemory(input: BeeRunInput): Promise<BaseMemory>;\n\n  createSnapshot() {\n    return {\n      input: shallowCopy(this.input),\n      options: shallowCopy(this.options),\n      memory: this.memory,\n      failedAttemptsCounter: this.failedAttemptsCounter,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}