Package com.tnsai.annotations

Annotation Interface MemorySpec

@Documented
@Retention(RUNTIME)
@Target({})
public @interface MemorySpec

Memory configuration annotation for Agents.

Defines how the agent manages conversation history and knowledge.

Usage

 @AgentSpec(description = "Research assistant")
 @MemorySpec(
     type = MemoryType.CONVERSATION,
     capacity = 100,
     pruneStrategy = PruneStrategy.SLIDING_WINDOW
 )
 public class ResearchAgent extends Agent { ... }
 

Author:

TnsAI Team

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	MemorySpec.MemoryType	Memory types.
static enum	MemorySpec.Persistence	Persistence backends.
static enum	MemorySpec.PruneStrategy	Pruning strategies.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
int	capacity	Maximum number of messages/items to store.
String	connectionUrl	Redis/Database connection URL (for persistent storage).
boolean	includeSystemMessages	Whether to include system messages in history.
int	maxContextTokens	Maximum tokens for context window management.
MemorySpec.Persistence	persistence	Persistence backend.
MemorySpec.PruneStrategy	pruneStrategy	Strategy for pruning when capacity is exceeded.
boolean	summarizeOnPrune	Whether to summarize old messages instead of removing.
MemorySpec.MemoryType	type	Type of memory store.

Element Details

type

MemorySpec.MemoryType type

Type of memory store.

Default:

CONVERSATION

capacity

int capacity

Maximum number of messages/items to store.

The default of 100 is a real, enforced limit — a bare @MemorySpec prunes at 100 entries. Set to 0 for unbounded storage.

Default:

100

pruneStrategy

MemorySpec.PruneStrategy pruneStrategy

Strategy for pruning when capacity is exceeded.

Default:

SLIDING_WINDOW

persistence

MemorySpec.Persistence persistence

Persistence backend.

Default:

IN_MEMORY

maxContextTokens

int maxContextTokens

Maximum tokens for context window management.

0 = no limit.

Default:

0

includeSystemMessages

boolean includeSystemMessages

Whether to include system messages in history.

Default:

false

summarizeOnPrune

boolean summarizeOnPrune

Whether to summarize old messages instead of removing.

Default:

false

connectionUrl

String connectionUrl

Redis/Database connection URL (for persistent storage).

Default:

""