agents-core/ai.koog.agents.core.agent.context.element/NodeInfoContextElement

NodeInfoContextElement

data class NodeInfoContextElement(val nodeName: String) : CoroutineContext.Element(source)

Represents a coroutine context element that holds metadata specific to a particular node participating in the execution context of an AI agent strategy.

This class implements CoroutineContext.Element, enabling it to store and provide access to node-specific context information, such as the name of the node, within coroutine scopes.

Constructors

constructor(nodeName: String)

Types

Key

object Key : CoroutineContext.Key<NodeInfoContextElement>

A companion object that serves as the key for the NodeInfoContextElement in a CoroutineContext. This key enables the retrieval of a NodeInfoContextElement instance stored within a coroutine's context.

Properties

key

open override val key: CoroutineContext.Key<*>

nodeName

val nodeName: String

The name of the node associated with this context element.

Functions

fold

open override fun <R> fold(initial: R, operation: (R, CoroutineContext.Element) -> R): R

get

open operator override fun <E : CoroutineContext.Element> get(key: CoroutineContext.Key<E>): E?

getAgentRunInfoElementOrThrow

suspend fun CoroutineContext.getAgentRunInfoElementOrThrow(): AgentRunInfoContextElement

Retrieves the AgentRunInfoContextElement from the current coroutine context, if present.

getNodeInfoElement

suspend fun CoroutineContext.getNodeInfoElement(): NodeInfoContextElement?

Retrieves the NodeInfoContextElement from the current coroutine context, if present.

minusKey

open override fun minusKey(key: CoroutineContext.Key<*>): CoroutineContext

plus

open operator fun plus(context: CoroutineContext): CoroutineContext