Class Expert

Expert agent extending SimpleAgent with configuration-based setup.

Hierarchy (View Summary)

SimpleAgent
- Expert

Constructors

constructor

new Expert(options: BaseAgentOptions, config: ExpertConfig): Expert
Parameters
- options: BaseAgentOptions
- config: ExpertConfig
Returns Expert
Overrides SimpleAgent.constructor
- Defined in packages/nexus-agents/src/agents/experts/expert-factory.ts:64

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

`Readonly`expertConfig

expertConfig: ExpertConfig

Accessors

state

get state(): AgentState
Current state

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

name

get name(): string
Get the expert's name.

Returns string
- Defined in packages/nexus-agents/src/agents/experts/expert-factory.ts:72

metadata

get metadata(): Record<string, unknown> | undefined
Get the expert's metadata.

Returns Record<string, unknown> | undefined
- Defined in packages/nexus-agents/src/agents/experts/expert-factory.ts:79

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 SimpleAgent.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 SimpleAgent.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 SimpleAgent.handleMessage
- Defined in packages/nexus-agents/src/agents/base-agent.ts:243

cleanup

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

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

hasCapability

hasCapability(capability: AgentCapability): boolean
Parameters
- capability: AgentCapability
Returns boolean
Inherited from SimpleAgent.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 SimpleAgent.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 SimpleAgent.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 SimpleAgent.addToHistory
- Defined in packages/nexus-agents/src/agents/base-agent.ts:307

`Protected`getHistory

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

`Protected`clearHistory

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

getPruningMetrics

getPruningMetrics(): Readonly<ContextPruningMetrics>
Returns Readonly<ContextPruningMetrics>
Inherited from SimpleAgent.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 SimpleAgent.addContextItem
- Defined in packages/nexus-agents/src/agents/base-agent.ts:320

isContextPruningEnabled

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

isMemoryEnabled

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

getMemoryState

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

getRelevantMemories

getRelevantMemories(): readonly TypedMemoryEntry<MemoryType>[]
Returns readonly TypedMemoryEntry<MemoryType>[]
Inherited from SimpleAgent.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 SimpleAgent.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 SimpleAgent.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 SimpleAgent.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 SimpleAgent.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 SimpleAgent.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 SimpleAgent.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 SimpleAgent.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>>
Inherited from SimpleAgent.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[]
Inherited from SimpleAgent.buildPrompt
- Defined in packages/nexus-agents/src/agents/simple-agent.ts:103

Class Expert

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns Expert

Properties

Readonlyid

Readonlyrole

Readonlycapabilities

Protected ReadonlystateMachine

Protected ReadonlybudgetTracker

Protectedadapter

Protected Readonlylogger

Protectedconfig

ProtectedsharedState

Protectedhistory

Protected ReadonlysystemPrompt

Protected Readonlytemperature

Protected ReadonlymaxTokens

Protected ReadonlyeventBus

Protected ReadonlyemitMessageEvents

ReadonlyexpertConfig

Accessors

state

Returns AgentState

name

Returns string

metadata

Returns Record<string, unknown> | undefined

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

`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

`Readonly`expertConfig

`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