beeai-framework 0.1.21 → 0.1.23

package/dist/agents/requirement/requirements/utils.cjs

@@ -0,0 +1,74 @@
+'use strict';
+
+var base_cjs = require('../../../tools/base.cjs');
+var errors_cjs = require('../../../errors.cjs');
+var remeda = require('remeda');
+var prototype_cjs = require('../../../internals/helpers/prototype.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function extractTargetName(target) {
+  if (typeof target === "string") {
+    return target;
+  }
+  if (typeof target === "function") {
+    return target.name;
+  }
+  return target.name;
+}
+__name(extractTargetName, "extractTargetName");
+function extractTargets(targets) {
+  if (!targets) {
+    return /* @__PURE__ */ new Set();
+  }
+  const targetArray = Array.isArray(targets) ? targets : [
+    targets
+  ];
+  return new Set(targetArray);
+}
+__name(extractTargets, "extractTargets");
+function targetSeenIn(target, haystack) {
+  if (!target) {
+    return null;
+  }
+  if (!(haystack instanceof Set)) {
+    haystack = /* @__PURE__ */ new Set([
+      haystack
+    ]);
+  }
+  for (const needle of haystack.values()) {
+    if (remeda.isString(needle) && needle === target.name) {
+      return needle;
+    }
+    if (needle instanceof base_cjs.Tool && needle === target) {
+      return needle;
+    }
+    if (prototype_cjs.isConstructor(needle) && target instanceof needle) {
+      return needle;
+    }
+  }
+  return null;
+}
+__name(targetSeenIn, "targetSeenIn");
+function assertAllRulesFound(targets, tools) {
+  for (const target of targets) {
+    let found = false;
+    for (const tool of tools) {
+      if (targetSeenIn(tool, target)) {
+        found = true;
+        break;
+      }
+    }
+    if (!found) {
+      throw new errors_cjs.ValueError(`Tool '${target}' is specified as 'source', 'before', 'after' or 'force_after' but not found.`);
+    }
+  }
+}
+__name(assertAllRulesFound, "assertAllRulesFound");
+
+exports.assertAllRulesFound = assertAllRulesFound;
+exports.extractTargetName = extractTargetName;
+exports.extractTargets = extractTargets;
+exports.targetSeenIn = targetSeenIn;
+//# sourceMappingURL=utils.cjs.map
+//# sourceMappingURL=utils.cjs.map

