Skip to main content

Interface: AgencyCallbacks

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

Event callbacks registered on BaseAgentConfig.on. Each returns void. An agency runs every one inside a try/catch, whichever part of a run fires it (the agency, its strategy, a tool approval or a HITL check): a callback that throws, or an async one whose promise rejects, is written through the host's logger as agency.callback_failed, with the callback's name and the error's listed type and code, never its message, and never fails the call, changes what it returns or leaves a rejection unhandled. An agency reads each one from the on object when the run fires it, and none when it is built, so a callback set, replaced or deleted there after agency() returns is the one that runs, and a getter there that throws is written as a callback that throws is, at its event.

Properties​

agentEnd()?​

optional agentEnd: (e) => void

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

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:1089

Called immediately before an agent starts.

Parameters​

e​

AgentStartEvent

Returns​

void


approvalDecided()?​

optional approvalDecided: (e) => void

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

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:1105

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:1099

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:1097

Called when an unhandled error occurs inside an agent.

Parameters​

e​
agent​

string

error​

Error

timestamp​

number

Returns​

void


guardrailHitlOverride()?​

optional guardrailHitlOverride: (e) => void

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

Called when the post-approval check overrides an HITL approval: a tool call, an agent run or the final output was approved, and a built-in check matched and vetoed it.

Parameters​

e​

GuardrailHitlOverrideEvent

Returns​

void


guardrailResult()?​

optional guardrailResult: (e) => void

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

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:1093

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:1103

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:1095

Called when an agent invokes a tool.

Parameters​

e​

ToolCallEvent

Returns​

void