Skip to content

Interface: ThreadNodeJSON

@providerprotocol/agents


@providerprotocol/agents / index / ThreadNodeJSON

Defined in: src/thread-tree/types.ts:13

Serialized representation of a ThreadNode for JSON persistence.

This interface defines the JSON structure used when serializing a ThreadNode for storage or transmission. It captures all node data including the full agent state snapshot at that point in the conversation tree.

  • ThreadNode - The runtime class this interface serializes
  • ThreadTreeJSON - The parent tree structure containing these nodes

children: string[]

Defined in: src/thread-tree/types.ts:40

IDs of all child nodes branching from this node. An empty array indicates this is a leaf node.


id: string

Defined in: src/thread-tree/types.ts:17

Unique identifier for this node (UUIDv4 format).


optional name: string

Defined in: src/thread-tree/types.ts:34

Optional human-readable name for this branch. Useful for identifying specific conversation paths (e.g., “refactor-attempt”, “alternative-solution”).


parentId: string | null

Defined in: src/thread-tree/types.ts:22

ID of the parent node, or null if this is the root node.


state: AgentStateJSON

Defined in: src/thread-tree/types.ts:28

Complete agent state snapshot at this point in the conversation. Contains messages, metadata, and all other state information.