agent

codebolt.agent.Agent(tools: Array<any>, systemPrompt: SystemPrompt, maxRun: number (optional), subAgents: Array<any>): Class

Central class for managing AI agent operations including tool execution, subagent coordination, and task processing through LLM interactions.

Parameters

Name	Type	Description
tools	Array<any>	Initial set of tools available to the agent
systemPrompt	SystemPrompt	Base prompt configuration for the agent
maxRun	number (optional)	Maximum execution cycles (0 = unlimited)
subAgents	Array<any>	List of subordinate agents

Key Features

• Tool Integration: Execute local and MCP tools
• Subagent Coordination: Manage nested agent workflows
• Conversation Management: Maintain context-aware dialog history
• Automatic Retry: Configurable execution attempts

Example Usage

// Initialize agent with tools and prompts
const systemPrompt = new SystemPrompt("You are a helpful AI assistant");
const taskInstruction = new TaskInstruction("Process user request", { priority: "high" });

const agent = new Agent(
  [imageProcessorTool, dataValidatorTool],
  systemPrompt,
  3, // max 3 attempts
  [reportGeneratorAgent]
);

// Execute task
const result = await agent.run(taskInstruction);
if (result.success) {
  console.log("Task completed:", result.message);
} else {
  console.error("Failed:", result.error);
}