orchestration

type AgentSpec struct {
	// Name is the ADK agent name used for transfer_to_agent delegation.
	Name string
	// Description is a one-line summary for the orchestrator's routing table.
	Description string
	// Instruction is the full system prompt with I/O spec and constraints.
	Instruction string
	// Prefixes are tool name prefixes this agent handles.
	Prefixes []string
	// Keywords are routing hints for the orchestrator's decision protocol.
	Keywords []string
	// Capabilities are semantic ability descriptions for description-based routing.
	// These supplement tool-derived capabilities with explicit domain labels.
	Capabilities []string
	// Accepts describes the expected input format.
	Accepts string
	// Returns describes the expected output format.
	Returns string
	// CannotDo lists things this agent must not attempt (negative constraints).
	CannotDo []string
	// ExampleRequests are concrete routing examples for the orchestrator.
	ExampleRequests []string
	// Disambiguation explains when NOT to pick this agent (overlap resolution).
	Disambiguation string
	// AlwaysInclude creates this agent even with zero tools (e.g. Planner).
	AlwaysInclude bool
	// SessionIsolation indicates this agent should use a child session
	// instead of the parent session.
	SessionIsolation bool
}

type Config struct {
	// Tools is the full set of available tools.
	Tools []*agent.Tool
	// Model is the primary LLM model adapter.
	Model model.LLM
	// SystemPrompt is the base system instruction.
	SystemPrompt string
	// AdaptTool converts an internal tool to an ADK tool.
	// Callers should pass adk.AdaptTool.
	AdaptTool ToolAdapter
	// RemoteAgents are external A2A agents to include as sub-agents.
	RemoteAgents []adk_agent.Agent
	// MaxDelegationRounds limits the number of orchestrator→sub-agent
	// delegation rounds per user turn. Zero means use default (10).
	MaxDelegationRounds int
	// SubAgentPrompt builds the final system prompt for each sub-agent.
	// When nil, the original spec.Instruction is used unchanged.
	SubAgentPrompt SubAgentPromptFunc
	// UniversalTools are tools given directly to the orchestrator
	// (e.g. builtin_list/builtin_invoke dispatchers).
	UniversalTools []*agent.Tool
	// Specs overrides the default built-in agent specifications.
	// When nil, the built-in agentSpecs are used (backward compatible).
	Specs []AgentSpec
	// DynamicAgents provides P2P agents discovered at runtime.
	// When set, discovered agents are added to the routing table.
	DynamicAgents agentpool.DynamicAgentProvider
}

type DynamicToolSet map[string][]*agent.Tool

type RoleToolSet struct {
	Operator   []*agent.Tool
	Navigator  []*agent.Tool
	Vault      []*agent.Tool
	Librarian  []*agent.Tool
	Automator  []*agent.Tool
	Planner    []*agent.Tool // Always empty — LLM-only reasoning.
	Chronicler []*agent.Tool
	Ontologist []*agent.Tool
	Unmatched  []*agent.Tool // Tools matching no prefix — tracked separately.
}

type SubAgentPromptFunc func(agentName, defaultInstruction string) string

type ToolAdapter func(t *agent.Tool, agentName string) (adk_tool.Tool, error)