Documentation / @agentick/core / ExecutionEvent

Interface: ExecutionEvent

Defined in: kernel/src/context.ts:60

Event emitted during procedure execution.

Events are emitted to both the global request bus (ctx.events) and the operation handle (ctx.executionHandle) if present.

Example

ctx.events.on('stream:chunk', (event: ExecutionEvent) => {
  console.log(`[${event.source}] ${event.type}:`, event.payload);
});

// Listen to all events
ctx.events.on('*', (event: ExecutionEvent) => {
  console.log(`Event: ${event.type}`);
});

See

Context.emit - Emit events to the current context

Properties

executionId?

optional executionId: string

Defined in: kernel/src/context.ts:74

Execution ID from context (auto-populated if available)

---

parentExecutionId?

optional parentExecutionId: string

Defined in: kernel/src/context.ts:76

Parent execution ID for nested executions (fork, spawn, component_tool)

---

payload

payload: any

Defined in: kernel/src/context.ts:64

Event payload data

---

procedureId?

optional procedureId: string

Defined in: kernel/src/context.ts:78

Procedure ID from context (auto-populated if available)

---

requestId?

optional requestId: string

Defined in: kernel/src/context.ts:72

Request ID for this execution context

---

source

source: string

Defined in: kernel/src/context.ts:68

Source of the event (e.g., 'agent:sales', 'model:openai')

---

tenantId?

optional tenantId: string

Defined in: kernel/src/context.ts:87

Tenant ID from context (for multi-tenant dashboards)

---

tick?

optional tick: number

Defined in: kernel/src/context.ts:80

Current tick number if in a tick context

---

timestamp

timestamp: number

Defined in: kernel/src/context.ts:66

Unix timestamp when the event occurred

---

traceId

traceId: string

Defined in: kernel/src/context.ts:70

Trace ID for correlation (distributed tracing)

---

type

type: string

Defined in: kernel/src/context.ts:62

Event type (e.g., 'stream:chunk', 'procedure:error')

---

userId?

optional userId: string

Defined in: kernel/src/context.ts:85

User ID from context (for attribution and multi-tenant filtering)