Uses of Class
com.tnsai.exceptions.TnsAIException

Packages that use TnsAIException

Package	Description
com.tnsai.agents.groups	Agent group membership management.
com.tnsai.agents.lifecycle	Agent lifecycle management with annotation-based hooks, timeout enforcement, and idle monitoring.
com.tnsai.agents.validation
com.tnsai.communication	Agent messaging infrastructure for inter-agent communication.
com.tnsai.exceptions	Custom exceptions for the TnsAI framework.
com.tnsai.idempotency
com.tnsai.invariants	Invariant checking framework for runtime state verification.
com.tnsai.knowledge	Knowledge base abstraction for Retrieval-Augmented Generation (RAG).
com.tnsai.output	Output serialization framework for converting action results to structured formats.
com.tnsai.parser	LLM output parsing with retry and validation support.
com.tnsai.prompt	Prompt building, templating, and management framework for LLM interactions.
com.tnsai.protocols	SPI handles for agent protocol management.
com.tnsai.protocols.callbacks	Protocol callback handlers for annotation-driven message dispatch.
com.tnsai.roles	Role definitions and capabilities for agents in the TnsAI framework.
com.tnsai.roles.registry	Centralized role registration and lookup service.
com.tnsai.security	Security SPI contracts and human-in-the-loop approval for TnsAI agents.
com.tnsai.state	State persistence and checkpointing for agent recovery.
com.tnsai.tools.spi	Service Provider Interface for pluggable tool implementations.

Uses of TnsAIException in com.tnsai.agents.groups

Subclasses of TnsAIException in com.tnsai.agents.groups

Modifier and Type	Class	Description
class	GroupPolicyViolationException	Exception thrown when a group policy is violated.

Uses of TnsAIException in com.tnsai.agents.lifecycle

Subclasses of TnsAIException in com.tnsai.agents.lifecycle

Modifier and Type	Class	Description
static class	LifecycleManager.LifecycleException	Exception thrown when a lifecycle method fails.
static class	LifecycleManager.LifecycleTimeoutException	Exception thrown when a lifecycle method times out.

Uses of TnsAIException in com.tnsai.agents.validation

Subclasses of TnsAIException in com.tnsai.agents.validation

