Skip to main content

Interface: AgencyCallbacks

Defined in: packages/agentos/src/api/types.ts:576

Event callbacks registered on BaseAgentConfig.on. All handlers are fire-and-forget (return void); errors thrown inside them are swallowed to prevent disrupting the main run.

Properties​

agentEnd()?​

optional agentEnd: (e) => void

Defined in: packages/agentos/src/api/types.ts:580

Called after an agent produces its final output.

Parameters​

e​

AgentEndEvent

Returns​

void

agentStart()?​

optional agentStart: (e) => void

Defined in: packages/agentos/src/api/types.ts:578

Called immediately before an agent starts.

Parameters​

e​

AgentStartEvent

Returns​

void

approvalDecided()?​

optional approvalDecided: (e) => void

Defined in: packages/agentos/src/api/types.ts:596

Called after an approval decision is resolved.

Parameters​

e​

ApprovalDecision

Returns​

void

approvalRequested()?​

optional approvalRequested: (e) => void

Defined in: packages/agentos/src/api/types.ts:594

Called when an approval request is raised.

Parameters​

e​

ApprovalRequest

Returns​

void

emergentForge()?​

optional emergentForge: (e) => void

Defined in: packages/agentos/src/api/types.ts:588

Called when the emergent subsystem forges a new agent.

Parameters​

e​

ForgeEvent

Returns​

void

error()?​

optional error: (e) => void

Defined in: packages/agentos/src/api/types.ts:586

Called when an unhandled error occurs inside an agent.

Parameters​

e​
agent​

string

error​

Error

timestamp​

number

Returns​

void

guardrailResult()?​

optional guardrailResult: (e) => void

Defined in: packages/agentos/src/api/types.ts:590

Called after a guardrail evaluates an input or output.

Parameters​

e​

GuardrailEvent

Returns​

void

handoff()?​

optional handoff: (e) => void

Defined in: packages/agentos/src/api/types.ts:582

Called when control is handed off between agents.

Parameters​

e​

HandoffEvent

Returns​

void

limitReached()?​

optional limitReached: (e) => void

Defined in: packages/agentos/src/api/types.ts:592

Called when a resource limit is reached.

Parameters​

e​

LimitEvent

Returns​

void

toolCall()?​

optional toolCall: (e) => void

Defined in: packages/agentos/src/api/types.ts:584

Called when an agent invokes a tool.

Parameters​

e​

ToolCallEvent

Returns​

void