Uses of Package
com.tnsai.annotations

Packages that use com.tnsai.annotations

Package	Description
com.tnsai.agents.groups	Agent group membership management.
com.tnsai.agents.init	Agent initialization and specification extraction.
com.tnsai.agents.lifecycle	Agent lifecycle management with annotation-based hooks, timeout enforcement, and idle monitoring.
com.tnsai.annotations	Custom annotations for the TnsAI framework.
com.tnsai.guardrails	Runtime enforcement of InputGuardrail and OutputGuardrail annotations declared on @ActionSpec methods or their declaring Role classes.
com.tnsai.identity	Decentralized identity management for agents using W3C DID standards.
com.tnsai.memory	Memory management and persistence for agent conversation history.
com.tnsai.memory.vector
com.tnsai.metadata	Metadata extraction and representation for actions, tools, and roles.
com.tnsai.rag	Canonical RAG configuration and retrieval contracts.
com.tnsai.resilience	Resilience patterns for fault-tolerant agent and action execution.
com.tnsai.security	Security SPI contracts and human-in-the-loop approval for TnsAI agents.

Classes in com.tnsai.annotations used by com.tnsai.agents.groups

Class	Description
GroupMember	Declares agent group memberships.

Classes in com.tnsai.annotations used by com.tnsai.agents.init

Class	Description
MemorySpec	Memory configuration annotation for Agents.

Classes in com.tnsai.annotations used by com.tnsai.agents.lifecycle

Class	Description
Lifecycle.Phase	Agent lifecycle phases.

Classes in com.tnsai.annotations used by com.tnsai.annotations

Class	Description
ClassConfig	The class configuration file an AgentSpec.config() or a RoleSpec.config() points at, read once per class and run; a host starts a run with ClassConfig.useBaseDirectory(java.nio.file.Path).
ClassConfig.Level	One level of a file: an agent, a role in an agent's file, or a role's own file.
ClassConfig.RoleBinding	The roles one ClassConfig.bindRoles(java.lang.Class<?>, java.lang.String, java.util.Collection<java.lang.Class<?>>) or ClassConfig.bindRole(java.lang.Class<?>, java.lang.Class<?>) call recorded.
ClassConfig.RunFile	A run file as a host passes it to ClassConfig.useBaseDirectory(RunFile) and ClassConfig.checkAgents(RunFile): its base directory, its name for messages, its Agents section and, optionally, the agent types of the run.
Communication.Formality
Communication.ResponseFormat
Communication.Tone
Communication.Verbosity
Contract.InheritanceMode	Defines how contracts are inherited.
Coordination.Consensus.Strategy
Coordination.CoordinationRole
Coordination.NegotiationType	Negotiation protocol types.
Coordination.TaskDistribution
DIDSpec.KeyType	Supported key types for DID cryptography.
Effect.Operation	Effect operations for state modification.
EvalMetric.MetricCategory	Categories for evaluation metrics.
EventEmitter.Scope	Event scope definitions.
IdempotencyHint	Declares the runtime dispatcher's expectation about idempotency-key tracking for a Tool method (TNS-299).
InputGuardrail.ContentCategory	Content categories for moderation.
InputGuardrail.FailureAction	Actions on guardrail failure.
Knowledge	Declares a body of knowledge and how it reaches the model.
Knowledge.Type	Kinds of corpus a loader can ingest.
Knowledge.Use	How a source's content reaches the model.
KnowledgePolicy.Presence	Whether a source must load when nothing configures it.
Lifecycle.Phase	Agent lifecycle phases.
LLMSpec.Provider	Supported LLM providers.
Memory.Conversation.Strategy
Memory.Vector.Metric
MemorySpec.MemoryType	Memory types.
MemorySpec.Persistence	Persistence backends.
MemorySpec.PruneStrategy	Pruning strategies.
NormType	Types of social norms based on deontic logic.
OutputGuardrail.FailureAction	Actions on guardrail failure.
OutputGuardrail.OutputFormat	Output format types.
OutputGuardrail.PIIType	PII (Personally Identifiable Information) types.
QualityGate.OnFail	Actions when quality gate fails.
Resilience.RateLimit.Strategy
Search.FallbackAction	Fallback actions on retrieval failure.
Search.QueryExpansion	Query expansion methods.
Search.Strategy	Retrieval strategies.
Security.AuditLevel	Audit logging levels.
SideEffect	Classifies the observable effect a Tool method has on the world (TNS-299).

Classes in com.tnsai.annotations used by com.tnsai.guardrails

Class	Description
InputGuardrail	Configures input validation and sanitization for actions.
InputGuardrail.FailureAction	Actions on guardrail failure.
OutputGuardrail	Configures output validation and formatting for actions.
OutputGuardrail.FailureAction	Actions on guardrail failure.

Classes in com.tnsai.annotations used by com.tnsai.identity

Class	Description
DIDSpec	Configures W3C Decentralized Identifier (DID) for agent identity.

Classes in com.tnsai.annotations used by com.tnsai.memory

Class	Description
MemorySpec	Memory configuration annotation for Agents.
MemorySpec.MemoryType	Memory types.
MemorySpec.Persistence	Persistence backends.
MemorySpec.PruneStrategy	Pruning strategies.

Classes in com.tnsai.annotations used by com.tnsai.memory.vector

Class	Description
VectorMemory	Configures vector memory for an Agent class.

Classes in com.tnsai.annotations used by com.tnsai.metadata

Class	Description
Contract	Defines behavioral contracts for actions using Design by Contract principles.
Effect	Defines a structured effect (state modification) for planning.
Header	Defines a custom HTTP header for WEB_SERVICE actions.
LLMParam	Defines a parameter that is exposed to the LLM for tool calling.
ToolExample	Defines an example for a tool/action to help LLMs understand usage patterns.

Classes in com.tnsai.annotations used by com.tnsai.rag

Class	Description
Knowledge	Declares a body of knowledge and how it reaches the model.
Knowledge.Type	Kinds of corpus a loader can ingest.
Knowledge.Use	How a source's content reaches the model.
KnowledgePolicy	How a source the same spec declares must be present.
Search	How a Knowledge.Use.SEARCH source is ranked and rendered.
Search.FallbackAction	Fallback actions on retrieval failure.
Search.QueryExpansion	Query expansion methods.
Search.Strategy	Retrieval strategies.

Classes in com.tnsai.annotations used by com.tnsai.resilience

Class	Description
Resilience	Configures resilience policies for actions and roles.
Resilience.Retry	Retry policy configuration.

Classes in com.tnsai.annotations used by com.tnsai.security

Class	Description
AuditLog	Records method invocations to an audit trail.
ExecutionPolicy	Optional action execution restriction.
Security	Configures security policies for actions and roles.
Security.AuditLevel	Audit logging levels.