Modifier and Type	Class	Description
class	AgentValidationException	Thrown by AgentBuilder.build() when one or more Severity.ERROR issues are detected during pre-flight validation (issue #85).

Uses of TnsAIException in com.tnsai.communication

Subclasses of TnsAIException in com.tnsai.communication

Modifier and Type	Class	Description
class	CommunicationViolationException	Exception thrown when a communication policy is violated.

Uses of TnsAIException in com.tnsai.exceptions

Subclasses of TnsAIException in com.tnsai.exceptions

Modifier and Type	Class	Description
class	ActionExecutionException	Exception thrown when action execution fails.
class	ApprovalRequiredException	Exception thrown when an action requires human approval before execution.
class	KnowledgeNotReadyException	Thrown when a configured WHEN_CONFIGURED source is not ready before a run: its file is missing, it holds no unit, or it cannot be read.
class	LLMCapabilityException	Exception thrown when an LLM model lacks a required capability.
class	LLMException	Exception for LLM-related errors (model errors, invalid responses, etc.).
class	NetworkException	Exception for network-related errors (connection failures, DNS issues, etc.).
class	RateLimitException	Exception for rate limit errors (HTTP 429, quota exceeded).
class	TaskCompleteException	Signals that a task has been completed and the agent loop should terminate.
class	TimeoutException	Exception for operation timeout errors.
class	ToolCallNotSupportedException	Exception thrown when tools are sent to an LLM model that does not support function/tool calling.
class	ValidationException	Thrown when an action violates pre/post conditions or parameter contracts.

Methods in com.tnsai.exceptions that return TnsAIException

Modifier and Type	Method	Description
static TnsAIException	TnsAIException.wrap(Throwable t)	Wrap an arbitrary throwable in a TnsAIException so it carries a framework error code, retryable flag, and (via subclassing) flows uniformly through ErrorEmitter.

Uses of TnsAIException in com.tnsai.idempotency

Subclasses of TnsAIException in com.tnsai.idempotency

Modifier and Type	Class	Description
class	IdempotencyException	Thrown when an idempotency-protected call produces an outcome the framework cannot resolve safely (issue #91): a hard cache hit under RetryBehavior.FAIL_FAST, a hash collision against a different input, or the configured IdempotencyStore being unreachable mid-call.

Uses of TnsAIException in com.tnsai.invariants

Subclasses of TnsAIException in com.tnsai.invariants

Modifier and Type	Class	Description
class	InvariantViolationException	Exception thrown when an invariant condition is violated.

Uses of TnsAIException in com.tnsai.knowledge

Subclasses of TnsAIException in com.tnsai.knowledge

Modifier and Type	Class	Description
class	KnowledgeBaseException	Exception thrown by knowledge base operations.

Uses of TnsAIException in com.tnsai.output

Subclasses of TnsAIException in com.tnsai.output

Modifier and Type	Class	Description
class	OutputSerializationException	Exception thrown when output serialization or deserialization fails.

Uses of TnsAIException in com.tnsai.parser

Subclasses of TnsAIException in com.tnsai.parser

Modifier and Type	Class	Description
class	ParseException	Exception thrown when LLM output cannot be parsed into the expected type.

Uses of TnsAIException in com.tnsai.prompt

Subclasses of TnsAIException in com.tnsai.prompt

Modifier and Type	Class	Description
class	PromptException	Exception thrown when prompt operations fail.

Uses of TnsAIException in com.tnsai.protocols

Methods in com.tnsai.protocols that throw TnsAIException

Modifier and Type	Method	Description
void	ProtocolManagerHandle.start()	Starts all configured protocol handlers.

Uses of TnsAIException in com.tnsai.protocols.callbacks

Subclasses of TnsAIException in com.tnsai.protocols.callbacks

Modifier and Type	Class	Description
static class	MessageCallbackDispatcher.CallbackInvocationException	Exception thrown when a callback invocation fails in FAIL_FAST mode.

Uses of TnsAIException in com.tnsai.roles

Subclasses of TnsAIException in com.tnsai.roles

Modifier and Type	Class	Description
class	RoleInitializationException	Exception thrown when role initialization fails.

Uses of TnsAIException in com.tnsai.roles.registry

Subclasses of TnsAIException in com.tnsai.roles.registry

Modifier and Type	Class	Description
class	RoleAssignmentException	Exception thrown when a role assignment fails due to exclusivity constraints.

Uses of TnsAIException in com.tnsai.security

Subclasses of TnsAIException in com.tnsai.security

Modifier and Type	Class	Description
class	SecurityException	Base exception for security-related violations.

Uses of TnsAIException in com.tnsai.state

Subclasses of TnsAIException in com.tnsai.state

Modifier and Type	Class	Description
class	StateException	Exception thrown when state operations fail.

Uses of TnsAIException in com.tnsai.tools.spi

Subclasses of TnsAIException in com.tnsai.tools.spi

Modifier and Type	Class	Description
class	ToolAuthenticationException	Tool authentication failed — typically HTTP 401 from upstream, missing or invalid API key, expired bearer token.
class	ToolAuthorizationException	Tool credential is valid but lacks permission for the requested operation — typically HTTP 403 from upstream, RBAC denial, scope mismatch on an OAuth token.
class	ToolConfigurationException	Tool itself is misconfigured — missing required environment variable, invalid endpoint URL, malformed credential file.
class	ToolConflictException	Tool failed due to a conflict against current upstream state — typically HTTP 409, optimistic-concurrency version mismatch, stale-resource update, unique-constraint violation.
class	ToolException	Exception thrown when a tool execution fails.
class	ToolExternalServiceException	Tool failed because the upstream external service returned a server-side error — typically HTTP 5xx, a connection reset, or any provider-side malfunction the tool itself did not cause.
class	ToolInputException	Tool input was invalid — required field missing, type mismatch, value outside allowed range, schema violation.
class	ToolNotFoundException	Remote resource the tool was asked to operate on does not exist — typically HTTP 404 from upstream, file-not-found, missing record.
class	ToolRateLimitException	Tool was rate-limited by upstream — typically HTTP 429.
class	ToolResultSerializationException	Tool produced a result that the framework could not marshal back to the caller — JSON encoding failed, return-type adapter missing, recursive object graph.
class	ToolTimeoutException	Tool exceeded its execution deadline.
class	ToolUnexpectedException	Catchall for tool failures that don't fit any other typed subclass — a pure RuntimeException thrown from inside the tool, an AssertionError, or anything else escaping the well-defined failure taxonomy.
class	ToolUserCanceledException	Tool execution was canceled by the user — confirmation prompt declined, deadline elapsed before the user responded, or an explicit abort signal.