Class SimpleAgent

Simple concrete agent implementation for testing and basic use cases.

This agent processes tasks by sending them directly to the model adapter and returning the response.

Hierarchy (View Summary)

BaseAgent
- SimpleAgent
  - Expert

Constructors

constructor

new SimpleAgent(options: BaseAgentOptions): SimpleAgent
Parameters
- options: BaseAgentOptions
Returns SimpleAgent
Inherited from BaseAgent.constructor
- Defined in packages/nexus-agents/src/agents/base-agent.ts:122

Properties

`Readonly`id

id: string

Unique agent identifier

`Readonly`role

role: AgentRole

Agent role

`Readonly`capabilities

capabilities: readonly AgentCapability[]

Agent capabilities

`Protected` `Readonly`stateMachine

stateMachine: AgentStateMachine

`Protected` `Readonly`budgetTracker

budgetTracker: ITokenBudgetTracker

`Protected`adapter

adapter: IModelAdapter | undefined

`Protected` `Readonly`logger

logger: ILogger

`Protected`config

config: AgentConfig | undefined

`Protected`sharedState

sharedState: Record<string, unknown> = {}

`Protected`history

history: Message[] = []

`Protected` `Readonly`systemPrompt

systemPrompt: string | undefined

`Protected` `Readonly`temperature

temperature: number

`Protected` `Readonly`maxTokens

maxTokens: number

`Protected` `Readonly`eventBus

eventBus: IEventBus

`Protected` `Readonly`emitMessageEvents

emitMessageEvents: boolean

Accessors

state

get state(): AgentState
Current state

Returns AgentState
Inherited from BaseAgent.state
- Defined in packages/nexus-agents/src/agents/base-agent.ts:169

Methods

initialize

initialize(ctx: AgentContext): Promise<Result<void, AgentError>>
Initialize the agent with context.
Parameters
- ctx: AgentContext
  Agent context
Returns Promise<Result<void, AgentError>>
Result with void or AgentError
Inherited from BaseAgent.initialize
- Defined in packages/nexus-agents/src/agents/base-agent.ts:198

execute

execute(task: Task): Promise<Result<TaskResult, AgentError>>
Execute a task.
Parameters
- task: Task
  Task to execute
Returns Promise<Result<TaskResult, AgentError>>
Result with TaskResult or AgentError
Inherited from BaseAgent.execute
- Defined in packages/nexus-agents/src/agents/base-agent.ts:211

handleMessage

handleMessage(msg: AgentMessage): Promise<Result<AgentResponse, AgentError>>
Handle an inter-agent message.
Parameters
- msg: AgentMessage
  Message to handle
Returns Promise<Result<AgentResponse, AgentError>>
Result with AgentResponse or AgentError
Inherited from BaseAgent.handleMessage
- Defined in packages/nexus-agents/src/agents/base-agent.ts:243

cleanup

cleanup(): Promise<void>
Cleanup agent resources.

Returns Promise<void>
Inherited from BaseAgent.cleanup
- Defined in packages/nexus-agents/src/agents/base-agent.ts:258

hasCapability

hasCapability(capability: AgentCapability): boolean
Parameters
- capability: AgentCapability
Returns boolean
Inherited from BaseAgent.hasCapability
- Defined in packages/nexus-agents/src/agents/base-agent.ts:274

`Protected`transformError

transformError(error: unknown, taskId: string): AgentError
Parameters
- error: unknown
- taskId: string
Returns AgentError
Inherited from BaseAgent.transformError
- Defined in packages/nexus-agents/src/agents/base-agent.ts:281

`Protected`complete

complete(
request: CompletionRequest,
): Promise<Result<CompletionResponse, AgentError>>
Parameters
- request: CompletionRequest
Returns Promise<Result<CompletionResponse, AgentError>>
Inherited from BaseAgent.complete
- Defined in packages/nexus-agents/src/agents/base-agent.ts:285