package/dist/agents/requirement/requirements/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/agents/requirement/requirements/utils.ts"],"names":["extractTargetName","target","name","extractTargets","targets","Set","targetArray","Array","isArray","targetSeenIn","haystack","needle","values","isString","Tool","isConstructor","assertAllRulesFound","tools","found","tool","ValueError"],"mappings":";;;;;;;;;AAgBO,SAASA,kBAAkBC,MAAAA,EAAkB;AAClD,EAAA,IAAI,OAAOA,WAAW,QAAA,EAAU;AAC9B,IAAA,OAAOA,MAAAA;AACT;AACA,EAAA,IAAI,OAAOA,WAAW,UAAA,EAAY;AAChC,IAAA,OAAOA,MAAAA,CAAOC,IAAAA;AAChB;AACA,EAAA,OAAOD,MAAAA,CAAOC,IAAAA;AAChB;AARgBF,MAAAA,CAAAA,iBAAAA,EAAAA,mBAAAA,CAAAA;AAaT,SAASG,eAAeC,OAAAA,EAAyB;AACtD,EAAA,IAAI,CAACA,OAAAA,EAAS;AACZ,IAAA,2BAAWC,GAAAA,EAAAA;AACb;AAEA,EAAA,MAAMC,WAAAA,GAAcC,KAAAA,CAAMC,OAAAA,CAAQJ,OAAAA,IAAWA,OAAAA,GAAU;AAACA,IAAAA;;AACxD,EAAA,OAAO,IAAIC,IAAIC,WAAAA,CAAAA;AACjB;AAPgBH,MAAAA,CAAAA,cAAAA,EAAAA,gBAAAA,CAAAA;AAYT,SAASM,YAAAA,CACdR,QACAS,QAAAA,EAAsC;AAEtC,EAAA,IAAI,CAACT,MAAAA,EAAQ;AACX,IAAA,OAAO,IAAA;AACT;AAEA,EAAA,IAAI,EAAES,oBAAoBL,GAAAA,CAAAA,EAAM;AAC9BK,IAAAA,QAAAA,uBAAeL,GAAAA,CAAI;AAACK,MAAAA;AAAS,KAAA,CAAA;AAC/B;AAEA,EAAA,KAAA,MAAWC,MAAAA,IAAUD,QAAAA,CAASE,MAAAA,EAAM,EAAI;AACtC,IAAA,IAAIC,eAAAA,CAASF,MAAAA,CAAAA,IAAWA,MAAAA,KAAWV,OAAOC,IAAAA,EAAM;AAC9C,MAAA,OAAOS,MAAAA;AACT;AACA,IAAA,IAAIA,MAAAA,YAAkBG,aAAAA,IAAQH,MAAAA,KAAWV,MAAAA,EAAQ;AAC/C,MAAA,OAAOU,MAAAA;AACT;AACA,IAAA,IAAII,2BAAAA,CAAcJ,MAAAA,CAAAA,IAAWV,MAAAA,YAAkBU,MAAAA,EAAQ;AACrD,MAAA,OAAOA,MAAAA;AACT;AACF;AAEA,EAAA,OAAO,IAAA;AACT;AAzBgBF,MAAAA,CAAAA,YAAAA,EAAAA,cAAAA,CAAAA;AA8BT,SAASO,mBAAAA,CAAoBZ,SAA0Ba,KAAAA,EAAgB;AAC5E,EAAA,KAAA,MAAWhB,UAAUG,OAAAA,EAAS;AAC5B,IAAA,IAAIc,KAAAA,GAAQ,KAAA;AACZ,IAAA,KAAA,MAAWC,QAAQF,KAAAA,EAAO;AACxB,MAAA,IAAIR,YAAAA,CAAaU,IAAAA,EAAMlB,MAAAA,CAAAA,EAAS;AAC9BiB,QAAAA,KAAAA,GAAQ,IAAA;AACR,QAAA;AACF;AACF;AACA,IAAA,IAAI,CAACA,KAAAA,EAAO;AACV,MAAA,MAAM,IAAIE,qBAAAA,CACR,CAAA,MAAA,EAASnB,MAAAA,CAAAA,6EAAAA,CAAqF,CAAA;AAElG;AACF;AACF;AAfgBe,MAAAA,CAAAA,mBAAAA,EAAAA,qBAAAA,CAAAA","file":"utils.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { AnyTool, AnyToolClass, Tool } from \"@/tools/base.js\";\nimport { ValueError } from \"@/errors.js\";\nimport { isString } from \"remeda\";\nimport { isConstructor } from \"@/internals/helpers/prototype.js\";\n\nexport type TargetType = string | AnyTool | AnyToolClass;\nexport type MultiTargetType = TargetType | TargetType[];\n\n/**\n * Extract target name from various input types\n */\nexport function extractTargetName(target: TargetType): string {\n  if (typeof target === \"string\") {\n    return target;\n  }\n  if (typeof target === \"function\") {\n    return target.name;\n  }\n  return target.name;\n}\n\n/**\n * Extract set of target names from various input types\n */\nexport function extractTargets(targets?: MultiTargetType): Set<TargetType> {\n  if (!targets) {\n    return new Set();\n  }\n\n  const targetArray = Array.isArray(targets) ? targets : [targets];\n  return new Set(targetArray);\n}\n\n/**\n * Check if a tool matches any target in the set\n */\nexport function targetSeenIn(\n  target: AnyTool | null | undefined,\n  haystack: Set<TargetType> | TargetType,\n): TargetType | null {\n  if (!target) {\n    return null;\n  }\n\n  if (!(haystack instanceof Set)) {\n    haystack = new Set([haystack]);\n  }\n\n  for (const needle of haystack.values()) {\n    if (isString(needle) && needle === target.name) {\n      return needle;\n    }\n    if (needle instanceof Tool && needle === target) {\n      return needle;\n    }\n    if (isConstructor(needle) && target instanceof needle) {\n      return needle;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Assert that all targets exist in the tools list\n */\nexport function assertAllRulesFound(targets: Set<TargetType>, tools: AnyTool[]): void {\n  for (const target of targets) {\n    let found = false;\n    for (const tool of tools) {\n      if (targetSeenIn(tool, target)) {\n        found = true;\n        break;\n      }\n    }\n    if (!found) {\n      throw new ValueError(\n        `Tool '${target}' is specified as 'source', 'before', 'after' or 'force_after' but not found.`,\n      );\n    }\n  }\n}\n"]}

package/dist/agents/requirement/requirements/utils.d.cts

@@ -0,0 +1,40 @@
+import { AnyTool, AnyToolClass } from '../../../tools/base.cjs';
+import 'ajv';
+import '../../../context.cjs';
+import '../../../emitter-jN55XZZq.cjs';
+import '../../../internals/types.cjs';
+import '../../../internals/helpers/guards.cjs';
+import '../../../internals/serializable.cjs';
+import '../../../internals/helpers/promise.cjs';
+import '../../../errors.cjs';
+import 'promise-based-task';
+import '../../../cache/base.cjs';
+import '../../../internals/helpers/schema.cjs';
+import 'zod';
+import 'zod-to-json-schema';
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+type TargetType = string | AnyTool | AnyToolClass;
+type MultiTargetType = TargetType | TargetType[];
+/**
+ * Extract target name from various input types
+ */
+declare function extractTargetName(target: TargetType): string;
+/**
+ * Extract set of target names from various input types
+ */
+declare function extractTargets(targets?: MultiTargetType): Set<TargetType>;
+/**
+ * Check if a tool matches any target in the set
+ */
+declare function targetSeenIn(target: AnyTool | null | undefined, haystack: Set<TargetType> | TargetType): TargetType | null;
+/**
+ * Assert that all targets exist in the tools list
+ */
+declare function assertAllRulesFound(targets: Set<TargetType>, tools: AnyTool[]): void;
+
+export { type MultiTargetType, type TargetType, assertAllRulesFound, extractTargetName, extractTargets, targetSeenIn };

package/dist/agents/requirement/requirements/utils.d.ts

