Command

Command API for AgentGraph in PyAgenity.

This module provides the Command class, which allows nodes to combine state updates with control flow, similar to LangGraph's Command API. Nodes can update agent state and direct graph execution to specific nodes or graphs.

Classes:

Name	Description
Command	Command object that combines state updates with control flow.

Attributes:

Name	Type	Description
StateT

Attributes

StateT module-attribute

StateT = TypeVar('StateT', bound='AgentState')

Classes

Command

Command object that combines state updates with control flow.

Allows nodes to update agent state and direct graph execution to specific nodes or graphs. Similar to LangGraph's Command API.

Methods:

Name	Description
__init__	Initialize a Command object.
__repr__	Return a string representation of the Command object.

Attributes:

Name	Type	Description
PARENT
goto
graph
state
update

Source code in pyagenity/utils/command.py

class Command[StateT: AgentState]:
    """
    Command object that combines state updates with control flow.

    Allows nodes to update agent state and direct graph execution to specific nodes or graphs.
    Similar to LangGraph's Command API.
    """

    PARENT = "PARENT"

    def __init__(
        self,
        update: Union["StateT", None, Message, str, "BaseConverter"] = None,
        goto: str | None = None,
        graph: str | None = None,
        state: StateT | None = None,
    ):
        """
        Initialize a Command object.

        Args:
            update (StateT | None | Message | str | BaseConverter): State update to apply.
            goto (str | None): Next node to execute (node name or END).
            graph (str | None): Which graph to navigate to (None for current, PARENT for parent).
            state (StateT | None): Optional agent state to attach.
        """
        self.update = update
        self.goto = goto
        self.graph = graph
        self.state = state

    def __repr__(self) -> str:
        """
        Return a string representation of the Command object.

        Returns:
            str: String representation of the Command.
        """
        return (
            f"Command(update={self.update}, goto={self.goto}, \n"
            f" graph={self.graph}, state={self.state})"
        )

Attributes

PARENT class-attribute instance-attribute

PARENT = 'PARENT'

goto instance-attribute

goto = goto

graph instance-attribute

graph = graph

state instance-attribute

state = state

update instance-attribute

update = update

Functions

__init__

__init__(update=None, goto=None, graph=None, state=None)

Initialize a Command object.

Parameters:

Name	Type	Description	Default
update	StateT | None | Message | str | BaseConverter	State update to apply.	None
goto	str | None	Next node to execute (node name or END).	None
graph	str | None	Which graph to navigate to (None for current, PARENT for parent).	None
state	StateT | None	Optional agent state to attach.	None

Source code in pyagenity/utils/command.py

def __init__(
    self,
    update: Union["StateT", None, Message, str, "BaseConverter"] = None,
    goto: str | None = None,
    graph: str | None = None,
    state: StateT | None = None,
):
    """
    Initialize a Command object.

    Args:
        update (StateT | None | Message | str | BaseConverter): State update to apply.
        goto (str | None): Next node to execute (node name or END).
        graph (str | None): Which graph to navigate to (None for current, PARENT for parent).
        state (StateT | None): Optional agent state to attach.
    """
    self.update = update
    self.goto = goto
    self.graph = graph
    self.state = state

__repr__

__repr__()

Return a string representation of the Command object.

Returns:

Name	Type	Description
str	str	String representation of the Command.

Source code in pyagenity/utils/command.py

def __repr__(self) -> str:
    """
    Return a string representation of the Command object.

    Returns:
        str: String representation of the Command.
    """
    return (
        f"Command(update={self.update}, goto={self.goto}, \n"
        f" graph={self.graph}, state={self.state})"
    )