Uses of Class
com.tnsai.metadata.ActionMetadata

Packages that use ActionMetadata

Package	Description
com.tnsai.actions	Action execution framework for agent tool/function calling.
com.tnsai.actions.contracts	Design-by-contract support for action execution with pre/post condition validation.
com.tnsai.actions.executors	Specialized action executors for different execution contexts.
com.tnsai.guardrails	Runtime enforcement of InputGuardrail and OutputGuardrail annotations declared on @ActionSpec methods or their declaring Role classes.
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.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.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 ActionMetadata in com.tnsai.actions

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

Modifier and Type	Method	Description
AccessRequest	ActionExecutor.authorizeAction(ActionMetadata action, Object target, Map<String,Object> parameters)	Side-effect-free authorization preflight; does not consume approval or execute hooks.
void	ActionExecutor.authorizeMcpAlias(ActionMetadata action, Role role, String alias, Map<String,Object> parameters)	Discovered endpoint aliases need their own explicit registration in secured dispatch.
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.
Object	ActionExecutor.execute(ActionMetadata action, Object target, Map<String,Object> parameters, Map<String,Object> context)	Executes an action on a generic Object target.

Uses of ActionMetadata in com.tnsai.actions.contracts

Methods in com.tnsai.actions.contracts with parameters of type ActionMetadata

Modifier and Type	Method	Description
default void	ActionContract.validatePostConditions(ActionMetadata action, Object result)	Runs after the action returns.
default void	ActionContract.validatePreConditions(ActionMetadata action, Map<String,Object> parameters)	Runs before the action is invoked.

Uses of ActionMetadata in com.tnsai.actions.executors

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

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 ActionMetadata in com.tnsai.guardrails

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

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.
static Map<String,Object>	InputGuardrailEnforcer.enforceForTarget(ActionMetadata action, Object target, Map<String,Object> params)	Enforces method- or class-level input guardrails for a generic action target.
static Object	OutputGuardrailEnforcer.enforceForTarget(ActionMetadata action, Object target, Object result)	Enforces method- or class-level output guardrails for a generic action target.

Uses of ActionMetadata in com.tnsai.metadata

Methods in com.tnsai.metadata that return ActionMetadata

Modifier and Type	Method	Description
ActionMetadata	DiscoveredRoleActions.findAction(String actionName)	Finds an action by name.
ActionMetadata	ActionConfig.toActionMetadata()	Converts this config into the runtime ActionMetadata shape that reflection produces for @ActionSpec methods — no reflective Method; dispatch goes through ActionConfig.handler().

Methods in com.tnsai.metadata that return types with arguments of type ActionMetadata

Modifier and Type	Method	Description
List<ActionMetadata>	DiscoveredRoleActions.getActions()	Gets all discovered actions as an immutable list.

Methods in com.tnsai.metadata with parameters of type ActionMetadata

Modifier and Type	Method	Description
static Optional<String>	ActionParams.firstStringValueInDeclarationOrder(ActionMetadata action, Map<String,Object> parameters)	Returns the value of the first String-typed parameter in declaration order whose entry in parameters is a non-blank String.
static List<String>	ActionParams.parameterNames(ActionMetadata action)	Returns the declared parameter names of action, in declaration order.

Constructor parameters in com.tnsai.metadata with type arguments of type ActionMetadata

Modifier	Constructor	Description
	DiscoveredRoleActions(Class<?> roleClass, List<ActionMetadata> actions)	Creates a container for discovered role actions.

Uses of ActionMetadata in com.tnsai.rag

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

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.
default void	RetrievalSpi.enforce(ActionMetadata action, Object target, Map<String,Object> params, Map<String,Object> context)	Same contract as RetrievalSpi.enforce(ActionMetadata, Role, Map, Map) for a target that is not a Role.

Uses of ActionMetadata in com.tnsai.resilience

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

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 ActionMetadata in com.tnsai.roles

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

Modifier and Type	Method	Description
final Optional<ActionMetadata>	Role.getAction(String actionName)
final List<ActionMetadata>	Role.getActions()	Gets all discovered actions.

Uses of ActionMetadata in com.tnsai.roles.export

Methods in com.tnsai.roles.export that return types with arguments of type ActionMetadata

Modifier and Type	Method	Description
List<ActionMetadata>	ExportedRole.actions()	Returns the value of the actions record component.

Uses of ActionMetadata in com.tnsai.schema

Methods in com.tnsai.schema with parameters of type ActionMetadata

Modifier and Type	Method	Description
Map<String,Object>	ToolSchemaGenerator.generateToolSchema(ActionMetadata action)	Generates tool schema for a single action.

Uses of ActionMetadata in com.tnsai.security

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

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.
default void	SecurityEnforcerHandle.audit(ActionMetadata action, Object target, String callerAgentId, Map<String,Object> parameters, Object result, long durationMs)	Logs audit information based on audit level and @AuditLog, for an action whose target is not a Role.
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.
default <T> T	SecurityEnforcerHandle.executeWithTimeout(ActionMetadata action, Object target, Callable<T> task)	Executes an action with security timeout enforcement, for an action whose target is not a Role.
Map<String,Object>	SecurityEnforcerHandle.processParameters(ActionMetadata action, Role role, Map<String,Object> parameters)	Processes parameters based on security settings.
default Map<String,Object>	SecurityEnforcerHandle.processParameters(ActionMetadata action, Object target, Map<String,Object> parameters)	Processes parameters based on security settings, for an action whose target is not a Role.
Object	SecurityEnforcerHandle.processResult(ActionMetadata action, Role role, Object result)	Processes the result based on security settings.
default Object	SecurityEnforcerHandle.processResult(ActionMetadata action, Object target, Object result)	Processes the result based on security settings, for an action whose target is not a Role.
default void	SecurityEnforcerHandle.requireHonored(ActionMetadata action, Object target)	Refuses, before the action's body runs, an action whose target is not a Role and whose features this handle cannot honor.