Events

Events are declared before emission. This keeps plugin and application event maps type-safe and gives observers a single redaction boundary.

const events = defineEvents({
  "task:started": event<{ taskId: string }>(),
  "credential:used": event<{ token: string }>({
    redact: () => ({ token: "[redacted]" }),
  }),
});

Core application events

Dispatch flow

preventDefault() records that default behavior should not run. stopPropagation() ends the remaining routed phases. Subscription priority orders listeners within the same phase; event priority controls scheduling.

Priorities

• immediate: lifecycle and safety-sensitive work
• interaction: direct user intent
• normal: ordinary application updates
• background: work that may yield before dispatch

Subscription ownership

on() and observe() return disposers. Pass an AbortSignal when the subscription belongs to a request, workflow step, plugin activation, or React effect so cancellation and disposal share the same boundary.

Workflow and router event vocabularies are listed in their package pages.