beeai-framework 0.1.21 → 0.1.23

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

@@ -0,0 +1,115 @@
+import { RunContext, MiddlewareType, GetRunContext } from '../../context.cjs';
+import * as zod from 'zod';
+import { z } from 'zod';
+import { a as BaseAgent, c as AgentMeta } from '../../base-XfWeXQ-S.cjs';
+import { AnyTool } from '../../tools/base.cjs';
+import { BaseMemory } from '../../memory/base.cjs';
+import { E as Emitter } from '../../emitter-jN55XZZq.cjs';
+import { m as ChatModel, n as ChatModelOutput, d as ChatModelInput } from '../../chat-BOb9n7AJ.cjs';
+import { AssistantMessage, ToolMessage, Message } from '../../backend/message.cjs';
+import { c as RequirementAgentExecutionConfig, d as RequirementAgentTemplates, R as RequirementAgentRunState, a as RequirementAgentRequest, e as RequirementAgentRunInput, f as RequirementAgentOutput, g as RequirementAgentRunOptions, h as RequirementAgentCallbacks } from '../../types-W0QttuP_.cjs';
+import { Requirement, Rule } from './requirements/requirement.cjs';
+import { ToolCallPart } from 'ai';
+import { RetryCounter } from '../../internals/helpers/counter.cjs';
+import { RequirementsReasoner } from './utils/llm.cjs';
+import { ToolCallChecker, ToolCallCheckerConfig } from './utils/toolCallChecker.cjs';
+import { RequiredExcept } from '../../internals/types.cjs';
+import '../../internals/serializable.cjs';
+import '../../internals/helpers/guards.cjs';
+import '../../internals/helpers/promise.cjs';
+import '../../errors.cjs';
+import 'ajv';
+import 'promise-based-task';
+import '../../cache/base.cjs';
+import '../../internals/helpers/schema.cjs';
+import 'zod-to-json-schema';
+import '../../backend/constants.cjs';
+import '../../template.cjs';
+import '../../logger/logger.cjs';
+import 'pino';
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * Runner for RequirementAgent execution
+ */
+declare class RequirementAgentRunner {
+    protected readonly llm: ChatModel;
+    protected readonly runConfig: RequirementAgentExecutionConfig;
+    protected readonly requirements: Requirement[];
+    protected readonly toolCallCycleChecker: ToolCallChecker;
+    protected readonly ctx: RunContext<RequirementAgent>;
+    protected forceFinalAnswerAsTool: boolean;
+    protected readonly templates: RequirementAgentTemplates;
+    protected readonly state: RequirementAgentRunState;
+    protected readonly reasoner: RequirementsReasoner;
+    protected readonly iterationErrorCounter: RetryCounter;
+    protected readonly globalErrorCounter: RetryCounter;
+    constructor(llm: ChatModel, runConfig: RequirementAgentExecutionConfig, tools: AnyTool[], requirements: Requirement[], expectedOutput: string | z.ZodSchema | null, toolCallCycleChecker: ToolCallChecker, ctx: RunContext<RequirementAgent>, forceFinalAnswerAsTool: boolean, templates: RequirementAgentTemplates);
+    protected incrementIteration(): void;
+    protected runLLM(request: RequirementAgentRequest): Promise<ChatModelOutput>;
+    protected prepareLLMRequest(request: RequirementAgentRequest): Promise<ChatModelInput>;
+    protected createFinalAnswerToolCall(fullText: string): Promise<AssistantMessage | null>;
+    protected createRequest(extraRules?: Rule[]): Promise<RequirementAgentRequest>;
+    protected invokeToolCalls(tools: AnyTool[], toolCalls: ToolCallPart[]): Promise<ToolMessage[]>;
+    addMessages(messages: Message[]): Promise<void>;
+    run(): Promise<RequirementAgentRunState>;
+    protected runIteration(request: RequirementAgentRequest): Promise<ChatModelOutput>;
+    private createFinalAnswerStream;
+}
+
+type RequirementAgentTemplateFactory<K extends keyof RequirementAgentTemplates> = (template: RequirementAgentTemplates[K]) => RequirementAgentTemplates[K];
+interface RequirementAgentInput {
+    llm: ChatModel;
+    memory?: BaseMemory;
+    tools?: AnyTool[];
+    requirements?: Requirement[];
+    name?: string;
+    description?: string;
+    role?: string;
+    instructions?: string | string[];
+    notes?: string | string[];
+    toolCallChecker?: boolean | ToolCallCheckerConfig;
+    finalAnswerAsTool?: boolean;
+    saveIntermediateSteps?: boolean;
+    execution?: RequirementAgentExecutionConfig;
+    templates?: Partial<{
+        [K in keyof RequirementAgentTemplates]: RequirementAgentTemplates[K] | RequirementAgentTemplateFactory<K>;
+    }>;
+    middlewares?: MiddlewareType<RequirementAgent>[];
+}
+type InternalRequirementAgentInput = RequiredExcept<RequirementAgentInput, "role" | "instructions" | "name" | "description" | "templates" | "notes" | "execution" | "middlewares">;
+/**
+ * RequirementAgent - A declarative AI agent with rule-based constraints
+ *
+ * The RequirementAgent provides predictable, controlled execution behavior across
+ * different language models through rule-based constraints (Requirements).
+ * Requirements can be configured as strict or flexible as necessary, adapting to
+ * task requirements while ensuring consistent execution regardless of the underlying
+ * model's reasoning or tool-calling capabilities.
+ */
+declare class RequirementAgent extends BaseAgent<RequirementAgentRunInput, RequirementAgentOutput, RequirementAgentRunOptions> {
+    readonly emitter: Emitter<RequirementAgentCallbacks>;
+    protected readonly input: InternalRequirementAgentInput;
+    protected runner: new (...args: ConstructorParameters<typeof RequirementAgentRunner>) => RequirementAgentRunner;
+    constructor(input: RequirementAgentInput);
+    protected _run(input: RequirementAgentRunInput, options: RequirementAgentRunOptions | undefined, run: GetRunContext<typeof this>): Promise<RequirementAgentOutput>;
+    protected processInput(input: RequirementAgentRunInput): Message[];
+    protected createToolCallChecker(): ToolCallChecker;
+    get meta(): AgentMeta;
+    protected get templates(): RequirementAgentTemplates;
+    createSnapshot(): {
+        input: InternalRequirementAgentInput;
+        emitter: Emitter<RequirementAgentCallbacks>;
+        runner: new (llm: ChatModel, runConfig: RequirementAgentExecutionConfig, tools: AnyTool[], requirements: Requirement[], expectedOutput: string | zod.ZodType<any, zod.ZodTypeDef, any> | null, toolCallCycleChecker: ToolCallChecker, ctx: RunContext<RequirementAgent, any>, forceFinalAnswerAsTool: boolean, templates: RequirementAgentTemplates) => RequirementAgentRunner;
+        isRunning: boolean;
+        middlewares: MiddlewareType<any>[];
+    };
+    set memory(memory: BaseMemory);
+    get memory(): BaseMemory;
+}
+
+export { type RequirementAgentTemplateFactory as R, RequirementAgentRunner, type RequirementAgentInput as a, RequirementAgent as b };

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

