beeai-framework 0.1.22 → 0.1.23

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

@@ -1,11 +1,11 @@
 import '../../../parsers/linePrefix.cjs';
 import '../types.cjs';
 import '../../../internals/serializable.cjs';
-export { B as BaseRunner, R as ReActAgentRunnerLLMInput, a as ReActAgentRunnerToolInput } from '../../../agent-BMfyig7X.cjs';
+export { B as BaseRunner, R as ReActAgentRunnerLLMInput, a as ReActAgentRunnerToolInput } from '../../../agent-BVuc9Nfn.cjs';
 import '../../../internals/helpers/counter.cjs';
 import '../../../memory/base.cjs';
 import '../../../context.cjs';
-import '../../../emitter-CGKd_-kK.cjs';
+import '../../../emitter-jN55XZZq.cjs';
 import 'node_modules/remeda/dist/ToString-DKW-jYvM.js';
 import '../../../parsers/field.cjs';
 import 'zod';
@@ -26,8 +26,8 @@ import 'zod-to-json-schema';
 import '../../../internals/helpers/promise.cjs';
 import '../prompts.cjs';
 import '../../../template.cjs';
-import '../../../chat-DB_cf15S.cjs';
+import '../../../chat-BOb9n7AJ.cjs';
 import '../../../backend/constants.cjs';
 import '../../../logger/logger.cjs';
 import 'pino';
-import '../../../base-v-PYIq5G.cjs';
+import '../../../base-XfWeXQ-S.cjs';

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

@@ -1,11 +1,11 @@
 import '../../../parsers/linePrefix.js';
 import '../types.js';
 import '../../../internals/serializable.js';
-export { B as BaseRunner, R as ReActAgentRunnerLLMInput, a as ReActAgentRunnerToolInput } from '../../../agent-Dxw8AGWb.js';
+export { B as BaseRunner, R as ReActAgentRunnerLLMInput, a as ReActAgentRunnerToolInput } from '../../../agent-Cuy8Q4gw.js';
 import '../../../internals/helpers/counter.js';
 import '../../../memory/base.js';
 import '../../../context.js';
-import '../../../emitter-CN7I4uSV.js';
+import '../../../emitter-36-9MnvA.js';
 import 'node_modules/remeda/dist/ToString-DKW-jYvM.js';
 import '../../../parsers/field.js';
 import 'zod';
@@ -26,8 +26,8 @@ import 'zod-to-json-schema';
 import '../../../internals/helpers/promise.js';
 import '../prompts.js';
 import '../../../template.js';
-import '../../../chat-BbCYMAdE.js';
+import '../../../chat-DrqwUgD8.js';
 import '../../../backend/constants.js';
 import '../../../logger/logger.js';
 import 'pino';
-import '../../../base-BurRTBA7.js';
+import '../../../base-CyFx7BRL.js';

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

