beeai-framework 0.1.21 → 0.1.23

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

@@ -0,0 +1,71 @@
+import { Requirement, Rule } from './requirement.js';
+import { MultiTargetType, TargetType } from './utils.js';
+import { AnyTool } from '../../../tools/base.js';
+import { RunContext } from '../../../context.js';
+import { R as RequirementAgentRunState } from '../../../types-CJwiMH3u.js';
+import '../../../emitter-36-9MnvA.js';
+import '../../../internals/types.js';
+import '../../../internals/helpers/guards.js';
+import '../../../internals/serializable.js';
+import '../../../errors.js';
+import '../../../internals/helpers/promise.js';
+import 'ajv';
+import 'promise-based-task';
+import '../../../cache/base.js';
+import '../../../internals/helpers/schema.js';
+import 'zod';
+import 'zod-to-json-schema';
+import '../../../memory/base.js';
+import '../../../backend/message.js';
+import 'ai';
+import '../../../template.js';
+import '../../../chat-DrqwUgD8.js';
+import '../../../backend/constants.js';
+import '../../../logger/logger.js';
+import 'pino';
+import '../../../base-CyFx7BRL.js';
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+interface ConditionalRequirementOptions {
+    name?: string;
+    forceAtStep?: number;
+    onlyBefore?: MultiTargetType;
+    onlyAfter?: MultiTargetType;
+    forceAfter?: MultiTargetType;
+    forcePreventStop?: boolean;
+    minInvocations?: number;
+    maxInvocations?: number;
+    onlySuccessInvocations?: boolean;
+    consecutiveAllowed?: boolean;
+    priority?: number;
+    customChecks?: ((state: RequirementAgentRunState) => boolean)[];
+    enabled?: boolean;
+    reason?: string;
+}
+declare class ConditionalRequirement extends Requirement {
+    protected source: TargetType;
+    protected sourceTool?: AnyTool;
+    protected before: Set<TargetType>;
+    protected after: Set<TargetType>;
+    protected forceAfterSet: Set<TargetType>;
+    protected minInvocations: number;
+    protected maxInvocations: number;
+    protected forceAtStepValue?: number;
+    protected onlySuccessInvocations: boolean;
+    protected consecutiveAllowedValue: boolean;
+    protected customChecks: ((state: RequirementAgentRunState) => boolean)[];
+    protected forcePreventStop: boolean;
+    protected reason?: string;
+    constructor(target: TargetType, options?: ConditionalRequirementOptions);
+    protected checkInvariant(): void;
+    init(tools: AnyTool[], ctx: RunContext<any>): Promise<void>;
+    reset(): this;
+    _run(state: RequirementAgentRunState, _: RunContext<typeof this>): Promise<Rule[]>;
+    clone(): Promise<this>;
+}
+
+export { ConditionalRequirement, type ConditionalRequirementOptions };

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

