agents / Exports / IPluginHooks

Interface: IPluginHooks

Plugin lifecycle hooks

Implemented by

• AbstractPlugin

Table of contents

Methods

• beforeRun
• afterRun
• beforeExecution
• afterExecution
• beforeConversation
• afterConversation
• beforeToolCall
• beforeToolExecution
• afterToolCall
• afterToolExecution
• beforeProviderCall
• afterProviderCall
• onStreamingChunk
• onError
• onMessageAdded
• onModuleEvent

Methods

beforeRun

▸ beforeRun(input, options?): void | Promise<void>

Called before agent run

Parameters

Name	Type
input	string
options?	IRunOptions

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:207

---

afterRun

▸ afterRun(input, response, options?): void | Promise<void>

Called after agent run

Parameters

Name	Type
input	string
response	string
options?	IRunOptions

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:212

---

beforeExecution

▸ beforeExecution(context): void | Promise<void>

Called before execution with context

Parameters

Name	Type
context	IPluginExecutionContext

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:217

---

afterExecution

▸ afterExecution(context, result): void | Promise<void>

Called after execution with context and result

Parameters

Name	Type
context	IPluginExecutionContext
result	IPluginExecutionResult

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:222

---

beforeConversation

▸ beforeConversation(context): void | Promise<void>

Called before conversation with context

Parameters

Name	Type
context	IPluginExecutionContext

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:227

---

afterConversation

▸ afterConversation(context, result): void | Promise<void>

Called after conversation with context and result

Parameters

Name	Type
context	IPluginExecutionContext
result	IPluginExecutionResult

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:232

---

beforeToolCall

▸ beforeToolCall(toolName, parameters): void | Promise<void>

Called before tool execution

Parameters

Name	Type
toolName	string
parameters	TToolParameters

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:237

---

beforeToolExecution

▸ beforeToolExecution(context, toolData): void | Promise<void>

Called before tool execution with context

Parameters

Name	Type
context	IPluginExecutionContext
toolData	IToolExecutionContext

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:242

---

afterToolCall

▸ afterToolCall(toolName, parameters, result): void | Promise<void>

Called after tool execution

Parameters

Name	Type
toolName	string
parameters	TToolParameters
result	IToolExecutionResult

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:247

---

afterToolExecution

▸ afterToolExecution(context, toolResults): void | Promise<void>

Called after tool execution with context

Parameters

Name	Type
context	IPluginExecutionContext
toolResults	IPluginExecutionResult

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:252

---

beforeProviderCall

▸ beforeProviderCall(messages): void | Promise<void>

Called before AI provider call

Parameters

Name	Type
messages	TUniversalMessage[]

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:257

---

afterProviderCall

▸ afterProviderCall(messages, response): void | Promise<void>

Called after AI provider call

Parameters

Name	Type
messages	TUniversalMessage[]
response	TUniversalMessage

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:262

---

onStreamingChunk

▸ onStreamingChunk(chunk): void | Promise<void>

Called on streaming chunk

Parameters

Name	Type
chunk	TUniversalMessage

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:267

---

onError

▸ onError(error, context?): void | Promise<void>

Called on error

Parameters

Name	Type
error	Error
context?	IPluginErrorContext

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:272

---

onMessageAdded

▸ onMessageAdded(message): void | Promise<void>

Called on message added to history

Parameters

Name	Type
message	TUniversalMessage

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:277

---

onModuleEvent

▸ onModuleEvent(eventType, eventData): void | Promise<void>

Called when module events are received

Parameters

Name	Type
eventType	EventType
eventData	EventData

Returns

void | Promise<void>

Defined in

packages/agents/src/abstracts/abstract-plugin.ts:282