orkes.graph.EdgeTrace

pydantic model orkes.graph.EdgeTrace

Represents the trace of a single edge traversal during a graph execution.

This model captures when and how an edge was traversed, including execution order, timing information, and optional runtime metadata. It provides fine-grained visibility into control flow between nodes.

edge_id

Unique identifier of the edge.

Type:

str

edge_run_number

Sequential number indicating how many times this edge has been traversed during the current run.

Type:

int

from_node

Name of the source node where the edge originates.

Type:

str

to_node

Name of the destination node(s).

Type:

Union[str, List[str]]

passes_left

Remaining number of allowed traversals before the edge reaches its maximum pass limit.

Type:

int

edge_type

Type of edge (e.g., “__forward__”, “__conditional__”).

Type:

str | None

elapsed

Elapsed time in seconds since the start of the run when this edge was traversed.

Type:

float

state_snapshot

Snapshot of relevant runtime state at the moment the edge was traversed.

Type:

dict

meta

Additional metadata associated with this edge traversal.

Type:

dict

llm_traces

A list of LLM traces that occurred during this edge’s execution.

Type:

list[LLMTraceSchema]

function_traces

A list of function traces that occurred during this edge’s execution.

Type:

list[FunctionTraceSchema]

Fields:

• edge_id (str)

• edge_run_number (int)

• edge_type (str | None)

• elapsed (float)

• from_node (str)

• function_traces (List[orkes.graph.schema.FunctionTraceSchema])

• llm_traces (List[orkes.graph.schema.LLMTraceSchema])

• meta (dict)

• passes_left (int)

• state_snapshot (dict)

• to_node (str | List[str])

field edge_id: str [Required]

field edge_run_number: int [Required]

field edge_type: str | None [Required]

field elapsed: float [Required]

field from_node: str [Required]

field function_traces: List[FunctionTraceSchema] = []

field llm_traces: List[LLMTraceSchema] = []

field meta: dict [Required]

field passes_left: int [Required]

field state_snapshot: dict = {}

field to_node: str | List[str] [Required]