@@ -0,0 +1,188 @@
+import { Requirement, RequirementError } from './requirement.js';
+import { extractTargetName, extractTargets, assertAllRulesFound, targetSeenIn } from './utils.js';
+import { ValueError } from '../../../errors.js';
+import { isTruthy } from 'remeda';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class ConditionalRequirement extends Requirement {
+  static {
+    __name(this, "ConditionalRequirement");
+  }
+  source;
+  sourceTool;
+  before;
+  after;
+  forceAfterSet;
+  minInvocations;
+  maxInvocations;
+  forceAtStepValue;
+  onlySuccessInvocations;
+  consecutiveAllowedValue;
+  customChecks;
+  forcePreventStop;
+  reason;
+  constructor(target, options = {}) {
+    super(options.name || `Condition${extractTargetName(target)}`);
+    this.source = target;
+    this.enabled = options.enabled ?? true;
+    if (options.priority !== void 0) {
+      this.priority = options.priority;
+    }
+    this.before = extractTargets(options.onlyBefore);
+    this.after = extractTargets(options.onlyAfter);
+    this.forceAfterSet = extractTargets(options.forceAfter);
+    this.minInvocations = options.minInvocations ?? 0;
+    this.maxInvocations = options.maxInvocations ?? Infinity;
+    this.forceAtStepValue = options.forceAtStep;
+    this.onlySuccessInvocations = options.onlySuccessInvocations ?? true;
+    this.consecutiveAllowedValue = options.consecutiveAllowed ?? true;
+    this.customChecks = options.customChecks ?? [];
+    this.forcePreventStop = options.forcePreventStop ?? true;
+    this.reason = options.reason;
+    this.checkInvariant();
+  }
+  checkInvariant() {
+    if (this.minInvocations < 0) {
+      throw new ValueError("The 'minInvocations' argument must be non negative!");
+    }
+    if (this.maxInvocations < 0) {
+      throw new ValueError("The 'maxInvocations' argument must be non negative!");
+    }
+    if (this.minInvocations > this.maxInvocations) {
+      throw new ValueError("The 'minInvocations' argument must be less than or equal to 'maxInvocations'!");
+    }
+    const sourceName = extractTargetName(this.source);
+    if (this.before.has(this.source)) {
+      throw new ValueError(`Referencing self in 'before' is not allowed (${sourceName})!`);
+    }
+    if (this.forceAfterSet.has(this.source)) {
+      throw new ValueError(`Referencing self in 'forceAfter' is not allowed (${sourceName})!`);
+    }
+    const beforeAfterIntersection = new Set([
+      ...this.before
+    ].filter((x) => this.after.has(x)));
+    if (beforeAfterIntersection.size > 0) {
+      throw new ValueError(`Tool specified as 'before' and 'after' at the same time: ${Array.from(beforeAfterIntersection).join(", ")}!`);
+    }
+    const beforeForceAfterIntersection = new Set([
+      ...this.before
+    ].filter((x) => this.forceAfterSet.has(x)));
+    if (beforeForceAfterIntersection.size > 0) {
+      throw new ValueError(`Tool specified as 'before' and 'forceAfter' at the same time: ${Array.from(beforeForceAfterIntersection).join(", ")}!`);
+    }
+    if (this.forceAtStepValue !== void 0 && this.forceAtStepValue < 1) {
+      throw new ValueError("The 'forceAtStep' argument must be >= 1!");
+    }
+  }
+  async init(tools, ctx) {
+    await super.init(tools, ctx);
+    const allTargets = /* @__PURE__ */ new Set([
+      ...this.before,
+      ...this.after,
+      ...this.forceAfterSet,
+      this.source
+    ]);
+    assertAllRulesFound(allTargets, tools);
+    for (const tool of tools) {
+      if (targetSeenIn(tool, this.source)) {
+        if (this.sourceTool && this.sourceTool !== tool) {
+          throw new ValueError(`More than one occurrence of ${extractTargetName(this.source)} has been found!`);
+        }
+        this.sourceTool = tool;
+      }
+    }
+    if (!this.sourceTool) {
+      throw new ValueError(`Source tool ${extractTargetName(this.source)} was not found!`);
+    }
+    if (targetSeenIn(this.sourceTool, this.before)) {
+      throw new ValueError(`Referencing self in 'before' is not allowed: ${this.sourceTool.name}!`);
+    }
+    if (this.consecutiveAllowedValue && targetSeenIn(this.sourceTool, this.forceAfterSet)) {
+      throw new ValueError(`Referencing self in 'forceAfter' is not allowed: ${this.sourceTool.name}. It would prevent an infinite loop. Consider setting 'consecutiveAllowed' to false.`);
+    }
+  }
+  reset() {
+    this.before.clear();
+    this.after.clear();
+    this.forceAfterSet.clear();
+    return this;
+  }
+  async _run(state, _) {
+    const sourceTool = this.sourceTool;
+    if (!sourceTool) {
+      throw new RequirementError("Source was not found!", this);
+    }
+    const steps = this.onlySuccessInvocations ? state.steps.filter((step) => !step.error) : state.steps;
+    const lastStepTool = steps.at(-1)?.tool;
+    const invocations = steps.filter((step) => step.tool === sourceTool).length;
+    const resolve = /* @__PURE__ */ __name((allowed) => {
+      const currentStep = steps.length + 1;
+      if (!allowed && this.forceAtStepValue === currentStep) {
+        throw new RequirementError(`Tool '${sourceTool.name}' cannot be executed at step ${this.forceAtStepValue} because it has not met all requirements.`, this);
+      }
+      const forced = allowed ? Boolean(targetSeenIn(lastStepTool, this.forceAfterSet) || this.forceAtStepValue === currentStep) : false;
+      return [
+        {
+          target: sourceTool.name,
+          allowed,
+          forced,
+          hidden: false,
+          preventStop: this.minInvocations > invocations || forced && this.forcePreventStop,
+          reason: !allowed ? this.reason : void 0
+        }
+      ];
+    }, "resolve");
+    if (!this.consecutiveAllowedValue && sourceTool === lastStepTool) {
+      return resolve(false);
+    }
+    if (invocations >= this.maxInvocations) {
+      return resolve(false);
+    }
+    if (this.after.size > 0) {
+      const stepsAsToolCalls = steps.map((step) => step.tool).filter(isTruthy);
+      const afterToolsRemaining = new Set(this.after);
+      for (const stepTool of stepsAsToolCalls) {
+        if (targetSeenIn(stepTool, this.forceAfterSet)) {
+          return resolve(false);
+        }
+        const matcher = targetSeenIn(stepTool, this.after);
+        if (matcher) {
+          afterToolsRemaining.delete(matcher);
+        }
+      }
+      if (afterToolsRemaining.size > 0) {
+        return resolve(false);
+      }
+    }
+    for (const check of this.customChecks) {
+      if (!check(state)) {
+        return resolve(false);
+      }
+    }
+    return resolve(true);
+  }
+  async clone() {
+    const instance = await super.clone();
+    instance.before = new Set(this.before);
+    instance.after = new Set(this.after);
+    instance.forceAfterSet = new Set(this.forceAfterSet);
+    instance.minInvocations = this.minInvocations;
+    instance.maxInvocations = this.maxInvocations;
+    instance.customChecks = [
+      ...this.customChecks
+    ];
+    instance.onlySuccessInvocations = this.onlySuccessInvocations;
+    instance.forceAtStepValue = this.forceAtStepValue;
+    instance.consecutiveAllowedValue = this.consecutiveAllowedValue;
+    instance.source = this.source;
+    instance.sourceTool = this.sourceTool;
+    instance.forcePreventStop = this.forcePreventStop;
+    instance.reason = this.reason;
+    return instance;
+  }
+}
+
+export { ConditionalRequirement };
+//# sourceMappingURL=conditional.js.map
+//# sourceMappingURL=conditional.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/agents/requirement/requirements/conditional.ts"],"names":["ConditionalRequirement","Requirement","source","sourceTool","before","after","forceAfterSet","minInvocations","maxInvocations","forceAtStepValue","onlySuccessInvocations","consecutiveAllowedValue","customChecks","forcePreventStop","reason","target","options","name","extractTargetName","enabled","priority","undefined","extractTargets","onlyBefore","onlyAfter","forceAfter","Infinity","forceAtStep","consecutiveAllowed","checkInvariant","ValueError","sourceName","has","beforeAfterIntersection","Set","filter","x","size","Array","from","join","beforeForceAfterIntersection","init","tools","ctx","allTargets","assertAllRulesFound","tool","targetSeenIn","reset","clear","_run","state","_","RequirementError","steps","step","error","lastStepTool","at","invocations","length","resolve","allowed","currentStep","forced","Boolean","hidden","preventStop","stepsAsToolCalls","map","isTruthy","afterToolsRemaining","stepTool","matcher","delete","check","clone","instance"],"mappings":"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","file":"conditional.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { Requirement, RequirementError, Rule } from \"./requirement.js\";\nimport {\n  TargetType,\n  MultiTargetType,\n  extractTargets,\n  extractTargetName,\n  targetSeenIn,\n  assertAllRulesFound,\n} from \"./utils.js\";\nimport { AnyTool } from \"@/tools/base.js\";\nimport { RunContext } from \"@/context.js\";\nimport { ValueError } from \"@/errors.js\";\nimport type { RequirementAgentRunState } from \"@/agents/requirement/types.js\";\nimport { isTruthy } from \"remeda\";\n\nexport interface ConditionalRequirementOptions {\n  name?: string;\n  forceAtStep?: number;\n  onlyBefore?: MultiTargetType;\n  onlyAfter?: MultiTargetType;\n  forceAfter?: MultiTargetType;\n  forcePreventStop?: boolean;\n  minInvocations?: number;\n  maxInvocations?: number;\n  onlySuccessInvocations?: boolean;\n  consecutiveAllowed?: boolean;\n  priority?: number;\n  customChecks?: ((state: RequirementAgentRunState) => boolean)[];\n  enabled?: boolean;\n  reason?: string;\n}\n\nexport class ConditionalRequirement extends Requirement {\n  protected source: TargetType;\n  protected sourceTool?: AnyTool;\n  protected before: Set<TargetType>;\n  protected after: Set<TargetType>;\n  protected forceAfterSet: Set<TargetType>;\n  protected minInvocations: number;\n  protected maxInvocations: number;\n  protected forceAtStepValue?: number;\n  protected onlySuccessInvocations: boolean;\n  protected consecutiveAllowedValue: boolean;\n  protected customChecks: ((state: RequirementAgentRunState) => boolean)[];\n  protected forcePreventStop: boolean;\n  protected reason?: string;\n\n  constructor(target: TargetType, options: ConditionalRequirementOptions = {}) {\n    super(options.name || `Condition${extractTargetName(target)}`);\n\n    this.source = target;\n    this.enabled = options.enabled ?? true;\n\n    if (options.priority !== undefined) {\n      this.priority = options.priority;\n    }\n\n    this.before = extractTargets(options.onlyBefore);\n    this.after = extractTargets(options.onlyAfter);\n    this.forceAfterSet = extractTargets(options.forceAfter);\n    this.minInvocations = options.minInvocations ?? 0;\n    this.maxInvocations = options.maxInvocations ?? Infinity;\n    this.forceAtStepValue = options.forceAtStep;\n    this.onlySuccessInvocations = options.onlySuccessInvocations ?? true;\n    this.consecutiveAllowedValue = options.consecutiveAllowed ?? true;\n    this.customChecks = options.customChecks ?? [];\n    this.forcePreventStop = options.forcePreventStop ?? true;\n    this.reason = options.reason;\n\n    this.checkInvariant();\n  }\n\n  protected checkInvariant(): void {\n    if (this.minInvocations < 0) {\n      throw new ValueError(\"The 'minInvocations' argument must be non negative!\");\n    }\n\n    if (this.maxInvocations < 0) {\n      throw new ValueError(\"The 'maxInvocations' argument must be non negative!\");\n    }\n\n    if (this.minInvocations > this.maxInvocations) {\n      throw new ValueError(\n        \"The 'minInvocations' argument must be less than or equal to 'maxInvocations'!\",\n      );\n    }\n\n    const sourceName = extractTargetName(this.source);\n    if (this.before.has(this.source)) {\n      throw new ValueError(`Referencing self in 'before' is not allowed (${sourceName})!`);\n    }\n\n    if (this.forceAfterSet.has(this.source)) {\n      throw new ValueError(`Referencing self in 'forceAfter' is not allowed (${sourceName})!`);\n    }\n\n    const beforeAfterIntersection = new Set([...this.before].filter((x) => this.after.has(x)));\n    if (beforeAfterIntersection.size > 0) {\n      throw new ValueError(\n        `Tool specified as 'before' and 'after' at the same time: ${Array.from(beforeAfterIntersection).join(\", \")}!`,\n      );\n    }\n\n    const beforeForceAfterIntersection = new Set(\n      [...this.before].filter((x) => this.forceAfterSet.has(x)),\n    );\n    if (beforeForceAfterIntersection.size > 0) {\n      throw new ValueError(\n        `Tool specified as 'before' and 'forceAfter' at the same time: ${Array.from(beforeForceAfterIntersection).join(\", \")}!`,\n      );\n    }\n\n    if (this.forceAtStepValue !== undefined && this.forceAtStepValue < 1) {\n      throw new ValueError(\"The 'forceAtStep' argument must be >= 1!\");\n    }\n  }\n\n  async init(tools: AnyTool[], ctx: RunContext<any>): Promise<void> {\n    await super.init(tools, ctx);\n\n    const allTargets = new Set([...this.before, ...this.after, ...this.forceAfterSet, this.source]);\n    assertAllRulesFound(allTargets, tools);\n\n    for (const tool of tools) {\n      if (targetSeenIn(tool, this.source)) {\n        if (this.sourceTool && this.sourceTool !== tool) {\n          throw new ValueError(\n            `More than one occurrence of ${extractTargetName(this.source)} has been found!`,\n          );\n        }\n        this.sourceTool = tool;\n      }\n    }\n\n    if (!this.sourceTool) {\n      throw new ValueError(`Source tool ${extractTargetName(this.source)} was not found!`);\n    }\n\n    if (targetSeenIn(this.sourceTool, this.before)) {\n      throw new ValueError(`Referencing self in 'before' is not allowed: ${this.sourceTool.name}!`);\n    }\n\n    if (this.consecutiveAllowedValue && targetSeenIn(this.sourceTool, this.forceAfterSet)) {\n      throw new ValueError(\n        `Referencing self in 'forceAfter' is not allowed: ${this.sourceTool.name}. ` +\n          `It would prevent an infinite loop. Consider setting 'consecutiveAllowed' to false.`,\n      );\n    }\n  }\n\n  reset(): this {\n    this.before.clear();\n    this.after.clear();\n    this.forceAfterSet.clear();\n    return this;\n  }\n\n  async _run(state: RequirementAgentRunState, _: RunContext<typeof this>): Promise<Rule[]> {\n    const sourceTool = this.sourceTool;\n    if (!sourceTool) {\n      throw new RequirementError(\"Source was not found!\", this);\n    }\n\n    // Get steps from state (assuming state has steps property)\n    const steps = this.onlySuccessInvocations\n      ? state.steps.filter((step) => !step.error)\n      : state.steps;\n\n    const lastStepTool = steps.at(-1)?.tool;\n\n    const invocations = steps.filter((step) => step.tool === sourceTool).length;\n\n    const resolve = (allowed: boolean): Rule[] => {\n      const currentStep = steps.length + 1;\n      if (!allowed && this.forceAtStepValue === currentStep) {\n        throw new RequirementError(\n          `Tool '${sourceTool.name}' cannot be executed at step ${this.forceAtStepValue} ` +\n            `because it has not met all requirements.`,\n          this,\n        );\n      }\n\n      const forced = allowed\n        ? Boolean(\n            targetSeenIn(lastStepTool, this.forceAfterSet) || this.forceAtStepValue === currentStep,\n          )\n        : false;\n\n      return [\n        {\n          target: sourceTool.name,\n          allowed,\n          forced,\n          hidden: false,\n          preventStop: this.minInvocations > invocations || (forced && this.forcePreventStop),\n          reason: !allowed ? this.reason : undefined,\n        },\n      ];\n    };\n\n    // Check consecutive constraint\n    if (!this.consecutiveAllowedValue && sourceTool === lastStepTool) {\n      return resolve(false);\n    }\n\n    // Check max invocations\n    if (invocations >= this.maxInvocations) {\n      return resolve(false);\n    }\n\n    // Check after/before constraints\n    if (this.after.size > 0) {\n      const stepsAsToolCalls = steps.map((step) => step.tool).filter(isTruthy);\n      const afterToolsRemaining = new Set(this.after);\n\n      for (const stepTool of stepsAsToolCalls) {\n        if (targetSeenIn(stepTool, this.forceAfterSet)) {\n          return resolve(false);\n        }\n\n        const matcher = targetSeenIn(stepTool as any, this.after);\n        if (matcher) {\n          afterToolsRemaining.delete(matcher);\n        }\n      }\n\n      if (afterToolsRemaining.size > 0) {\n        return resolve(false);\n      }\n    }\n\n    // Check custom checks\n    for (const check of this.customChecks) {\n      if (!check(state)) {\n        return resolve(false);\n      }\n    }\n\n    return resolve(true);\n  }\n\n  async clone(): Promise<this> {\n    const instance = await super.clone();\n    instance.before = new Set(this.before);\n    instance.after = new Set(this.after);\n    instance.forceAfterSet = new Set(this.forceAfterSet);\n    instance.minInvocations = this.minInvocations;\n    instance.maxInvocations = this.maxInvocations;\n    instance.customChecks = [...this.customChecks];\n    instance.onlySuccessInvocations = this.onlySuccessInvocations;\n    instance.forceAtStepValue = this.forceAtStepValue;\n    instance.consecutiveAllowedValue = this.consecutiveAllowedValue;\n    instance.source = this.source;\n    instance.sourceTool = this.sourceTool;\n    instance.forcePreventStop = this.forcePreventStop;\n    instance.reason = this.reason;\n    return instance;\n  }\n}\n"]}

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

