Agent

Defined in: src/agent/agent.ts:171

Orchestrates the interaction between a model, a set of tools, and MCP clients. The Agent is responsible for managing the lifecycle of tools and clients and invoking the core decision-making loop.

Implements

• AgentData

Constructors

Constructor

new Agent(config?): Agent;

Defined in: src/agent/agent.ts:226

Creates an instance of the Agent.

Parameters

Parameter	Type	Description
config?	AgentConfig	The configuration for the agent.

Returns

Agent

Properties

messages

readonly messages: Message[];

Defined in: src/agent/agent.ts:175

The conversation history of messages between user and assistant.

Implementation of

AgentData.messages

---

state

readonly state: AppState;

Defined in: src/agent/agent.ts:180

App state storage accessible to tools and application logic. State is not passed to the model during inference.

Implementation of

AgentData.state

---

conversationManager

readonly conversationManager: HookProvider;

Defined in: src/agent/agent.ts:184

Conversation manager for handling message history and context overflow.

---

hooks

readonly hooks: HookRegistry;

Defined in: src/agent/agent.ts:189

Hook registry for managing event callbacks. Hooks enable observing and extending agent behavior.

---

model

model: Model;

Defined in: src/agent/agent.ts:194

The model provider used by the agent for inference.

---

systemPrompt?

optional systemPrompt: SystemPrompt;

Defined in: src/agent/agent.ts:199

The system prompt to pass to the model provider.

---

name

readonly name: string;

Defined in: src/agent/agent.ts:204

The name of the agent.

---

agentId

readonly agentId: string;

Defined in: src/agent/agent.ts:209

The unique identifier of the agent instance.

Accessors

tools

Get Signature

get tools(): Tool[];

Defined in: src/agent/agent.ts:307

The tools this agent can use.

Returns

Tool[]

---

toolRegistry

Get Signature

get toolRegistry(): ToolRegistry;

Defined in: src/agent/agent.ts:314

The tool registry for managing the agent’s tools.

Returns

ToolRegistry

Methods

initialize()

initialize(): Promise<void>;

Defined in: src/agent/agent.ts:268

Returns

Promise<void>

---

invoke()

invoke(args, options?): Promise<AgentResult>;

Defined in: src/agent/agent.ts:336

Invokes the agent and returns the final result.

This is a convenience method that consumes the stream() method and returns only the final AgentResult. Use stream() if you need access to intermediate streaming events.

Parameters

Parameter	Type	Description
args	InvokeArgs	Arguments for invoking the agent
options?	InvokeOptions	Optional per-invocation options

Returns

Promise<AgentResult>

Promise that resolves to the final AgentResult

Example

const agent = new Agent({ model, tools })
const result = await agent.invoke('What is 2 + 2?')
console.log(result.lastMessage) // Agent's response

---

stream()

stream(args, options?): AsyncGenerator<AgentStreamEvent, AgentResult, undefined>;

Defined in: src/agent/agent.ts:375

Streams the agent execution, yielding events and returning the final result.

The agent loop manages the conversation flow by:

1. Streaming model responses and yielding all events
2. Executing tools when the model requests them
3. Continuing the loop until the model completes without tool use

Use this method when you need access to intermediate streaming events. For simple request/response without streaming, use invoke() instead.

An explicit goal of this method is to always leave the message array in a way that the agent can be reinvoked with a user prompt after this method completes. To that end assistant messages containing tool uses are only added after tool execution succeeds with valid toolResponses

Parameters

Parameter	Type	Description
args	InvokeArgs	Arguments for invoking the agent
options?	InvokeOptions	Optional per-invocation options

Returns

AsyncGenerator<AgentStreamEvent, AgentResult, undefined>

Async generator that yields AgentStreamEvent objects and returns AgentResult

Example

const agent = new Agent({ model, tools })

for await (const event of agent.stream('Hello')) {
  console.log('Event:', event.type)
}
// Messages array is mutated in place and contains the full conversation