@@ -0,0 +1,115 @@
+import { RunContext, MiddlewareType, GetRunContext } from '../../context.js';
+import * as zod from 'zod';
+import { z } from 'zod';
+import { a as BaseAgent, c as AgentMeta } from '../../base-CyFx7BRL.js';
+import { AnyTool } from '../../tools/base.js';
+import { BaseMemory } from '../../memory/base.js';
+import { E as Emitter } from '../../emitter-36-9MnvA.js';
+import { m as ChatModel, n as ChatModelOutput, d as ChatModelInput } from '../../chat-DrqwUgD8.js';
+import { AssistantMessage, ToolMessage, Message } from '../../backend/message.js';
+import { c as RequirementAgentExecutionConfig, d as RequirementAgentTemplates, R as RequirementAgentRunState, a as RequirementAgentRequest, e as RequirementAgentRunInput, f as RequirementAgentOutput, g as RequirementAgentRunOptions, h as RequirementAgentCallbacks } from '../../types-CJwiMH3u.js';
+import { Requirement, Rule } from './requirements/requirement.js';
+import { ToolCallPart } from 'ai';
+import { RetryCounter } from '../../internals/helpers/counter.js';
+import { RequirementsReasoner } from './utils/llm.js';
+import { ToolCallChecker, ToolCallCheckerConfig } from './utils/toolCallChecker.js';
+import { RequiredExcept } from '../../internals/types.js';
+import '../../internals/serializable.js';
+import '../../internals/helpers/guards.js';
+import '../../internals/helpers/promise.js';
+import '../../errors.js';
+import 'ajv';
+import 'promise-based-task';
+import '../../cache/base.js';
+import '../../internals/helpers/schema.js';
+import 'zod-to-json-schema';
+import '../../backend/constants.js';
+import '../../template.js';
+import '../../logger/logger.js';
+import 'pino';
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * Runner for RequirementAgent execution
+ */
+declare class RequirementAgentRunner {
+    protected readonly llm: ChatModel;
+    protected readonly runConfig: RequirementAgentExecutionConfig;
+    protected readonly requirements: Requirement[];
+    protected readonly toolCallCycleChecker: ToolCallChecker;
+    protected readonly ctx: RunContext<RequirementAgent>;
+    protected forceFinalAnswerAsTool: boolean;
+    protected readonly templates: RequirementAgentTemplates;
+    protected readonly state: RequirementAgentRunState;
+    protected readonly reasoner: RequirementsReasoner;
+    protected readonly iterationErrorCounter: RetryCounter;
+    protected readonly globalErrorCounter: RetryCounter;
+    constructor(llm: ChatModel, runConfig: RequirementAgentExecutionConfig, tools: AnyTool[], requirements: Requirement[], expectedOutput: string | z.ZodSchema | null, toolCallCycleChecker: ToolCallChecker, ctx: RunContext<RequirementAgent>, forceFinalAnswerAsTool: boolean, templates: RequirementAgentTemplates);
+    protected incrementIteration(): void;
+    protected runLLM(request: RequirementAgentRequest): Promise<ChatModelOutput>;
+    protected prepareLLMRequest(request: RequirementAgentRequest): Promise<ChatModelInput>;
+    protected createFinalAnswerToolCall(fullText: string): Promise<AssistantMessage | null>;
+    protected createRequest(extraRules?: Rule[]): Promise<RequirementAgentRequest>;
+    protected invokeToolCalls(tools: AnyTool[], toolCalls: ToolCallPart[]): Promise<ToolMessage[]>;
+    addMessages(messages: Message[]): Promise<void>;
+    run(): Promise<RequirementAgentRunState>;
+    protected runIteration(request: RequirementAgentRequest): Promise<ChatModelOutput>;
+    private createFinalAnswerStream;
+}
+
+type RequirementAgentTemplateFactory<K extends keyof RequirementAgentTemplates> = (template: RequirementAgentTemplates[K]) => RequirementAgentTemplates[K];
+interface RequirementAgentInput {
+    llm: ChatModel;
+    memory?: BaseMemory;
+    tools?: AnyTool[];
+    requirements?: Requirement[];
+    name?: string;
+    description?: string;
+    role?: string;
+    instructions?: string | string[];
+    notes?: string | string[];
+    toolCallChecker?: boolean | ToolCallCheckerConfig;
+    finalAnswerAsTool?: boolean;
+    saveIntermediateSteps?: boolean;
+    execution?: RequirementAgentExecutionConfig;
+    templates?: Partial<{
+        [K in keyof RequirementAgentTemplates]: RequirementAgentTemplates[K] | RequirementAgentTemplateFactory<K>;
+    }>;
+    middlewares?: MiddlewareType<RequirementAgent>[];
+}
+type InternalRequirementAgentInput = RequiredExcept<RequirementAgentInput, "role" | "instructions" | "name" | "description" | "templates" | "notes" | "execution" | "middlewares">;
+/**
+ * RequirementAgent - A declarative AI agent with rule-based constraints
+ *
+ * The RequirementAgent provides predictable, controlled execution behavior across
+ * different language models through rule-based constraints (Requirements).
+ * Requirements can be configured as strict or flexible as necessary, adapting to
+ * task requirements while ensuring consistent execution regardless of the underlying
+ * model's reasoning or tool-calling capabilities.
+ */
+declare class RequirementAgent extends BaseAgent<RequirementAgentRunInput, RequirementAgentOutput, RequirementAgentRunOptions> {
+    readonly emitter: Emitter<RequirementAgentCallbacks>;
+    protected readonly input: InternalRequirementAgentInput;
+    protected runner: new (...args: ConstructorParameters<typeof RequirementAgentRunner>) => RequirementAgentRunner;
+    constructor(input: RequirementAgentInput);
+    protected _run(input: RequirementAgentRunInput, options: RequirementAgentRunOptions | undefined, run: GetRunContext<typeof this>): Promise<RequirementAgentOutput>;
+    protected processInput(input: RequirementAgentRunInput): Message[];
+    protected createToolCallChecker(): ToolCallChecker;
+    get meta(): AgentMeta;
+    protected get templates(): RequirementAgentTemplates;
+    createSnapshot(): {
+        input: InternalRequirementAgentInput;
+        emitter: Emitter<RequirementAgentCallbacks>;
+        runner: new (llm: ChatModel, runConfig: RequirementAgentExecutionConfig, tools: AnyTool[], requirements: Requirement[], expectedOutput: string | zod.ZodType<any, zod.ZodTypeDef, any> | null, toolCallCycleChecker: ToolCallChecker, ctx: RunContext<RequirementAgent, any>, forceFinalAnswerAsTool: boolean, templates: RequirementAgentTemplates) => RequirementAgentRunner;
+        isRunning: boolean;
+        middlewares: MiddlewareType<any>[];
+    };
+    set memory(memory: BaseMemory);
+    get memory(): BaseMemory;
+}
+
+export { type RequirementAgentTemplateFactory as R, RequirementAgentRunner, type RequirementAgentInput as a, RequirementAgent as b };