`Protected`addToHistory

addToHistory(message: Message): void
Parameters
- message: Message
Returns void
Inherited from BaseAgent.addToHistory
- Defined in packages/nexus-agents/src/agents/base-agent.ts:307

`Protected`getHistory

getHistory(): Message[]
Returns Message[]
Inherited from BaseAgent.getHistory
- Defined in packages/nexus-agents/src/agents/base-agent.ts:310

`Protected`clearHistory

clearHistory(): void
Returns void
Inherited from BaseAgent.clearHistory
- Defined in packages/nexus-agents/src/agents/base-agent.ts:313

getPruningMetrics

getPruningMetrics(): Readonly<ContextPruningMetrics>
Returns Readonly<ContextPruningMetrics>
Inherited from BaseAgent.getPruningMetrics
- Defined in packages/nexus-agents/src/agents/base-agent.ts:316

`Protected`addContextItem

addContextItem(
    content: string,
    priority?: 20 | 60 | 80 | 100 | 40,
    category?: "system" | "task" | "active",
): Promise<void>
Parameters
- content: string
- Optionalpriority: 20 | 60 | 80 | 100 | 40
- Optionalcategory: "system" | "task" | "active"
Returns Promise<void>
Inherited from BaseAgent.addContextItem
- Defined in packages/nexus-agents/src/agents/base-agent.ts:320

isContextPruningEnabled

isContextPruningEnabled(): boolean
Returns boolean
Inherited from BaseAgent.isContextPruningEnabled
- Defined in packages/nexus-agents/src/agents/base-agent.ts:334

isMemoryEnabled

isMemoryEnabled(): boolean
Returns boolean
Inherited from BaseAgent.isMemoryEnabled
- Defined in packages/nexus-agents/src/agents/base-agent.ts:337

getMemoryState

getMemoryState(): Readonly<AgentMemoryState> | null
Returns Readonly<AgentMemoryState> | null
Inherited from BaseAgent.getMemoryState
- Defined in packages/nexus-agents/src/agents/base-agent.ts:340

getRelevantMemories

getRelevantMemories(): readonly TypedMemoryEntry<MemoryType>[]
Returns readonly TypedMemoryEntry<MemoryType>[]
Inherited from BaseAgent.getRelevantMemories
- Defined in packages/nexus-agents/src/agents/base-agent.ts:343

flushMemory

flushMemory(): Promise<Result<void, AgentMemoryError>>
Returns Promise<Result<void, AgentMemoryError>>
Inherited from BaseAgent.flushMemory
- Defined in packages/nexus-agents/src/agents/base-agent.ts:347

`Protected`recordLearning

recordLearning(learning: Omit<TaskLearning, "id" | "learnedAt">): void
Parameters
- learning: Omit<TaskLearning, "id" | "learnedAt">
Returns void
Inherited from BaseAgent.recordLearning
- Defined in packages/nexus-agents/src/agents/base-agent.ts:360

`Protected`recordPattern

recordPattern(
p: Omit<ExecutionPattern, "id" | "lastSeen" | "occurrences">,
): void
Parameters
- p: Omit<ExecutionPattern, "id" | "lastSeen" | "occurrences">
Returns void
Inherited from BaseAgent.recordPattern
- Defined in packages/nexus-agents/src/agents/base-agent.ts:363

`Protected`recordResolution

recordResolution(r: Omit<ErrorResolution, "resolvedAt">): void
Parameters
- r: Omit<ErrorResolution, "resolvedAt">
Returns void
Inherited from BaseAgent.recordResolution
- Defined in packages/nexus-agents/src/agents/base-agent.ts:366

`Protected`findResolutionForError

findResolutionForError(errorMessage: string): ErrorResolution | undefined
Parameters
- errorMessage: string
Returns ErrorResolution | undefined
Inherited from BaseAgent.findResolutionForError
- Defined in packages/nexus-agents/src/agents/base-agent.ts:369

