Package dev.agenor.runtime.hitl

Class HitlAnnotationProcessor

java.lang.Object

dev.agenor.runtime.hitl.HitlAnnotationProcessor

public final class HitlAnnotationProcessor
extends Object

Reads the RequiresApproval annotation from behavior classes registered with a BaseAgent and wraps each annotated behavior in a HumanCheckpointBehavior at agent registration time.

Called by AgenorRuntime.registerAgent() for every BaseAgent:

 // Inside AgenorRuntime.registerAgent():
 if (agent instanceof BaseAgent baseAgent) {
     HitlAnnotationProcessor.process(baseAgent, approvalGate);
 }
 

Wiring logic

1. Iterate over all behaviors currently registered on the agent.
2. For each behavior whose class carries RequiresApproval:
3. Parse RequiresApproval.timeout() → Duration.
4. Instantiate ApprovalNotifier: if notifier class is the DefaultApprovalNotifier sentinel, substitute LoggingApprovalNotifier.
5. Remove the original behavior from the agent.
6. Add a HumanCheckpointBehavior wrapping it in its place.

Since:

0.13.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	HitlAnnotationProcessor.HitlWiringException	Thrown when a behavior class listed in @RequiresApproval cannot be wired at agent bootstrap time.

Method Summary

Modifier and Type	Method	Description
static void	process(BaseAgent agent, ApprovalGate gate)	Processes all RequiresApproval-annotated behaviors on agent and wraps them with HumanCheckpointBehavior.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

process

public static void process(BaseAgent agent,
 ApprovalGate gate)

Processes all RequiresApproval-annotated behaviors on agent and wraps them with HumanCheckpointBehavior.

This method is a no-op if no behavior carries the annotation.

Parameters:

agent - the agent being registered; never null

gate - the singleton approval gate; never null

Throws:

HitlAnnotationProcessor.HitlWiringException - if a notifier class cannot be instantiated, or if the timeout string cannot be parsed