Uses of Class
com.tnsai.roles.Role

Packages that use Role

Package	Description
com.tnsai.actions	Action execution framework for agent tool/function calling.
com.tnsai.actions.executors	Specialized action executors for different execution contexts.
com.tnsai.agents	Agent classes and lifecycle management for the TnsAI framework.
com.tnsai.agents.capabilities	Agent capability management -- planning, reasoning, evaluation, feedback, environment perception, variant selection, context graphs, and resilience.
com.tnsai.agents.execution	Agent execution components including LLM orchestration, tool processing, and memory management.
com.tnsai.agents.init	Agent initialization and specification extraction.
com.tnsai.agents.orchestration	Agent orchestration — chat, streaming, tool execution, and knowledge base management.
com.tnsai.agents.validation
com.tnsai.communication	Agent messaging infrastructure for inter-agent communication.
com.tnsai.guardrails	Runtime enforcement of InputGuardrail and OutputGuardrail annotations declared on @ActionSpec methods or their declaring Role classes.
com.tnsai.llm	LLM (Large Language Model) client interfaces and abstractions.
com.tnsai.prompt	Prompt building, templating, and management framework for LLM interactions.
com.tnsai.protocols.callbacks	Protocol callback handlers for annotation-driven message dispatch.
com.tnsai.rag	Canonical RAG configuration and retrieval contracts.
com.tnsai.resilience	Resilience patterns for fault-tolerant agent and action execution.
com.tnsai.roles	Role definitions and capabilities for agents in the TnsAI framework.
com.tnsai.roles.export	Role export system for converting TnsAI roles to various formats.
com.tnsai.roles.export.frameworks	Framework-specific role exporters.
com.tnsai.roles.registry	Centralized role registration and lookup service.
com.tnsai.schema	JSON Schema generation for LLM function calling tool definitions.
com.tnsai.security	Security SPI contracts and human-in-the-loop approval for TnsAI agents.

Uses of Role in com.tnsai.actions

Methods in com.tnsai.actions with parameters of type Role

Modifier and Type	Method	Description
void	ActionExecutor.authorizeMcpAlias(ActionMetadata action, Role role, String alias, Map<String,Object> parameters)	Discovered endpoint aliases need their own explicit registration in secured dispatch.
static DiscoveredRoleActions	ActionDiscovery.discoverActions(Role role)	Discovers all actions from a Role instance.
Object	ActionExecutor.execute(ActionMetadata action, Role role, Map<String,Object> parameters)	Executes an action without additional context.
Object	ActionExecutor.execute(ActionMetadata action, Role role, Map<String,Object> parameters, Map<String,Object> context)	Executes an action with the given parameters and context.

Uses of Role in com.tnsai.actions.executors

Methods in com.tnsai.actions.executors with parameters of type Role

Modifier and Type	Method	Description
Object	LLMRoleExecutor.execute(ActionMetadata action, Role role, Map<String,Object> parameters, Map<String,Object> context)
Object	McpToolExecutor.execute(ActionMetadata action, Role role, Map<String,Object> parameters, Map<String,Object> context)
Object	TypedActionExecutor.execute(ActionMetadata action, Role role, Map<String,Object> parameters, Map<String,Object> context)	Executes an action with the given parameters and context.
Object	WebServiceExecutor.execute(ActionMetadata action, Role role, Map<String,Object> parameters, Map<String,Object> context)

Uses of Role in com.tnsai.agents

Methods in com.tnsai.agents that return Role

Modifier and Type	Method	Description
final Role	Agent.getRole()	Returns the primary (first) role, or null.

Methods in com.tnsai.agents that return types with arguments of type Role

Modifier and Type	Method	Description
final List<Role>	Agent.getAgentRoles()
final List<Role>	Agent.getRolesTemplate()
final List<Role>	Agent.roles()	Returns the assigned roles (never null, never empty).

Methods in com.tnsai.agents with parameters of type Role

Modifier and Type	Method	Description
AgentBuilder	AgentBuilder.role(Role role)	Adds a role to the agent.

Method parameters in com.tnsai.agents with type arguments of type Role

