Skip to content

AIDK API Reference / aidk-kernel / ExecutionEvent

Interface: ExecutionEvent ​

Defined in: packages/kernel/src/context.ts:59

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 ​

typescript
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 ​

PropertyTypeDescriptionDefined in
executionId?stringExecution ID from context (auto-populated if available)packages/kernel/src/context.ts:73
parentExecutionId?stringParent execution ID for nested executions (fork, spawn, component_tool)packages/kernel/src/context.ts:75
payloadanyEvent payload datapackages/kernel/src/context.ts:63
procedureId?stringProcedure ID from context (auto-populated if available)packages/kernel/src/context.ts:77
requestId?stringRequest ID for this execution contextpackages/kernel/src/context.ts:71
sourcestringSource of the event (e.g., 'agent:sales', 'model:openai')packages/kernel/src/context.ts:67
tenantId?stringTenant ID from context (for multi-tenant dashboards)packages/kernel/src/context.ts:86
tick?numberCurrent tick number if in a tick contextpackages/kernel/src/context.ts:79
timestampnumberUnix timestamp when the event occurredpackages/kernel/src/context.ts:65
traceIdstringTrace ID for correlation (distributed tracing)packages/kernel/src/context.ts:69
typestringEvent type (e.g., 'stream:chunk', 'procedure:error')packages/kernel/src/context.ts:61
userId?stringUser ID from context (for attribution and multi-tenant filtering)packages/kernel/src/context.ts:84

Released under the MIT License.