@@ -0,0 +1,107 @@
+'use strict';
+
+var context_cjs = require('../../../context.cjs');
+var emitter_cjs = require('../../../emitter/emitter.cjs');
+var errors_cjs = require('../../../errors.cjs');
+var remeda = require('remeda');
+var decoratorCache_cjs = require('../../../cache/decoratorCache.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 Requirement {
+  static {
+    __name(this, "Requirement");
+  }
+  name;
+  state = {};
+  enabled = true;
+  middlewares = [];
+  _priority = 10;
+  constructor(name) {
+    this.name = name || this.constructor.name;
+  }
+  get priority() {
+    return this._priority;
+  }
+  set priority(value) {
+    if (value <= 0) {
+      throw new errors_cjs.ValueError("Priority must be a positive integer.");
+    }
+    this._priority = value;
+  }
+  get emitter() {
+    return emitter_cjs.Emitter.root.child({
+      namespace: [
+        "requirement",
+        remeda.toCamelCase(this.name)
+      ],
+      creator: this
+    });
+  }
+  run(state) {
+    return context_cjs.RunContext.enter(this, {
+      signal: void 0,
+      params: [
+        state
+      ]
+    }, async (context) => {
+      return await this._run(state, context);
+    });
+  }
+  async init(tools, _) {
+    await this.emitter.emit("init", {
+      tools
+    });
+  }
+  async clone() {
+    const instance = Object.create(Object.getPrototypeOf(this));
+    instance.name = this.name;
+    instance.priority = this.priority;
+    instance.enabled = this.enabled;
+    instance.state = {
+      ...this.state
+    };
+    instance.middlewares = [
+      ...this.middlewares
+    ];
+    return instance;
+  }
+}
+_ts_decorate([
+  decoratorCache_cjs.Cache({
+    enumerable: false
+  }),
+  _ts_metadata("design:type", typeof emitter_cjs.Emitter === "undefined" ? Object : emitter_cjs.Emitter),
+  _ts_metadata("design:paramtypes", [])
+], Requirement.prototype, "emitter", null);
+class RequirementError extends errors_cjs.FrameworkError {
+  static {
+    __name(this, "RequirementError");
+  }
+  requirement;
+  constructor(message, requirement, cause, context) {
+    super(message, cause ? [
+      cause
+    ] : void 0, {
+      isFatal: true,
+      isRetryable: false,
+      context
+    }), this.requirement = requirement;
+  }
+}
+
+exports.Requirement = Requirement;
+exports.RequirementError = RequirementError;
+//# sourceMappingURL=requirement.cjs.map
+//# sourceMappingURL=requirement.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/agents/requirement/requirements/requirement.ts"],"names":["Requirement","name","state","enabled","middlewares","_priority","priority","value","ValueError","emitter","Emitter","root","child","namespace","toCamelCase","creator","run","RunContext","enter","signal","undefined","params","context","_run","init","tools","_","emit","clone","instance","Object","create","getPrototypeOf","enumerable","RequirementError","FrameworkError","message","requirement","cause","isFatal","isRetryable"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAwBO,MAAeA,WAAAA,CAAAA;AAAAA,EAAAA;;;AACbC,EAAAA,IAAAA;AACAC,EAAAA,KAAAA,GAA6B,EAAC;EAC9BC,OAAAA,GAAU,IAAA;AACVC,EAAAA,WAAAA,GAA6C,EAAA;EAE1CC,SAAAA,GAAY,EAAA;AAEtB,EAAA,WAAA,CAAYJ,IAAAA,EAAe;AACzB,IAAA,IAAA,CAAKA,IAAAA,GAAOA,IAAAA,IAAQ,IAAA,CAAK,WAAA,CAAYA,IAAAA;AACvC;AAEA,EAAA,IAAIK,QAAAA,GAAmB;AACrB,IAAA,OAAO,IAAA,CAAKD,SAAAA;AACd;AAEA,EAAA,IAAIC,SAASC,KAAAA,EAAe;AAC1B,IAAA,IAAIA,SAAS,CAAA,EAAG;AACd,MAAA,MAAM,IAAIC,sBAAW,sCAAA,CAAA;AACvB;AACA,IAAA,IAAA,CAAKH,SAAAA,GAAYE,KAAAA;AACnB;AAEA,EAAA,IACIE,OAAAA,GAAyC;AAC3C,IAAA,OAAOC,mBAAAA,CAAQC,KAAKC,KAAAA,CAAM;MACxBC,SAAAA,EAAW;AAAC,QAAA,aAAA;AAAeC,QAAAA,kBAAAA,CAAY,KAAKb,IAAI;;MAChDc,OAAAA,EAAS;KACX,CAAA;AACF;AAEAC,EAAAA,GAAAA,CAAId,KAAAA,EAAiC;AACnC,IAAA,OAAOe,sBAAAA,CAAWC,MAChB,IAAA,EACA;MAAEC,MAAAA,EAAQC,MAAAA;MAAWC,MAAAA,EAAQ;AAACnB,QAAAA;;AAAgB,KAAA,EAC9C,OAAOoB,OAAAA,KAAAA;AACL,MAAA,OAAO,MAAM,IAAA,CAAKC,IAAAA,CAAKrB,KAAAA,EAAOoB,OAAAA,CAAAA;KAChC,CAAA;AAEJ;EAIA,MAAME,IAAAA,CAAKC,OAAkBC,CAAAA,EAAmC;AAC9D,IAAA,MAAM,IAAA,CAAKjB,OAAAA,CAAQkB,IAAAA,CAAK,MAAA,EAAQ;AAAEF,MAAAA;KAAM,CAAA;AAC1C;AAEA,EAAA,MAAMG,KAAAA,GAAuB;AAC3B,IAAA,MAAMC,WAAWC,MAAAA,CAAOC,MAAAA,CAAOD,MAAAA,CAAOE,cAAAA,CAAe,IAAI,CAAA,CAAA;AACzDH,IAAAA,QAAAA,CAAS5B,OAAO,IAAA,CAAKA,IAAAA;AACrB4B,IAAAA,QAAAA,CAASvB,WAAW,IAAA,CAAKA,QAAAA;AACzBuB,IAAAA,QAAAA,CAAS1B,UAAU,IAAA,CAAKA,OAAAA;AACxB0B,IAAAA,QAAAA,CAAS3B,KAAAA,GAAQ;AAAE,MAAA,GAAG,IAAA,CAAKA;AAAM,KAAA;AACjC2B,IAAAA,QAAAA,CAASzB,WAAAA,GAAc;SAAI,IAAA,CAAKA;;AAChC,IAAA,OAAOyB,QAAAA;AACT;AACF;;;IAjCWI,UAAAA,EAAY;;;;;AAoChB,MAAMC,yBAAyBC,yBAAAA,CAAAA;AAAAA,EAAAA;;;;EACpC,WAAA,CACEC,OAAAA,EACgBC,WAAAA,EAChBC,KAAAA,EACAhB,OAAAA,EACA;AACA,IAAA,KAAA,CAAMc,SAASE,KAAAA,GAAQ;AAACA,MAAAA;QAASlB,MAAAA,EAAW;MAC1CmB,OAAAA,EAAS,IAAA;MACTC,WAAAA,EAAa,KAAA;AACblB,MAAAA;KACF,CAAA,EAAA,KARgBe,WAAAA,GAAAA,WAAAA;AASlB;AACF","file":"requirement.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { AnyTool } from \"@/tools/base.js\";\nimport { MiddlewareType, RunContext } from \"@/context.js\";\nimport { Callback, Emitter } from \"@/emitter/emitter.js\";\nimport { FrameworkError, ValueError } from \"@/errors.js\";\nimport { toCamelCase } from \"remeda\";\nimport type { RequirementAgentRunState } from \"@/agents/requirement/types.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\n\n// Rule definition\nexport interface Rule {\n  target: string;\n  allowed: boolean;\n  reason?: string;\n  preventStop: boolean;\n  forced: boolean;\n  hidden: boolean;\n}\n\n// Base Requirement class\nexport abstract class Requirement {\n  public name: string;\n  public state: Record<string, any> = {};\n  public enabled = true;\n  public middlewares: MiddlewareType<typeof this>[] = [];\n\n  protected _priority = 10;\n\n  constructor(name?: string) {\n    this.name = name || this.constructor.name;\n  }\n\n  get priority(): number {\n    return this._priority;\n  }\n\n  set priority(value: number) {\n    if (value <= 0) {\n      throw new ValueError(\"Priority must be a positive integer.\");\n    }\n    this._priority = value;\n  }\n\n  @Cache({ enumerable: false })\n  get emitter(): Emitter<RequirementCallbacks> {\n    return Emitter.root.child({\n      namespace: [\"requirement\", toCamelCase(this.name)],\n      creator: this,\n    });\n  }\n\n  run(state: RequirementAgentRunState) {\n    return RunContext.enter(\n      this,\n      { signal: undefined, params: [state] as const },\n      async (context) => {\n        return await this._run(state, context);\n      },\n    );\n  }\n\n  abstract _run(state: RequirementAgentRunState, _: RunContext<typeof this>): Promise<Rule[]>;\n\n  async init(tools: AnyTool[], _: RunContext<any>): Promise<void> {\n    await this.emitter.emit(\"init\", { tools });\n  }\n\n  async clone(): Promise<this> {\n    const instance = Object.create(Object.getPrototypeOf(this));\n    instance.name = this.name;\n    instance.priority = this.priority;\n    instance.enabled = this.enabled;\n    instance.state = { ...this.state };\n    instance.middlewares = [...this.middlewares];\n    return instance;\n  }\n}\n\n// Requirement error\nexport class RequirementError extends FrameworkError {\n  constructor(\n    message: string,\n    public readonly requirement?: Requirement,\n    cause?: Error,\n    context?: Record<string, any>,\n  ) {\n    super(message, cause ? [cause] : undefined, {\n      isFatal: true,\n      isRetryable: false,\n      context,\n    });\n  }\n}\n\nexport interface RequirementCallbacks {\n  init: Callback<{ tools: AnyTool[] }>;\n}\n"]}

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

