Interface: EventMeta

Defined in: src/events/types.ts:76

Metadata attached by the dispatcher to every event. Consumers never construct this manually — the dispatcher fills it in.

Properties

compositionPath

readonly compositionPath: readonly string[]

Defined in: src/events/types.ts:86

Composition ancestry — e.g. ['Sequence:pipeline','Agent:ethics'].

---

correlationId?

readonly optional correlationId?: string

Defined in: src/events/types.ts:96

Domain correlation id — ties retrieval → injection → LLM.

---

iterIndex?

readonly optional iterIndex?: number

Defined in: src/events/types.ts:90

Iteration index (Agent context only).

---

runId

readonly runId: string

Defined in: src/events/types.ts:98

Run id — demultiplex concurrent runs sharing one dispatcher.

---

runOffsetMs

readonly runOffsetMs: number

Defined in: src/events/types.ts:80

ms since run start — deterministic replay.

---

runtimeStageId

readonly runtimeStageId: string

Defined in: src/events/types.ts:82

footprintjs universal stage key.

---

spanId?

readonly optional spanId?: string

Defined in: src/events/types.ts:94

OTEL span id for the current composition boundary.

---

subflowPath

readonly subflowPath: readonly string[]

Defined in: src/events/types.ts:84

Subflow path parsed from runtimeStageId.

---

traceId?

readonly optional traceId?: string

Defined in: src/events/types.ts:92

OTEL trace id (when env.traceId is set).

---

turnIndex?

readonly optional turnIndex?: number

Defined in: src/events/types.ts:88

Turn index (Agent context only).

---

wallClockMs

readonly wallClockMs: number

Defined in: src/events/types.ts:78

Wall-clock ms — for external correlation / dashboards.