Struct ExecutionNode 

pub struct ExecutionNode {

    pub uuid: Option<String>,
    pub parent_uuid: Option<String>,
    pub timestamp: Option<i64>,
    pub node_type: NodeType,
    pub is_sidechain: Option<bool>,
    pub session_id: Option<String>,
    pub cwd: Option<String>,
    pub message: Option<Message>,
    pub tool_use: Option<ToolUse>,
    pub tool_result: Option<ToolResult>,
    pub tool_use_result: Option<Value>,
    pub thinking: Option<String>,
    pub progress: Option<Progress>,
    pub token_usage: Option<TokenUsage>,
    pub extra: Option<HashMap<String, Value>>,
}

A single execution node in the Claude Code session tree

Represents any event in the transcript: user messages, assistant responses, tool calls, thinking blocks, etc. Nodes are linked via uuid/parentUuid.

Fields

uuid: Option<String>

Unique identifier for this node

parent_uuid: Option<String>

Parent node UUID (for building hierarchy). The JSONL field is camelCase parentUuid — must match exactly.

timestamp: Option<i64>

Timestamp in milliseconds (accepts both ISO 8601 string and number)

node_type: NodeType

Node type (user, assistant, progress, system, file-history-snapshot, …)

is_sidechain: Option<bool>

Whether this node belongs to a sidechain (subagent parallel execution).

session_id: Option<String>

Session ID this node belongs to (mirrors the filename stem).

cwd: Option<String>

Working directory at the time of this node.

message: Option<Message>

Message content (for user/assistant messages)

tool_use: Option<ToolUse>

Tool use details (legacy top-level format — real data uses ContentBlock::ToolUse)

tool_result: Option<ToolResult>

Tool result (legacy top-level format — real data uses ContentBlock::ToolResult)

tool_use_result: Option<Value>

Tool use result (raw tool output - can be string or object)

thinking: Option<String>

Thinking content (legacy top-level format)

progress: Option<Progress>

Progress updates (legacy field — real data stores progress details in extra["data"])

token_usage: Option<TokenUsage>

Token usage statistics

extra: Option<HashMap<String, Value>>

Additional metadata (optional to save memory when not present)

Implementations

impl ExecutionNode

pub fn effective_token_usage(&self) -> Option<&TokenUsage>

Returns token usage for this node.

Claude Code stores usage inside message.usage, not at the top level. This helper checks both places so callers don’t need to know the layout.

pub fn has_error(&self) -> bool

Returns true if this node represents a tool error.

Checks all known error signals in one place:

1. tool_result.is_error flag
2. <tool_use_error> tag in tool_result.content
3. toolUseResult (raw JSON) deserialized as ToolResult with is_error
4. ContentBlock::ToolResult with is_error or <tool_use_error> content

Trait Implementations

impl Clone for ExecutionNode

fn clone(&self) -> ExecutionNode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExecutionNode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ExecutionNode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ExecutionNode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.