@@ -0,0 +1,59 @@
+import { MiddlewareType, Run, RunContext } from '../../../context.cjs';
+import { AnyTool } from '../../../tools/base.cjs';
+import { E as Emitter, C as Callback } from '../../../emitter-jN55XZZq.cjs';
+import { FrameworkError } from '../../../errors.cjs';
+import { R as RequirementAgentRunState } from '../../../types-W0QttuP_.cjs';
+import '../../../internals/serializable.cjs';
+import '../../../internals/types.cjs';
+import '../../../internals/helpers/guards.cjs';
+import '../../../internals/helpers/promise.cjs';
+import 'ajv';
+import 'promise-based-task';
+import '../../../cache/base.cjs';
+import '../../../internals/helpers/schema.cjs';
+import 'zod';
+import 'zod-to-json-schema';
+import '../../../memory/base.cjs';
+import '../../../backend/message.cjs';
+import 'ai';
+import '../../../template.cjs';
+import '../../../chat-BOb9n7AJ.cjs';
+import '../../../backend/constants.cjs';
+import '../../../logger/logger.cjs';
+import 'pino';
+import '../../../base-XfWeXQ-S.cjs';
+
+interface Rule {
+    target: string;
+    allowed: boolean;
+    reason?: string;
+    preventStop: boolean;
+    forced: boolean;
+    hidden: boolean;
+}
+declare abstract class Requirement {
+    name: string;
+    state: Record<string, any>;
+    enabled: boolean;
+    middlewares: MiddlewareType<typeof this>[];
+    protected _priority: number;
+    constructor(name?: string);
+    get priority(): number;
+    set priority(value: number);
+    get emitter(): Emitter<RequirementCallbacks>;
+    run(state: RequirementAgentRunState): Run<Rule[], this, readonly [RequirementAgentRunState]>;
+    abstract _run(state: RequirementAgentRunState, _: RunContext<typeof this>): Promise<Rule[]>;
+    init(tools: AnyTool[], _: RunContext<any>): Promise<void>;
+    clone(): Promise<this>;
+}
+declare class RequirementError extends FrameworkError {
+    readonly requirement?: Requirement | undefined;
+    constructor(message: string, requirement?: Requirement | undefined, cause?: Error, context?: Record<string, any>);
+}
+interface RequirementCallbacks {
+    init: Callback<{
+        tools: AnyTool[];
+    }>;
+}
+
+export { Requirement, type RequirementCallbacks, RequirementError, type Rule };

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

