beeai-framework 0.1.21 → 0.1.22

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-CGKd_-kK.cjs';
+import { FrameworkError } from '../../../errors.cjs';
+import { R as RequirementAgentRunState } from '../../../types-Cx6f43du.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-DB_cf15S.cjs';
+import '../../../backend/constants.cjs';
+import '../../../logger/logger.cjs';
+import 'pino';
+import '../../../base-v-PYIq5G.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-CN7I4uSV.js';
+import { FrameworkError } from '../../../errors.js';
+import { R as RequirementAgentRunState } from '../../../types-BXkkbABd.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-BbCYMAdE.js';
+import '../../../backend/constants.js';
+import '../../../logger/logger.js';
+import 'pino';
+import '../../../base-BurRTBA7.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"]}

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-CGKd_-kK.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-CN7I4uSV.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"]}