@@ -0,0 +1,40 @@
+import { AnyTool, AnyToolClass } from '../../../tools/base.js';
+import 'ajv';
+import '../../../context.js';
+import '../../../emitter-36-9MnvA.js';
+import '../../../internals/types.js';
+import '../../../internals/helpers/guards.js';
+import '../../../internals/serializable.js';
+import '../../../internals/helpers/promise.js';
+import '../../../errors.js';
+import 'promise-based-task';
+import '../../../cache/base.js';
+import '../../../internals/helpers/schema.js';
+import 'zod';
+import 'zod-to-json-schema';
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+type TargetType = string | AnyTool | AnyToolClass;
+type MultiTargetType = TargetType | TargetType[];
+/**
+ * Extract target name from various input types
+ */
+declare function extractTargetName(target: TargetType): string;
+/**
+ * Extract set of target names from various input types
+ */
+declare function extractTargets(targets?: MultiTargetType): Set<TargetType>;
+/**
+ * Check if a tool matches any target in the set
+ */
+declare function targetSeenIn(target: AnyTool | null | undefined, haystack: Set<TargetType> | TargetType): TargetType | null;
+/**
+ * Assert that all targets exist in the tools list
+ */
+declare function assertAllRulesFound(targets: Set<TargetType>, tools: AnyTool[]): void;
+
+export { type MultiTargetType, type TargetType, assertAllRulesFound, extractTargetName, extractTargets, targetSeenIn };

package/dist/agents/requirement/requirements/utils.js

@@ -0,0 +1,69 @@
+import { Tool } from '../../../tools/base.js';
+import { ValueError } from '../../../errors.js';
+import { isString } from 'remeda';
+import { isConstructor } from '../../../internals/helpers/prototype.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function extractTargetName(target) {
+  if (typeof target === "string") {
+    return target;
+  }
+  if (typeof target === "function") {
+    return target.name;
+  }
+  return target.name;
+}
+__name(extractTargetName, "extractTargetName");
+function extractTargets(targets) {
+  if (!targets) {
+    return /* @__PURE__ */ new Set();
+  }
+  const targetArray = Array.isArray(targets) ? targets : [
+    targets
+  ];
+  return new Set(targetArray);
+}
+__name(extractTargets, "extractTargets");
+function targetSeenIn(target, haystack) {
+  if (!target) {
+    return null;
+  }
+  if (!(haystack instanceof Set)) {
+    haystack = /* @__PURE__ */ new Set([
+      haystack
+    ]);
+  }
+  for (const needle of haystack.values()) {
+    if (isString(needle) && needle === target.name) {
+      return needle;
+    }
+    if (needle instanceof Tool && needle === target) {
+      return needle;
+    }
+    if (isConstructor(needle) && target instanceof needle) {
+      return needle;
+    }
+  }
+  return null;
+}
+__name(targetSeenIn, "targetSeenIn");
+function assertAllRulesFound(targets, tools) {
+  for (const target of targets) {
+    let found = false;
+    for (const tool of tools) {
+      if (targetSeenIn(tool, target)) {
+        found = true;
+        break;
+      }
+    }
+    if (!found) {
+      throw new ValueError(`Tool '${target}' is specified as 'source', 'before', 'after' or 'force_after' but not found.`);
+    }
+  }
+}
+__name(assertAllRulesFound, "assertAllRulesFound");
+
+export { assertAllRulesFound, extractTargetName, extractTargets, targetSeenIn };
+//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map

