Package org.bsc.langgraph4j.agentexecutor

Interface UnloadTarget

All Known Implementing Classes:

UnloadTarget.All, UnloadTarget.Ids, UnloadTarget.Matching, UnloadTarget.None

public sealed interface UnloadTarget
permits UnloadTarget.None, UnloadTarget.All, UnloadTarget.Ids, UnloadTarget.Matching

Declarative target for SkillInjector's unload operation. Sealed over exactly four variants: UnloadTarget.None, UnloadTarget.All, UnloadTarget.Ids, UnloadTarget.Matching. Construct via the static factories none(), all(), ids(String...), matching(Predicate).

Project targets Java 17, so dispatch inside SkillInjector uses an if-else instanceof chain — the lazy permits self-check in UnloadTarget.PermitsCheck keeps every dispatch site honest.

Semantics: None keeps everything (no-op), All clears every activated id (ephemeral), Ids drops a specific set, Matching drops ids accepted by its predicate.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final record	UnloadTarget.All	Clear every currently-activated skill (ephemeral semantics).
static final record	UnloadTarget.Ids	Drop a concrete set of skill ids.
static final record	UnloadTarget.Matching	Drop every skill id accepted by UnloadTarget.Matching.test().
static final record	UnloadTarget.None	Keep every currently-activated skill.
static final class	UnloadTarget.PermitsCheck	Lazy holder — validates permits once on first dispatch-through.

Method Summary

Modifier and Type	Method	Description
static UnloadTarget.All	all()
default List<String>	apply(List<String> activeSkills)	Apply this target to an activeSkills list and return the remaining list.
static void	assertPermitsCoverExpected()	Verifies (via reflection) that the sealed permits clause covers exactly the four subtypes this module expects.
static UnloadTarget.Ids	ids(String... ids)
static UnloadTarget.Matching	matching(Predicate<String> test)
static UnloadTarget.None	none()

Method Details

none

static UnloadTarget.None none()

Returns:

a "no-op" target.

all

static UnloadTarget.All all()

Returns:

a "clear all" target.

ids

static UnloadTarget.Ids ids(String... ids)

Returns:

a "drop these ids" target (nulls / duplicates removed).

matching

static UnloadTarget.Matching matching(Predicate<String> test)

Returns:

a "drop ids matching predicate" target.

apply

default List<String> apply(List<String> activeSkills)

Apply this target to an activeSkills list and return the remaining list. The input is never mutated.

Parameters:

activeSkills - never null, may be empty

Returns:

filtered list (same ref if nothing changed, mutable copy if it did)

assertPermitsCoverExpected

static void assertPermitsCoverExpected()

Verifies (via reflection) that the sealed permits clause covers exactly the four subtypes this module expects. Runs once, lazily, via the UnloadTarget.PermitsCheck holder.

Why reflection? Because the project targets Java 17, dispatch sites use manual if-else instanceof chains — the compiler does NOT warn when a fifth permitted subtype is added and a chain is not extended. This one-time volatile-read guard costs effectively nothing.