Package com.tnsai.exceptions

Class ThrowableContextDecorator

java.lang.Object

com.tnsai.exceptions.ThrowableContextDecorator

public final class ThrowableContextDecorator
extends Object

Helper for the catch-side of framework boundaries.

When framework code catches a third-party throwable that doesn't extend TnsAIException, calling enrich(Throwable) attaches the current AgentContext via a ContextualWrapper so downstream logging / ErrorEmitter sees the correlation fields. TnsAIException instances pass through unchanged because they already capture context at construction.

Typical usage:

 try {
     httpClient.execute(request);
 } catch (IOException e) {
     // ContextualWrapper attaches current agent / role / session / tenant.
     throw ThrowableContextDecorator.enrich(e);
 }
 

enrich returns a RuntimeException so the caller can throw the result directly without changing the surrounding method signature.

Since:

0.5.0 (issue #90)

Method Summary

Modifier and Type	Method	Description
static RuntimeException	enrich(Throwable t)	Attach the current AgentContext to t if it isn't already context-aware.

Methods inherited from class java.lang.Object

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

Method Details

enrich

public static RuntimeException enrich(Throwable t)

Attach the current AgentContext to t if it isn't already context-aware. Returns the original throwable unchanged when:

• t is a TnsAIException — already context-captured
• t is a ContextualWrapper — already wrapped
• no AgentContext is currently active — nothing to attach

Otherwise returns a new ContextualWrapper carrying the current context.

Parameters:

t - throwable to enrich; must not be null

Returns:

a RuntimeException suitable for re-throwing — either the original (when it can't be improved) or a ContextualWrapper