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()?
optionalagentEnd: (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()?
optionalagentStart: (e) =>void
Defined in: packages/agentos/src/api/types.ts:1089
Called immediately before an agent starts.
Parameters
e
AgentStartEvent
Returns
void
approvalDecided()?
optionalapprovalDecided: (e) =>void
Defined in: packages/agentos/src/api/types.ts:1107
Called after an approval decision is resolved.
Parameters
e
Returns
void
approvalRequested()?
optionalapprovalRequested: (e) =>void
Defined in: packages/agentos/src/api/types.ts:1105
Called when an approval request is raised.
Parameters
e
Returns
void
emergentForge()?
optionalemergentForge: (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()?
optionalerror: (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()?
optionalguardrailHitlOverride: (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()?
optionalguardrailResult: (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()?
optionalhandoff: (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()?
optionallimitReached: (e) =>void
Defined in: packages/agentos/src/api/types.ts:1103
Called when a resource limit is reached.
Parameters
e
LimitEvent
Returns
void
toolCall()?
optionaltoolCall: (e) =>void
Defined in: packages/agentos/src/api/types.ts:1095
Called when an agent invokes a tool.
Parameters
e
ToolCallEvent
Returns
void