@@ -0,0 +1,59 @@
+import { MiddlewareType, Run, RunContext } from '../../../context.js';
+import { AnyTool } from '../../../tools/base.js';
+import { E as Emitter, C as Callback } from '../../../emitter-36-9MnvA.js';
+import { FrameworkError } from '../../../errors.js';
+import { R as RequirementAgentRunState } from '../../../types-CJwiMH3u.js';
+import '../../../internals/serializable.js';
+import '../../../internals/types.js';
+import '../../../internals/helpers/guards.js';
+import '../../../internals/helpers/promise.js';
+import 'ajv';
+import 'promise-based-task';
+import '../../../cache/base.js';
+import '../../../internals/helpers/schema.js';
+import 'zod';
+import 'zod-to-json-schema';
+import '../../../memory/base.js';
+import '../../../backend/message.js';
+import 'ai';
+import '../../../template.js';
+import '../../../chat-DrqwUgD8.js';
+import '../../../backend/constants.js';
+import '../../../logger/logger.js';
+import 'pino';
+import '../../../base-CyFx7BRL.js';
+
+interface Rule {
+    target: string;
+    allowed: boolean;
+    reason?: string;
+    preventStop: boolean;
+    forced: boolean;
+    hidden: boolean;
+}
+declare abstract class Requirement {
+    name: string;
+    state: Record<string, any>;
+    enabled: boolean;
+    middlewares: MiddlewareType<typeof this>[];
+    protected _priority: number;
+    constructor(name?: string);
+    get priority(): number;
+    set priority(value: number);
+    get emitter(): Emitter<RequirementCallbacks>;
+    run(state: RequirementAgentRunState): Run<Rule[], this, readonly [RequirementAgentRunState]>;
+    abstract _run(state: RequirementAgentRunState, _: RunContext<typeof this>): Promise<Rule[]>;
+    init(tools: AnyTool[], _: RunContext<any>): Promise<void>;
+    clone(): Promise<this>;
+}
+declare class RequirementError extends FrameworkError {
+    readonly requirement?: Requirement | undefined;
+    constructor(message: string, requirement?: Requirement | undefined, cause?: Error, context?: Record<string, any>);
+}
+interface RequirementCallbacks {
+    init: Callback<{
+        tools: AnyTool[];
+    }>;
+}
+
+export { Requirement, type RequirementCallbacks, RequirementError, type Rule };

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

