<!--
 ⚠️  AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
 This file is automatically generated by scripts/docs-generator.js
 To make changes, edit the source TypeScript files or update the generator script
-->

[agents](../../) / [Exports](../modules) / HierarchicalEventData

# Interface: HierarchicalEventData

🆕 Enhanced event data for hierarchical execution tracking
Extends EventData with additional fields for parent-child relationships and real-time data

## Hierarchy

- [`EventData`](EventData)

  ↳ **`HierarchicalEventData`**

## Table of contents

### Properties

- [type](HierarchicalEventData#type)
- [timestamp](HierarchicalEventData#timestamp)
- [executionId](HierarchicalEventData#executionid)
- [sessionId](HierarchicalEventData#sessionid)
- [userId](HierarchicalEventData#userid)
- [data](HierarchicalEventData#data)
- [error](HierarchicalEventData#error)
- [metadata](HierarchicalEventData#metadata)
- [parentExecutionId](HierarchicalEventData#parentexecutionid)
- [rootExecutionId](HierarchicalEventData#rootexecutionid)
- [executionLevel](HierarchicalEventData#executionlevel)
- [executionPath](HierarchicalEventData#executionpath)
- [realTimeData](HierarchicalEventData#realtimedata)

## Properties

### type

• **type**: [`EventType`](../modules#eventtype)

#### Inherited from

[EventData](EventData).[type](EventData#type)

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:160](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L160)

---

### timestamp

• **timestamp**: `Date`

#### Inherited from

[EventData](EventData).[timestamp](EventData#timestamp)

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:161](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L161)

---

### executionId

• `Optional` **executionId**: `string`

#### Inherited from

[EventData](EventData).[executionId](EventData#executionid)

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:162](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L162)

---

### sessionId

• `Optional` **sessionId**: `string`

#### Inherited from

[EventData](EventData).[sessionId](EventData#sessionid)

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:163](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L163)

---

### userId

• `Optional` **userId**: `string`

#### Inherited from

[EventData](EventData).[userId](EventData#userid)

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:164](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L164)

---

### data

• `Optional` **data**: `EventExecutionContextData`

#### Inherited from

[EventData](EventData).[data](EventData#data)

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:165](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L165)

---

### error

• `Optional` **error**: `Error`

#### Inherited from

[EventData](EventData).[error](EventData#error)

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:166](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L166)

---

### metadata

• `Optional` **metadata**: `EventEmitterMetadata`

#### Inherited from

[EventData](EventData).[metadata](EventData#metadata)

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:167](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L167)

---

### parentExecutionId

• `Optional` **parentExecutionId**: `string`

Parent execution ID for hierarchical tracking

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:176](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L176)

---

### rootExecutionId

• `Optional` **rootExecutionId**: `string`

Root execution ID (Team/Agent level)

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:179](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L179)

---

### executionLevel

• **executionLevel**: `number`

Execution depth level (0: Team, 1: Agent, 2: Tool, etc.)

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:182](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L182)

---

### executionPath

• **executionPath**: `string`[]

Execution path showing complete hierarchy

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:185](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L185)

---

### realTimeData

• `Optional` **realTimeData**: `Object`

Real-time execution data (no simulation)

#### Type declaration

| Name                | Type                                            | Description                                      |
| :------------------ | :---------------------------------------------- | :----------------------------------------------- |
| `startTime`         | `Date`                                          | Actual execution start time                      |
| `actualDuration?`   | `number`                                        | Actual duration in milliseconds (when completed) |
| `actualParameters?` | [`TToolParameters`](../modules#ttoolparameters) | Actual input parameters                          |
| `actualResult?`     | [`IToolResult`](IToolResult)                    | Actual execution result                          |

#### Defined in

[packages/agents/src/plugins/event-emitter-plugin.ts:188](https://github.com/woojubb/robota/blob/4f4c8a3197e92ddd43d12dc9186b0771983054c9/packages/agents/src/plugins/event-emitter-plugin.ts#L188)
