Package ai.mindconnect.common

Class LoggingContext

java.lang.Object

ai.mindconnect.common.LoggingContext

All Implemented Interfaces:

AutoCloseable

public final class LoggingContext
extends Object
implements AutoCloseable

Helper for setting SLF4J/MDC fields scoped to a single agent invocation.

Use as a try-with-resources block — the MDC slots are reset to whatever was there before the call ended (so nested invocations stack correctly):

 try (var ctx = LoggingContext.session(sessionId, conversationId, agentName)) {
     // every log line in this block has sessionId/agentName in its MDC
     ...
     try (var sub = LoggingContext.subagent("answer-relevance-checker")) {
         // sub-agent block — agentName stays, subAgent is set
         ...
     }
     // sub-agent slot cleared again here
 }
 

The Logback pattern in logback-spring.xml can read these via %X{sessionId}, %X{agentName}, %X{subAgent} etc.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	AGENT_NAME	MDC key for the currently running agent's display name.
static final String	CONVERSATION_ID	MDC key for the conversation UUID.
static final String	SESSION_ID	MDC key for the agent session UUID.
static final String	SUB_AGENT	MDC key for a sub-agent that was invoked from inside the current agent.
static final String	TASK	MDC key for the stateless task name (e.g.
static final String	TOOL	MDC key for the current tool being executed.

Method Summary

Modifier and Type	Method	Description
void	close()
static LoggingContext	session(UUID sessionId, UUID conversationId, String agentName)	Sets sessionId, conversationId and agentName for the duration of the block.
static LoggingContext	subagent(String subAgentName, String task)	Sets the subAgent + task slot.
static LoggingContext	tool(String toolName)	Sets the tool slot for the duration of one tool invocation.

Methods inherited from class java.lang.Object

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

Field Details

SESSION_ID

public static final String SESSION_ID

MDC key for the agent session UUID.

See Also:

• Constant Field Values

CONVERSATION_ID

public static final String CONVERSATION_ID

MDC key for the conversation UUID.

See Also:

• Constant Field Values

AGENT_NAME

public static final String AGENT_NAME

MDC key for the currently running agent's display name.

See Also:

• Constant Field Values

SUB_AGENT

public static final String SUB_AGENT

MDC key for a sub-agent that was invoked from inside the current agent.

See Also:

• Constant Field Values

TASK

public static final String TASK

MDC key for the stateless task name (e.g. "answer-relevance-checker").

See Also:

• Constant Field Values

TOOL

public static final String TOOL

MDC key for the current tool being executed.

See Also:

• Constant Field Values

Method Details

session

public static LoggingContext session(UUID sessionId,
 UUID conversationId,
 String agentName)

Sets sessionId, conversationId and agentName for the duration of the block.

subagent

public static LoggingContext subagent(String subAgentName,
 String task)

Sets the subAgent + task slot. The parent agentName stays untouched.

tool

public static LoggingContext tool(String toolName)

Sets the tool slot for the duration of one tool invocation.

close

public void close()

Specified by:

close in interface AutoCloseable