agent-handoff

Configure agent handoffs: $ARGUMENTS

Before Starting

1. Search OpenAI docs for handoff patterns:
   • Use mcp__openai-docs__search_openai_docs with query "Agents SDK handoffs" for SDK-native handoff/transfer support
   • Use mcp__openai-docs__search_openai_docs with query "Agents SDK multi-agent" for orchestration patterns
2. Read the existing handoff infrastructure:
   • src/agents/shared/handoffs.ts — AgentRegistry, HandoffDecision, HandoffHandler
   • src/agents/shared/enhanced-agent-bridge.ts — search for enableHandoffs and handoff event handling
   • src/agents/shared/agent-tracer.ts — handoff event tracing
3. Read the database schema:
   • src/lib/database/schema.ts — search for agent_handoffs table (from_agent_id, to_agent_id, trigger_rules, priority)

Agent Registry

The AgentRegistry is a singleton that maps agent names to agent instances: