Package com.tnsai.agents.capabilities

Class AgentCapabilities

java.lang.Object

com.tnsai.agents.capabilities.AgentCapabilities

public final class AgentCapabilities
extends Object

Manages agent capabilities: planning, reasoning, evaluation, feedback, environment perception, variant selection, context graphs, and resilience.

Extracted from Agent (Phase 2) to improve cohesion. Agent delegates to this class for all cognitive and resilience operations.

Since:

0.3.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AgentCapabilities.CapabilitiesContext	Provides agent context needed by capability methods.

Constructor Summary

Constructors

Constructor	Description
AgentCapabilities(AgentCognitiveSupport cognitiveSupport, AgentCapabilities.CapabilitiesContext context)

Method Summary

Modifier and Type	Method	Description
ActionOutcome	actOnEnvironment(String actionName, Map<String,Object> parameters)
void	addEvalHook(EvalHook hook)
void	applyResilienceState(ResilienceExecutor resilienceExecutor, RetryPolicy defaultRetryPolicy, DeadLetterQueue deadLetterQueue, AgentRecoveryManager agentRecoveryManager, AgentStateRecoveryManager stateRecoveryManager)
EvalContext	clearEvalContext()
void	clearRecoveryState()
void	enableContextGraph(SnapshotStore snapshotStore, DecisionTraceStore decisionTraceStore)
void	ensureEvalContext()
PlannerHandle.PlanResult	executePlan(List<PlannerHandle.PlanStep> steps)
Map<String,Object>	extractCurrentState()
void	fireOnAfterChat(String result, long latencyMs)
void	fireOnAfterToolCall(String toolName, Object result, boolean success, long latencyMs)
void	fireOnAgentStop(String status)
void	fireOnBeforeChat(String message)
void	fireOnBeforeToolCall(String toolName, Map<String,Object> arguments)
void	fireOnError(Exception e, String ctx)
AgentRecoveryManager	getAgentRecoveryManager()
AgentCognitiveSupport	getCognitiveSupport()
Optional<ContextManagerHandle>	getContextManager()
ContextManagerHandle	getContextManagerDirect()
DeadLetterQueue	getDeadLetterQueue()
RetryPolicy	getDefaultRetryPolicy()
Optional<Environment>	getEnvironment()
EvalContext	getEvalContext()
FeedbackCollector	getFeedbackCollector()
AgentHealthState	getHealthState()
Optional<ReasoningStrategyHandle.ReasoningResult>	getLastReasoningResult()
PaymentBroker	getPaymentBroker()
Optional<PlannerHandle>	getPlannerHandle()
Optional<ReasoningStrategyHandle>	getReasoningStrategy()
ReasoningStrategyHandle	getReasoningStrategyRaw()
ResilienceExecutor	getResilienceExecutor()
AgentResilienceManager	getResilienceManager()
AgentStateRecoveryManager	getStateRecoveryManager()
AgentVariant	getVariant()
VariantSelector	getVariantSelector()
boolean	isContextGraphEnabled()
boolean	isEnvironmentEnabled()
boolean	isEvalEnabled()
boolean	isPlanningEnabled()
boolean	isReasoningEnabled()
Percept	perceive()
List<PlannerHandle.PlanStep>	plan()
List<PlannerHandle.PlanStep>	planForGoal(String goalName)
void	recordGoalCompletion(String goalId, boolean success, Map<String,Object> details)
void	recordToolOutcome(String toolName, Object result, boolean success, long latencyMs)
boolean	removeEvalHook(EvalHook hook)
AgentVariant	resolveVariant(String taskDescription)
void	setEnvironment(Environment environment)
void	setEvalEnabled(boolean enabled)
void	setFeedbackCollector(FeedbackCollector collector)
void	setLastReasoningResult(ReasoningStrategyHandle.ReasoningResult result)
void	setPaymentBroker(PaymentBroker broker)
void	setPlannerHandle(PlannerHandle handle)
void	setReasoningStrategy(ReasoningStrategyHandle strategy)
void	setResilienceManager(AgentResilienceManager resilienceManager)
void	setVariant(AgentVariant variant)
void	setVariantSelector(VariantSelector selector)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

AgentCapabilities

public AgentCapabilities(AgentCognitiveSupport cognitiveSupport,
 AgentCapabilities.CapabilitiesContext context)

Method Details

applyResilienceState

public void applyResilienceState(ResilienceExecutor resilienceExecutor,
 RetryPolicy defaultRetryPolicy,
 DeadLetterQueue deadLetterQueue,
 AgentRecoveryManager agentRecoveryManager,
 AgentStateRecoveryManager stateRecoveryManager)

setResilienceManager

public void setResilienceManager(AgentResilienceManager resilienceManager)

ensureEvalContext

public void ensureEvalContext()

getEvalContext

public EvalContext getEvalContext()

fireOnBeforeChat

public void fireOnBeforeChat(String message)

fireOnAfterChat

public void fireOnAfterChat(String result,
 long latencyMs)

fireOnError

public void fireOnError(Exception e,
 String ctx)

fireOnBeforeToolCall

public void fireOnBeforeToolCall(String toolName,
 Map<String,Object> arguments)

fireOnAfterToolCall

public void fireOnAfterToolCall(String toolName,
 Object result,
 boolean success,
 long latencyMs)

recordToolOutcome

public void recordToolOutcome(String toolName,
 Object result,
 boolean success,
 long latencyMs)

fireOnAgentStop

public void fireOnAgentStop(String status)

addEvalHook

public void addEvalHook(EvalHook hook)

removeEvalHook

public boolean removeEvalHook(EvalHook hook)

clearEvalContext

public EvalContext clearEvalContext()

setEvalEnabled

public void setEvalEnabled(boolean enabled)

isEvalEnabled

public boolean isEvalEnabled()

recordGoalCompletion

public void recordGoalCompletion(String goalId,
 boolean success,
 Map<String,Object> details)

getFeedbackCollector

public FeedbackCollector getFeedbackCollector()

setFeedbackCollector

public void setFeedbackCollector(FeedbackCollector collector)

getPaymentBroker

public PaymentBroker getPaymentBroker()

setPaymentBroker

public void setPaymentBroker(PaymentBroker broker)

plan

public List<PlannerHandle.PlanStep> plan()

planForGoal

public List<PlannerHandle.PlanStep> planForGoal(String goalName)

executePlan

public PlannerHandle.PlanResult executePlan(List<PlannerHandle.PlanStep> steps)

extractCurrentState

public Map<String,Object> extractCurrentState()

getPlannerHandle

public Optional<PlannerHandle> getPlannerHandle()

setPlannerHandle

public void setPlannerHandle(PlannerHandle handle)

isPlanningEnabled

public boolean isPlanningEnabled()

setEnvironment

public void setEnvironment(Environment environment)

getEnvironment

public Optional<Environment> getEnvironment()

isEnvironmentEnabled

public boolean isEnvironmentEnabled()

perceive

public Percept perceive()

actOnEnvironment

public ActionOutcome actOnEnvironment(String actionName,
 Map<String,Object> parameters)

getReasoningStrategy

public Optional<ReasoningStrategyHandle> getReasoningStrategy()

setReasoningStrategy

public void setReasoningStrategy(ReasoningStrategyHandle strategy)

isReasoningEnabled

public boolean isReasoningEnabled()

getReasoningStrategyRaw

public ReasoningStrategyHandle getReasoningStrategyRaw()

setLastReasoningResult

public void setLastReasoningResult(ReasoningStrategyHandle.ReasoningResult result)

getLastReasoningResult

public Optional<ReasoningStrategyHandle.ReasoningResult> getLastReasoningResult()

getVariant

public AgentVariant getVariant()

setVariant

public void setVariant(AgentVariant variant)

setVariantSelector

public void setVariantSelector(VariantSelector selector)

getVariantSelector

public VariantSelector getVariantSelector()

resolveVariant

public AgentVariant resolveVariant(String taskDescription)

enableContextGraph

public void enableContextGraph(SnapshotStore snapshotStore,
 DecisionTraceStore decisionTraceStore)

getContextManager

public Optional<ContextManagerHandle> getContextManager()

isContextGraphEnabled

public boolean isContextGraphEnabled()

getContextManagerDirect

public ContextManagerHandle getContextManagerDirect()

getResilienceManager

public AgentResilienceManager getResilienceManager()

getHealthState

public AgentHealthState getHealthState()

getResilienceExecutor

public ResilienceExecutor getResilienceExecutor()

getDefaultRetryPolicy

public RetryPolicy getDefaultRetryPolicy()

getDeadLetterQueue

public DeadLetterQueue getDeadLetterQueue()

getAgentRecoveryManager

public AgentRecoveryManager getAgentRecoveryManager()

getStateRecoveryManager

public AgentStateRecoveryManager getStateRecoveryManager()

clearRecoveryState

public void clearRecoveryState()

getCognitiveSupport

public AgentCognitiveSupport getCognitiveSupport()