setExecutionPointAfterNode

suspend fun setExecutionPointAfterNode(nodePath: String, output: JSONElement, agentContext: AIAgentGraphContextBase)(source)

Enforces the strategy's next execution to continue right after the node identified by nodePath, using output as that node's completed output.

nodePath is a DEFAULT_AGENT_PATH_SEPARATOR-joined path whose first segment is the agent's id and is ignored; the remaining segments identify the completed node inside this strategy's metadata. output is decoded using the completed node's AIAgentNodeBase.outputType.

Behavior:

  • If the completed node is a FinishNode, the subgraph containing it is resumed by re-starting the finish node with output (finish nodes have no outgoing edges and input equals output).

  • Otherwise, the outgoing edge of the completed node is resolved against output and the resulting next node and transformed input are set as the new execution point.

Parameters

nodePath

The path identifying the completed node within the strategy's metadata.

output

The serialized output produced by the node at nodePath.

agentContext

The graph context whose execution point should be enforced.

Throws

if nodePath does not contain any node segment after the agent id.

if no node corresponding to nodePath can be found in metadata, if no outgoing edge matches the produced output, or if one of the intermediate path segments is not an ExecutionPointNode.