Annotation Interface BeforeCall

@Retention(RUNTIME)
@Target(METHOD)
public @interface BeforeCall

Marks a method as a pre-invocation hook for an agentic pattern. The annotated method must be static, accept an AgenticScope as argument, and return void. It will be invoked before every execution of the agent, allowing initialization or transformation of the shared state.

Example:

    public interface StoryCreatorWithDefaults {

        @SequenceAgent(outputKey = "story",
                subAgents = { CreativeWriter.class, StyleEditor.class })
        String write(@V("topic") String topic);

        @BeforeCall
        static void beforeCall(AgenticScope agenticScope) {
            agenticScope.writeStateIfAbsent("style", "comedy");
        }
    }