package/dist/agents/requirement/requirements/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/agents/requirement/requirements/utils.ts"],"names":["extractTargetName","target","name","extractTargets","targets","Set","targetArray","Array","isArray","targetSeenIn","haystack","needle","values","isString","Tool","isConstructor","assertAllRulesFound","tools","found","tool","ValueError"],"mappings":";;;;;;;AAgBO,SAASA,kBAAkBC,MAAAA,EAAkB;AAClD,EAAA,IAAI,OAAOA,WAAW,QAAA,EAAU;AAC9B,IAAA,OAAOA,MAAAA;AACT;AACA,EAAA,IAAI,OAAOA,WAAW,UAAA,EAAY;AAChC,IAAA,OAAOA,MAAAA,CAAOC,IAAAA;AAChB;AACA,EAAA,OAAOD,MAAAA,CAAOC,IAAAA;AAChB;AARgBF,MAAAA,CAAAA,iBAAAA,EAAAA,mBAAAA,CAAAA;AAaT,SAASG,eAAeC,OAAAA,EAAyB;AACtD,EAAA,IAAI,CAACA,OAAAA,EAAS;AACZ,IAAA,2BAAWC,GAAAA,EAAAA;AACb;AAEA,EAAA,MAAMC,WAAAA,GAAcC,KAAAA,CAAMC,OAAAA,CAAQJ,OAAAA,IAAWA,OAAAA,GAAU;AAACA,IAAAA;;AACxD,EAAA,OAAO,IAAIC,IAAIC,WAAAA,CAAAA;AACjB;AAPgBH,MAAAA,CAAAA,cAAAA,EAAAA,gBAAAA,CAAAA;AAYT,SAASM,YAAAA,CACdR,QACAS,QAAAA,EAAsC;AAEtC,EAAA,IAAI,CAACT,MAAAA,EAAQ;AACX,IAAA,OAAO,IAAA;AACT;AAEA,EAAA,IAAI,EAAES,oBAAoBL,GAAAA,CAAAA,EAAM;AAC9BK,IAAAA,QAAAA,uBAAeL,GAAAA,CAAI;AAACK,MAAAA;AAAS,KAAA,CAAA;AAC/B;AAEA,EAAA,KAAA,MAAWC,MAAAA,IAAUD,QAAAA,CAASE,MAAAA,EAAM,EAAI;AACtC,IAAA,IAAIC,QAAAA,CAASF,MAAAA,CAAAA,IAAWA,MAAAA,KAAWV,OAAOC,IAAAA,EAAM;AAC9C,MAAA,OAAOS,MAAAA;AACT;AACA,IAAA,IAAIA,MAAAA,YAAkBG,IAAAA,IAAQH,MAAAA,KAAWV,MAAAA,EAAQ;AAC/C,MAAA,OAAOU,MAAAA;AACT;AACA,IAAA,IAAII,aAAAA,CAAcJ,MAAAA,CAAAA,IAAWV,MAAAA,YAAkBU,MAAAA,EAAQ;AACrD,MAAA,OAAOA,MAAAA;AACT;AACF;AAEA,EAAA,OAAO,IAAA;AACT;AAzBgBF,MAAAA,CAAAA,YAAAA,EAAAA,cAAAA,CAAAA;AA8BT,SAASO,mBAAAA,CAAoBZ,SAA0Ba,KAAAA,EAAgB;AAC5E,EAAA,KAAA,MAAWhB,UAAUG,OAAAA,EAAS;AAC5B,IAAA,IAAIc,KAAAA,GAAQ,KAAA;AACZ,IAAA,KAAA,MAAWC,QAAQF,KAAAA,EAAO;AACxB,MAAA,IAAIR,YAAAA,CAAaU,IAAAA,EAAMlB,MAAAA,CAAAA,EAAS;AAC9BiB,QAAAA,KAAAA,GAAQ,IAAA;AACR,QAAA;AACF;AACF;AACA,IAAA,IAAI,CAACA,KAAAA,EAAO;AACV,MAAA,MAAM,IAAIE,UAAAA,CACR,CAAA,MAAA,EAASnB,MAAAA,CAAAA,6EAAAA,CAAqF,CAAA;AAElG;AACF;AACF;AAfgBe,MAAAA,CAAAA,mBAAAA,EAAAA,qBAAAA,CAAAA","file":"utils.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { AnyTool, AnyToolClass, Tool } from \"@/tools/base.js\";\nimport { ValueError } from \"@/errors.js\";\nimport { isString } from \"remeda\";\nimport { isConstructor } from \"@/internals/helpers/prototype.js\";\n\nexport type TargetType = string | AnyTool | AnyToolClass;\nexport type MultiTargetType = TargetType | TargetType[];\n\n/**\n * Extract target name from various input types\n */\nexport function extractTargetName(target: TargetType): string {\n  if (typeof target === \"string\") {\n    return target;\n  }\n  if (typeof target === \"function\") {\n    return target.name;\n  }\n  return target.name;\n}\n\n/**\n * Extract set of target names from various input types\n */\nexport function extractTargets(targets?: MultiTargetType): Set<TargetType> {\n  if (!targets) {\n    return new Set();\n  }\n\n  const targetArray = Array.isArray(targets) ? targets : [targets];\n  return new Set(targetArray);\n}\n\n/**\n * Check if a tool matches any target in the set\n */\nexport function targetSeenIn(\n  target: AnyTool | null | undefined,\n  haystack: Set<TargetType> | TargetType,\n): TargetType | null {\n  if (!target) {\n    return null;\n  }\n\n  if (!(haystack instanceof Set)) {\n    haystack = new Set([haystack]);\n  }\n\n  for (const needle of haystack.values()) {\n    if (isString(needle) && needle === target.name) {\n      return needle;\n    }\n    if (needle instanceof Tool && needle === target) {\n      return needle;\n    }\n    if (isConstructor(needle) && target instanceof needle) {\n      return needle;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Assert that all targets exist in the tools list\n */\nexport function assertAllRulesFound(targets: Set<TargetType>, tools: AnyTool[]): void {\n  for (const target of targets) {\n    let found = false;\n    for (const tool of tools) {\n      if (targetSeenIn(tool, target)) {\n        found = true;\n        break;\n      }\n    }\n    if (!found) {\n      throw new ValueError(\n        `Tool '${target}' is specified as 'source', 'before', 'after' or 'force_after' but not found.`,\n      );\n    }\n  }\n}\n"]}

package/dist/agents/requirement/runner.cjs

