adk_callbacks behaviour (erlang_adk v0.2.1)

adk_callbacks - Behavior and registry for ADK execution callbacks.

Callbacks allow hooking into the execution lifecycle (e.g., on_llm_start, on_tool_call, on_error) for logging, monitoring, or side-effects.

Summary

on_agent_end/2

on_agent_start/2

on_error/1

on_tool_end/2

on_tool_start/2

Execute a callback hook across all registered handlers.

-callback on_agent_end(AgentName :: binary(), Output :: term()) -> ok.

-callback on_agent_start(AgentName :: binary(), Input :: term()) -> ok.

-callback on_error(Error :: term()) -> ok.

-callback on_tool_end(ToolName :: binary(), Result :: term()) -> ok.

-callback on_tool_start(ToolName :: binary(), Args :: map()) -> ok.

-spec execute(Handlers :: [module()], Hook :: atom(), Args :: [term()]) -> ok.

Execute a callback hook across all registered handlers.