Modifier and Type	Method	Description
Map<String,Object>	AgentCognitiveSupport.extractCurrentState(List<Role> roles)
void	AgentCognitiveSupport.onEnvironmentChangeWithRoles(Percept percept, String agentClassName, List<Role> roles)	Handles environment change with access to roles for state extraction.
List<PlannerHandle.PlanStep>	AgentCognitiveSupport.plan(List<Role> roles)
List<PlannerHandle.PlanStep>	AgentCognitiveSupport.planForGoal(String goalName, List<Role> roles)
AgentBuilder	AgentBuilder.roles(List<Role> roles)	Adds multiple roles to the agent.

Uses of Role in com.tnsai.agents.capabilities

Methods in com.tnsai.agents.capabilities that return types with arguments of type Role

Modifier and Type	Method	Description
List<Role>	AgentCapabilities.CapabilitiesContext.getAgentRoles()

Uses of Role in com.tnsai.agents.execution

Methods in com.tnsai.agents.execution that return types with arguments of type Role

Modifier and Type	Method	Description
List<Role>	AgentToolExecutor.AgentContext.getAgentRoles()

Uses of Role in com.tnsai.agents.init

Fields in com.tnsai.agents.init with type parameters of type Role

Modifier and Type	Field	Description
final List<Role>	AgentInitializer.InitializationResult.roles

Methods in com.tnsai.agents.init that return types with arguments of type Role

Modifier and Type	Method	Description
List<Role>	AgentSpecExtractor.getRoles()	Instantiates the role classes declared in @AgentSpec.roles (TNS-536) — the annotation counterpart of AgentBuilder.role(...).
List<Role>	AgentInitializer.InitializerContext.getRolesTemplate()

Uses of Role in com.tnsai.agents.orchestration

Methods in com.tnsai.agents.orchestration that return types with arguments of type Role

Modifier and Type	Method	Description
List<Role>	AgentOrchestrator.getAgentRoles()
List<Role>	AgentOrchestrator.OrchestratorContext.getAgentRoles()

Uses of Role in com.tnsai.agents.validation

Methods in com.tnsai.agents.validation that return types with arguments of type Role

Modifier and Type	Method	Description
List<Role>	ValidationContext.roles()	Returns the value of the roles record component.

Constructor parameters in com.tnsai.agents.validation with type arguments of type Role

Modifier	Constructor	Description
	ValidationContext(Optional<LLMClient> llmClient, List<Role> roles)	Backwards-compatible 2-arg constructor — defaults every later-added field to its safe / empty value so existing validator test fixtures keep compiling.
	ValidationContext(Optional<LLMClient> llmClient, List<Role> roles, boolean hasExternalTools)	3-arg constructor — defaults memoryStore, reachabilityTimeout, the V006 tool/filter flags, tenantId, and mcpServerUrls.
	ValidationContext(Optional<LLMClient> llmClient, List<Role> roles, boolean hasExternalTools, Duration reachabilityTimeout)	4-arg constructor — defaults memoryStore, the V006 tool/filter flags, tenantId, and mcpServerUrls.
	ValidationContext(Optional<LLMClient> llmClient, List<Role> roles, boolean hasExternalTools, Optional<MemoryStore> memoryStore, Duration reachabilityTimeout)	5-arg constructor (the pre-0.8.5 primary shape) — defaults the V006 tool/filter flags, tenantId, and mcpServerUrls so existing call sites keep compiling.
	ValidationContext(Optional<LLMClient> llmClient, List<Role> roles, boolean hasExternalTools, Optional<MemoryStore> memoryStore, Duration reachabilityTimeout, boolean hasConfirmationRequiredTool, boolean toolCallFilterSet)	7-arg constructor (the V006 shape) — defaults tenantId and mcpServerUrls so call sites added by issue #234 keep compiling.
	ValidationContext(Optional<LLMClient> llmClient, List<Role> roles, boolean hasExternalTools, Optional<MemoryStore> memoryStore, Duration reachabilityTimeout, boolean hasConfirmationRequiredTool, boolean toolCallFilterSet, Optional<String> tenantId)	8-arg constructor (the V012 shape) — defaults mcpServerUrls so call sites added by issue #235 phase 2 keep compiling.
	ValidationContext(Optional<LLMClient> llmClient, List<Role> roles, boolean hasExternalTools, Optional<MemoryStore> memoryStore, Duration reachabilityTimeout, boolean hasConfirmationRequiredTool, boolean toolCallFilterSet, Optional<String> tenantId, Set<String> mcpServerUrls)	Creates an instance of a ValidationContext record class.

