Embabel Agent Documentation/com.embabel.agent.api.tool.agentic/DomainToolTracker

DomainToolTracker

class DomainToolTracker(sources: List<DomainToolSource<*>> = emptyList(), autoDiscovery: Boolean = false, agentProcess: AgentProcess? = null)

Tracks domain instances and provides tools from them.

When a single instance of a registered domain class is retrieved, this tracker binds @LlmTool methods from that instance.

Supports two modes:

Registered sources mode: Only binds instances of explicitly registered types
Auto-discovery mode: Binds any object with @LlmTool methods, replacing previous bindings

In both modes, "last wins" - when a new matching artifact arrives, it replaces any previously bound instance.

Parameters

sources

List of registered domain tool sources (empty for auto-discovery mode)

autoDiscovery

When true, discovers tools from any object with @LlmTool methods

agentProcess

Optional agent process for predicate evaluation

Constructors

DomainToolTracker

constructor(sources: List<DomainToolSource<*>> = emptyList(), autoDiscovery: Boolean = false, agentProcess: AgentProcess? = null)

Types

Companion

object Companion

Functions

drainPendingTools

fun drainPendingTools(): List<Tool>

Drain and return all pending tools discovered via auto-discovery. After calling this method, the pending buffer is cleared. Used by com.embabel.agent.spi.loop.ToolChainingInjectionStrategy to inject tools mid-loop.

getBoundInstance

fun <T : Any> getBoundInstance(type: Class<T>): T?

Get the currently bound instance for a domain class, if any.

hasBoundInstance

fun hasBoundInstance(type: Class<*>): Boolean

Check if an instance is bound for the given type.

tryBindArtifact

fun tryBindArtifact(artifact: Any): List<Tool>

Check if the given artifact is a single instance of a registered domain class (or any class with @LlmTool methods in auto-discovery mode). If so, bind it and return any tools extracted from it.