@@ -46,12 +46,12 @@ declare const DeepThinkReActAgentSystemPrompt: PromptTemplate<zod.ZodObject<{
     }, zod.ZodTypeAny, "passthrough">>, "many">;
     createdAt: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
 }, "strip", zod.ZodTypeAny, {
+    instructions: string;
     tools: zod.objectOutputType<{
         name: zod.ZodString;
         description: zod.ZodString;
         schema: zod.ZodString;
     }, zod.ZodTypeAny, "passthrough">[];
-    instructions: string;
     createdAt?: string | null | undefined;
 }, {
     tools: zod.objectInputType<{

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

@@ -46,12 +46,12 @@ declare const DeepThinkReActAgentSystemPrompt: PromptTemplate<zod.ZodObject<{
     }, zod.ZodTypeAny, "passthrough">>, "many">;
     createdAt: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
 }, "strip", zod.ZodTypeAny, {
+    instructions: string;
     tools: zod.objectOutputType<{
         name: zod.ZodString;
         description: zod.ZodString;
         schema: zod.ZodString;
     }, zod.ZodTypeAny, "passthrough">[];
-    instructions: string;
     createdAt?: string | null | undefined;
 }, {
     tools: zod.objectInputType<{

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

@@ -4,10 +4,10 @@ import { PromptTemplate } from '../../../../template.cjs';
 import { AnyTool } from '../../../../tools/base.cjs';
 import { DefaultRunner } from '../default/runner.cjs';
 import { z } from 'zod';
-import { b as ReActAgentInput, c as ReActAgent } from '../../../../agent-BMfyig7X.cjs';
+import { b as ReActAgentInput, c as ReActAgent } from '../../../../agent-BVuc9Nfn.cjs';
 import { GetRunContext } from '../../../../context.cjs';
 import 'node_modules/remeda/dist/ToString-DKW-jYvM.js';
-import '../../../../emitter-CGKd_-kK.cjs';
+import '../../../../emitter-jN55XZZq.cjs';
 import '../../../../internals/types.cjs';
 import '../../../../internals/helpers/guards.cjs';
 import '../../../../internals/serializable.cjs';
@@ -21,7 +21,7 @@ import '../../../../backend/message.cjs';
 import 'ai';
 import '../../prompts.cjs';
 import 'ajv';
-import '../../../../chat-DB_cf15S.cjs';
+import '../../../../chat-BOb9n7AJ.cjs';
 import 'promise-based-task';
 import '../../../../cache/base.cjs';
 import '../../../../backend/constants.cjs';
@@ -30,7 +30,7 @@ import 'pino';
 import '../../../../internals/helpers/promise.cjs';
 import '../../../../internals/helpers/schema.cjs';
 import 'zod-to-json-schema';
-import '../../../../base-v-PYIq5G.cjs';
+import '../../../../base-XfWeXQ-S.cjs';
 import '../../../../internals/helpers/counter.cjs';
 
 declare class DeepThinkRunner extends DefaultRunner {
@@ -52,12 +52,12 @@ declare class DeepThinkRunner extends DefaultRunner {
             }, z.ZodTypeAny, "passthrough">>, "many">;
             createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
+            instructions: string;
             tools: z.objectOutputType<{
                 name: z.ZodString;
                 description: z.ZodString;
                 schema: z.ZodString;
             }, z.ZodTypeAny, "passthrough">[];
-            instructions: string;
             createdAt?: string | null | undefined;
         }, {
             tools: z.objectInputType<{

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

@@ -4,10 +4,10 @@ import { PromptTemplate } from '../../../../template.js';
 import { AnyTool } from '../../../../tools/base.js';
 import { DefaultRunner } from '../default/runner.js';
 import { z } from 'zod';
-import { b as ReActAgentInput, c as ReActAgent } from '../../../../agent-Dxw8AGWb.js';
+import { b as ReActAgentInput, c as ReActAgent } from '../../../../agent-Cuy8Q4gw.js';
 import { GetRunContext } from '../../../../context.js';
 import 'node_modules/remeda/dist/ToString-DKW-jYvM.js';
-import '../../../../emitter-CN7I4uSV.js';
+import '../../../../emitter-36-9MnvA.js';
 import '../../../../internals/types.js';
 import '../../../../internals/helpers/guards.js';
 import '../../../../internals/serializable.js';
@@ -21,7 +21,7 @@ import '../../../../backend/message.js';
 import 'ai';
 import '../../prompts.js';
 import 'ajv';
-import '../../../../chat-BbCYMAdE.js';
+import '../../../../chat-DrqwUgD8.js';
 import 'promise-based-task';
 import '../../../../cache/base.js';
 import '../../../../backend/constants.js';
@@ -30,7 +30,7 @@ import 'pino';
 import '../../../../internals/helpers/promise.js';
 import '../../../../internals/helpers/schema.js';
 import 'zod-to-json-schema';
-import '../../../../base-BurRTBA7.js';
+import '../../../../base-CyFx7BRL.js';
 import '../../../../internals/helpers/counter.js';
 
 declare class DeepThinkRunner extends DefaultRunner {
@@ -52,12 +52,12 @@ declare class DeepThinkRunner extends DefaultRunner {
             }, z.ZodTypeAny, "passthrough">>, "many">;
             createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
+            instructions: string;
             tools: z.objectOutputType<{
                 name: z.ZodString;
                 description: z.ZodString;
                 schema: z.ZodString;
             }, z.ZodTypeAny, "passthrough">[];
-            instructions: string;
             createdAt?: string | null | undefined;
         }, {
             tools: z.objectInputType<{

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

@@ -1,5 +1,5 @@
 import { PromptTemplate } from '../../../../template.cjs';
-import { B as BaseRunner, R as ReActAgentRunnerLLMInput, a as ReActAgentRunnerToolInput } from '../../../../agent-BMfyig7X.cjs';
+import { B as BaseRunner, R as ReActAgentRunnerLLMInput, a as ReActAgentRunnerToolInput } from '../../../../agent-BVuc9Nfn.cjs';
 import { ReActAgentRunIteration, ReActAgentRunInput, ReActAgentParserInput } from '../../types.cjs';
 import { AnyTool } from '../../../../tools/base.cjs';
 import { LinePrefixParser } from '../../../../parsers/linePrefix.cjs';
@@ -12,16 +12,16 @@ import '../../../../internals/helpers/guards.cjs';
 import '../../../../internals/serializable.cjs';
 import 'ajv';
 import '../../../../context.cjs';
-import '../../../../emitter-CGKd_-kK.cjs';
+import '../../../../emitter-jN55XZZq.cjs';
 import '../../../../internals/helpers/promise.cjs';
-import '../../../../base-v-PYIq5G.cjs';
-import '../../../../chat-DB_cf15S.cjs';
-import 'ai';
+import '../../../../base-XfWeXQ-S.cjs';
+import '../../../../chat-BOb9n7AJ.cjs';
 import 'promise-based-task';
 import '../../../../cache/base.cjs';
 import '../../../../backend/constants.cjs';
 import '../../../../logger/logger.cjs';
 import 'pino';
+import 'ai';
 import '../../../../internals/helpers/counter.cjs';
 import '../../prompts.cjs';
 import '../../../../parsers/field.cjs';
@@ -52,12 +52,12 @@ declare class DefaultRunner extends BaseRunner {
             }, z.ZodTypeAny, "passthrough">>, "many">;
             createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
+            instructions: string;
             tools: z.objectOutputType<{
                 name: z.ZodString;
                 description: z.ZodString;
                 schema: z.ZodString;
             }, z.ZodTypeAny, "passthrough">[];
-            instructions: string;
             createdAt?: string | null | undefined;
         }, {
             tools: z.objectInputType<{

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

@@ -1,5 +1,5 @@
 import { PromptTemplate } from '../../../../template.js';
-import { B as BaseRunner, R as ReActAgentRunnerLLMInput, a as ReActAgentRunnerToolInput } from '../../../../agent-Dxw8AGWb.js';
+import { B as BaseRunner, R as ReActAgentRunnerLLMInput, a as ReActAgentRunnerToolInput } from '../../../../agent-Cuy8Q4gw.js';
 import { ReActAgentRunIteration, ReActAgentRunInput, ReActAgentParserInput } from '../../types.js';
 import { AnyTool } from '../../../../tools/base.js';
 import { LinePrefixParser } from '../../../../parsers/linePrefix.js';
@@ -12,16 +12,16 @@ import '../../../../internals/helpers/guards.js';
 import '../../../../internals/serializable.js';
 import 'ajv';
 import '../../../../context.js';
-import '../../../../emitter-CN7I4uSV.js';
+import '../../../../emitter-36-9MnvA.js';
 import '../../../../internals/helpers/promise.js';
-import '../../../../base-BurRTBA7.js';
-import '../../../../chat-BbCYMAdE.js';
-import 'ai';
+import '../../../../base-CyFx7BRL.js';
+import '../../../../chat-DrqwUgD8.js';
 import 'promise-based-task';
 import '../../../../cache/base.js';
 import '../../../../backend/constants.js';
 import '../../../../logger/logger.js';
 import 'pino';
+import 'ai';
 import '../../../../internals/helpers/counter.js';
 import '../../prompts.js';
 import '../../../../parsers/field.js';
@@ -52,12 +52,12 @@ declare class DefaultRunner extends BaseRunner {
             }, z.ZodTypeAny, "passthrough">>, "many">;
             createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
+            instructions: string;
             tools: z.objectOutputType<{
                 name: z.ZodString;
                 description: z.ZodString;
                 schema: z.ZodString;
             }, z.ZodTypeAny, "passthrough">[];
-            instructions: string;
             createdAt?: string | null | undefined;
         }, {
             tools: z.objectInputType<{

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

@@ -46,12 +46,12 @@ declare const GraniteReActAgentSystemPrompt: PromptTemplate<zod.ZodObject<{
     }, zod.ZodTypeAny, "passthrough">>, "many">;
     createdAt: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
 }, "strip", zod.ZodTypeAny, {
+    instructions: string;
     tools: zod.objectOutputType<{
         name: zod.ZodString;
         description: zod.ZodString;
         schema: zod.ZodString;
     }, zod.ZodTypeAny, "passthrough">[];
-    instructions: string;
     createdAt?: string | null | undefined;
 }, {
     tools: zod.objectInputType<{

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

@@ -46,12 +46,12 @@ declare const GraniteReActAgentSystemPrompt: PromptTemplate<zod.ZodObject<{
     }, zod.ZodTypeAny, "passthrough">>, "many">;
     createdAt: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
 }, "strip", zod.ZodTypeAny, {
+    instructions: string;
     tools: zod.objectOutputType<{
         name: zod.ZodString;
         description: zod.ZodString;
         schema: zod.ZodString;
     }, zod.ZodTypeAny, "passthrough">[];
-    instructions: string;
     createdAt?: string | null | undefined;
 }, {
     tools: zod.objectInputType<{

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

@@ -4,10 +4,10 @@ import * as zod from 'zod';
 import { AnyTool } from '../../../../tools/base.cjs';
 import { DefaultRunner } from '../default/runner.cjs';
 import { ReActAgentRunOptions, ReActAgentParserInput } from '../../types.cjs';
-import { b as ReActAgentInput, c as ReActAgent } from '../../../../agent-BMfyig7X.cjs';
+import { b as ReActAgentInput, c as ReActAgent } from '../../../../agent-BVuc9Nfn.cjs';
 import { GetRunContext } from '../../../../context.cjs';
 import 'node_modules/remeda/dist/ToString-DKW-jYvM.js';
-import '../../../../emitter-CGKd_-kK.cjs';
+import '../../../../emitter-jN55XZZq.cjs';
 import '../../../../internals/types.cjs';
 import '../../../../internals/helpers/guards.cjs';
 import '../../../../internals/serializable.cjs';
@@ -25,8 +25,8 @@ import '../../../../internals/helpers/promise.cjs';
 import '../../../../backend/message.cjs';
 import 'ai';
 import '../../../../memory/base.cjs';
-import '../../../../base-v-PYIq5G.cjs';
-import '../../../../chat-DB_cf15S.cjs';
+import '../../../../base-XfWeXQ-S.cjs';
+import '../../../../chat-BOb9n7AJ.cjs';
 import '../../../../backend/constants.cjs';
 import '../../../../logger/logger.cjs';
 import 'pino';
@@ -53,12 +53,12 @@ declare class GraniteRunner extends DefaultRunner {
             }, zod.ZodTypeAny, "passthrough">>, "many">;
             createdAt: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
         }, "strip", zod.ZodTypeAny, {
+            instructions: string;
             tools: zod.objectOutputType<{
                 name: zod.ZodString;
                 description: zod.ZodString;
                 schema: zod.ZodString;
             }, zod.ZodTypeAny, "passthrough">[];
-            instructions: string;
             createdAt?: string | null | undefined;
         }, {
             tools: zod.objectInputType<{

package/dist/agents/react/runners/granite/runner.d.ts

@@ -4,10 +4,10 @@ import * as zod from 'zod';
 import { AnyTool } from '../../../../tools/base.js';
 import { DefaultRunner } from '../default/runner.js';
 import { ReActAgentRunOptions, ReActAgentParserInput } from '../../types.js';
-import { b as ReActAgentInput, c as ReActAgent } from '../../../../agent-Dxw8AGWb.js';
+import { b as ReActAgentInput, c as ReActAgent } from '../../../../agent-Cuy8Q4gw.js';
 import { GetRunContext } from '../../../../context.js';
 import 'node_modules/remeda/dist/ToString-DKW-jYvM.js';
-import '../../../../emitter-CN7I4uSV.js';
+import '../../../../emitter-36-9MnvA.js';
 import '../../../../internals/types.js';
 import '../../../../internals/helpers/guards.js';
 import '../../../../internals/serializable.js';
@@ -25,8 +25,8 @@ import '../../../../internals/helpers/promise.js';
 import '../../../../backend/message.js';
 import 'ai';
 import '../../../../memory/base.js';
-import '../../../../base-BurRTBA7.js';
-import '../../../../chat-BbCYMAdE.js';
+import '../../../../base-CyFx7BRL.js';
+import '../../../../chat-DrqwUgD8.js';
 import '../../../../backend/constants.js';
 import '../../../../logger/logger.js';
 import 'pino';
@@ -53,12 +53,12 @@ declare class GraniteRunner extends DefaultRunner {
             }, zod.ZodTypeAny, "passthrough">>, "many">;
             createdAt: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
         }, "strip", zod.ZodTypeAny, {
+            instructions: string;
             tools: zod.objectOutputType<{
                 name: zod.ZodString;
                 description: zod.ZodString;
                 schema: zod.ZodString;
             }, zod.ZodTypeAny, "passthrough">[];
-            instructions: string;
             createdAt?: string | null | undefined;
         }, {
             tools: zod.objectInputType<{

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

@@ -1,12 +1,12 @@
 import { BaseMemory } from '../../memory/base.cjs';
 import { Message } from '../../backend/message.cjs';
-import { C as Callback } from '../../emitter-CGKd_-kK.cjs';
+import { C as Callback } from '../../emitter-jN55XZZq.cjs';
 import { AnyTool, BaseToolRunOptions, ToolOutput, ToolError } from '../../tools/base.cjs';
 import { ReActAgentSystemPrompt, ReActAgentAssistantPrompt, ReActAgentUserPrompt, ReActAgentUserEmptyPrompt, ReActAgentToolErrorPrompt, ReActAgentToolInputErrorPrompt, ReActAgentToolNoResultsPrompt, ReActAgentToolNotFoundPrompt, ReActAgentSchemaErrorPrompt } from './prompts.cjs';
 import { LinePrefixParser } from '../../parsers/linePrefix.cjs';
 import { ZodParserField, JSONParserField } from '../../parsers/field.cjs';
 import { NonUndefined } from '../../internals/types.cjs';
-import { n as ChatModelOutput } from '../../chat-DB_cf15S.cjs';
+import { n as ChatModelOutput } from '../../chat-BOb9n7AJ.cjs';
 import '../../errors.cjs';
 import '../../internals/helpers/guards.cjs';
 import '../../internals/serializable.cjs';

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

@@ -1,12 +1,12 @@
 import { BaseMemory } from '../../memory/base.js';
 import { Message } from '../../backend/message.js';
-import { C as Callback } from '../../emitter-CN7I4uSV.js';
+import { C as Callback } from '../../emitter-36-9MnvA.js';
 import { AnyTool, BaseToolRunOptions, ToolOutput, ToolError } from '../../tools/base.js';
 import { ReActAgentSystemPrompt, ReActAgentAssistantPrompt, ReActAgentUserPrompt, ReActAgentUserEmptyPrompt, ReActAgentToolErrorPrompt, ReActAgentToolInputErrorPrompt, ReActAgentToolNoResultsPrompt, ReActAgentToolNotFoundPrompt, ReActAgentSchemaErrorPrompt } from './prompts.js';
 import { LinePrefixParser } from '../../parsers/linePrefix.js';
 import { ZodParserField, JSONParserField } from '../../parsers/field.js';
 import { NonUndefined } from '../../internals/types.js';
-import { n as ChatModelOutput } from '../../chat-BbCYMAdE.js';
+import { n as ChatModelOutput } from '../../chat-DrqwUgD8.js';
 import '../../errors.js';
 import '../../internals/helpers/guards.js';
 import '../../internals/serializable.js';

package/dist/agents/requirement/agent.cjs

@@ -146,7 +146,7 @@ class RequirementAgent extends base_cjs.BaseAgent {
       ...super.createSnapshot(),
       input: utils_cjs.shallowCopy(this.input),
       emitter: this.emitter,
-      runnerClass: this.runner
+      runner: this.runner
     };
   }
   set memory(memory) {

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/agents/requirement/agent.ts"],"names":["RequirementAgent","BaseAgent","emitter","Emitter","root","child","namespace","creator","input","runner","RequirementAgentRunner","memory","UnconstrainedMemory","tools","requirements","saveIntermediateSteps","finalAnswerAsTool","toolCallChecker","middlewares","push","register","_run","options","run","execution","maxRetriesPerStep","totalMaxRetries","maxIterations","createToolCallChecker","llm","expectedOutput","templates","newMessages","processInput","addMessages","messages","finalState","reset","addMany","lastPair","slice","answer","Error","result","state","prompt","userMessage","UserMessage","task","render","context","undefined","config","Object","assign","checker","ToolCallChecker","enabled","meta","name","description","length","extraDescription","map","tool","join","overrides","finalized","mapObj","system","RequirementAgentSystemPrompt","RequirementAgentTaskPrompt","toolError","RequirementAgentToolErrorPrompt","toolNoResult","RequirementAgentToolNoResultPrompt","key","defaultTemplate","override","PromptTemplate","role","instructions","notes","update","defaults","pickBy","isEmptyish","castArray","v","isDefined","createSnapshot","shallowCopy","runnerClass"],"mappings":"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","file":"agent.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { BaseAgent } from \"@/agents/base.js\";\nimport { AnyTool } from \"@/tools/base.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { ChatModel } from \"@/backend/chat.js\";\nimport type { GetRunContext, MiddlewareType } from \"@/context.js\";\nimport { UnconstrainedMemory } from \"@/memory/unconstrainedMemory.js\";\nimport { Message, UserMessage } from \"@/backend/message.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { mapObj } from \"@/internals/helpers/object.js\";\nimport { PromptTemplate } from \"@/template.js\";\nimport {\n  RequirementAgentCallbacks,\n  RequirementAgentExecutionConfig,\n  RequirementAgentOutput,\n  RequirementAgentRunInput,\n  RequirementAgentRunOptions,\n  RequirementAgentTemplates,\n} from \"./types.js\";\nimport {\n  RequirementAgentSystemPrompt,\n  RequirementAgentTaskPrompt,\n  RequirementAgentToolErrorPrompt,\n  RequirementAgentToolNoResultPrompt,\n} from \"./prompts.js\";\nimport { Requirement } from \"./requirements/requirement.js\";\nimport { RequirementAgentRunner } from \"./runner.js\";\nimport { ToolCallChecker, ToolCallCheckerConfig } from \"./utils/toolCallChecker.js\";\nimport { isDefined, isEmptyish, pickBy } from \"remeda\";\nimport { castArray } from \"@/internals/helpers/array.js\";\nimport type { RequiredExcept } from \"@/internals/types.js\";\n\nexport type RequirementAgentTemplateFactory<K extends keyof RequirementAgentTemplates> = (\n  template: RequirementAgentTemplates[K],\n) => RequirementAgentTemplates[K];\n\nexport interface RequirementAgentInput {\n  llm: ChatModel;\n  memory?: BaseMemory;\n  tools?: AnyTool[];\n  requirements?: Requirement[];\n  name?: string;\n  description?: string;\n  role?: string;\n  instructions?: string | string[];\n  notes?: string | string[];\n  toolCallChecker?: boolean | ToolCallCheckerConfig;\n  finalAnswerAsTool?: boolean;\n  saveIntermediateSteps?: boolean;\n  execution?: RequirementAgentExecutionConfig;\n  templates?: Partial<{\n    [K in keyof RequirementAgentTemplates]:\n      | RequirementAgentTemplates[K]\n      | RequirementAgentTemplateFactory<K>;\n  }>;\n  middlewares?: MiddlewareType<RequirementAgent>[];\n}\n\ntype InternalRequirementAgentInput = RequiredExcept<\n  RequirementAgentInput,\n  | \"role\"\n  | \"instructions\"\n  | \"name\"\n  | \"description\"\n  | \"templates\"\n  | \"notes\"\n  | \"execution\"\n  | \"middlewares\"\n>;\n\n/**\n * RequirementAgent - A declarative AI agent with rule-based constraints\n *\n * The RequirementAgent provides predictable, controlled execution behavior across\n * different language models through rule-based constraints (Requirements).\n * Requirements can be configured as strict or flexible as necessary, adapting to\n * task requirements while ensuring consistent execution regardless of the underlying\n * model's reasoning or tool-calling capabilities.\n */\nexport class RequirementAgent extends BaseAgent<\n  RequirementAgentRunInput,\n  RequirementAgentOutput,\n  RequirementAgentRunOptions\n> {\n  public readonly emitter = Emitter.root.child<RequirementAgentCallbacks>({\n    namespace: [\"agent\", \"requirement\"],\n    creator: this,\n  });\n\n  protected readonly input: InternalRequirementAgentInput;\n\n  protected runner: new (\n    ...args: ConstructorParameters<typeof RequirementAgentRunner>\n  ) => RequirementAgentRunner = RequirementAgentRunner;\n\n  constructor(input: RequirementAgentInput) {\n    super();\n    this.input = {\n      ...input,\n      memory: input.memory || new UnconstrainedMemory(),\n      tools: input.tools || [],\n      requirements: input.requirements || [],\n      saveIntermediateSteps: input.saveIntermediateSteps ?? true,\n      finalAnswerAsTool: input.finalAnswerAsTool ?? true,\n      toolCallChecker: input.toolCallChecker ?? true,\n    };\n    if (input.middlewares) {\n      this.middlewares.push(...input.middlewares);\n    }\n  }\n\n  static {\n    this.register();\n  }\n\n  protected async _run(\n    input: RequirementAgentRunInput,\n    options: RequirementAgentRunOptions = {},\n    run: GetRunContext<typeof this>,\n  ): Promise<RequirementAgentOutput> {\n    const execution: RequirementAgentExecutionConfig = {\n      maxRetriesPerStep: 3,\n      totalMaxRetries: 20,\n      maxIterations: 20,\n      ...this.input.execution,\n      ...options.execution,\n    };\n\n    const toolCallChecker = this.createToolCallChecker();\n\n    const runner = new this.runner(\n      this.input.llm,\n      execution,\n      this.input.tools || [],\n      this.input.requirements || [],\n      input.expectedOutput || null,\n      toolCallChecker,\n      run,\n      this.input.finalAnswerAsTool,\n      this.templates,\n    );\n\n    // Process input messages\n    const newMessages = this.processInput(input);\n    await runner.addMessages([...this.memory.messages]);\n    await runner.addMessages(newMessages);\n\n    // Run the agent\n    const finalState = await runner.run();\n\n    // Update memory\n    if (this.input.saveIntermediateSteps) {\n      this.memory.reset();\n      await this.memory.addMany(finalState.memory.messages);\n    } else {\n      await this.memory.addMany(newMessages);\n      // Add last tool call pair\n      const messages = finalState.memory.messages;\n      const lastPair = messages.slice(-2);\n      await this.memory.addMany(lastPair);\n    }\n\n    if (!finalState.answer) {\n      throw new Error(\"Agent did not produce a final answer\");\n    }\n\n    return {\n      result: finalState.answer,\n      memory: finalState.memory,\n      state: finalState,\n    };\n  }\n\n  protected processInput(input: RequirementAgentRunInput): Message[] {\n    if (!input.prompt) {\n      return [];\n    }\n\n    const userMessage = new UserMessage(\n      this.templates.task.render({\n        prompt: input.prompt,\n        context: input.context,\n        expectedOutput: typeof input.expectedOutput === \"string\" ? input.expectedOutput : undefined,\n      }),\n    );\n\n    return [userMessage];\n  }\n\n  protected createToolCallChecker(): ToolCallChecker {\n    const config: ToolCallCheckerConfig = {};\n\n    if (typeof this.input.toolCallChecker === \"object\") {\n      Object.assign(config, this.input.toolCallChecker);\n    }\n\n    const checker = new ToolCallChecker(config);\n    checker.enabled = this.input.toolCallChecker !== false;\n    return checker;\n  }\n\n  get meta(): AgentMeta {\n    const tools = this.input.tools || [];\n\n    return {\n      name: this.input.name ?? \"Requirement\",\n      tools,\n      description:\n        this.input.description ??\n        \"The RequirementAgent is a declarative AI agent implementation that provides predictable, \" +\n          \"controlled execution behavior across different language models through rule-based constraints.\",\n      ...(tools.length > 0 && {\n        extraDescription: [\n          `Tools that I can use to accomplish given task.`,\n          ...tools.map((tool) => `Tool '${tool.name}': ${tool.description}.`),\n        ].join(\"\\n\"),\n      }),\n    };\n  }\n\n  protected get templates(): RequirementAgentTemplates {\n    const overrides = this.input.templates || {};\n    const finalized = mapObj({\n      system: RequirementAgentSystemPrompt,\n      task: RequirementAgentTaskPrompt,\n      toolError: RequirementAgentToolErrorPrompt,\n      toolNoResult: RequirementAgentToolNoResultPrompt,\n    } as RequirementAgentTemplates)((\n      key,\n      defaultTemplate: RequirementAgentTemplates[typeof key],\n    ) => {\n      const override = overrides[key] ?? defaultTemplate;\n      if (override instanceof PromptTemplate) {\n        return override;\n      }\n      return override(defaultTemplate) ?? defaultTemplate;\n    });\n\n    if (this.input.role || this.input.instructions || this.input.notes) {\n      finalized.system.update({\n        defaults: pickBy(\n          {\n            role: this.input.role,\n            instructions: isEmptyish(this.input.instructions)\n              ? undefined\n              : castArray(this.input.instructions)\n                  .map((v) => `- ${v}`)\n                  .join(\"\\n\"),\n            notes: isEmptyish(this.input.notes)\n              ? undefined\n              : castArray(this.input.notes)\n                  .map((v) => `- ${v}`)\n                  .join(\"\\n\"),\n          },\n          isDefined,\n        ),\n      });\n    }\n\n    return finalized;\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      input: shallowCopy(this.input),\n      emitter: this.emitter,\n      runnerClass: this.runner,\n    };\n  }\n\n  set memory(memory: BaseMemory) {\n    this.input.memory = memory;\n  }\n\n  get memory(): BaseMemory {\n    return this.input.memory!;\n  }\n}\n"]}
+{"version":3,"sources":["../../../src/agents/requirement/agent.ts"],"names":["RequirementAgent","BaseAgent","emitter","Emitter","root","child","namespace","creator","input","runner","RequirementAgentRunner","memory","UnconstrainedMemory","tools","requirements","saveIntermediateSteps","finalAnswerAsTool","toolCallChecker","middlewares","push","register","_run","options","run","execution","maxRetriesPerStep","totalMaxRetries","maxIterations","createToolCallChecker","llm","expectedOutput","templates","newMessages","processInput","addMessages","messages","finalState","reset","addMany","lastPair","slice","answer","Error","result","state","prompt","userMessage","UserMessage","task","render","context","undefined","config","Object","assign","checker","ToolCallChecker","enabled","meta","name","description","length","extraDescription","map","tool","join","overrides","finalized","mapObj","system","RequirementAgentSystemPrompt","RequirementAgentTaskPrompt","toolError","RequirementAgentToolErrorPrompt","toolNoResult","RequirementAgentToolNoResultPrompt","key","defaultTemplate","override","PromptTemplate","role","instructions","notes","update","defaults","pickBy","isEmptyish","castArray","v","isDefined","createSnapshot","shallowCopy"],"mappings":"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","file":"agent.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { BaseAgent } from \"@/agents/base.js\";\nimport { AnyTool } from \"@/tools/base.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { ChatModel } from \"@/backend/chat.js\";\nimport type { GetRunContext, MiddlewareType } from \"@/context.js\";\nimport { UnconstrainedMemory } from \"@/memory/unconstrainedMemory.js\";\nimport { Message, UserMessage } from \"@/backend/message.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { mapObj } from \"@/internals/helpers/object.js\";\nimport { PromptTemplate } from \"@/template.js\";\nimport {\n  RequirementAgentCallbacks,\n  RequirementAgentExecutionConfig,\n  RequirementAgentOutput,\n  RequirementAgentRunInput,\n  RequirementAgentRunOptions,\n  RequirementAgentTemplates,\n} from \"./types.js\";\nimport {\n  RequirementAgentSystemPrompt,\n  RequirementAgentTaskPrompt,\n  RequirementAgentToolErrorPrompt,\n  RequirementAgentToolNoResultPrompt,\n} from \"./prompts.js\";\nimport { Requirement } from \"./requirements/requirement.js\";\nimport { RequirementAgentRunner } from \"./runner.js\";\nimport { ToolCallChecker, ToolCallCheckerConfig } from \"./utils/toolCallChecker.js\";\nimport { isDefined, isEmptyish, pickBy } from \"remeda\";\nimport { castArray } from \"@/internals/helpers/array.js\";\nimport type { RequiredExcept } from \"@/internals/types.js\";\n\nexport type RequirementAgentTemplateFactory<K extends keyof RequirementAgentTemplates> = (\n  template: RequirementAgentTemplates[K],\n) => RequirementAgentTemplates[K];\n\nexport interface RequirementAgentInput {\n  llm: ChatModel;\n  memory?: BaseMemory;\n  tools?: AnyTool[];\n  requirements?: Requirement[];\n  name?: string;\n  description?: string;\n  role?: string;\n  instructions?: string | string[];\n  notes?: string | string[];\n  toolCallChecker?: boolean | ToolCallCheckerConfig;\n  finalAnswerAsTool?: boolean;\n  saveIntermediateSteps?: boolean;\n  execution?: RequirementAgentExecutionConfig;\n  templates?: Partial<{\n    [K in keyof RequirementAgentTemplates]:\n      | RequirementAgentTemplates[K]\n      | RequirementAgentTemplateFactory<K>;\n  }>;\n  middlewares?: MiddlewareType<RequirementAgent>[];\n}\n\ntype InternalRequirementAgentInput = RequiredExcept<\n  RequirementAgentInput,\n  | \"role\"\n  | \"instructions\"\n  | \"name\"\n  | \"description\"\n  | \"templates\"\n  | \"notes\"\n  | \"execution\"\n  | \"middlewares\"\n>;\n\n/**\n * RequirementAgent - A declarative AI agent with rule-based constraints\n *\n * The RequirementAgent provides predictable, controlled execution behavior across\n * different language models through rule-based constraints (Requirements).\n * Requirements can be configured as strict or flexible as necessary, adapting to\n * task requirements while ensuring consistent execution regardless of the underlying\n * model's reasoning or tool-calling capabilities.\n */\nexport class RequirementAgent extends BaseAgent<\n  RequirementAgentRunInput,\n  RequirementAgentOutput,\n  RequirementAgentRunOptions\n> {\n  public readonly emitter = Emitter.root.child<RequirementAgentCallbacks>({\n    namespace: [\"agent\", \"requirement\"],\n    creator: this,\n  });\n\n  protected readonly input: InternalRequirementAgentInput;\n\n  protected runner: new (\n    ...args: ConstructorParameters<typeof RequirementAgentRunner>\n  ) => RequirementAgentRunner = RequirementAgentRunner;\n\n  constructor(input: RequirementAgentInput) {\n    super();\n    this.input = {\n      ...input,\n      memory: input.memory || new UnconstrainedMemory(),\n      tools: input.tools || [],\n      requirements: input.requirements || [],\n      saveIntermediateSteps: input.saveIntermediateSteps ?? true,\n      finalAnswerAsTool: input.finalAnswerAsTool ?? true,\n      toolCallChecker: input.toolCallChecker ?? true,\n    };\n    if (input.middlewares) {\n      this.middlewares.push(...input.middlewares);\n    }\n  }\n\n  static {\n    this.register();\n  }\n\n  protected async _run(\n    input: RequirementAgentRunInput,\n    options: RequirementAgentRunOptions = {},\n    run: GetRunContext<typeof this>,\n  ): Promise<RequirementAgentOutput> {\n    const execution: RequirementAgentExecutionConfig = {\n      maxRetriesPerStep: 3,\n      totalMaxRetries: 20,\n      maxIterations: 20,\n      ...this.input.execution,\n      ...options.execution,\n    };\n\n    const toolCallChecker = this.createToolCallChecker();\n\n    const runner = new this.runner(\n      this.input.llm,\n      execution,\n      this.input.tools || [],\n      this.input.requirements || [],\n      input.expectedOutput || null,\n      toolCallChecker,\n      run,\n      this.input.finalAnswerAsTool,\n      this.templates,\n    );\n\n    // Process input messages\n    const newMessages = this.processInput(input);\n    await runner.addMessages([...this.memory.messages]);\n    await runner.addMessages(newMessages);\n\n    // Run the agent\n    const finalState = await runner.run();\n\n    // Update memory\n    if (this.input.saveIntermediateSteps) {\n      this.memory.reset();\n      await this.memory.addMany(finalState.memory.messages);\n    } else {\n      await this.memory.addMany(newMessages);\n      // Add last tool call pair\n      const messages = finalState.memory.messages;\n      const lastPair = messages.slice(-2);\n      await this.memory.addMany(lastPair);\n    }\n\n    if (!finalState.answer) {\n      throw new Error(\"Agent did not produce a final answer\");\n    }\n\n    return {\n      result: finalState.answer,\n      memory: finalState.memory,\n      state: finalState,\n    };\n  }\n\n  protected processInput(input: RequirementAgentRunInput): Message[] {\n    if (!input.prompt) {\n      return [];\n    }\n\n    const userMessage = new UserMessage(\n      this.templates.task.render({\n        prompt: input.prompt,\n        context: input.context,\n        expectedOutput: typeof input.expectedOutput === \"string\" ? input.expectedOutput : undefined,\n      }),\n    );\n\n    return [userMessage];\n  }\n\n  protected createToolCallChecker(): ToolCallChecker {\n    const config: ToolCallCheckerConfig = {};\n\n    if (typeof this.input.toolCallChecker === \"object\") {\n      Object.assign(config, this.input.toolCallChecker);\n    }\n\n    const checker = new ToolCallChecker(config);\n    checker.enabled = this.input.toolCallChecker !== false;\n    return checker;\n  }\n\n  get meta(): AgentMeta {\n    const tools = this.input.tools || [];\n\n    return {\n      name: this.input.name ?? \"Requirement\",\n      tools,\n      description:\n        this.input.description ??\n        \"The RequirementAgent is a declarative AI agent implementation that provides predictable, \" +\n          \"controlled execution behavior across different language models through rule-based constraints.\",\n      ...(tools.length > 0 && {\n        extraDescription: [\n          `Tools that I can use to accomplish given task.`,\n          ...tools.map((tool) => `Tool '${tool.name}': ${tool.description}.`),\n        ].join(\"\\n\"),\n      }),\n    };\n  }\n\n  protected get templates(): RequirementAgentTemplates {\n    const overrides = this.input.templates || {};\n    const finalized = mapObj({\n      system: RequirementAgentSystemPrompt,\n      task: RequirementAgentTaskPrompt,\n      toolError: RequirementAgentToolErrorPrompt,\n      toolNoResult: RequirementAgentToolNoResultPrompt,\n    } as RequirementAgentTemplates)((\n      key,\n      defaultTemplate: RequirementAgentTemplates[typeof key],\n    ) => {\n      const override = overrides[key] ?? defaultTemplate;\n      if (override instanceof PromptTemplate) {\n        return override;\n      }\n      return override(defaultTemplate) ?? defaultTemplate;\n    });\n\n    if (this.input.role || this.input.instructions || this.input.notes) {\n      finalized.system.update({\n        defaults: pickBy(\n          {\n            role: this.input.role,\n            instructions: isEmptyish(this.input.instructions)\n              ? undefined\n              : castArray(this.input.instructions)\n                  .map((v) => `- ${v}`)\n                  .join(\"\\n\"),\n            notes: isEmptyish(this.input.notes)\n              ? undefined\n              : castArray(this.input.notes)\n                  .map((v) => `- ${v}`)\n                  .join(\"\\n\"),\n          },\n          isDefined,\n        ),\n      });\n    }\n\n    return finalized;\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      input: shallowCopy(this.input),\n      emitter: this.emitter,\n      runner: this.runner,\n    };\n  }\n\n  set memory(memory: BaseMemory) {\n    this.input.memory = memory;\n  }\n\n  get memory(): BaseMemory {\n    return this.input.memory!;\n  }\n}\n"]}

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

@@ -1,12 +1,12 @@
 import '../../context.cjs';
 import 'zod';
-import '../../base-v-PYIq5G.cjs';
+import '../../base-XfWeXQ-S.cjs';
 import '../../tools/base.cjs';
 import '../../memory/base.cjs';
-import '../../emitter-CGKd_-kK.cjs';
-import '../../chat-DB_cf15S.cjs';
+import '../../emitter-jN55XZZq.cjs';
+import '../../chat-BOb9n7AJ.cjs';
 import '../../backend/message.cjs';
-import '../../types-Cx6f43du.cjs';
+import '../../types-W0QttuP_.cjs';
 import './requirements/requirement.cjs';
 export { b as RequirementAgent, a as RequirementAgentInput, R as RequirementAgentTemplateFactory } from './runner.cjs';
 import './utils/toolCallChecker.cjs';

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

@@ -1,12 +1,12 @@
 import '../../context.js';
 import 'zod';
-import '../../base-BurRTBA7.js';
+import '../../base-CyFx7BRL.js';
 import '../../tools/base.js';
 import '../../memory/base.js';
-import '../../emitter-CN7I4uSV.js';
-import '../../chat-BbCYMAdE.js';
+import '../../emitter-36-9MnvA.js';
+import '../../chat-DrqwUgD8.js';
 import '../../backend/message.js';
-import '../../types-BXkkbABd.js';
+import '../../types-CJwiMH3u.js';
 import './requirements/requirement.js';
 export { b as RequirementAgent, a as RequirementAgentInput, R as RequirementAgentTemplateFactory } from './runner.js';
 import './utils/toolCallChecker.js';

package/dist/agents/requirement/agent.js

@@ -144,7 +144,7 @@ class RequirementAgent extends BaseAgent {
       ...super.createSnapshot(),
       input: shallowCopy(this.input),
       emitter: this.emitter,
-      runnerClass: this.runner
+      runner: this.runner
     };
   }
   set memory(memory) {

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/agents/requirement/agent.ts"],"names":["RequirementAgent","BaseAgent","emitter","Emitter","root","child","namespace","creator","input","runner","RequirementAgentRunner","memory","UnconstrainedMemory","tools","requirements","saveIntermediateSteps","finalAnswerAsTool","toolCallChecker","middlewares","push","register","_run","options","run","execution","maxRetriesPerStep","totalMaxRetries","maxIterations","createToolCallChecker","llm","expectedOutput","templates","newMessages","processInput","addMessages","messages","finalState","reset","addMany","lastPair","slice","answer","Error","result","state","prompt","userMessage","UserMessage","task","render","context","undefined","config","Object","assign","checker","ToolCallChecker","enabled","meta","name","description","length","extraDescription","map","tool","join","overrides","finalized","mapObj","system","RequirementAgentSystemPrompt","RequirementAgentTaskPrompt","toolError","RequirementAgentToolErrorPrompt","toolNoResult","RequirementAgentToolNoResultPrompt","key","defaultTemplate","override","PromptTemplate","role","instructions","notes","update","defaults","pickBy","isEmptyish","castArray","v","isDefined","createSnapshot","shallowCopy","runnerClass"],"mappings":"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","file":"agent.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { BaseAgent } from \"@/agents/base.js\";\nimport { AnyTool } from \"@/tools/base.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { ChatModel } from \"@/backend/chat.js\";\nimport type { GetRunContext, MiddlewareType } from \"@/context.js\";\nimport { UnconstrainedMemory } from \"@/memory/unconstrainedMemory.js\";\nimport { Message, UserMessage } from \"@/backend/message.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { mapObj } from \"@/internals/helpers/object.js\";\nimport { PromptTemplate } from \"@/template.js\";\nimport {\n  RequirementAgentCallbacks,\n  RequirementAgentExecutionConfig,\n  RequirementAgentOutput,\n  RequirementAgentRunInput,\n  RequirementAgentRunOptions,\n  RequirementAgentTemplates,\n} from \"./types.js\";\nimport {\n  RequirementAgentSystemPrompt,\n  RequirementAgentTaskPrompt,\n  RequirementAgentToolErrorPrompt,\n  RequirementAgentToolNoResultPrompt,\n} from \"./prompts.js\";\nimport { Requirement } from \"./requirements/requirement.js\";\nimport { RequirementAgentRunner } from \"./runner.js\";\nimport { ToolCallChecker, ToolCallCheckerConfig } from \"./utils/toolCallChecker.js\";\nimport { isDefined, isEmptyish, pickBy } from \"remeda\";\nimport { castArray } from \"@/internals/helpers/array.js\";\nimport type { RequiredExcept } from \"@/internals/types.js\";\n\nexport type RequirementAgentTemplateFactory<K extends keyof RequirementAgentTemplates> = (\n  template: RequirementAgentTemplates[K],\n) => RequirementAgentTemplates[K];\n\nexport interface RequirementAgentInput {\n  llm: ChatModel;\n  memory?: BaseMemory;\n  tools?: AnyTool[];\n  requirements?: Requirement[];\n  name?: string;\n  description?: string;\n  role?: string;\n  instructions?: string | string[];\n  notes?: string | string[];\n  toolCallChecker?: boolean | ToolCallCheckerConfig;\n  finalAnswerAsTool?: boolean;\n  saveIntermediateSteps?: boolean;\n  execution?: RequirementAgentExecutionConfig;\n  templates?: Partial<{\n    [K in keyof RequirementAgentTemplates]:\n      | RequirementAgentTemplates[K]\n      | RequirementAgentTemplateFactory<K>;\n  }>;\n  middlewares?: MiddlewareType<RequirementAgent>[];\n}\n\ntype InternalRequirementAgentInput = RequiredExcept<\n  RequirementAgentInput,\n  | \"role\"\n  | \"instructions\"\n  | \"name\"\n  | \"description\"\n  | \"templates\"\n  | \"notes\"\n  | \"execution\"\n  | \"middlewares\"\n>;\n\n/**\n * RequirementAgent - A declarative AI agent with rule-based constraints\n *\n * The RequirementAgent provides predictable, controlled execution behavior across\n * different language models through rule-based constraints (Requirements).\n * Requirements can be configured as strict or flexible as necessary, adapting to\n * task requirements while ensuring consistent execution regardless of the underlying\n * model's reasoning or tool-calling capabilities.\n */\nexport class RequirementAgent extends BaseAgent<\n  RequirementAgentRunInput,\n  RequirementAgentOutput,\n  RequirementAgentRunOptions\n> {\n  public readonly emitter = Emitter.root.child<RequirementAgentCallbacks>({\n    namespace: [\"agent\", \"requirement\"],\n    creator: this,\n  });\n\n  protected readonly input: InternalRequirementAgentInput;\n\n  protected runner: new (\n    ...args: ConstructorParameters<typeof RequirementAgentRunner>\n  ) => RequirementAgentRunner = RequirementAgentRunner;\n\n  constructor(input: RequirementAgentInput) {\n    super();\n    this.input = {\n      ...input,\n      memory: input.memory || new UnconstrainedMemory(),\n      tools: input.tools || [],\n      requirements: input.requirements || [],\n      saveIntermediateSteps: input.saveIntermediateSteps ?? true,\n      finalAnswerAsTool: input.finalAnswerAsTool ?? true,\n      toolCallChecker: input.toolCallChecker ?? true,\n    };\n    if (input.middlewares) {\n      this.middlewares.push(...input.middlewares);\n    }\n  }\n\n  static {\n    this.register();\n  }\n\n  protected async _run(\n    input: RequirementAgentRunInput,\n    options: RequirementAgentRunOptions = {},\n    run: GetRunContext<typeof this>,\n  ): Promise<RequirementAgentOutput> {\n    const execution: RequirementAgentExecutionConfig = {\n      maxRetriesPerStep: 3,\n      totalMaxRetries: 20,\n      maxIterations: 20,\n      ...this.input.execution,\n      ...options.execution,\n    };\n\n    const toolCallChecker = this.createToolCallChecker();\n\n    const runner = new this.runner(\n      this.input.llm,\n      execution,\n      this.input.tools || [],\n      this.input.requirements || [],\n      input.expectedOutput || null,\n      toolCallChecker,\n      run,\n      this.input.finalAnswerAsTool,\n      this.templates,\n    );\n\n    // Process input messages\n    const newMessages = this.processInput(input);\n    await runner.addMessages([...this.memory.messages]);\n    await runner.addMessages(newMessages);\n\n    // Run the agent\n    const finalState = await runner.run();\n\n    // Update memory\n    if (this.input.saveIntermediateSteps) {\n      this.memory.reset();\n      await this.memory.addMany(finalState.memory.messages);\n    } else {\n      await this.memory.addMany(newMessages);\n      // Add last tool call pair\n      const messages = finalState.memory.messages;\n      const lastPair = messages.slice(-2);\n      await this.memory.addMany(lastPair);\n    }\n\n    if (!finalState.answer) {\n      throw new Error(\"Agent did not produce a final answer\");\n    }\n\n    return {\n      result: finalState.answer,\n      memory: finalState.memory,\n      state: finalState,\n    };\n  }\n\n  protected processInput(input: RequirementAgentRunInput): Message[] {\n    if (!input.prompt) {\n      return [];\n    }\n\n    const userMessage = new UserMessage(\n      this.templates.task.render({\n        prompt: input.prompt,\n        context: input.context,\n        expectedOutput: typeof input.expectedOutput === \"string\" ? input.expectedOutput : undefined,\n      }),\n    );\n\n    return [userMessage];\n  }\n\n  protected createToolCallChecker(): ToolCallChecker {\n    const config: ToolCallCheckerConfig = {};\n\n    if (typeof this.input.toolCallChecker === \"object\") {\n      Object.assign(config, this.input.toolCallChecker);\n    }\n\n    const checker = new ToolCallChecker(config);\n    checker.enabled = this.input.toolCallChecker !== false;\n    return checker;\n  }\n\n  get meta(): AgentMeta {\n    const tools = this.input.tools || [];\n\n    return {\n      name: this.input.name ?? \"Requirement\",\n      tools,\n      description:\n        this.input.description ??\n        \"The RequirementAgent is a declarative AI agent implementation that provides predictable, \" +\n          \"controlled execution behavior across different language models through rule-based constraints.\",\n      ...(tools.length > 0 && {\n        extraDescription: [\n          `Tools that I can use to accomplish given task.`,\n          ...tools.map((tool) => `Tool '${tool.name}': ${tool.description}.`),\n        ].join(\"\\n\"),\n      }),\n    };\n  }\n\n  protected get templates(): RequirementAgentTemplates {\n    const overrides = this.input.templates || {};\n    const finalized = mapObj({\n      system: RequirementAgentSystemPrompt,\n      task: RequirementAgentTaskPrompt,\n      toolError: RequirementAgentToolErrorPrompt,\n      toolNoResult: RequirementAgentToolNoResultPrompt,\n    } as RequirementAgentTemplates)((\n      key,\n      defaultTemplate: RequirementAgentTemplates[typeof key],\n    ) => {\n      const override = overrides[key] ?? defaultTemplate;\n      if (override instanceof PromptTemplate) {\n        return override;\n      }\n      return override(defaultTemplate) ?? defaultTemplate;\n    });\n\n    if (this.input.role || this.input.instructions || this.input.notes) {\n      finalized.system.update({\n        defaults: pickBy(\n          {\n            role: this.input.role,\n            instructions: isEmptyish(this.input.instructions)\n              ? undefined\n              : castArray(this.input.instructions)\n                  .map((v) => `- ${v}`)\n                  .join(\"\\n\"),\n            notes: isEmptyish(this.input.notes)\n              ? undefined\n              : castArray(this.input.notes)\n                  .map((v) => `- ${v}`)\n                  .join(\"\\n\"),\n          },\n          isDefined,\n        ),\n      });\n    }\n\n    return finalized;\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      input: shallowCopy(this.input),\n      emitter: this.emitter,\n      runnerClass: this.runner,\n    };\n  }\n\n  set memory(memory: BaseMemory) {\n    this.input.memory = memory;\n  }\n\n  get memory(): BaseMemory {\n    return this.input.memory!;\n  }\n}\n"]}
+{"version":3,"sources":["../../../src/agents/requirement/agent.ts"],"names":["RequirementAgent","BaseAgent","emitter","Emitter","root","child","namespace","creator","input","runner","RequirementAgentRunner","memory","UnconstrainedMemory","tools","requirements","saveIntermediateSteps","finalAnswerAsTool","toolCallChecker","middlewares","push","register","_run","options","run","execution","maxRetriesPerStep","totalMaxRetries","maxIterations","createToolCallChecker","llm","expectedOutput","templates","newMessages","processInput","addMessages","messages","finalState","reset","addMany","lastPair","slice","answer","Error","result","state","prompt","userMessage","UserMessage","task","render","context","undefined","config","Object","assign","checker","ToolCallChecker","enabled","meta","name","description","length","extraDescription","map","tool","join","overrides","finalized","mapObj","system","RequirementAgentSystemPrompt","RequirementAgentTaskPrompt","toolError","RequirementAgentToolErrorPrompt","toolNoResult","RequirementAgentToolNoResultPrompt","key","defaultTemplate","override","PromptTemplate","role","instructions","notes","update","defaults","pickBy","isEmptyish","castArray","v","isDefined","createSnapshot","shallowCopy"],"mappings":"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","file":"agent.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { BaseAgent } from \"@/agents/base.js\";\nimport { AnyTool } from \"@/tools/base.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { ChatModel } from \"@/backend/chat.js\";\nimport type { GetRunContext, MiddlewareType } from \"@/context.js\";\nimport { UnconstrainedMemory } from \"@/memory/unconstrainedMemory.js\";\nimport { Message, UserMessage } from \"@/backend/message.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { mapObj } from \"@/internals/helpers/object.js\";\nimport { PromptTemplate } from \"@/template.js\";\nimport {\n  RequirementAgentCallbacks,\n  RequirementAgentExecutionConfig,\n  RequirementAgentOutput,\n  RequirementAgentRunInput,\n  RequirementAgentRunOptions,\n  RequirementAgentTemplates,\n} from \"./types.js\";\nimport {\n  RequirementAgentSystemPrompt,\n  RequirementAgentTaskPrompt,\n  RequirementAgentToolErrorPrompt,\n  RequirementAgentToolNoResultPrompt,\n} from \"./prompts.js\";\nimport { Requirement } from \"./requirements/requirement.js\";\nimport { RequirementAgentRunner } from \"./runner.js\";\nimport { ToolCallChecker, ToolCallCheckerConfig } from \"./utils/toolCallChecker.js\";\nimport { isDefined, isEmptyish, pickBy } from \"remeda\";\nimport { castArray } from \"@/internals/helpers/array.js\";\nimport type { RequiredExcept } from \"@/internals/types.js\";\n\nexport type RequirementAgentTemplateFactory<K extends keyof RequirementAgentTemplates> = (\n  template: RequirementAgentTemplates[K],\n) => RequirementAgentTemplates[K];\n\nexport interface RequirementAgentInput {\n  llm: ChatModel;\n  memory?: BaseMemory;\n  tools?: AnyTool[];\n  requirements?: Requirement[];\n  name?: string;\n  description?: string;\n  role?: string;\n  instructions?: string | string[];\n  notes?: string | string[];\n  toolCallChecker?: boolean | ToolCallCheckerConfig;\n  finalAnswerAsTool?: boolean;\n  saveIntermediateSteps?: boolean;\n  execution?: RequirementAgentExecutionConfig;\n  templates?: Partial<{\n    [K in keyof RequirementAgentTemplates]:\n      | RequirementAgentTemplates[K]\n      | RequirementAgentTemplateFactory<K>;\n  }>;\n  middlewares?: MiddlewareType<RequirementAgent>[];\n}\n\ntype InternalRequirementAgentInput = RequiredExcept<\n  RequirementAgentInput,\n  | \"role\"\n  | \"instructions\"\n  | \"name\"\n  | \"description\"\n  | \"templates\"\n  | \"notes\"\n  | \"execution\"\n  | \"middlewares\"\n>;\n\n/**\n * RequirementAgent - A declarative AI agent with rule-based constraints\n *\n * The RequirementAgent provides predictable, controlled execution behavior across\n * different language models through rule-based constraints (Requirements).\n * Requirements can be configured as strict or flexible as necessary, adapting to\n * task requirements while ensuring consistent execution regardless of the underlying\n * model's reasoning or tool-calling capabilities.\n */\nexport class RequirementAgent extends BaseAgent<\n  RequirementAgentRunInput,\n  RequirementAgentOutput,\n  RequirementAgentRunOptions\n> {\n  public readonly emitter = Emitter.root.child<RequirementAgentCallbacks>({\n    namespace: [\"agent\", \"requirement\"],\n    creator: this,\n  });\n\n  protected readonly input: InternalRequirementAgentInput;\n\n  protected runner: new (\n    ...args: ConstructorParameters<typeof RequirementAgentRunner>\n  ) => RequirementAgentRunner = RequirementAgentRunner;\n\n  constructor(input: RequirementAgentInput) {\n    super();\n    this.input = {\n      ...input,\n      memory: input.memory || new UnconstrainedMemory(),\n      tools: input.tools || [],\n      requirements: input.requirements || [],\n      saveIntermediateSteps: input.saveIntermediateSteps ?? true,\n      finalAnswerAsTool: input.finalAnswerAsTool ?? true,\n      toolCallChecker: input.toolCallChecker ?? true,\n    };\n    if (input.middlewares) {\n      this.middlewares.push(...input.middlewares);\n    }\n  }\n\n  static {\n    this.register();\n  }\n\n  protected async _run(\n    input: RequirementAgentRunInput,\n    options: RequirementAgentRunOptions = {},\n    run: GetRunContext<typeof this>,\n  ): Promise<RequirementAgentOutput> {\n    const execution: RequirementAgentExecutionConfig = {\n      maxRetriesPerStep: 3,\n      totalMaxRetries: 20,\n      maxIterations: 20,\n      ...this.input.execution,\n      ...options.execution,\n    };\n\n    const toolCallChecker = this.createToolCallChecker();\n\n    const runner = new this.runner(\n      this.input.llm,\n      execution,\n      this.input.tools || [],\n      this.input.requirements || [],\n      input.expectedOutput || null,\n      toolCallChecker,\n      run,\n      this.input.finalAnswerAsTool,\n      this.templates,\n    );\n\n    // Process input messages\n    const newMessages = this.processInput(input);\n    await runner.addMessages([...this.memory.messages]);\n    await runner.addMessages(newMessages);\n\n    // Run the agent\n    const finalState = await runner.run();\n\n    // Update memory\n    if (this.input.saveIntermediateSteps) {\n      this.memory.reset();\n      await this.memory.addMany(finalState.memory.messages);\n    } else {\n      await this.memory.addMany(newMessages);\n      // Add last tool call pair\n      const messages = finalState.memory.messages;\n      const lastPair = messages.slice(-2);\n      await this.memory.addMany(lastPair);\n    }\n\n    if (!finalState.answer) {\n      throw new Error(\"Agent did not produce a final answer\");\n    }\n\n    return {\n      result: finalState.answer,\n      memory: finalState.memory,\n      state: finalState,\n    };\n  }\n\n  protected processInput(input: RequirementAgentRunInput): Message[] {\n    if (!input.prompt) {\n      return [];\n    }\n\n    const userMessage = new UserMessage(\n      this.templates.task.render({\n        prompt: input.prompt,\n        context: input.context,\n        expectedOutput: typeof input.expectedOutput === \"string\" ? input.expectedOutput : undefined,\n      }),\n    );\n\n    return [userMessage];\n  }\n\n  protected createToolCallChecker(): ToolCallChecker {\n    const config: ToolCallCheckerConfig = {};\n\n    if (typeof this.input.toolCallChecker === \"object\") {\n      Object.assign(config, this.input.toolCallChecker);\n    }\n\n    const checker = new ToolCallChecker(config);\n    checker.enabled = this.input.toolCallChecker !== false;\n    return checker;\n  }\n\n  get meta(): AgentMeta {\n    const tools = this.input.tools || [];\n\n    return {\n      name: this.input.name ?? \"Requirement\",\n      tools,\n      description:\n        this.input.description ??\n        \"The RequirementAgent is a declarative AI agent implementation that provides predictable, \" +\n          \"controlled execution behavior across different language models through rule-based constraints.\",\n      ...(tools.length > 0 && {\n        extraDescription: [\n          `Tools that I can use to accomplish given task.`,\n          ...tools.map((tool) => `Tool '${tool.name}': ${tool.description}.`),\n        ].join(\"\\n\"),\n      }),\n    };\n  }\n\n  protected get templates(): RequirementAgentTemplates {\n    const overrides = this.input.templates || {};\n    const finalized = mapObj({\n      system: RequirementAgentSystemPrompt,\n      task: RequirementAgentTaskPrompt,\n      toolError: RequirementAgentToolErrorPrompt,\n      toolNoResult: RequirementAgentToolNoResultPrompt,\n    } as RequirementAgentTemplates)((\n      key,\n      defaultTemplate: RequirementAgentTemplates[typeof key],\n    ) => {\n      const override = overrides[key] ?? defaultTemplate;\n      if (override instanceof PromptTemplate) {\n        return override;\n      }\n      return override(defaultTemplate) ?? defaultTemplate;\n    });\n\n    if (this.input.role || this.input.instructions || this.input.notes) {\n      finalized.system.update({\n        defaults: pickBy(\n          {\n            role: this.input.role,\n            instructions: isEmptyish(this.input.instructions)\n              ? undefined\n              : castArray(this.input.instructions)\n                  .map((v) => `- ${v}`)\n                  .join(\"\\n\"),\n            notes: isEmptyish(this.input.notes)\n              ? undefined\n              : castArray(this.input.notes)\n                  .map((v) => `- ${v}`)\n                  .join(\"\\n\"),\n          },\n          isDefined,\n        ),\n      });\n    }\n\n    return finalized;\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      input: shallowCopy(this.input),\n      emitter: this.emitter,\n      runner: this.runner,\n    };\n  }\n\n  set memory(memory: BaseMemory) {\n    this.input.memory = memory;\n  }\n\n  get memory(): BaseMemory {\n    return this.input.memory!;\n  }\n}\n"]}