Uses of Role in com.tnsai.communication

Methods in com.tnsai.communication with parameters of type Role

Modifier and Type	Method	Description
String	CommunicationEnforcer.buildConstraintsPrompt(Role role)	Builds a system prompt section that describes communication constraints.
String	CommunicationEnforcer.truncateIfNeeded(Role role, String response)	Truncates response to max length if needed.
void	CommunicationEnforcer.validateResponse(Role role, String response)	Validates a response against communication constraints.

Uses of Role in com.tnsai.guardrails

Methods in com.tnsai.guardrails with parameters of type Role

Modifier and Type	Method	Description
static Map<String,Object>	InputGuardrailEnforcer.enforce(ActionMetadata action, Role role, Map<String,Object> params)	Enforces the (possibly inherited) input guardrail on params.
static Object	OutputGuardrailEnforcer.enforce(ActionMetadata action, Role role, Object result)	Enforces the (possibly inherited) output guardrail on result.

Uses of Role in com.tnsai.llm

Methods in com.tnsai.llm with parameters of type Role

Modifier and Type	Method	Description
static boolean	LLMResolver.hasLLM(Agent agent, Role role)	Checks if the given agent-role combination has an LLM configured.
static Optional<LLMClient>	LLMResolver.resolve(Agent agent, Role role)	Resolves the LLM client for the given agent and role.
static LLMClient	LLMResolver.resolveOrThrow(Agent agent, Role role)	Gets the LLM client or throws if none configured.

Uses of Role in com.tnsai.prompt

Methods in com.tnsai.prompt with parameters of type Role

Modifier and Type	Method	Description
static String	RolePromptBuilder.buildRolePrompt(Role role)	Builds a complete role prompt from a Role instance.

Uses of Role in com.tnsai.protocols.callbacks

Methods in com.tnsai.protocols.callbacks with parameters of type Role

Modifier and Type	Method	Description
void	MessageCallbackDispatcher.registerRole(Role role)	Registers callbacks from a Role instance.

Uses of Role in com.tnsai.rag

Methods in com.tnsai.rag with parameters of type Role

Modifier and Type	Method	Description
void	RetrievalSpi.enforce(ActionMetadata action, Role role, Map<String,Object> params, Map<String,Object> context)	Resolves the knowledge the given action names (it may name none) and, if any, gives or searches it against the host's declared knowledge according to each entry's use.

Uses of Role in com.tnsai.resilience

Methods in com.tnsai.resilience with parameters of type Role

Modifier and Type	Method	Description
static TracedSpan	TracedResolver.open(ActionMetadata action, Role role, Map<String,Object> params)	Opens a traced span for the given action invocation.
static MeteredHandle	MeteredResolver.start(ActionMetadata action, Role role)	Opens a metered span for the given action invocation.
static Object	FallbackResolver.tryRecover(ActionMetadata action, Role role, Map<String,Object> params, Throwable failure, FallbackResolver.RetryCallback retryCallback)	Attempts to recover from a failed action invocation by invoking the matching @Fallback handler.
static Object	FallbackResolver.tryRecover(ActionMetadata action, Role role, Map<String,Object> params, Throwable failure, FallbackResolver.RetryCallback retryCallback, Consumer<Method> beforeFallback)	Managed dispatch supplies the common gate immediately before a fallback body.

Uses of Role in com.tnsai.roles

Subclasses of Role in com.tnsai.roles

Modifier and Type	Class	Description
final class	ConfigurableRole	A fully configurable Role implementation created via RoleBuilder.

Methods in com.tnsai.roles with type parameters of type Role

Modifier and Type	Method	Description
static <T extends Role> T	Role.create(Class<T> roleClass)	Safe factory method for creating Role instances.

Methods in com.tnsai.roles that return Role