`Protected`getTaskLearnings

getTaskLearnings(taskType: string): readonly TaskLearning[]
Parameters
- taskType: string
Returns readonly TaskLearning[]
Inherited from BaseAgent.getTaskLearnings
- Defined in packages/nexus-agents/src/agents/base-agent.ts:372

`Protected`getTopExecutionPatterns

getTopExecutionPatterns(limit?: number): readonly ExecutionPattern[]
Parameters
- limit: number = 10
Returns readonly ExecutionPattern[]
Inherited from BaseAgent.getTopExecutionPatterns
- Defined in packages/nexus-agents/src/agents/base-agent.ts:375

`Protected`executeTask

executeTask(task: Task): Promise<Result<TaskResult, AgentError>>
Execute a task by sending it to the model.
Parameters
- task: Task
Returns Promise<Result<TaskResult, AgentError>>
Overrides BaseAgent.executeTask
- Defined in packages/nexus-agents/src/agents/simple-agent.ts:21

`Protected`buildPrompt

buildPrompt(task: Task): Message[]
Build prompt messages from a task.
Parameters
- task: Task
Returns Message[]
Overrides BaseAgent.buildPrompt
- Defined in packages/nexus-agents/src/agents/simple-agent.ts:103

Class SimpleAgent

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns SimpleAgent

Properties

Readonlyid

Readonlyrole

Readonlycapabilities

Protected ReadonlystateMachine

Protected ReadonlybudgetTracker

Protectedadapter

Protected Readonlylogger

Protectedconfig

ProtectedsharedState

Protectedhistory

Protected ReadonlysystemPrompt

Protected Readonlytemperature

Protected ReadonlymaxTokens

Protected ReadonlyeventBus

Protected ReadonlyemitMessageEvents

Accessors

state

Returns AgentState

Methods

initialize

Parameters

Returns Promise<Result<void, AgentError>>

execute

Parameters

Returns Promise<Result<TaskResult, AgentError>>

handleMessage

Parameters

Returns Promise<Result<AgentResponse, AgentError>>

cleanup

Returns Promise<void>

hasCapability

Parameters

Returns boolean

ProtectedtransformError

Parameters

Returns AgentError

Protectedcomplete

Parameters

Returns Promise<Result<CompletionResponse, AgentError>>

ProtectedaddToHistory

Parameters

Returns void

ProtectedgetHistory

Returns Message[]

ProtectedclearHistory

Returns void

getPruningMetrics

Returns Readonly<ContextPruningMetrics>

ProtectedaddContextItem

Parameters

Returns Promise<void>

isContextPruningEnabled

Returns boolean

isMemoryEnabled

Returns boolean

getMemoryState

Returns Readonly<AgentMemoryState> | null

getRelevantMemories

Returns readonly TypedMemoryEntry<MemoryType>[]

flushMemory

Returns Promise<Result<void, AgentMemoryError>>

ProtectedrecordLearning

Parameters

Returns void

ProtectedrecordPattern

Parameters

Returns void

ProtectedrecordResolution

`Readonly`id

`Readonly`role

`Readonly`capabilities

`Protected` `Readonly`stateMachine

`Protected` `Readonly`budgetTracker

`Protected`adapter

`Protected` `Readonly`logger

`Protected`config

`Protected`sharedState

`Protected`history

`Protected` `Readonly`systemPrompt

`Protected` `Readonly`temperature

`Protected` `Readonly`maxTokens

`Protected` `Readonly`eventBus

`Protected` `Readonly`emitMessageEvents

`Protected`transformError

`Protected`complete

`Protected`addToHistory

`Protected`getHistory

`Protected`clearHistory

`Protected`addContextItem

`Protected`recordLearning

`Protected`recordPattern

`Protected`recordResolution

`Protected`findResolutionForError

`Protected`getTaskLearnings

`Protected`getTopExecutionPatterns

`Protected`executeTask

`Protected`buildPrompt