package/dist/agents/requirement/runner.js

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

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

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

package/dist/agents/requirement/types.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+var zod = require('zod');
+
+const RequirementAgentSystemPromptInputSchema = zod.z.object({
+  role: zod.z.string().optional(),
+  instructions: zod.z.string().optional(),
+  notes: zod.z.string().optional(),
+  finalAnswerName: zod.z.string(),
+  finalAnswerSchema: zod.z.string().optional(),
+  finalAnswerInstructions: zod.z.string().optional(),
+  tools: zod.z.array(zod.z.object({
+    name: zod.z.string(),
+    description: zod.z.string(),
+    inputSchema: zod.z.string(),
+    allowed: zod.z.string(),
+    reason: zod.z.string().optional()
+  }))
+});
+const RequirementAgentTaskPromptInputSchema = zod.z.object({
+  prompt: zod.z.string(),
+  context: zod.z.string().optional(),
+  expectedOutput: zod.z.string().optional()
+});
+const RequirementAgentToolErrorPromptInputSchema = zod.z.object({
+  reason: zod.z.string()
+});
+const RequirementAgentToolNoResultPromptInputSchema = zod.z.object({
+  toolCall: zod.z.object({
+    tool: zod.z.any().optional(),
+    input: zod.z.unknown()
+  })
+});
+
+exports.RequirementAgentSystemPromptInputSchema = RequirementAgentSystemPromptInputSchema;
+exports.RequirementAgentTaskPromptInputSchema = RequirementAgentTaskPromptInputSchema;
+exports.RequirementAgentToolErrorPromptInputSchema = RequirementAgentToolErrorPromptInputSchema;
+exports.RequirementAgentToolNoResultPromptInputSchema = RequirementAgentToolNoResultPromptInputSchema;
+//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/agents/requirement/types.ts"],"names":["RequirementAgentSystemPromptInputSchema","z","object","role","string","optional","instructions","notes","finalAnswerName","finalAnswerSchema","finalAnswerInstructions","tools","array","name","description","inputSchema","allowed","reason","RequirementAgentTaskPromptInputSchema","prompt","context","expectedOutput","RequirementAgentToolErrorPromptInputSchema","RequirementAgentToolNoResultPromptInputSchema","toolCall","tool","any","input","unknown"],"mappings":";;;;AAeO,MAAMA,uCAAAA,GAA0CC,MAAEC,MAAAA,CAAO;EAC9DC,IAAAA,EAAMF,KAAAA,CAAEG,MAAAA,EAAM,CAAGC,QAAAA,EAAQ;EACzBC,YAAAA,EAAcL,KAAAA,CAAEG,MAAAA,EAAM,CAAGC,QAAAA,EAAQ;EACjCE,KAAAA,EAAON,KAAAA,CAAEG,MAAAA,EAAM,CAAGC,QAAAA,EAAQ;AAC1BG,EAAAA,eAAAA,EAAiBP,MAAEG,MAAAA,EAAM;EACzBK,iBAAAA,EAAmBR,KAAAA,CAAEG,MAAAA,EAAM,CAAGC,QAAAA,EAAQ;EACtCK,uBAAAA,EAAyBT,KAAAA,CAAEG,MAAAA,EAAM,CAAGC,QAAAA,EAAQ;EAC5CM,KAAAA,EAAOV,KAAAA,CAAEW,KAAAA,CACPX,KAAAA,CAAEC,MAAAA,CAAO;AACPW,IAAAA,IAAAA,EAAMZ,MAAEG,MAAAA,EAAM;AACdU,IAAAA,WAAAA,EAAab,MAAEG,MAAAA,EAAM;AACrBW,IAAAA,WAAAA,EAAad,MAAEG,MAAAA,EAAM;AACrBY,IAAAA,OAAAA,EAASf,MAAEG,MAAAA,EAAM;IACjBa,MAAAA,EAAQhB,KAAAA,CAAEG,MAAAA,EAAM,CAAGC,QAAAA;AACrB,GAAA,CAAA;AAEJ,CAAA;AAEO,MAAMa,qCAAAA,GAAwCjB,MAAEC,MAAAA,CAAO;AAC5DiB,EAAAA,MAAAA,EAAQlB,MAAEG,MAAAA,EAAM;EAChBgB,OAAAA,EAASnB,KAAAA,CAAEG,MAAAA,EAAM,CAAGC,QAAAA,EAAQ;EAC5BgB,cAAAA,EAAgBpB,KAAAA,CAAEG,MAAAA,EAAM,CAAGC,QAAAA;AAC7B,CAAA;AAEO,MAAMiB,0CAAAA,GAA6CrB,MAAEC,MAAAA,CAAO;AACjEe,EAAAA,MAAAA,EAAQhB,MAAEG,MAAAA;AACZ,CAAA;AAEO,MAAMmB,6CAAAA,GAAgDtB,MAAEC,MAAAA,CAAO;AACpEsB,EAAAA,QAAAA,EAAUvB,MAAEC,MAAAA,CAAO;IACjBuB,IAAAA,EAAMxB,KAAAA,CAAEyB,GAAAA,EAAG,CAAGrB,QAAAA,EAAQ;AACtBsB,IAAAA,KAAAA,EAAO1B,MAAE2B,OAAAA;GACX;AACF,CAAA","file":"types.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { AssistantMessage } from \"@/backend/message.js\";\nimport { AnyTool, ToolOutput } from \"@/tools/base.js\";\nimport { FrameworkError } from \"@/errors.js\";\nimport { PromptTemplate } from \"@/template.js\";\nimport { ChatModelOutput, ChatModelToolChoice, ChatModelUsage } from \"@/backend/chat.js\";\nimport { BaseAgentRunOptions } from \"@/agents/base.js\";\nimport { z } from \"zod\";\nimport { FinalAnswerTool } from \"@/agents/requirement/utils/tool.js\";\n\nexport const RequirementAgentSystemPromptInputSchema = z.object({\n  role: z.string().optional(),\n  instructions: z.string().optional(),\n  notes: z.string().optional(),\n  finalAnswerName: z.string(),\n  finalAnswerSchema: z.string().optional(),\n  finalAnswerInstructions: z.string().optional(),\n  tools: z.array(\n    z.object({\n      name: z.string(),\n      description: z.string(),\n      inputSchema: z.string(),\n      allowed: z.string(),\n      reason: z.string().optional(),\n    }),\n  ),\n});\n\nexport const RequirementAgentTaskPromptInputSchema = z.object({\n  prompt: z.string(),\n  context: z.string().optional(),\n  expectedOutput: z.string().optional(),\n});\n\nexport const RequirementAgentToolErrorPromptInputSchema = z.object({\n  reason: z.string(),\n});\n\nexport const RequirementAgentToolNoResultPromptInputSchema = z.object({\n  toolCall: z.object({\n    tool: z.any().optional(),\n    input: z.unknown(),\n  }),\n});\n\n// Template collection\nexport interface RequirementAgentTemplates {\n  system: PromptTemplate<typeof RequirementAgentSystemPromptInputSchema>;\n  task: PromptTemplate<typeof RequirementAgentTaskPromptInputSchema>;\n  toolError: PromptTemplate<typeof RequirementAgentToolErrorPromptInputSchema>;\n  toolNoResult: PromptTemplate<typeof RequirementAgentToolNoResultPromptInputSchema>;\n}\n\n// Run state types\nexport interface RequirementAgentRunStateStep {\n  id: string;\n  iteration: number;\n  tool: AnyTool | null;\n  input: unknown;\n  output: ToolOutput;\n  error: FrameworkError | null;\n}\n\nexport interface RequirementAgentRunState {\n  answer: AssistantMessage | null;\n  result: unknown;\n  memory: BaseMemory;\n  iteration: number;\n  steps: RequirementAgentRunStateStep[];\n  usage: ChatModelUsage;\n  // cost: ChatModelCost; TODO: not supported yet\n}\n\n// Agent output\nexport interface RequirementAgentOutput {\n  result: AssistantMessage;\n  memory: BaseMemory;\n  state: RequirementAgentRunState;\n}\n\n// Internal request structure\nexport interface RequirementAgentRequest {\n  tools: AnyTool[];\n  allowedTools: AnyTool[];\n  reasonByTool: WeakMap<AnyTool, string | undefined>;\n  hiddenTools: AnyTool[];\n  toolChoice: ChatModelToolChoice;\n  finalAnswer: FinalAnswerTool;\n  canStop: boolean;\n}\n\n// Execution configuration\nexport interface RequirementAgentExecutionConfig {\n  maxRetriesPerStep?: number;\n  totalMaxRetries?: number;\n  maxIterations?: number;\n}\n\n// Run input and options\nexport interface RequirementAgentRunInput {\n  prompt: string | null;\n  context?: string;\n  expectedOutput?: string | z.ZodSchema;\n}\n\nexport interface RequirementAgentRunOptions extends BaseAgentRunOptions {\n  execution?: RequirementAgentExecutionConfig;\n}\n\n// Event callback types\nexport interface RequirementAgentCallbacks {\n  start: (data: { state: RequirementAgentRunState; request: RequirementAgentRequest }) => void;\n  success: (data: { state: RequirementAgentRunState; response: ChatModelOutput }) => void;\n  finalAnswer: (data: {\n    state: RequirementAgentRunState;\n    output: string;\n    delta: string;\n    outputStructured: unknown;\n  }) => void;\n}\n"]}

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

