Handoff Tool Policy • AI Agent SDK

HandoffToolPolicy: Policy for tool boundary enforcement during handoff.

HandoffToolPolicy

Defined in the handoff module.

Policy for tool boundary enforcement during handoff.

Defines how tools are filtered when handing off to a target agent. Default mode is ‘intersect’ for security by default – sub-agents only get tools that both they and the source agent have access to.

Attributes: mode: Tool filtering mode – “intersect”: Target gets intersection of source and target tools (DEFAULT – secure) – “passthrough”: Target keeps its full tool set (legacy behavior – opt-in) blocked_tools: List of tool names to always strip, regardless of intersection

Properties

Source

Related Documentation