@@ -0,0 +1,104 @@
+import { RunContext } from '../../../context.js';
+import { Emitter } from '../../../emitter/emitter.js';
+import { ValueError, FrameworkError } from '../../../errors.js';
+import { toCamelCase } from 'remeda';
+import { Cache } from '../../../cache/decoratorCache.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 Requirement {
+  static {
+    __name(this, "Requirement");
+  }
+  name;
+  state = {};
+  enabled = true;
+  middlewares = [];
+  _priority = 10;
+  constructor(name) {
+    this.name = name || this.constructor.name;
+  }
+  get priority() {
+    return this._priority;
+  }
+  set priority(value) {
+    if (value <= 0) {
+      throw new ValueError("Priority must be a positive integer.");
+    }
+    this._priority = value;
+  }
+  get emitter() {
+    return Emitter.root.child({
+      namespace: [
+        "requirement",
+        toCamelCase(this.name)
+      ],
+      creator: this
+    });
+  }
+  run(state) {
+    return RunContext.enter(this, {
+      signal: void 0,
+      params: [
+        state
+      ]
+    }, async (context) => {
+      return await this._run(state, context);
+    });
+  }
+  async init(tools, _) {
+    await this.emitter.emit("init", {
+      tools
+    });
+  }
+  async clone() {
+    const instance = Object.create(Object.getPrototypeOf(this));
+    instance.name = this.name;
+    instance.priority = this.priority;
+    instance.enabled = this.enabled;
+    instance.state = {
+      ...this.state
+    };
+    instance.middlewares = [
+      ...this.middlewares
+    ];
+    return instance;
+  }
+}
+_ts_decorate([
+  Cache({
+    enumerable: false
+  }),
+  _ts_metadata("design:type", typeof Emitter === "undefined" ? Object : Emitter),
+  _ts_metadata("design:paramtypes", [])
+], Requirement.prototype, "emitter", null);
+class RequirementError extends FrameworkError {
+  static {
+    __name(this, "RequirementError");
+  }
+  requirement;
+  constructor(message, requirement, cause, context) {
+    super(message, cause ? [
+      cause
+    ] : void 0, {
+      isFatal: true,
+      isRetryable: false,
+      context
+    }), this.requirement = requirement;
+  }
+}
+
+export { Requirement, RequirementError };
+//# sourceMappingURL=requirement.js.map
+//# sourceMappingURL=requirement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/agents/requirement/requirements/requirement.ts"],"names":["Requirement","name","state","enabled","middlewares","_priority","priority","value","ValueError","emitter","Emitter","root","child","namespace","toCamelCase","creator","run","RunContext","enter","signal","undefined","params","context","_run","init","tools","_","emit","clone","instance","Object","create","getPrototypeOf","enumerable","RequirementError","FrameworkError","message","requirement","cause","isFatal","isRetryable"],"mappings":";;;;;;;;;;;;;;;;;;;AAwBO,MAAeA,WAAAA,CAAAA;AAAAA,EAAAA;;;AACbC,EAAAA,IAAAA;AACAC,EAAAA,KAAAA,GAA6B,EAAC;EAC9BC,OAAAA,GAAU,IAAA;AACVC,EAAAA,WAAAA,GAA6C,EAAA;EAE1CC,SAAAA,GAAY,EAAA;AAEtB,EAAA,WAAA,CAAYJ,IAAAA,EAAe;AACzB,IAAA,IAAA,CAAKA,IAAAA,GAAOA,IAAAA,IAAQ,IAAA,CAAK,WAAA,CAAYA,IAAAA;AACvC;AAEA,EAAA,IAAIK,QAAAA,GAAmB;AACrB,IAAA,OAAO,IAAA,CAAKD,SAAAA;AACd;AAEA,EAAA,IAAIC,SAASC,KAAAA,EAAe;AAC1B,IAAA,IAAIA,SAAS,CAAA,EAAG;AACd,MAAA,MAAM,IAAIC,WAAW,sCAAA,CAAA;AACvB;AACA,IAAA,IAAA,CAAKH,SAAAA,GAAYE,KAAAA;AACnB;AAEA,EAAA,IACIE,OAAAA,GAAyC;AAC3C,IAAA,OAAOC,OAAAA,CAAQC,KAAKC,KAAAA,CAAM;MACxBC,SAAAA,EAAW;AAAC,QAAA,aAAA;AAAeC,QAAAA,WAAAA,CAAY,KAAKb,IAAI;;MAChDc,OAAAA,EAAS;KACX,CAAA;AACF;AAEAC,EAAAA,GAAAA,CAAId,KAAAA,EAAiC;AACnC,IAAA,OAAOe,UAAAA,CAAWC,MAChB,IAAA,EACA;MAAEC,MAAAA,EAAQC,MAAAA;MAAWC,MAAAA,EAAQ;AAACnB,QAAAA;;AAAgB,KAAA,EAC9C,OAAOoB,OAAAA,KAAAA;AACL,MAAA,OAAO,MAAM,IAAA,CAAKC,IAAAA,CAAKrB,KAAAA,EAAOoB,OAAAA,CAAAA;KAChC,CAAA;AAEJ;EAIA,MAAME,IAAAA,CAAKC,OAAkBC,CAAAA,EAAmC;AAC9D,IAAA,MAAM,IAAA,CAAKjB,OAAAA,CAAQkB,IAAAA,CAAK,MAAA,EAAQ;AAAEF,MAAAA;KAAM,CAAA;AAC1C;AAEA,EAAA,MAAMG,KAAAA,GAAuB;AAC3B,IAAA,MAAMC,WAAWC,MAAAA,CAAOC,MAAAA,CAAOD,MAAAA,CAAOE,cAAAA,CAAe,IAAI,CAAA,CAAA;AACzDH,IAAAA,QAAAA,CAAS5B,OAAO,IAAA,CAAKA,IAAAA;AACrB4B,IAAAA,QAAAA,CAASvB,WAAW,IAAA,CAAKA,QAAAA;AACzBuB,IAAAA,QAAAA,CAAS1B,UAAU,IAAA,CAAKA,OAAAA;AACxB0B,IAAAA,QAAAA,CAAS3B,KAAAA,GAAQ;AAAE,MAAA,GAAG,IAAA,CAAKA;AAAM,KAAA;AACjC2B,IAAAA,QAAAA,CAASzB,WAAAA,GAAc;SAAI,IAAA,CAAKA;;AAChC,IAAA,OAAOyB,QAAAA;AACT;AACF;;;IAjCWI,UAAAA,EAAY;;;;;AAoChB,MAAMC,yBAAyBC,cAAAA,CAAAA;AAAAA,EAAAA;;;;EACpC,WAAA,CACEC,OAAAA,EACgBC,WAAAA,EAChBC,KAAAA,EACAhB,OAAAA,EACA;AACA,IAAA,KAAA,CAAMc,SAASE,KAAAA,GAAQ;AAACA,MAAAA;QAASlB,MAAAA,EAAW;MAC1CmB,OAAAA,EAAS,IAAA;MACTC,WAAAA,EAAa,KAAA;AACblB,MAAAA;KACF,CAAA,EAAA,KARgBe,WAAAA,GAAAA,WAAAA;AASlB;AACF","file":"requirement.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { AnyTool } from \"@/tools/base.js\";\nimport { MiddlewareType, RunContext } from \"@/context.js\";\nimport { Callback, Emitter } from \"@/emitter/emitter.js\";\nimport { FrameworkError, ValueError } from \"@/errors.js\";\nimport { toCamelCase } from \"remeda\";\nimport type { RequirementAgentRunState } from \"@/agents/requirement/types.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\n\n// Rule definition\nexport interface Rule {\n  target: string;\n  allowed: boolean;\n  reason?: string;\n  preventStop: boolean;\n  forced: boolean;\n  hidden: boolean;\n}\n\n// Base Requirement class\nexport abstract class Requirement {\n  public name: string;\n  public state: Record<string, any> = {};\n  public enabled = true;\n  public middlewares: MiddlewareType<typeof this>[] = [];\n\n  protected _priority = 10;\n\n  constructor(name?: string) {\n    this.name = name || this.constructor.name;\n  }\n\n  get priority(): number {\n    return this._priority;\n  }\n\n  set priority(value: number) {\n    if (value <= 0) {\n      throw new ValueError(\"Priority must be a positive integer.\");\n    }\n    this._priority = value;\n  }\n\n  @Cache({ enumerable: false })\n  get emitter(): Emitter<RequirementCallbacks> {\n    return Emitter.root.child({\n      namespace: [\"requirement\", toCamelCase(this.name)],\n      creator: this,\n    });\n  }\n\n  run(state: RequirementAgentRunState) {\n    return RunContext.enter(\n      this,\n      { signal: undefined, params: [state] as const },\n      async (context) => {\n        return await this._run(state, context);\n      },\n    );\n  }\n\n  abstract _run(state: RequirementAgentRunState, _: RunContext<typeof this>): Promise<Rule[]>;\n\n  async init(tools: AnyTool[], _: RunContext<any>): Promise<void> {\n    await this.emitter.emit(\"init\", { tools });\n  }\n\n  async clone(): Promise<this> {\n    const instance = Object.create(Object.getPrototypeOf(this));\n    instance.name = this.name;\n    instance.priority = this.priority;\n    instance.enabled = this.enabled;\n    instance.state = { ...this.state };\n    instance.middlewares = [...this.middlewares];\n    return instance;\n  }\n}\n\n// Requirement error\nexport class RequirementError extends FrameworkError {\n  constructor(\n    message: string,\n    public readonly requirement?: Requirement,\n    cause?: Error,\n    context?: Record<string, any>,\n  ) {\n    super(message, cause ? [cause] : undefined, {\n      isFatal: true,\n      isRetryable: false,\n      context,\n    });\n  }\n}\n\nexport interface RequirementCallbacks {\n  init: Callback<{ tools: AnyTool[] }>;\n}\n"]}