@@ -0,0 +1,24 @@
+import '../../memory/base.cjs';
+import '../../backend/message.cjs';
+import '../../tools/base.cjs';
+import '../../errors.cjs';
+import '../../template.cjs';
+import '../../chat-BOb9n7AJ.cjs';
+import '../../base-XfWeXQ-S.cjs';
+import 'zod';
+export { h as RequirementAgentCallbacks, c as RequirementAgentExecutionConfig, f as RequirementAgentOutput, a as RequirementAgentRequest, e as RequirementAgentRunInput, g as RequirementAgentRunOptions, R as RequirementAgentRunState, l as RequirementAgentRunStateStep, b as RequirementAgentSystemPromptInputSchema, i as RequirementAgentTaskPromptInputSchema, d as RequirementAgentTemplates, j as RequirementAgentToolErrorPromptInputSchema, k as RequirementAgentToolNoResultPromptInputSchema } from '../../types-W0QttuP_.cjs';
+import '../../internals/serializable.cjs';
+import '../../internals/types.cjs';
+import '../../internals/helpers/guards.cjs';
+import 'ai';
+import 'ajv';
+import '../../context.cjs';
+import '../../emitter-jN55XZZq.cjs';
+import '../../internals/helpers/promise.cjs';
+import 'promise-based-task';
+import '../../cache/base.cjs';
+import '../../internals/helpers/schema.cjs';
+import 'zod-to-json-schema';
+import '../../backend/constants.cjs';
+import '../../logger/logger.cjs';
+import 'pino';

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