@@ -0,0 +1,268 @@
+'use strict';
+
+var uuid = require('uuid');
+var base_cjs = require('../base.cjs');
+var message_cjs = require('../../backend/message.cjs');
+var unconstrainedMemory_cjs = require('../../memory/unconstrainedMemory.cjs');
+var counter_cjs = require('../../internals/helpers/counter.cjs');
+var llm_cjs = require('./utils/llm.cjs');
+var tool_cjs = require('./utils/tool.cjs');
+var schema_cjs = require('../../internals/helpers/schema.cjs');
+var utils_cjs = require('../../adapters/vercel/backend/utils.cjs');
+var streamToolCall_cjs = require('../../middleware/streamToolCall.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const TEMP_MESSAGE_KEY = "tempMessage";
+class RequirementAgentRunner {
+  static {
+    __name(this, "RequirementAgentRunner");
+  }
+  llm;
+  runConfig;
+  requirements;
+  toolCallCycleChecker;
+  ctx;
+  forceFinalAnswerAsTool;
+  templates;
+  state;
+  reasoner;
+  iterationErrorCounter;
+  globalErrorCounter;
+  constructor(llm, runConfig, tools, requirements, expectedOutput, toolCallCycleChecker, ctx, forceFinalAnswerAsTool, templates) {
+    this.llm = llm;
+    this.runConfig = runConfig;
+    this.requirements = requirements;
+    this.toolCallCycleChecker = toolCallCycleChecker;
+    this.ctx = ctx;
+    this.forceFinalAnswerAsTool = forceFinalAnswerAsTool;
+    this.templates = templates;
+    this.state = {
+      answer: null,
+      result: null,
+      memory: new unconstrainedMemory_cjs.UnconstrainedMemory(),
+      steps: [],
+      iteration: 0,
+      usage: {
+        totalTokens: 0,
+        promptTokens: 0,
+        completionTokens: 0,
+        reasoningTokens: 0,
+        cachedPromptTokens: void 0
+      }
+    };
+    this.requirements = requirements;
+    const finalAnswer = new tool_cjs.FinalAnswerTool(expectedOutput, this.state);
+    this.reasoner = new llm_cjs.RequirementsReasoner(tools, finalAnswer, ctx);
+    const maxRetriesPerIteration = runConfig.maxRetriesPerStep ?? 0;
+    this.iterationErrorCounter = new counter_cjs.RetryCounter(maxRetriesPerIteration, base_cjs.AgentError);
+    const maxRetries = Math.max(maxRetriesPerIteration, runConfig.totalMaxRetries ?? 0);
+    this.globalErrorCounter = new counter_cjs.RetryCounter(maxRetries, base_cjs.AgentError);
+  }
+  incrementIteration() {
+    this.state.iteration++;
+    if (this.runConfig.maxIterations && this.state.iteration > this.runConfig.maxIterations) {
+      throw new base_cjs.AgentError(`Agent was not able to resolve the task in ${this.state.iteration} iterations.`);
+    }
+  }
+  async runLLM(request) {
+    const streamMiddleware = this.createFinalAnswerStream(request.finalAnswer);
+    try {
+      const input = await this.prepareLLMRequest(request);
+      const response = await this.llm.create(input).middleware(streamMiddleware);
+      if (response.usage) {
+        utils_cjs.mergeTokenUsage(this.state.usage, response.usage);
+      }
+      return response;
+    } finally {
+      streamMiddleware.unbind();
+    }
+  }
+  async prepareLLMRequest(request) {
+    const messages = [
+      await llm_cjs.createSystemMessage(this.templates.system, request),
+      ...this.state.memory.messages
+    ];
+    return {
+      messages,
+      tools: request.allowedTools,
+      toolChoice: request.toolChoice,
+      streamPartialToolCalls: true
+    };
+  }
+  async createFinalAnswerToolCall(fullText) {
+    const parsed = schema_cjs.parseBrokenJson(fullText, {
+      pair: [
+        "{",
+        "}"
+      ]
+    });
+    if (!parsed) {
+      if (!this.reasoner.finalAnswer.customSchema) {
+        return new message_cjs.AssistantMessage([
+          {
+            type: "tool-call",
+            toolCallId: `call_${uuid.v4().substring(0, 8)}`,
+            toolName: this.reasoner.finalAnswer.name,
+            input: this.reasoner.finalAnswer.inputSchema().parse({
+              response: fullText
+            })
+          }
+        ]);
+      }
+      return null;
+    }
+    return new message_cjs.AssistantMessage([
+      {
+        type: "tool-call",
+        toolCallId: `call_${uuid.v4().substring(0, 8)}`,
+        toolName: this.reasoner.finalAnswer.name,
+        input: parsed
+      }
+    ]);
+  }
+  async createRequest(extraRules = []) {
+    return await this.reasoner.createRequest(this.state, this.forceFinalAnswerAsTool, extraRules);
+  }
+  async invokeToolCalls(tools, toolCalls) {
+    const toolResults = [];
+    const results = await Promise.all(toolCalls.map((msg) => tool_cjs.runTool(tools, msg, {
+      state: this.state
+    })));
+    for (const toolCall of results) {
+      this.state.steps.push({
+        id: uuid.v4(),
+        iteration: this.state.iteration,
+        input: toolCall.input,
+        output: toolCall.output,
+        tool: toolCall.tool,
+        error: toolCall.error
+      });
+      let result;
+      if (toolCall.error) {
+        result = this.templates.toolError.render({
+          reason: toolCall.error.explain()
+        });
+      } else {
+        result = !toolCall.output.isEmpty() ? toolCall.output.getTextContent() : this.templates.toolNoResult.render({
+          toolCall: {
+            tool: toolCall.tool,
+            input: toolCall.input
+          }
+        });
+      }
+      toolResults.push(new message_cjs.ToolMessage({
+        type: "tool-result",
+        toolName: toolCall.tool?.name || toolCall.msg.toolName,
+        toolCallId: toolCall.msg.toolCallId,
+        output: {
+          type: "text",
+          value: result
+        }
+      }));
+      if (toolCall.error) {
+        this.iterationErrorCounter.use(toolCall.error);
+        this.globalErrorCounter.use(toolCall.error);
+      }
+    }
+    return toolResults;
+  }
+  async addMessages(messages) {
+    await this.state.memory.addMany(messages);
+  }
+  async run() {
+    if (this.state.answer) {
+      return this.state;
+    }
+    await this.reasoner.update(this.requirements);
+    while (!this.state.answer) {
+      this.incrementIteration();
+      const request = await this.createRequest();
+      await this.ctx.emitter.emit("start", {
+        state: this.state,
+        request
+      });
+      const response = await this.runIteration(request);
+      await this.ctx.emitter.emit("success", {
+        state: this.state,
+        response
+      });
+    }
+    return this.state;
+  }
+  async runIteration(request) {
+    const response = await this.runLLM(request);
+    const toolCalls = response.getToolCalls();
+    if (toolCalls.length === 0) {
+      const textMessages = response.getTextMessages();
+      const text = textMessages.map((m) => m.text).join("\n");
+      if (!text || request.canStop) {
+        throw new base_cjs.AgentError("Model produced an empty response.");
+      }
+      const finalAnswerToolCall = await this.createFinalAnswerToolCall(text);
+      if (!finalAnswerToolCall) {
+        const err = new base_cjs.AgentError("Model produced an invalid final answer tool call.");
+        this.iterationErrorCounter.use(err);
+        this.globalErrorCounter.use(err);
+        await this.reasoner.update([]);
+        const updatedRequest = await this.createRequest([
+          {
+            target: this.reasoner.finalAnswer.name,
+            allowed: true,
+            hidden: false,
+            forced: false,
+            preventStop: false
+          }
+        ]);
+        this.forceFinalAnswerAsTool = true;
+        return await this.runIteration(updatedRequest);
+      }
+      await this.state.memory.add(finalAnswerToolCall);
+      toolCalls.push(...finalAnswerToolCall.getToolCalls());
+    } else {
+      await this.state.memory.addMany(response.messages);
+    }
+    for (const toolCallMsg of toolCalls) {
+      this.toolCallCycleChecker.register(toolCallMsg);
+      if (this.toolCallCycleChecker.cycleFound) {
+        this.toolCallCycleChecker.reset();
+        const updatedRequest = await this.createRequest([
+          {
+            target: toolCallMsg.toolName,
+            allowed: false,
+            hidden: false,
+            forced: true,
+            preventStop: false
+          }
+        ]);
+        return await this.runIteration(updatedRequest);
+      }
+    }
+    const toolResults = await this.invokeToolCalls(request.allowedTools, toolCalls);
+    await this.state.memory.addMany(toolResults);
+    const tempMessages = this.state.memory.messages.filter((msg) => msg.meta[TEMP_MESSAGE_KEY]);
+    await this.state.memory.deleteMany(tempMessages);
+    return response;
+  }
+  createFinalAnswerStream(finalAnswer) {
+    const middleware = new streamToolCall_cjs.StreamToolCallMiddleware({
+      target: finalAnswer,
+      forceStreaming: false,
+      key: "response",
+      matchNested: false
+    });
+    middleware.emitter.on("update", async (data, _) => {
+      await this.ctx.emitter.emit("finalAnswer", {
+        state: this.state,
+        output: data.output,
+        delta: data.delta,
+        outputStructured: void 0
+      });
+    });
+    return middleware;
+  }
+}
+
+exports.RequirementAgentRunner = RequirementAgentRunner;
+//# sourceMappingURL=runner.cjs.map
+//# sourceMappingURL=runner.cjs.map

package/dist/agents/requirement/runner.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/agents/requirement/runner.ts"],"names":["TEMP_MESSAGE_KEY","RequirementAgentRunner","state","reasoner","iterationErrorCounter","globalErrorCounter","llm","runConfig","tools","requirements","expectedOutput","toolCallCycleChecker","ctx","forceFinalAnswerAsTool","templates","answer","result","memory","UnconstrainedMemory","steps","iteration","usage","totalTokens","promptTokens","completionTokens","reasoningTokens","cachedPromptTokens","undefined","finalAnswer","FinalAnswerTool","RequirementsReasoner","maxRetriesPerIteration","maxRetriesPerStep","RetryCounter","AgentError","maxRetries","Math","max","totalMaxRetries","incrementIteration","maxIterations","runLLM","request","streamMiddleware","createFinalAnswerStream","input","prepareLLMRequest","response","create","middleware","mergeTokenUsage","unbind","messages","createSystemMessage","system","allowedTools","toolChoice","streamPartialToolCalls","createFinalAnswerToolCall","fullText","parsed","parseBrokenJson","pair","customSchema","AssistantMessage","type","toolCallId","uuidv4","substring","toolName","name","inputSchema","parse","createRequest","extraRules","invokeToolCalls","toolCalls","toolResults","results","Promise","all","map","msg","runTool","toolCall","push","id","output","tool","error","toolError","render","reason","explain","isEmpty","getTextContent","toolNoResult","ToolMessage","value","use","addMessages","addMany","run","update","emitter","emit","runIteration","getToolCalls","length","textMessages","getTextMessages","text","m","join","canStop","finalAnswerToolCall","err","updatedRequest","target","allowed","hidden","forced","preventStop","add","toolCallMsg","register","cycleFound","reset","tempMessages","filter","meta","deleteMany","StreamToolCallMiddleware","forceStreaming","key","matchNested","on","data","_","delta","outputStructured"],"mappings":"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","file":"runner.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { v4 as uuidv4 } from \"uuid\";\nimport { AgentError } from \"@/agents/base.js\";\nimport { ChatModel, ChatModelInput, ChatModelOutput } from \"@/backend/chat.js\";\nimport { AssistantMessage, Message, ToolMessage } from \"@/backend/message.js\";\nimport { ToolCallPart } from \"ai\";\nimport { AnyTool } from \"@/tools/base.js\";\nimport { UnconstrainedMemory } from \"@/memory/unconstrainedMemory.js\";\nimport { RetryCounter } from \"@/internals/helpers/counter.js\";\nimport { RunContext } from \"@/context.js\";\nimport {\n  RequirementAgentExecutionConfig,\n  RequirementAgentRequest,\n  RequirementAgentRunState,\n  RequirementAgentTemplates,\n} from \"./types.js\";\nimport { Requirement, Rule } from \"./requirements/requirement.js\";\nimport { RequirementsReasoner, createSystemMessage } from \"./utils/llm.js\";\nimport { FinalAnswerTool, runTool } from \"./utils/tool.js\";\nimport { ToolCallChecker } from \"./utils/toolCallChecker.js\";\nimport { z } from \"zod\";\nimport { parseBrokenJson } from \"@/internals/helpers/schema.js\";\nimport { RequirementAgent } from \"@/agents/requirement/agent.js\";\nimport { mergeTokenUsage } from \"@/adapters/vercel/backend/utils.js\";\nimport { StreamToolCallMiddleware } from \"@/middleware/streamToolCall.js\";\n\nconst TEMP_MESSAGE_KEY = \"tempMessage\";\n\n/**\n * Runner for RequirementAgent execution\n */\nexport class RequirementAgentRunner {\n  protected readonly state: RequirementAgentRunState;\n  protected readonly reasoner: RequirementsReasoner;\n  protected readonly iterationErrorCounter: RetryCounter;\n  protected readonly globalErrorCounter: RetryCounter;\n\n  constructor(\n    protected readonly llm: ChatModel,\n    protected readonly runConfig: RequirementAgentExecutionConfig,\n    tools: AnyTool[],\n    protected readonly requirements: Requirement[],\n    expectedOutput: string | z.ZodSchema | null,\n    protected readonly toolCallCycleChecker: ToolCallChecker,\n    protected readonly ctx: RunContext<RequirementAgent>,\n    protected forceFinalAnswerAsTool: boolean,\n    protected readonly templates: RequirementAgentTemplates,\n  ) {\n    this.state = {\n      answer: null,\n      result: null,\n      memory: new UnconstrainedMemory(),\n      steps: [],\n      iteration: 0,\n      usage: {\n        totalTokens: 0,\n        promptTokens: 0,\n        completionTokens: 0,\n        reasoningTokens: 0,\n        cachedPromptTokens: undefined,\n      },\n    };\n\n    this.requirements = requirements;\n    const finalAnswer = new FinalAnswerTool(expectedOutput, this.state);\n    this.reasoner = new RequirementsReasoner(tools, finalAnswer, ctx);\n\n    const maxRetriesPerIteration = runConfig.maxRetriesPerStep ?? 0;\n    this.iterationErrorCounter = new RetryCounter(maxRetriesPerIteration, AgentError);\n\n    const maxRetries = Math.max(maxRetriesPerIteration, runConfig.totalMaxRetries ?? 0);\n    this.globalErrorCounter = new RetryCounter(maxRetries, AgentError);\n  }\n\n  protected incrementIteration(): void {\n    this.state.iteration++;\n\n    if (this.runConfig.maxIterations && this.state.iteration > this.runConfig.maxIterations) {\n      throw new AgentError(\n        `Agent was not able to resolve the task in ${this.state.iteration} iterations.`,\n      );\n    }\n  }\n\n  protected async runLLM(request: RequirementAgentRequest): Promise<ChatModelOutput> {\n    const streamMiddleware = this.createFinalAnswerStream(request.finalAnswer);\n    try {\n      const input = await this.prepareLLMRequest(request);\n      const response = await this.llm.create(input).middleware(streamMiddleware);\n\n      if (response.usage) {\n        mergeTokenUsage(this.state.usage, response.usage);\n      }\n\n      return response;\n    } finally {\n      streamMiddleware.unbind();\n    }\n  }\n\n  protected async prepareLLMRequest(request: RequirementAgentRequest): Promise<ChatModelInput> {\n    const messages: Message[] = [\n      await createSystemMessage(this.templates.system, request),\n      ...this.state.memory.messages,\n    ];\n\n    return {\n      messages,\n      tools: request.allowedTools,\n      toolChoice: request.toolChoice,\n      streamPartialToolCalls: true,\n    };\n  }\n\n  protected async createFinalAnswerToolCall(fullText: string): Promise<AssistantMessage | null> {\n    // Try to extract JSON from text\n    const parsed = parseBrokenJson(fullText, { pair: [\"{\", \"}\"] });\n    if (!parsed) {\n      // If no JSON and no custom schema, wrap in default schema\n      if (!this.reasoner.finalAnswer.customSchema) {\n        return new AssistantMessage([\n          {\n            type: \"tool-call\",\n            toolCallId: `call_${uuidv4().substring(0, 8)}`,\n            toolName: this.reasoner.finalAnswer.name,\n            input: this.reasoner.finalAnswer.inputSchema().parse({ response: fullText }),\n          },\n        ]);\n      }\n      return null;\n    }\n\n    return new AssistantMessage([\n      {\n        type: \"tool-call\",\n        toolCallId: `call_${uuidv4().substring(0, 8)}`,\n        toolName: this.reasoner.finalAnswer.name,\n        input: parsed,\n      },\n    ]);\n  }\n\n  protected async createRequest(extraRules: Rule[] = []): Promise<RequirementAgentRequest> {\n    return await this.reasoner.createRequest(this.state, this.forceFinalAnswerAsTool, extraRules);\n  }\n\n  protected async invokeToolCalls(\n    tools: AnyTool[],\n    toolCalls: ToolCallPart[],\n  ): Promise<ToolMessage[]> {\n    const toolResults: ToolMessage[] = [];\n\n    const results = await Promise.all(\n      toolCalls.map((msg) => runTool(tools, msg, { state: this.state })),\n    );\n\n    for (const toolCall of results) {\n      this.state.steps.push({\n        id: uuidv4(),\n        iteration: this.state.iteration,\n        input: toolCall.input,\n        output: toolCall.output,\n        tool: toolCall.tool,\n        error: toolCall.error,\n      });\n\n      let result: string;\n      if (toolCall.error) {\n        result = this.templates.toolError.render({\n          reason: toolCall.error.explain(),\n        });\n      } else {\n        result = !toolCall.output.isEmpty()\n          ? toolCall.output.getTextContent()\n          : this.templates.toolNoResult.render({\n              toolCall: { tool: toolCall.tool, input: toolCall.input },\n            });\n      }\n      toolResults.push(\n        new ToolMessage({\n          type: \"tool-result\",\n          toolName: toolCall.tool?.name || toolCall.msg.toolName,\n          toolCallId: toolCall.msg.toolCallId,\n          output: { type: \"text\", value: result },\n        }),\n      );\n\n      if (toolCall.error) {\n        this.iterationErrorCounter.use(toolCall.error);\n        this.globalErrorCounter.use(toolCall.error);\n      }\n    }\n\n    return toolResults;\n  }\n\n  async addMessages(messages: Message[]): Promise<void> {\n    await this.state.memory.addMany(messages);\n  }\n\n  async run(): Promise<RequirementAgentRunState> {\n    if (this.state.answer) {\n      return this.state;\n    }\n\n    // Initialize requirements\n    await this.reasoner.update(this.requirements);\n\n    while (!this.state.answer) {\n      this.incrementIteration();\n\n      const request = await this.createRequest();\n      await this.ctx.emitter.emit(\"start\", { state: this.state, request });\n      const response = await this.runIteration(request);\n      await this.ctx.emitter.emit(\"success\", { state: this.state, response });\n    }\n\n    return this.state;\n  }\n\n  protected async runIteration(request: RequirementAgentRequest): Promise<ChatModelOutput> {\n    const response = await this.runLLM(request);\n\n    // Try to cast text message to final answer tool call if allowed\n    const toolCalls = response.getToolCalls();\n    if (toolCalls.length === 0) {\n      const textMessages = response.getTextMessages();\n      const text = textMessages.map((m) => m.text).join(\"\\n\");\n\n      if (!text || request.canStop) {\n        throw new AgentError(\"Model produced an empty response.\");\n      }\n\n      const finalAnswerToolCall = await this.createFinalAnswerToolCall(text);\n      if (!finalAnswerToolCall) {\n        const err = new AgentError(\"Model produced an invalid final answer tool call.\");\n        this.iterationErrorCounter.use(err);\n        this.globalErrorCounter.use(err);\n\n        await this.reasoner.update([]);\n        const updatedRequest = await this.createRequest([\n          {\n            target: this.reasoner.finalAnswer.name,\n            allowed: true,\n            hidden: false,\n            forced: false,\n            preventStop: false,\n          },\n        ]);\n        this.forceFinalAnswerAsTool = true;\n        return await this.runIteration(updatedRequest);\n      }\n\n      await this.state.memory.add(finalAnswerToolCall);\n      toolCalls.push(...finalAnswerToolCall.getToolCalls());\n    } else {\n      await this.state.memory.addMany(response.messages);\n    }\n\n    // Check for cycles\n    for (const toolCallMsg of toolCalls) {\n      this.toolCallCycleChecker.register(toolCallMsg);\n      if (this.toolCallCycleChecker.cycleFound) {\n        this.toolCallCycleChecker.reset();\n        const updatedRequest = await this.createRequest([\n          {\n            target: toolCallMsg.toolName,\n            allowed: false,\n            hidden: false,\n            forced: true,\n            preventStop: false,\n          },\n        ]);\n        return await this.runIteration(updatedRequest);\n      }\n    }\n\n    const toolResults = await this.invokeToolCalls(request.allowedTools, toolCalls);\n    await this.state.memory.addMany(toolResults);\n\n    // Delete temporary messages\n    const tempMessages = this.state.memory.messages.filter((msg) => msg.meta[TEMP_MESSAGE_KEY]);\n    await this.state.memory.deleteMany(tempMessages);\n\n    return response;\n  }\n\n  private createFinalAnswerStream(finalAnswer: FinalAnswerTool) {\n    const middleware = new StreamToolCallMiddleware({\n      target: finalAnswer,\n      forceStreaming: false,\n      key: \"response\",\n      matchNested: false,\n    });\n    middleware.emitter.on(\"update\", async (data, _) => {\n      await this.ctx.emitter.emit(\"finalAnswer\", {\n        state: this.state,\n        output: data.output,\n        delta: data.delta,\n        outputStructured: undefined,\n      });\n    });\n    return middleware;\n  }\n}\n"]}