Modifier and Type	Method	Description
Role	RoleBuilder.build()	Builds and returns the configured Role instance.
final Role	Role.setLLM(LLMClient llm)	Sets the LLM client for this role.

Uses of Role in com.tnsai.roles.export

Methods in com.tnsai.roles.export with parameters of type Role

Modifier and Type	Method	Description
String	JsonRoleExporter.export(Role role)
String	RoleExporter.export(Role role)	Exports a Role instance to the target format.
String	YamlRoleExporter.export(Role role)
static ExportedRole	ExportedRole.from(Role role)

Method parameters in com.tnsai.roles.export with type arguments of type Role

Modifier and Type	Method	Description
String	JsonRoleExporter.exportFromClass(Class<? extends Role> roleClass)
String	RoleExporter.exportFromClass(Class<? extends Role> roleClass)	Exports a Role class (using annotations) to the target format.
String	YamlRoleExporter.exportFromClass(Class<? extends Role> roleClass)
static ExportedRole	ExportedRole.fromClass(Class<? extends Role> roleClass)

Uses of Role in com.tnsai.roles.export.frameworks

Methods in com.tnsai.roles.export.frameworks with parameters of type Role

Modifier and Type	Method	Description
String	JADEExporter.export(Role role)
String	JasonExporter.export(Role role)
String	SCOPExporter.export(Role role)

Method parameters in com.tnsai.roles.export.frameworks with type arguments of type Role

Modifier and Type	Method	Description
String	JADEExporter.exportFromClass(Class<? extends Role> roleClass)
String	JasonExporter.exportFromClass(Class<? extends Role> roleClass)
String	SCOPExporter.exportFromClass(Class<? extends Role> roleClass)

Uses of Role in com.tnsai.roles.registry

Methods in com.tnsai.roles.registry that return types with arguments of type Role

Modifier and Type	Method	Description
Set<Class<? extends Role>>	RoleRegistry.getRoles(Agent agent)	Gets all role classes assigned to an agent.

Methods in com.tnsai.roles.registry with parameters of type Role

Modifier and Type	Method	Description
void	RoleRegistry.assignRole(Agent agent, Role role)	Assigns a role to an agent.
void	RoleRegistry.releaseRole(Agent agent, Role role)	Releases a role from an agent.

Method parameters in com.tnsai.roles.registry with type arguments of type Role

Modifier and Type	Method	Description
Optional<Agent>	RoleRegistry.getOwner(Class<? extends Role> roleClass)	Gets the current owner of an exclusive role.
boolean	RoleRegistry.hasRole(Agent agent, Class<? extends Role> roleClass)	Checks if an agent has a specific role assigned.
boolean	RoleRegistry.isShared(Class<? extends Role> roleClass)	Checks if a role class is shared (can be assigned to multiple agents).

Uses of Role in com.tnsai.schema

Method parameters in com.tnsai.schema with type arguments of type Role

Modifier and Type	Method	Description
List<Map<String,Object>>	ToolSchemaGenerator.generateToolSchemas(List<Role> roles)	Generates tool schemas for all roles' actions.
String	ToolSchemaGenerator.generateToolsDescription(List<Role> roles)	Generates a human-readable description of available tools.

Uses of Role in com.tnsai.security

Methods in com.tnsai.security with parameters of type Role

Modifier and Type	Method	Description
void	SecurityEnforcerHandle.audit(ActionMetadata action, Role role, String callerAgentId, Map<String,Object> parameters, Object result, long durationMs)	Logs audit information based on audit level.
void	SecurityEnforcerHandle.enforceAccessControl(ActionMetadata action, Role role, String callerAgentId, Set<String> callerRoles)	Enforces access control based on @Security annotation.
<T> T	SecurityEnforcerHandle.executeWithTimeout(ActionMetadata action, Role role, Callable<T> task)	Executes an action with security timeout enforcement.
Map<String,Object>	SecurityEnforcerHandle.processParameters(ActionMetadata action, Role role, Map<String,Object> parameters)	Processes parameters based on security settings.
Object	SecurityEnforcerHandle.processResult(ActionMetadata action, Role role, Object result)	Processes the result based on security settings.