@@ -0,0 +1,24 @@
+import '../../memory/base.js';
+import '../../backend/message.js';
+import '../../tools/base.js';
+import '../../errors.js';
+import '../../template.js';
+import '../../chat-DrqwUgD8.js';
+import '../../base-CyFx7BRL.js';
+import 'zod';
+export { h as RequirementAgentCallbacks, c as RequirementAgentExecutionConfig, f as RequirementAgentOutput, a as RequirementAgentRequest, e as RequirementAgentRunInput, g as RequirementAgentRunOptions, R as RequirementAgentRunState, l as RequirementAgentRunStateStep, b as RequirementAgentSystemPromptInputSchema, i as RequirementAgentTaskPromptInputSchema, d as RequirementAgentTemplates, j as RequirementAgentToolErrorPromptInputSchema, k as RequirementAgentToolNoResultPromptInputSchema } from '../../types-CJwiMH3u.js';
+import '../../internals/serializable.js';
+import '../../internals/types.js';
+import '../../internals/helpers/guards.js';
+import 'ai';
+import 'ajv';
+import '../../context.js';
+import '../../emitter-36-9MnvA.js';
+import '../../internals/helpers/promise.js';
+import 'promise-based-task';
+import '../../cache/base.js';
+import '../../internals/helpers/schema.js';
+import 'zod-to-json-schema';
+import '../../backend/constants.js';
+import '../../logger/logger.js';
+import 'pino';