Class EventManager

Event manager for client-side event handling.

Supports:

Exact match: 'tick' matches only 'tick'
Prefix wildcard: 'agent:*' matches 'agent.event', 'agent.created'
Global wildcard: '*' matches all events

Index

Constructors

Methods

onListenerError on once off emit emitFrame handlerCount

Constructors

constructor

new EventManager(): EventManager
Returns EventManager

Methods

onListenerError

onListenerError(handler: ListenerErrorHandler | null): void
Set a callback for handling errors thrown by event listeners.

By default, listener errors are logged to console.error. Use this method to customize error handling (e.g., send to error tracking service).
Parameters
- handler: ListenerErrorHandler | null
  Callback function to handle listener errors
Returns void
Example
```
events.onListenerError(({ error, eventName, pattern }) => {
  console.error(`Handler for pattern "${pattern}" failed on event "${eventName}":`, error);
  // Send to error tracking service
  Sentry.captureException(error);
});
```
- Defined in src/managers/event.ts:79

on

on<T = unknown>(
    pattern: string,
    handler: EventHandler<T>,
    namespace?: string,
): UnsubscribeFn
Subscribe to events.
Type Parameters
- T = unknown
Parameters
- pattern: string
  Event pattern ('', 'agent:', 'event.name')
- handler: EventHandler<T>
  Event handler function
- Optionalnamespace: string
  Optional namespace for isolation
Returns UnsubscribeFn
Unsubscribe function
Example
```
const unsub1 = events.on('*', (e) => console.log(e.event));
const unsub2 = events.on('agent:*', (e) => console.log(e.event));
const unsub3 = events.on('tick', (e) => console.log(e.payload));
```
- Defined in src/managers/event.ts:98

once

once<T = unknown>(
    pattern: string,
    handler: EventHandler<T>,
    namespace?: string,
): UnsubscribeFn
Subscribe to event once.
Type Parameters
- T = unknown
Parameters
- pattern: string
- handler: EventHandler<T>
- Optionalnamespace: string
Returns UnsubscribeFn
- Defined in src/managers/event.ts:138

off

off<T = unknown>(
    pattern?: string,
    handler?: EventHandler<T>,
    namespace?: string,
): void
Unsubscribe from events.
Type Parameters
- T = unknown
Parameters
- Optionalpattern: string
- Optionalhandler: EventHandler<T>
- Optionalnamespace: string
Returns void
- Defined in src/managers/event.ts:153

emit

emit<T = unknown>(eventName: string, payload: T): void
Emit an event to all matching handlers.
Type Parameters
- T = unknown
Parameters
- eventName: string
- payload: T
Returns void
- Defined in src/managers/event.ts:201

emitFrame

emitFrame(frame: EventFrame): void
Emit a protocol EventFrame.
Parameters
- frame: EventFrame
Returns void
- Defined in src/managers/event.ts:246

handlerCount

handlerCount(pattern?: string, namespace?: string): number
Get handler count.
Parameters
- Optionalpattern: string
- Optionalnamespace: string
Returns number
- Defined in src/managers/event.ts:253